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é).
+30
View File
@@ -0,0 +1,30 @@
# Registre des décisions
Format : une entrée par décision structurante, la plus récente en haut.
## 2026-07-09 — Blog de chantier Hugo « hackerspace » sur Tower
**Décision** : blog statique Hugo (`blog/`), thème terminal custom
vendored, servi par nginx dockerisé sur Tower `:8090`, exposé sur
https://bus.saillant.cc via l'infra `*.saillant.cc` existante.
**Pourquoi** : markdown cohérent avec le repo, zéro dépendance upstream
(politique supply-chain), Tower déjà allumé en continu.
**Alternatives écartées** : Zola/Astro (écosystème moins connu ici),
thème upstream en submodule (flottant, non audité).
## 2026-07-09 — VASP atelier ≤ 9 places
**Décision** : reclassification en VASP atelier avec 9 places assises max.
**Pourquoi** : conduite au permis C, sortie du régime transport en commun
(fin des contrôles semestriels), tout en gardant la capacité de déplacer
une équipe.
**Conséquences** : suivi de poids par essieu obligatoire dès la
conception ; sièges et ancrages homologués ; exigences DREAL à intégrer
en amont (`10-reglementaire/`).
## 2026-07-09 — Structure du workspace par domaines
**Décision** : dossiers numérotés par domaine technique (00→80) plutôt
que par phase chronologique.
**Pourquoi** : sur 5 ans, chaque domaine vit à son rythme et traverse
plusieurs phases ; la roadmap transversale vit dans `ROADMAP.md`.
+35
View File
@@ -0,0 +1,35 @@
# BUS — Irisbus Axer → atelier mobile
Rénovation et aménagement d'un bus **Irisbus Axer** en **atelier / labo
mobile** : électronique & prototypage + fabrication numérique (imprimantes
3D, découpe laser, petite CNC), avec **1 cabine de douche** et **9 places
assises** homologuées.
- **Objectif réglementaire** : reclassification **VASP atelier ≤ 9 places**
(permis C, passage DREAL/UTAC).
- **Horizon** : 5 ans — voir [ROADMAP.md](ROADMAP.md).
- **Blog de chantier** : https://bus.saillant.cc (sources dans `blog/`).
## État
- [x] Bus acquis, intérieur vidé
- [ ] Conception (plans, poids, énergie)
- [ ] Dossier réglementaire VASP
- [ ] Chantier
## Structure
| Dossier | Contenu |
|---------|---------|
| `00-vehicule/` | Fiche technique Axer, état initial, photos de départ |
| `10-reglementaire/` | Parcours VASP, DREAL/UTAC, checklists, contacts |
| `20-conception/` | Implantation, zoning, **suivi de poids par essieu** |
| `30-energie-elec/` | Bilan de puissance, architecture élec, schémas KiCad |
| `40-fluides/` | Eau/douche, chauffage, ventilation/extraction |
| `50-amenagement/` | Isolation, mobilier, 9 sièges homologués |
| `60-machines/` | Parc machines, établis, arrimage en roulage |
| `70-chantier/` | Journal de chantier, photos datées |
| `80-budget/` | Budget prévisionnel, dépenses, devis |
| `blog/` | Site Hugo → bus.saillant.cc |
Les décisions structurantes sont tracées dans [DECISIONS.md](DECISIONS.md).
+21
View File
@@ -0,0 +1,21 @@
# Roadmap 5 ans
| Année | Jalon principal | Statut |
|-------|-----------------|--------|
| An 1 (2026-27) | Conception complète (plans, suivi poids, bilan énergie) + contact DREAL/RTI + isolation | en cours |
| An 2 (2027-28) | Énergie & électricité (solaire, batteries, distribution) | à venir |
| An 3 (2028-29) | Fluides (douche, chauffage, ventilation) + aménagement structurel | à venir |
| An 4 (2029-30) | Mobilier atelier, sièges homologués, installation machines | à venir |
| An 5 (2030-31) | Finitions, dossier VASP, passage DREAL/UTAC, mise en service | à venir |
## An 1 — détail
- [ ] Compléter `00-vehicule/fiche-technique.md` (peser le bus : PV réel !)
- [ ] Relevé coté de l'intérieur vidé → `20-conception/implantation.md`
- [ ] Premier contact DREAL / centre RTI → `10-reglementaire/contacts.md`
- [ ] Bilan de puissance machines → `30-energie-elec/bilan-puissance.md`
- [ ] Zoning validé (atelier / douche / 9 places / circulation)
- [ ] Choix isolation + pose
- [ ] Blog lancé (premier billet publié)
Le blog raconte le chantier dès l'An 1.