commit a8d9d424f17de779c01711951c7e60ec9db34e43 Author: L'électron rare <108685187+electron-rare@users.noreply.github.com> Date: Thu Jul 9 10:47:22 2026 +0200 docs: add bus-axer workspace design spec diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..a69d611 --- /dev/null +++ b/.gitignore @@ -0,0 +1,4 @@ +.remember/ +.DS_Store +blog/public/ +blog/resources/ diff --git a/docs/superpowers/specs/2026-07-09-bus-axer-workspace-design.md b/docs/superpowers/specs/2026-07-09-bus-axer-workspace-design.md new file mode 100644 index 0000000..f67f54a --- /dev/null +++ b/docs/superpowers/specs/2026-07-09-bus-axer-workspace-design.md @@ -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.