docs: add project root docs

This commit is contained in:
L'électron rare
2026-07-09 10:55:28 +02:00
parent 239ca3ea57
commit 5e197f0d6b
4 changed files with 117 additions and 0 deletions
+31
View File
@@ -0,0 +1,31 @@
# CLAUDE.md — projet BUS (Irisbus Axer → atelier mobile)
Workspace documentaire du chantier d'aménagement. **Pas un projet de
code** : l'essentiel est du markdown, plus un site Hugo (`blog/`) et des
schémas KiCad (`30-energie-elec/kicad/`).
## Conventions
- **Docs en français** (réglementaire FR, artisans, fournisseurs).
Commits en anglais, sujet ≤ 50 chars, pas d'attribution IA.
- Toute décision structurante → entrée datée dans `DECISIONS.md`.
- Tout ajout de masse significatif (> 5 kg) → mise à jour de
`20-conception/suivi-poids.md`. C'est le point dur n°1 du VASP.
- Journal de chantier : un fichier par session,
`70-chantier/journal/AAAA-MM-JJ-sujet.md`.
- Photos compressées (< 500 ko) dans `70-chantier/photos/AAAA-MM-JJ/` ;
**vidéos hors repo**.
- Dépenses : une ligne par achat dans `80-budget/depenses.csv`.
## Blog
- Sources Hugo dans `blog/`, thème terminal custom vendored
(`blog/themes/terminal-bus/`) — ne pas ajouter de thème upstream.
- Publier : `blog/deploy.sh` (build + rsync vers Tower, nginx `:8090`,
public sur https://bus.saillant.cc).
## Git
- Remote : `https://electron@git.saillant.cc/electron-rare/bus-axer.git`
(HTTPS + token ; garder le `electron@` dans l'URL — il échappe à la
règle globale `insteadOf` qui réécrirait vers le SSH :2222 cassé).