Wildberries Monorepo

Локальный запуск backend + frontend для разработки.

Структура

• backend — Go backend (gRPC + HTTP gateway, Postgres, Swagger UI)
• wb_front — Vite/React frontend

Требования

• Docker + Docker Compose
• Go (для goose, если миграции запускаются локально)
• psql (PostgreSQL client)
• Node.js + npm

AI настройка секрета

Ключ AI-провайдера используется только на backend.

1. Создать локальный файл /Users/eugenesuvorov/Study/wildberris/wildberries/backend/.env.backend (файл игнорируется git).
2. Скопировать туда значения из /Users/eugenesuvorov/Study/wildberris/wildberries/backend/.env.backend.example.
3. Выбрать провайдера через AI_PROVIDER и вставить ключ только в backend env.

Пример для Gemini:

AI_PROVIDER=gemini
GEMINI_API_KEY=your_secret_key
GEMINI_MODEL=gemini-2.5-flash
GEMINI_API_BASE_URL=https://generativelanguage.googleapis.com

Пример для Groq:

AI_PROVIDER=groq
GROQ_API_KEY=your_secret_key
GROQ_MODEL=llama-3.1-8b-instant
GROQ_API_BASE_URL=https://api.groq.com/openai/v1

Рекомендации по безопасности:

• не хранить ключ во frontend и не публиковать в репозитории;
• не логировать значение ключа в runtime;
• хранить prod/CI ключи в Secret Manager (GitHub Secrets / Vault);
• для Groq и Gemini регулярно ротировать ключи при подозрении на утечку.

Быстрый старт (рекомендуется)

Этот вариант запускает backend, DB и Swagger в Docker, а frontend локально.

1. Поднять backend-инфраструктуру и сервер:

cd /Users/eugenesuvorov/Study/wildberris/wildberries/backend
# при необходимости: export $(cat .env | xargs)
docker compose up -d --build

2. Применить миграции:

cd /Users/eugenesuvorov/Study/wildberris/wildberries/backend
goose -dir ./migrations postgres "postgres://postgres:postgres@localhost:5442/seller_promotions?sslmode=disable" up

3. Загрузить dev seed-данные (товары для seller flow):

psql "postgres://postgres:postgres@localhost:5442/seller_promotions?sslmode=disable" \
  -f /Users/eugenesuvorov/Study/wildberris/wildberries/backend/docs/dev_seed_products.sql

4. Если backend-контейнер стартовал до миграций и завершился с ошибкой, перезапустить:

cd /Users/eugenesuvorov/Study/wildberris/wildberries/backend
docker compose restart server

5. Запустить frontend:

cd /Users/eugenesuvorov/Study/wildberris/wildberries/wb_front
npm ci
VITE_API_BASE_URL=/api VITE_SELLER_ID=1 npm run dev
# windows
set VITE_API_BASE_URL=/api && set VITE_SELLER_ID=1 && npm run dev

Куда заходить

• Frontend: http://localhost:5173
• Backend HTTP API: http://localhost:8080
• Swagger UI: http://localhost:7003

Альтернатива: backend локально через Go

Если нужно запускать backend не в контейнере:

1. Поднять только БД и Swagger:

cd /Users/eugenesuvorov/Study/wildberris/wildberries/backend
docker compose up -d db swagger-ui

2. Запустить backend локально:

cd /Users/eugenesuvorov/Study/wildberris/wildberries/backend
DATABASE_DSN=postgres://postgres:postgres@localhost:5442/seller_promotions?sslmode=disable \
AI_PROVIDER=stub \
HTTP_PORT=8080 GRPC_PORT=7002 go run ./cmd/server
# windows
set DATABASE_DSN=postgres://postgres:postgres@localhost:5442/seller_promotions?sslmode=disable && set AI_PROVIDER=stub && set HTTP_PORT=8080 && set GRPC_PORT=7002 && go run ./cmd/server

Важно: не запускать одновременно Docker-контейнер server и локальный go run (конфликт портов 8080 и 7002).

Пауза / возобновление (локально)

Если backend/db/swagger запущены через Docker

Поставить на паузу (контейнеры остановятся, данные в volume сохранятся):

cd /Users/eugenesuvorov/Study/wildberris/wildberries/backend
docker compose stop

Возобновить:

cd /Users/eugenesuvorov/Study/wildberris/wildberries/backend
docker compose start

Если backend запущен через go run, frontend через npm run dev, а БД локально (fallback)

• В терминале с backend (go run ./cmd/server) нажать Ctrl+C
• В терминале с frontend (npm run dev) нажать Ctrl+C
• Если поднимали локальный Postgres через pg_ctl, остановить:

/opt/homebrew/opt/postgresql@18/bin/pg_ctl -D /tmp/wb-e1-pg stop

Повторный запуск:

• backend: снова выполнить команду go run из раздела выше
• frontend: снова выполнить npm run dev
• local Postgres (если использовался): pg_ctl ... start с тем же каталогом данных

Полная остановка (Docker)

cd /Users/eugenesuvorov/Study/wildberris/wildberries/backend
docker compose down

Полезные заметки

• Vite proxy уже настроен: /api -> http://localhost:8080
• Для локального go run backend обязательно задавать DATABASE_DSN, иначе backend попробует подключиться к db:5432
• Для включения Gemini используйте AI_PROVIDER=gemini и задайте GEMINI_API_KEY только в backend окружении
• Для включения Groq используйте AI_PROVIDER=groq и задайте GROQ_API_KEY только в backend окружении
• Подробный runbook: backend/docs/runbook_локальный_запуск_генерация_акций.md