# Module Platform — socle transverse

> **Zone : fonctionnel évergreen** (le **quoi**, vue utilisateur / chef de projet). Le **comment**
> (archi, code) vit dans [`.claude/technical-docs/platform/`](../../.claude/technical-docs/platform/README.md).
> Règles du système documentaire : [`_conventions.md`](../../.claude/technical-docs/_conventions.md).

`platform` regroupe les **capacités partagées par tous les métiers** (CRM, tickets, projets, GMAO…)
sans domaine propre : métadonnées & feature-flags, historisation, export/import, et le socle
d'administration.

> Les capacités qui avaient leur propre cohérence ont été extraites en modules dédiés :
> [`search`](../search/README.md), [`identity`](../identity/README.md),
> [`integrations`](../integrations/README.md), [`comms`](../comms/README.md),
> [`wiki`](../wiki/README.md).

---

## Par où commencer, selon le besoin

| Ton besoin | Thème à ouvrir |
|------------|----------------|
| « C'est quoi les champs / entités de référence, comment sort une nouveauté ? » | [Métadonnées & feature-flags](#métadonnées--feature-flags) |
| « Que trace-t-on sur une fiche ? » | [Historisation](#historisation) |
| « Comment sortir / réinjecter des données en masse ? » | [Export / Import](#export--import) |
| « Où se paramètre la plateforme ? » | [Administration & socle](#administration--socle) |

---

## Métadonnées & feature-flags

Le référentiel de structure de l'application et le déploiement progressif des nouveautés.

- **Point d'entrée** : [`isi-metadata.md`](isi-metadata.md) — les métadonnées ISI (parties, champs,
  entités de référence).
- [`feature-flags.md`](feature-flags.md) — activation progressive des fonctionnalités (dev / alpha /
  beta) et à qui elles sont visibles.
- [`module-management-rules.md`](module-management-rules.md) — engagements et modules d'abonnement
  du client (ce qui est activé commercialement, côté tenant).

## Historisation

Ce qui est tracé et consultable sur les fiches.

- **Point d'entrée** : [`history-logging.md`](history-logging.md) — le journal d'activité des fiches
  (qui a modifié quoi, quand).

## Export / Import

Sortie et réinjection de données en masse.

- **Point d'entrée** : [`export-import.md`](export-import.md) — le module d'export/import de données.
- [`export-import-field-custom.md`](export-import-field-custom.md) — prise en compte des champs
  personnalisés par client dans les exports/imports.

## Administration & socle

Écrans de pilotage de la plateforme et briques transverses des fiches.

- **Point d'entrée** : [`admin-dashboard.md`](admin-dashboard.md) — le tableau de bord d'administration.
- Référentiels : [`application.md`](application.md) (applications).
- Fiches : [`sidebar-ctl.md`](sidebar-ctl.md) (panneau latéral).
- Annuaires : [`onyx-avatar.md`](onyx-avatar.md) — avatars à initiales et couleur automatique des
  entités, adresses et personnes.
- Adresses : [`addresses.md`](addresses.md) (annuaire des sites, transverse) — inclut la vCard
  par adresse.
- Navigation : [`arbo-import.md`](arbo-import.md) (import d'un menu portail / d'une arborescence
  de documentation d'une plateforme cliente vers une autre).
- Divers socle : [`cgv-signature.md`](cgv-signature.md) (signature des CGV),
  [`dsi-param-messages.md`](dsi-param-messages.md) (messages automatiques paramétrables — Param SI).
- [`archive.md`](archive.md) — archivage des données. ⚠️ **`deprecated`** : ne pas s'appuyer dessus
  pour du neuf.

---

## Trouver une doc sans naviguer

```bash
rg -l "^module: platform" docs/platform/      # toutes les docs fonctionnelles du module
rg -l "^status: deprecated" docs/platform/    # ce qui est périmé
```