Seed — référence

​

Source des données

​

Options de run

​

Cibles et identité

​

Architecture

apps/api/src/seed/
  catalogue/     le métier en données : installations, règles, anomalies, prestataires, archétypes
  blueprint/     le contrat typé Blueprint + sa validation
  generator/     archétype × taille × seed → Blueprint
  engine/        rejoue un Blueprint à travers le domaine, phase par phase
  invariants/    contrôles de cohérence sur toute organisation seedée
  demo/<nom>/    blueprints écrits à la main + leurs PDF
  factories/     defineFactory par modèle, aussi utilisé par les fixtures de tests de routes
  account/       provisioning d'une connexion RS et d'un admin backoffice
  orchestration/ clear d'un tenant, manifeste des modèles, upload des assets

​

Maintenance

• Les tests de routes API utilisent les fixtures rsFixture, boFixture, adFixture, prFixture — pas le seeder.
• Nouvelle valeur d’enum visible : la classer dans invariants/checks/coverage.ts. Une valeur qu’aucun chemin d’écriture ne produit va dans la liste UNREACHABLE, avec le commentaire qui dit pourquoi.
• Nouveau modèle Prisma scopé organisation : l’ajouter au manifeste de clear (orchestration/tenant-models.ts), sinon son test unitaire échoue. S’il porte un createdAt historique, l’ajouter aussi à engine/backdate.ts et enregistrer ses lignes via ctx.state.record.
• Nouveau cas métier : un type d’événement dans blueprint/types.ts, son contrôle dans blueprint/validate.ts, son handler dans engine/events/, et son émission dans generator/timeline.ts. Ne pas écrire un statut ou une échéance à la main : appeler la policy du domaine.
• Nouvelle règle métier ou installation : le catalogue (catalogue/rules.ts, catalogue/installations.ts) est la seule source ; le générateur n’invente aucun libellé.
• Nouvel archétype : une entrée dans catalogue/archetypes.ts suffit, plus son ajout aux choix du workflow.

​

Comportements du domaine tolérés

• une règle à workflow calendrier n’avance pas son échéance après une visite en retard ;
• les formations ne portent pas de verifiedAt, elles sont validées par leurs preuves de présence ;
• une règle de session ne produit une échéance que par le seuil de capacité du site.