BoursePython/AGENTS.md

# AGENTS.md — Projet Bourse

## Description du projet

Application de gestion boursière permettant :

* le suivi des actions et titres financiers ;
* la gestion des ordres d'achat et de vente ;
* l'importation de données financières ;
* la consultation via une interface web et des API.

Le projet doit rester maintenable, sécurisé et compatible avec l'environnement Docker existant.

---

# Architecture technique

## Environnement

Système de développement :

* Ubuntu Linux
* Python 3.x
* environnement virtuel `.venv`
* Docker / Docker Compose

## Technologies principales

Backend :

* Python
* Flask
* API REST

Base de données :

* MySQL 8
* phpMyAdmin pour administration

Frontend :

* HTML
* CSS 
* JavaScript
* Tailwind

Déploiement :

* Docker
* conteneurs séparés pour application et base de données

---

# Règles générales de développement

## Avant toute modification

Toujours :

1. analyser le code existant ;
2. expliquer la cause du problème ;
3. proposer une modification ;
4. attendre validation avant les changements importants.

Ne jamais réécrire une partie complète du projet sans justification.

---

# Python

Respecter :

* PEP8 ;
* code lisible et commenté en Français ;
* fonctions courtes ;
* gestion correcte des exceptions.

Éviter :

* duplication de code ;
* variables globales inutiles ;
* modifications qui cassent l'existant.

Toujours utiliser l'environnement virtuel :

```
.venv
```

---

# Flask

Respecter l'organisation actuelle du projet.

Avant modification :

* identifier les routes existantes ;
* vérifier les dépendances ;
* vérifier les appels frontend/API.

Les nouvelles routes doivent :

* avoir une validation des entrées ;
* retourner des erreurs explicites ;
* utiliser les codes HTTP appropriés.

---

# Base de données MySQL

Règles :

* ne jamais supprimer une table sans confirmation ;
* ne jamais modifier une colonne existante sans vérifier les impacts ;
* toujours proposer une migration SQL.

Respecter les conventions :

* noms de tables en minuscules ;
* clés primaires explicites ;
* index sur les recherches fréquentes.

Avant une requête SQL complexe :

* expliquer son fonctionnement ;
* vérifier les performances.

---

# Données financières

Attention aux données :

* ticker ;
* ISIN ;
* exchange ;
* pays ;
* devise ;
* cours ;
* ordres.

Ne jamais modifier automatiquement une donnée financière sans conserver la valeur précédente si nécessaire.

---

# Docker

Avant modification :

Vérifier :

```
docker ps
docker compose ps
```

Ne jamais :

* supprimer un volume Docker ;
* supprimer une base ;
* reconstruire tous les conteneurs sans raison.

Toujours expliquer :

* quel conteneur est modifié ;
* pourquoi ;
* comment revenir en arrière.

---

# Tests

Après chaque modification importante :

Tester :

* démarrage de l'application ;
* connexion MySQL ;
* appels API ;
* affichage frontend.

Vérifier les logs :

```
docker logs <container>
```

---

# Style de réponse attendu de l'IA

Quand tu analyses ce projet :

1. commence par expliquer ce que tu observes ;
2. indique les fichiers concernés ;
3. propose une solution ;
4. donne les commandes exactes à exécuter.

Ne pas modifier plusieurs fichiers simultanément sans expliquer pourquoi.

---

# Priorités du projet

Ordre des priorités :

1. stabilité ;
2. conservation des données ;
3. sécurité ;
4. performances ;
5. nouvelles fonctionnalités.

---

# Modèle IA utilisé

Le projet utilise OpenCode avec Ollama local :

Modèle principal :

```
qwen2.5-coder:32b
```

L'IA doit privilégier :

* compréhension du code existant ;
* explications techniques ;
* modifications minimales ;
* solutions compatibles avec l'architecture actuelle.