Руководство разработчика

Быстрый старт для разработчиков.

Локальная разработка

Требования

Python 3.9+
PostgreSQL
Node.js 18+ (для frontend)

Backend

# Установить зависимости
pip install -r requirements.txt

# Запустить PostgreSQL
docker-compose up -d postgres

# Запустить сервер
cd src
uvicorn main:app --host 0.0.0.0 --port 7373

Frontend

cd frontend
npm install
npm run dev

Структура проекта

src/
├── domain/          # Доменный слой
├── application/     # Use cases
├── infrastructure/  # Технические детали
└── presentation/    # REST API

Архитектурные принципы

Clean Architecture
Repository Pattern
Dependency Injection
Use Cases для бизнес-логики

Добавление нового endpoint

Создать use case в application/use_cases/
Зарегистрировать DI provider в infrastructure/di/injection.py
Создать endpoint в presentation/api/endpoints/
Добавить роутер в main.py