3.7 KiB
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 :
- analyser le code existant ;
- expliquer la cause du problème ;
- proposer une modification ;
- 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 :
- commence par expliquer ce que tu observes ;
- indique les fichiers concernés ;
- propose une solution ;
- donne les commandes exactes à exécuter.
Ne pas modifier plusieurs fichiers simultanément sans expliquer pourquoi.
Priorités du projet
Ordre des priorités :
- stabilité ;
- conservation des données ;
- sécurité ;
- performances ;
- 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.