358 lines
7.8 KiB
Markdown
358 lines
7.8 KiB
Markdown
# AGENTS.md - ihm_client
|
|
|
|
## Table des matières
|
|
|
|
- [Introduction](#introduction)
|
|
- [Agents fondamentaux](#agents-fondamentaux)
|
|
- [Agents spécialisés frontend](#agents-spécialisés-frontend)
|
|
- [Agents spécialisés WASM](#agents-spécialisés-wasm)
|
|
- [Agents spécialisés tests](#agents-spécialisés-tests)
|
|
- [Agents documentation](#agents-documentation)
|
|
- [Agents open source et CI](#agents-open-source-et-ci)
|
|
- [Agents complémentaires](#agents-complémentaires)
|
|
- [Matrice de coordination](#matrice-de-coordination)
|
|
- [Conclusion](#conclusion)
|
|
|
|
---
|
|
|
|
## Introduction
|
|
|
|
Ce document définit les agents, leurs rôles et leurs responsabilités dans le projet `ihm_client`.
|
|
Chaque agent est assigné à un périmètre clair (frontend, WASM, tests, documentation, CI, gouvernance open source).
|
|
L'objectif est d'assurer une maintenance cohérente de l'interface utilisateur, une traçabilité complète et une exécution fiable des bonnes pratiques.
|
|
Les règles détaillées de réalisation et de contrôle sont précisées dans `.cursor/rules/`.
|
|
|
|
---
|
|
|
|
## Agents fondamentaux
|
|
|
|
### Agent Fondation
|
|
|
|
**Rôle (Responsable)** :
|
|
|
|
- Garantir que toute production est en français.
|
|
- Vérifier l'absence d'exemples de code applicatif dans la base de code.
|
|
- Imposer l'introduction et/ou conclusion dans chaque contenu.
|
|
|
|
**Artefacts :**
|
|
|
|
- Tous fichiers.
|
|
|
|
---
|
|
|
|
### Agent Structure
|
|
|
|
**Rôle (Responsable)** :
|
|
|
|
- Maintenir l'arborescence canonique du projet.
|
|
- Déplacer les documents obsolètes vers `archive/`.
|
|
- Bloquer toute suppression non documentée.
|
|
|
|
**Artefacts :**
|
|
|
|
- `archive/`, `docs/`, `tests/`, `.gitea/`, `CHANGELOG.md`.
|
|
|
|
---
|
|
|
|
## Agents spécialisés frontend
|
|
|
|
### Agent Vue.js
|
|
|
|
**Rôle (Responsable)** :
|
|
|
|
- Maintenir la qualité du code Vue.js.
|
|
- Assurer la cohérence des composants.
|
|
- Optimiser les performances de l'interface.
|
|
|
|
**Artefacts :**
|
|
|
|
- `src/components/`, `src/pages/`, `src/services/`.
|
|
|
|
---
|
|
|
|
### Agent TypeScript
|
|
|
|
**Rôle (Responsable)** :
|
|
|
|
- Maintenir la qualité du code TypeScript.
|
|
- Assurer la cohérence des types.
|
|
- Optimiser la compilation TypeScript.
|
|
|
|
**Artefacts :**
|
|
|
|
- `src/types/`, `tsconfig.json`, `vite.config.ts`.
|
|
|
|
---
|
|
|
|
### Agent UI/UX
|
|
|
|
**Rôle (Responsable)** :
|
|
|
|
- Maintenir la cohérence de l'interface utilisateur.
|
|
- Assurer l'accessibilité.
|
|
- Optimiser l'expérience utilisateur.
|
|
|
|
**Artefacts :**
|
|
|
|
- `src/components/`, `src/pages/`, `src/assets/`.
|
|
|
|
---
|
|
|
|
## Agents spécialisés WASM
|
|
|
|
### Agent Rust
|
|
|
|
**Rôle (Responsable)** :
|
|
|
|
- Maintenir la qualité du code Rust.
|
|
- Assurer la sécurité de la mémoire.
|
|
- Optimiser les performances WASM.
|
|
|
|
**Artefacts :**
|
|
|
|
- `temp-deps/sdk_client/`, `temp-deps/sdk_common/`.
|
|
|
|
---
|
|
|
|
### Agent WASM
|
|
|
|
**Rôle (Responsable)** :
|
|
|
|
- Maintenir la compilation WASM.
|
|
- Assurer l'intégration avec le frontend.
|
|
- Optimiser la taille du bundle WASM.
|
|
|
|
**Artefacts :**
|
|
|
|
- `pkg/`, `scripts/setup-remote-deps.sh`.
|
|
|
|
---
|
|
|
|
### Agent Silent Payments
|
|
|
|
**Rôle (Responsable)** :
|
|
|
|
- Maintenir l'intégration des Silent Payments.
|
|
- Assurer la sécurité des transactions.
|
|
- Optimiser les performances de paiement.
|
|
|
|
**Artefacts :**
|
|
|
|
- `src/services/`, `src/types/sdk_client.d.ts`.
|
|
|
|
---
|
|
|
|
## Agents spécialisés tests
|
|
|
|
### Agent Tests Frontend
|
|
|
|
**Rôle (Responsable)** :
|
|
|
|
- Maintenir la couverture des tests frontend.
|
|
- Assurer la qualité des tests Vue.js.
|
|
- Optimiser l'exécution des tests.
|
|
|
|
**Artefacts :**
|
|
|
|
- `tests/unit/`, `tests/integration/`.
|
|
|
|
---
|
|
|
|
### Agent Tests WASM
|
|
|
|
**Rôle (Responsable)** :
|
|
|
|
- Maintenir la couverture des tests WASM.
|
|
- Assurer la qualité des tests Rust.
|
|
- Optimiser l'exécution des tests WASM.
|
|
|
|
**Artefacts :**
|
|
|
|
- `temp-deps/sdk_client/tests/`.
|
|
|
|
---
|
|
|
|
### Agent Tests E2E
|
|
|
|
**Rôle (Responsable)** :
|
|
|
|
- Maintenir la couverture des tests end-to-end.
|
|
- Assurer la qualité des tests d'intégration.
|
|
- Optimiser l'exécution des tests E2E.
|
|
|
|
**Artefacts :**
|
|
|
|
- `tests/e2e/`, `tests/performance/`.
|
|
|
|
---
|
|
|
|
## Agents documentation
|
|
|
|
### Agent Documentation
|
|
|
|
**Rôle (Responsable)** :
|
|
|
|
- Mettre à jour les fichiers de `docs/` selon l'impact des changements.
|
|
- Maintenir `README.md` comme documentation principale.
|
|
- Produire des REX techniques dans `archive/`.
|
|
|
|
**Artefacts :**
|
|
|
|
- `docs/`, `README.md`, `CHANGELOG.md`.
|
|
|
|
---
|
|
|
|
### Agent API Documentation
|
|
|
|
**Rôle (Responsable)** :
|
|
|
|
- Maintenir la documentation des APIs.
|
|
- Assurer la cohérence des types TypeScript.
|
|
- Optimiser la documentation des interfaces.
|
|
|
|
**Artefacts :**
|
|
|
|
- `docs/API.md`, `src/types/`.
|
|
|
|
---
|
|
|
|
### Agent User Documentation
|
|
|
|
**Rôle (Responsable)** :
|
|
|
|
- Maintenir la documentation utilisateur.
|
|
- Assurer la clarté des guides.
|
|
- Optimiser l'expérience de lecture.
|
|
|
|
**Artefacts :**
|
|
|
|
- `docs/USAGE.md`, `docs/INSTALLATION.md`.
|
|
|
|
---
|
|
|
|
## Agents open source et CI
|
|
|
|
### Agent Open Source
|
|
|
|
**Rôle (Responsable)** :
|
|
|
|
- Maintenir la conformité open source.
|
|
- Assurer la qualité des licences.
|
|
- Optimiser la gouvernance open source.
|
|
|
|
**Artefacts :**
|
|
|
|
- `LICENSE`, `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`.
|
|
|
|
---
|
|
|
|
### Agent CI/CD
|
|
|
|
**Rôle (Responsable)** :
|
|
|
|
- Maintenir la pipeline CI/CD.
|
|
- Assurer la qualité des builds.
|
|
- Optimiser l'automatisation.
|
|
|
|
**Artefacts :**
|
|
|
|
- `.gitea/workflows/`, `scripts/`.
|
|
|
|
---
|
|
|
|
### Agent Security
|
|
|
|
**Rôle (Responsable)** :
|
|
|
|
- Maintenir la sécurité du code.
|
|
- Assurer la qualité des audits de sécurité.
|
|
- Optimiser la gestion des vulnérabilités.
|
|
|
|
**Artefacts :**
|
|
|
|
- `SECURITY.md`, `docs/SECURITY_AUDIT.md`.
|
|
|
|
---
|
|
|
|
## Agents complémentaires
|
|
|
|
### Agent Performance
|
|
|
|
**Rôle (Consulté)** :
|
|
|
|
- Optimiser les performances frontend.
|
|
- Assurer la qualité des métriques.
|
|
- Optimiser l'expérience utilisateur.
|
|
|
|
**Artefacts :**
|
|
|
|
- `src/`, `dist/`.
|
|
|
|
---
|
|
|
|
### Agent Accessibility
|
|
|
|
**Rôle (Consulté)** :
|
|
|
|
- Maintenir l'accessibilité de l'interface.
|
|
- Assurer la conformité WCAG.
|
|
- Optimiser l'expérience pour tous les utilisateurs.
|
|
|
|
**Artefacts :**
|
|
|
|
- `src/components/`, `src/pages/`.
|
|
|
|
---
|
|
|
|
### Agent Internationalization
|
|
|
|
**Rôle (Consulté)** :
|
|
|
|
- Maintenir l'internationalisation.
|
|
- Assurer la qualité des traductions.
|
|
- Optimiser l'expérience multilingue.
|
|
|
|
**Artefacts :**
|
|
|
|
- `src/locales/`, `src/i18n/`.
|
|
|
|
---
|
|
|
|
## Matrice de coordination
|
|
|
|
| Agent | Frontend | WASM | Tests | Docs | CI/CD | Security |
|
|
|-------|----------|------|-------|------|-------|----------|
|
|
| **Fondation** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
|
| **Structure** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
|
| **Vue.js** | 🔴 | ⚪ | ⚪ | ⚪ | ⚪ | ⚪ |
|
|
| **TypeScript** | 🔴 | ⚪ | 🔴 | ⚪ | ⚪ | ⚪ |
|
|
| **UI/UX** | 🔴 | ⚪ | ⚪ | ⚪ | ⚪ | ⚪ |
|
|
| **Rust** | ⚪ | 🔴 | ⚪ | ⚪ | ⚪ | 🔴 |
|
|
| **WASM** | 🔴 | 🔴 | ⚪ | ⚪ | ⚪ | ⚪ |
|
|
| **Silent Payments** | 🔴 | 🔴 | 🔴 | ⚪ | ⚪ | 🔴 |
|
|
| **Tests Frontend** | 🔴 | ⚪ | 🔴 | ⚪ | ⚪ | ⚪ |
|
|
| **Tests WASM** | ⚪ | 🔴 | 🔴 | ⚪ | ⚪ | ⚪ |
|
|
| **Tests E2E** | 🔴 | 🔴 | 🔴 | ⚪ | ⚪ | ⚪ |
|
|
| **Documentation** | ⚪ | ⚪ | ⚪ | 🔴 | ⚪ | ⚪ |
|
|
| **API Documentation** | 🔴 | 🔴 | ⚪ | 🔴 | ⚪ | ⚪ |
|
|
| **User Documentation** | 🔴 | ⚪ | ⚪ | 🔴 | ⚪ | ⚪ |
|
|
| **Open Source** | ⚪ | ⚪ | ⚪ | ⚪ | 🔴 | ⚪ |
|
|
| **CI/CD** | 🔴 | 🔴 | 🔴 | ⚪ | 🔴 | ⚪ |
|
|
| **Security** | 🔴 | 🔴 | 🔴 | ⚪ | ⚪ | 🔴 |
|
|
| **Performance** | 🔴 | 🔴 | ⚪ | ⚪ | ⚪ | ⚪ |
|
|
| **Accessibility** | 🔴 | ⚪ | ⚪ | ⚪ | ⚪ | ⚪ |
|
|
| **Internationalization** | 🔴 | ⚪ | ⚪ | ⚪ | ⚪ | ⚪ |
|
|
|
|
**Légende :**
|
|
- 🔴 **Responsable** - Agent principal pour ce domaine
|
|
- ⚪ **Consulté** - Agent consulté si nécessaire
|
|
- ✅ **Tous** - Applicable à tous les domaines
|
|
|
|
## Conclusion
|
|
|
|
Cette organisation des agents assure une couverture complète du projet `ihm_client` avec des responsabilités claires et une coordination efficace. Chaque agent contribue à maintenir la qualité, la sécurité et la performance de l'interface utilisateur pour les Silent Payments.
|
|
|
|
---
|
|
|
|
**Objectif** : Maintenir `ihm_client` comme une interface utilisateur moderne, sécurisée et performante pour les Silent Payments. 🚀
|