feat(back-end): new db for custom quote requests

README.md

@@ -1,70 +1,67 @@
 # Print Calculator (OrcaSlicer Edition)
 
-Un'applicazione Full Stack (Angular + Python/FastAPI) per calcolare preventivi di stampa 3D precisi utilizzando **OrcaSlicer** in modalità headless.
+Un'applicazione Full Stack (Angular + Spring Boot) per calcolare preventivi di stampa 3D precisi utilizzando **OrcaSlicer** in modalità headless.
 
 ## Funzionalità
 
-*   **Slicing Reale**: Usa il motore di OrcaSlicer per stimare tempo e materiale, non semplici approssimazioni geometriche.
-*   **Preventivazione Completa**: Calcola costo materiale, ammortamento macchina, energia e ricarico.
-*   **Configurabile**: Prezzi e parametri macchina modificabili via variabili d'ambiente.
-*   **Docker Ready**: Tutto containerizzato per un facile deployment.
+*   **Slicing Reale**: Usa il motore di OrcaSlicer per stimare tempo e materiale, garantendo la massima precisione.
+*   **Preventivazione Database-Driven**: Calcolo basato su politiche di prezzo configurabili nel database (costo materiale, ammortamento macchina a scaglioni, energia e markup).
+*   **Visualizzazione 3D**: Anteprima del file STL caricato tramite Three.js.
+*   **Multi-Profilo**: Supporto per diverse stampanti, materiali e profili di processo.
+
+## Stack Tecnologico
+
+- **Backend**: Java 21, Spring Boot 3.4, PostgreSQL, Flyway.
+- **Frontend**: Angular 19, Angular Material, Three.js.
+- **Slicer**: OrcaSlicer (invocato via CLI).
 
 ## Prerequisiti
 
-*   Docker Desktop & Docker Compose installati.
+*   **Java 21** installato.
+*   **Node.js 22** e **npm** installati.
+*   **PostgreSQL** attivo.
+*   **OrcaSlicer** installato sul sistema.
 
 ## Avvio Rapido
 
-1.  Clona il repository.
-2.  Esegui lo script di avvio o docker-compose:
-    ```bash
-    docker-compose up --build
-    ```
-    *Nota: La prima build impiegherà alcuni minuti per scaricare OrcaSlicer (~200MB) e compilare il Frontend.*
+### 1. Database
+Crea un database PostgreSQL chiamato `printcalc`. Le tabelle verranno create automaticamente al primo avvio tramite Flyway.
 
-3.  Accedi all'applicazione:
-    *   **Frontend**: [http://localhost](http://localhost)
-    *   **API Docs**: [http://localhost:8000/docs](http://localhost:8000/docs)
+### 2. Backend
+Configura il percorso di OrcaSlicer in `backend/src/main/resources/application.properties` o tramite la variabile d'ambiente `SLICER_PATH`.
 
-## Configurazione Prezzi
-
-Puoi modificare i prezzi nel file `docker-compose.yml` (sezione `environment` del servizio backend):
-
-*   `FILAMENT_COST_PER_KG`: Costo filamento al kg (es. 25.0).
-*   `MACHINE_COST_PER_HOUR`: Costo orario macchina (ammortamento/manutenzione).
-*   `ENERGY_COST_PER_KWH`: Costo energia elettrica.
-*   `MARKUP_PERCENT`: Margine di profitto percentuale (es. 20 = +20%).
-
-## Struttura del Progetto
-
-*   `/backend`: API Python FastAPI. Include Dockerfile che scarica OrcaSlicer AppImage.
-*   `/frontend`: Applicazione Angular 19+ con Material Design.
-*   `/backend/profiles`: Contiene i profili di slicing (.ini). Attualmente configurato per una stima generica simil-Bambu Lab A1.
-
-## Troubleshooting
-
-### Errore Download OrcaSlicer
-Se la build del backend fallisce durante il download di `OrcaSlicer.AppImage`, verifica la tua connessione internet o aggiorna l'URL nel `backend/Dockerfile`.
-
-### Slicing Fallito (Costo 0 o Errore)
-Se l'API ritorna errore o valori nulli:
-1.  Controlla che il file STL sia valido (manifold).
-2.  Controlla i log del backend: `docker logs print-calculator-backend`.
-
-## Sviluppo Locale (Senza Docker)
-
-**Backend**:
-Richiede Linux (o WSL2) per eseguire l'AppImage di OrcaSlicer.
 ```bash
 cd backend
-pip install -r requirements.txt
-# Assicurati di avere OrcaSlicer installato e nel PATH o aggiorna SLICER_PATH in slicer.py
-uvicorn main:app --reload
+./gradlew bootRun
 ```
 
-**Frontend**:
+### 3. Frontend
 ```bash
 cd frontend
 npm install
 npm start
 ```
+
+Accedi a [http://localhost:4200](http://localhost:4200).
+
+## Configurazione Prezzi
+
+I prezzi non sono più gestiti tramite variabili d'ambiente fisse ma tramite tabelle nel database:
+- `pricing_policy`: Definisce markup, fee fissi e costi elettrici.
+- `pricing_policy_machine_hour_tier`: Definisce i costi orari delle macchine in base alla durata della stampa.
+- `printer_machine`: Anagrafica stampanti e consumi energetici.
+- `filament_material_type` / `filament_variant`: Listino prezzi materiali.
+
+## Struttura del Progetto
+
+*   `/backend`: API Spring Boot.
+*   `/frontend`: Applicazione Angular.
+*   `/backend/profiles`: Contiene i file di configurazione per OrcaSlicer.
+
+## Troubleshooting
+
+### Percorso OrcaSlicer
+Assicurati che `slicer.path` punti al binario corretto. Su macOS è solitamente `/Applications/OrcaSlicer.app/Contents/MacOS/OrcaSlicer`. Su Linux è il percorso all'AppImage (estratta o meno).
+
+### Database connection
+Verifica le credenziali in `application.properties`. Se usi Docker, puoi passare `DB_URL`, `DB_USERNAME` e `DB_PASSWORD` come variabili d'ambiente.