56b26db0c1
All checks were successful
Le Makefile portait surtout des cibles mortes/trompeuses (test/test-unit/ test-integration/lint annoncaient "pas implemente" alors que les tests tournent ; install-hooks pointait sur des fichiers absents) ; sa seule cible porteuse, `init`, existait parce que `docker compose up` seul n'applique pas les migrations. En deplacant migrate + seed DANS la stack, `docker compose up` devient l'unique commande qui amene une stack complete et loginnable -> Cr 7.c.4 satisfait sans dependance a l'outil `make`. - db/migrate-container.sh : runner in-container (connexion par le reseau compose), applique db/migrations/*.sql (suivi schema_migrations) puis db/seeds/*.sql (suivi seeds_applied), idempotent. - Service one-shot `wakdo-migrate` (depends_on db healthy) ; wakdo-app/web attendent sa completion (service_completed_successfully). - Makefile supprime ; db/migrate.sh (hote) conserve pour l'usage manuel / --status. - Docs realignees : README, .env.example, db/README, docker-compose, PROJECT_CONTEXT (`make *` -> `docker compose *`, Cr 7.b porte par les scripts Bash). Correction au passage : la CI/CD est Forgejo Actions (pas GitHub Actions), protections cote Forgejo. - Journal : docs/journal/2026-06-17--makefile-to-compose-migrate.md (rationale + verif sur base ephemere : 2 migrations + 2 seeds, idempotent ; note de deploiement pour les bases deja seedees). Verifie : docker compose config valide ; runner teste sur MariaDB ephemere (5 roles, 23 permissions, admin present) ; re-run = 0 nouveau. Aucun code PHP/JS touche.
250 lines
11 KiB
Markdown
250 lines
11 KiB
Markdown
# Wakdo
|
|
|
|
Borne de commande pour restauration rapide. Projet de certification RNCP 37805 (Titre Developpeur Web, B2, option DevOps).
|
|
|
|
**Statut** : en developpement actif. Soutenance prevue septembre 2026.
|
|
|
|
**Sites exposes cibles** :
|
|
- `https://corentin-wakdo.stark.a3n.fr` — Borne client (Bloc 1 Front)
|
|
- `https://corentin-wakdo-admin.stark.a3n.fr` — Back-office + API REST (Bloc 2)
|
|
|
|
---
|
|
|
|
## Apercu
|
|
|
|
Wakdo simule une borne de commande tactile de type fast-food (pastiche McDonald's), avec back-office administrateur, workflow de preparation en cuisine et API REST interne consommee par la borne.
|
|
|
|
Trois canaux de prise de commande :
|
|
|
|
- `kiosk` — borne tactile autonome (le client compose seul)
|
|
- `counter` — comptoir (un equipier saisit pour le client au guichet)
|
|
- `drive` — drive-thru (equipier saisit via intercom + casque)
|
|
|
|
Quatre statuts commande : `pending` -> `preparing` -> `ready` -> `delivered` (ou `cancelled`).
|
|
|
|
Scope metier complet, regles, horaires de service et fenetre de maintenance : voir `docs/PROJECT_CONTEXT.md`.
|
|
|
|
---
|
|
|
|
## Methodologie et outils
|
|
|
|
Ce projet a ete developpe avec l'appui de **BYAN (Builder of YAN)**, un systeme d'agents IA custom applicant la methodologie **Merise Agile enrichie de 64 Mantras** (voir `.claude/CLAUDE.md` et `.claude/rules/`).
|
|
|
|
Realisation avec l'assistance d'outils d'IA generative (Claude Code, BYAN), conformement a l'autorisation du centre de formation Acadenice.
|
|
|
|
- Les decisions d'architecture, de scope et de design sont prises par l'auteur.
|
|
- Le code, les tests et la documentation sont co-rediges et valides par l'auteur avant commit.
|
|
- La modelisation Merise est formalisee par l'IA a partir du dictionnaire de donnees et des user stories ; l'arbitrage et la validation sont de l'auteur.
|
|
- Tracabilite du projet : `docs/journal/` (retrospectives de session et de feature) et `docs/PROJECT_CONTEXT.md` section 17 (scope complet de l'usage IA).
|
|
- Pas de trailer `Co-Authored-By` appose sur les commits — voir section 17.7 du `PROJECT_CONTEXT.md` pour la justification.
|
|
|
|
---
|
|
|
|
## Stack technique
|
|
|
|
| Couche | Techno | Version |
|
|
|---|---|---|
|
|
| Langage back | PHP | 8.3 |
|
|
| Framework back | Aucun (from scratch) | — |
|
|
| Autoloader | PSR-4 manuel via `spl_autoload_register` | — |
|
|
| Base de donnees | MariaDB | 11.4 |
|
|
| Pilote BDD | PDO (prepared statements uniquement) | natif PHP |
|
|
| Serveur web | Apache httpd | 2.4 Alpine |
|
|
| Serveur app | PHP-FPM | 8.3 Alpine |
|
|
| Reverse proxy | Traefik | existant sur l'hote (reseau `admin_proxy`) |
|
|
| Tests | PHPUnit | 11.x (`.phar` autonome, sans Composer) |
|
|
| Front | HTML5 + CSS3 + JS ES6+ vanilla | — |
|
|
| Conteneurisation | Docker + docker compose v2 | — |
|
|
| Orchestration locale | docker compose v2 (service one-shot `wakdo-migrate`) | — |
|
|
| CI/CD | Forgejo Actions | — |
|
|
| Versioning | Git + Forgejo (`git.acadenice.com`, miroir GitHub) | Conventional Commits |
|
|
|
|
Detail et justifications : `docs/PROJECT_CONTEXT.md` section 6.
|
|
|
|
---
|
|
|
|
## Architecture
|
|
|
|
```
|
|
corentin-wakdo.stark.a3n.fr corentin-wakdo-admin.stark.a3n.fr
|
|
| |
|
|
+--------------+-----------------------+
|
|
|
|
|
v
|
|
Traefik (reseau admin_proxy)
|
|
|
|
|
v
|
|
wakdo-web (Apache httpd)
|
|
| FastCGI :9000
|
|
v
|
|
wakdo-app (PHP-FPM 8.3)
|
|
| PDO
|
|
v
|
|
wakdo-db (MariaDB 11.4)
|
|
|
|
wakdo-cron (backup BDD + purge sessions + stats)
|
|
```
|
|
|
|
Reseaux, volumes, services et decoupage reseau interne / reseau proxy : voir `docs/PROJECT_CONTEXT.md` section 5.
|
|
|
|
---
|
|
|
|
## Quickstart
|
|
|
|
Ce projet tourne **sur serveur derriere un reverse proxy Traefik** : pas de binding de ports hote, pas d'acces `localhost`. L'acces public se fait par FQDN HTTPS (TLS gere automatiquement par Traefik). Les environnements `dev`, `staging` et `prod` se distinguent par des FQDN et des fichiers `.env` separes.
|
|
|
|
### Prerequis sur l'hote
|
|
|
|
1. Docker Engine + docker compose v2 (voir ci-dessous)
|
|
2. Un reverse proxy Traefik deja en place, avec un reseau Docker externe dedie. Le **nom du reseau** est configurable via la variable `REVERSE_PROXY_NETWORK` du `.env` (defaut : `admin_proxy` — convention de l'auteur). A adapter a votre infrastructure.
|
|
3. Les FQDN cibles pointent en DNS vers l'hote
|
|
|
|
### Sur un hote deja equipe (Docker + Traefik)
|
|
|
|
```bash
|
|
git clone git@github.com:AcadeNice/wakdo_corentin.git
|
|
cd wakdo_corentin
|
|
cp .env.example .env
|
|
# Editer .env : DB_PASSWORD, DB_ROOT_PASSWORD, APP_URL_*, TRAEFIK_DOMAIN_*
|
|
docker compose up -d
|
|
```
|
|
|
|
> **Attention au `.env` pre-existant.** Si un fichier `.env` existe deja a la racine (tooling externe, autre plateforme installee dans le meme repertoire), **ne pas faire** `cp .env.example .env` — cela ecraserait les variables existantes. Faire un **merge manuel** a la place : ajouter les variables manquantes du template dans le `.env` actuel. Les prefixes de variables de ce projet (`APP_`, `DB_`, `SESSION_`, `CORS_`, `UPLOAD_`, `CRON_`, `TRAEFIK_`, `REVERSE_PROXY_`) sont disjoints de ceux utilises par des outils tiers courants, donc la cohabitation est safe.
|
|
|
|
Critere RNCP Cr 7.c.4 couvert : une seule commande (`docker compose up -d`) lance la
|
|
stack complete. Le service one-shot `wakdo-migrate` applique le schema (migrations)
|
|
puis les donnees de reference (seed) avant que l'app ne serve ; `wakdo-app`/`wakdo-web`
|
|
attendent sa completion (`depends_on: service_completed_successfully`). Migrations et
|
|
seed sont idempotents (tables de suivi `schema_migrations` / `seeds_applied`).
|
|
Detail : `docs/journal/2026-06-17--makefile-to-compose-migrate.md`.
|
|
|
|
Services accessibles apres `docker compose up -d` :
|
|
- Borne : la valeur de `TRAEFIK_DOMAIN_KIOSK` dans `.env`
|
|
- Admin + API : la valeur de `TRAEFIK_DOMAIN_ADMIN` dans `.env`
|
|
|
|
### Installation Docker sur un hote neuf (Debian / Ubuntu)
|
|
|
|
Procedure officielle detaillee : `https://docs.docker.com/engine/install/` (selectionner la distribution). Resume pour Debian stable :
|
|
|
|
```bash
|
|
sudo apt update
|
|
sudo apt install -y ca-certificates curl
|
|
sudo install -m 0755 -d /etc/apt/keyrings
|
|
sudo curl -fsSL https://download.docker.com/linux/debian/gpg \
|
|
-o /etc/apt/keyrings/docker.asc
|
|
sudo chmod a+r /etc/apt/keyrings/docker.asc
|
|
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] \
|
|
https://download.docker.com/linux/debian \
|
|
$(. /etc/os-release && echo $VERSION_CODENAME) stable" \
|
|
| sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
|
|
sudo apt update
|
|
sudo apt install -y docker-ce docker-ce-cli containerd.io \
|
|
docker-buildx-plugin docker-compose-plugin
|
|
sudo usermod -aG docker $USER
|
|
# Fermer et rouvrir la session pour activer le groupe docker
|
|
```
|
|
|
|
### Reseau externe du reverse proxy
|
|
|
|
Le `docker-compose.yml` attend un reseau Docker externe deja existant sur l'hote, dont le nom est donne par la variable `REVERSE_PROXY_NETWORK` (defaut : `admin_proxy`).
|
|
|
|
Si vous avez deja un Traefik en place, ce reseau a generalement ete cree par son propre stack. Adaptez la variable `REVERSE_PROXY_NETWORK` dans votre `.env` au nom utilise par votre proxy. Sinon, creez-le manuellement :
|
|
|
|
```bash
|
|
docker network create mon_reseau_proxy
|
|
# puis dans .env :
|
|
# REVERSE_PROXY_NETWORK=mon_reseau_proxy
|
|
```
|
|
|
|
Avant le premier `docker compose up`, s'assurer que le reseau existe. Verification rapide :
|
|
|
|
```bash
|
|
docker network inspect "$(grep ^REVERSE_PROXY_NETWORK .env | cut -d= -f2)"
|
|
```
|
|
|
|
Si la commande retourne une erreur, soit adapter `REVERSE_PROXY_NETWORK` au nom du reseau utilise par votre proxy, soit creer le reseau manuellement (le reseau externe doit exister avant `docker compose up`).
|
|
|
|
*Section mise a jour au fil de l'implementation (migrations reelles, seed, CI/CD deploiement).*
|
|
|
|
---
|
|
|
|
## Structure du projet
|
|
|
|
```
|
|
.
|
|
|-- .claude/ # Methodologie BYAN (visible jury : CLAUDE.md + rules/)
|
|
|-- .forgejo/
|
|
| `-- workflows/ # CI Forgejo Actions (ci.yml : secret-scan, php-lint, static-tests, js-tests, auto-merge)
|
|
|-- .githooks/ # pre-commit + commit-msg [a venir]
|
|
|-- docker/ # Dockerfiles customs par service
|
|
| |-- apache/
|
|
| |-- php-fpm/
|
|
| `-- cron/
|
|
|-- db/
|
|
| |-- migrations/ # DDL MariaDB versionnes [a venir]
|
|
| `-- seeds/ # Donnees de demo [a venir]
|
|
|-- docs/
|
|
| |-- PROJECT_CONTEXT.md # Source de verite projet (scope, stack, RNCP mapping)
|
|
| |-- journal/ # Retros par session et par feature (oral RNCP)
|
|
| `-- merise/ # MCD, MCT, MLD [a venir]
|
|
|-- scripts/ # backup-db, install-hooks, ... [a venir]
|
|
|-- src/ # Code applicatif [a venir]
|
|
| |-- Core/ # Router, Autoloader, DB
|
|
| |-- Controllers/
|
|
| |-- Models/
|
|
| |-- Views/
|
|
| |-- Services/
|
|
| |-- public/ # DocumentRoot Apache
|
|
| `-- bootstrap.php
|
|
|-- tests/
|
|
| |-- Unit/ # [a venir]
|
|
| `-- Integration/ # [a venir]
|
|
|-- .env.example
|
|
|-- .dockerignore
|
|
|-- .gitignore
|
|
|-- docker-compose.yml
|
|
`-- README.md
|
|
```
|
|
|
|
---
|
|
|
|
## Developpement
|
|
|
|
### Conventions
|
|
|
|
- **Commits** : Conventional Commits en anglais (`feat`, `fix`, `docs`, `refactor`, `test`, `chore`, `ci`, `db`, `perf`, `style`). Format : `type(scope): description`. Voir `docs/PROJECT_CONTEXT.md` section 9.
|
|
- **Branches** : `feat/*`, `fix/*`, `refactor/*`, `docs/*`, `ci/*`, `db/*`, `chore/*`, `test/*` depuis `dev`. Merge vers `dev` par PR squashee. Periodiquement `dev` -> `main` par PR avec tag semver.
|
|
- `main` et `dev` sont proteges cote Forgejo (PR requise, force push bloque, checks requis : secret-scan / php-lint / static-tests).
|
|
- Pas d'emoji dans le code, les commits ou les specs techniques (Mantra IA-23).
|
|
|
|
*Sections detaillees (setup env de dev, lint, tests) : a completer au fil de l'implementation.*
|
|
|
|
---
|
|
|
|
## Tests
|
|
|
|
*Section a completer. Strategie globale : PHPUnit via `.phar` autonome (sans Composer), priorite Unit > Integration > E2E, voir `docs/PROJECT_CONTEXT.md` section 6 et mantras Merise Agile.*
|
|
|
|
---
|
|
|
|
## Deploiement
|
|
|
|
*Strategie : CI Forgejo Actions sur PR vers `dev`/`main` (secret-scan gitleaks, php-lint, static-tests PHPStan+PHPUnit, js-tests) avec auto-merge sur label + CI verte. CD : declenchement humain, redeploiement par `docker compose pull && docker compose up -d`. Voir `docs/PROJECT_CONTEXT.md` section 7 Bloc 5.*
|
|
|
|
---
|
|
|
|
## Documentation
|
|
|
|
| Document | Role |
|
|
|---|---|
|
|
| `docs/PROJECT_CONTEXT.md` | Source de verite projet (17 sections : scope, stack, architecture, mapping critere RNCP, planning, risques, conventions) |
|
|
| `docs/journal/` | Retrospectives par session et par feature (preparation de l'oral RNCP) |
|
|
| `docs/merise/` *(a venir)* | Modelisation Merise : dictionnaire, MCD, MCT, MLD |
|
|
| `.claude/CLAUDE.md` | Constitution du projet pour les agents Claude Code |
|
|
| `.claude/rules/` | Protocoles appliques : fact-check, merise-agile, elo-trust, hermes-dispatcher, byan-api, byan-agents |
|
|
|
|
---
|
|
|
|
## Licence
|
|
|
|
Projet pedagogique dans le cadre de la certification RNCP 37805. Usage et reproduction reserves a l'evaluation et a la demonstration, sans cession de droits commerciaux.
|