architect/templates/@it/stacks/python/DESIGN.md

DESIGN — {ИМЯ} (Python)

Версия: 1.0.0
Стек: Python / FastAPI


Стек

Компонент Технология Версия
Language Python 3.12+
Framework FastAPI 0.11x
Database PostgreSQL / SQLite
ORM SQLAlchemy 2.x
Task Queue
Сервер {хостинг / VPS}

Архитектура

{имя}/
├── app/
│   ├── main.py           ← точка входа
│   ├── config.py         ← настройки (из .env)
│   ├── models/           ← SQLAlchemy модели
│   ├── routers/          ← FastAPI роутеры
│   ├── services/         ← бизнес-логика
│   └── utils/            ← вспомогательные функции
├── tests/
├── requirements.txt
├── .env.example
└── Dockerfile (опционально)

Ключевые решения

Решение Обоснование
{решение} {почему}

API endpoints

Метод URL Описание
GET /api/{resource} Список
POST /api/{resource} Создать
GET /api/{resource}/{id} Получить
PUT /api/{resource}/{id} Обновить
DELETE /api/{resource}/{id} Удалить

Обновлено: {YYYY-MM-DD}