Files
lux/README.md
T
2025-06-14 12:57:56 +02:00

152 lines
6.0 KiB
Markdown

# LUX
Progetto per la realizzazione del "MES dei Falegnami"; che deve gestire il flusso logistico almeno di
* produzione finestre e serramenti
* produzione porte ...
## To Do
- [ ] Completare la documentazione
- [ ] Setup repo agli sviluppatori
- [ ] Definizione struttura progetti
## Elementi della soluzione - Entità gestite
### Offerta
L'offerta è il primo documento che il cliente si trova a generare prima di realizzare un nuovo progetto.
Lofferta deve contenere riferimenti alle seguenti entità ARTICOLO:
* prodotti forniti (i serramenti)
* servizi forniti (installazione)
* accessori impliciti (certificazioni prodotto, )
* accessori opzionali
L'offerta è intestata ad una PERSONA (fisica o legale)
L'offerta avrà dei dati di testata (relativi alla persona di chi offre e di chi riceve) + dati di dettaglio di tutti gli ARTICOLI offerti + dei dati di reseconto in termini di
* tempi
* costi
indicati in modo analitico per ogni articolo (quantià * prezzo) + riassunti globalmente
L'offerta ha un termine di validità (STANDARD)
L'offerta è archiviata in un set informativo e può evolvere di stato o natura (offerta confermata vs ordine)
L'offerta di norma è generata dal cliente, ma può essere prodotta per suo conto da un AGENTE /mandatario/rivenditore, che è anche lui una persona con permessi speciali che può generare offerte per nome e conto.
Gli agenti costituiscono un criterio di ricerca e raggruppamento delle offerte per poter essere indivuate.
Gli agenti hanno un "listino" dato da
* prezzo a listino (aumentato...)
* prezzo standard proposto di vendita
* prezzo rock bottom minimo concesso
* costo effettivo aziendale (comprensivo di margini minimi, ricarichi, costi OH)
La valutazione degli agenti permette di classificarne l'efficienza in termini di% sulla differenza costo proposto/rockbottom e valutare se gestire la provvigione sulal abse di questo (step 2)
L'offerta ha uno stato
* aperta
* chiusa con ordine
* persa
Un offerta può essere modificata nel tempo.
Di un offerta teniamo sempre ultima versione + numero revisione (x tracciare numero modifiche ) + eventuale pdf dei documenti di ogni revisione (opzionale)
### PERSONA
La persona individua un soggetto fisico o giuridico destinatario di una operazione o un riferimento.
Avrà gli attributi per definire la sua natura in termini di ruoli ammessi tra
* cliente
* fornitore
in qudsto caso i dati fiscali di riferimento devono essere completi per la documentazione tecnico/economica e fiscale di goni offerta/commessa/ordine
Inoltre un tipo speciale di PERSONA è quello dell'utente applicativo distinto almeno dai seguenti ruoli
* utente interno standard
* agente
* responsabile/amministratore interno
### ARTICOLO
Gli articoli possono essere distinti per
* fisico / servizio
* make / buy
* in caso di varianti fornitori articolo è 1 solo e gestiamo varianti fornitori come relazione esterna (con prezzo/quantità/tempi)
Gli articoli conterranno minimo i seguenti dati
* codice univoco interno
* descrizione
* codice fornitore (opzionale)
* codice parlante interno
* costo/prezzo (? listini esterni?)
* margine standard (per classe?)
Gli articoli saranno una classe di abse, estesa dalle tipologie specifiche con attributi (es dimensioni, tipologia, colore...) specifici opzionali
### Composer
Il flusso di realizzazione di un offerta, dopo la fase di intestazione dell'offerta ad una persona, prevede di inserire 1-n articoli di diversa natura.
Quelli in rivendita/servizi sono esplicità (quantità/costo)
Gli articoli più complessi e oggetto del progetto saranno inseriti con una procedura SPECIALE; che prevede di
* TIPO DI OFFERTA (x ora fissa a serramenti)
* selezionare 1-n attributi "generali" dell'offerta, ad esempio
* tipologia (legno, legno-alluminio, pvc)
* tipologia del vetro
* spessore del serramento
* ... tutti gli attributi sono bloccabili a livello di istanza o meno (x evitare sovrascritture da parte dell'offerta contenitore)
* selezione di un articolo DA TEMPLATE (da ragioanre se davvero articolo o un sotto oggetto)
* l'articolo da template è a tutti gli effetti una singola istanza (SALVATA) di un progetto di una finestra template con le informazioni necessarie e sufficienti a definirla completamente fino a tempi/costi
* questo articolo pò essere ricalcolato ogni giorno/settimana/... per essere valido come prima stima
* il tempalte può essere inserito con valori standard di impostazione e valori calcolati standard di prezzo/tempi x avere una prima stima dell'offerta
* l'elenco dei template è ovviametne estendibile da aprte dell'utente finale
* ogni istanza di finestra (comprensiva dei suoi dati di calcolo) deve essere salvata insieme ai vari file/json/set informativi di corredo, tracui
* json di progettazione
* json/xml di richiesta/risposta ferramenta
* json/csv di configurazione della BOM prevista dei vari componenti
* altri file o oggetti encessari alle fasi di offerta fornitore e/o calcolo effettivo in produzione
* l'insieme delle informazioni collezionate a livello di offerta sono poi oggetto di VALIDAZIONE in fase di conferma ordine prima della traduzione in termini di COMMESSA effettiva di lavoro.
#### Template
Ogni template rappresenterà un intero serramento configurato.
Idealmente si parte SEMPRE da un template di fiestra definito.
I template di base (nell'ordine di una decina) saranno installati da noi con il sw, l'utente potrà modificarli e/o intergrare con nuovi.
Un template può essere salvata solo se valido (validato dal motore di calcolo).
### Engine
CI saranno ALMENO 2 motori:
* engine completo che contiene il CAM e fa calcoli esatti
* eingine semplificato da browser (Threejs?)
questi 2 motori sono in grado di leggere entrambi il json di configurazione serramento (JWD = Json Windows Definition) e generare uno un modello completo e l'altro uno semplificato
L'operatività di editing sarà fatta nel browser sul modello semplificato
Eventuali "equilibrismi" richiederanno valutazione/gestione con motore CAM.
### BOM
### Cicli
#### Pezzo
## Version History
tabella versioni