hello-world

Минималистичный скелет HTTP-сервиса на Go. Служит отправной точкой для новых сервисов: DI через fx, структурированные логи, конфигурация из YAML + ENV, единый формат ответов.

go run ./cmd/server --config config.yaml
# или
go run ./cmd/server -c /path/to/config.yaml

Сервер поднимается на порту из конфига (по умолчанию :8080).

curl http://localhost:8080/health
# {"status":"OK"}

Конфиг читается из YAML-файла, потом поверх него накладываются переменные окружения.

config.yaml

development: true

http:
  host: ""
  port: "8080"
  read_header_timeout: 5s
  read_timeout: 30s
  write_timeout: 30s
  idle_timeout: 60s

Переменные окружения

Разделитель уровней вложенности — двойное подчёркивание (__). Одиночное подчёркивание допустимо в именах полей.

ENV имеет приоритет над YAML.

.
├── cmd/server/         # точка входа, сборка fx-приложения
├── config/             # типы конфига + провайдер (koanf)
└── internal/
    ├── dto/            # общие типы запросов/ответов
    ├── handler/        # HTTP-обработчики
    ├── middleware/     # middleware: request_id, logging, chain
    ├── module/         # fx-модули (Config, Logger, Handler, Server)
    ├── response/       # хелперы записи JSON-ответов
    └── server/         # обёртка над http.Server

Все ответы — JSON. Структура единая для успехов и ошибок.

Успех

{
  "success": true,
  "data": { ... }
}

Ошибка

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "invalid request",
    "details": [
      { "field": "email", "message": "required" }
    ]
  }
}

details присутствует только когда нужен.