ADa Workshop

Что необходимо

• Python 3.11 или новее;
• запущенный PostgreSQL и созданная пустая база данных;
• бакет Backblaze B2 и Application Key с правами Read and Write;
• файлы проекта:

Workshop/
├── main.py           # Запуск FastAPI и отдача страницы
├── routers.py        # API каталога, проверка ZIP и загрузка в B2
├── database.py       # Модели и подключение PostgreSQL
├── workshop.html     # Интерфейс мастерской
├── requirements.txt  # Python-зависимости
└── .evn              # Локальные настройки и секреты, в Git не добавлять

Папки .venv/ и backups/ для запуска не нужны: первая создаётся командами ниже, вторая содержит резервные копии разработки.

Настройка .evn

Создай в папке Workshop файл именно с именем .evn и заполни его:

DATABASE_URL=postgresql+psycopg://POSTGRES_USER:POSTGRES_PASSWORD@localhost:5432/WORKSHOP_DB

S3_ENDPOINT_URL=https://s3.YOUR_REGION.backblazeb2.com
S3_REGION=YOUR_REGION
S3_BUCKET=YOUR_BUCKET_NAME
S3_ACCESS_KEY=YOUR_B2_keyID
S3_SECRET_KEY=YOUR_B2_applicationKey

Для Backblaze B2:

• S3_ACCESS_KEY — поле keyID созданного Application Key;
• S3_SECRET_KEY — поле applicationKey;
• S3_REGION — регион из S3 Endpoint;
• S3_BUCKET — имя бакета.

Запуск на Windows

Открой PowerShell в папке проекта и выполни:

cd C:\путь\к\Workshop
py -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\.venv\Scripts\python.exe -m uvicorn main:app --reload

Открой в браузере: http://127.0.0.1:8000

Запуск на macOS

Открой Terminal в папке проекта и выполни:

cd /путь/к/Workshop
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python -m uvicorn main:app --reload

Открой в браузере: http://127.0.0.1:8000

Для остановки сервера в обоих случаях нажми Ctrl+C.

Формат загружаемого ZIP

Архив должен содержать файлы в корне архива, без внешней папки ada/:

ada.zip
├── checker/
│   └── checker.py
└── service/
    ├── docker-compose.yml
    ├── Dockerfile.api
    └── ...

Обязательны checker/checker.py, service/docker-compose.yml и service/Dockerfile.api. Максимальный размер ZIP — 5 МБ; все файлы должны лежать только внутри checker/ или service/.