Модульный монолит вместо распределённых микросервисов
Попытка разделить систему на микросервисы до стабилизации требований создаёт искусственные сложности. На начальном этапе границы бизнес-логики регулярно меняются, а распределённая сеть требует согласованного обновления контрактов, настройки сетевых политик и решения проблем распределённых транзакций.
В Go естественной границей изоляции служат пакеты. Размещение прикладных модулей внутри каталога «internal» и взаимодействие через интерфейсы обеспечивает порядок в коде без сетевых задержек. Если в дальнейшем отдельному модулю потребуется независимое масштабирование, его можно выделить в отдельный сервис без изменения предметной логики.
PostgreSQL как единый источник достоверных данных
Реляционная база данных PostgreSQL закрывает основные потребности ранней версии продукта: гарантирует целостность связей, поддерживает транзакции уровня ACID и обеспечивает надёжное индексирование. Наличие типа данных JSONB позволяет хранить документы с гибкой структурой там, где модель данных ещё формируется, избавляя от необходимости подключать стороннюю NoSQL-базу.
Для взаимодействия с базой в Go оптимально использовать драйвер pgx и явные SQL-запросы или кодогенерацию. Отказ от тяжеловесных ORM исключает скрытые запросы, позволяет точно анализировать планы выполнения через EXPLAIN и снижает потребление памяти приложением.
Строгие версионированные миграции схемы данных
Любые изменения структуры базы данных должны быть зафиксированы в кодовой базе и применяться автоматически. Ручное выполнение SQL-скриптов на сервере или автоматическая генерация таблиц на основе структур данных приводят к рассинхронизации схемы между средами разработки и рабочей средой.
Инструменты вроде goose или golang-migrate упорядочивают изменения схемы в виде последовательных файлов миграций с шагами применения и отката. Запуск миграций при старте контейнера или на этапе развёртывания гарантирует, что структура таблиц в базе точно соответствует ожиданиям запущенной версии бинарного файла.
Конфигурация через окружение и проверка при запуске
В соответствии с методологией «Twelve-Factor App» все параметры, зависящие от окружения, должны передаваться через переменные среды. Зашивать параметры подключения, секретные ключи или адреса внешних сервисов в конфигурационные файлы репозитория небезопасно.
При старте приложения в точке входа main переменные окружения считываются в строго типизированную структуру Go. Если обязательный параметр отсутствует или задан с ошибкой, приложение должно немедленно завершить работу с информативным сообщением в логе, не пытаясь открывать сетевой порт в некорректном состоянии.
Многоэтапная сборка в Docker и локальный запуск
Компиляция Go в единый статический бинарный файл позволяет формировать компактные и безопасные контейнеры. Многоэтапная сборка (multi-stage build) выполняет компиляцию приложения в официальном образе Go, а в финальный образ переносит только готовый исполняемый файл и корневые сертификаты.
- Итоговый образ на базе Alpine Linux или scratch не содержит компилятора и лишних системных утилит, что уменьшает размер и снижает вектор возможных атак.
- Запуск процесса от имени непривилегированного пользователя внутри контейнера ограничивает доступ к файловой системе хоста.
- Файл Docker Compose объединяет контейнер бэкенда, базу данных PostgreSQL и постоянные тома данных в единую предсказуемую конфигурацию.
Базовая наблюдаемость: логи slog и проверка состояния
На старте продукта нет необходимости разворачивать комплексные системы распределённого трейсинга, но базовая диагностика должна присутствовать изначально. Стандартный пакет «slog» позволяет формировать структурированные логи в формате JSON с указанием уровня логирования, времени и контекста запроса.
Сервис должен предоставлять стандартные HTTP-эндпоинты проверки состояния: маршрут liveness для подтверждения работоспособности веб-сервера и маршрут readiness для проверки доступности пула соединений с PostgreSQL перед направлением пользовательского трафика.
Какие решения безопаснее отложить на следующие релизы
Инженерная дисциплина при разработке первой версии заключается в осознанном отказе от инфраструктурных усложнений: Такие бэкенды мы делаем в рамках услуги разработка backend на Go.
- Микросервисная архитектура и сетевой обмен по gRPC между внутренними компонентами системы.
- Тяжёлые брокеры сообщений уровня Kafka или RabbitMQ, когда для редких фоновых задач достаточно очередей на таблицах PostgreSQL с блокировкой строк.
- Кэширование через Redis до появления реальных профилей нагрузки и выявленных медленных запросов к базе данных.
- Кластерная оркестрация Kubernetes, пока нагрузка предсказуемо обслуживается на одном виртуальном сервере с Docker Compose.
- Сложные шаблоны проектирования вроде Event Sourcing и CQRS, замедляющие доработку схемы данных.