📦 Promocode Service

Стек: Golang + PostgreSQL + Docker

---

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

1. Установите зависимости

Перед запуском убедитесь, что у вас установлены:

• Go (рекомендуется 1.20+)
• Docker + Docker Compose
• make (Linux/macOS — обычно есть, Windows — через WSL или Git Bash)
• migrate CLI (для работы с миграциями)

Установка migrate

MacOS (brew):

brew install golang-migrate

Linux:

curl -L https://github.com/golang-migrate/migrate/releases/latest/download/migrate.linux-amd64.tar.gz | tar xvz
sudo mv migrate /usr/local/bin/

Windows: Скачать: https://github.com/golang-migrate/migrate/releases

---

2. Клонируйте проект

git clone <repo_url>
cd <project_folder>

---

3. Настройте окружение

Создайте .env файл:

cp .env-example .env

Заполните переменные (БД, порт и т.д.)

---

4. Установите зависимости Go

go mod tidy

---

5. Запустите PostgreSQL

docker-compose up -d

---

6. Примените миграции

make migrate-pg-up

---

7. Запустите приложение

make run

---

📬 Работа с API

1. Откройте Postman

2. Импортируйте файл:

   Promocode.postman_collection.json
   

3. Используйте готовые эндпоинты

---

⚠️ Частые ошибки

• ❌ Не установлен migrate → миграции не работают
• ❌ Не выполнен go mod tidy → ошибки зависимостей
• ❌ Не поднят Docker → нет подключения к БД
• ❌ Не создан .env → приложение не стартует