Files
ms1readerv4/.cursor/rules/ms1reader-workflow.mdc
stephan def14692ee Adapter le dépôt au layout serveur (git root = home, pas public_html).
Déplace deploy_dev.php dans public_html, retire www/home du tracking, et limite git clean aux chemins applicatifs.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-19 10:29:36 -04:00

40 lines
2.0 KiB
Plaintext

---
description: Workflow MS1 Reader — JIRA, validation avant gros changements
alwaysApply: true
---
# Workflow MS1 Reader
## Numéro JIRA
- Au début d'une tâche de développement (nouvelle feature, correctif, refactor), **demander le numéro JIRA** si l'utilisateur ne l'a pas fourni.
- Ne pas bloquer une simple question ou une lecture du code — seulement quand on s'apprête à modifier des fichiers.
- Référencer le ticket dans le code et les scripts SQL : `// MSREAD-xxxx` ou `-- MSREAD-xxxx — description` (ajuster le préfixe projet si différent).
## Portée des changements
- **Changement minimal** : corriger uniquement ce qui est demandé.
- Pas de refactor large, renommage massif ou « nettoyage » opportuniste sans accord explicite.
- Pour le code existant, privilégier la cohérence locale (fichier / module touché) plutôt qu'une modernisation globale.
## Git / déploiement (philosophie MS1)
- Développement sur branche **`dev`** ; **`master`** = référence prod.
- Le serveur = **déploiement uniquement** (pas de commits sur le serveur).
- Sur le serveur Reader, le dépôt Git est à **`$HOME`** (`/home/ms1reader`) : `ci4app/` et `public_html/` sont frères ; `www` → symlink vers `public_html`.
- Flux : push Windows → Gitea → webhook → `public_html/deploy_dev.php` → `~/deploy/deploy_dev.sh` (`fetch` + `reset --hard` + `clean -fd` **limité** à `ci4app` et `public_html`).
- Tout fichier nécessaire après un deploy (ex. `public_html/deploy_dev.php`) **doit être versionné**.
## Incohérences repérées
Quand du code voisin contredit le pattern du fichier ou du module :
1. **Signaler** brièvement l'incohérence à l'utilisateur.
2. **Proposer** une correction ciblée ou l'alignement sur le pattern dominant.
3. **Attendre confirmation** avant de corriger hors périmètre.
## Fin de tâche
- Résumer ce qui a changé (fichiers, comportement, SQL à exécuter).
- Mentionner les étapes manuelles restantes (déploiement, import SQL, cache).