115 lines
4.7 KiB
Markdown
115 lines
4.7 KiB
Markdown
# План: Decouple polygon v0.2.1
|
||
|
||
Цель: разнести монолитный `app.py` (400 строк, 17 роутов) на отдельные blueprint-файлы
|
||
по шаблону app-autotest. Никакого инлайн-CSS/HTML — всё в `static/` и `templates/`.
|
||
|
||
## Текущее → Целевое
|
||
|
||
```
|
||
polygon/site/
|
||
├── app.py (400 строк, всё в одном)
|
||
├── mock_state.py
|
||
├── state_machine.py
|
||
├── config_loader.py
|
||
└── from_stands.py
|
||
|
||
↓
|
||
|
||
polygon/site/
|
||
├── app.py # ТОЛЬКО: Flask(), register_blueprint, /health, app.run()
|
||
├── routes/
|
||
│ ├── root.py # GET / (render_template + style.css)
|
||
│ ├── services_routes.py # GET /api/v1/svc/services, GET /services/<id>
|
||
│ ├── instances_routes.py # GET/POST /api/v1/svc/instances, GET /instances/<uid>
|
||
│ ├── operations_routes.py # POST /instanceOperations, GET default, GET status, POST params, GET validate
|
||
│ ├── run.py # POST /instanceOperations/<uid>/run
|
||
│ └── mock_routes.py # POST /_mock/reset, GET /_mock/state, GET /_mock/services, POST /_mock/delay
|
||
├── state/
|
||
│ ├── mock_state.py # MockState (без изменений)
|
||
│ └── state_machine.py # apply_effect (без изменений)
|
||
├── config/
|
||
│ └── loader.py # load_services() (бывший config_loader.py)
|
||
├── converter/
|
||
│ └── from_stands.py # конвертер (без изменений)
|
||
├── utils/
|
||
│ ├── pluralize.py # _pluralize() — одна функция
|
||
│ └── now.py # _now() — одна функция
|
||
├── static/
|
||
│ └── style.css # CSS из index() — тёмная тема
|
||
├── templates/
|
||
│ └── index.html # HTML из index() — Jinja2 с {{ VERSION }}
|
||
└── services/
|
||
└── ...yaml # без изменений
|
||
```
|
||
|
||
## Пошагово
|
||
|
||
### Шаг 1. Утилиты
|
||
|
||
- `utils/now.py` — `_now()` из app.py (одна функция)
|
||
- `utils/pluralize.py` — `_pluralize()` из state_machine.py (одна функция)
|
||
|
||
### Шаг 2. CSS и HTML
|
||
|
||
- `static/style.css` — вынести инлайн-CSS из f-строки `index()`
|
||
- `templates/index.html` — вынести HTML из f-строки, использовать Jinja2 `{{ version }}`, `<link rel="stylesheet">`
|
||
|
||
### Шаг 3. Маршруты — 6 blueprint-файлов
|
||
|
||
Каждый blueprint импортирует нужные модули из `state/`, `config/`, `utils/`.
|
||
|
||
- `routes/root.py` — `bp = Blueprint("root", __name__)`, роут `/` с `render_template`
|
||
- `routes/services_routes.py` — `bp = Blueprint("services", __name__)`, 2 роута
|
||
- `routes/instances_routes.py` — `bp = Blueprint("instances", __name__)`, 3 роута
|
||
- `routes/operations_routes.py` — `bp = Blueprint("operations", __name__)`, 5 роутов
|
||
- `routes/run.py` — `bp = Blueprint("run", __name__)`, 1 роут
|
||
- `routes/mock_routes.py` — `bp = Blueprint("mock", __name__)`, 4 роута
|
||
|
||
### Шаг 4. app.py — только скелет
|
||
|
||
```python
|
||
import os
|
||
from flask import Flask
|
||
from routes.root import bp as root_bp
|
||
from routes.services_routes import bp as services_bp
|
||
# ... все 6 blueprint'ов
|
||
from config.loader import load_services
|
||
|
||
os.environ.setdefault("WEB_CONCURRENCY", "1")
|
||
VERSION = "0.2.1"
|
||
MOCK_OP_DELAY = float(os.getenv("MOCK_OP_DELAY", "0.1"))
|
||
|
||
app = Flask(__name__, template_folder="templates", static_folder="static")
|
||
|
||
app.register_blueprint(root_bp)
|
||
app.register_blueprint(services_bp)
|
||
# ... все 6
|
||
|
||
@app.route("/health")
|
||
def health():
|
||
return "OK"
|
||
|
||
if __name__ == "__main__":
|
||
app.run(debug=True, host="0.0.0.0", port=5000)
|
||
```
|
||
|
||
### Шаг 5. Импорты в state_machine и from_stands
|
||
|
||
- `state_machine.py`: `from utils.pluralize import pluralize` (вместо `_pluralize()` внутри)
|
||
- `from_stands.py`: импортирует `pluralize` из `utils/`
|
||
|
||
## Что НЕ меняется
|
||
|
||
- `state/mock_state.py` — как есть
|
||
- `state/state_machine.py` — только импорт `pluralize`
|
||
- `converter/from_stands.py` — только импорт `pluralize`
|
||
- `services/*.yaml` — данные
|
||
- `tests/` — только поправить пути импорта (site → site.state и т.д.)
|
||
|
||
## Верификация
|
||
|
||
1. `python -m py_compile` на ВСЕХ .py файлах
|
||
2. `python -c "from app import app; [print(r.rule) for r in app.url_map.iter_rules()]"` → те же 17 роутов
|
||
3. `pytest tests/ -v` → 19/19 PASS
|
||
4. Запустить `python app.py` → curl /health, /services, /instances → работает
|