docs: add bus-axer workspace design spec
This commit is contained in:
@@ -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.
|
||||||
Reference in New Issue
Block a user