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