Tauler i rutes /compta/

El tauler és la porta de l’app interna. Si ja has entrat, / et porta aquí: /compta/. No és una pàgina de WordPress amb shortcode: és una ruta nostra que acaba a page-dashboard.php.

El tauler és la compta: clients, productes, vendes, agenda. El logo Dusk ho resumeix.

Qui pot entrar

Qualsevol URL de /compta/ exigeix sessió WordPress. Si no hi ha login, astrolus_handle_requests() redirigeix a la portada (formulari d’entrar). El Front (/front/) és l’única ruta Nítida pública. Després del login, el destí és sempre /compta/.

El POST astrolus_login fa wp_signon() i, si va bé, wp_safe_redirect( home_url( '/compta/' ) ).

Rutes físiques i plantilles

Nginx/Apache veuen carpetes reals sota compta/. Cada index.php només marca el mòdul i torna a carregar WordPress:

// compta/index.php
$_GET['nitida'] = 'dashboard';
require dirname(__DIR__) . '/index.php';

// compta/clients/index.php
$_GET['nitida'] = 'clients';
require dirname(__DIR__, 2) . '/index.php';

Després, template_include tria la plantilla. Sense això, WordPress intentaria una pàgina o un 404.

Query vars

functions.php llegeix la URL (o ?nitida=) i omple tres vars:

nitida — mòdul: dashboard, clients, vendes, cites…
nitida_action — new, edit, fitxa (si hi ha id i no hi ha action, assumeix edit)
nitida_id — id del registre

També desactivem redirect_canonical a /compta/ i /front/ perquè WP no ens reescrigui les rutes.

Quina plantilla surt

Ruta	Plantilla
`/compta/`	`page-dashboard.php`
`/compta/clients/` (llista / editar)	`page-compta.php`
`/compta/clients/?action=fitxa&id=`	`page-client.php`
`/compta/cites/` (setmana)	`page-agenda.php`
`/compta/cites/?action=new`	`page-compta.php`
Altres CRUD	`page-compta.php`

Els slugs CRUD els marca astrolus_crud_slugs(): clients, empleats, productes, categories, proveïdors, vendes, cites, cabines.

El tauler

page-dashboard.php pinta vuit targetes amb comptadors de astrolus_nitida_stats() (clients, empleats, cites, cabines, productes, categories, proveïdors, vendes) i una taula de les últimes 25 vendes. Cada targeta va a astrolus_nitida_url( $slug ).

Les URLs les construeix astrolus_nitida_url():

/compta/                      → dashboard
/compta/vendes/               → llista
/compta/vendes/?action=new    → alta
/compta/vendes/?id=12         → editar

Al navbar, si hi ha sessió, surten els grups de astrolus_nav_groups():

Persones — clients, empleats
Catàleg — productes, categories
Compta — vendes, proveïdors
Agenda — cites, cabines

El logo Nítida (sessió oberta) també torna al tauler, no al Front.

Afegir un mòdul

Crea compta/{slug}/index.php que faci $_GET['nitida'] = '{slug}'.
Afegeix l’slug a astrolus_crud_slugs() (i a astrolus_entities() si és CRUD).
Si cal una vista especial, enganxa-la a astrolus_template(). Si no, ja usarà page-compta.php.
Posa’l al grup del navbar si l’has de veure cada dia.

El CRUD (llistes, altes, esborrats, sync Woo) el tracten els capítols següents. Aquí només importa: ruta → query var → plantilla.