intranetBatoi

🤖 Índex de coneixement de domini

Documents vius per a agents d’IA. Cada fitxer té alta cohesió (tot el que conté pertany al seu context) i baix acoblament (és autoexplicatiu sense dependre d’altres fitxers).

Quan la IA es comporta malament en un domini, refines el fitxer corresponent; no el prompt.

Comença ací si véns de nou: tetris.md — mapa de les 4 peces i guia d’ús al dia a dia (receptes per escenari, exemple complet del flux OpenSpec, antipatrons i la regla de l’adaptador prim per a configs d’IA).

📏 Convencions generals

Fitxer	Contingut
conventions.md	Estil de codi, patrons del projecte, rutes/cache, commits
testing-docker.md	Execució de tests, scripts Composer, Docker/Selenium

🖥️ UI operativa i graelles

Fitxer	Contingut
ui/grid-datatables.md	Components de graella, Panel/Pestana, DataTables, estat buit

🏢 FCT (Formació en Centres de Treball)

Dominis: annexos, signatures, SAO, expedients, empreses, col·laboracions.

Fitxer	Contingut
fct/fct-map.md	Rutes, controladors, entitats, vistes, correus
fct/signatures.md	Flux /signatura, sendTo/signed, plantilles Annex I/II/III/V
fct/sao-selenium.md	Descàrregues SAO, depuració Selenium

🎒 Activitats complementàries i extraescolars

Fitxer	Contingut
activitats/activitats-map.md	Rutes, fitxers clau, camps llegats, coordinador, PDFs

📨 Notificacions i correu

Fitxer	Contingut
notificacions/notificacions-map.md	NotificationService, avisos, MyMail, reutilització del sistema d’enviament

🧪 Specs de comportament

Les especificacions BDD (Given/When/Then) viuen a specs/. Cada spec descriu el comportament esperat d’un bounded context, independent de la tecnologia.

Spec	Bounded context
specs/fct.md	FCT: annexos, signatura, expedients
specs/activitats.md	Activitats: creació, visites, PDF
specs/comisions.md	Comissions: estats, FCTs associades, PDF
specs/guardies.md	Guàrdies: presència, panell donde, coincidències
specs/horaris.md	Horaris: canvi temporal, proposta JSON, bulk apply

✅ Flux OpenSpec

Procediment per a implementar funcionalitats amb aprovació humana en tres passos (propose → apply → archive). Documentació: openspec.md.

🔍 Pipeline IA revisora ≠ generadora

La IA que escriu el codi no pot revisar-lo amb objectivitat. Documentació del workflow de revisió creuada: ia-review-pipeline.md.