Files
Beaujol-Bus-Lab/docs/superpowers/specs/2026-07-09-bus-axer-workspace-design.md
2026-07-09 10:47:22 +02:00

8.1 KiB

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.mdtableau 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.