Contabilita

Contabilita (Modalita Contabilita) e' il routing file del dominio finanze ISI-CNV: dirige la risposta alle domande "perche' questa spesa?" (alert ARGO) e "quanto rende la pubblicita'?" collegando classificazione, contratti fornitori, ricorrenze attese e risultati. Deriva dalla spec TESORIERE dettata da Marco il 07/07/2026 (memoria architecture_1783460671236_4nxv6j). Principio invariabile: mai LLM sui numeri — tutto deterministico, LLM solo per commento e matching nomi ambigui.

1. Chi esegue

• finance_daily_sync.py — cron 06:45, aggiorna transactions_multianno e viste
• tesoriere_v2.py — moduli saldo | ricavi | morosi | agenzia | funnel
• argo_watch.py — alert spese anomale
• perche_spesa.py — DA CREARE: dato un movimento produce il report a 5 blocchi (sotto)
• Cantieri: Cantieri aperti → modalita-contabilita e finanze-classificazione

2. Accessi (puntatori, mai credenziali)

• BigQuery leafy-responder-483419-a4.isicnv_finance: transactions_multianno, classification_rules (678 regole), controparti, pagamenti_ricorrenti_attesi, fx_rates, contratti_fornitori, fatture_fornitori, fornitori_pagamenti_dichiarati (nuove, 25/08/2026)
• Fatture correnti: Gmail isicnv, ricerca VMK fattura / label fatture
• Fatture storiche VMK: cartella Drive (da Salsina)
• Lead e chiusure: Streak CRM + leads_journey / lead_ads_*

3. Template "Perche' questa spesa?" (5 blocchi obbligatori)

1. Identificazione: movimento, conto, data, merchant/controparte
2. Classificazione: ramo (classification_rules), tier 1-4, ricorrente? atteso da contratto (contratti_fornitori)?
3. Serie storica: stesso merchant ultimi 12 mesi + stesso periodo anno scorso
4. Risultati collegati (solo Tier 1 ADV): spesa ads periodo, lead entrati (agenzia/dubbi/altri), chiusure Linea A teorica vs Linea B effettiva (bucket 400 EUR), quota agenzia spalmata /30
5. Verdetto: LEGITTIMO | ANOMALO | DA VERIFICARE, con delta vs atteso

4. Criterio di accettazione

Un alert ARGO e' "spiegato" solo se il report contiene tutti e 5 i blocchi con numeri da BQ. DA_CLASSIFICARE non deve risalire (sentinella notturna).

5. Fornitore VMK Lab Srl — quadro al 25/08/2026

• Accordo in vigore dal 01/01/2026: 960 EUR/mese, solo Google Ads (fattura tipica 962). Solo bonifico. Confermato da Marina Ornella 08/01/2026.
• Accordo 2025 (chiuso): fee 1.072 + anticipo 5.517/12 (460) = 1.532/mese + extra; FUNNEL 2.880 in 3 rate.
• Riepilogo VMK 07/05/2026: fatturato 2025-26 28.961, pagato 26.546, saldo residuo dichiarato 2.415 EUR — sollecito 16/06/2026 senza risposta. Dettaglio completo in fatture_fornitori e fornitori_pagamenti_dichiarati.
• Progetto separato "Di storie e di stelle": rate 2-3 inviate a Ilaria (mag-giu 2026), importi da estrarre dai PDF.
• Contatti: m.ornella@vmklab.it, e.malgaroli@vmklab.it — P.IVA 05007570269, Noale (VE).

6. Fallimenti noti e rimedi

• Campo note del ledger e' FLOAT64: marcatori in classifier_blob
• CLI bq perde le regex negli escaping: usare libreria python google.cloud.bigquery
• Importi non tutti EUR (PYG, BGN...): mai sommare amount_src senza CASE di conversione (viste)
• BQ streaming insert blocca UPDATE/DELETE ~90 min: load_table_from_json
• 503 CC in <100ms = load balancer, non cold start (learning learn_1776710748794)

7. Strumenti ammessi e vietati

Ammessi: BQ via libreria python, route CC /finance/*, /bq/query, Gmail isicnv, Streak API (mai sovrascrivere dati Ilaria). Vietati: LLM sui numeri, modifiche a mano al ledger senza regola in classification_rules, invii/pagamenti autonomi.

8. Riconciliazione VMK eseguita il 25/08/2026

• 21/22 pagamenti dichiarati da VMK trovati nel ledger. Alias ledger: Veneto Marketing Lab (dst_name), conto Universite, direction OUT.
• Il pagamento dichiarato 04/05/2026 di 962 non risulta a quella data: il ledger registra 962 il 07/07/2026 (probabile stesso pagamento, data diversa).
• DISCREPANZA: la lista pagamenti nella mail VMK somma 25.546, ma VMK dichiara totale pagato 26.546 (+1.000 non in lista). Con fatturato 28.961 il saldo sarebbe 3.415, non 2.415 — oppure manca un pagamento nella loro lista. Verificato col totale ledger (sotto). Da chiarire con Marina prima di saldare.
• Sollecito VMK del 16/06/2026 ancora senza risposta.