D-AGROBUSINESS

SaaS de gestion intégrée de la chaîne de valeur agricole : financement, intrants, parc matériel, production, usine de transformation, RH/paie et comptabilité analytique (département × secteur/projet × campagne).

Stack : Next.js 16 (App Router), Supabase (Postgres + RLS + Auth), Tailwind v4, composants de style shadcn/ui.

Mise en route

1. Copier .env.example vers .env.local et renseigner l'URL et la clé publique du projet Supabase.
2. Appliquer les migrations de supabase/migrations/ dans l'ordre (SQL Editor Supabase ou supabase db push).
3. npm install puis npm run dev.
4. Créer une organisation depuis /signup : plan comptable (selon le pays), départements et journaux sont initialisés automatiquement.

Commandes

npm run dev               # serveur de développement
npm run build             # build de production (contrôle d'abord les traductions)
npm run lint              # eslint
npm run typecheck         # tsc --noEmit
npm run i18n:check        # traductions fr/en/ar complètes
npm run audit:securite    # RLS, fonctions security definer, secrets (voir docs/AUDIT.md)
npm run audit:coherence   # cohérence des données (lecture seule, clé de service)
npm run audit:index       # clés étrangères sans index
npm run seed:demo         # crée l'entreprise de démonstration « Riz du Delta »

Phase 0 — Fondations (livrée)

• Multi-tenant par organisation_id, rôles (admin, comptable, chef de département, RH, direction, lecteur), RLS sur toutes les tables, journal d'audit.
• Référentiels : départements, secteurs/projets, exercices, campagnes, tiers unifiés.
• Moteur comptable : plan comptable par référentiel (SYSCOHADA complet sur les comptes principaux ; PCM Maroc et Mauritanie en squelette, à faire valider), journaux, écritures immuables et équilibrées, imputation analytique obligatoire sur les classes 6 et 7, contre-passation, balance et résultat analytique.

Phases livrées

• Phase 1 : catalogue, stocks (CUMP, stock propre / consigné), achats, dépôt-vente, ventes et distribution, remboursement en nature, trésorerie.
• Phase 2 : emprunts, crédit de campagne, fonds de commercialisation, crédit-bail, subventions d'investissement (reprise au taux de financement), parc matériel et amortissements.
• Phase 3 : production par secteur × campagne (coût analytique, rendement), usine de transformation (nomenclatures, ordres de fabrication, répartition matière + frais).
• Phase 4 : personnel, contrats, pointage, congés, paie paramétrable avec verrou de validation.
• Traçabilité et qualité (migration 27) : lots créés automatiquement par chaque récolte et chaque fabrication (ou à la main pour les achats), filiation matière → produit fini, contrôles qualité avec blocage automatique d’un lot non conforme, expéditions refusées pour un lot bloqué ou périmé, rappel de lot (clients touchés en aval).
• Rapprochement bancaire (migration 28) : import d’un relevé CSV, pointage automatique (uniquement sans ambiguïté) ou manuel avec les écritures de la banque, comptabilisation des lignes absentes des livres (frais, agios), écart de rapprochement.
• Trésorerie prévisionnelle (migration 29) : plan à 12 mois (soldes, échéances de financement, créances et dettes ouvertes avec délai de règlement paramétrable, prévisions saisies uniques ou mensuelles), alerte au premier mois de trésorerie négative. Les ventes futures sont estimées d’après l’historique (même mois des années précédentes, sinon moyenne des 12 derniers mois), retenues à 80 % par défaut (0 à 100 % au choix) et encaissées avec le délai des créances ; le mois en cours n’est pas estimé. La masse salariale est reprise de la paie (moyenne des 3 dernières paies, reconduite chaque mois ; désactivable).

Paie : impôt et TRIMF calculés automatiquement

L'impôt sur le revenu et la TRIMF se calculent à partir du brut, du nombre de parts et du nombre de conjoints, sans barème à importer :

1. base = brut − abattement (30 %, plafonné à 900 000 par an), arrondie à l'inférieur (1 000) ;
2. impôt brut = barème progressif ; réduction pour charges de famille selon les parts (minimum et maximum) ;
3. TRIMF = palier du brut × (1 + nombre de conjoints).

Permanents : base annuelle · saisonniers : base mensuelle · journaliers : base journalière (annualisée × 360 puis ÷ 360). Cette formule reproduit exactement le barème officiel de retenue à la source du Sénégal (vérifié sur les 19 823 lignes de ses grilles annuelle, mensuelle et journalière).

Tout est paramétrable par organisation dans Paie → Paramètres (tranches, réductions, paliers de TRIMF, abattement, arrondi, cotisations), donc adaptable à un autre pays. Un mode « table » permet aussi d'importer une grille de retenue (CSV, supabase/seed/bareme_retenue_sn_2013.csv pour l'exemple sénégalais) pour les pays qui publient un barème par lignes. Un administrateur doit valider le paramétrage avant tout calcul de paie ; toute modification impose une nouvelle validation.

Règle des trois langues (français, anglais, arabe)

Tout texte de l'interface, message d'erreur ou libellé doit exister en français, en anglais et en arabe. Le français sert de clé : t('Texte') côté serveur (creerT(ctx.lang)) ou useT() côté client, avec les traductions dans lib/i18n-en.ts et lib/i18n-ar.ts.

npm run i18n:check (exécuté aussi automatiquement avant npm run build) recense tous les textes du code et des migrations et échoue s'il en manque un dans l'une des deux langues, si un marqueur {nom} ou § n'est pas conservé, si une traduction arabe ne contient pas d'arabe, ou si une clé est en double. Option -- --orphelines : liste les clés de dictionnaire devenues inutiles.

Abonnements et paiements

Trois niveaux : Standard (10 000 F CFA / mois : sans l'usine de transformation ni les ressources humaines), Medium (12 500 : tout sauf les ressources humaines) et Premium (15 000 : tout). Les fonctions fermées le sont partout : menu masqué, pages redirigées et tables protégées dans la base (migrations 31 et 32). Un mois seul est au prix plein ; à partir de 2 mois payés d'un coup, la remise est de 1 % par mois payé (durées proposées : 1, 6 et 12 mois).

Durée	Standard	Medium	Premium
1 mois	10 000	12 500	15 000
6 mois (−6 %)	56 400	70 500	84 600
12 mois (−12 %)	105 600	132 000	158 400

Chaque organisation démarre par 7 jours d'essai avec l'accès Premium ; ensuite l'accès est fermé (redirection vers la page Abonnement) tant qu'aucun paiement n'a abouti. Un paiement prolonge l'abonnement à partir de son échéance ; le niveau ne change qu'à l'échéance.

Prestataires (un compte plateforme par prestataire, variables dans .env.example) : Bictorys (Wave, Orange Money), Moneroo (carte bancaire), Chariow (Mobile Money et carte). Chariow débite le prix d'un produit préconfiguré : créer un produit par niveau et par durée dans la boutique Chariow, au montant du tableau, et déclarer chaque identifiant dans une variable CHARIOW_PRODUCT_<NIVEAU>_<MOIS> (ex. CHARIOW_PRODUCT_PREMIUM_12). Webhooks à déclarer chez chaque prestataire : /api/webhooks/bictorys, /api/webhooks/moneroo, /api/webhooks/chariow?secret=<CHARIOW_WEBHOOK_SECRET>. Un cron quotidien (vercel.json, CRON_SECRET) re-vérifie les paiements Chariow en attente. Aucun paiement n'est crédité sur la foi du seul webhook Chariow : le statut est relu auprès du prestataire.

Super-administration et démonstration

• /admin (réservé aux emails de ADMIN_EMAILS, identité partagée avec les autres produits DembaSolution) : tableau de bord de la plateforme, entreprises (niveau, échéance, abonnement accordé à la main, prolongation d'essai, verrouillage), paiements, configuration (moyens de paiement proposés aux clients : Chariow actif, Bictorys et Moneroo prêts en attente de leurs clés ; produits Chariow par niveau et durée ; adresses des webhooks). Migration 33.
• Démonstration : npm run seed:demo crée l'entreprise « Riz du Delta » (campagnes, achats, production, usine, ventes, financement, paie, traçabilité, prévisions, rapprochement). Le lien « Découvrir » (/decouvrir-dagrobusiness) ouvre une session sans mot de passe sur les comptes direction, comptable ou RH.
• Vitrine : /bienvenue (accueil), /tarifs, /decouvrir-dagrobusiness. Un visiteur non connecté sur / est redirigé vers l'accueil. Fiche à reprendre sur la landing DembaSolution : docs/fiche-produit-landing-dembasolution.md.
• Audit : docs/AUDIT.md.