From 38b8b90c0319dbf6fa2a0e4f3a6c866fb885695e Mon Sep 17 00:00:00 2001 From: michele Date: Wed, 11 Mar 2026 19:27:54 +0000 Subject: [PATCH] docs(handoff): align baseline and embed exact first-message prompt --- .../ai/restart/HANDOFF-NUOVO-AMBIENTE-DAY0.md | 81 ++++++++++++++++++- docs/ai/restart/START-HERE-NETGESCON-DAY0.md | 2 +- 2 files changed, 80 insertions(+), 3 deletions(-) diff --git a/docs/ai/restart/HANDOFF-NUOVO-AMBIENTE-DAY0.md b/docs/ai/restart/HANDOFF-NUOVO-AMBIENTE-DAY0.md index c2ca4d1..941ea5c 100644 --- a/docs/ai/restart/HANDOFF-NUOVO-AMBIENTE-DAY0.md +++ b/docs/ai/restart/HANDOFF-NUOVO-AMBIENTE-DAY0.md @@ -1,7 +1,7 @@ # Handoff Nuovo Ambiente Day-0 Data: 2026-03-11 -Baseline commit Day-0: `3719eda` +Baseline commit Day-0: `5d3f5c6` Repository: `michele/netgescon-day0` ## 1) Stato confermato @@ -102,7 +102,7 @@ ## 4) Prompt pronto da dare al nuovo agent Contesto: - Repo: michele/netgescon-day0 - Branch: main -- Baseline: 3719eda +- Baseline: 5d3f5c6 - Staging online: /var/www/netgescon via nginx su porta 80 - Sviluppo: /home/michele/netgescon/netgescon-day0 su porta 8000 @@ -129,6 +129,83 @@ ## 4) Prompt pronto da dare al nuovo agent - Non rompere flusso PostIt/Filament esistente - Non revertare modifiche utente non richieste - Validare sempre con test/route/query prima del commit + +Richiesta DB fondamentale: +- Voglio stessi dati tra sviluppo e staging (DB condiviso), con cartelle/app distinte. +- Prima backup, poi allineamento configurazioni `.env`, migrate una sola volta, verifica dati CTI su entrambi gli ambienti. +``` + +## 4.1 Primo messaggio esatto (versione operativa consigliata) + +```text +Sei il nuovo agent operativo di NetGescon Day-0. Lavora in modalità esecutiva completa (codice + test + commit/push), senza fermarti alla sola analisi. + +BASELINE E CONTESTO +- Repo: michele/netgescon-day0 +- Branch: main +- Baseline commit: 5d3f5c6 +- Documento guida principale: docs/ai/restart/HANDOFF-NUOVO-AMBIENTE-DAY0.md +- Pagina controllo modifiche: /admin-filament/supporto/modifiche +- Changelog manuale: docs/NETGESCON-MODIFICHE.md +- Changelog Git auto: docs/NETGESCON-GIT-AUTOCHANGELOG.md + +Sviluppa solo nel tree principale Day-0 (non in _legacy-vault), poi commit/push. +Poi ciclo staging update. + +AMBIENTI +- Sviluppo interno: /home/michele/netgescon/netgescon-day0 (porta 8000) +- Staging online: /var/www/netgescon con nginx su porta 80 + +CTI PANASONIC GIA IMPLEMENTATO +- POST /api/v1/cti/panasonic/incoming +- POST /api/v1/cti/panasonic/call-ended +- GET /api/v1/cti/panasonic/lookup +- Obiettivo operativo: verificare che i Post-it si creino/chiudano correttamente con esito e durata. + +RICHIESTA FONDAMENTALE DB +Voglio vedere gli stessi dati sia in sviluppo che in staging (stessa base dati condivisa, cartelle/app diverse ok). +Quindi: +1) analizza configurazioni DB attuali dei due ambienti +2) proponi e applica configurazione "DB unico condiviso" in sicurezza +3) esegui backup prima di cambiare +4) applica migrazioni necessarie una sola volta sul DB condiviso +5) verifica con test CTI che i dati Post-it appaiano uguali su dev e staging + +DELIVERABLE RICHIESTI +- report finale con comandi eseguiti +- file modificati +- output chiave verifiche +- eventuali rischi della strategia DB condiviso + mitigazioni +- aggiornamento docs/NETGESCON-MODIFICHE.md con le modifiche funzionali +- commit/push su main + +OBIETTIVO IMMEDIATO +1) Verificare end-to-end Post-it su dev e staging: + - incoming crea post-it + - call-ended chiude post-it, salva esito/durata/chiusa_il +2) Aggiornare staging online con migrate e cache clear +3) Validare con test reali o curl simulati +4) Fornire report finale con: + - comandi eseguiti + - endpoint testati + - id record creati/chiusi in chiamate_post_it + - eventuali mismatch payload PBX e fix fatti + +STAGING: +- cd /var/www/netgescon +- php artisan migrate --force +- php artisan optimize:clear +- sudo systemctl reload nginx + +VERIFICHE MINIME +- curl incoming/call-ended/lookup su dev e staging +- query SQL su chiamate_post_it per stato/esito/durata/chiusa_il +- nessuna regressione lato pagina Filament PostIt + +VINCOLI +- Non rompere flusso PostIt esistente +- Compatibilità fallback se event_id assente +- Se trovi modifiche locali non tue, non revertare senza richiesta esplicita ``` ## 5) Documenti e manuali presenti (conferma) diff --git a/docs/ai/restart/START-HERE-NETGESCON-DAY0.md b/docs/ai/restart/START-HERE-NETGESCON-DAY0.md index 0b51554..2e6b610 100644 --- a/docs/ai/restart/START-HERE-NETGESCON-DAY0.md +++ b/docs/ai/restart/START-HERE-NETGESCON-DAY0.md @@ -11,7 +11,7 @@ ## Stato confermato - Repository Day-0 attivo: `/home/michele/netgescon/netgescon-day0` - Remote Git attivo: `ssh://git@192.168.0.53:2222/michele/netgescon-day0.git` - Branch principale: `main` -- Ultimo commit noto: `13813fe` +- Ultimo commit noto: `5d3f5c6` ## Stato supporto/modifiche