archicratie-edition/docs/QUICKSTART.md

Quickstart — 10 minutes (Proposer → Ticket → Apply → Tests)

1) Pré-requis

• Node.js + npm
• Accès Gitea (compte) + PAT si usage API (apply-ticket)

2) Lancer le site

en bash : npm install npm run dev

Dans le navigateur, url : http://localhost:4321

3) Proposer une correction

Ouvre une page (ex: Prologue).

Sur un paragraphe : clique Proposer.

Choisis :

Type : Correction / Fact-check

Category (optionnel)

Un nouvel onglet Gitea s’ouvre sur une issue pré-remplie.

Rédige :

Proposition (remplacer par):

Justification:

4) Appliquer le ticket en local ( = numéro du ticket non pas id-paragraphe)

En bash :

dry-run (recommandé)

node scripts/apply-ticket.mjs --dry-run

appliquer

node scripts/apply-ticket.mjs git diff git add git commit -m "edit: apply ticket # (...)"

5) Vérifier avant push

npm test

6) Règle d’or

Ne jamais éditer dist/ à la main.

Toujours garder Chemin + Ancre + Proposition dans le ticket.

Déplacer/ajouter les deux docs que je t’ai donnés

• docs/MANUEL_REFERENCE.md
• docs/CONTRAT_TICKETS.md

(Tu peux reprendre mes versions telles quelles.)

---

Commandes terminal P0 (copier-coller)

En bash mkdir -p docs

crée/édite les fichiers avec ton éditeur habituel

README.md

docs/QUICKSTART.md

docs/MANUEL_REFERENCE.md

docs/CONTRAT_TICKETS.md

git status -sb npm test git add docs/QUICKSTART.md docs/MANUEL_REFERENCE.md docs/CONTRAT_TICKETS.md git commit -m "docs: add quickstart + reference manual + ticket contract" git push