Modelli, Moduli e App

I modelli determinano la struttura logica del database e definiscono come i dati vengono memorizzati, organizzati e manipolati. In altre parole, un modello rappresenta una tabella di informazioni che può essere collegata ad altre tabelle.

Un modello solitamente rappresenta un concetto aziendale, come un ordine di lavaggio, contatto cliente, o articolo nel contesto di una lavanderia industriale.

Moduli e app contengono vari elementi come modelli, viste, file dati, controller web e dati statici.

Funzionalità Suggerite {#suggested-features}

Quando crei un nuovo modello o app con lo strumento di Personalizzazione, puoi scegliere di aggiungere fino a 14 funzionalità predefinite per velocizzare il processo di creazione. Queste funzionalità raggruppano campi, impostazioni predefinite e viste che vengono solitamente utilizzati insieme per fornire funzionalità standard.

La maggior parte di queste funzionalità può essere aggiunta successivamente, ma aggiungerle dall'inizio rende il processo di creazione del modello molto più semplice. Inoltre, queste funzionalità interagiscono tra loro in alcuni casi per aumentare la loro utilità.

1. Dettagli Contatto {#contact-details}

Aggiunge alla vista Modulo un campo Many2One collegato al modello Contatti e due dei suoi campi correlati: Telefono ed Email. Il campo Contatto viene anche aggiunto alla vista Elenco, e la vista Mappa viene attivata.

Utilizzo pratico in lavanderia:

• Collegare ordini di lavaggio ai clienti con accesso rapido a telefono ed email
• Visualizzare clienti su mappa per ottimizzare giri di consegna
• Gestire contatti di hotel/ristoranti con riferimenti diretti negli ordini

2. Assegnazione Utente {#user-assignment}

Aggiunge alla vista Modulo un campo Many2One collegato al modello Contatti, con un filtro che permette di selezionare solo Utenti Interni (escludendo utenti esterni). Utilizza il widget many2one_avatar_user per visualizzare l'avatar dell'utente. Il campo Responsabile viene anche aggiunto alla vista Elenco.

Utilizzo pratico in lavanderia:

• Assegnare ordini di lavaggio a operatori specifici
• Identificare responsabili di lotti di produzione
• Gestire turni e responsabilità per sezioni (lavaggio, stiro, confezionamento)

3. Data e Calendario {#date-calendar}

Aggiunge alla vista Modulo un campo Data e attiva la vista Calendario.

Utilizzo pratico in lavanderia:

• Pianificare date di consegna ordini
• Gestire calendario manutenzioni macchinari
• Schedulare turni di lavoro o appuntamenti con clienti

4. Intervallo Date e Gantt {#date-range-gantt}

Aggiunge alla vista Modulo due campi Data affiancati (data inizio e data fine) utilizzando il widget daterange, e attiva la vista Gantt.

Utilizzo pratico in lavanderia:

• Monitorare durata cicli di lavaggio completi (ritiro → lavaggio → riconsegna)
• Pianificare manutenzioni programmate con inizio e fine intervento
• Gestire contratti di noleggio biancheria con periodo di validità

5. Fasi Pipeline {#pipeline-stages}

Attiva la vista Kanban e aggiunge diversi campi come Priorità e Stato Kanban, insieme a tre fasi predefinite: Nuovo, In Corso e Completato. La barra di stato pipeline e il campo Stato Kanban vengono aggiunti alla vista Modulo. Il campo Colore viene aggiunto alla vista Elenco.

Utilizzo pratico in lavanderia:

• Gestire workflow ordini: Ricevuto → In Lavaggio → In Stiro → Pronto → Consegnato
• Monitorare stato lavorazioni speciali (sanificazione, smacchiatura)
• Tracciare avanzamento produzione lotti biancheria

6. Tag {#tags}

Aggiunge alle viste Modulo ed Elenco un campo Tag, creando automaticamente un modello Tag con diritti di accesso preconfigurati.

Utilizzo pratico in lavanderia:

• Classificare articoli per tipo: #biancheria-piana, #divise, #tovagliato
• Etichettare clienti: #hotel, #ristorante, #ospedale, #casa-riposo
• Marcare ordini speciali: #urgente, #sanificazione-certificata, #eco-wash

7. Immagine {#picture}

Aggiunge in alto a destra nella vista Modulo un campo Immagine.

Utilizzo pratico in lavanderia:

• Fotografare articoli danneggiati o con macchie per tracciabilità
• Documentare risultati di lavaggi speciali
• Archiviare foto di referenza per divise personalizzate

8. Elementi Riga {#lines}

Aggiunge alla vista Modulo un campo Righe (tabella relazionale) all'interno di un componente Scheda.

Utilizzo pratico in lavanderia:

• Dettagliare articoli in un ordine (quantità, tipo capo, prezzo unitario)
• Gestire distinte base per kit biancheria (es. "Kit Camera Standard": 2 lenzuola, 2 federe, 1 coperta)
• Registrare consumi materiali per lavorazione (detersivi, additivi)

9. Note {#notes}

Aggiunge alla vista Modulo un campo HTML che utilizza l'intera larghezza del modulo, ideale per note estese formattate.

Utilizzo pratico in lavanderia:

• Annotare istruzioni speciali per lavaggio (es. "Non usare candeggina")
• Documentare accordi particolari con cliente
• Registrare note operative per turno successivo

10. Valore Monetario {#monetary-value}

Aggiunge alle viste Modulo ed Elenco un campo Monetario e attiva le viste Grafico e Pivot per analisi finanziarie.

Utilizzo pratico in lavanderia:

• Calcolare totale ordine con prezzi articoli
• Monitorare fatturato giornaliero/mensile
• Analizzare margini per tipo di cliente o servizio

11. Azienda {#company}

Aggiunge alle viste Modulo ed Elenco un campo Many2One collegato al modello Aziende.

Utilizzo pratico in lavanderia:

• Gestire dati separati per filiali diverse (Lavanderia Nord/Sud)
• Amministrare società del gruppo con database condiviso
• Tracciare ordini per sede operativa

12. Ordinamento Personalizzato {#custom-sorting}

Aggiunge alla vista Elenco un'icona a forma di maniglia per riordinare manualmente i record trascinandoli.

Utilizzo pratico in lavanderia:

• Prioritizzare ordini urgenti manualmente
• Riordinare sequenza di lavorazione per ottimizzare flusso produzione
• Organizzare clienti per importanza strategica

13. Chatter {#chatter}

Aggiunge alla vista Modulo le funzionalità Chatter (invio messaggi, note interne, pianificazione attività).

Utilizzo pratico in lavanderia:

• Comunicare tra operatori su ordini complessi
• Registrare chiamate clienti per reclami o variazioni
• Pianificare follow-up per ordini ritardati
• Notificare team di magazzino per prelievi urgenti

14. Archiviazione {#archiving}

Aggiunge alle viste Modulo ed Elenco l'azione Archivia e nasconde i record archiviati da ricerche e viste per impostazione predefinita.

Utilizzo pratico in lavanderia:

• Archiviare ordini completati e consegnati
• Disattivare clienti non più attivi senza cancellarli
• Nascondere articoli fuori produzione mantenendo storico

Export e Import Personalizzazioni {#export-import}

Quando effettui personalizzazioni con lo strumento Personalizzazione, viene aggiunto al database un nuovo modulo denominato studio_customization. Puoi esportare questo modulo come file ZIP utilizzando la funzione Export Personalizzazione.

Il modulo può poi essere importato in un altro database Laundry ERP. Questo è utile, ad esempio, quando si configura una nuova filiale o per scopi di formazione.

Export Personalizzazioni {#export}

Per esportare le personalizzazioni:

1. Clicca il pulsante Personalizzazione sulla dashboard principale di Laundry ERP
2. Seleziona Export
3. Scegli una delle seguenti opzioni:
   • Scarica tutte le personalizzazioni cliccando il pulsante Export
   • Configura cosa esportare cliccando Configura dati e dati demo da esportare

Configurare Dati da Esportare {#export-configure}

Per selezionare modelli specifici da esportare:

1. Clicca Nuovo nella schermata Export Personalizzazione
2. Inizia a digitare il nome del modello rilevante o selezionalo dalla lista

Seleziona le seguenti opzioni se rilevanti:

• Demo: se i record esportati devono essere considerati dati demo quando importati
• Allegati: se gli allegati correlati ai record esportati devono essere inclusi
• Aggiornabile: se i record esportati possono essere aggiornati durante un aggiornamento del modulo

Se necessario, modifica il Dominio per determinare quali record del modello devono essere esportati cliccando il pulsante Modifica Dominio.

Dopo aver configurato un modello per l'export, clicca Export Personalizzazione per tornare alla schermata principale. Per scaricare un file ZIP con le personalizzazioni per tutti i modelli elencati, clicca Export.

Nella finestra Export Personalizzazione:

• Lascia le caselle deselezionate per esportare solo le personalizzazioni fatte con Personalizzazione
• Seleziona Includi Dati per includere i dati dai modelli selezionati nell'export
• Seleziona Includi Dati Demo per includere i dati demo dai modelli selezionati

Clicca il pulsante Export per scaricare il file ZIP.

Import Personalizzazioni {#import}

Per importare e installare personalizzazioni in un altro database Laundry ERP:

1. Connettiti al database di destinazione
2. Clicca il pulsante Personalizzazione sulla dashboard principale
3. Seleziona Import
4. Carica il file ZIP esportato. Se i dati demo devono essere importati, seleziona Carica dati demo
5. Clicca Installa

Best Practices per Lavanderie

Pianificazione Modelli

Quando crei nuovi modelli per la tua lavanderia:

1. Analizza il processo: Identifica tutti i passaggi del workflow (ritiro → lavaggio → stiro → confezionamento → consegna)
2. Scegli funzionalità adeguate: Per ordini di lavaggio, considera: Fasi Pipeline, Chatter, Elementi Riga, Valore Monetario, Data e Calendario
3. Pensa all'integrazione: Considera come il nuovo modello si collega a modelli esistenti (clienti, articoli, contratti)

Esempi di Modelli Tipici

Ordine di Lavaggio Speciale:

• Funzionalità: Dettagli Contatto, Data e Calendario, Fasi Pipeline, Elementi Riga, Valore Monetario, Chatter, Tag, Note, Immagine
• Uso: Gestire richieste particolari (sanificazione certificata, lavaggio urgente, trattamento macchie)

Manutenzione Macchinario:

• Funzionalità: Assegnazione Utente, Intervallo Date e Gantt, Chatter, Immagine, Valore Monetario
• Uso: Pianificare e tracciare interventi su lavatrici, essiccatoi, tunnel di finitura

Kit Biancheria Contratto:

• Funzionalità: Dettagli Contatto, Elementi Riga, Tag, Valore Monetario, Archiviazione
• Uso: Definire composizione kit standard per contratti hotel/ristoranti

Reclamo Cliente:

• Funzionalità: Dettagli Contatto, Fasi Pipeline, Chatter, Immagine, Note, Assegnazione Utente
• Uso: Tracciare segnalazioni qualità e risoluzione problemi