zentral/docs/functions/README.md

Funzioni Database

Questa cartella contiene la documentazione di tutte le 23 funzioni del database.

Funzioni Calcolo Quantità e Disponibilità

Funzione	Ritorno	Descrizione
F_GET_QTA_IMPEGNATA	NUMBER	Quantità impegnata di un articolo in un range di date
F_GET_TOT_OSPITI	NUMBER	Totale ospiti per evento (opzionale per tipo)
F_GET_OSPITI	TABLE	Dettaglio ospiti per evento (funzione pipelined)
F_LIST_PRELIEVO_ADD_ARTICOLO	VARCHAR2 (JSON)	Aggiunge articolo alla lista prelievo con validazioni

Funzioni Calcolo Costi

Funzione	Ritorno	Descrizione
F_GET_COSTO_ARTICOLO	NUMBER	Costo unitario articolo a una data specifica

Funzioni Validazione

Funzione	Ritorno	Descrizione
F_EVENTO_SCADUTO	NUMBER (0/1)	Verifica se preventivo è scaduto
F_MAX_NUMERO_EVENTI_RAGGIUNTO	NUMBER (-1/0/1)	Verifica limite eventi giornaliero
F_MAX_NUM_EVENTI_CONFERMATI	NUMBER (0/1)	Verifica limite eventi confermati
F_CI_SONO_EVENTI_CONFERMATI	NUMBER (0/1)	Check esistenza eventi confermati in data/location

Funzioni Report

Funzione	Ritorno	Descrizione
F_REP_ALLESTIMENTI	TABLE	Dati per report allestimenti (pipelined)
F_REP_CUCINA	TABLE	Dati per report cucina (pipelined)
F_GET_ANGOLO_ALLESTIMENTO	VARCHAR2	Descrizione angolo allestimento
F_GET_ANGOLO_ALLESTIMENTO_OB	VARCHAR2	Descrizione angolo open bar
F_GET_TOVAGLIATO_ALLESTIMENTO	VARCHAR2	Descrizione tovagliato

Funzioni Autorizzazione

Funzione	Ritorno	Descrizione
F_USER_IN_ROLE	NUMBER (0/1)	Verifica appartenenza utente a ruolo
F_USER_IN_ROLE_STR	VARCHAR2	Verifica ruolo (ritorna stringa)

Funzioni Utility

Funzione	Ritorno	Descrizione
F_DAY_TO_NAME	VARCHAR2	Converte numero giorno in nome italiano
STRING_TO_TABLE_ENUM	TABLE	Converte stringa delimitata in tabella
GET_PARAM_VALUE	VARCHAR2	Recupera valore parametro da TB_CONFIG
SPLIT	TABLE	Split stringa in elementi
MY_INSTR	NUMBER	Funzione INSTR personalizzata
CLOB2BLOB	BLOB	Conversione CLOB → BLOB
EXTDATE_GET_ITA	VARCHAR2	Formatta data in italiano esteso

Dettaglio Funzioni Critiche

F_GET_QTA_IMPEGNATA

FUNCTION F_GET_QTA_IMPEGNATA(
    p_codart    VARCHAR2,
    p_data_from DATE,
    p_data_to   DATE DEFAULT NULL
) RETURN NUMBER

Logica:

• Interroga V_IMPEGNI_ARTICOLI
• Somma quantità impegnate nel range di date
• Se p_data_to è NULL, usa p_data_from

F_EVENT0_SCADUTO

FUNCTION F_EVENTO_SCADUTO(
    DATA_SCADENZA  IN DATE,
    STATO_EVENTO   IN NUMBER,
    STATO_FROM     IN NUMBER,
    STATO_TO       IN NUMBER
) RETURN NUMBER

Logica:

• Ritorna 1 se TRUNC(DATA_SCADENZA) <= TRUNC(SYSDATE) AND STATO_EVENTO BETWEEN STATO_FROM AND STATO_TO
• Altrimenti ritorna 0

F_LIST_PRELIEVO_ADD_ARTICOLO

FUNCTION F_LIST_PRELIEVO_ADD_ARTICOLO(
    p_event_id      NUMBER,
    p_articolo_add  VARCHAR2,
    p_qta_aperitivo NUMBER := 0,
    p_qta_seduto    NUMBER := 0,
    p_qta_dolci     NUMBER := 0
) RETURN VARCHAR2

Logica:

1. Verifica esistenza evento
2. Verifica esistenza articolo
3. Recupera giacenza articolo
4. Controlla impegni in date vicine (±2 giorni)
5. Inserisce record in EVENTI_DET_PREL
6. Chiama EVENTI_AGGIORNA_QTA_LISTA
7. Ritorna JSON con esito:
   • {"type":"success","message":"..."}
   • {"type":"warning","message":"..."}
   • {"type":"error","code":"...","stack":"...","message":"..."}

F_GET_COSTO_ARTICOLO

FUNCTION F_GET_COSTO_ARTICOLO(
    p_cod_articolo VARCHAR2,
    p_date DATE
) RETURN NUMBER

Logica:

1. Cerca costo in COSTI_ARTICOLI alla data esatta
2. Se non trovato, prende ultimo costo disponibile
3. Se non trovato nulla, ritorna 0