Wiki/docmost/setup

Docmost setup — Iteration 3 BUILD

Configuration manuelle de Docmost (10 min). Couvre stories S-01 (workspace + spaces), S-07 (share link), S-08 (space etudiant pattern).

API publique vs internals : l'API REST officielle Docmost (documentee, stable, supportee) est Enterprise payante (docs). Mais les endpoints internes que la SPA React utilise sont accessibles dans la Community Edition AGPL.

Deux options :

• A. Setup manuel UI (cf sections 1-5 de ce README) — recommande pour first-time / one-shot
• B. Seed automatise via endpoints internes — make seed-docmost (cf seed.py)

L'option B est utile pour l'idempotence (re-run apres bump Docmost) et pour l'integration future avec le bridge Phase 2 (cf doc 19).

1. Creer le compte admin (premier boot — 1 min)

1. Ouvrir http://localhost:3000
2. Page d'accueil → "Create your account"
3. Renseigner :
   • Workspace name : Acadenice
   • Your name : Corentin JOGUET
   • Email : corentin@acadenice.fr
   • Password : robuste (sauve dans pass/vault)
4. Submit → tu arrives dans Docmost avec workspace Acadenice

2. Creer les 3 spaces (3 min)

Mapping miroir des collections Outline (cf doc 02 scope etendu).

Pour chaque space :

1. Sidebar gauche → "Create space" (icon +)
2. Renseigner les champs ci-dessous

Space 1 — CFA

Champ	Valeur
Name	CFA
Description	Centre de Formation des Apprentis — formations, blocs, modules, supports pedagogiques
Icon	(au choix, ex: school)
Visibility	Open to workspace members (default)

Space 2 — Agence

Champ	Valeur
Name	Agence
Description	Agence de developpement — projets clients, livraisons, doc technique
Icon	(au choix, ex: code)
Visibility	Open to workspace members

Space 3 — Interne

Champ	Valeur
Name	Interne
Description	Operations internes — vision, RH, communication, batiment, evenements
Icon	(au choix, ex: building)
Visibility	Open to workspace members

3. Creer une page test "Welcome" + Share link (3 min)

Pour valider stories S-07 (share link client guest).

1. Aller dans space CFA
2. "New page" → titre Welcome formation-hub
3. Coller dans le contenu :

# Welcome to formation-hub

## Stack

- **Docmost** : ce wiki (AGPL self-host)
- **Baserow** : DBs structurees (MIT self-host)
- **Bridge service** : a venir (Phase 2)

## Diagrammes natifs

### Mermaid

\`\`\`mermaid
flowchart LR
    User -->|push| Forgejo
    Forgejo -->|CI| Tests
    Tests -->|deploy| Staging
\`\`\`

### Drawio

(Insere un block drawio via slash menu `/drawio`)

### Excalidraw

(Insere un block excalidraw via slash menu `/excalidraw`)

4. Sauver
5. Boutton "Share" en haut a droite
6. Activer "Share to web" + configurer :
   • Password : optionnel (ex acadenice2026)
   • Expiration : 7 days
7. Copier le share link
8. Test : ouvrir le link en navigation privee → page lisible sans login

4. Pattern "space etudiant" (2 min — story S-08)

Pour onboarder un etudiant :

1. "Create space" → Etudiant - <Nom Prenom> (ex: Etudiant - Marie Dupont)
2. Description : Space personnel - libre usage
3. Visibility : Private
4. Apres creation : Settings space → Permissions → Invite member
5. Renseigner l'email de l'etudiant + role Editor
6. L'etudiant recoit invite mail + acces uniquement a son space

Automation possible Phase 2 : le bridge service pourra creer ce pattern via des appels qui mimick l'UI (en reverse-engineer des appels prives, ou en attendant que l'API publique passe en open dans une version future Community).

5. Tester les diagrammes natifs (1 min)

Sur la page Welcome :

• Ajoute un block Mermaid via /mermaid
• Ajoute un block Drawio via /drawio → editor s'ouvre
• Ajoute un block Excalidraw via /excalidraw → canvas s'ouvre

Si les 3 fonctionnent : Phase 1 Docmost est valide.

Configuration recommandee additionnelle

Workspace settings

• Settings → Workspace → Allow member workspace creation : OFF (admin only)
• Settings → Security → Two-factor auth : encourager (pas obligatoire Phase 1)

User settings (Corentin perso)

• Settings → Profile → photo + bio
• Settings → Preferences → langue francais si dispo
• Settings → API keys : skip (Enterprise)

Checklist iteration 3 BUILD

• Compte admin Docmost cree
• Workspace Acadenice operationnel
• 3 spaces crees (CFA, Agence, Interne) avec descriptions + icons
• 1 page test Welcome formation-hub dans CFA avec Mermaid block
• Share link genere + teste en navigation privee
• Pattern space etudiant teste (1 space test fictif puis supprime)
• Diagrammes natifs Mermaid + Drawio + Excalidraw verifies fonctionnels

Une fois tous coches : iteration 3 done, on passe a iteration 4 (forms publics Baserow).

Schema declaratif (pour reference future)

docmost/setup/spaces.yaml decrit la structure cible. Si l'API Community Docmost s'ouvre dans une version future (issue #346 suit ce sujet), ce YAML pourra etre consomme par un script seed.