153 lines
4.6 KiB
Markdown
153 lines
4.6 KiB
Markdown
# Finance Workflow - Tests
|
|
|
|
**Date:** 2026-03-14
|
|
**Status:** EN COURS
|
|
|
|
## Tests unitaires - Limitation JWT
|
|
|
|
### Problème identifié
|
|
|
|
Les services `ApprovalService` et `BudgetService` injectent directement `JsonWebToken` via `@Inject`, ce qui rend difficile les tests unitaires purs avec Mockito :
|
|
|
|
```java
|
|
@ApplicationScoped
|
|
public class ApprovalService {
|
|
@Inject
|
|
JsonWebToken jwt; // Injection directe, difficile à mocker
|
|
|
|
public TransactionApprovalResponse approveTransaction(UUID approvalId, ApproveTransactionRequest request) {
|
|
String userEmail = jwt.getClaim("email"); // Dépendance JWT
|
|
UUID userId = UUID.fromString(jwt.getClaim("sub"));
|
|
...
|
|
}
|
|
}
|
|
```
|
|
|
|
### Solutions possibles
|
|
|
|
**Option 1: Tests d'intégration avec @QuarkusTest** (RECOMMANDÉ)
|
|
```java
|
|
@QuarkusTest
|
|
@TestSecurity(user = "admin@test.com", roles = {"ORG_ADMIN"})
|
|
class ApprovalServiceIntegrationTest {
|
|
@Inject
|
|
ApprovalService service;
|
|
|
|
@Test
|
|
void testApprove() {
|
|
// Tests with real JWT injection
|
|
}
|
|
}
|
|
```
|
|
|
|
**Option 2: Refactoring pour dependency injection explicite**
|
|
|
|
Modifier les services pour accepter userId en paramètre :
|
|
```java
|
|
public TransactionApprovalResponse approveTransaction(
|
|
UUID approvalId,
|
|
ApproveTransactionRequest request,
|
|
UUID userId, // Explicit parameter
|
|
String userEmail
|
|
) {
|
|
// No JWT dependency
|
|
}
|
|
```
|
|
|
|
Puis les Resources extraient le JWT et passent les paramètres.
|
|
|
|
**Option 3: Tests via REST endpoints**
|
|
|
|
Tester les fonctionnalités via les endpoints REST avec RestAssured :
|
|
```java
|
|
given()
|
|
.auth().oauth2(token)
|
|
.contentType(ContentType.JSON)
|
|
.body(request)
|
|
.when()
|
|
.post("/api/finance/approvals/{id}/approve", approvalId)
|
|
.then()
|
|
.statusCode(200);
|
|
```
|
|
|
|
### Décision actuelle
|
|
|
|
Pour l'instant, on procède avec :
|
|
1. **Tests de migration Flyway** - Vérifier que V6 s'exécute sans erreur
|
|
2. **Tests manuels via Swagger UI** - Vérifier que les endpoints fonctionnent
|
|
3. **Tests d'intégration REST** (P1) - À créer après validation initiale
|
|
|
|
Les tests unitaires purs des services seront ajoutés en P1 après refactoring si nécessaire.
|
|
|
|
## Tests à effectuer
|
|
|
|
### ✅ P0 - Production Blockers
|
|
|
|
- [ ] **Migration Flyway V6**
|
|
- Exécuter `mvn quarkus:dev` et vérifier les logs Flyway
|
|
- Vérifier que les 4 tables sont créées : transaction_approvals, approver_actions, budgets, budget_lines
|
|
- Vérifier les contraintes CHECK, foreign keys, et indexes
|
|
|
|
- [ ] **Endpoints REST - Swagger UI**
|
|
- Démarrer Quarkus dev: `mvn quarkus:dev`
|
|
- Accéder à http://localhost:8085/q/swagger-ui
|
|
- Tester GET /api/finance/approvals/pending
|
|
- Tester POST /api/finance/approvals (approve/reject)
|
|
- Tester GET /api/finance/budgets
|
|
- Tester POST /api/finance/budgets (create)
|
|
- Tester GET /api/finance/budgets/{id}/tracking
|
|
|
|
- [ ] **Intégration mobile-backend**
|
|
- Lancer le backend (port 8085)
|
|
- Lancer l'app mobile Flutter en dev
|
|
- Naviguer vers Finance Workflow
|
|
- Vérifier que les approbations se chargent
|
|
- Vérifier que les budgets se chargent
|
|
- Tester une approbation end-to-end
|
|
- Tester la création d'un budget
|
|
|
|
### P1 - Post-Production
|
|
|
|
- [ ] **Tests d'intégration RestAssured**
|
|
- ApprovalResourceIntegrationTest (E2E workflow)
|
|
- BudgetResourceIntegrationTest (CRUD complet)
|
|
|
|
- [ ] **Tests unitaires entités**
|
|
- TransactionApprovalTest (méthodes métier: hasAllApprovals, isExpired, countApprovals)
|
|
- BudgetTest (méthodes métier: recalculateTotals, getRealizationRate, isOverBudget)
|
|
|
|
- [ ] **Tests repositories**
|
|
- TransactionApprovalRepositoryTest (requêtes personnalisées)
|
|
- BudgetRepositoryTest (filtres, recherches)
|
|
|
|
### P2 - Couverture complète
|
|
|
|
- [ ] Refactoring services pour faciliter tests unitaires
|
|
- [ ] Tests unitaires services (après refactoring)
|
|
- [ ] Tests de charge (performance)
|
|
- [ ] Tests de sécurité (autorisations)
|
|
|
|
## Commandes utiles
|
|
|
|
```bash
|
|
# Démarrer Quarkus en mode dev
|
|
cd unionflow/unionflow-server-impl-quarkus
|
|
mvn quarkus:dev
|
|
|
|
# Vérifier migration Flyway
|
|
tail -f target/quarkus.log | grep Flyway
|
|
|
|
# Exécuter tests d'intégration (quand créés)
|
|
mvn test -Dtest=ApprovalResourceIntegrationTest
|
|
|
|
# Générer rapport de couverture
|
|
mvn clean verify
|
|
# Rapport: target/site/jacoco/index.html
|
|
```
|
|
|
|
## Notes
|
|
|
|
- Les fichiers de tests créés (`ApprovalServiceTest.java`, `BudgetServiceTest.java`) ne compilent pas actuellement à cause des dépendances JWT
|
|
- Ils peuvent servir de base pour des tests d'intégration futurs
|
|
- La priorité P0 est de valider que le backend fonctionne (migration + endpoints)
|