Il documento descrive la struttura e il significato semantico delle tabelle che compongono il database di ticketing per la gestione degli RMA (Return Merchandise Authorization) relativi alla sostituzione di componenti d'impianto per Alstom.
Il database principale si chiama Ticketing_DB_tickets_IXL. Ne esistono altri due analoghi, Ticketing_DB_tickets_TMS e Ticketing_DB_tickets, che coprono tecnologie differenti ma condividono la medesima struttura: comprendere uno equivale, dal punto di vista dello schema, a comprendere tutti e tre.
Il database è composto da cinque tabelle:
| Tabella |
Descrizione sintetica |
| stati |
Elenco degli stati logici del ticket |
| repairing |
Dati dei componenti da sostituire/sostituiti |
| ticket |
Anagrafica e ciclo di vita del ticket |
| ticket_repairing |
Dettaglio tecnico e operativo del ticket |
| ticket_repairing_id_intervento |
Registro progressivo degli ID intervento |
Tabella di lookup che definisce gli stati logici possibili di un ticket RMA.
| Colonna |
Tipo |
Descrizione |
| id |
int(11) |
Identificativo auto-incrementale |
| stato |
text |
Etichetta dello stato logico (es. Open, Validated, Waiting Pickup) |
| ordine |
int(11) |
Ordine sequenziale logico degli stati |
Contiene le informazioni sui componenti coinvolti nella sostituzione, sia quelli difettosi sia quelli nuovi. Prevede anche colonne "corrette" per tracciare le eventuali rettifiche apportate da un amministratore o utente di controllo Alstom.
| Colonna |
Tipo |
Descrizione |
| id |
bigint(20) |
Identificativo auto-incrementale |
| ticket_id |
bigint(20) |
Riferimento all'id della tabella ticket |
| pn_fault |
varchar(45) |
Part number del componente da sostituire |
| sn_fault |
varchar(45) |
Serial number del componente da sostituire |
| pn_new |
varchar(45) |
Part number del componente nuovo |
| sn_new |
varchar(45) |
Serial number del componente nuovo |
| pn_fault_corretto |
varchar(45) |
Part number corretto del componente difettoso (rettifica) |
| sn_fault_corretto |
varchar(45) |
Serial number corretto del componente difettoso (rettifica) |
| pn_new_corretto |
varchar(45) |
Part number corretto del componente nuovo (rettifica) |
| sn_new_corretto |
varchar(45) |
Serial number corretto del componente nuovo (rettifica) |
Nota: La coppia part number + serial number identifica univocamente un componente fisico. Le quattro colonne _corretto preservano la tracciabilità dei valori originali qualora un amministratore debba correggere quanto inserito dall'utente.
Anagrafica principale del ticket RMA. Tiene traccia dell'identità del ticket, dell'utente creatore, dello stato corrente e dell'intera cronologia temporale degli stati attraverso una serie di colonne timestamp_*.
| Colonna |
Tipo |
Descrizione |
| unique_ticket_id |
bigint(20) |
ID univoco del ticket, comunicato al cliente; chiave sorgente per tutte le tabelle collegate |
| user_username |
varchar(45) |
Username dell'utente che ha generato l'RMA |
| lista_utente |
varchar(45) |
ID della lista alla quale l'utente è eventualmente associato |
| ticket_type |
varchar(45) |
Tipologia del ticket |
| state_label |
varchar(45) |
Stato corrente del ticket; dovrebbe essere collegato alla tabella stati |
| cancelled |
bigint(20) |
ID del ticket sostitutivo creato in seguito alla cancellazione del ticket corrente, in caso contrario viene compilato con 0 |
| service_assigned |
varchar(20) |
Sede Alstom di destinazione del componente difettoso |
| brevi_manu |
varchar(2) |
Flag (Sì/No): indica se il reintegro del componente è avvenuto tramite consegna a mano anziché corriere. Selezionabile solo se service_assigned = Bologna |
| reintegrated |
varchar(1) |
X maiuscola se il componente nuovo è stato consegnato al cliente; altrimenti NULL |
| user_pic_username |
varchar(45) |
Username utente PIC (campo raramente valorizzato) |
| Colonna |
Tipo |
Descrizione |
| timestamp_open |
datetime |
Data/ora del primo verificarsi dello stato Open |
| timestamp_assigned |
datetime |
Data/ora del primo verificarsi dello stato Assigned |
| timestamp_validated |
datetime |
Data/ora del primo verificarsi dello stato Validated |
| timestamp_waiting_pickup |
datetime |
Data/ora del primo verificarsi dello stato Waiting Pickup |
| timestamp_confirmed_pickup |
datetime |
Data/ora del primo verificarsi dello stato Confirmed Pickup |
| timestamp_booked_pickup |
datetime |
Data/ora del primo verificarsi dello stato Booked Pickup |
| timestamp_quarantine |
datetime |
Data/ora del primo verificarsi dello stato Quarantine |
| timestamp_completed_pickup |
datetime |
Data/ora del primo verificarsi dello stato Completed Pickup |
| timestamp_arrived |
datetime |
Data/ora del primo verificarsi dello stato Arrived |
| timestamp_registered |
datetime |
Data/ora del primo verificarsi dello stato Registered |
| timestamp_reintegrated |
datetime |
Data/ora del primo verificarsi dello stato Reintegrated |
| timestamp_closed |
datetime |
Data/ora del primo verificarsi dello stato Closed |
| timestamp_canceled |
datetime |
Data/ora del primo verificarsi dello stato Canceled |
| timestamp_automatic_rule |
datetime |
Data/ora del primo verificarsi dello stato Automatic Rule |
| timestamp_delivered |
datetime |
Data/ora del primo verificarsi dello stato Delivered |
Nota sul campo cancelled: Se il ticket n. 20 viene cancellato e se ne crea uno nuovo (es. n. 22), il campo cancelled del ticket 20 conterrà il valore 22.
La tabella più ricca del database. Contiene i dettagli tecnici, logistici e operativi relativi all'intervento di sostituzione associato al ticket RMA.
| Colonna |
Tipo |
Descrizione |
| id |
bigint(20) |
ID del ticket; collegato alla tabella ticket |
| customer_label |
varchar(45) |
Stringa identificativa del cliente (es. RFI, ATM) |
| technology_label |
varchar(45) |
Tecnologia oggetto del ticket (es. IXL, CTC, TRK) |
| warehouse_label |
varchar(45) |
Divisione dell'azienda richiedente |
| Colonna |
Tipo |
Descrizione |
| pbs |
varchar(45) |
Etichetta impianto nella logica Alstom Control Room (tabella impianto) |
| impianto_specifico |
varchar(200) |
Etichetta locale nella logica Alstom Control Room (tabella locale) |
| sottosistema |
varchar(45) |
Etichetta apparato nella logica Alstom Control Room (tabella apparato) |
| zona_ente |
varchar(45) |
Campo attualmente sempre nullo |
| apparato_specifico |
varchar(45) |
Campo attualmente sempre nullo |
| Colonna |
Tipo |
Descrizione |
| data_avaria |
date |
Data (AAAA-MM-GG) in cui si è verificato il guasto |
| descrizione_avaria |
mediumtext |
Descrizione testuale dell'avaria |
| messaggio_diagnostica |
mediumtext |
Messaggio generato dal sistema di diagnostica d'impianto |
| effetto |
varchar(45) |
Effetto del guasto (campo poco utilizzato) |
| gravita |
varchar(45) |
Gravità del guasto (campo poco utilizzato) |
| sottosistema_funzione |
varchar(45) |
Funzione del sottosistema (campo poco utilizzato) |
| impatto_avaria |
varchar(45) |
Impatto dell'avaria (campo poco utilizzato) |
| Colonna |
Tipo |
Descrizione |
| id_intervento |
bigint(20) |
ID dell'intervento; collegato alla tabella ticket_repairing_id_intervento |
| data_intervento |
datetime |
Data e ora di inizio dell'intervento di analisi da parte del service desk |
| fine_intervento |
datetime |
Data e ora di fine dell'intervento |
| durata |
decimal(3,1) |
Durata dell'intervento in formato decimale |
| manutentore |
varchar(45) |
Nominativo del manutentore che ha effettuato l'intervento |
| descrizione_intervento |
mediumtext |
Descrizione dettagliata delle attività svolte durante l'intervento (campo chiave) |
| tools |
mediumtext |
Strumenti utilizzati (campo attualmente sempre nullo) |
| classificazione_intervento |
varchar(45) |
Classificazione dell'intervento (campo sempre nullo) |
| classificazione_intervento_altro |
mediumtext |
Classificazione libera (campo sempre nullo) |
| modalita_intervento |
varchar(45) |
Modalità dell'intervento (campo sempre nullo) |
| modalita_intervento_altro |
mediumtext |
Modalità libera (campo sempre nullo) |
| Colonna |
Tipo |
Descrizione |
| n_componenti |
int(11) |
Numero di componenti coinvolti nell'RMA (può essere > 1) |
| Nome_File_Allegati |
mediumtext |
Nomi dei file allegati, separati dal delimitatore \t|\|\t |
| numero_allegati |
int(2) |
Numero di allegati; sequenzialmente coerente con Nome_File_Allegati |
| presenza_pn_installato |
tinyint(4) |
Flag presenza part number installato |
| presenza_pn_rimosso |
tinyint(4) |
Flag presenza part number rimosso |
| componente_installato_note |
mediumtext |
Note sul componente installato |
| componente_installato_note_corretto |
mediumtext |
Correzione delle note sul componente installato |
| componente_rimosso_note |
mediumtext |
Note sul componente rimosso |
| componente_rimosso_note_corretto |
mediumtext |
Correzione delle note sul componente rimosso |
| Colonna |
Tipo |
Descrizione |
| rma |
varchar(45) |
ID RMA ufficiale nel portale GSI (portale Alstom per la gestione RMA) (campo chiave) |
| sto |
varchar(45) |
Identificativo STO, analogo concettualmente all'RMA |
| shipment_address |
mediumtext |
Indirizzo di spedizione del componente nuovo |
| numero_ordinativo |
varchar(45) |
Numero ordinativo (significato non noto) |
| Colonna |
Tipo |
Descrizione |
| scorta |
tinyint(4) |
Flag: 1 se il componente sostitutivo era già disponibile presso il cliente (il componente difettoso verrà comunque restituito ad Alstom) |
| preventiva |
tinyint(4) |
Flag attualmente sempre a 0 |
| Vettura |
mediumtext |
Numero della lettera di vettura |
| Vettura_reintegro |
mediumtext |
Modalità di reintegro (es. Spedizione DHL) |
| api_tracking_status |
varchar(255) |
Stato corrente della spedizione tramite API corriere (es. Consegna effettuata, Delivered) |
| api_tracking_date |
date |
Data dell'evento di tracking |
| DDT |
mediumtext |
Numero del Documento di Trasporto |
| Data_DDT |
date |
Data di creazione del DDT |
| DATA_EntrataMerci |
date |
Data di arrivo in magazzino delle merci spedite dal cliente |
| data_ddt_cliente |
date |
Data DDT lato cliente (significato non noto) |
| equipment_rimosso |
varchar(100) |
ID dell'equipaggiamento rimosso |
| equipment_installato |
varchar(100) |
ID dell'equipaggiamento installato |
| Colonna |
Tipo |
Descrizione |
| note_ritiro_Client |
int(11) |
Note di ritiro lato cliente |
| note_ritiro_User |
mediumtext |
Note di ritiro da parte dell'utente |
| note_ritiro_Reintegro |
mediumtext |
Note relative al reintegro |
| note_rfi |
mediumtext |
Note aggiuntive specifiche RFI |
| note |
mediumtext |
Note generiche del ticket, visibili al cliente |
| note_interne |
mediumtext |
Note interne, visibili solo agli utenti Alstom di revisione; il cliente non ha accesso |
| ente |
mediumtext |
Campo ente (significato non noto) |
| tecnologia_locale |
varchar(45) |
Tecnologia effettiva del locale (es. TRK) |
| locale_codici_indirizzo_trk |
int(11) |
Codici indirizzo del locale (significato non noto; valore intero) |
Tabella minimale con un unico scopo: fungere da registro progressivo degli ID intervento.
| Colonna |
Tipo |
Descrizione |
| id_intervento |
bigint(11) |
ID progressivo dell'intervento; collegato al campo id_intervento della tabella ticket_repairing |
Attenzione: Questa tabella non contiene etichette o descrizioni proprie. È indispensabile mantenere il collegamento con ticket_repairing.id_intervento: la perdita di questo riferimento rende impossibile risalire all'intervento associato.
stati
└─ stato / ordine → (lookup) ticket.state_label
ticket
└─ unique_ticket_id → repairing.ticket_id
└─ unique_ticket_id → ticket_repairing.id
ticket_repairing
└─ id_intervento → ticket_repairing_id_intervento.id_intervento