Nítida Studio: portal intern de gestió (disseny.estudijoanpuig.com)

Nítida Studio és el portal intern de gestió del centre d'estètica: un únic punt d'entrada des d'on l'equip accedeix a clients, agenda, catàleg, comptabilitat i analítica.

No és una sola aplicació monolítica, sinó un ecosistema de mòduls PHP que comparteixen autenticació, base de dades i identitat visual, desplegat al servidor disseny (VM Proxmox).

Què ofereix el portal?

A la pàgina principal hi ha targetes d'accés ràpid a cada àrea funcional:

Arquitectura del sistema

                    ┌─────────────────────────────┐
                    │  disseny.estudijoanpuig.com │
                    │   Portal Nítida Studio      │
                    └──────────────┬──────────────┘
                                   │
     ┌─────────────┬───────────────┼───────────────┬─────────────┐
     ▼             ▼               ▼               ▼             ▼
 Seguiment    Comptabilitat   Dashboard      Web pública    phpMyAdmin
 (clients)    (vendes/compres) (Koibox+Sheets)  (/nitida/)    (MySQL)
     │             │               │               │
     └─────────────┴───────────────┴───────────────┘
                                   │
                          MySQL (base nitida / posts_adk)
                          PHP 8.x + Apache

Mòduls principals al codi

• nitida_seguiment/ — CRM intern: clients, productes del centre, consentiments signats, aniversaris, protocol LM Studio.
• nitida_comptabilitat/ — Vendes amb detall de productes, importació des del dashboard, catàleg comptable.
• dashboard_nitida/ — Fusiona vendes de Koibox (oficial) i Google Sheets (comptabilitat B), amb gràfics Chart.js.
• nitida/ — Web pública del centre (reserves, contacte, catàleg de serveis).
• inc/nitida-nav.php — Menú «Apps» compartit per saltar entre mòduls sense perdre context.
• inc/portal-auth.php — Autenticació unificada; redirigeix al login del portal principal si cal.

Flux de dades de vendes

El dashboard és el cor analític:

1. Koibox aporta les vendes oficials (fitxer MovimientosCaja.xlsx).
2. Google Sheets complementa l'històric i el registre manual de comptabilitat B.
3. En períodes solapats, preval Koibox i s'exclouen duplicats de Sheets.
4. nitida_comptabilitat importa aquestes dades per al diari de vendes amb detall de productes.

Autenticació i navegació

• Login centralitzat via el portal principal (index.php del blog/gestió).
• Els mòduls protegits criden portal_require_auth() o el seu propi auth.php.
• El commutador Apps Nítida (seguiment, comptabilitat, dashboard, web) apareix a les barres de navegació internes.
• Enllaç de tornada al portal general amb portal_home_link().

Desplegament

El portal en producció viu a https://disseny.estudijoanpuig.com/, allotjat a una VM del clúster Proxmox (disseny, xarxa interna). En local es replica sota C:\Apache24\htdocs\ amb les mateixes carpetes de mòduls.

Stack tècnic

• Servidor web: Apache 2.4 + PHP 8.2 (mysqli / PDO)
• Base de dades: MySQL 8.4
• Frontend: Tailwind CSS, Alpine.js, Font Awesome, Chart.js (dashboard)
• Correu: PHPMailer (formularis web de nitida/)

Per a qui és útil aquest portal?

• Recepció / estètica: consultar clients, consentiments i agenda.
• Gestió: vendes, despeses, marges i comparatives trimestrals.
• Marketing / web: catàleg de productes i serveis publicats.
• Tècnic / administrador: importacions Koibox, dashboard i phpMyAdmin.

Resum

Nítida Studio centralitza la gestió diària d'un centre d'estètica en un portal clar i modular. Cada targeta del dashboard obre una aplicació especialitzada, però totes comparteixen dades, usuaris i estètica corporativa (crema, beix i verd en comptabilitat).

És un bon exemple de com un negoci local pot tenir un mini-ERP a mida sense dependre de SaaS externs per a tot: CRM, comptabilitat, analítica i web pública en un mateix entorn PHP/MySQL.