# 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`