- Python 3.12
- Docker и Docker Compose
- Poetry 1.8.x
- Скопируйте значения окружения:
cp .env.local.example .env.localи при необходимости замените пароли/порты. - Запустите сервисы:
docker compose up --build. - API будет доступно на
http://localhost:8000/api/health. - Админ-панель будет доступна на
http://localhost:8001.
- Установите зависимости:
poetry install. - Примените переменные окружения (можно взять из
.env.local.example):- Убедитесь, что
DATABASE_URLуказывает на вашу базу (например, локальный Postgres или контейнерdbиз compose).
- Убедитесь, что
- Запустите сервер:
uvicorn app.api.main:app --reload. - Для админ-панели используйте:
uvicorn app.admin.main:app --reload --port 8001.
APP_PORT— порт публикации FastAPI (по умолчанию 8000).ADMIN_PORT— порт публикации админ-панели (по умолчанию 8001).DEBUG— режим подробных логов SQLAlchemy.POSTGRES_USER,POSTGRES_PASSWORD,POSTGRES_DB— учётные данные БД.DATABASE_URL— строка подключения SQLAlchemy (async); в compose используется хостdb.S3_ENDPOINT_URL— внутренний endpoint S3 для backend-контейнера (локально обычноhttp://localstack:4566).S3_PRESIGN_PUBLIC_ENDPOINT— endpoint, который будет попадать в presignedupload_url/urlдля клиентов.
Для локальной мобильной разработки обычно:
- iOS simulator / web / curl с хоста:
S3_PRESIGN_PUBLIC_ENDPOINT=http://localhost:4566 - Android emulator:
S3_PRESIGN_PUBLIC_ENDPOINT=http://10.0.2.2:4566
.env.local предназначен для локальной разработки и игнорируется Git. .env.lock хранит дефолтные значения для справки и тестов. Для стейджа/прода переменные задаются через GitHub Actions secrets при деплое.
- Для dev-режима таблицы создаются автоматически при старте приложения.
- Для продакшн-потока подключим Alembic и будем генерировать миграции вместо
create_all.
- Файл каталога услуг:
data/services.json. - Скрипт заполнения (идемпотентный):
python scripts/seed_services.py. - Можно запускать повторно — данные будут обновляться по имени и родителю.
- Конфигурация:
alembic.ini, скрипты вalembic/. URL берётся изDATABASE_URL(учитываетENVIRONMENT). - Создать новую ревизию (автогенерация от моделей):
alembic revision -m "name" --autogenerate. - Применить миграции:
alembic upgrade head. Откат:alembic downgrade -1. - Initial ревизия:
0001_initial(создаёт все текущие таблицы).
- Основана на
sqladmin, использует общие модели проекта. - Запуск в docker: сервис
adminвdocker-compose.yml(сборка черезadmin.Dockerfile). - Локальный запуск:
uvicorn app.admin.main:app --reload --port 8001.
- Установка дев-зависимостей уже прописана в Poetry (
black,isort). - Быстрый формат кода:
make pretty(isort + black). - Проверка без изменений:
make validate(isort/black в check-режиме).