MCTC - Motorizzazione Civile¶

Panoramica¶

L'integrazione MCTC (Ministero dei Trasporti - Motorizzazione Civile) gestisce la comunicazione dei punti patente e dei provvedimenti sui veicoli. La comunicazione avviene tramite FTP over VPN attraverso il modulo dedicato VpnMctcService.

Architettura¶

sequenceDiagram
    participant ELB as ElaborazioneService
    participant VPN as VpnMctcService
    participant MCTC as MCTC (Motorizzazione)

    ELB->>VPN: Invio file provvedimenti
    VPN->>VPN: Connessione VPN tunnel
    VPN->>MCTC: Upload FTP (file CSV/TXT)
    MCTC-->>VPN: Conferma ricezione

    Note over MCTC: Elaborazione MCTC

    VPN->>MCTC: Download FTP esiti
    MCTC-->>VPN: File esiti
    VPN-->>ELB: Risultati elaborazione

Classi di Implementazione¶

VpnMctcService¶

Modulo WAR dedicato con EJB per la comunicazione FTP over VPN. Implementa JAX-WS per l'interfaccia SOAP.

MLib - Utility e POJO¶

Classe/Package	Descrizione
Classi client FTP	Gestione connessione e trasferimento file
POJO dati MCTC	Strutture dati per messaggi MCTC

Entita JPA (MLib)¶

Entita	Tabella	Descrizione
`VvIntProvvMctc`	`vv_int_provv_mctc`	Provvedimenti integrati MCTC
`VvMsgMctc`	`vv_msg_mctc`	Messaggi scambiati con MCTC
`VvPunti`	`vv_punti`	Punti patente da comunicare
`VvPuntiStato`	`vv_punti_stato`	Stato comunicazione punti
`VvTrasmRicezPatpunti`	`vv_trasm_ricez_patpunti`	Trasmissione/ricezione punti

Tabelle di Riferimento¶

Entita	Descrizione
`VfEsitoMctc`	Codici esito elaborazione MCTC
`VfUffMctc`	Uffici MCTC competenti

Protocollo¶

Tipo: FTP over VPN
Autenticazione: Tunnel VPN + credenziali FTP
Formato dati: File CSV/TXT con tracciato record fisso
Operazioni principali:
- Upload comunicazioni punti patente
- Upload provvedimenti su veicoli
- Download esiti elaborazione
- Download aggiornamenti

Flussi Dati¶

Decurtazione Punti Patente¶

Verbale con infrazione che prevede decurtazione punti
Generazione comunicazione punti (VvPunti)
Invio batch tramite VpnMctcService
Ricezione esiti MCTC
Aggiornamento stato (VvPuntiStato)

Provvedimenti Veicoli¶

Provvedimento (sequestro, fermo, revisione)
Generazione messaggio MCTC (VvMsgMctc)
Invio tramite VpnMctcService
Ricezione conferma/esito

Configurazione¶

Parametri VPN: Configurazione nel vault ConnessioneService
Credenziali FTP: Gestite dal modulo VpnMctcService
Uffici MCTC: Tabella VfUffMctc

Riferimenti¶

Portale dell'Automobilista: https://www.ilportaledellautomobilista.it/