Guide d'Utilisation — X-Fund
Plateforme de Crowdfunding Immobilier
0. Accès et Préparation
Comptes utilisateurs
admin@test.com — Tous les autres : TestXfund2026!
Redirection apres connexion
| Role | Redirection |
|---|---|
| Admin | /admin/dashboard |
| Investisseur | /investor/dashboard (ou onboarding si non complete) |
| Porteur de projet | /dashboard |
| Analyste | /analyste/dashboard |
Statut des integrations
Les 4 roles de la plateforme
Crée et soumet le projet"] -->|soumet un projet| B["Analyste
Évalue le projet"] B -->|analyse et note| C["Administrateur
Supervise la plateforme"] C -->|approuve et active| D["Investisseurs
Investissent dans le projet"] D -->|investissent| A
| Role | Description | Interface |
|---|---|---|
| Administrateur | Supervise toute la plateforme : approbation, allocation, dividendes, retards, parametres | Sidebar laterale |
| Analyste | Évalue les projets soumis, communique avec les porteurs via chat | Sidebar laterale |
| Porteur de Projet | Crée et gère ses projets immobiliers, factures, rembourséments | Navbar + chat flottant |
| Investisseur | Explore les projets, investit, suit ses rendements et son portefeuille | Navbar horizontale |
Widget Voyage dans le Temps
Diagramme Global du Cycle de Vie
Ce diagramme represente l'ensemble du cycle de vie d'un projet d'investissement sur X-Fund. Chaque noeud correspond a une phase détaillée dans les sections qui suivent.
Legende : Automatique Déclenchée par le système (date atteinte, parts vendues, cooling-off expire) Manuelle Déclenchée par un utilisateur (porteur, analyste, admin)
Étapes
karim.mansouri@test.com)/dashboard) — vue des projets et actions rapides/projects/new) — lancer le formulaire multi-etapes. Le bien immobilier (titre, description, type, adresse, prix d'acquisition, valeur estimee) est cree directement dans le formulaire du projet.Formulaire de creation de projet (13 etapes)
| # | Étape | Contenu |
|---|---|---|
| 1 | Presentation | Titre, description, type d'operation, stratégie d'exploitation |
| 2 | Localisation | Selection/creation d'un bien, adresse complete |
| 3 | Porteur du projet | Informations porteur et société (SIRET, forme juridique, expertise) |
| 4 | Structure financiere | Montant total, prix/part, investissement min/max, rendement, durée, fréquence |
| 5 | Apport et financement | Apport personnel, frais notaire, budget travaux, prêtbancaire |
| 6 | Plan de charges | Detail des charges prévisionnelles |
| 7 | Plan de vente | Configuration des lots (division/vente) |
| 8 | Simulation financiere | Apercu repartition des fonds, commissions, escrows |
| 9 | Garanties | Hypothèque, fiducie, caution, séquestres intérêts/travaux |
| 10 | Photos | Upload des photos du bien |
| 11 | Documents | Contrat obligataire, FICI, PV decision, note d'operation |
| 12 | Infos complémentaires | Toute information additionnelle |
| 13 | Signature et soumission | Consentement et soumission finale |
Le rendement net peut etre calcule automatiquement (base 8% + modificateurs), dans une fourchette de 8% a 12%. Un snapshot du formulaire est sauvegarde a la soumission.
admin@test.com), allez dans Projets (/admin/projects), et verifiez quel analyste est assigne au projet que vous venez de creer (attention a ne pas le confondre avec d'autres projets existants).
Étapes
admin@test.com), aller dans Projets (/admin/projects), reperer le projet soumis et noter l'analyste assignemarc.lefevre@test.com ou julie.moreau@test.com)/analyste/dashboard) — KPI et file de projets/analyste/projects) — trouver le projet de KarimDemande d'informations supplémentaires
Si l'analyste a besoin d'infos complémentaires :
- L'analyste crée une InfoRequest (champs/documents manquants)
- Statut → "Informations demandees"
- Le porteur recoit une notification et fournit les reponses
- Statut → "Informations re-soumises"
- L'analyste reprend son analyse
Ce cycle peut se repeter autant de fois que necessaire.
Étapes
admin@test.com)/admin/projects) — trouver le projet "Analyse soumise"Scenarios alternatifs
Rejet
Statut → rejected. Le porteur et l'analyste recoivent le motif du rejet. Le porteur peut modifier et resoumettre.
Demande de revision (Redo)
Statut revient a pending_analysis. L'opinion et verifications sont effacées. L'analyste doit re-analyser.
Demande d'information
Statut → info_requested. Le porteur est notifié.
Reassignation d'analyste
L'admin peut changer l'analyste assigne. Les champs d'analyse sont reinitialises.
Étapes
/admin/projects/:id/structuring) — statut → "Structuration juridique"/admin/projects/:id/legal-documents) — preparer les 3 documents : Convention, Contrat de Prêt, FICILes 3 documents legaux
| Document | Description |
|---|---|
| Convention | Accord de partenariat entre la plateforme et le porteur |
| Contrat de Prêt | Contrat formel avec conditions, taux et échéancier |
| FICI | Fiche d'Information Cle sur l'Investissement (obligation réglementaire) |
Environnement actuel : YouSign sandbox — signatures non juridiquement contraignantes.
funding_start_date est dans le futur, avancez jusqu'a cette date via le widget. La transition vers "Collecte en cours" se fera automatiquement.
Étapes
sophie.martin@test.com)/investor/wallet) — cliquer "Deposer", saisir le montant (min 10 EUR)/investor/projects) — parcourir la grilleOnboarding investisseur (8 phases)
| Phase | Contenu |
|---|---|
| Identite (5 etapes) | Type client, nom, telephone, date de naissance, adresse |
| Bienvenue | Presentation de la plateforme |
| Objectifs (3 etapes) | Objectifs, horizon temporel, appetit pour le risque |
| Patrimoine (4 etapes) | Revenus, actifs, depenses, capacité d'investissement |
| Experience (4 etapes) | Engagements, montant investi, experience, transactions |
| Connaissances (3 etapes) | Obligations, liquidité, risques |
| KYC | Upload piece d'identité + justificatif de domicile |
| Completion | Page de confirmation |
Contraintes d'investissement
- Montant = multiple du prix par part
- Minimum et maximum du projet respectes
- KYC vérifié
- Solde suffisant
- Investisseurs "non averti" : plafond annuel de 1 000 EUR (ECSP)
- Investisseurs "averti" : pas de plafond
Retractation (cooling-off de 4 jours)
Chaque investissement a une période de rétractation de 4 jours :
- Annulation possible depuis
/investor/investments/:id - Banniere avec compte a rebours affichée
- Remboursément integral (y compris frais)
- Si le projet etait "Finance" : retour a "Collecte en cours"
- Apres 4 jours : confirmation automatique
Étapes
/admin/projects/:id/escrow)| Destination | Calcul (ex : 500 000 EUR) |
|---|---|
| Commission plateforme | 500 000 x 6% = 30 000 EUR |
| Frais de notaire | 500 000 x 1,5% = 7 500 EUR |
| Séquestre intérêts | Calcule selon rendement x durée |
| Séquestre travaux | Budget travaux (si applicable) |
| Versement au porteur | Solde restant |
vérifiéd_start_date. Statut → "Actif"Detail de l'allocation des fonds
Operation atomique (tout reussit ou tout est annule).
Invariant : Apres allocation, le solde du portefeuille de financement doit etre exactement zero.
ReleaseInterestJob crée et distribué automatiquement.
Étapes
/admin/projects/:id/dividends/newCalcul des intérêts et methode de repartition
Methode Actual/365 (jour exact)
Périodes de dividendes
- Premiere : Proratisée de la vérifiéd_start_date au prochain jour de paiement
- Intermédiaires : Durée complete (1, 3, 6 ou 12 mois)
- Dernière : Proratisée jusqu'a la maturité — utilise le solde restant du séquestre
Repartition : Plus Grand Reste
- Calculer le montant exact par investisseur
- Arrondir vers le bas (floor)
- Distribuér les centimes restants aux plus grandes fractions
- Zero perte d'arrondi
Étapes
/admin/projects/:id/works-invoices/:id)Rapports de suivi (MVP Reports)
Le porteur peut soumettre des rapports de suivi :
- Categories : administratif, travaux, commercialisation, financier
- Avancement des travaux (%), ecart budgetaire, raisons des retards
- L'analyste examine et valide chaque rapport
- Des mises a jour sont publiees pour les investisseurs
Étapes
Mecanismes du remboursément anticipé
Zero pénalité — entierement volontaire.
Excédent du séquestre
- Total : Tout le solde restant retourne (moins intérêts proratas)
- Partiel : Seule la portion excedant les obligations futures
Cas special : montant < 1 centime par part
- Total : Distribution forcée
- Partiel : Report au prochain dividende (
carry_over_interest_cents)
Timeline des pénalités
Phase 1 : Grace
J+1 a J+10
Pas de pénalités actives
Frais d'incident 500 EUR actives des J+1
Intérêts sur frais d'incident commencent a courir
Phase 2 : Pénalités
J+11 a J+29
Forfaitaire 5%
Intérêts retard 12%/an
Phase 3 : Garantie
J+30+
Phase 2 continue +
Activation garantie 10 000 EUR
Étapes
/admin/recovery) — consulter les projets en retard| # | Action | Destinataire |
|---|---|---|
| 1 | Capital restant distribué | Investisseurs |
| 2 | Solde séquestre intérêts distribué | Investisseurs |
| 3 | Pénalités distribuées (forfaitaire + retard) | Investisseurs |
| 4 | Frais plateforme collectes (incident + garantie) | Portefeuille plateforme |
| 5 | Soldes résiduels escrows retournes | Porteur |
Calcul détaillé des pénalités
| Pénalité | Formule | Exemple (500 000 EUR) |
|---|---|---|
| Forfaitaire | Capital x 5% | 25 000 EUR |
| Intérêts retard | Capital x (12%/365) x jours | ~164 EUR/jour |
| Frais incident | Fixe | 500 EUR |
| Intérêts frais | 500 x (12%/365) x jours | ~0,16 EUR/jour |
| Activation garantie | Fixe (a partir de J+30) | 10 000 EUR |
Collecte partielle des frais plateforme
L'admin peut collecter uniquement les frais plateforme sans distribuér aux investisseurs (frais d'incident, intérêts sur frais, frais de garantie). Cela permet de securiser les revenus plateforme avant la resolution complete.
Annexe A : Voyage dans le Temps
Qu'est-ce que c'est ?
Outil de simulation temporelle réservé aux environnements de développement et staging. Permet de manipuler la date simulée pour tester les fonctionnalités dependantes du temps sans attendre le passage reel des jours.
Interface du widget
| Element | Description |
|---|---|
| Bouton declencheur | Icone d'horloge dorée + badge "DEV", en bas a gauche |
| Date actuelle | Format français, avec indicateur "Date réelle" ou "Date simulée" |
| Tag d'offset | Decalage affiche (ex : "+2 mois", "+14 jours") |
Actions disponibles
| Action | Description |
|---|---|
| Pas rapides | 6 boutons : -1 jour, +1 jour, -1 semaine, +1 semaine, -1 mois, +1 mois |
| Pas personnalise | Nombre + unite (Jours/Semaines/Mois/Annees) + direction |
| Aller a une date | Champ date + bouton "Aller" |
| Réinitialiser | "Réinitialiser (aujourd'hui)" — retour au temps reel + rollback complet |
Snapshot et rollback
Restriction
Le Voyage dans le Temps ne peut pas reçuler avant la date réelle. Pour revenir a la date réelle, utilisez "Réinitialiser".
Annexe B : Paramètres de la Plateforme
47 parametres configurables depuis /admin/settings, organises en 8 categories.
Plateforme
| Paramètre | Défaut | Description |
|---|---|---|
| Nom | X-Fund | Nom affiche |
| Email contact | contact@x-fund.com | Email de contact |
| Devise | EUR | Devise par defaut |
| Mode maintenance | Non | Désactivé l'acces |
| Max projets/analyste | 7 | Limite d'assignation |
Investissement
| Paramètre | Défaut | Description |
|---|---|---|
| Investissement min | 1 000 EUR | Montant minimum |
| Investissement max | 500 000 EUR | Montant maximum |
| Clôture auto | Oui | Transition auto quand 100% finance |
| Max projets/porteur | 10 | Limite par porteur |
Commissions et Rendements
| Paramètre | Défaut | Description |
|---|---|---|
| Commission plateforme | 6% | Sur le montant collecte |
| Frais de notaire | 1,5% | Inscription hypothécaire |
| Commission investissement | 0% | Sur chaque investissement |
| Commission dividende | 0% | Sur chaque distribution |
| Rendement de base | 8% | Taux de référence |
| Rendement plancher/plafond | 8% / 12% | Fourchette autorisée |
Pénalités
| Paramètre | Défaut | Description |
|---|---|---|
| Pénalité forfaitaire | 5% | Sur capital impaye (J+11) |
| Intérêts de retard | 12% annuel | Quotidien a partir de J+11 |
| Debut intérêts retard | J+11 | Grace de 10 jours |
| Frais d'incident | 500 EUR | Montant fixe |
| Jour activation garantie | J+30 | Déclenchement indemnite |
| Frais activation garantie | 10 000 EUR | Indemnite de gestion |
Portefeuille
| Paramètre | Défaut |
|---|---|
| Depot min / max | 10 / 1 000 000 EUR |
| Retrait min / max | 50 / 500 000 EUR |
| Delai retrait | 48 heures |
| Frais transaction | 0% |
KYC
| Paramètre | Défaut |
|---|---|
| KYC obligatoire | Oui |
| Document identité requis | Oui |
| Justificatif domicile requis | Oui |
| Validite KYC | 12 mois |
| Rappel avant expiration | 7 jours |
Sécurité
| Paramètre | Défaut |
|---|---|
| Expiration JWT | 24 heures |
| Tentatives connexion max | 5 |
| Longueur min mot de passe | 8 caracteres |
Annexe C : Tableau des Frais
Frais standard
| Frais | Taux / Montant | Moment | Destination |
|---|---|---|---|
| Commission deblocage | 6% | Allocation des fonds | Plateforme |
| Frais notaire | 1,5% | Allocation des fonds | Plateforme |
| Commission investissement | 0% (configurable) | A chaque investissement | Plateforme |
| Commission dividende | 0% (configurable) | A chaque distribution | Plateforme |
Frais de retard
| Frais | Taux / Montant | Déclenchement | Destination |
|---|---|---|---|
| Frais incident | 500 EUR | Des J+1 | Plateforme |
| Intérêts frais incident | 12% annuel | Quotidien | Plateforme |
| Pénalité forfaitaire | 5% | A partir de J+11 | Investisseurs |
| Intérêts de retard | 12% annuel | A partir de J+11 | Investisseurs |
| Activation garantie | 10 000 EUR | A partir de J+30 | Plateforme |
Exemple : Projet de 500 000 EUR
| Scenario | Detail | Montant |
|---|---|---|
| Normal | Commission deblocage | 30 000 EUR |
| Frais notaire | 7 500 EUR | |
| Total | 37 500 EUR | |
| +Retard J+35 | Frais incident + intérêts | ~506 EUR |
| Activation garantie | 10 000 EUR | |
| Supplement | ~10 506 EUR | |
| Total global | ~48 006 EUR |
Annexe D : Diagramme Complet des Statuts
Tous les statuts d'un projet
| # | Statut technique | Libelle | Description |
|---|---|---|---|
| 0 | draft | Brouillon | Sauvegarde, non soumis |
| 1 | pending_analysis | En attente d'analyse | Soumis, en attente de revue |
| 2 | info_requested | Informations demandees | Infos supplémentaires requises |
| 12 | info_resubmitted | Infos re-soumises | Porteur a fourni les infos |
| 13 | analysis_submitted | Analyse soumise | Analyste a soumis |
| 3 | rejected | Rejeté | Rejeté par l'admin |
| 4 | approved | Approuvé | Approuvé par l'admin |
| 5 | legal_structuring | Structuration juridique | Documents en preparation |
| 6 | signing | En signature | Contrats envoyes pour signature |
| 14 | coming_soon | Bientot disponible | Signes, en attente debut collecte |
| 7 | funding_active | Collecte en cours | Ouvert aux investisseurs |
| 8 | funded | Finance | 100% finance, cooling-off |
| 17 | guarantees_pending | Garanties en attente | Validation des garanties |
| 15 | active | Actif | Prêt active, intérêts courent |
| 16 | delayed | En retard | Maturité dépassée |
| 9 | under_construction | En travaux | Construction/renovation |
| 10 | operating | En exploitation | Revenus locatifs |
| 11 | repaid | Remboursé | Capital remboursé — termine |
Diagramme complet
Transitions automatiques
| De | Vers | Déclencheur |
|---|---|---|
coming_soon | funding_active | funding_start_date atteinte |
funding_active | funded | Toutes les parts vendues |
funded | guarantees_pending | Cooling-off expire (4 jours) |
signing | coming_soon | 3 documents signes |
active | delayed | Maturité dépassée |
Transitions manuelles (Admin)
| Action | De | Vers |
|---|---|---|
| Approuvér | analysis_submitted | approved |
| Rejetér | tout statut analyse | rejected |
| Structuration | approved | legal_structuring |
| Allouer + Activer | guarantees_pending | active |
| Résoudre retard | delayed | repaid |
| Remboursément total | active | repaid |
Annexe E : Glossaire
| Terme | Définition |
|---|---|
| AUM | Assets Under Management — valeur totale des investissements actifs |
| Contrat obligataire | Document juridique encadrant l'emission des obligations |
| Convention | Accord de partenariat plateforme/porteur |
| Cooling-off | Période de 4 jours de droit de rétractation |
| Dividende | Paiement periodique aux investisseurs (intérêts ou capital) |
| ECSP | European Crowdfunding Service Provider — cadre réglementaire |
| Escrow (Séquestre) | Compte ségregué pour un usage spécifique (intérêts ou travaux) |
| FICI | Fiche d'Information Cle sur l'Investissement |
| Fiducie | Actifs détenus par un fiduciaire en garantie |
| Hypothèque 1er rang | Droit de priorite sur le bien en cas de defaut |
| In-fine | Paiement unique a la maturité (pas de versements intermédiaires) |
| Investisseur averti | Sans plafond annuel d'investissement |
| Investisseur non averti | Plafond annuel de 1 000 EUR (ECSP) |
| KYC | Know Your Customer — verification d'identité |
| Lemonway | Prestataire de paiement (integration en attente) |
| Maturité | Date d'échéance du prêt(debut + durée) |
| Note d'operation | PDF auto-généré résumant l'analyse |
| Obligation | Titre financier emis — l'instrument d'investissement |
| Part | Unite d'investissement a prix fixe |
| Plus grand reste | Methode de repartition des dividendes (zero arrondi) |
| Porteur de projet | Personne ou entite cherchant a lever des fonds |
| PV Decision | Procès-verbal de la decision d'approbation |
| Rendement brut | Taux annuel avant frais plateforme |
| Rendement net | Taux annuel apres frais — rendement effectif |
| Séquestre intérêts | Fonds pré-provisionnés pour les paiements d'intérêts |
| Séquestre travaux | Budget construction détenu en escrow |
| Verified start date | Date officielle de debut du pret |
| YouSign | Plateforme de signature électronique (actuellement sandbox) |
X-Fund — Guide d'Utilisation v1.0 — 3 avril 2026