Adriano
e4b29c0b2d
Cleanup - Remove src/backend/Dockerfile.legacy and src/frontend/flask_app/Dockerfile.legacy (history is in git, build uses the new uv-based root Dockerfile / Dockerfile.frontend). - Remove src/frontend/flask_app/verify_i18n.py (had hardcoded paths pointing at the old client/ tree). Group docs/ - New docs/README.md indexes everything in one place. - New docs/architecture/STATO_PROGETTO.md: snapshot of what works in V2.0.0 (inherited V1.0.7 features, rev04 Phase 1 stations, worker scaling, src/ restructure, test status, stack, decisions). - New docs/architecture/ROADMAP.md: what's next — Phases 2-7 of the rev04 migration with status, open client decisions (D-0.1 through D-0.10), tech debt and time estimates for M1 / M2. - Move PIANO_IMPLEMENTAZIONE.md (90KB V1.0.0 plan) to docs/archive/2026-02-06-piano-implementazione-v1.md (historical). - Move Schema sviluppo SW TieFlow_rev04-2026.docx to docs/specs/ with ISO date filename so the customer spec is now tracked. - Move src/frontend/flask_app/I18N_SETUP.md to docs/I18N_SETUP.md and rewrite paths to the new src/frontend/flask_app/ tree. .dockerignore: simplified now that legacy Dockerfiles are gone; docs/ stays excluded from the build context. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
123 lines
7.0 KiB
Markdown
123 lines
7.0 KiB
Markdown
# Stato Progetto TieMeasureFlow — V2.0.0
|
||
|
||
> Snapshot al 2026-04-25. Aggiornare ad ogni milestone.
|
||
|
||
## Versione corrente
|
||
|
||
**V2.0.0** (in sviluppo, branch `V2.0.0` come default su `git.tielogic.xyz`).
|
||
|
||
Versione precedente di produzione: `V1.0.7`.
|
||
|
||
## Sintesi esecutiva
|
||
|
||
Il sistema base (V1.0.7) è completo e collaudato: ricette, task, misurazioni, SPC, report PDF, gestione utenti, dashboard metrologist. La V2.0.0 in corso aggiunge il primo blocco della migrazione **rev04** (stazioni per-tablet) e ristruttura l'intero monorepo secondo lo standard `python-project-spec-design.md` (uv + `src/backend/` + `src/frontend/flask_app/`).
|
||
|
||
## Cosa funziona oggi (V2.0.0 — branch corrente)
|
||
|
||
### Funzionalità ereditate da V1.0.7
|
||
- Autenticazione username/password + API key per-utente, ruoli combinabili (Maker, MeasurementTec, Metrologist) + flag `is_admin`.
|
||
- Recipe versioning copy-on-write: una nuova versione si crea solo se la corrente ha già measurements; altrimenti update in-place.
|
||
- Editor ricette (Maker) con annotation editor Fabric.js (~1200 LOC, collaudato su tablet).
|
||
- Workflow operatore tablet: select_recipe → task_list → task_execute → task_complete, con barcode scanner e numpad touch (input USB calibro con burst detection).
|
||
- Calcolo pass/fail con limiti UTL/UWL/LWL/LTL.
|
||
- Dashboard SPC: capability (Cp/Cpk/Pp/Ppk), control chart (UCL/LCL = mean ± 3σ), istogramma con curva normale, calcoli puro stdlib (no numpy).
|
||
- Report PDF (WeasyPrint + Kaleido SVG).
|
||
- Setup page protetta da `SETUP_PASSWORD` per inizializzazione DB e seed.
|
||
- i18n IT/EN (Flask-Babel + Alpine.js JSON).
|
||
- Tema light/dark via `Alpine.store('theme')` + localStorage.
|
||
|
||
### Aggiunte V2.0.0 (rev04 Fase 1 — Stazioni per-tablet)
|
||
- Tabelle `stations` + `station_recipe_assignments` (Alembic migration `002_add_stations.py`).
|
||
- Modelli ORM: `Station`, `StationRecipeAssignment` con vincolo unique `(station_id, recipe_id)`.
|
||
- Schemas Pydantic: `StationCreate/Update/Response`, `StationRecipeAssignmentCreate/Response`, `RecipeSummary`.
|
||
- Service `station_service` (CRUD + assegnazioni + cascade delete).
|
||
- Router `/api/stations` con CRUD admin + endpoint operatore `GET /api/stations/by-code/{code}/recipes`.
|
||
- Seed automatico `ST-DEFAULT` con tutte le ricette esistenti (idempotente).
|
||
- Variabile env client `STATION_CODE` letta da `Config`, helper `APIClient.get_station_recipes()`.
|
||
- Filtro `select_recipe`: il client mostra solo le ricette assegnate alla propria stazione, errore se `STATION_CODE` non configurato.
|
||
- **GUI admin completa** in `/admin/stations`: tabella con search, modal create/edit, modal gestione assegnazioni ricette, conferma eliminazione, link in navbar (desktop + mobile).
|
||
- 47 nuovi test (32 server + 15 client) tutti pass.
|
||
|
||
### Aggiunte V2.0.0 (performance + multi-utente)
|
||
- Gunicorn 5 workers × 4 thread (gthread) — capacità ~20 richieste concorrenti Flask, regge 20+ tablet.
|
||
- Uvicorn 4 workers + `--proxy-headers --forwarded-allow-ips='*'`.
|
||
- Rate limit middleware: identificazione IP reale via `X-Forwarded-For` → `X-Real-IP` → `request.client.host`.
|
||
- Rate limit general 100 → 300 req/min/IP (per-tablet ora, non più condiviso).
|
||
- Flask `ProxyFix(x_for=1, x_proto=1, x_host=1)` per IP reale dietro Nginx.
|
||
- `APIClient` propaga `X-Forwarded-For` + `X-Real-IP` (sia JSON che multipart).
|
||
- 12 test aggiuntivi (7 server + 5 client).
|
||
|
||
### Aggiunte V2.0.0 (struttura monorepo)
|
||
- `pyproject.toml` unico con extra `server`/`client`/`dev`. Niente più `requirements.txt`.
|
||
- `uv.lock` (77 pacchetti) + `.python-version` (3.11) committati per build riproducibili.
|
||
- Layout `src/backend/` + `src/frontend/flask_app/` (vedi sotto).
|
||
- `Dockerfile` (root) + `Dockerfile.frontend` riscritti con `uv sync --frozen --no-dev --extra server|client`.
|
||
- `docker-compose.{dev,}.yml` con build context `.`.
|
||
- Alembic env.py aggiunge project root a `sys.path`; `script_location = %(here)s` resta valido.
|
||
- `.dockerignore` aggiornato.
|
||
|
||
## Layout repository (V2.0.0)
|
||
|
||
```
|
||
TieMeasureFlow/
|
||
├── pyproject.toml + uv.lock + .python-version
|
||
├── Dockerfile (backend) + Dockerfile.frontend
|
||
├── docker-compose.dev.yml + docker-compose.yml
|
||
├── nginx/
|
||
├── uploads/ # volume Docker
|
||
├── docs/ # raggruppata e indicizzata
|
||
│ ├── README.md (indice)
|
||
│ ├── API.md / DEPLOYMENT.md / USER_GUIDE.md / I18N_SETUP.md
|
||
│ ├── architecture/ # questo file + ROADMAP.md
|
||
│ ├── archive/ # piani storici
|
||
│ ├── specs/ # spec esterne (.docx)
|
||
│ └── superpowers/plans/ # piani TDD dettagliati
|
||
└── src/
|
||
├── backend/
|
||
│ ├── main.py / config.py / database.py
|
||
│ ├── api/{routers,middleware}/
|
||
│ ├── models/{orm,api}/
|
||
│ ├── services/
|
||
│ ├── migrations/
|
||
│ ├── templates/
|
||
│ └── tests/
|
||
└── frontend/
|
||
└── flask_app/
|
||
├── app.py / config.py / compile_translations.py
|
||
├── blueprints/ (auth, maker, measure, statistics, admin)
|
||
├── services/ (api_client.py)
|
||
├── templates/ + static/ + translations/
|
||
└── tests/
|
||
```
|
||
|
||
## Test status
|
||
|
||
| Suite | Pass | Fail | Note |
|
||
|---|---|---|---|
|
||
| Backend (`src/backend/tests/`) | 127 | 3 | Fail pre-esistenti: `test_recipes` (2) + `test_tasks` (1). Nessuno introdotto dalla V2.0.0. |
|
||
| Frontend (`src/frontend/flask_app/tests/`) | 44 | 1 | Fail pre-esistente: `test_save_measurement_proxy`. |
|
||
| **Totale** | **171** | **4** | Tutti i fallimenti tracciati come tech debt da risolvere. |
|
||
|
||
## Stack confermato
|
||
|
||
- **Backend:** FastAPI + SQLAlchemy 2.0 async + MySQL 8 + Alembic + Pydantic v2 + WeasyPrint + Plotly/Kaleido.
|
||
- **Frontend:** Flask + Jinja2 + Alpine.js + TailwindCSS + Fabric.js 5.3.1 + html5-qrcode + Plotly.js + Flask-Babel.
|
||
- **Deploy:** Docker Compose. Dev = Nginx; Prod = Traefik + Let's Encrypt SSL.
|
||
- **Tooling:** uv (package mgmt), pytest + pytest-asyncio + httpx + aiosqlite (test).
|
||
|
||
## Decisioni architetturali rilevanti
|
||
|
||
| Decisione | Stato | Note |
|
||
|---|---|---|
|
||
| Frontend Flask invece di React (deroga vs spec §8) | **Confermata** | Tablet UX server-side, USB calipers/barcode, Fabric.js editor, i18n Babel collaudato. Vedi conversazione 2026-04-25. |
|
||
| NATS messaging (spec §7) | **Skippato** | Monorepo single-host, no microservizi. Nessuno stub `nats_client/` creato. |
|
||
| Envelope risposta `{success,data,error}` (spec §6) | **Rimandato** | Costo 4-5gg refactor + rotture client. Eventuale v2 API in M2. |
|
||
| Header `X-API-Key` vs spec `X-Api-Key` | **Mantenuto attuale** | Rinominare costa 50+ punti di codice + breaking per deploy. Rivedere in M2. |
|
||
| Variabili `.env` (DB_HOST, SERVER_PORT, ...) | **Mantenute attuali** | Rename a SERVICE_NAME/SERVICE_DOMAIN/API_KEY rinviato (impatta deploy esistenti). |
|
||
|
||
## Branch git
|
||
|
||
- **Default:** `V2.0.0` (lavoro corrente)
|
||
- **Mantenuti:** `V1.0.0` … `V1.0.7` (release branches storiche)
|
||
- **Mergiato e chiuso:** `feature/rev04-phase1-stations` (in `V2.0.0` con commit `ea8e468`)
|