161 lines
5.2 KiB
Markdown
Executable File
161 lines
5.2 KiB
Markdown
Executable File
# 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
|