Документировать карту инфраструктуры Lab 2
Skeleton contracts / contracts (pull_request) Canceled after 0s
Skeleton contracts / contracts (pull_request) Canceled after 0s
This commit is contained in:
@@ -15,6 +15,16 @@ Lab1 в указанном репозитории — skeleton без готов
|
||||
|
||||
FastAPI обращается к PostgreSQL через asyncpg и ограниченный пул соединений. PostgreSQL — источник истины для пользователей, хешей паролей, чатов, участников и сообщений. Redis — источник истины для сессий; Redis AOF использует `appendfsync always`, а сессии задаются абсолютным PXAT и не продлеваются запросами. Logout удаляет ключ. Переходная миграция 0002 аннулирует старые хеши сессий PostgreSQL; после обновления клиент должен войти заново. Миграции выполняются при запуске и отмечаются в schema_migrations; создание чата и его участников проходит в одной транзакции. Bearer-токен генерируется с 256 битами энтропии; Redis содержит только SHA-256-ключ токена, user_id и expires_at. Индексы: уникальность username, список чатов по участнику и история сообщений по (chat_id, created_at, id). Параметры .env задают локальные реквизиты PostgreSQL и TTL; Compose передаёт API внутренние DATABASE_URL и REDIS_URL. Запросы параметризованы asyncpg; пул ограничен min/max size, временем ожидания свободного соединения и таймаутом SQL-команды. История сообщений читает только одну keyset-страницу через индекс `(chat_id, created_at, id)`. Порты API и PostgreSQL проброшены только на `127.0.0.1`, чтобы не выставлять учебный HTTP API и БД наружу.
|
||||
|
||||
### Карта инфраструктуры
|
||||
|
||||
| Роль | Compose service и версия | Health/readiness | Volume | Сеть и опубликованный порт | Передача credentials |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| HTTP API | `api`; локальная сборка из `Dockerfile`, база `python:3.12.8-slim`; Python-пакеты закреплены в `requirements-app.txt` | Compose проверяет `GET /health/ready`; запуск зависит от healthy PostgreSQL и Redis | Нет: API stateless | Внутренняя сеть Compose; наружу только `127.0.0.1:${APP_PORT:-8080}:8080` | Compose подставляет значения `.env` в `DATABASE_URL`; Redis доступен по внутреннему `REDIS_URL` |
|
||||
| Основная БД | `postgres`, `postgres:16.4-alpine` | `pg_isready` с пользователем и базой из конфигурации | Именованный `postgres_data` → `/var/lib/postgresql/data` | Внутренняя сеть Compose; наружу только `127.0.0.1:${POSTGRES_PORT:-5432}:5432` | `POSTGRES_USER`, `POSTGRES_PASSWORD`, `POSTGRES_DB` берутся из локального `.env`; пароль также входит во внутренний `DATABASE_URL` API |
|
||||
| Сессии | `redis`, `redis:7.4.2-alpine` | `redis-cli ping`; API отдельно проверяет доступность зависимости в readiness | Именованный `redis_data` → `/data`; включены AOF и `appendfsync always` | Только внутренняя сеть Compose, host port не опубликован | Пароль Redis не задан; Redis не опубликован на host и доступен сервисам только по внутреннему имени `redis` |
|
||||
|
||||
Bootstrap схемы выполняет API при старте: `apply_migrations` создаёт `schema_migrations`, берёт PostgreSQL advisory lock и применяет упорядоченные SQL-файлы. Каждая новая версия и запись о ней фиксируются в одной транзакции; уже отмеченные версии пропускаются, поэтому повторный запуск безопасен. Отдельные bucket/broker provisioning-команды не нужны: эти сервисы в Lab 2 не используются. `scripts/restart.sh` перезапускает PostgreSQL, Redis и API, сохраняя именованные volumes; отдельный failover hook не добавлен, поскольку стенд содержит одну API-реплику и проверяет отказы зависимостей напрямую.
|
||||
|
||||
## Доказательства критериев
|
||||
|
||||
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
|
||||
|
||||
Reference in New Issue
Block a user