# Documentation fonctionnelle — ISI-App

> **Zone : fonctionnel évergreen.** Ce dossier décrit **ce que font** les features (vue utilisateur /
> chef de projet), maintenu pour refléter l'état courant. Le **comment** (technique) vit dans
> `.claude/technical-docs/`. Les décisions/audits/specs datés vivent dans `.claude/records/`.
>
> 📐 Règles complètes : [`.claude/technical-docs/_conventions.md`](../.claude/technical-docs/_conventions.md)

## Les trois zones en un coup d'œil

| Zone | Où | Nature |
|------|----|--------|
| Fonctionnel évergreen | `docs/<module>/` | Le **quoi** (ici) |
| Technique évergreen | `.claude/technical-docs/<module>/` | Le **comment** |
| Point-in-time | `.claude/records/` | Décisions (ADR), audits, revues, specs — datés, jamais réécrits |

## Carte des modules

Chaque module est un dossier `docs/<module>/`. Les modules denses ont leur propre README-carte ;
sinon, ouvre le dossier, le frontmatter de chaque doc te renseigne.

| Module | Périmètre fonctionnel | Carte |
|--------|----------------------|-------|
| **ai** | Assistance IA, tool-calling, auto-remplissage, connecteurs IA | [`ai/`](ai/README.md) |
| **crm** | Clients, contacts, affaires, missions, charges, planning, contrats | [`crm/`](crm/README.md) |
| **tickets** | Support, création par mail, sujets, pilotage | [`tickets/`](tickets/README.md) |
| **store** | Connecteurs d'inventaire (OCS, Intune, GLPI), hardware | [`store/`](store/README.md) |
| **isi-nova** | Form-builder, restitutions, composants Nova | [`isi-nova/`](isi-nova/README.md) |
| **search** | Recherche globale (Ctrl+K), recherche avancée | [`search/`](search/README.md) |
| **identity** | Utilisateurs (personnes, IAM) & droits d'accès fins | [`identity/`](identity/README.md) |
| **integrations** | Connecteurs externes O365/Azure/Youzer (≠ inventaire) | [`integrations/`](integrations/README.md) |
| **comms** | Notifications & messagerie interne | [`comms/`](comms/README.md) |
| **wiki** | Wiki, livrets & éditeur riche | [`wiki/`](wiki/README.md) |
| **platform** | Socle transverse restant : métadonnées, feature-flags, logs, export/import, admin | [`platform/`](platform/README.md) |
| **sante** | FINESS, RPPS, données santé | `sante/` |
| **gmao** | Équipements, bâtiments | `gmao/` |
| **projects** | Projets, réunions, tâches | `projects/` |
| **form** | Generic-form, champs custom | `form/` |
| **demo** | Comptes & instances de démo | `demo/` |
| **widget** | Catalogue & manager de widgets | `widget/` |
| **dev** | Méta-process : tests, conventions, UI, release-notes | `dev/` |

## Trouver une doc sans naviguer

```bash
rg -l "^module: crm" docs/              # toutes les docs fonctionnelles CRM
rg -l "^status: deprecated" docs/       # ce qui est périmé
rg -l "^type: functional" docs/         # (redondant ici : tout docs/ est fonctionnel)
```

## Ajouter une doc

Copie [`_templates/functional.md`](_templates/functional.md), remplis le frontmatter, place le
fichier dans `docs/<module>/`. Voir la checklist dans les [conventions](../.claude/technical-docs/_conventions.md).