docs: add bus-axer workspace design spec

This commit is contained in:
L'électron rare
2026-07-09 10:47:22 +02:00
commit a8d9d424f1
2 changed files with 165 additions and 0 deletions
+4
View File
@@ -0,0 +1,4 @@
.remember/
.DS_Store
blog/public/
blog/resources/
@@ -0,0 +1,161 @@
# Projet BUS — Atelier mobile Irisbus Axer : workspace & blog
**Date** : 2026-07-09
**Statut** : validé (brainstorming du 2026-07-09)
**Portée** : création du workspace projet (repo git) + blog de chantier public
## 1. Contexte et objectifs
Rénovation et aménagement d'un bus **Irisbus Axer** (acquis, intérieur déjà
vidé) en **atelier / labo mobile** : électronique & prototypage (cœur de
métier FineFab) + fabrication numérique (imprimantes 3D, découpe laser,
petite CNC). L'aménagement inclut **1 cabine de douche** et **9 places
assises** homologuées.
- **Objectif réglementaire** : reclassification **VASP atelier, ≤ 9 places**
(conduite au permis C, sortie du régime transport en commun, passage
DREAL/UTAC).
- **Horizon** : **5 ans**, budget construit progressivement au fil du projet.
- **Livrable de cette phase** : un repo git structuré dans
`~/Documents/BUS`, hébergé sur `git.saillant.cc`, et un blog de chantier
public `bus.saillant.cc` hébergé sur Tower.
## 2. Ce qui est hors périmètre (cette phase)
- Les études techniques elles-mêmes (dimensionnement solaire, plans
définitifs, dossier DREAL) : le workspace les *accueille*, il ne les
*produit* pas.
- CI Gitea Actions pour le blog (un script de déploiement suffit au départ).
- Tout achat de matériel.
## 3. Structure du repo
```
BUS/
├─ README.md ← vision, specs clés du bus, état d'avancement
├─ CLAUDE.md ← conventions du repo
├─ ROADMAP.md ← jalons sur 5 ans
├─ DECISIONS.md ← registre des décisions (format ADR léger)
├─ 00-vehicule/ ← fiche technique Axer, CG, photos état initial
├─ 10-reglementaire/ ← parcours VASP, DREAL/UTAC, RTI, checklists
├─ 20-conception/ ← plans, zoning, suivi de poids par essieu
├─ 30-energie-elec/ ← bilan de puissance, architecture élec, KiCad
├─ 40-fluides/ ← eau/douche, chauffage, ventilation/extraction
├─ 50-amenagement/ ← isolation, mobilier, 9 sièges homologués
├─ 60-machines/ ← parc machines, établis, fixations en roulage
├─ 70-chantier/ ← journal de chantier, photos datées
├─ 80-budget/ ← budget prévisionnel, dépenses réelles, devis
├─ blog/ ← site Hugo → bus.saillant.cc
└─ docs/superpowers/specs/ ← documents de design (dont celui-ci)
```
## 4. Contenu initial par domaine
Chaque dossier est semé de documents utiles (pas de coquilles vides) :
- **Racine** : `README.md`, `CLAUDE.md` (conventions), `ROADMAP.md`,
`DECISIONS.md` (première entrée : choix VASP atelier ≤ 9 places).
- **00-vehicule/** : `fiche-technique.md` à compléter (dimensions, PTAC,
PV essieux, empattement, moteur, année, kilométrage), `etat-initial.md`
(inventaire de ce qui reste après le vidage), `photos/` (état de départ).
- **10-reglementaire/** : `parcours-vasp.md` (synthèse des étapes :
RTI — réception à titre isolé, pièces du dossier, DREAL, UTAC),
`checklist-conformite.md`, `contacts.md`.
- **20-conception/** : `implantation.md` (zoning atelier / douche /
9 places / circulation), `suivi-poids.md` — **tableau des masses par
poste et répartition par essieu**, point dur n°1 d'un VASP sur châssis
bus : à tenir à jour à chaque ajout.
- **30-energie-elec/** : `bilan-puissance.md` (les machines de fab
numérique sont les gros consommateurs — laser et CNC dimensionnent le
système), `architecture.md` (parc batterie, solaire, chargeur,
convertisseur, distribution 12/48 V et 230 V), squelette de projet
**KiCad** (`kicad/bus-elec/`) pour les schémas de distribution.
- **40-fluides/** : `eau.md` (réservoirs propre/grise pour la douche),
`chauffage.md`, `ventilation.md` (extraction poussières et fumées :
impression 3D, laser — sécurité prioritaire).
- **50-amenagement/** : `isolation.md`, `mobilier.md`, `sieges.md`
(9 places homologuées : ancrages, ceintures, conformité).
- **60-machines/** : `inventaire.md` (machine, masse, puissance,
emplacement prévu), `fixations.md` (arrimage en roulage).
- **70-chantier/** : `journal/` (un fichier par session :
`AAAA-MM-JJ-sujet.md`), `photos/AAAA-MM-JJ/` (compressées).
- **80-budget/** : `budget-previsionnel.md` (par domaine),
`depenses.csv` (date, domaine, fournisseur, montant, facture),
`devis/`.
## 5. Conventions
- **Docs en français** (réglementaire français, artisans, fournisseurs) ;
**commits en anglais**, sujet ≤ 50 caractères, corps ≤ 72 colonnes,
pas d'attribution IA (règles maison).
- Photos **compressées** versionnées dans `70-chantier/photos/AAAA-MM-JJ/` ;
**vidéos hors repo**.
- Schémas électriques dans KiCad, versionnés.
- Toute décision structurante → une entrée dans `DECISIONS.md`.
- Chaque ajout de masse significatif → mise à jour de
`20-conception/suivi-poids.md`.
## 6. Git et hébergement
- Repo local `~/Documents/BUS`, branche `main`.
- Remote : **`git.saillant.cc`** (Gitea), org **`electron-rare`**, repo
**`bus-axer`**, créé via l'API Gitea.
- URL remote en **HTTPS + token** (`https://electron@git.saillant.cc/
electron-rare/bus-axer.git`) — le SSH :2222 est cassé ; l'URL avec
`electron@` échappe à la règle globale `insteadOf` qui réécrirait le
HTTPS en SSH.
- `.gitignore` racine : `.remember/`, `.DS_Store`, artefacts de build Hugo
(`blog/public/`, `blog/resources/`).
## 7. Blog `bus.saillant.cc`
- **Contenu** : récit du chantier — les billets s'appuient sur le journal
et les photos de `70-chantier/`.
- **Générateur** : **Hugo**, sources dans `blog/`.
- **Design** : **type hackerspace** — esthétique terminal (monospace,
fond sombre, accent vert/ambre, ASCII art bienvenu). Thème vendored
dans le repo (pas de submodule upstream flottant — politique
supply-chain maison) : base « terminal-like » minimale, customisée.
- **Hébergement** : container **nginx statique sur Tower**
(`192.168.0.120` / Tailscale `100.78.6.122`), port dédié (ex. `:8090`).
- **Exposition** : route `bus.saillant.cc` → Tower ajoutée à l'infra
existante — **à vérifier sur place** : tunnel cloudflared historique
(`*.saillant.cc`) ou Traefik 3 de l'edge (comme `git.saillant.cc`
depuis 2026-06-08). La route sera ajoutée là où l'infra le fait
aujourd'hui.
- **Déploiement** : `blog/deploy.sh` — build Hugo local + rsync du
`public/` vers Tower + (re)démarrage du container nginx. CI Gitea
Actions possible plus tard, hors périmètre.
## 8. Roadmap 5 ans (jalons proposés, à affiner)
| Année | Jalon principal |
|-------|-----------------|
| An 1 | Conception complète (plans, suivi poids, bilan énergie) + contact DREAL/RTI + isolation |
| An 2 | Énergie & électricité (solaire, batteries, distribution) |
| An 3 | Fluides (douche, chauffage, ventilation) + aménagement structurel |
| An 4 | Mobilier atelier, sièges homologués, installation machines |
| An 5 | Finitions, dossier VASP, passage DREAL/UTAC, mise en service |
Le blog est lancé dès la phase 1 (récit du chantier depuis le début).
## 9. Risques et points durs identifiés
1. **Poids / répartition essieux** : un atelier équipé (machines, batteries,
eau) charge vite — le suivi de poids est tenu dès le premier jour.
2. **Réglementaire VASP** : les exigences DREAL (ancrages sièges,
gaz/électricité, issues) doivent être connues *avant* de concevoir,
pas après — d'où le domaine `10-reglementaire/` en tête de roadmap.
3. **Énergie des machines** : laser/CNC/imprimantes en autonomie = gros
parc batterie ou groupe/raccordement — le bilan de puissance arbitrera.
4. **Sécurité atelier roulant** : extraction fumées laser, arrimage
machines — traités comme des exigences, pas des options.
## 10. Critères de réussite (cette phase)
- [ ] Repo initialisé, structure complète, documents semés, premier commit.
- [ ] Remote Gitea `electron-rare/bus-axer` créé et poussé.
- [ ] Blog Hugo buildable localement (`hugo` sans erreur), premier billet
« le projet » publié.
- [ ] Blog servi sur Tower et accessible sur `https://bus.saillant.cc`.
- [ ] `deploy.sh` fonctionnel de bout en bout.