Percorso progressivo
Dal risultato visibile all’implementazione.
Ogni livello aggiunge dettaglio senza richiedere di ricominciare: si può entrare dal punto più adatto e proseguire verso il livello successivo.
In pratica
Sei concetti tecnici tradotti in immagini mentali.
Adapter
Un interprete che trasforma fonti differenti in una forma comune.
State machine
Un semaforo che distingue lavoro completato, saltato, bloccato o fallito.
Idempotenza
Premere due volte il pulsante non deve produrre due pubblicazioni identiche.
Log
Un diario che registra cosa è successo e quando.
Test offline
Verificare il sistema con copie controllate dei dati senza dipendere ogni volta dalla fonte esterna.
Segreti e credenziali
Password e chiavi non devono comparire nel codice o nei report.
Livello operativo
La pipeline è scomposta in componenti con responsabilità verificabili.
Dal componente al comportamento.
Un workflow affidabile nasce da responsabilità separate, stati espliciti e controlli ripetibili. La forma dell’architettura rende visibile dove un run può procedere, degradarsi o fermarsi.
fontimetodocontrollioutputmemoria
Toolchain implementata
Framework e strumenti collegati a un ruolo preciso.
Core e dati
Elaborazione tabellare, validazione degli oggetti e persistenza verificabile.
Machine learning
Modelli supervisionati, anomaly detection, clustering, grafi e bootstrap.
Acquisizione
Client HTTP, parsing di pagine e PDF, feed e API pubbliche.
Rendering e web
Card statiche, grafici navigabili e sito bilingue indicizzabile.
Automazione
Schedule, ambienti protetti, artifact, test e pubblicazione idempotente.
Delivery
Record social standalone, sito statico e routing linguistico.
Ciclo di un run
Ogni esecuzione attraversa stati espliciti.
Trigger
Schedule, evento, dispatch manuale o nuova fonte.
Acquire
Retry, timeout, data sorgente e metadati.
Validate
Schema, freschezza, missing, range e gate.
Compute
Decide
Published, dry-run, skipped, blocked o failed.
Persist
Artifact, stato, provenance, hash e URI.
Qualità software
Test diversi coprono errori diversi.
Unit test
Parser, trasformazioni, caption, record key, metriche e guard.
Contract test
Versioni, struttura dei file, schema degli output e obblighi di release.
Offline integration
Fixture e mock riproducono fonti esterne senza dipendere dalla rete.
Dry-run
Genera card, payload e provenienza senza inviare record reali.
CI
Ruff, pytest, build degli artifact e controlli prima dello schedule.
Runbook
Esiti, failure mode, retry e recupero dello stato sono documentati.
Confine di maturità
Implementato e possibile evoluzione restano distinti.
Repository e workflow correnti
GitHub Actions, artifact, stato JSON, pytest, Ruff, rendering statico, AT Protocol e Cloudflare Pages.
Produzione più strutturata
Container OCI/Docker, registry, API FastAPI, DVC o MLflow, OpenTelemetry, Prometheus/Grafana e object storage. Non sono presentati come componenti già attivi.