Dezinfection CRM

CRM для сервиса дезинфекции dezgost.ru. Стек: FastAPI + React + PostgreSQL.

Документы:

• CLAUDE.md — инструкции для агента и правила репозитория
• PLAN.md — план реализации
• ERD.md — модель данных

Локальный запуск

Требуется Docker, Python 3.12+ и Node 20+.

cp infra/.env.example infra/.env
make up           # postgres, redis, backend, frontend
make migrate      # применить миграции
make logs         # хвост логов

После старта:

• API: http://localhost:8000 (docs: http://localhost:8000/docs)
• Web: http://localhost:5273
• Postgres: localhost:5532
• Redis: localhost:6479

Порты сдвинуты, чтобы не конфликтовать с соседним проектом Ordo (он держит 5173/5432/6379). Изменить — в infra/.env.

Структура

backend/   FastAPI + SQLAlchemy + Alembic
frontend/  React + Vite + TypeScript
infra/     docker-compose, переменные окружения

Первая миграция

После добавления новой модели:

make shell-backend
alembic revision --autogenerate -m "describe change"
alembic upgrade head

Тесты и линт

make test
make lint