Cahier des Charges — Harambee

Objectifs cibles — Phase 1 → Phase 3

1 000

Investisseurs actifs (v1.0)

500 k€

Collecte cumulée (v1.0)

5 000

Investisseurs (v2.0)

3 M€

Collecte cumulée (v2.0)

Contexte & objectifs

Harambee — Le Club des Investisseurs Pan-africains

Harambee est une plateforme de crowdfunding / crowdequity dédiée aux projets africains, accessible à la diaspora mondiale et aux résidents du continent. Inspirée du modèle Wiseed (France), la plateforme permet à tout particulier de financer des projets structurants (agriculture, énergie, immobilier, santé, tech) avec un ticket d'entrée accessible.

La plateforme est conforme aux exigences RGPD, aux obligations LCB-FT (Lutte contre le blanchiment et le financement du terrorisme) et intègre un module KYC (Know Your Customer) avec scoring de risque automatisé.

Utilisateurs

Profils utilisateurs

Profil	Description	Droits principaux	KYC requis
Diaspora Investisseur	Membre de la diaspora africaine résidant hors du continent	Investir, consulter portefeuille, accéder marketplace secondaire	Renforcé (PPE check)
Résident Investisseur	Particulier résidant en Afrique francophone	Investir, consulter portefeuille, accéder marketplace secondaire	Basique
Porteur de projet	Entrepreneur ou structure soumettant un projet à financer	Soumettre projets, suivre collecte, publier mises à jour	Renforcé + KYB (entreprise)
Administrateur	Équipe Harambee — back-office de validation et pilotage	Valider KYC/projets, gérer utilisateurs, accéder rapports	N/A (interne)
Visiteur	Utilisateur non inscrit, navigation publique	Consulter projets publiés, landing page, catégories	Aucun

Périmètre fonctionnel

8 Modules fonctionnels

🔐

Authentification & Comptes P0

Inscription multi-canal, connexion sécurisée (Laravel Sanctum), 2FA TOTP, gestion de sessions, rôles RBAC, récupération mot de passe.

📁

Gestion des Projets P0

Soumission, validation admin, publication, suivi collecte en temps réel, 8 catégories thématiques, 44 sous-domaines, UUID, soft delete.

🪪

KYC / LCB-FT P0

Vérification identité via Jumio/Onfido, scoring risque 0–100, vérification PPE, filtrage sanctions ONU/UE, niveaux basique et renforcé, file d'attente admin.

💰

Investissement P0

5 types (don, prêt, equity, obligation, fonds), plafonds réglementaires, transaction atomique DB, référence WAR-AAAA-XXXXXX, suivi portefeuille.

🏪

Marketplace Secondaire P1

Revente de participations entre investisseurs, prix plafonné à 200% valeur d'achat, commission Harambee 1%, statuts offer/pending/sold/cancelled.

💳

Paiements Multi-gateway P1

Stripe (international), Wave, Orange Money, MTN MoMo. Webhook de confirmation, réconciliation automatique, reçus PDF, remboursements.

🔔

Notifications P1

Email (SendGrid), SMS (Twilio), push web. Notifications : validation KYC, investissement confirmé, projet financé, relance, newsletter.

⚙️

Administration P0

Back-office XAMPP (prototype) + interface Laravel. Tableaux de bord KPI, rapports CSV/PDF, paramétrage plateforme, logs d'audit.

Catégories d'investissement

8 Thèmes · 44 Sous-domaines

#	Thème	Sous-domaines principaux
1	🌾 AgriTech & Agriculture	Agriculture durable, Élevage, Irrigation, Pisciculture, Transformation alimentaire, Agroforesterie
2	🏘️ Immobilier & Habitat	Résidences diaspora, Logements sociaux, Bureaux & coworking, Centres commerciaux, Tourisme
3	💻 Tech & Digital	Fintech, E-commerce, Santé digitale, EdTech, IA & Data, SaaS, Cybersécurité
4	☀️ Énergies Renouvelables	Solaire, Éolien, Biomasse, Mini-réseaux ruraux, Efficacité énergétique, Stockage
5	🏥 Santé & Bien-être	Cliniques, Pharmacies, Médecine préventive, Médecine traditionnelle, Équipements médicaux
6	📚 Éducation & Formation	Écoles primaires/secondaires, Universités, Centres de formation, Bourses, EdTech
7	🚧 Infrastructure	Transport & logistique, Eau & assainissement, Télécoms, Routes, Ports
8	💰 Finance & Services	Microfinance, Assurance, Épargne solidaire, Services aux PME, Leasing

Exigences techniques

Exigences non-fonctionnelles

Domaine	Exigence	Mesure
Performance	Chargement page < 2 s	Lighthouse Score ≥ 90
Disponibilité	SLA production ≥ 99,5 %	Monitoring UptimeRobot
Sécurité	OWASP Top 10 couvert	Audit trimestriel + CI
RGPD	Droit à l'oubli, export données	Endpoint /account/export
LCB-FT	Déclaration de soupçon	Score > 70 → blocage auto
Couverture tests	≥ 80 % de couverture code	PHPUnit + GitHub Actions
Accessibilité	WCAG 2.1 AA	Axe audit CI
Multi-devises	EUR, USD, XOF, GHS, NGN	Taux via API Fixer.io

Qualité

Définition du Terminé (DoD)

Feature implémentée selon les specs (tous les cas nominaux et alternatifs couverts)
Tests unitaires écrits et passants (PHPUnit, couverture ≥ 80 %)
Tests de non-régression mis à jour et passants
Code reviewé par au moins un autre développeur (PR approuvée)
Aucune régression détectée sur les fonctionnalités existantes
Documentation inline (PHPDoc) complète sur les classes et méthodes publiques
Pipeline CI GitHub Actions vert (lint + tests + coverage)
Feature déployée en staging et validée manuellement par l'équipe Harambee