# ADR-008 — Création de dossiers de documents (pas de documents directs)

Date : 2026-05-22
Statut : Accepté
Fiche source : registry/T5-edit-cta-roles/DEC-CTA-002-document-folder-creation.md

## Contexte

Les documents sont générés/uploadés indirectement (pipeline AIR, exports…),
pas créés manuellement. En revanche, créer un **dossier** de documents doit
être possible — ce CTA manquait.

## Décision

| Action | Module | Rôles |
|---|---|---|
| `create` | `documentfolders` | admin, agency, support, sale |
| `create` | `documents` | ❌ aucun (désactivé) |
| `update` | `documents` | admin, support |
| `delete` | `documents` | admin |

## Conséquences

- **CHAPS** (chaps-api `bab333a`) : seeder idempotent `DocumentFolderCtaSeeder`
  (exécuté APRÈS StandardCtasSeeder) — CTA create sur `documentfolders`
  (roles admin/agency/support/sale), `documents`.create désactivé (`is_active=0`,
  non supprimé, réversible), update/delete documents restreints.
- **Frontend** (frontend `b5ad3fb`) : `CreateFolderDialog.vue` + mécanisme
  `SPECIAL_CREATE_DIALOGS` dans le pivot — le bouton « Créer » du module
  `documentfolders` ouvre ce dialog dédié au lieu du panneau create générique.
  POST `/v1/admin/documentfolders`.

## Notes / dette

- La garde d'autorisation réelle (backend) sur la création documentfolders
  reste à confirmer côté estair-api (le CTA ne contrôle que l'affichage UI).
- Le champ `parent_id` doit être accepté par l'API documentfolders (à valider).

## Références

> Ange : « créer un document non, mais créer un dossier de documents oui, ce CTA manque »