netgescon-day0/docs/support/PBX-PANASONIC-STATO-OPERATIVO.md

83 lines
3.3 KiB
Markdown

# PBX Panasonic stato operativo
## Scopo
Questo file raccoglie in modo strutturato tutto il lavoro gia fatto sul centralino Panasonic, cosi da poter riprendere lo sviluppo o il collaudo senza dover ricostruire il ragionamento da zero.
## Stato attuale
- La base CTI lato NetGescon e gia predisposta con endpoint incoming, call-ended, lookup e click-to-call.
- Il canale `panasonic_csta` e gia integrato nel flusso Post-it e nella messaggistica tecnica.
- In `strumenti/post-it-gestione` esistono ora tab distinti per SMDR e `CTI / CSTA e Click-to-Call`.
- Il click-to-call e gia previsto tramite richieste in `pbx_click_to_call_requests`.
- L architettura lato UI e servizi e stata tenuta piu aperta possibile per non bloccare il progetto su Panasonic e poter accogliere FreePBX come prossimo adapter.
## Cosa e stato implementato
### Eventi CTI / CSTA
- endpoint per arrivo chiamata
- endpoint per chiusura chiamata
- lookup rubrica per popup e correlazione
- salvataggio eventi tecnici su `communication_messages.channel=panasonic_csta`
### Click-to-call
- registrazione richiesta outbound dal gestionale
- recupero richieste pendenti lato adapter PBX
- presa in carico richiesta
- aggiornamento esito chiamata
### UI di test e controllo
- separazione tra traccia passiva SMDR e flusso ricco CSTA
- esposizione provider e metadati piu adatti a scenari PBX multipli
- action diretta di click-to-call dalla vista tecnica
## Endpoint gia disponibili
- `POST /api/v1/cti/panasonic/incoming`
- `POST /api/v1/cti/panasonic/call-ended`
- `GET /api/v1/cti/panasonic/lookup?phone=...`
- `GET /api/v1/cti/panasonic/click-to-call/pending?extension=...`
- `POST /api/v1/cti/panasonic/click-to-call/{id}/claim`
- `POST /api/v1/cti/panasonic/click-to-call/{id}/status`
## Stato verifiche
- [U] locale: bootstrap e codice applicativo validi
- [U] locale: tab tecnici separati presenti
- [P] staging: da verificare con traffico CTI/CSTA reale e con interni reali monitorati
- [P] staging: da validare click-to-call end-to-end sul centralino Panasonic
## Dati e interni di riferimento attuali
- `201` centralino con segreteria
- `205` operatore studio
- `206` amministratore
- `601` gruppo/modalita giorno
- `603` gruppo/modalita notte
Questi riferimenti vanno mantenuti allineati nella scheda amministratore e nelle configurazioni usate per routing e test.
## Ragionamento architetturale da non perdere
- Panasonic e il primo centralino integrato, non il vincolo definitivo del progetto.
- Il livello da tenere stabile e il contratto applicativo NetGescon: eventi chiamata, lookup, richieste click-to-call, mapping interno utente.
- Il livello da cambiare in futuro deve essere l adapter PBX, non la logica gestionale o la UI principale.
- FreePBX deve poter entrare riusando il piu possibile la stessa semantica applicativa.
## Prossimi test da fare su staging
1. verificare la tab `CTI / CSTA e Click-to-Call` con eventi reali
2. verificare la creazione e chiusura corretta dei Post-it da eventi Panasonic
3. verificare il click-to-call dal gestionale verso interno/telefono associato
4. verificare il mapping tra interno PBX, utente NetGescon e stabile attivo
## Collegamenti utili
- `docs/CTI-NS1000-CHECKLIST.md`
- `docs/CTI-WINDOWS-TAPI-PROBE.md`
- `docs/support/MANUALE-SVILUPPO-OPERATIVO.md`
- `docs/support/BUG-RISOLTI-E-VALIDAZIONI.md`