Initial vault setup

2026-06-09 18:40:21 +02:00
commit bda02d587f
3692 changed files with 402457 additions and 0 deletions
@@ -0,0 +1,162 @@
+---
+title: Bigcapital
+created: 2026-06-07
+updated: 2026-06-07
+type: app
+tags: [catalogue, accounting, bigcapital, double-entry, inventory, invoicing, typescript, docker]
+confidence: high
+contested: false
+sources:
+  - https://selfh.st/apps/?tag=accounting
+  - https://github.com/bigcapitalhq/bigcapital
+  - https://bigcapital.app/
+---
+
+# 💵 Bigcapital
+
+> Comptabilité intelligente et open-source pour PME, alternative moderne à **QuickBooks, Xero et Wave**, avec inventaire, facturation et rapports financiers automatisés.
+
+| Métadonnée | Valeur |
+| :--- | :--- |
+| **Site web** | https://bigcapital.app/ |
+| **GitHub** | https://github.com/bigcapitalhq/bigcapital |
+| **License** | AGPL-3.0 |
+| **Langage** | TypeScript (97.2%) |
+| **Étoiles** | ⭐ 3 700 (≈450 sur selfh.st) |
+| **Dernière MAJ** | 2026-05-31 |
+| **Catégorie** | [[cat-accounting]] |
+
+## 📝 Description
+
+**Bigcapital** est une plateforme de comptabilité et de gestion d'inventaire **tout-en-un** pensée pour les **petites et moyennes entreprises** qui veulent reprendre le contrôle de leurs finances sans dépendre d'un SaaS étranger. Le projet, démarré en 2021 par Ahmed Bouhuolia, s'appuie sur une stack moderne (TypeScript/Node.js, Vite, PostgreSQL) et un monorepo Lerna/pnpm qui sépare clairement le front, l'API et le SDK TypeScript généré automatiquement depuis OpenAPI.
+
+Le cœur fonctionnel repose sur la **comptabilité en partie double** : chaque écriture est équilibrée (débit = crédit), les journaux sont générés automatiquement à partir des factures, paiements et dépenses, et les **états financiers** (bilan, compte de résultat, tableau des flux de trésorerie, balance générale) sont produits en temps réel. Bigcapital ajoute nativement la **gestion d'inventaire** (articles, entrepôts, mouvements de stock, valorisation FIFO/pondérée) et la **facturation** (devis, factures récurrentes, multi-devises), ce qui le distingue des pure-player de la facturation comme [[app-invoiceshelf]] ou [[app-crater]].
+
+Côté UX, l'interface est une SPA réactive (Vite + React) avec dashboard de trésorerie, drill-down sur les transactions, et **rapports imprimables**. L'**intégration Plaid** (banques US/CA) et le **scanning OCR de reçus** sont prévus ou déjà en bêta. Un **API REST documentée OpenAPI** et un **SDK TypeScript** permettent l'intégration headless (« headless accounting ») avec d'autres outils (CRM, e-commerce). Un **serveur MCP** est en cours de stabilisation pour piloter la comptabilité depuis un agent IA.
+
+Cas d'usage typique : « Je suis une PME de 5-20 personnes, je veux remplacer QuickBooks par une solution que j'héberge moi-même, qui gère mes factures, mes dépenses, mon stock et produise mes bilans en un clic ».
+
+## 🚀 Installation
+
+### Option 1 : Docker Compose (recommandé)
+
+```yaml
+# docker-compose.yml
+version: "3.8"
+
+services:
+  server:
+    image: ghcr.io/bigcapitalhq/server:latest
+    container_name: bigcapital-server
+    restart: unless-stopped
+    environment:
+      APP_ENV: production
+      APP_KEY: ${APP_KEY:-changez-moi-32-caracteres-minimum}
+      APP_URL: https://bigcapital.example.com
+      DATABASE_URL: postgres://bigcapital:bigcapital@db:5432/bigcapital
+      JWT_SECRET: ${JWT_SECRET:-changez-moi-aussi-ici}
+      MAIL_HOST: smtp.example.com
+      MAIL_PORT: 587
+      MAIL_USERNAME: ${MAIL_USERNAME}
+      MAIL_PASSWORD: ${MAIL_PASSWORD}
+    depends_on:
+      db:
+        condition: service_healthy
+    networks: [bigcapital]
+
+  webapp:
+    image: ghcr.io/bigcapitalhq/webapp:latest
+    container_name: bigcapital-webapp
+    restart: unless-stopped
+    environment:
+      VITE_API_URL: https://bigcapital.example.com/api
+    depends_on:
+      - server
+    networks: [bigcapital]
+
+  db:
+    image: postgres:16-alpine
+    container_name: bigcapital-db
+    restart: unless-stopped
+    environment:
+      POSTGRES_DB: bigcapital
+      POSTGRES_USER: bigcapital
+      POSTGRES_PASSWORD: bigcapital
+    volumes:
+      - ./data/db:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U bigcapital -d bigcapital"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks: [bigcapital]
+
+networks:
+  bigcapital:
+    driver: bridge
+```
+
+Premier lancement : `docker compose up -d`, puis créer le compte admin via `https://bigcapital.example.com/setup` et suivre l'assistant de configuration (devise de base, plan comptable, premier entrepôt).
+
+### Option 2 : Installation manuelle (développement)
+
+Cloner le repo, installer Node 18.16.1 (`.nvmrc` présent), `pnpm install` au root, puis dans `packages/server` lancer les migrations Prisma et démarrer l'API. Le front se lance avec `pnpm dev` dans `packages/webapp`. Voir [CONTRIBUTING.md](https://github.com/bigcapitalhq/bigcapital/blob/develop/CONTRIBUTING.md).
+
+## ⚙️ Configuration
+
+- **Plan comptable** : import d'un chart of accounts au démarrage (templates US GAAP, UK GAAP, FR PCG fournis par la communauté).
+- **Multi-devise** : taux de change manuels ou importés depuis une source (openexchangerates, ECB).
+- **Plaid** : intégration bancaire US/CA via OAuth, catégorisation automatique des transactions.
+- **Stock** : valorisation moyenne pondérée ou FIFO, alertes de réassort, emplacements multiples.
+- **Factures récurrentes** : planification cron-like, génération PDF branded.
+- **Permissions** : RBAC fin (admin, comptable, vendeur, lecture seule) basé sur JWT.
+- **API/SDK** : OpenAPI exporté à chaque release, SDK TypeScript dans `packages/sdk` consommable depuis n'importe quel front.
+
+## 🔄 Alternatives
+
+### Open Source
+- [[app-invoiceshelf]] — Facturation PHP/Laravel, plus simple mais pas de comptabilité double.
+- [[app-crater]] — Fork possible, facturation + dépenses uniquement.
+- [[app-akaunting]] — Comptabilité PHP mature, plus large mais moins moderne.
+- [[app-solidinvoice]] — PHP/Symfony, facturation pour freelances.
+- **ERPNext** — ERP complet (compta incluse) en Python/Frappe, beaucoup plus lourd.
+- **Odoo Community** — Modules comptables riches mais usine à gaz.
+
+### Propriétaires (ce que cette app remplace)
+- **QuickBooks Online** — Leader SMB, ~$30-80/mois, fermé.
+- **Xero** — Concurrent direct, UK/AU, fermé.
+- **Wave Accounting** — Freemium, fermé depuis l'acquisition par H&R Block.
+- **FreshBooks** — Orienté freelances, fermé.
+- **Sage Business Cloud** — Legacy SMB, fermé.
+
+## 🔒 Sécurité
+
+- **HTTPS obligatoire** : reverse proxy [[app-traefik]] ou [[app-caddy]] avec certificats Let's Encrypt.
+- **JWT_SECRET** et **APP_KEY** : 32+ caractères aléatoires, stockés dans un fichier `.env` jamais commité ou mieux dans un secret manager.
+- **Base de données** : `pg_dump` quotidien vers un volume chiffré (cf. recettes [[app-postgres-backup]]).
+- **Mises à jour** : suivre les releases (~1 par mois), images Docker `latest` et tags pinnés.
+- **RBAC** : ne jamais donner le rôle `admin` au quotidien, créer des comptes comptables/read-only.
+- **Plaid** : tokens stockés chiffrés côté serveur, rotation régulière.
+- **Logs** : `APP_LOG_LEVEL=info` en prod, audit log consultable dans l'UI.
+
+## 📚 Ressources
+
+- Site officiel : https://bigcapital.app/
+- Documentation : https://docs.bigcapital.app/
+- Déploiement Docker : https://docs.bigcapital.app/deployment/docker
+- API Reference : https://docs.bigcapital.app/api-reference
+- Repository : https://github.com/bigcapitalhq/bigcapital
+- Discord : https://discord.com/invite/c8nPBJafeb
+- Postman : https://www.postman.com/bigcapital/workspace/bigcapital-api
+- Docker Hub : https://hub.docker.com/u/bigcapitalhq
+
+## 🔗 Pages Liées
+
+- [[cat-accounting]] — Catégorie parente
+- [[app-invoiceshelf]] — Facturation concurrente (PHP/Laravel)
+- [[app-crater]] — Facturation + dépenses open source
+- [[app-akaunting]] — Comptabilité PHP mature
+- [[app-solidinvoice]] — Facturation PHP/Symfony
+- [[app-traefik]] — Reverse proxy HTTPS
+- [[recettes-docker-compose]] — Templates Docker
+- [[securisation-home-lab]] — Bonnes pratiques