netgescon-master/docs/02-architettura-laravel/specifiche/definizioni per gestione ticket.txt

buongiorno! allora dobbiamo integrare meglio la gestione dei ticket lo voglio far diventare il nodo centrale della gestione condominiale, devo poter registrare i ticket che possono venire dai condomini e/o internamente da collaboratori o dall'amministratore, 
Li devo poter assegnare a chi deve fare l'intervento  a seconda del problema perciò devo poter gestire anche delle priorità. 
Chi li inserisce deve poter mettere e/o allegare foto e documenti normalmente in PDF, se possibile prevedere di poter scattare delle foto direttamente dalla pagina del sito dopo aver fatto il login.
Le foto inviate devono essere scalate onde evitare di occupare spazio sul server inutilmente,  gestiamo una compressione o scalatura delle immagini. 
La richiesta di ticket deve poter seguire varie strade o essere assegnata in base alla richiesta direttamente al manutentore / ditta / fornitore e procedere all'invio che deve essere presa in carico e confermata per procedere altrimenti deve essere riassegnata.
Una volta assegnata diamo una mano alla ditta/manutentore/fornitore che inserisce all'interno della sua area riservata il lavoro fatto e i materiali usati e relativi costi per l'intervento,  noi diamo una mano ai manutentori che non hanno di solito dei programmi per gestire gli interventi con programmi loro gestiscono il loro ticket con tutte le note e altro che ha ritiene opportuno chi fa l'internvento, poi può procedere con la richiesta della chiusura del ticket,  terminato il lavoro/ intervento generiamo una fattura proforma che poi ci viene inviata ma a noi a questo punto abbiamo già pronto tutto il proforma da inserire in contabilità.
Per quanto riguarda la contabilità (che vedremo in una secondo momento dove dovremo definire gli archivi e la modalità di registrazione ma comunque di base deve essere fatta in partita doppia),
Procediamo con il ticket se lavorato e terminato abbiamo chiuso ed inviato il messeggio di chiusura a chi ha aperto il ticket e all'amministratore/collaboratore per la definizione dell'intervento,e preparata la proforma che sarà chiusa con la ricezione della fattura dal cassetto fiscale in formato XML.
Invece per i ticket che hanno problemi dobbiamo cominciare a pensare ad altri piani di lavoro deve poter essere riassegnato a qualcun altro o andare a questo punto in archivo speciale dove deve essere gestito direttamente dallo studio dell'amministratore,
questi problemi potrebbero generare dei lavori straordinari perciò dobbiamo prevedere la gesione pre lavori straordinari che poi devono essere gestiti con tutta la procedura normale del condominio detta in breve (convocazione assemblea secondo le modalità date dalla legge, approvazione preventivo, ripartizione spese su tabelle e millesimi per quel lavoro, invio comunicazioni per la gestione dei lavori straordinari, emissione rate sulla base del preventino, aggiunta rate per ulteriori spese non preventivate, incasso rate e gestione solleciti, chiusura del bilancio e passaggio degli ultimi conguagli se non pagati nella gestione ordinaria come spesa individuale) questi i passaggi per la gestione base delle straordinarie ma anche qui ci potrebbero essere problemi ma che vedremo in separata sede. 
le strade possono essere varie, può essere mandato all'Assicurazione e devo poter gestire a questo punto le pratiche assicurative ma per ora prevedi solo il menù per gestire i ticket aperti verso queste strade.
O nel caso peggiore va prima in mediazione o poi in tribunale e a questo punto dobbamo gestire le pratiche legali, ma anche questo prevedi per ora solo il menu per gestire le pratiche legali.
Naturalmente il tutto va poi ricordato e messo nel calendario di google con un calendario apposta ma anche questo lo vediamo poi.
perciò i ticket non lavorati o con dei problemi deve essere gestito dallo studio dove deve poter controllare il percorso dello stesso che alla fine potrebbe avere più strade, naturlmente le varie comunicazioni devono essere sempre regsitrate in un registro di protocollo delle comunicazioni per tenere traccia del lavoro fatto nel tempo, naturlmente il registro del protocollo non terrà le comunicazioni solo dei ticket ma di qualsiasi comunicazione fatta e a chi perciò poi gestremo anche dei collegamenti con la posta normale con la casella su Gmail ma dovremi poi gestire anche la PEC e altre forme d'invio tipo RR, posta in cassetta, ricevuta a mano, invio su portale, e quanto altro possimo pensare per comunicare con i condomini/fornotori/ditte ecc.
perciò ora creiamo la struttura completa e funzionante della gestione dei ticket, nel frattempo l'altra squadra sta lavorando ti ricordi allìestrazione dei dati 


^^^^^^^^^^^^^^^^^^^^^^
programma di lavoro 
Progetto: Gestione Avanzata Ticket Condominiali
Obiettivo
Rendere il modulo Ticket il nodo centrale della gestione condominiale, integrando workflow, allegati, assegnazioni, gestione priorità, comunicazioni e preparazione automatica della contabilità.

Funzionalità da implementare

1. Creazione e gestione ticket
I ticket possono essere creati da:
Condomini (area riservata)
Collaboratori/amministratore
Ogni ticket deve avere:
Oggetto, descrizione, categoria/problema
Priorità (bassa, media, alta, urgente)
Possibilità di allegare file (PDF, immagini, documenti)
Possibilità di scattare foto direttamente dalla pagina (da mobile/desktop)
Compressione/scalatura automatica delle immagini caricate

2. Assegnazione e workflow
I ticket possono essere:
Assegnati automaticamente o manualmente a manutentori/ditte/fornitori in base alla categoria
Presi in carico e confermati dal destinatario
Riassegnati se necessario
Stato ticket: aperto, in lavorazione, in attesa, chiuso, riassegnato, archiviato speciale

3. Area riservata manutentori/fornitori
Ogni manutentore/fornitore ha una propria area riservata dove:
Visualizza i ticket assegnati
Inserisce dettagli intervento, materiali usati, costi
Può allegare documenti e note
Può richiedere la chiusura del ticket

4. Gestione chiusura e proforma
Alla chiusura del ticket:
Invio notifica di chiusura a chi ha aperto il ticket e all’amministratore
Generazione automatica di una fattura proforma (da validare)
Preparazione dati per la contabilità (partita doppia, da definire in dettaglio)

5. Gestione ticket problematici
Ticket non risolti o con problemi:
Possibilità di riassegnazione
Possibilità di archiviazione speciale per gestione amministrativa
Possibilità di avvio pratiche straordinarie (convocazione assemblea, preventivi, rate, ecc.)
Possibilità di avvio pratiche assicurative (solo menu e struttura)
Possibilità di avvio pratiche legali (solo menu e struttura)

6. Registro comunicazioni e protocollo
Ogni azione/comunicazione su ticket e pratiche deve essere registrata in un registro di protocollo
Il registro deve poter gestire anche comunicazioni non legate ai ticket (es. invio posta, PEC, RR, portale, ecc.)
Prevedere la futura integrazione con Gmail, PEC, Google Calendar

7. Altre funzionalità
Pannello di controllo per lo studio amministrativo per monitorare lo stato e il percorso di ogni ticket
Notifiche automatiche via email e/o sistema
Pannello di gestione pratiche assicurative e legali (inizialmente solo struttura/menu)
Tutte le azioni devono essere tracciate (audit log)

Struttura tecnica da preparare
Database
Tabella tickets (con relazioni a utenti, fornitori, stabili, priorità, stato, ecc.)
Tabella ticket_allegati (per file e immagini, con compressione/scalatura immagini lato server)
Tabella ticket_log (registro azioni e comunicazioni)
Tabelle di supporto: categorie_ticket, priorita_ticket, stati_ticket, fornitori, manutentori, pratiche_assicurative, pratiche_legali, ecc.

Backend
Controller e Livewire component per:
CRUD ticket
Gestione allegati (upload, compressione, preview)
Workflow assegnazione e cambio stato
Area riservata manutentori/fornitori
Registro protocollo
Gestione pratiche assicurative/legali (solo struttura/menu)
Policy e autorizzazioni granulari

Frontend
Maschera creazione/modifica ticket con:
Upload multiplo file/immagini
Scatto foto da browser (usando JS/HTML5)
Selezione priorità, categoria, destinatario
Dashboard ticket per amministratore e manutentori
Area riservata manutentori/fornitori
Registro comunicazioni/protocollo
Menu per pratiche assicurative/legali

Extra
Notifiche email e/o toast
Audit log
Preparazione dati per contabilità (proforma)
Roadmap e priorità
Database e modelli
CRUD ticket e allegati
Workflow assegnazione/priorità
Area manutentori/fornitori
Registro protocollo
Menu pratiche assicurative/legali
Notifiche e audit log
Preparazione dati proforma per contabilità

Note
Prevedere la scalabilità per multi-condominio e multi-amministratore
Documentare bene API, modelli e workflow
Tutto il codice deve essere testato e versionato