Freelance Flow
Devis, factures conformes, relances et suivi du chiffre d'affaires pour les travailleurs indépendants.
Un indépendant qui facture jongle souvent entre trois outils : un tableur pour le devis, un traitement de texte pour la facture, sa boîte mail pour la relance. Freelance Flow réunit la chaîne complète — client, projet, devis, facture, encaissement — dans une seule application, avec une promesse simple : produire un devis ou une facture conforme en moins de deux minutes, TVA calculée au centime et mentions légales comprises.
Projet de démonstration réalisé par Aurélien Jesson-Daniel dans le cadre du titre RNCP 39583 « Expert en développement logiciel » (Ynov). L'application est déployée et fonctionnelle, mais non commercialisée : le paiement fonctionne en environnement de test Stripe, sans aucun prélèvement réel.
Application en ligne : https://freelance-flow-wine.vercel.app
Sommaire
Fonctionnalités
Facturation
- Clients identifiés par leur SIRET, vérifié et prérempli en direct via l'API publique Recherche d'entreprises.
- Projets rattachés à un client, en vue grille ou kanban, avec leurs agrégats financiers (budget, facturé, encaissé, reste à facturer).
- Éditeur de devis et de factures avec aperçu A4 en temps réel :
- montants stockés en centimes entiers, TVA par ligne et arrondi commercial ;
- trois régimes de TVA (franchise en base, réel simplifié, réel normal) et mentions légales ajoutées automatiquement (art. 293 B du CGI, pénalités et indemnité de 40 € de l'art. L441-10 du Code de commerce) ;
- numérotation légale séquentielle
FAC-2026-001 / DEV-2026-001, attribuée à l'émission seulement (un brouillon n'a pas de numéro).
- PDF généré côté serveur, identique à l'écran.
- Envoi par e-mail avec le PDF en pièce jointe ; pour un devis, un lien d'acceptation en ligne permet au client d'accepter ou de refuser sans créer de compte.
- Conversion d'un devis accepté en facture en un clic, duplication de pièces, annulation d'un statut.
- Relances automatiques des factures échues (tâche quotidienne, trois paliers et trois tons au choix).
- Logo de l'entreprise sur les documents.
Pilotage
- Tableau de bord : chiffre d'affaires encaissé, en attente, en retard, devis à relancer, graphe sur 8 mois, priorités du jour — tout est cliquable.
- Rapports : indicateurs par période (année, 12 mois glissants, trimestre), répartition du CA et délais de paiement par client, export PDF.
- Recherche globale (
⌘K / Ctrl+K) et notifications.
Compte et abonnement
- Inscription par e-mail ou Google, réinitialisation du mot de passe, changement d'adresse e-mail.
- Forfait gratuit limité à 5 documents émis par mois ; forfait Premium via Stripe Checkout (environnement de test).
- Export des données au format JSON et suppression définitive du compte (droits d'accès, de portabilité et d'effacement du RGPD).
Interface
- Responsive (utilisable sur téléphone), thème clair et sombre, navigation complète au clavier.
Stack technique
| Couche | Technologie |
|---|
| Framework | Next.js 14 (App Router, server actions), React 18, TypeScript |
| Interface | Tailwind CSS 3, composants shadcn/ui, icônes Lucide |
| Données et authentification | Supabase (PostgreSQL, Auth, Storage) avec Row Level Security |
| Accès aux données | Prisma 6 |
| Validation | Zod |
| PDF | Puppeteer (puppeteer-core + @sparticuz/chromium) |
| Paiement | Stripe Checkout et webhooks signés (mode test) |
| E-mail | Resend |
| Supervision | Sentry (erreurs uniquement) |
| Tests | bun test (unitaires et intégration), Playwright (bout en bout), axe-core |
| Hébergement | Vercel (région Dublin) |
| Environnement | Bun |
Architecture
app/
├── (public)/ Pages publiques : accueil, connexion, inscription,
│ mentions légales, page d'acceptation de devis (/proposition)
├── (app)/ Application authentifiée : tableau de bord, clients, projets,
│ │ devis, factures, rapports, abonnement, paramètres
│ └── */actions.ts Server actions : session, validation Zod, filtre utilisateur
└── api/ Routes serveur : PDF, webhook Stripe, tâche de relance, keep-alive
components/ Composants d'interface, rangés par domaine
lib/
├── invoicing/ Cœur métier pur : montants, TVA, numérotation, mentions, dates
├── pdf.ts Rendu PDF (Puppeteer)
├── reminders.ts Règles des relances (pures) — reminder-sweep.ts les exécute
└── supabase/, auth/ Clients Supabase et session
prisma/schema.prisma Modèle de données
supabase/migrations/ Migrations SQL versionnées (schéma, règles RLS, stockage)
tests/
├── integration/ Server actions contre une vraie base de test, isolation entre comptes
└── e2e/ Parcours réels dans Chromium
scripts/ Audits rejouables (accessibilité, éco-conception) et test de fumée
docs/ecoindex.md Rapport d'éco-conception
Modèle de données — une hiérarchie stricte utilisateur → client → projet → document → lignes. Chaque table porte l'identifiant de l'utilisateur.
Génération du PDF — le moteur de rendu navigue vers la vraie page du document, avec la session de l'utilisateur, et l'imprime. Il n'existe donc qu'une seule source de vérité visuelle : ce que l'utilisateur voit à l'écran est exactement ce que le client reçoit.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
