Files

Auto Tag Develop / tag (push) Has been cancelled

Details

- Rename project name across code, configs, docs, dev/prod infra
- Dev: DOCKER_APP_NAME + POSTGRES_DB switched to starseed, containers become php-starseed-fpm / nginx-starseed / starseed-db-1
- Dev: mount nginx.conf on default.conf instead of starseed.conf to avoid alphabetical-order clash with image's default site
- Makefile: export CURRENT_UID/CURRENT_GID at top level so docker compose builds (db-reset etc.) get them
- Prod: image registry path, container_name, volumes, vhost server_name + paths, DATABASE_URL, CORS, CI workflow
- Add doc/prompt-rename-prod.md with the migration runbook for the prod server (DB rename, FS move, vhost, Let's Encrypt)

2026-05-19 08:24:19 +02:00

2.9 KiB

Raw Blame History

Workflow

Langue

UI : francais (tout ce qui est visible utilisateur)
Communication avec l'utilisateur : francais
Code (noms de classes, methodes, variables, types) : anglais
Commentaires (PHP, TS, Vue — docblock, inline, bloc) : francais. Objectif : faciliter la relecture par l'equipe FR sans polluer l'API publique du code

Delegation Codex

Pour les taches mecaniques (generation de tests boilerplate, renommages massifs, refacto repetitif, scaffolding), deleguer a Codex via le plugin codex (skill codex:rescue).

Codex = junior rapide et pas cher → executions mecaniques
Claude = senior qui verifie et reflechit → design, review, decisions

Ratio qualite/credits optimal : Claude conserve la reflexion et la validation, Codex avale le boilerplate.

Avant d'implementer un ticket

Les specs fonctionnelles vivent sous docs/{rbac,sites,modules}/ticket-*-spec.md.

Avant de coder :

Lire la spec correspondante en entier (elles sont longues mais exhaustives)
Ne pas inventer de detail non specifie — demander a l'utilisateur ou citer explicitement la section manquante
Si la spec contredit le code existant, poser la question avant de choisir

Verification avant "c'est fini"

Ne jamais declarer une tache terminee sans avoir lance les verifications applicables :

Ce qui a bouge	Commande a lancer
Fichiers PHP	`make test` + `make php-cs-fixer-allow-risky`
Fichiers front (Vue/TS)	`make nuxt-test`
Migrations	`make migration-migrate` (sur BDD fraiche ideal : `make db-reset`)
Sidebar / permissions	Verifier que les 3 miroirs RBAC sont alignes (cf. @.claude/rules/testing.md)
UI visible	Demarrer `make dev-nuxt` et verifier le golden path dans le navigateur

Si une verification echoue ou ne peut pas etre lancee (ex : container pas demarre), le dire explicitement plutot que d'annoncer "fini".

Time tracking Lesstime

Au demarrage de toute tache de dev sur Starseed, creer une time entry via l'API Lesstime (cf. ~/.claude/CLAUDE.md pour la procedure complete).

Projet : /api/projects/6 (STARSEED)
Tags : choisir selon le type (Backend 3, Frontend 2, Infra 5, UI/UX 4, Maintenance 6, Gestion projet 9, etc.)

Fix `make cache-clear` (permissions `var/`)

Si make cache-clear echoue sur les permissions de var/ :

docker exec -t -u root php-starseed-fpm chown -R www-data:www-data /var/www/html/var
docker exec -t -u www-data php-starseed-fpm php bin/console cache:clear

A terme : integrer ce fix dans le makefile lui-meme.

Docker — references utiles

Container PHP : php-starseed-fpm
Container Nginx : nginx-starseed (port 8083)
Container DB : PostgreSQL port 5437 (interne et externe)
Config dev : infra/dev/.env.docker (override local : infra/dev/.env.docker.local)
Config prod : infra/prod/ (Dockerfile multi-stage, docker-compose.prod.yml)
Apres modif nginx : docker restart nginx-starseed

2.9 KiB Raw Blame History