Skip to content

README_FACTORY.md

Latest commit

 

History

History
107 lines (90 loc) · 5.28 KB

README_FACTORY.md

File metadata and controls

107 lines (90 loc) · 5.28 KB
Raw

README_FACTORY.md — App / SaaS Factory

Cette factory transforme une idée, une URL, ou un repo Python métier en SaaS déployable, sécurisé, mesurable et opérationnellement piloté.

Ce que la factory fait

Idée / URL / Screenshot
        │
        ▼
[reference-site-analyzer]  ← cleanroom : pas de copie
        │
        ▼
[feature-generation]       ← feature blueprint
        │
        ▼
[modules-registry]         ← composants réutilisables
        │
        ▼
[backend-packs]            ← backend prévalidé (jamais freestyle)
        │
        ▼
Une app déployée
        │
        ├─ ops-packs           (monitoring, backups)
        ├─ ops-autopilot       (fallback, quotas, incidents)
        ├─ automation-packs    (n8n)
        ├─ factory-control-center (cockpit multi-sites)
        ├─ finance-ledger      (P&L par site)
        ├─ growth-data-layer   (collecte + consentement + datasets vendables)
        ├─ ai-privacy-gateway  (anonymisation avant IA)
        └─ security-packs      (scans à chaque PR)

Les 18 briques

Dossier Rôle Statut MVP
repo-factory-shell/ CLI : audit, normalize, connect, scan MVP exécutable
reference-site-analyzer/ URL/screenshot → feature spec en cleanroom Cleanroom prompts + CLI site:analyze MVP
feature-generation/ Idée → blueprint UI/API/worker/sécurité/tests CLI feature:generate MVP + contrats
modules-registry/ Composants/modules versionnés réutilisables MVP contrats de modules
backend-packs/ Backend patterns prévalidés (Supabase, Trigger.dev, BullMQ, FastAPI, NestJS) MVP pack registry
security-packs/ Scans Semgrep/Gitleaks/OSV/Trivy/CodeQL/ZAP MVP exécutable
ai-privacy-gateway/ Presidio : anonymise/pseudonymise avant LLM MVP exécutable, Redis chiffré requis en prod
growth-data-layer/ Collecte, consentement, identity, datasets vendables MVP fait : schémas SQL + politiques
ops-packs/ Coolify, Uptime Kuma, Sentry, Renovate, Restic MVP policies/config examples
ops-autopilot/ Fallback, quotas, modes site, blocage exports MVP action policy
automation-packs/ Workflows n8n versionnés MVP workflows/policies
factory-control-center/ Dashboard P&L + incidents + sécurité multi-sites MVP exécutable : APIs admin + schema
finance-ledger/ Revenus, coûts, P&L par site_id MVP fait : schémas + policies
agent-quality-system/ Skills, router, hooks, approval policy pour Claude/Codex MVP fait : règles + approval policy
context-engine/ Graphify : éviter token-burn MVP policies/context packets
dev-orchestrator/ Tâches IA bornées async MVP detectors/routing contracts
docs/ Doctrine (architecture, sécurité, design, ops) MVP doctrine
legal/ Cleanroom, licences, data-selling MVP fait

La règle absolue : la chaîne data

collecte
  → consentement enregistré (consent_ledger)
  → identification du contact (identity-resolution)
  → enrichissement contrôlé
  → sellable_status calculé
  → export bloqué si sellable_status != eligible

  Aucune donnée client brute ne sort jamais du système si :
    - opt_out = true
    - consent_partners = false
    - sellable_status != eligible
    - retention_expires_at dépassé
    - buyer usage non autorisé

Voir growth-data-layer/data-products/ et legal/data-selling-policy.md.

Lien avec les templates existants

Le repo contient :

  • micro-saas-template-v2/ — template SaaS Next.js + Supabase + Stripe (Shell + Run adapter pattern). Voir micro-saas-template-v2/INTEGRATION_NOTES.md pour son rôle dans la factory.
  • D'autres templates futurs viendront en frères (docs-saas-template/, etc.).

La factory encadre les templates. Les templates utilisent les briques factory (backend-packs, security-packs, modules-registry). La factory ne remplace aucun template.

Ordre de construction (7 phases)

Voir docs/factory/00-overview.md pour le détail. En résumé :

  1. Phase 1 — Foundation : repo-factory-shell + tools/scanners + AGENT_RULES.md + QUALITY_GATES.md + 1 backend-pack + security MVP
  2. Phase 2 — App generation : reference-site-analyzer + feature-generation + modules-registry + design system
  3. Phase 3 — Agents/contexte : agent-quality-system + context-engine + dev-orchestrator + approval-policy
  4. Phase 4 — Ops multi-sites : ops-packs + factory-control-center + ops-autopilot
  5. Phase 5 — Automation : automation-packs/n8n
  6. Phase 6 — Data & monétisation : growth-data-layer complet + identity-resolution + sellable marts + delivery log
  7. Phase 7 — Gouvernance : ADR decisions + restore tests + module versioning + AI output scorecard

Lis ces fichiers en premier

  1. README_FACTORY.md (tu y es)
  2. AGENT_RULES.md — doctrine globale agents (Claude/Codex)
  3. QUALITY_GATES.md — checks PR obligatoires
  4. RUN_SCHEMA.md — contrat universel input/output engine
  5. legal/data-selling-policy.md — règle data vendable
  6. legal/cleanroom-policy.md — règle anti-copie
  7. agent-quality-system/policies/approval-policy.yml — ce qui est auto vs ce qui demande validation