|
|
| Riga 1: |
Riga 1: |
| '''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 <code>architecture_1783460671236_4nxv6j</code>). Principio invariabile: '''mai LLM sui numeri''' — tutto deterministico, LLM solo per commento e matching nomi ambigui.
| | La contabilita operativa e documentata nella wiki riservata. |
|
| |
|
| == 1. Chi esegue ==
| | [[Categoria:Infrastruttura]] |
| * <code>finance_daily_sync.py</code> — cron 06:45, aggiorna transactions_multianno e viste
| |
| * <code>tesoriere_v2.py</code> — moduli saldo | ricavi | morosi | agenzia | funnel
| |
| * <code>argo_watch.py</code> — alert spese anomale
| |
| * <code>perche_spesa.py</code> — DA CREARE: dato un movimento produce il report a 5 blocchi (sotto)
| |
| * Cantieri: [[Cantieri aperti]] → <code>modalita-contabilita</code> e <code>finanze-classificazione</code>
| |
| | |
| == 2. Accessi (puntatori, mai credenziali) ==
| |
| * BigQuery <code>leafy-responder-483419-a4.isicnv_finance</code>: 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 <code>VMK fattura</code> / label fatture
| |
| * Fatture storiche VMK: [https://drive.google.com/drive/folders/1bWfWyC3GckE3Cd6Z_UZ62GCAbDwp_1vE cartella Drive (da Salsina)]
| |
| * Lead e chiusure: Streak CRM + <code>leads_journey</code> / <code>lead_ads_*</code>
| |
| | |
| == 3. Template "Perche' questa spesa?" (5 blocchi obbligatori) ==
| |
| # '''Identificazione''': movimento, conto, data, merchant/controparte
| |
| # '''Classificazione''': ramo (classification_rules), tier 1-4, ricorrente? atteso da contratto (contratti_fornitori)?
| |
| # '''Serie storica''': stesso merchant ultimi 12 mesi + stesso periodo anno scorso
| |
| # '''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
| |
| # '''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 <code>fatture_fornitori</code> e <code>fornitori_pagamenti_dichiarati</code>.
| |
| * 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 <code>note</code> del ledger e' FLOAT64: marcatori in <code>classifier_blob</code>
| |
| * CLI <code>bq</code> 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 <code>learn_1776710748794</code>)
| |
| | |
| == 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). CONFERMATO dal ledger (23 mov. OUT = 26.945, meno 1.399 fattura 174/2024 = 25.546 esatti): nessun pagamento manca, il totale 26.546 nella mail VMK e' un errore aritmetico. Saldo reale al 07/05 = '''3.415''' (non 2.415); dopo il pagamento 962 del 07/07 residuo '''~2.453''' sulle fatture emesse fino a maggio, escluse eventuali fatture giu-ago e rate Storie e stelle. Da chiarire con Marina prima di saldare.
| |
| * Sollecito VMK del 16/06/2026 ancora senza risposta.
| |