# Documentazione applicazioni SOPHIA

Questo repository contiene la documentazione tecnica in formato Markdown per `yii`.

## Regole di uniformita (obbligatorie)

- Usa nomi file/cartelle in italiano.
- Usa `snake_case` minuscolo per i file (esempio: `analisi_tecnica_esterometro.md`).
- Usa sempre `ticket/` (singolare) come cartella dei ticket.
- Usa il pattern `ticket_<id>_<tipo>.md` per i file ticket.
- Mantieni come base: `README.md`, `context.md` (se utile), `linee_guida_*.md` (se presenti).
- Usa `functions/`, `ticket/`, `analisi/` quando applicabili al contenuto del repo.
- Evita path assoluti o server-specifici: usa riferimenti logici a repository, moduli e componenti.
- In ogni analisi tecnica indica: scopo, contesto, componenti, flusso, rischi/vincoli, verifiche.

## Regola di transizione

- I nuovi documenti devono rispettare queste regole.
- I documenti legacy non vengono rinominati in blocco: l'allineamento è progressivo e non bloccante.

## Ultimo aggiornamento documentazione app

- 2026-05-21 20:36 CEST

## Scopo
Descrivere obiettivo operativo e risultato atteso.

## Perimetro
Definire modulo, confini funzionali e prerequisiti.

## Flusso
1. Input e contesto.
2. Esecuzione del processo.
3. Output e verifica.

## Componenti
- Controller/servizi.
- Model e tabelle.
- Job/log/integrazioni correlate.

## Failure mode
- Errori ricorrenti.
- Cause tipiche.
- Segnali diagnostici.

## Checklist
- Pre: prerequisiti validati.
- Post: outcome e coerenza dati verificati.

## Criteri di accettazione
Contenuto azionabile, verificabile e coerente con il codice.

- ultima_verifica: 2026-05-28
- stato_validazione: da_verificare
- owner_documentazione: team_documentazione_tecnica