---
description: Documentation du code et des changements MS1 Reader
alwaysApply: true
---

# Documentation MS1 Reader

## Commentaires dans le code

- Documenter la **logique métier non évidente**.
- Pour une nouvelle fonction ou un bloc important : courte description du **pourquoi**, pas seulement du quoi.
- Référencer le ticket : `// MSREAD-xxxx` ou bloc PHPDoc.
- Langue : **français** pour les commentaires métier, sauf si le fichier est entièrement en anglais.

## Scripts SQL

En-tête obligatoire en tête de fichier :

```sql
-- MSREAD-xxxx — Titre court
-- Contexte / prérequis
-- Notes (idempotent, safe, etc.)
```

- Préférer les scripts **idempotents** quand c'est possible.

## Résumé des changements (agent)

À la fin d'une implémentation, fournir :

1. **Quoi** — comportement ajouté ou corrigé.
2. **Où** — fichiers principaux touchés.
3. **Déploiement** — SQL, config, étapes manuelles.

Ne pas créer de fichiers README ou docs hors demande explicite.