# AkuXfer Back-office — Changelog v2.1

## Nouvelles fonctionnalités : Gestion des demandes clients portail

### 🆕 Module "Demandes Clients" (back-office)

#### Accès
- Menu latéral : **Demandes Clients** (avec compteur rouge d'urgences)
- URL : `/transactions/requests`
- Permissions requises : module `client_requests`, action `view`

#### Actions disponibles par l'agent

**Étape 1 — Taxation** (`en_attente` → `taxe`)
- Saisir le taux de change (pré-rempli depuis `exchange_rates`)
- Saisir le % de frais (pré-rempli depuis `fee_rules`)
- Frais fixes optionnels
- Calcul live du montant reçu
- Message optionnel au client
- Notification automatique envoyée au client portail

**Étape 2 — Validation** (`docs_soumis` → `valide`)
- Visualisation de la facture et preuve de versement soumises par le client
- Bouton **Valider** → crée automatiquement la transaction dans AkuXfer
  - Copie les fichiers vers `uploads/invoices/` et `uploads/proofs/`
  - Lie la demande à la transaction via `transaction_id`
  - Notifie le client avec la référence AkuXfer
- Bouton **Rejeter** → avec motif obligatoire (notifie le client)

#### Alertes tableau de bord
- Bandeau orange : demandes en attente de taxation
- Bandeau violet : demandes avec documents à valider

#### Fichiers ajoutés/modifiés
- `src/models/ClientRequestAgentModel.php` — Nouveau
- `src/controllers/ClientRequestController.php` — Nouveau
- `src/views/client_requests/index.php` — Nouveau
- `src/views/client_requests/show.php` — Nouveau
- `database/migration_v2.1_client_submissions.sql` — Nouveau
- `public/index.php` — Routes `/transactions/requests/*` ajoutées
- `src/views/layouts/header.php` — Lien nav + badge compteur urgences
- `src/views/dashboard/index.php` — Alertes demandes prioritaires
- `src/controllers/DashboardController.php` — Stats injectées
- `public/uploads/client_requests/` — Dossier réception documents (créé)

### Permissions ajoutées
```sql
-- module: client_requests
-- actions: view, tax, validate, manage
-- rôles: super_admin, admin, manager, agent
```
(Ajoutées automatiquement par la migration v2.1)

### Migration SQL requise
```
database/migration_v2.1_client_submissions.sql
```