Piani di controllo qualita' — Gestionale e portale Odontosoft¶

Area funzionale: Laboratori Odontotecnici / Qualita'

Indice¶

Panoramica
Anagrafica piani di controllo
Anagrafica problemi associati
Legame piano - azione
Registrazione esecuzione lato gestionale
Sincronizzazione verso il portale Odontosoft
Schema dati lato web
Differenze tra registrazione gestionale e web
Programmi correlati

1. Panoramica¶

Il sistema di gestione laboratori odontotecnici prevede l'associazione di piani di controllo qualita' alle azioni dei piani di fabbricazione. Quando una commessa viene avanzata e raggiunge una fase la cui azione e' collegata a uno o piu' piani di controllo, l'operatore deve confermarne l'esecuzione e, in caso di esito negativo, segnalare la criticita' riscontrata.

L'avanzamento puo' avvenire su due canali:

Gestionale, tramite COGZ45 — l'operatore conferma il piano tramite COGY23, indicando come problema un codice predefinito da LODCTRPB
Portale web Odontosoft, tramite l'app di avanzamento prestazione — l'operatore conferma il piano e in caso di esito negativo compila una nota libera

I due canali registrano i dati in archivi separati e non comunicanti: la consultazione storica delle esecuzioni avviene sul canale dove e' stata fatta la registrazione.

2. Anagrafica piani di controllo¶

LODCONTR — copybook gestionale¶

01 lcn-rec.
   03 lcn-chia1.
      04 lcn-cod              pic x(08).   * Codice piano
   03 lcn-des                 pic x(40).   * Descrizione
   03 lcn-rsp                 pic x(25).   * Responsabile
   03 lcn-da-eseguire         pic x(01).   * Da eseguire in avanzamento? S/N

Gestione: COGZ23 (gestione piani di controllo).

Il flag lcn-da-eseguire determina se, durante l'avanzamento di una fase la cui azione e' collegata al piano, deve essere richiesta conferma esplicita all'operatore.

3. Anagrafica problemi associati¶

LODCTRPB — copybook gestionale¶

Anagrafica dei problemi predefiniti, associati al singolo piano di controllo. Chiave: piano + codice problema.

Solo gestionale: questa anagrafica non e' esportata verso Odontosoft (vedi sezione Differenze tra registrazione gestionale e web).

4. Legame piano - azione¶

LODRACCO tipo "AC" (Azione-Controllo)¶

LODRACCO e' una tabella generica di raccordi tra oggetti del sistema. Per i piani di controllo si utilizza il tipo "AC" (Azione-Controllo), che lega un'azione (LODAZION) a un piano (LODCONTR):

Campo	Significato per tipo "AC"
`lrc-tip`	`"AC"`
`lrc-key-1`	Codice azione (chiave LODAZION)
`lrc-key-2`	Codice piano di controllo (chiave LODCONTR)
`lrc-dati`	Dati aggiuntivi (campo variabile)

Altri tipi presenti in LODRACCO (CI, RI, RC, AR, AI, AM, PI, TM, NP, FC) riguardano altri raccordi del laboratorio e non sono pertinenti al flusso piani di controllo.

5. Registrazione esecuzione lato gestionale¶

LODCMCTR — copybook gestionale¶

01 lpc-rec.
   02 lpc-chia1.
      03 lpc-riga-commessa.
         04 lpc-com           pic 9(10).   * Commessa
         04 lpc-riga          pic 9(04).   * Progressivo azione
      03 lpc-piano            pic x(08).   * Codice piano
   02 lpc-dati.
      03 lpc-fl-eseguito      pic x(01).   * S/N
      03 lpc-ope-eseguito     pic 9(03).   * Operatore esecutore
      03 lpc-data-eseguito    pic 9(08).   * Data esecuzione
      ...
      03 lpc-problema         pic x(08).   * Codice problema (FK LODCTRPB)
      03 lpc-ope-problema     pic 9(03).

Chiave: commessa + progressivo azione + piano. Il record e' a livello di singola azione/fase della commessa (granularita' fine).

Flusso: 1. COGZ45 verifica i controlli in LODCMCTR per la fase corrente (vedi laboratorio-odontotecnico-avanzamento.md) 2. Per le azioni con piani di controllo collegati (LODRACCO tipo "AC") richiede conferma esecuzione via COGY23 3. In caso di esito negativo l'operatore seleziona un codice da LODCTRPB 4. Il record viene scritto/aggiornato su LODCMCTR

6. Sincronizzazione verso il portale Odontosoft¶

Le anagrafiche LODCONTR e LODRACCO vengono esportate verso il portale Odontosoft come cloni read-only, in modo che il portale possa proporre la conferma esecuzione dei piani durante l'avanzamento web.

Programma: SWN136 (esteso) — sincronizzazione anagrafiche laboratorio gestionale -> web.

Direzione: solo gestionale -> web (no import).

Pattern: scansione integrale + confronto record per record, su modello del paragrafo esistente per LODAZION -> ARPLODAZIONI. Cancellazione logica su web per record non piu' presenti sul gestionale.

Tabella gestionale	Tabella web	Direzione	Note
LODCONTR	ARPLODCONTR	Gestionale -> Web	Anagrafica piani
LODRACCO	ARPLODRACCO	Gestionale -> Web	Esportata integrale (cardinalita' limitata)

LODCTRPB non viene esportato: l'esito negativo lato web e' gestito tramite nota testuale libera anziche' codice problema.

LODCMCTR non viene esportato e non viene importato: la registrazione esecuzione web e gestionale sono separate.

7. Schema dati lato web¶

ARPLODCONTR — clone anagrafica piani¶

01 a-lcn-rec.
   02 a-lcn-chia1.
      03 a-lcn-azienda        pic x(06).
      03 a-lcn-cod            pic x(08).
   02 a-lcn-des-breve         pic x(60).
   02 a-lcn-des-dett          pic x(2000).  * VAR-LENGTH
   02 a-lcn-da-eseguire       pic x(01).
   * campi standard sync:
   02 a-lcn-fl-canc           pic x(01).
   02 a-lcn-di-data/time/ope/prog
   02 a-lcn-da-data/time/ope/prog
   02 a-lcn-id-sincro         pic 9(15).
   02 a-lcn-agg-app           pic x(01).

Differenze rispetto al gestionale: descrizione separata in des-breve (60) e des-dett (2000, variabile) — il gestionale aveva una sola descrizione (40 caratteri).

ARPLODRACCO — clone raccordi¶

01 a-lrc-rec.
   02 a-lrc-chia1.
      03 a-lrc-azienda        pic x(06).
      03 a-lrc-tip            pic x(02).    * AC, CI, RI, ...
      03 a-lrc-key-1          pic x(10).
      03 a-lrc-key-2          pic x(10).
   02 a-lrc-dati              pic x(2000).  * VAR-LENGTH
   * campi standard sync

ARPLODCMCONTR — registrazione esecuzione web (nuova)¶

01 a-lpc-rec.
   02 a-lpc-chia1.
      03 a-lpc-azienda        pic x(06).
      03 a-lpc-commessa       pic x(10).
      03 a-lpc-prs-id         pic 9(04).   * Id prestazione
      03 a-lpc-piano          pic x(08).
   02 a-lpc-fl-canc           pic x(01).
   * campi standard sync (di-/da-/id-sincro/agg-app)
   02 a-lpc-note-esito        pic x(2000). * VAR-LENGTH, nota libera
   02 a-lpc-esito             pic x(01).   * S=positivo / N=negativo

Tabella interamente lato Odontosoft: alimentata dall'app web durante l'avanzamento prestazione, consultata dal portale stesso. Non importata sul gestionale. Strutturata come "figlia" del record di avanzamento prestazione ARPLODCMAVAPR (parent), pur non condividendo la chiave in modo formale (la chiave web e' a livello commessa + prestazione + piano, senza ava-id: una conferma per prestazione, indipendente dal numero di sessioni di avanzamento).

8. Differenze tra registrazione gestionale e web¶

Aspetto	Gestionale (LODCMCTR)	Web (ARPLODCMCONTR)
Granularita'	Per fase/azione (commessa + progressivo riga + piano)	Per prestazione (commessa + prs-id + piano)
Problema (esito negativo)	Codice problema da `LODCTRPB` (predefinito)	Nota testuale libera (`a-lpc-note-esito`)
Esito esplicito	Flag `lpc-fl-eseguito` (S/N) — la non-esecuzione e' implicita nell'assenza del record o nel flag	Campo `a-lpc-esito` (S/N) — positivo/negativo esplicito
Operatore esecutore	`lpc-ope-eseguito` (esplicito)	Derivato dal record padre `ARPLODCMAVAPR` (sessione avanzamento)
Data esecuzione	`lpc-data-eseguito` (esplicita)	Derivata dal padre
Consultazione storica	Da gestionale (COGZ45, COGZ23, report dedicati)	Da portale Odontosoft (UI consultazione web)
Comunicazione tra canali	Nessuna: i due archivi sono completamente separati

La separazione e' una scelta progettuale: il portale web e il gestionale operano su perimetri di clienti/utenti distinti e raramente la stessa fase viene avanzata da entrambi i canali. La consultazione e i report restano coerenti su ciascun lato.

9. Programmi correlati¶

Programma	Funzione	File rilevanti
COGZ23	Gestione anagrafica piani di controllo (CRUD)	LODCONTR
COGZ45	Avanzamento commesse step-by-step (gestionale): innesca COGY23 quando rileva piani da confermare	LODCMRIG, LODCMCTR
COGY23	Finestra di conferma esecuzione piano di controllo + selezione problema	LODCMCTR, LODCTRPB
SWN136	Sincronizzazione anagrafiche laboratorio gestionale -> web; esteso per `LODCONTR` e `LODRACCO`	LODAZION, LODCONTR, LODRACCO -> ARP*
COGZ82M / COGZSD	Allegati finali commessa (dichiarazione conformita', archiviazione documenti)	LODRACCO tipo `"PI"` — non legge LODCMCTR ne' i piani di controllo

Riferimenti: - Avanzamento commesse laboratorio — flusso COGZ45 e contesto avanzamento - Avanzamento misto commesse (se presente) — gestionale + web sulla stessa commessa - SWN136 - Azioni — documentazione del programma di sincronizzazione anagrafica - project_piani_controllo_odontosoft (memoria progetto) — stato implementazione

Documentato da: Claude (Anthropic) Data: 2026-05-19 Versione: 1.0