netgescon-day0/docs/00-INDICE-LAVORO-DISTRIBUITO.md

Indice lavoro distribuito rete e agent

Scopo

Questo indice serve a coordinare il lavoro tra piu macchine della rete, piu agent e piu stream tecnici senza perdere il filo tra chat, nodi e manuali locali.

La regola base e una sola:

• il punto di verita condiviso resta il repository Day0 su Gitea;
• la cartella docs/ e la memoria operativa distribuita;
• ogni macchina puo avere note locali temporanee, ma tutto cio che deve sopravvivere va riportato qui.

Sorgenti autorevoli

1. docs/README.md - orientamento generale, workspace autorevole e flusso Git reale
2. docs/support/RETE-DOCS-E-AGENT-OPERATIVITA.md - come distribuire i manuali su tutte le macchine
3. docs/support/MANUALE-SVILUPPO-OPERATIVO.md - modo standard di lavorare, aggiornare e validare
4. docs/support/CONTINUITA-SVILUPPO-AGENT.md - continuita minima tra agent e sessioni
5. docs/support/BUG-RISOLTI-E-VALIDAZIONI.md - correzioni e verifiche concrete

Cantieri attivi

1. Update server .53

Obiettivo:

• riallineare il server interno updates.netgescon.it per servire manifest e pacchetti corretti ai nodi.

Documenti guida:

• docs/support/UPDATE-SERVER-53-RUNBOOK-2026-05.md
• docs/support/AGGIORNAMENTI-STAGING-GIT.md

Output atteso:

• route update pubbliche corrette
• manifest free presente
• pacchetto zip presente
• check connettivita nodo senza timeout e senza 404 HTML Laravel

2. ACL centralizzate e programmi

Obiettivo:

• governare visibilita e accesso a programmi, pagine e moduli da un punto unico super admin, con override per ruolo e utente.

Documenti guida:

• docs/support/ARCHITETTURA-RUOLI-MODULI-COWORKING.md
• docs/support/MANUALE-SVILUPPO-OPERATIVO.md

Output atteso:

• catalogo programmi governabile
• regole globali + per ruolo + per utente
• riduzione dei canAccess() hardcoded sparsi

3. Coordinamento agent su rete

Obiettivo:

• fare in modo che gli agent lavorino come un unico gruppo, con indice, runbook e memoria condivisa via Gitea.

Fase attuale:

• prima attivazione via share LAN NFS di docs/ e scripts/ai/
• Gitea resta il secondo passo, quando tutte le macchine saranno collegate

Documenti guida:

• docs/support/RETE-DOCS-E-AGENT-OPERATIVITA.md
• docs/support/CONTINUITA-SVILUPPO-AGENT.md
• docs/support/SETUP-WORKSPACE-MACCHINE-LAN.md

Output atteso:

• ogni macchina ha una copia aggiornata di docs/
• ogni agent sa dove leggere prima di intervenire
• ogni scoperta locale viene riportata nel repository
• ogni nuova macchina puo montare la share e aprire un workspace coerente in pochi minuti

4. Riconciliazione banca e scritture contabili

Obiettivo:

• usare anche la macchina con mini AI come nodo tecnico dedicato a collegare movimenti bancari e scritture contabili.

Documenti guida iniziali:

• docs/support/MANUALE-SVILUPPO-OPERATIVO.md
• docs/support/BUG-RISOLTI-E-VALIDAZIONI.md

Stato attuale:

• stream riconosciuto come cantiere separato da formalizzare con runbook dedicato appena fissato il primo flusso dati.

5. Memoria condivisa .53 con KB e orchestrazione agent

Obiettivo:

• integrare sulla .53 una knowledge base condivisa e un livello di orchestrazione agent senza sostituire Git, Gitea e docs/ come fonte autorevole.

Documenti guida:

• docs/support/INTEGRAZIONE-KB-ORCHESTRATOR-53.md
• docs/support/RETE-DOCS-E-AGENT-OPERATIVITA.md
• docs/support/CONTINUITA-SVILUPPO-AGENT.md

Output atteso:

• docs/ usata come sorgente primaria ufficiale
• KB server usato come retrieval layer e memoria operativa condivisa
• orchestrazione agent agganciata allo stesso KB
• regole chiare per ingestione da share scambio/200 senza rumore o duplicati

6. Gestione documentale e import ex novo GESCON

Obiettivo:

• usare la DEMO aggiornata sulla .157 per test controllati con utenti esterni;
• riaprire il cantiere sui primi due moduli operativi: carico documenti e importazione ex novo da GESCON;
• raccogliere bug reali emersi dall inserimento dati e dal flusso archivio/import.

Documenti guida:

• docs/support/PASSAGGIO-CONSEGNE-GESTIONE-DOCUMENTALE-E-IMPORT-GESCON.md
• docs/000-FILAMENT/00-MANUALE-FILAMENT.md
• docs/support/RUNBOOK-157-DEMO-UPDATE.md

Output atteso:

• modulo iniziale di carico documenti con elenco presa in carico e stampa etichette DYMO 99014 e 11354
• procedura tracciata di upload documenti digitali nell archivio
• prova guidata di import GESCON step-by-step su dati nuovi
• raccolta bug e anomalie emerse dai test esterni sulla DEMO

Modus operandi unico

1. leggere l indice di questo file
2. aprire il runbook del cantiere toccato
3. lavorare nel repository Day0 o in mirror Git della stessa origine
4. riportare nel repository cio che e diventato operativo
5. solo dopo fare passaggio di consegne all altro agent o all altra macchina

Domande che questo indice deve sempre risolvere

• cosa si sta facendo
• dove si sta facendo
• chi e la sorgente autorevole
• qual e il prossimo check oggettivo
• dove si scrive l esito per gli altri

Aggiornamento minimo richiesto

Aggiornare questo indice quando cambia almeno uno di questi punti:

• nasce un nuovo cantiere di lavoro di rete
• un cantiere cambia runbook principale
• una macchina assume un ruolo operativo stabile
• un processo viene promosso da esperimento a workflow ufficiale