Opérer la plateforme

Voici la documentation opérateur : ce dont un admin plateforme a besoin pour faire tourner BoostEcom. Elle vit ici, dans des pages protégées, et l'app en sert encore sa copie sur /admin/docs, derrière requireAdmin(), sans jamais la publier.

Le corpus public (onglets Tools et Centre d'aide de ce site) répond à une autre question : comment un client utilise le produit.

La règle qui décide où va une page

Demandez-vous qui est lésé si la page est fausse.

• Un client agit à tort en s'y fiant → onglets publics Tools et Centre d'aide.
• Un opérateur agit à tort en s'y fiant → ici, page protégée.

C'est tout le test. Une page sur les crédits a sa place dans la documentation publique, parce qu'un marchand établit son budget à partir d'elle. Une page sur la façon d'accorder des crédits à une org depuis le panel admin a sa place ici, parce que seul un opérateur peut le faire, et qu'une erreur écrit dans le ledger une ligne que personne n'a demandée.

Pourquoi un dossier protégé et pas un drapeau

Un booléen comme internal: true sur un front-matter partagé n'est qu'à un défaut oublié de publier un runbook opérateur. Ici, une page est protégée par le nœud de navigation où elle vit (documentation.json), et scripts/audit-docs.mjs refuse qu'une page publique vive sous operations/ ou renvoie vers une page protégée.

src/test/docs-separation.test.ts prouve que le corpus n'atteint jamais le sitemap, llms.txt, le provider de recherche public ni l'outil MCP public.

Ce qui n'est PAS ici

L'architecture et les décisions ont leurs propres onglets protégés : ADR, audits, modèle des piliers, runbooks qui supposent un clone et un terminal. Ils sont écrits pour qui modifie le code.

Ce corpus s'adresse à qui fait tourner la plateforme depuis le panel admin. Si une page ne permet aucune action depuis /admin, elle a sans doute plutôt sa place dans les pages d'ingénierie.

Conventions

Une page par catégorie admin, alignée sur ADMIN_CATEGORIES dans src/config/admin-routes.ts : internal-docs-corpus.test.ts échoue quand une catégorie n'a pas de page. Les procédures transverses (une demande RGPD, un incident) ont leur propre page, sous une rubrique de procédure.

Les pages ne relistent pas les outils d'une catégorie, volontairement. Le rail dérive déjà cette liste de ADMIN_ROUTES, et une seconde copie en prose est une copie qui se périme. Documentez ce à QUOI servent les outils, et les pièges.