Web-Infra-Reports-IT/AGENTS.md

# AGENTS.md — Instructions Codex

## Contexte

Ce projet est un environnement de développement hébergé sur une infrastructure
professionnelle.

Le code présent dans ce workspace peut être modifié par Codex.

IMPORTANT :
Les bases de données auxquelles l'application peut accéder contiennent des
DONNÉES DE PRODUCTION.

La protection et l'intégrité de ces données sont prioritaires.

---

## 1. Périmètre autorisé

Codex peut :

- Lire tous les fichiers du workspace courant.
- Rechercher librement dans les fichiers du workspace.
- Créer, modifier, renommer ou supprimer des fichiers dans le workspace
  lorsque cela est nécessaire à la tâche demandée.
- Exécuter des commandes locales nécessaires à l'analyse du projet.
- Utiliser Git pour examiner :
    - status
    - diff
    - log
    - historique
- Analyser et modifier du code PHP, JavaScript, HTML, CSS, SQL et PowerShell
  présent dans le workspace.

Codex doit rester dans le workspace courant :

    E:\Sites\web-infra-reports

Ne jamais modifier un fichier situé en dehors de ce workspace sans demander
explicitement l'autorisation.

---

## 2. Bases de données — RÈGLE CRITIQUE

Les bases de données accessibles depuis cette application doivent être
considérées comme des bases de PRODUCTION.

### Opérations autorisées

Codex peut effectuer des opérations SQL strictement en lecture seule :

    SELECT

Il peut également :

- analyser les requêtes SQL présentes dans le code ;
- écrire ou modifier du SQL dans les fichiers source ;
- proposer des requêtes SQL ;
- examiner la structure des données lorsqu'elle est accessible en lecture.

### Opérations interdites

Codex ne doit JAMAIS exécuter sur une base de données une commande susceptible
de modifier les données, la structure ou la configuration.

Cela comprend notamment :

    INSERT
    UPDATE
    DELETE
    MERGE
    TRUNCATE
    DROP
    ALTER
    CREATE
    GRANT
    REVOKE

Ne jamais exécuter une procédure stockée ou une fonction SQL susceptible
d'avoir des effets de bord.

En particulier :

    EXEC
    EXECUTE

ne doivent être utilisés que s'il est certain que l'opération est strictement
en lecture seule.

En cas de doute :

    NE PAS EXÉCUTER LA REQUÊTE.

Demander confirmation à l'utilisateur.

---

## 3. Credentials et secrets

Ne jamais :

- afficher inutilement un mot de passe ;
- recopier un mot de passe dans un nouveau fichier ;
- ajouter un secret dans Git ;
- modifier les credentials existants sans demande explicite ;
- transmettre un credential ou un secret vers Internet.

Si des credentials sont découverts dans le code, les considérer comme
confidentiels.

Ne pas les inclure dans les réponses sauf nécessité absolue.

---

## 4. Infrastructure externe

Ne jamais modifier directement :

- un autre site IIS ;
- une configuration IIS externe au workspace ;
- Active Directory ;
- DNS ;
- un serveur distant ;
- une machine virtuelle ;
- un partage réseau ;
- une tâche planifiée ;
- une configuration système Windows ;
- une base de données ;
- une ressource de production.

Codex peut analyser le code qui effectue ces opérations et le modifier dans
le workspace.

L'exécution réelle d'une opération d'administration doit être laissée à
l'utilisateur sauf demande explicite.

---

## 5. Commandes PowerShell et shell

Les commandes purement consultatives peuvent être exécutées librement.

Exemples :

    rg
    Get-Content
    Select-String
    Get-ChildItem
    git status
    git diff
    git log

Avant d'exécuter une commande ayant potentiellement des effets de bord,
vérifier qu'elle ne peut pas modifier une ressource de production.

En cas de doute, demander confirmation.

---

## 6. Modifications du code

Avant une modification importante :

1. comprendre le code existant ;
2. rechercher les dépendances et les appels concernés ;
3. conserver le comportement existant qui n'est pas concerné par la demande ;
4. privilégier une modification minimale plutôt qu'une réécriture inutile.

Après modification :

1. vérifier les fichiers modifiés ;
2. rechercher les éventuelles références impactées ;
3. examiner le diff ;
4. signaler clairement les modifications réalisées ;
5. signaler les points qui n'ont pas pu être testés.

Ne jamais considérer qu'une modification est déployée en production.

---

## 7. Tests

Les tests locaux sans effet de bord sont autorisés.

Ne jamais utiliser une ressource de production pour tester une opération
d'écriture.

Si une fonctionnalité nécessite normalement une écriture en base de données,
modifier le code si demandé mais NE PAS effectuer l'écriture réelle.

Indiquer à l'utilisateur que cette partie doit être testée manuellement dans
un environnement approprié.

---

## 8. Accès Internet

Ne pas envoyer vers un service externe :

- code source propriétaire ;
- credentials ;
- noms d'utilisateurs ;
- données provenant des bases ;
- informations internes à l'entreprise.

Si une recherche Internet est nécessaire, demander l'autorisation lorsque
Codex le requiert et limiter la requête aux informations strictement
nécessaires.

---

## Principe général

Codex dispose d'une autonomie importante sur le CODE contenu dans ce
workspace.

Codex ne dispose d'aucune autonomie pour modifier les DONNÉES ou
l'INFRASTRUCTURE de production.

Si une action peut avoir un effet de bord sur une ressource extérieure au
workspace, demander confirmation avant de l'exécuter.