Skip to content

danielcraft57/Facturio

Repository files navigation

PrestaFacture

Server CI Coverage Node

API de facturation orientée prestations de services numériques : développement web, logiciel sur mesure, automatisation, intégrations API, maintenance et offres IA. Clients, catalogue de prestations, devis, factures, paiements, TVA (FR/UE) et déclarations.

Positionnement · Monétisation · Stratégie acquisition 2026 · Réforme 2026 · Dossier PA

Démarrage rapide

Pré-requis: Node 20+ et npm.

Option 1 : Démarrer tout (backend + frontend)

npm install
npm run install:all  # Installer les dépendances backend et frontend
npm run start:all    # Démarrer backend (port 3000) et frontend (port 5173)

Option 2 : Démarrer séparément

# Backend
cd server
npm i
npx prisma migrate dev
npm run seed:dev  # optionnel (taux de TVA FR)
npm run start:dev

# Frontend (dans un autre terminal)
cd frontend
npm i
npm run dev

Plus de détails: voir server/README.md et docs/getting-started/ENVIRONMENTS.md.

Documentation

Toute la documentation est disponible dans le dossier docs/ :

Démarrage rapide

API & Développement

Modules spécialisés

Planning

Changelog

Voir Documentation complète pour l'index complet.

Documentation par composant :

  • Backend: server/README.md
  • Frontend: frontend/README.md
  • Roadmap serveur: server/ROADMAP.md

UI & thèmes

Une démo statique des thèmes est disponible dans ui/:

  • Ouvrir ui/index.html dans le navigateur
  • Thèmes: Minimal Pro, Moderne chaleureux, Énergique, Business sombre
  • Fichiers: ui/theme-*.css et ui/theme-base.css

Structure

PrestaFacture/
  server/
    src/...
    prisma/...
  ui/
    index.html
    theme-*.css

Pour le détail des endpoints, exemples cURL, règles TVA et configuration (CORS, env, Postgres), référez-vous à server/README.md.

Comptabilité (nouveau)

  • Plan comptable minimal seedé (512, 411, 706, 44571, 44566, 606, 615, 622, 641, 645, 421, 431, 635, 447) et journaux VE (ventes), BQ (banque), OD.

  • Écritures automatiques:

    • Vente: 411/706/44571 à la création de facture
    • Encaissement: 512/411 au paiement
    • Achats services: 622/44566/401 et paiement fournisseur: 401/512
    • Paie: 641/645 au débit, 421/431 au crédit; paiement URSSAF: 431/512
    • Contributions: micro-social (CA x taux) 645/431, C3S 635/447
  • Endpoints clés:

    • Comptes, journaux, écritures: GET/POST /accounting/*
    • Rapports: Balance GET /accounting/reports/balance, Grand livre GET /accounting/reports/general-ledger?account=706
    • Export FEC: GET /accounting/exports/fec?start=YYYY-MM-DD&end=YYYY-MM-DD
    • Prestataires: POST /accounting/purchases/service, POST /accounting/payments/service
    • Paie/URSSAF: POST /accounting/payroll, POST /accounting/payments/urssaf
    • Contributions: POST /accounting/contrib/micro-social, POST /accounting/contrib/c3s
  • Devis (hors-bilan): à l'envoi d'un devis, une écriture DRAFT est enregistrée dans OD (706/44571/411). En cas de rejet/expiration, une contre-passation est créée automatiquement.

About

Facturio - API de facturation pour SaaS (clients, devis, factures, TVA, declarations)

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors