Manuale Operativo delle Funzionalità
Come Leggere la Guida & Metriche di Piattaforma
Questo documento fornisce la spiegazione operativa, funzionale e tecnica di ciascuna pagina, componente, popup modale e controllo della piattaforma 3CN.
Struttura di Ciascun Capitolo:
1. Scopo Funzionale: Obiettivo operativo e problemi risolti dalla funzionalità.
2. Mappa dei Controlli: Elenco dettagliato di pulsanti ed elementi interattivi.
3. Workflow Operativo: Procedura d'uso passo-passo dal click al risultato.
4. Dominio Parametri: Tabelle di configurazione con formato compatto a 2 colonne (Chiave + Valori e Descrizione).
Approfondimento Teorico: Per le specifiche matematiche dei modelli ONNX, l'architettura Multi-LLM e i riferimenti normativi (AI Act, GDPR), consulta il whitepaper completo in Project.
Edicola Digitale & Sfoglio Rassegne Giornaliere
Posizione nel portale: Home Page (/)
Scopo Funzionale: L'Edicola Digitale organizza le pubblicazioni giornaliere (massimo 3 articoli curati al giorno per garantire qualità elevata e assenza di rumore informativo) permettendo di sfogliare le edizioni degli ultimi 7 giorni con layout editoriale fluido.
Mappa dei Controlli & Pulsanti
①Ticker TV Tematico Superiore: Striscia dinamica che raggruppa le notizie del giorno in cluster tematici (⭐ TOP, 🤖 TECH, 🚀 SPAZIO, 🧬 BIO, ⚛️ QUANTUM). Cliccando su un cluster, l'edicola isola e mostra solo gli articoli di quella categoria.②Pulsante[ ‹ Ieri ]: Carica l'edizione del giorno immediatamente precedente preservando lo stato della scaletta audio.③Badge📅 Edizione di Oggi: Pillola centrale che mostra la data dell'edizione visualizzata; se cliccata riporta istantaneamente alla rassegna odierna.④Pulsante[ Successiva › ]: Avanza cronologicamente verso le rassegne più recenti (disabilitato quando ci si trova sull'edizione di oggi).⑤Pulsante[ 🎙️ Ascolta questa Rassegna ]: Invia l'intero pacchetto di notizie del giorno al Player Podcast MantoX Radio, caricando automaticamente la Traccia 0 Intro Speaker e le 3 notizie del giorno (vedi Capitolo 02 MantoX Radio).⑥Icona Segnalibro🔖(sulla Card): Salva o rimuove con un solo tocco l'articolo dallocalStoragedel browser (vedi Capitolo 06 Segnalibri Locali).⑦Badge Fonte & Licenza: Visualizza il nome dell'editore originale (es. NASA, Nature, Phys.org) con link diretto all'articolo sorgente e attestazione di licenza aperta CC BY 4.0.
Workflow Operativo Consigliato: Apri la Home Page, consulta il Ticker TV per identificare i cluster caldi, sfoglia con [ ‹ Ieri ] e premi [ 🎙️ Ascolta questa Rassegna ] per avviare l'ascolto hands-free.
Dominio Parametri & Configurazione
| Parametro & Valori | Descrizione & Impatto Operativo |
|---|---|
|
MaxNewsPubliched
|
Numero massimo di articoli storici caricati in memoria per lo sfoglio edicola. |
|
DateMinArticles
|
Data minima ammessa per l'inclusione delle rassegne storiche. |
Approfondimento Architettura: Consulta su Project ➔ Workflow & Pipeline per scoprire come vengono elaborate e pubblicate le edizioni quotidiane.
MantoX Radio & Podcast Continuo
Posizione nel portale: Player Superiore Fluttuante & Drawer Scaletta
Scopo Funzionale: Trasforma l'aggregazione di notizie in un vero giornale radiofonico. Ogni mattina la pipeline sintetizza una Traccia 0 ("Buongiorno MantoX Radio") che riassume i temi del giorno con tono brillante, concatenando poi le notizie con riproduzione fluida continua.
Mappa dei Controlli & Pulsanti
①Pulsante Play / Pausa (fa-play/fa-pause): Avvia o sospende la riproduzione audio con gestione fluida del buffer HTML5.②Pulsanti Traccia Precedente / Successiva: Consentono di saltare istantaneamente da un articolo all'altro senza interrompere l'esperienza.③Scrubbing Bar (Avanzamento Temporale): Slider interattivo per spostarsi avanti/indietro all'interno della traccia audio con indicatore di minutaggio ("01:24 / 03:45").④Pillole Selettore Velocità (1.0x,1.25x,1.5x): Regolano la velocità del parlato in tempo reale preservando il pitch naturale della voce.⑤Pulsante Scaletta (fa-list-ol): Apre il drawer laterale con la playlist completa; permette di cliccare su una qualsiasi traccia per ascoltarla subito o rimuoverla con la✕.⑥Pulsante Minimizza / Chiudi: Riduce il player a un badge fluttuante compatto o interrompe definitivamente lo streaming audio.
Dominio Parametri & Configurazione
| Parametro & Valori | Descrizione & Impatto Operativo |
|---|---|
|
Tts
›
Rate
|
Velocità di sintesi vocale: valori più alti rendono la lettura più brillante. |
|
Tts
›
Pitch
|
Tonalità vocale (valori <1.0 danno un tono più caldo/profondo da speaker radiofonico). |
|
Tts
›
Azure
›
VoiceIT
|
Modello vocale neurale italiano HD impiegato per la lettura. |
Approfondimento Architettura: Consulta su Project ➔ Sintesi Vocale Neurale per i dettagli sull'integrazione Edge-TTS / Azure Speech HD.
Ricerca Semantica Neurale & Trend Radar
Posizione nel portale: Archivio News (/news)
Scopo Funzionale: Combina la ricerca classica full-text con una potente ricerca vettoriale ONNX: cerca per significato concettuale anche quando l'utente non ricorda le parole chiave esatte. Il Trend Radar offre un'infografica interattiva con Donut Chart, barra segmentata e selettore temporale a latenza zero.
Mappa dei Controlli & Pulsanti
①Barra di Ricerca con Icona Neurale (fa-brain): Input di ricerca reattivo con debounce (300ms). Quando l'utente digita, compare la pillola verde.search-ai-active-pillche segnala l'attivazione della ricerca semantica vettoriale.②Pillole Selettore Temporale ([ 7G | 1M | 3M | 1A | Tutto ]): Ricalcolano istantaneamente (0ms di latenza da RAM) le proporzioni e le percentuali della Donut Chart e delle card tematiche su 7 giorni, 1 mese, 3 mesi, 1 anno o sull'intero archivio storico.③Donut Chart Vettoriale SVG: Grafico circolare con fette proporzionali multicolore a copertura 100% esatta, etichette interattive e contatore totale dinamico al centro.④Card Tematiche Interattive (es.🔬 Scienza (20,8%)): Filtrano l'archivio con 1 click navigando verso l'URL canonico SEO pulito/news/category/scienza.⑤Hashtag Cloud Interattivo (es.#quantum (12)): Pillole di tag popolari che aprono direttamente la rotta pulita/news/topic/quantum.⑥Badge Risultato🧠 AI 94%: Mostra il punteggio di similarità del coseno (Cosine Similarity) calcolato dal modello neurale localeall-MiniLM-L6 INT8.⑦Badge Risultato🔤 Keyword: Indica che la notizia corrisponde per testo esatto (ricerca full-text su titolo, tag o contenuto).⑧In-Memory Filter State: Ricerche estemporanee e filtri avanzati sono gestiti in memoria (Scoped); tornando indietro dalla pagina articolo, la posizione di scroll e i filtri vengono ripristinati istantaneamente senza sporcare l'URL con query string.⑨Filtro[ 🔖 Salva per dopo (N) ]: Isola istantaneamente tutti gli articoli salvati nei segnalibri locali dell'utente (vedi Capitolo 06 Segnalibri).
Dominio Parametri & Configurazione
| Parametro & Valori | Descrizione & Impatto Operativo |
|---|---|
|
SearchConfig
›
SemanticSearch
›
MinSimilarityThreshold
|
Soglia minima somiglianza: alzarla rende i risultati più restrittivi. |
|
SearchConfig
›
SemanticSearch
›
SemanticWeight
|
Peso del punteggio semantico nella graduatoria finale. |
|
SearchConfig
›
Boosts
›
HighRatingBoost
|
Incremento di visibilità assegnato agli articoli con rating >= 8.5. |
Approfondimento Architettura: Consulta su Project ➔ Ricerca Semantica Neurale per il modello ONNX INT8 e la Cosine Similarity.
"Chiedi all'AI" (Smart Q&A Flash) & Dettaglio Notizia
Posizione nel portale: Pagina Articolo (/article/...) e Card News
Scopo Funzionale: Consente di decodificare all'istante anche le scoperte scientifiche più complesse tramite 3 lenti sintetiche strutturate generate a costo zero durante l'ingestion LLM.
Le 3 Lenti Cognitive Integrate:
👶 [ Spiegamelo semplice ]: Divulgazione facilitata con metafore per non addetti ai lavori.
⚖️ [ Pro e Contro ]: Analisi critica che bilancia vantaggi, costi e limiti tecnologici.
🔭 [ Cosa ci aspetta ]: Proiezione a 5 anni sulle ricadute industriali, cliniche o scientifiche.
Mappa dei Controlli & Pulsanti
①Pillole Cognitive Interattive: Cliccando su una delle 3 pillole si espande la relativa card con animazione fluida.②Card Risposta Glassmorphic: Box semitrasparente che compare sotto le pillole con animazione fluida e tasto di chiusura✕.③Pulsante Copia Link (fa-link): Copia negli appunti l'URL dell'articolo comprensivo di ancora per la condivisione diretta.
Dominio Parametri & Configurazione
| Parametro & Valori | Descrizione & Impatto Operativo |
|---|---|
|
MaxSmartQA
|
Numero massimo di articoli arricchiti con Smart Q&A per ciclo batch. |
Modalità Lettura "Zen" & Accessibilità (WCAG 2.1)
Posizione nel portale: Overlay a Tutto Schermo
Scopo Funzionale: Isola il lettore da ogni elemento di distrazione del portale, massimizzando il comfort visivo grazie a palette di colore conformi alle linee guida WCAG 2.1 AA e supporto completo a screen reader.
Mappa dei Controlli & Pulsanti
①Pulsante[ 📖 Modalità Zen ]: Attiva l'overlay immersivo a schermo intero nascondendo header, footer e banner.②Selettori di Carta (Luce, Sepia, Notte OLED): Commutano istantaneamente sfondo e contrasto tipografico.③Pulsanti Dimensione Testo (A-/A+): Riducono o aumentano la scala tipografica memorizzando la preferenza nel browser.④Pulsante[ ✕ Esci ]: Disattiva la modalità Zen (attivabile anche premendo il tasto fisicoESC).
Approfondimento Architettura: Consulta su Project ➔ Accessibilità & Inclusione per i requisiti WCAG 2.1 AA.
Drawer Segnalibri ("Salva per dopo" Privacy-First)
Posizione nel portale: Header & Drawer Laterale Slide-in
Scopo Funzionale: Sistema di salvataggio preferiti 100% privacy-first: i dati risiedono solo nel localStorage del dispositivo dell'utente, senza richiedere registrazione o invio di cookie al server.
Mappa dei Controlli & Pulsanti
①Icona Segnalibri nell'Header: Mostra il contatore dinamico degli articoli salvati (es.🔖 (3)); cliccandola apre il drawer laterale.②Lista Notizie Salvate: Schede compatte con titolo, badge tematico e data; cliccando sul titolo si naviga all'articolo.③Pulsante Rimuovi Singolo (fa-trash-can): Rimuove istantaneamente l'articolo dalla memoria locale.④Pulsante[ 🎙️ Aggiungi tutti alla scaletta Radio ]: Prende in blocco tutti i segnalibri e li carica come playlist nel player MantoX Radio (vedi Capitolo 02 MantoX Radio).⑤Pulsante[ Svuota Tutti ]: Elimina tutti i segnalibri memorizzati dopo una conferma rapida.
Accesso Riservato & Sicurezza Password-Less OTP
Posizione nel portale: Pagina Login (/login)
Scopo Funzionale: Protegge le dashboard amministrative (Review, Scheduler, SQL Console, Config, Files, Resources) eliminando il rischio di furto credenziali statiche tramite codici OTP monouso temporizzati inviati su canale sicuro.
Mappa dei Controlli & Pulsanti
①Campo Inserimento OTP: Box protetto per digitare il token di accesso monouso temporizzato.②Pulsante[ Accedi ]: Convalida crittografica del token e generazione della sessione server-side protetta.③Pulsante Logout (fa-right-from-bracket): Presente nell'header di ogni pagina amministrativa; invalida la sessione a database e reindirizza alla Home.
Dominio Parametri & Configurazione
| Parametro & Valori | Descrizione & Impatto Operativo |
|---|---|
|
scadenzaMinuti
|
Durata di validità del token OTP prima della scadenza automatica. |
Dashboard "Review & Approvazione Articoli"
Posizione nel portale: Dashboard Review (/review)
Scopo Funzionale: Sala di controllo editoriale Human-in-the-loop. Permette al redattore di supervisionare i testi bilingue creati dall'AI, approvarli per la pubblicazione, correggerli al volo o rigenerarli.
Mappa dei Controlli & Pulsanti
①Badge Versione Deploy: Mostra data e ora dell'ultima compilazione server rilasciata.②Icona Aiuto Contestuale ((i)): Apre direttamente questo capitolo del manuale in una nuova scheda.③Pulsante[ Dashboard Schedulatore ]: Navigazione diretta verso la sala macchine di Quartz (Capitolo 11 Schedulatore).④Pillola KPI⭐ Rating Medio: X.X: Calcola in tempo reale la media qualitativa assegnata dall'AI alle bozze pendenti.⑤Pulsante[ 🚀 Schedulazione & Pubblicazione Batch ]: Espande il pannello superiore per calendarizzare il rilascio degli articoli approvati nelle 3 fasce giornaliere (Mattina 08:00, Pomeriggio 13:30, Sera 19:30).⑥Pulsante[ ✅ Approva ](su NewsCard): Assegna all'articolo lo statoApproved, pronto per essere calendarizzato.⑦Pulsante[ ❌ Rifiuta ](su NewsCard): Scarta l'articolo (statoRejected) escludendolo definitivamente dalla pubblicazione.⑧Pulsante[ ✏️ Modifica ](su NewsCard): Apre il popup modale di modifica rapida testuale in-place (👉 Approfondisci nel Capitolo 09 QuickEditModal).⑨Pulsante[ 🔄 Rielabora ](su NewsCard): Apre il popup modale di rigenerazione con modelli AI alternativi (👉 Approfondisci nel Capitolo 10 ReprocessModal).
Dominio Parametri & Configurazione
| Parametro & Valori | Descrizione & Impatto Operativo |
|---|---|
|
RatingMin
|
Soglia minima di qualità: notizie con voto inferiore vengono scartate subito. |
|
MaxArticles
|
Numero massimo di bozze create dall'AI per ciascun ciclo batch. |
|
MinLength
|
Lunghezza minima caratteri richiesta per la fonte originale. |
Approfondimento Architettura: Consulta su Project ➔ Human-in-the-Loop per la teoria del controllo editoriale combinato.
Popup Modifica Rapida (QuickEditModal)
Posizione nel portale: Finestra Modale su /review (Click su ✏️ Modifica)
Scopo Funzionale: Consente di correggere in tempo reale qualsiasi testo o metadato della notizia (in italiano o in inglese) salvando le modifiche sul database a zero latenza senza chiamare l'LLM.
Mappa dei Controlli & Pulsanti
①Linguette Switch Lingua ([ 🇮🇹 Italiano ]/[ 🇬🇧 English ]): Passano istantaneamente tra i campi localizzati in italiano e inglese.②Menu a Tendina "Elemento da modificare":📌 Titolo Articolo:Modifica il titolo visualizzato sulle card e nella testata.📖 Contenuto Principale:Modifica o corregge il testo dell'articolo divulgativo.🧠 Approfondimento Esperti (Bonus):Modifica il box specialistico per esperti.🏷️ Categoria & Hashtag:Modifica la categoria tematica e la lista#hashtag.👶 Smart Q&A: Spiegamelo semplice:Ritocca la spiegazione facilitata (vedi Capitolo 04).⚖️ Smart Q&A: Pro e Contro:Ritocca il bilancio critico.🔭 Smart Q&A: Cosa ci aspetta:Ritocca le previsioni future a 5 anni.
③Area di Input Dinamica: Textarea multilinea (o campo input) che si precompila automaticamente con il valore attuale presente nel DB.④Pulsante[ Annulla ]: Chiude il popup senza salvare alcuna modifica.⑤Pulsante[ 💾 Salva Modifica ]: Esegue l'aggiornamento a database e aggiorna istantaneamente la scheda sottostante con un feedback verde di conferma.
🔙 Ritorno alla Sala Controllo: Torna alla panoramica della Dashboard Review (Capitolo 08).
Popup Rielaborazione AI (ReprocessModal)
Posizione nel portale: Finestra Modale su /review (Click su 🔄 Rielabora)
Scopo Funzionale: Permette di rigenerare l'intero articolo dalla fonte originale RSS scegliendo se testare a caldo un modello LLM differente o se rimettere la bozza nella coda batch notturna.
Mappa dei Controlli & Pulsanti
①Radio Button "Rielabora Subito (Live)": Seleziona la modalità sincrona: la chiamata AI viene eseguita in tempo reale durante la sessione di lavoro.②Menu a Tendina "Modello AI da utilizzare": Permette di selezionare un LLM specifico tra quelli configurati (es.google/gemma-2,meta-llama/llama-3,openrouter/free) per ottenere stili o livelli di sintesi differenti.③Radio Button "Metti in Coda (Batch)": Riporta lo stato dell'articolo a grezzo per essere rielaborato durante il prossimo ciclo batch automatico (Capitolo 11 Schedulatore).④Pulsante[ ⚡ Rielabora ]: Avvia la procedura mostrando uno spinner reattivo sulla NewsCard e aggiornando i testi a video.
🔙 Ritorno alla Sala Controllo: Torna alla panoramica della Dashboard Review (Capitolo 08).
Dashboard "Batch Scheduler, RAM & Pipeline"
Posizione nel portale: Dashboard Scheduler (/Sched)
Scopo Funzionale: Centrale operativa del sistema: orchestra i Job Quartz.NET persistenti, permette trigger manuali con flag personalizzati, monitora l'integrità dei contenuti e controlla l'impegno di memoria RAM del processo .NET.
Mappa dei Controlli & Pulsanti
①Tool Hub Moduli (4 Grandi Pulsanti): Accesso rapido alle app di sistema:📁 File Manager:Esplora filesystem e storage (Capitolo 13).🎛️ Live Config:Ispezione e modifica parametri a caldo (Capitolo 14).🌐 Risorse & RESX:Traduzioni e testi bilingue (Capitolo 15).💾 SQL Console:15 preset diagnostici e query manager (Capitolo 12).
②Content Monitor (Pulsante[ Aggiorna ]): Ricarica le statistiche in tempo reale su Articoli DB, Audio TTS ed AI Enrichment.③Pulsante[ 🧹 Forza Garbage Collection ]: Attiva manualmente il GC del runtime .NET compattando la Large Object Heap (LOH) per liberare memoria dopo elaborazioni vettoriali pesanti.④Pulsante[ Aggiorna Metriche RAM ]: Ricarica i dati del WorkingSet dell'app e la percentuale di memoria occupata sul server.⑤Pulsante[ ⚡ Esegui Ora ](su Job Quartz): Forza l'avvio immediato della pipeline batch senza attendere l'orario pianificato.⑥Campo Override Flag di Esecuzione: Casella di testo in cui digitare combinazioni personalizzate di flag (es.news,tts) per eseguire solo specifici step.
Tabella dei Flag di Pipeline (Stringa Elab)
| Flag | Nome Step | Cosa fa in dettaglio | Parametri Correlati |
|---|---|---|---|
feeds | Ingestione RSS | Download feed (automatico il 1° del mese o forzato a mano). | LogFeedsPath |
news | Generazione AI | Elaborazione LLM con rating qualitativo e insight specialistici. | MaxArticles, RatingMin |
vector | Vettorizzazione AI | Calcolo embeddings ONNX 384-dim per la ricerca semantica. | SearchConfig:SemanticSearch |
aggr | Trend Radar | Calcolo percentuali e densità tematica settimanale. | PopularTopicsLimit |
smartqa | Smart Q&A Flash | Generazione pillole interattive (Semplice, Pro/Contro, Futuro). | MaxSmartQA |
tts | Audio MP3 | Sintesi vocale neurale HD e generazione Traccia 0 Intro Radio. | Tts:Azure:BackfillBatchSizeIT |
fix | Bonifica DB | Verifica integrità relazionale e correzione record. | - |
backup | Backup Compresso | Creazione archivio .zip di sicurezza del database SQL. | BackupConfig:DailyRetentionDays |
review | Notifica MagicLink | Invio email con OTP temporizzato alla redazione. | Smtp:ToEmail |
🍳 Ricettario Combinazioni Flag Elab per Scenari Reali
| Scenario Operativo Reale | Stringa Override | Risultato Pratico Ottenuto |
|---|---|---|
| ⚡ Generazione Rapida Articoli | news,review | Crea 3 nuovi articoli e invia l'email OTP alla redazione. |
| 🎙️ Recupero Tracce Audio Mancanti | tts | Genera gli MP3 e l'Intro radio per le notizie senza audio. |
| 🧠 Rigenerazione Vettori Semantici | vector,aggr | Ricalcola gli embeddings ONNX e aggiorna il Trend Radar. |
| 💬 Arricchimento Pillole Smart Q&A | smartqa | Genera le 3 pillole flash per gli articoli in archivio. |
| 💾 Manutenzione & Backup di Sicurezza | fix,backup | Esegue bonifica record e archivia lo zip di backup del DB. |
| 📥 Ricarica Forzata Feed RSS | feeds,news | Scarica subito le ultime fonti e produce le nuove bozze. |
Approfondimento Architettura: Consulta su Project ➔ Workflow & Pipeline Batch per i dettagli del motore Quartz.NET.
SQL Server Inspector & Query Console (/sql)
Posizione nel portale: Tool Hub ➔ SQL Console (/sql)
Scopo Funzionale: Ambiente diagnostico avanzato per esplorare lo schema del database SQL Server, analizzare i conteggi record, lanciare query personalizzate e accedere a 15 Query Rapide Predefinite per l'ispezione immediata del workflow e dei modelli AI.
Punti di Forza & Chicche Esclusive
- 🗄️ Tabelle con Conteggio in Tempo Reale: La barra laterale sinistra elenca tutte le tabelle del DB con il numero esatto di record aggiornato a video (es. Articles 1,420 r.). Cliccando su qualsiasi riga viene generata automaticamente la query ottimizzata
SELECT TOP 50 * FROM [NomeTabella]. - ⚡ I 15 Preset Diagnostici Istantanei: Menu a tendina che inietta query specializzate per controllare la salute dei dati:
- Stati & Workflow: Conteggio per Stato, In Revisione (Stato 3), Approvati in Coda (Stato 5), Ultimi Pubblicati (Stato 6), Feed Grezzi (Stati 1, 2), Scartati & Rifiutati, Articoli in Errore.
- AI & Ricerca Semantica: Senza Vettori Semantici (rileva articoli orfani di embedding ONNX), Senza Approfondimento Expert, Con Approfondimento Expert, Top Rating AI (≥ 8.5), Per Categoria e Rating, Modelli LLM Utilizzati.
- Sistema & Quartz: Quartz Triggers & Orari Cron, Conteggio Righe Tabelle.
- ⏱️ Misurazione Performance & Safety Limit: Ogni query riporta il tempo di risposta effettivo del motore SQL in millisecondi (es.
⏱️ 12 ms) e applica un guardrail a 100 righe per preservare memoria e fluidità dell'interfaccia. - 🔍 Zoom Densità Font (
S/M/L): Permette di alternare la visualizzazione tra compatta per laptop o allargata per monitor ad alta densità. - 📄 Esportazione CSV RFC 4180: Scarica l'intero dataset dei risultati formattato secondo lo standard RFC 4180 con codifica UTF-8 BOM, immediatamente leggibile in Microsoft Excel senza problemi di accenti.
Sottopagine & Popup: Modale "Modifica Record Database"
Selezionando una qualsiasi riga nella griglia risultati (evidenziata con il cursore 👉) si attiva il pulsante [ ✏️ Modifica Record ], che apre il modale verticale dedicato:
①Target Table & Schema Info: Il modale riconosce la tabella di destinazione e interroga lo schema SQL per visualizzare i metadati di ogni colonna: tipo dato (varchar,nvarchar(MAX),bit,int,datetime) e chiave primaria ([PK]protetta da modifica accidentale).②Dirty Tracking in Tempo Reale: Non appena un campo viene modificato, la relativa scheda assume un bordo evidenziato e il contatore in testata aggiorna il badge (es. "2 campi modificati").③Input Tipizzati & Boolean Switch: I campi booleani sono controllati da comodi toggle switch, le date da datepicker nativi e i testi lunghi da textarea a espansione automatica.④Pulsante Salva Modifiche: Convalida crittografica ed esecuzione dell'aggiornamento SQL puntuale con notifica verde di conferma.
Dominio Parametri & Configurazione
| Parametro & Valori | Descrizione & Impatto Operativo |
|---|---|
|
Sql:MaxResultRows
|
Limite di sicurezza sul numero massimo di righe restituite per query per prevenire picchi di memoria nel browser. |
|
Sql:CommandTimeoutSeconds
|
Tempo massimo di esecuzione prima dell'annullamento della query, a protezione di SQL Server da lock prolungati. |
Approfondimento Architettura: Consulta su Project ➔ Capitolo 9: Data Layer & Custom DbCore ORM per i dettagli sullo schema relazionale.
File Manager & Gestione Storage Filesystem (/files)
Posizione nel portale: Tool Hub ➔ File Manager (/files)
Scopo Funzionale: Esploratore del filesystem del server sicuro e sandboxato. Consente di navigare nelle cartelle di log, riprodurre istantaneamente i file audio MP3 generati dalla sintesi neurale Azure con player integrato, esportare report strutturati del disco con sottocartelle, effettuare upload protetti e scaricare archivi di backup.
Punti di Forza & Chicche Esclusive
- 🧭 Breadcrumbs Navigabili a Chip: Percorso interattivo per risalire la gerarchia directory con un click (es.
Root › private › backup › audio), con visualizzazione del path relativo corrente. - 🎧 Player Audio MP3 Integrato nelle Righe dei File: Su tutti i file audio generati (tracce vocali MP3 degli articoli o Track 0 Intro radiofonica), è presente direttamente l'icona Play (
fa-play). Cliccandola, l'audio si avvia istantaneamente nel browser, consentendo alla redazione di verificare la qualità della sintesi neurale senza dover scaricare il file. - 🔍 Filtro di Ricerca in Tempo Reale: Campo di input con debounce istantaneo per individuare file o directory per nome all'interno della cartella visualizzata.
- ⬇️ Download Diretto ad Alta Velocità: Pulsante dedicato (
fa-download) per scaricare archivi compressi, report o file di log direttamente sul computer locale.
Sottopagine & Popup: Modale "Esporta Albero File & Report Disco"
Premendo il pulsante [ 🌳 Esporta Albero File ] nella barra superiore si apre la console di reportistica del filesystem:
①Ambito di Scansione (Intera Root vs Cartella Corrente): Permette di limitare la scansione alla cartella in cui ci si trova o di analizzare l'intero albero dell'applicazione.②Toggle "Includi Sottocartelle": Genera la visualizzazione gerarchica ricorsiva con indentazione grafica (├──e└──) di tutti i rami e sotto-directory.③Toggle "Includi Cartelle di Sistema": Opzione avanzata per includere o escludere directory di build (bin,obj,.git) per concentrarsi solo sui contenuti applicativi.④Box Risultati con Statistiche: Mostra il conteggio totale dei file analizzati, lo spazio occupato in MB/GB e un'area di testo preformattata con pulsante di copia rapida per reportistica tecnica.
Sottopagine & Popup: Modale "Carica File" (Upload Protetto)
Premendo [ ➕ Carica File ] si accede alla finestra di caricamento protetto:
①Cartella di Destinazione Dinamica: Precompilata con la directory corrente visualizzata nell'esploratore.②Controllo Estensione & Dimensione: Anteprima del nome e peso del file selezionato (KB/MB) con verifica preventiva per bloccare file non autorizzati.③Upload Asincrono con Spinner: Trasferimento a blocchi in memoria senza saturare il thread pool del server.
Dominio Parametri & Configurazione
| Parametro & Valori | Descrizione & Impatto Operativo |
|---|---|
|
FileManager:AllowedExtensions
|
Whitelist di sicurezza delle estensioni file consentite per il caricamento, per bloccare upload eseguibili pericolosi. |
|
FileManager:MaxUploadSizeBytes
|
Dimensione massima consentita per singolo upload di file a salvaguardia dello spazio disco server. |
Live Config Inspector & Runtime Editor (/config)
Posizione nel portale: Tool Hub ➔ Live Config (/config)
Scopo Funzionale: Ispezione dell'intero albero di configurazione appsettings.json e modifica a caldo di qualsiasi parametro operativo a runtime con zero downtime, senza riavviare il server Kestrel/IIS e senza disconnettere gli utenti attivi.
Punti di Forza & Chicche Esclusive
- ⚡ Aggiornamento a Caldo senza Riavvio: A differenza delle tradizionali applicazioni web in cui modificare un file di configurazione causa il riciclo dell'Application Pool IIS (con perdita delle sessioni in memoria e secondi di latenza),
LiveConfigServiceapplica le variazioni all'istanzaIConfigurationa runtime mantenendo l'app online al 100%. - 🗂️ Selettore Viste (
[ 📁 Sezioni ]/[ 📋 Elenco Completo ]): Permette di passare istantaneamente tra l'albero gerarchico navigabile (con sezioni espandibili per modulo: OpenRouter, Smtp, BackupConfig, SearchConfig, Tts) e l'elenco piatto tabellare ordinabile per chiave o valore. - 🔍 Ricerca Universale in Tempo Reale: Campo di ricerca globale che filtra simultaneamente attraverso tutti i livelli di annidamento e visualizza solo le chiavi pertinenti.
- 🔒 Offuscamento Automatico Credenziali: Le chiavi sensibili (password, token, segreti di connessione) vengono automaticamente mascherate (es.
••••••••••••) con un pulsante reveal a occhio (fa-eye) accessibile solo agli amministratori autenticati.
Sottopagine & Popup: Modale "Nuova Chiave di Configurazione"
Premendo [ ➕ Nuova Chiave ] nella testata si apre il modale di inserimento parametro:
①Chiave Gerarchica con Namespace: Supporta la notazione standard a due punti (es.SearchConfig:SemanticSearch:MaxCandidates) collocando automaticamente il nuovo valore nella sezione corretta dell'albero JSON.②Tipizzazione Dinamica: Converte automaticamente il valore inserito nel tipo nativo corrispondente (booleano, intero, decimale o stringa).③Persistenza & Hot-Reload: Scrive la nuova chiave nel file JSON su disco e aggiorna il provider di configurazione in memoria.
Dominio Parametri & Configurazione
| Parametro & Valori | Descrizione & Impatto Operativo |
|---|---|
|
LiveConfig:EnableRuntimeOverrides
|
Abilita l'hot-reloading e l'override in memoria delle proprietà di configurazione. |
|
LiveConfig:PersistToDisk
|
Controlla se gli aggiornamenti runtime vengono persistiti anche nel file appsettings.json. |
Gestione Risorse & Lingue RESX (/resources)
Posizione nel portale: Tool Hub ➔ Risorse & Lingue (/resources)
Scopo Funzionale: Manutenzione centralizzata e a caldo di tutti i testi di interfaccia, pulsanti, etichette e tooltip bilingue (Italiano Resources.resx / Inglese Resources.en.resx), con isolamento immediato delle traduzioni mancanti e aggiornamento istantaneo della cache in memoria a zero latenza.
Punti di Forza & Chicche Esclusive
- 🎯 Linguette di Diagnosi Rapida per Traduzioni Mancanti:
[ Tutte (N) ]: Elenco completo di tutte le stringhe di risorsa caricate nell'applicazione.[ Mancanti in EN (N) ]: Chicca esclusiva per i traduttori; isola in un click solo le chiavi presenti in italiano ma prive della controparte inglese, eliminando ore di ricerca manuale.[ Mancanti in IT (N) ]: Rileva eventuali chiavi registrate solo in inglese prive della versione italiana.
- ✏️ Editor Bilingue Affiancato (Side-by-Side): Cliccando sull'icona modifica
fa-pen-to-square, la riga della tabella si sdoppia in due textarea indipendenti, permettendo di correggere contemporaneamente il testo italiano e inglese con visione d'insieme del contesto. - ⚡ Cache di Override Istantanea in Memoria: Al salvataggio (
fa-check), il sistema scrive le nuove stringhe sui file XML fisiciResources.resxeResources.en.resxe aggiorna istantaneamente la cache in memoria delLanguageService. Gli utenti che navigano vedono i nuovi testi al prossimo caricamento pagina senza richiedere alcuna ricompilazione della solution.
Sottopagine & Popup: Modale "Aggiungi Nuova Chiave di Traduzione"
Premendo [ ➕ Nuova Chiave ] nella toolbar superiore si apre la finestra assistita di creazione:
①Chiave Risorsa Univoca: Campo con formattazione dot-notation suggerita (es.Home.FeatureTitleoArticle.SmartQaPrompt).②Campo Testo Italiano: Inserisce la stringa che verrà serializzata nel file radiceResources.resx.③Campo Testo Inglese: Inserisce la traduzione corrispondente perResources.en.resx.④Salvataggio Atomico: Verifica che la chiave non esista già e sincronizza entrambi i file di localizzazione in un'unica transazione sicura.
Dominio Parametri & Configurazione
| Parametro & Valori | Descrizione & Impatto Operativo |
|---|---|
|
Localization:SupportedCultures
|
Elenco delle culture linguistiche RFC 4646 supportate disponibili nello switcher dell'interfaccia utente. |
|
Localization:DefaultCulture
|
Lingua predefinita adottata se la richiesta HTTP non specifica un header Accept-Language corrispondente o preferenza locale. |
GEO, LLMO & Dati Strutturati Schema.org (/llms.txt)
Posizione nel portale: Endpoint Pubblici (/llms.txt, /llms-full.txt) & HeadContent (/{slug})
Scopo Funzionale: Ottimizzazione avanzata per i motori di ricerca generativi (GEO - Generative Engine Optimization come Perplexity AI, ChatGPT Search, Google Gemini e Claude) e per i motori di ricerca tradizionali, esponendo feed in puro Markdown e metadati JSON-LD conformi allo standard Schema.org.
Mappa delle Specifiche & Endpoint
①EndpointGET /llms.txt: Fornisce una panoramica essenziale del portale in formato Markdown standard per gli AI Crawler: mission editoriale, link canonici alle categorie e lista delle top stories in evidenza.②EndpointGET /llms-full.txt: Dump strutturato completo con titolo, sommario, analisi specialistica degli esperti e risposte Smart Q&A (Spiegazione semplice, Pro e Contro, Prospettiva futura) per consentire all'AI di citare 3CN come fonte primaria.③Grafo Schema.orgNewsArticle: Nel blocco<head>di ogni articolo esporta metadati ISO 8601 di pubblicazione/modifica, autore, categoria, tag e link canonico.④AllegatoAudioObject: Collega direttamente la traccia MP3 neurale HD all'articolo per l'indicizzazione nei cataloghi podcast e Google News.⑤EntitàFAQPage: Modella le 3 pillole Smart Q&A come domande e risposte frequenti per attivare i Rich Snippets espandibili nei risultati di Google.
Centro Indicizzazione SEO & Protocollo IndexNow (/Sched)
Posizione nel portale: Batch Scheduler & Console (/Sched) & Workflow Review (/review)
Scopo Funzionale: Hub di monitoraggio e push real-time per la massima visibilità sui motori di ricerca tradizionali (Google, Bing, Yandex, Seznam) e sugli assistenti AI integrati (Microsoft Copilot). Combina l'audit continuo della conformità tecnica SEO (slug parlanti, sitemap dinamica, direttive crawler, grafi JSON-LD) con il protocollo istantaneo IndexNow: all'approvazione editoriale in /review l'URL viene trasmesso entro pochi secondi all'API di Bing, mentre da /Sched è possibile forzare una sincronizzazione globale massiva di tutti gli articoli pubblicati.
Mappa dei Controlli & Box KPI
①Box "Conformità SEO": Misura la percentuale di articoli pubblicati dotati di metadati completi, slug SEO bilingue validi e sintesi divulgative conformi; l'icona informativa(i)mostra la spiegazione dettagliata in hover.②Box "Sitemap XML": Riporta il conteggio istantaneo degli URL mappati nell'endpoint/sitemap.xml(articoli, categorie, pagine istituzionali), garantendo che nessun contenuto approvato rimanga orfano di scansione.③Box "Direttive Robots": Stato operativo del file/robots.txt, preposto ad autorizzare Googlebot, Bingbot, Slurp e i principali crawler di modelli linguistici (GPTBot, PerplexityBot, ClaudeBot), schermando al contempo le dashboard ad accesso riservato.④Box "Dati Strutturati": Conteggio dei grafi semantici Schema.org JSON-LD attivi (NewsArticle,BreadcrumbList,AudioObject,FAQPage) verificati a runtime.⑤Box "IndexNow Push": Monitora lo stato della connessione API al protocollo IndexNow e riporta il conteggio degli URL già sincronizzati con Microsoft Bing e la rete partner.⑥Pulsante[ ⚡ Invia a IndexNow ]: Attiva l'invio batch massivo di tutti gli URL degli articoli pubblicati all'endpoint ufficiale IndexNow (https://api.indexnow.org/indexnow) tramite pacchetti serializzati con validazione e firma digitale basata sulla chiave host (/{key}.txt).⑦Pulsante[ 🗺️ Sitemap XML ]: Apre in una nuova scheda l'output grezzo della sitemap dinamica per ispezione visuale e verifica dei tag<lastmod>e<changefreq>.⑧Pulsante[ 🤖 Robots.txt ]: Visualizza istantaneamente le direttive crawler per verificare le autorizzazioni di scansione e i puntamenti alla sitemap.⑨Pulsante[ 🔍 Search Console ]: Scorciatoia diretta alla dashboard ufficiale di Google Search Console per verificare clic, impressioni, copertura e indicizzazione dell'host.⑩SERP & Schema.org Inspector: Selettore interattivo di anteprima che mostra l'aspetto esatto dello snippet di ricerca nei risultati Google (titolo, data, breadcrumb, descrizione) affiancato al blocco di codice JSON-LD effettivo generato per quell'articolo.
Workflow Operativo Consigliato:
1. Workflow Automatico: Quando la redazione approva una notizia da /review, il sistema invia in background l'URL a IndexNow a zero latenza.
2. Verifica Periodica: Accedi a /Sched e controlla che l'indice di Conformità SEO sia ≥ 99% e che i box siano verdi.
3. Aggiornamento Massivo: Dopo modifiche globali di struttura o routing, premi [ ⚡ Invia a IndexNow ] per forzare il refresh degli indici di Bing, Copilot e Yandex.
4. Audit Google: Clicca su [ 🔍 Search Console ] per verificare lo stato di scansione e l'assenza di errori 404 o redirect.
Dominio Parametri & Configurazione
| Parametro & Valori | Descrizione & Impatto Operativo |
|---|---|
|
IndexNow:Enabled
|
Abilita o sospende l'invio push automatico e manuale verso l'API IndexNow. |
|
IndexNow:ApiKey
|
Chiave alfanumerica di identificazione IndexNow; corrisponde al file di verifica servito su https://dominio/{ApiKey}.txt. |
|
IndexNow:Host
|
Nome a dominio canonico validato per cui vengono sottomessi gli URL; previene errori HTTP 422 di discrepanza host. |
|
IndexNow:BatchSize
|
Dimensione massima del pacchetto di URL inviati per singola richiesta HTTP POST verso l'API di IndexNow. |
Approfondimento Architettura: Per le specifiche di indicizzazione GEO, il grafo semantico unificato e i protocolli per AI Search Engine, consulta Project ➔ Capitolo 12: Infrastruttura SEO, GEO & LLMO.
Backup, Restore & Disaster Recovery
Posizione nel portale: Tool Hub ➔ Backup Manager (/tools/backup) & Script di Rollback Pre-Deploy
Scopo Funzionale: Garantisce la continuità operativa, l'integrità dei dati e la resilienza a qualsiasi disastro o regressione applicativa. La piattaforma implementa una duplice strategia: backup automatico pre-deploy (WebDeploy e database SQL Server prima di ogni rilascio in produzione con rollback istantaneo a caldo in 30 secondi) e gestione snapshot manuali e schedulati dall'interfaccia amministrativa per database e asset statici.
Punti di Forza ("Chicche") della Resilienza
- Snapshot Pre-Deploy Automatico: Ad ogni esecuzione dello script di publish, il sistema genera un archivio ZIP compresso con timestamp dell'intera applicazione IIS e un dump SQL Server nativo (
.bako script schema+dati) prima di sovrascrivere un singolo byte. - Rollback Istantaneo in 30 Secondi: In caso di eccezioni o anomalie post-deploy, l'amministratore può ripristinare l'ultima versione perfettamente funzionante con un singolo comando PowerShell, azzerando i tempi di disservizio.
- Procedura di Emergenza RecoveryKey: Se l'amministratore perde l'accesso email per il MagicLink, l'URL
/login?token=RECOVERY_KEYconsente di forzare la rigenerazione e la notifica del token senza mai esporre chiavi in chiaro o bypass insicuri in produzione. - Politica di Retention & Pruning Automatico: I backup più vecchi della soglia configurata (default: 30 giorni) vengono epurati automaticamente per evitare saturazione dello spazio disco sul server.
Mappa dei Controlli & Box Operativi
①Statistiche Snapshot & Spazio Disco: Box superiore con contatore dei punti di ripristino disponibili, data dell'ultimo snapshot integro e spazio disco totale occupato dagli archivi.②Pulsante[ 💾 Crea Nuovo Backup ]: Apre il popup modale per l'esecuzione immediata di un backup a caldo con opzione di includere solo il Database SQL, solo gli Asset (audio MP3, immagini, config) o l'intero sistema (Full System Snapshot).③Tabella Cronologica degli Snapshot: Elenco dei backup con data/ora di creazione, dimensione file, tipo di backup (Full, DB, Assets), stato di integrità (checksum SHA-256) e note operative.④Pulsante[ ⬇️ Scarica Archivio ]: Consente il download locale del file.zipdi backup per archiviazione cold-storage offline protetta.⑤Pulsante[ 🔄 Ripristina ]: Apre la modale di sicurezza per il restore guidato con richiesta di conferma esplicita per prevenire sovrascritture accidentali.⑥Pulsante[ 🗑️ Elimina Snapshot ]: Rimuove permanentemente un archivio obsoleto liberando spazio disco sul volume.
Modale di Ripristino Guidato (Fig. 18.2)
ATTENZIONE: Operazione Distruttiva: Il ripristino di uno snapshot sovrascrive i dati attuali con lo stato congelato al momento del backup. La procedura modale include un doppio check di sicurezza:
- Check di Compatibilità Schema: Verifica che la versione dello schema del backup sia compatibile con i binari attualmente in esecuzione.
- Backup di Sicurezza Pre-Restore: Prima di procedere con la sovrascrittura, il sistema crea automaticamente uno snapshot di emergenza dello stato corrente ("Safety Rollback Point").
- Digitazione del Codice di Conferma: L'amministratore deve digitare la parola
RESTOREnel campo di input per sbloccare il pulsante di conferma definitiva.
Workflow di Rollback Rapido (Procedura Emergenza IIS)
Se il server IIS non risponde a seguito di una pubblicazione fallita:
- Apri una console PowerShell sul server o tramite sessione remota.
- Naviga nella cartella di deploy ed esegui lo script di rollback:
.\rollback.ps1. - Lo script ferma l'AppPool IIS, ripristina i binari della cartella
_backup_pre_deploye riavvia l'applicazione entro 30 secondi. - Se l'accesso admin via email è bloccato, apri il browser su
https://tuodominio.it/login?token=TUA_RECOVERY_KEYper ricevere immediatamente un nuovo link di accesso.
Dominio Parametri & Configurazione
| Parametro & Valori | Descrizione & Impatto Operativo |
|---|---|
|
Backup:StoragePath
|
Percorso su file system (locale o storage volume montato) dove vengono archiviati i file ZIP e i dump di backup. |
|
Backup:RetentionDays
|
Numero di giorni di conservazione prima che i vecchi archivi vengano rimossi automaticamente dal job di manutenzione notturno. |
|
Backup:CompressLevel
|
Livello di compressione GZip/Deflate applicato alla creazione degli archivi per bilanciare velocità di snapshot e consumo disco. |
|
Auth:RecoveryKey
|
Chiave di emergenza per sbloccare l'invio del MagicLink di login; verificata con algoritmo a tempo costante contro timing attacks. |
Approfondimento Architettura: Per i dettagli su WebDeploy, la procedura di disaster recovery e il ripristino da cold storage, consulta la guida completa in Project ➔ Capitolo 10: Sicurezza, Backup & Resilienza.
