Domain Knowledge Base - Telecomunicazioni
Come funziona il dominio, prima di scrivere una riga di codice? Scegli un documento dall'albero a sinistra: ogni pagina spiega una parte del modello.
Regole di Business - Telecomunicazioni (IT)
Regole di business invarianti del dominio telco italiano ed europeo. Ogni regola ha un codice univoco, una descrizione, la motivazione e la priorità. Le regole sono citate nei workflow e nelle entità dove applicabili.
Fonte normativa primaria: AGCOM delibere, D.Lgs. 259/2003 (Codice delle Comunicazioni Elettroniche), Regolamento UE 531/2012 (roaming), Regolamento UE 2015/2120 (net neutrality), Legge 40/2007 (tariffazione al secondo).
---
BR-01: Tariffazione al secondo per contratti consumer
Codice: BR-01 Nome: Tariffazione-al-secondo-consumer Descrizione: Le chiamate vocali nei contratti consumer (non business) devono essere fatturate per ogni secondo di conversazione effettiva, senza scatti alla risposta o arrotondamenti per eccesso. Motivazione: Obbligo di legge italiano introdotto dalla Legge 40/2007 e ribadito da delibere AGCOM. In vigore per tutti i nuovi contratti consumer dall'1/06/2018. Fonte: AGCOM delibera 418/07/CONS. Entità coinvolte: Contratto (tipo=consumer), Traffico (tipo=voce) Priorità: OBBLIGATORIA - violazione costituisce inadempienza contrattuale e sanzione AGCOM Eccezioni: I contratti business (B2B) possono prevedere arrotondamenti diversi purché esplicitamente concordati.
---
BR-02: Completamento MNP entro 3 giorni lavorativi
Codice: BR-02 Nome: SLA-MNP-3-giorni Descrizione: Il processo di portabilità del numero mobile (MNP) deve essere completato entro 3 giorni lavorativi dalla richiesta del cliente al recipient operator. Motivazione: Obbligo normativo AGCOM Delibera 147/11/CIR. Il donating operator deve validare la richiesta entro 1 giorno lavorativo. Il cut-over tecnico avviene di norma nelle prime ore notturne. Fonte: GSMA PRD IR.26 (linee guida generali), AGCOM Delibera 147/11/CIR (norma italiana). Entità coinvolte: Contratto (stato=in_attesa_portabilita), SIM (stato=portata_out) Priorità: OBBLIGATORIA - penali AGCOM per superamento del SLA Flusso: Richiesta cliente → validazione donating operator (≤1 gg) → cut-over tecnico → SIM portata_out
---
BR-03: Portabilità del numero non bloccabile
Codice: BR-03 Nome: MNP-non-bloccabile Descrizione: Il donating operator non può bloccare o rifiutare la portabilità del numero di un cliente anche in presenza di un contratto in essere, debiti insoluti o penali di recesso. Il diritto alla portabilità è incondizionato. Motivazione: Diritto sancito dal Codice delle Comunicazioni Elettroniche (D.Lgs. 259/2003 art. 80) e dalle delibere AGCOM. Il debito residuo è esigibile, ma non può bloccare la portabilità. Entità coinvolte: Contratto, SIM Priorità: OBBLIGATORIA - vincolo normativo assoluto Nota: L'operatore può attivare recupero crediti separato ma non il blocco della MNP.
---
BR-04: Notifica consumo dati in roaming UE (80% e 100%)
Codice: BR-04 Nome: RLAH-notifica-consumo Descrizione: Quando un abbonato in roaming intra-UE raggiunge l'80% e il 100% del bundle dati incluso nel piano (ai sensi del Regolamento UE 531/2012 "Roam Like At Home"), l'operatore deve inviare una notifica SMS/push informativa. Motivazione: Obbligo del Regolamento (UE) 531/2012, modificato dal Regolamento (UE) 2022/612. La notifica al 100% deve includere il costo per ulteriore consumo extra-bundle (se applicabile). Fonte: Art. 15 del Reg. UE 531/2012. Entità coinvolte: Traffico (tipo=roaming_dati), Contratto Priorità: OBBLIGATORIA per abbonati consumer EU in roaming intra-EEA Sistemi coinvolti: Mediation system (monitoraggio volume), SMSC (notifica)
---
BR-05: SLA di disponibilità rete (uptime)
Codice: BR-05 Nome: SLA-uptime-rete Descrizione: L'operatore deve garantire il livello di disponibilità della rete (uptime) contrattualizzato con il cliente. Per contratti consumer la disponibilità minima attesa è definita dalla Carta dei Servizi; per contratti B2B è definita nel contratto SLA (tipicamente 99.9% – 99.99% annuo). Motivazione: Obbligo contrattuale e regolatorio. AGCOM può richiedere la pubblicazione delle misurazioni di qualità del servizio (QoS). Fonte: Delibera AGCOM 154/12/CONS (misurazioni QoS rete mobile). Entità coinvolte: Rete, Contratto, PuntoDiAccesso Priorità: OBBLIGATORIA - violazione genera diritto al rimborso o penale Misurazione: MTTR (Mean Time To Repair) ≤4h per guasti P1; disponibilità annua target ≥99.99%
---
BR-06: Nessun credito Ki/chiavi crittografiche in log applicativi
Codice: BR-06 Nome: Sicurezza-chiavi-SIM Descrizione: Le chiavi crittografiche della SIM (Ki, OPc - utilizzate per l'autenticazione AKA) non devono mai essere presenti in log applicativi, risposte API, messaggi di errore o sistemi di auditing non sicuri. Motivazione: Le chiavi Ki sono le credenziali di autenticazione alla rete. La loro esposizione consentirebbe la clonazione della SIM (IMSI takeover). Obbligo di sicurezza derivante dalla normativa su protezione dati (GDPR) e dai requisiti di sicurezza degli operatori. Fonte: GSMA FS.07 (Security Classification). Entità coinvolte: SIM Priorità: OBBLIGATORIA - violazione costituisce data breach notificabile al Garante Privacy Mitigazione tecnica: Le chiavi Ki risiedono solo nell'HLR/HSS/UDM e nel chip SIM; mai estratte verso sistemi applicativi di business.
---
BR-07: Provisioning SIM atomico (BSS + OSS sincronizzati)
Codice: BR-07 Nome: Provisioning-atomico Descrizione: Il processo di provisioning di una nuova SIM deve essere atomico: lo stato nel BSS (CRM + billing) e lo stato nel OSS (HLR/HSS/UDM) devono essere sempre coerenti. Un provisioning parziale (BSS aggiornato ma HLR/HSS non aggiornato, o viceversa) è un errore di dominio che deve essere rilevato e corretto. Motivazione: Un'inconsistenza BSS/OSS produce errori di fatturazione, impossibilità di autenticazione, o servizi attivi non fatturati. Richiede meccanismi di compensazione (saga pattern o 2PC). Fonte: pattern operativi standard del settore telco. Entità coinvolte: SIM, Contratto Priorità: OBBLIGATORIA - errore di provisioning parziale genera SLA breach e potenziale danno economico SLA: Tasso di errori di provisioning deve essere <0.5% (KPI standard di settore).
---
BR-08: IMSI non esposto sull'interfaccia radio in 5G
Codice: BR-08 Nome: Privacy-SUCI-5G Descrizione: Nelle reti 5G NR, l'IMSI dell'abbonato non deve essere trasmesso in chiaro sull'interfaccia radio. Deve essere usato il SUCI (Subscription Concealed Identifier) che cifra l'IMSI con la chiave pubblica ECIES dell'operatore. Motivazione: Prevenzione degli IMSI catcher - dispositivi che intercettano l'IMSI trasmesso in chiaro per tracciare la posizione dell'abbonato. Il SUCI è introdotto con la 5G Security Architecture (3GPP TS 33.501) come mitigazione. Fonte: 3GPP TS 33.501 §6.12. Entità coinvolte: SIM, Rete (generazione=5G-SA) Priorità: OBBLIGATORIA per reti 5G SA - requisito di sicurezza 3GPP Nota: Le reti 4G LTE non hanno questa protezione; l'IMSI può essere richiesto in chiaro durante Attach. 5G NSA eredita la vulnerabilità dal core 4G.
---
BR-09: Neutralità della rete (net neutrality EU)
Codice: BR-09 Nome: Net-neutrality-UE Descrizione: L'operatore non può bloccare, rallentare selettivamente (throttling) o discriminare il traffico internet degli utenti in base all'origine, destinazione, tipo di contenuto o applicazione, salvo traffic management ragionevole per preservare la qualità della rete. Motivazione: Regolamento (UE) 2015/2120, Titolo IV. Il BEREC pubblica linee guida periodicamente aggiornate sull'applicazione del Regolamento. Lo zero rating è soggetto a valutazione caso per caso. Fonte: Reg. UE 2015/2120; BEREC Net Neutrality Guidelines. Entità coinvolte: Traffico, Contratto, Rete Priorità: OBBLIGATORIA - violazione soggetta a sanzione AGCOM e BEREC Eccezioni ammesse: Traffic management ragionevole, emergenze di rete, ordini dell'autorità giudiziaria.
---
BR-10: Fattura elettronica B2B obbligatoria
Codice: BR-10 Nome: Fattura-elettronica-B2B Descrizione: Per i contratti business (B2B), le fatture devono essere emesse in formato elettronico XML e trasmesse tramite il Sistema di Interscambio (SdI) dell'Agenzia delle Entrate. Motivazione: Obbligo introdotto dal D.L. 119/2018 (art. 10-bis) per le transazioni B2B italiane. Per i contratti consumer la fattura elettronica è facoltativa ma incoraggiata. Fonte: D.L. 119/2018; Agenzia delle Entrate circolare 14/E/2019. Entità coinvolte: Contratto (tipo=business), Fattura Priorità: OBBLIGATORIA per contratti B2B italiani Sistemi coinvolti: BSS billing, SdI (Sistema di Interscambio), conservazione sostitutiva