ms-catalog

ms-catalog

REST-микросервис управления каталогом товаров на Go. Часть платформы selfshop-dev.

Обзор

ms-catalog реализует полный жизненный цикл товара: создание, обновление, управление статусом, мягкое удаление и постраничный просмотр активных товаров. Сервис построен по принципу чистой архитектуры с явным разделением на слои domain, usecase, handler и storage.

Подробнее об архитектуре — в docs/ARCHITECTURE.md.
Полная спецификация API — в docs/API.md.
Обоснование технологических решений — в docs/DECISIONS.

Возможности

• CRUD для товаров с поддержкой статусов active, inactive, draft, archived
• Поиск по UUID и slug
• Пагинированный список активных товаров
• Валидация на уровне домена и на уровне HTTP-запроса
• RFC 9457 problem details для всех ошибочных ответов
• Структурированное логирование через zap с runtime-управлением уровнем
• Health-эндпоинты /health/alive и /health/ready
• Swagger UI в dev-режиме на /swagger
• Hot-reload в dev-окружении через air

Быстрый старт

# Клонировать репозиторий
git clone https://github.com/selfshop-dev/ms-catalog
cd ms-catalog

# Скопировать и заполнить переменные окружения
cp .env.example .env

# Запустить dev-окружение с hot-reload
make dev

# Применить миграции
make mig-apply

# Открыть Swagger UI
open http://localhost:8080/swagger

Конфигурация

Сервис конфигурируется через переменные окружения с префиксом INIT__. Двойное подчёркивание __ — разделитель вложенности (INIT__DB__DSN → db.dsn).

Разработка

Подробнее о рабочем процессе и правилах оформления коммитов — в CONTRIBUTING.md.

make test     # unit-тесты с покрытием
make test-e2e # end-to-end тесты (требует Docker)

make lint # статический анализ (golangci-lint)

make sqlc-gen # регенерировать Go-код из SQL
make swag-gen # регенерировать OpenAPI spec
make code-gen # go generate ./...

Лицензия

MIT © 2026-present selfshop-dev