Talok — Module Comptabilité : Référence COMPLÈTE

2. Tables SQL (15 tables + audit_log + triggers + RLS)

Triggers : trg_entry_balance (vérifie sum=0 avant validation), trg_locked_entry (intangibilité), trg_audit_entries (audit auto)

3. Engine double-entry — API

14 écritures automatiques (AUTO_ENTRIES)

4. FEC (18 champs art. A47 A-1 LPF)

Format .txt, UTF-8 avec BOM, tabulation. Montants en 1234,56 (virgule FR). Séquentiel sans rupture. Trié par ValidDate croissante.

• generateFEC(supabase, entityId, exerciseId, siren) → FECResult { content, filename, lineCount, errors }
• validateFECContent(content) → FECValidationResult { valid, errors, warnings, lineCount }
• exportFEC(...) → blob UTF-8 + BOM, filename {SIREN}FEC{YYYYMMDD}.txt, mimeType

5. Rapprochement bancaire

Score = 50 (montant match) + dateProximity×0.3 + labelSimilarity×0.2 (Jaccard)

Détection transferts internes : même montant, sens inversé, connexions différentes, même jour ±1.

API : reconcileTransactions, manualMatch, acceptSuggestion, ignoreTransaction, getReconciliationStats

6. Plan comptable

• PCG owner : 35 comptes (164-791), dans PCG_OWNER_ACCOUNTS
• Copro décret 2005 : 30 comptes (102-718), dans COPRO_ACCOUNTS
• Journaux : ACH, VE, BQ, OD, AN, CL
• initializeChartOfAccounts(supabase, entityId, 'pcg' | 'copro' | 'both')
• addCustomAccount(supabase, entityId, accountNumber, label, accountType)

7. Amortissements

Décomposition par composant (terrain 15% non amortissable par défaut). Linéaire. Prorata temporis année 1.

• decomposeProperty(totalCents, terrainPct) → PropertyComponent[]
• computeLinearAmortization(depreciableCents, years, acqDate) → AmortizationLineResult[]
• saveAmortizationSchedule(supabase, ...) → { scheduleId, lineCount }

Composants standard : terrain (15%), gros_oeuvre (40%/50ans), facade (10%/25ans), installations (15%/25ans), agencements (10%/15ans), equipements (10%/10ans)

8. OCR Pipeline

Prompt système dans OCR_EXTRACTION_SYSTEM_PROMPT : retourne JSON strict avec document_type, montants en centimes, suggested_account, alerts.

Validation TVA : validateTVACoherence(detectedRate, territory) — 5 territoires DROM-COM. Validation montants : validateOCRAmounts(extracted) — cohérence HT + TVA = TTC.

Important : Le document physique est géré par talok-documents-sota (upload, storage, bucket). L'analyse OCR/IA et la liaison comptable sont gérées ICI via document_analyses.

8.1 Auto-trigger à l'upload

Depuis QW3, l'OCR comptable est déclenché automatiquement à l'upload pour les 6 types de pièces comptables :

Point d'entrée : app/api/documents/upload/route.ts appelle triggerAccountingOcr() (lib/accounting/auto-ocr.ts) en fire-and-forget après l'insert documents.

Comportement quota :

• Plan gratuit ou indéfini → skip + metadata.ocr_skipped_reason = 'plan_not_eligible'
• Plan confort quota 30/mois atteint → skip + metadata.ocr_skipped_reason = 'quota_exceeded'
• Plans pro / enterprise_* → illimité, jamais skippé

Garde-fous :

• Re-check existence du document (race avec delete)
• Skip si entity_id du document ≠ entity attendu
• Skip si une analyse existe déjà pour ce document
• Jamais throw — toutes les erreurs sont loggées

L'OCR auto n'auto-valide PAS l'écriture. L'extraction atterrit dans document_analyses.extracted_data avec processing_status='completed'. La création de l'écriture reste déclenchée manuellement par l'utilisateur via POST /api/accounting/documents/[id]/validate (revue humaine obligatoire).

Extension de la liste : pour ajouter un type au trigger auto, éditer OCR_ACCOUNTING_DOCUMENT_TYPES dans lib/accounting/auto-ocr.ts et documenter ici.

9. Feature gating comptabilité

10. Règles absolues

1. JAMAIS calcul financier frontend
2. TOUJOURS centimes INTEGER
3. TOUJOURS sum(D)=sum(C)
4. JAMAIS modifier écriture validée → contre-passer
5. JAMAIS FEC sans validation
6. TOUJOURS vérifier plan avant action
7. JAMAIS écriture OCR sans validation humaine
8. TOUJOURS SHA-256 sur docs archivés (→ voir talok-documents-sota)
9. JAMAIS supprimer doc < 10 ans
10. TOUJOURS séparer comptes mandants (Hoguet)
11. TOUJOURS plan copro décret 2005 pour syndic
12. JAMAIS hardcoder TVA (5 taux DROM-COM dans TVA_RATES)
13. TOUJOURS lettrer après rapprochement
14. TOUJOURS audit log sur écritures

11. Frontières avec les autres skills