Word in Markdown · Mermaid Diagram
Da documenti Word e Markdown a diagrammi gerarchici e flow chart interattivi Mermaid con validazione LLM locale.
Web App locale Python sviluppata su architettura Streamlit 1.61.1+ per convertire file DOCX (fino a 20 MB) e file MD in grafi visivi Mermaid. Realizza un parsing gerarchico deterministico su intestazioni (#, ##, ###), liste puntate/annidate ed estrae workflow complessi da diagrammi di flusso ASCII verticali.
Perché una Soluzione Locale & Privata?
Nelle organizzazioni enterprise e nelle architetture SAP, le specifiche tecniche e i flussi autorizzativi contengono segreti industriali e dati sensibili non delegabili a cloud di terze parti.
Massima Privacy & Dati in Memoria
Nessun dato viene persistito sul disco rigido locale. I file .docx e .md transitano esclusivamente in streaming nella memoria volatile (RAM), garantendo l'assoluta conformità GDPR e zero persistenza non autorizzata.
Zero Dipendenze Cloud & No API Cost
L'elaborazione si realizza al 100% su 127.0.0.1. Se il server Ollama opzionale non è attivo, l'algoritmo effettua un fallback trasparente sulla modalità deterministica MarkItDown/Regex senza mai interrompere la pipeline.
Rendering & Download Standalone
Generazione simultanea e scaricabile di Markdown strutturato (.md), codice Mermaid nativo (.mmd) e di un file HTML completo e autoconsistente renderizzato via libreria SVG Mermaid.
Modalità di Elaborazione Disponibili
Flessibilità per documenti complessi: dalla mappatura integrale di un intero documento alla dissezione isolata di sole specifiche di flusso procedurale.
Documento Completo
Esegue il parse gerarchico Top-Down (TD) di ogni paragrafo, capitolo e sotto-livello del file, strutturando l'albero visivo a partire da un nodo radice sintetico Documento.
- check_circle Mappatura multilivello di capitoli H1, H2, H3 con indicizzazione coerente.
- check_circle Supporto multimodale Ollama (es. nemotron, llava) per generare didascalie contestualizzate di immagini incorporate (fino a 20 immagini, max 8 MB cad).
- check_circle Raggruppamento e nesting per liste puntate e tabelle di processo.
Solo Diagramma di Flusso
Isola programmaticamente tramite markdown-it-py solo la specifica sezione intitolata o numerata "Diagramma di Flusso" (es. 6. Diagramma di Flusso) ignorando il resto del testo.
- check_circle Segmentazione sicura delimitata fino all'inizio del titolo successivo.
- check_circle Riconoscimento automatico delle sequenze decisionali ASCII verticali.
- check_circle Sintesi immediata senza rumore informativo per diagrammi operativi.
Come viene Generato il Diagramma & Parser ASCII
Dalla ricezione del pacchetto binario DOCX alla restituzione dell'albero Mermaid TD, la logica opera attraverso sei fasi deterministicamente concatenate.
Decodifica & Ispezione OOXML
Verifica MIME-Type con Magika e stream buffer in memoria RAM. Decodifica UTF-8 per sorgenti Markdown ed estrazione OOXML nativa per file DOCX.
Conversione MarkItDown
Conversione ad alta fedeltà delle strutture tipografiche Word. Gestione automatica del fallback open-source qualora intervengano blocchi formattazione.
Estrazione Sezione Target
Se attiva la modalità 'Solo Diagramma di Flusso', la libreria markdown-it-py tokenizza il documento isolando il segmento circoscritto tra i tag H2/H3.
Stack Gerarchico dei Nodi
Costruzione della topologia gerarchica: calcolo dei livelli di profondità per intestazioni e indentazioni numerate con assegnazione di ID univoci ai nodi.
Parser ASCII Verticale
Riconoscimento pattern sequenziali verticali (START | V +--> KO). Traduzione in rami condizionali grafici e ricongiunzione coerente su nodo fine.
Validazione con Ollama
Controllo di sintassi opzionale tramite micro-modello locale. Correzione di caratteri speciali riservati Mermaid ed emissione dell'output pulito.
# 6. Diagramma di Flusso
START
|
V
Controllo autorizzazioni
|
+--> KO --> Fine
|
V
Verifica periodi chiusi
|
V
Estrazione CR
|
V
Visualizzazione ALV
|
V
Selezione CR
|
V
Rilascio Task
|
V
Rilascio CR
|
V
FINEgraph TD
N1["START"] --> N2["Controllo autorizzazioni"]
N2 -->|KO| N_KO["KO"]
N_KO --> N_END["Fine"]
N2 --> N3["Verifica periodi chiusi"]
N3 --> N4["Estrazione CR"]
N4 --> N5["Visualizzazione ALV"]
N5 --> N6["Selezione CR"]
N6 --> N7["Rilascio Task"]
N7 --> N8["Rilascio CR"]
N8 --> N_END
style N1 fill:#f2f4f6,stroke:#76777d
style N_END fill:#dbe1ff,stroke:#0051d5,color:#00174bInterfaccia Streamlit & Risultato Real-Time
Visualizzazione reattiva a doppio pannello. L'utente ispeziona sia il codice Markdown generato sia il rendering grafico istantaneo del flow chart SVG interattivo.
view_week Pannelli di Ispezione Real-Time
L'ambiente dispone del tab Testo Markdown per validare il parsing letterale, del tab Diagramma con rendering visuale st.mermaid_chart e di un expander dedicato con il sorgente puro Mermaid.
download 3 Pulsanti di Esportazione Immediata
Specifiche Tecniche & Limiti Operativi
Parametri architetturali, librerie autorizzate e vincoli di memoria calcolati per garantire esecuzione affidabile su workstation aziendali standard.
| Parametro Architetturale | Specifica & Valore Certificato | Comportamento di Sistema / Fallback |
|---|---|---|
| file_present Formati File Supportati | .docx (fino a 20 MB) e .md | Rifiuto immediato per formati legacy binari obsoleti (.doc) o archivi compressi > 100 MB per prevenzione buffer overflow. |
| extension Librerie Python Autorizzate | markitdown[docx], magika, markdownify, markdown-it-py | Esecuzione vincolata al Python Virtualenv senza invocare moduli C++ nativi non certificati. |
| dns Porta & Servizio Locale | Port 8502 (--server.port personalizzabile) |
Binding vincolato su interfaccia localhost (127.0.0.1) per escludere esposizione su LAN non autorizzata.
|
| timer Timeout LLM & Throttling | Timeout 90s (Max 50.000 caratteri) | Se Ollama non risponde entro la soglia, il rendering usa automaticamente il grafo prodotto dal parser deterministico locale. |
| image Supporto Multimodale Immagini | Max 20 immagini per doc (Max 8 MB cad) | Generazione di descrizioni funzionali integrate nel grafo se è presente un modello Ollama compatibile Vision. |
Dalla Prosa alla Visualizzazione Chiara
Rendi leggibili i tuoi processi di business e la documentazione tecnica SAP/IT senza sforzo manuale. Architettura sicura, scalabile e completamente confinata sulla tua postazione.