Facil Framework

Generic deployable framework for digital services platforms. Gov · Enterprise · SaaS · Banking · Telco · HR · Real estate · E-commerce

Vision · Architecture · Profiles · Roadmap · Documentation · Contributing

---

 Statut : pré-bootstrap. L'environnement est préparé, le développement actif n'a pas encore démarré. Le lancement est conditionné au go-live de TaxasGE (le déploiement de référence) + recrutement équipe + vérification trademark Facil.

Facil Framework est un framework générique de plateformes de services digitaux, déployable sur n'importe quel cloud ou en local, customisable sans code par des utilisateurs non-techniques via un Customization Studio dédié.

---

Table des matières

1. Vision
2. Origine
3. Modèle économique
4. Architecture
5. Profiles
6. Quick start
7. Documentation
8. Roadmap
9. Pré-requis avant lancement
10. Contribuer
11. License

---

Vision

Principe	Implementation
Modulaire au boot	Tous les modules backend inclus, activables via MODULES_ENABLED (Phase A.5)
5 profiles pré-faits	Pack install.yaml + seeds + workflows + branding par cible métier
Studio sans code	UI admin pour branding, langues, RBAC, taxonomies, catalogue, workflows, providers, documents, signature, KB
Cloud-privé / on-prem par défaut	Ollama + Postgres+pgvector + MinIO. Zéro dépendance Cloud externe requise
Provider-agnostic	LLM, Storage, Payment, Auth, Embedding, Signature : tous abstractions ABC pluggables
18 améliorations vs TaxasGE	Voir docs/IMPROVEMENTS_OVER_TAXASGE.md

Origine

Cloné en snapshot du déploiement concret TaxasGE (Guinée Équatoriale gov digital services, repo séparé) en date du 2026-05-10.

• Aucun lien Git, ni submodule, ni symlink avec TaxasGE
• Repos évoluent indépendamment
• Diffusion d'améliorations infrastructure : cherry-pick manuel via tools/sync-from-taxasge.sh (Phase A.5)

Modèle économique (Open Core)

Tier	License	Hosting	Status
Facil Framework (ce repo)	AGPL-3.0	Self-hosted	Planned
Facil Cloud (facil.io)	Hosted SaaS	Managé	Future
Facil Enterprise	Commercial	Managé / on-prem	Future

Pourquoi AGPL-3.0 et pas MIT : empêche le fork hostile cloud (cf. Elastic vs OpenSearch / AWS). Tout SaaS hébergeur de modifications doit ouvrir son code source aussi.

Architecture

┌─────────────────────────────────────────────────────────────┐
│                    Customization Studio (UI)                │
│   Branding · Langues · RBAC · Taxonomies · Catalog ·        │
│   Workflow Designer · Providers · Documents · Signature ·   │
│   Knowledge Base · Modules                                  │
└──────────────────────────┬──────────────────────────────────┘
                           │
┌──────────────────────────▼──────────────────────────────────┐
│             Module Loader (Phase A.5 — clé de voûte)        │
│              MODULES_ENABLED → conditional load             │
└──────────────────────────┬──────────────────────────────────┘
                           │
       ┌───────────────────┼───────────────────┐
       │                   │                   │
   ┌───▼────┐        ┌─────▼─────┐       ┌────▼────┐
   │Backend │        │ Frontend  │       │ Mobile  │
   │FastAPI │        │ Next.js   │       │  Expo   │
   └───┬────┘        └─────┬─────┘       └────┬────┘
       │                   │                   │
       └─────────┬─────────┴────────┬──────────┘
                 │                  │
   ┌─────────────▼─────────┐  ┌─────▼──────────────┐
   │  Provider Abstractions │  │  Profile templates │
   │  LLM · Storage · Auth  │  │   gov / private /  │
   │  Payment · Signature   │  │  saas / banking /  │
   │   · Embedding/RAG      │  │       empty        │
   └────────────────────────┘  └────────────────────┘
                 │
   ┌─────────────▼─────────────────────────────────────┐
   │  Postgres + pgvector  ·  Redis  ·  Ollama  ·      │
   │  MinIO / S3 / Firebase  ·  Cloud LLM (optional)   │
   └────────────────────────────────────────────────────┘

Voir docs/BPMN.md pour les diagrammes de processus détaillés (déploiement, customization, workflow execution, module activation, migration, designer).

Profiles

Légende : ● en place · ◐ en cours · ○ planifié

Profile	Use case	Modules typiques	Status
empty	Démarrage from scratch	rbac · communications · audit_logs · dashboards	○
private-services-company	Plateforme B2B services (cible MVP)	+ treasury · service_requests · chatbot · documents · verified_identifiers	○
gov-emergent-country	Services gov digitaux (port TaxasGE)	+ declarations · bange_payment · permis · IVA	○
saas-multitenant	SaaS multi-tenant	+ tenant_management · billing · onboarding	○
banking	KYC + lending	+ kyc · loan_application · compliance	○

1 déploiement = 1 profile actif. Profile changeable post-installation via Studio (avec migration).

Quick start (futur)

 Pas encore exécutable — Phase A.5 (Module Loader) doit être implémentée d'abord. Voir ROADMAP.md.

# 1. Clone (quand le repo deviendra public)
git clone https://github.com/KouemouSah/facil-framework.git
cd facil-framework

# 2. Choisir un profile et déployer en local
cd deploy
python init.py --profile=private-services-company --non-interactive
docker compose up

# 3. Ouvrir le Studio
open http://localhost:3000/admin/studio

Voir CONTRIBUTING.md pour le setup de développement complet.

Documentation

Public (committé)

Document	Audience	Contenu
PRD	Product / stakeholders	Product Requirements Document complet (12 sections)
BPMN	Devs / architects	6 diagrammes de processus Mermaid
REUSE_FROM_TAXASGE	Devs	Inventaire 60% reused / 25% adapted / 15% new
IMPROVEMENTS_OVER_TAXASGE	Tech leaders	18 pain points TaxasGE résolus par Voie B
AGENTS_AND_SECRETS	Maintainers	AI agents, secrets, costs, model alternatives
ROADMAP	Public	Phases A → N.5, effort, statut
CHANGELOG	Tous	Notable changes per release
CONTRIBUTING	Contributors	Branching, conventional commits, dev setup
SECURITY	Security researchers	Disclosure policy + scope
CODE_OF_CONDUCT	Tous	Contributor Covenant 2.1

Interne (gitignored)

Plans détaillés au format task-decomposition-expert : .claude/plans/phases/PHASE_*.md × 19 phases. Format : Executive Summary · Goal Analysis · WBS 3 niveaux 8/80 · Dependency Graph · Parallelism Map · Risk Register · Validation Checkpoints · Agent Handoff Plan.

Roadmap

Voir ROADMAP.md pour le détail.

Total : 144-209 jours de dev focalisé (~7-10 mois 1 FTE ou 4-6 mois 2 devs).

Track	Phases	Effort cumulé
Foundations	A.5 · B · B.5 · B.6 · C	49-71j
Profiles + Studio	D · E · F · G · H · H.5 · I · I.bis	47-67j
Auth + Apps	J · K	12-17j
Documents	N · N.5	21-31j
Tests + Docs	L · M	14-20j

Phase critique R&D : H Workflow Designer (15-25j drag-drop ReactFlow). Phase la plus longue : B.6 Embedding/RAG Abstraction (32-45j).

Pré-requis avant lancement actif

Légende : ● en place · ◐ en cours · ○ pending

#	Pré-requis	Status
1	TaxasGE prod stable 1+ mois	○
2	Trademark "Facil" vérifié (USPTO / EUIPO / OAPI)	○
3	Équipe : 1 FTE 8 mois OU 2 devs 4-5 mois	○
4	Domaine facil.io acquis	○
5	Setup business (société, infra cloud)	○
6	Décisions stratégiques validées (PRD §11)	○

Contribuer

Le repo est en mode privé pendant la phase pré-bootstrap. Les contributions externes ouvriront avec la Phase A.5.

En attendant :

• Star pour notifications de release
• Discussions pour idées et questions
• Issues pour bugs et feature requests
• SECURITY.md pour vulnérabilités

Voir CONTRIBUTING.md pour le guide complet (branching, conventional commits, dev setup).

License

GNU AGPL-3.0 (Affero GPL).

Tout SaaS hébergeur de modifications doit publier son code source sous AGPL également.

Pour un usage commercial sans contrainte AGPL, voir le tier Facil Enterprise (futur, contact : kouemou.sah@gmail.com).

---

_{Made with care · 2026 · kouemou.sah@gmail.com}

_{Roadmap · Discussions · Issues · Security}