# Backoffice Preventivi — Krèios

Backend + backoffice collegato al configuratore 3D. Riceve i prodotti configurati, li accumula in un
preventivo (carrello lato server con token), alla conferma raccoglie i dati del cliente, genera un PDF
riassuntivo e invia le email a cliente e amministratore.

## Componenti

- **Laravel 13 + Filament 3** (questa cartella): API pubblica del carrello (`/api/carrello/*`) e pannello
  admin (`/admin`).
- **App cliente Vue 3** (`cliente/`): riepilogo carrello + form contatti + conferma (nessun iframe).
- **Configuratore** (`../src`): la modifica in `src/js/starter.js` sostituisce il vecchio `postMessage`
  con una chiamata diretta all'API e mostra un pulsante "Vai al preventivo".

## Flusso

1. L'utente configura un prodotto nel configuratore e clicca "Aggiungi al preventivo".
2. `starter.js` invia `POST /api/carrello/aggiungi` (con `sistema`, `type`, dimensioni, prezzo, payload,
   screenshot PNG). Il backend crea/aggiorna un `preventivo` (stato `bozza`) identificato da un `token`
   salvato in `localStorage`.
3. Il pulsante "Vai al preventivo" apre l'app cliente passando il token: `/preventivo/?token=XXX`.
4. L'app cliente mostra il carrello, l'utente compila i dati e conferma → `POST /api/carrello/{token}/conferma`.
5. Il backend crea il `cliente`, imposta lo stato a `inviato`, genera il PDF e invia le email
   (cliente con PDF allegato + notifica admin). Il preventivo è visibile nel backoffice.

## Setup

```bash
# 1. Backend Laravel (da questa cartella)
composer install
# .env già configurato: MySQL 127.0.0.1 / root / (no password) / DB kreios_preventivi
php artisan migrate --seed        # crea le tabelle + utente admin
php artisan storage:link
php artisan serve --port=8000     # API + admin su http://localhost:8000

# 2. Frontend: configuratore + app cliente, compilati in public/ (dalla root del repo)
cd ..
./build.sh                        # -> public/configuratore e public/preventivo
```

Configuratore e app cliente sono serviti da questo backend: <http://localhost:8000/configuratore/?sistema=pvc&type=finestra_2_ante>
e <http://localhost:8000/preventivo/>. In sviluppo `./dev.sh` (root) avvia Laravel e ricompila i frontend
a ogni modifica. Dettagli in `../docs/PREVENTIVI_BACKOFFICE.md`.

### Credenziali admin (seed di default)
- URL: <http://localhost:8000/admin>
- Email: `admin@kreiosinfissi.it` — Password: `password`

### Email in sviluppo
`MAIL_MAILER=log`: le email finiscono in `storage/logs/laravel.log` (incluso il PDF allegato in base64).
In produzione configurare SMTP nel `.env`.

## Configurazione (`.env` Laravel)

| Variabile | Descrizione |
|---|---|
| `DB_*` | MySQL: `127.0.0.1`, `root`, no password, `kreios_preventivi` |
| `ADMIN_NOTIFY_EMAIL` | Email che riceve la notifica di nuovo preventivo |
| `APP_FRONTEND_CLIENTE_URL` | URL dell'app cliente, solo se non servita da qui (default `APP_URL/preventivo`) |
| `CORS_ALLOWED_ORIGINS` | Origini esterne autorizzate all'API (default `*`; i frontend serviti da qui non ne hanno bisogno) |

### Frontend
Configuratore e app cliente chiamano l'API sulla stessa origine (`${location.origin}/api`): nessuna
variabile da impostare. `VITE_PREVENTIVI_API_BASE` (root) / `VITE_API_BASE` (`cliente/`) servono solo per
un'API su un altro dominio. Il link "Vai al preventivo" usa `frontend_cliente_url` da `GET /api/config`.

## Modello dati

- **`clienti`** — anagrafica cliente.
- **`preventivi`** — un preventivo/carrello: `token`, `numero`, `stato`
  (`bozza`→`inviato`→`in_lavorazione`→`chiuso`), `totale` (IVA inclusa), `pdf_path`.
- **`preventivo_items`** — righe: `sistema`, `type`, `nome_modello`, dimensioni, `quantita`, prezzi,
  `payload` (JSON della configurazione), `immagine_path` (screenshot decodificato).

Il payload del configuratore mescola stringhe e oggetti listino: `App\Support\ConfigurazioneFormatter`
lo normalizza in righe `{label, value}` con etichette italiane, usato sia dal PDF che dal backoffice.

## Branding

Palette allineata al configuratore Krèios (`../src/assets/style.css`): teal `#12373C` (primario) e oro
`#ffd700` (call-to-action). Il logo (`../src/assets/img/kreios.jpg`) è copiato in `public/images/kreios-logo.jpg`
(Laravel/Filament/PDF/email) e in `cliente/public/kreios-logo.jpg` (app cliente Vue).

## API

| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | `/api/config` | Configurazione pubblica (URL corrente dell'app cliente) |
| POST | `/api/carrello/aggiungi` | Aggiunge un prodotto (crea il carrello se manca il token) |
| GET | `/api/carrello/{token}` | Ritorna il carrello (solo stato bozza) |
| DELETE | `/api/carrello/{token}/item/{id}` | Rimuove una riga |
| POST | `/api/carrello/{token}/conferma` | Finalizza: cliente + PDF + email |