Couche 1
Parsers
FEC (Art. A47 A-1 LPF), CAMT.053 (ISO 20022), DRM XML ProDouane, DSN (NEODeS). Code Python déterministe, sans LLM. Si un fichier ne parse pas, Korva flag `incertain` et continue · pas de retry silencieux.
Produit
Korva ne court-circuite jamais une couche. Chaque étape laisse une trace dans l’audit log. Chaque action irréversible passe par une validation humaine explicite.
Architecture
Couche 1
FEC (Art. A47 A-1 LPF), CAMT.053 (ISO 20022), DRM XML ProDouane, DSN (NEODeS). Code Python déterministe, sans LLM. Si un fichier ne parse pas, Korva flag `incertain` et continue · pas de retry silencieux.
Couche 2
Neuf Skills core versionnés en Git (FEC viti, règles DRM, appellations FR, primeurs, IAS 41 bio, Loi Evin, INAO, CSRD ESRS wine, IAS consolidation). Trois niveaux · core Korva, business rules tenant, custom skills tenant.
Couche 3
Trois agents transverses. CEO orchestre les intentions utilisateur. Settings expose 7 domaines de configuration sur 3 niveaux de privilège. Guardian audite en continu la cohérence FEC ↔ CAMT ↔ DRM ↔ DSN.
Couche 4
CFO Agent consolide les P&L multi-entités. Treasury Agent surveille la position cash et les covenants. Reporting Agent compose le pack PE PDF. Chaque agent est un ClaudeSDKClient avec Skills + tools + permissions + hooks audit.
Couche 5
FastAPI avec middleware Clerk + middleware tenant context. Toutes les routes exécutent un SET LOCAL app.current_tenant. Serveur MCP exposé en parallèle sur https://api.korva.me/mcp avec OAuth 2.1.
Skills wine v1
Chaque Skill est un fichier markdown source-of-truth, immutable par requête, mis en cache LLM agressivement. Les tenants peuvent ajouter leurs propres business rules et custom skills.
Fiscalité
FEC viticole · plan comptable adapté, comptes 355, balises CTRL.
Stocks vins
DRM ProDouane · cohérence entrées/sorties cuves et compte 355 FEC.
Appellations
Référentiel INAO complet · AOC, IGP, mentions complémentaires.
Cycle de vente
Workflow primeurs Bordeaux · allocations, en-primeurs, livraisons.
Comptabilité
IAS 41 · valorisation actifs biologiques (cuvées en élevage).
Compliance
Loi Evin · règles de communication, supports interdits, mentions obligatoires.
Compliance
INAO · contrôles agréments, sanctions, calendriers.
Reporting ESG
CSRD ESRS · indicateurs environnementaux et sociaux adaptés au wine.
Consolidation
IFRS / IAS consolidation · méthodes IG, MEE, IP, élimination intra-groupe.
Six agents Korva
Agent
Orchestre les intentions utilisateur. Route vers les agents métier, compose la réponse finale. Pure orchestration, pas de logique wine.
Agent
Expose 7 domaines de configuration · profil structurel, comptable, commercial, production, marque, opérationnel, intégrations. Trois niveaux de privilège.
Agent
Audite la cohérence des flux ingérés. Chaînage hash dans audit_log. Émet des alertes avant qu'un écart ne devienne un problème.
Agent
Consolidation multi-entités IG / MEE / IP. Élimination intra-groupe. Restitution P&L consolidé prêt CODIR.
Agent
Réconciliation FEC ↔ CAMT.053. Position cash quotidienne. Surveillance covenants avec alertes anticipées.
Agent
Compose le pack PE PDF en sept sections. Mise en page éditoriale Korva, signable, archivable sept ans.
Couche MCP
Le serveur MCP Korva (Model Context Protocol) est exposé sur https://api.korva.me/mcp avec authentification OAuth 2.1 via Clerk. Cinq outils minimum · get_consolidated_pnl, get_treasury_position, generate_pe_report, list_compliance_alerts, query_business_rules. Rate limit 1000 requêtes par heure et par tenant.