Este document descriu l’aplicació tal com està implementada en la branca
principal. És el punt d’entrada tècnic; els detalls de cada domini viuen en
docs/agents/ i el comportament esperat, en
specs/.
Intranet\.El frontend conserva un runtime híbrid perquè encara conviuen pantalles modernes amb JavaScript llegat.
Navegador
-> ruta del perfil (`routes/*.php`)
-> middleware web i de rol
-> controlador o component Livewire
-> servei d'aplicació/domini quan existeix
-> entitats Eloquent i serveis transversals
-> vista Blade o resposta JSON/PDF
Els controladors antics encara poden accedir directament a Eloquent. El codi
nou o extret ha de preferir app/Application, app/Domain, app/Finders i
app/Services abans de duplicar lògica.
app/Providers/RouteServiceProvider.php carrega les rutes per perfil. El
middleware RoleMiddleware resol l’usuari autenticat, comprova el rol requerit
i permet sempre l’accés a administració.
| Fitxer | Prefix | Accés principal |
|---|---|---|
routes/public.php |
— | Sense autenticar |
routes/todos.php |
— | Qualsevol usuari autenticat |
routes/profesor.php |
— | Professorat i perfils docents compostos |
routes/jefeDpto.php |
/depto |
Reservat per a caps de departament; actualment no declara rutes pròpies |
routes/direccion.php |
/direccion |
Direcció |
routes/administrador.php |
— | Administració |
routes/alumno.php |
/alumno |
Alumnat |
routes/conserge.php |
— | Consergeria |
routes/mantenimiento.php |
/mantenimiento |
Manteniment |
routes/api.php |
/api |
API; autenticació segons l’endpoint |
Els rols es defineixen com a factors primers en config/roles.php. Un usuari
pot acumular-ne diversos en un únic valor; userIsAllow(), rolesUser() i
esRol() comproven la divisibilitat del valor compost. Per això no s’ha de
comparar directament el camp rol amb un únic número.
El menú lateral és dinàmic:
MenuService::make('general') consulta els registres actius de la taula
menus.messages.menu.*.Una ruta pot existir i no aparéixer en el menú. Per documentar la interfície
real cal contrastar sempre la taula menus de l’entorn desplegat amb
php artisan route:list.
El camp ajuda de cada registre de menú enllaça una pantalla amb un manual.
existsHelp() busca l’ajuda associada a l’URL actual i els layouts obrin:
https://cipfpbatoi.github.io/intranetBatoi/manuals/{ajuda}
Per tant, si es crea o es mou un manual, també s’ha de revisar el valor
menus.ajuda corresponent.
| Capa | Responsabilitat |
|---|---|
app/Entities |
Models Eloquent, relacions, accessors i compatibilitat llegada |
app/Domain |
Contractes i fronteres dels dominis extrets |
app/Application |
Casos d’ús i orquestració de cada domini |
app/Http/Controllers |
Entrada HTTP, validació, autorització i resposta |
app/Livewire |
Estat i accions dels panells reactius |
app/Finders |
Consultes reutilitzables |
app/Services |
Capacitats transversals: autenticació, documents, correu, notificacions, escola, signatures i UI |
app/UI |
Panells, pestanyes i botons de les pantalles operatives |
app/Policies |
Autorització sobre entitats |
app/Sao |
Integració i automatització amb SAO |
Hi ha dos patrons principals:
Core/BaseController i UI/Panels/Panel per a CRUD i graelles operatives;resources/views/livewire per als panells
reactius.Els layouts conviuen en resources/views/layouts i
resources/views/components/layouts. Les taules compartides estan en
resources/views/components/grid. Les regles específiques de graelles i
DataTables estan documentades en
docs/agents/ui/grid-datatables.md.
Les rutes API usen el prefix /api i controladors de
Intranet\Http\Controllers\API. L’aplicació usa Sanctum 4 i manté punts de
compatibilitat amb tokens llegats. Qualsevol canvi d’autenticació ha de
comprovar tant els clients web com els consumidors de l’API.
Les fonts viuen en resources/assets/js i resources/assets/sass.
vite.config.mjs declara els punts d’entrada i Vite genera els bundles. No
s’han d’editar manualment els assets compilats de public/ quan existeix una
font equivalent en resources/assets.
Quan canvie una pantalla s’ha de revisar, com a mínim:
menus.ajuda, si canvia el fitxer o l’àncora de l’ajuda;