Session 3: corrected architecture - no monolith, max decoupling

2026-07-23 09:29:47 +04:00
parent 6e5f009b82
commit 32c57e4cd9
1 changed files with 60 additions and 0 deletions
@@ -0,0 +1,60 @@
+# Исправление архитектуры — 2026-07-23
+
+⛔ tfflaskcrud — демо, не образец для app-autotest.
+
+## Новые принципы
+
+- **Никакого монолита** — максимум 50-80 строк на файл
+- **Decoupling** — каждый модуль делает одно дело
+- **Factory pattern** — `create_app()`
+- **Blueprints** — разделение роутов по доменам
+- **Чёткая структура Python**
+
+## Структура проекта
+
+```
+app-autotest/
+├── requirements.txt
+├── run.py                          # Точка входа (5 строк)
+├── config.py                       # Конфигурация (переменные окружения)
+└── app/
+    ├── __init__.py                 # create_app() фабрика
+    ├── api/
+    │   ├── __init__.py
+    │   └── client.py               # HTTP-клиент облака Nubes
+    ├── services/
+    │   ├── __init__.py
+    │   ├── service_discovery.py    # Получение списка сервисов + параметров
+    │   └── test_runner.py          # Запуск тестов, поллинг статуса
+    ├── models/
+    │   ├── __init__.py
+    │   ├── db.py                   # Подключение к БД, get_db()
+    │   └── repository.py           # SQL-запросы (CRUD тестов, конфигов)
+    ├── routes/
+    │   ├── __init__.py
+    │   ├── main.py                 # Главная страница (blueprint)
+    │   ├── api_routes.py           # REST API для фронта (blueprint)
+    │   └── config_routes.py        # Конфигурация тестов (blueprint)
+    ├── static/
+    │   ├── favicon.svg
+    │   ├── logo.svg
+    │   ├── style.css
+    │   └── app.js                  # Фронтенд: state → render
+    └── templates/
+        ├── base.html               # Базовый шаблон Nubes
+        ├── index.html              # Главная
+        └── components/             # Переиспользуемые компоненты
+            ├── card.html
+            ├── modal.html
+            └── table.html
+```
+
+## Правила
+
+- Максимум **50-80 строк на файл**
+- Каждый модуль — одна ответственность
+- Никакой бизнес-логики в роутах — только вызов сервисов
+- `api/` — только HTTP, не знает про Flask
+- `services/` — бизнес-логика, не знает про HTTP
+- `routes/` — только маршрутизация, тонкие контроллеры
+- `models/` — только БД