# 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