Public demo of Factory 4 Life project management: - Gate definitions S0 (spec), S1 (build), S2 (integration), S3 (production ready) - Hardware project template with PlatformIO, KiCad CI, and Makefile for fab packages - JSON schema for .kill-life.yaml manifest - CLI scripts: create-project, validate-gates, dashboard with color-coded status output - Example project: led-controller (S0+S1 passed, S2 in progress)
68 lines
2.0 KiB
Markdown
68 lines
2.0 KiB
Markdown
# life-project-example
|
|
|
|
Example repo for Factory 4 Life project management: gates S0-S3, templates, cross-repo orchestration.
|
|
|
|
> This is a **public demo** of the project management system. See the gate definitions, templates, and scripts below.
|
|
|
|
## Concept
|
|
|
|
Chaque projet hardware/firmware/software suit un pipeline de **gates** (S0 -> S3) inspiré du stage-gate process. Ce repo centralise :
|
|
|
|
- **Gates** : definitions, criteres, checklists (`gates/`)
|
|
- **Schemas** : validation YAML des manifests `.kill-life.yaml` (`schemas/`)
|
|
- **Templates** : squelettes de repos prets a l'emploi (`templates/`)
|
|
- **Scripts** : outils CLI pour creer, valider et suivre les projets (`scripts/`)
|
|
- **Projects** : registre des projets actifs (`projects/`)
|
|
|
|
## Pipeline de gates
|
|
|
|
| Gate | Nom | Objectif |
|
|
|------|-----|----------|
|
|
| **S0** | Spec Ready | Specs testables, architecture definie, plan de validation |
|
|
| **S1** | Build OK | Firmware compile, ERC/DRC green, tests unitaires passent |
|
|
| **S2** | Integration | Tests integration, BOM valide, prototype fonctionnel |
|
|
| **S3** | Production Ready | Fab package complet, compliance, documentation livree |
|
|
|
|
## Structure d'un projet
|
|
|
|
Chaque repo projet contient un `.kill-life.yaml` a la racine :
|
|
|
|
```yaml
|
|
kill_life:
|
|
version: 1
|
|
project: "mon-projet"
|
|
client: "client-name"
|
|
gates:
|
|
s0: { status: passed, date: "2026-03-15" }
|
|
s1: { status: in_progress }
|
|
s2: { status: pending }
|
|
s3: { status: pending }
|
|
hardware:
|
|
pcb_dir: hardware/pcb
|
|
bom_dir: hardware/bom
|
|
firmware:
|
|
framework: platformio
|
|
src_dir: firmware/src
|
|
```
|
|
|
|
## Utilisation
|
|
|
|
```bash
|
|
# Creer un nouveau projet depuis le template
|
|
./scripts/create-project.sh mon-projet electron-rare
|
|
|
|
# Valider les gates d'un projet
|
|
./scripts/validate-gates.sh electron-rare/mon-projet
|
|
|
|
# Dashboard de tous les projets
|
|
./scripts/dashboard.sh
|
|
```
|
|
|
|
## Repos exemple
|
|
|
|
- [electron-rare/hypnoled](https://github.com/electron-rare/hypnoled) — HypnoLED animations LED ESP32
|
|
|
|
## License
|
|
|
|
MIT
|