[#ED-1] Ajout des API de lecture bovin (#2)
All checks were successful
Auto Tag Develop / tag (push) Successful in 6s
Build Release Artefact / build (push) Successful in 39s

| Numéro du ticket | Titre du ticket |
|------------------|-----------------|
|                  |                 |

## Description de la PR

## Modification du .env

## Check list

- [ ] Pas de régression
- [x] TU/TI/TF rédigée
- [x] TU/TI/TF OK
- [ ] CHANGELOG modifié

Reviewed-on: #2
Co-authored-by: tristan <tristan@yuno.malio.fr>
Co-committed-by: tristan <tristan@yuno.malio.fr>
This commit was merged in pull request #2.
This commit is contained in:
2026-04-21 08:14:37 +00:00
committed by Autin
parent 16798d9abb
commit f757822f36
29 changed files with 3416 additions and 208 deletions

File diff suppressed because it is too large Load Diff

188
docs/ws-catalog.md Normal file
View File

@@ -0,0 +1,188 @@
# Catalogue des WebServices EDNOTIF
Inventaire des opérations exposées par les WSDL embarqués dans
`resources/ednotif-ws/`, avec le statut d'implémentation et une
recommandation de priorisation.
## Légende statut
- **Implémenté** — opération couverte par le bundle
- **À faire** — opération pertinente non encore implémentée
- **Optionnel** — opération hors périmètre probable, à confirmer selon le consommateur
---
## 1. wsIpBNotif — Notifications IPG Bovin
WS métier principal : déclarations réglementaires d'un cheptel bovin auprès de l'IPG.
### Lecture
| Opération | Statut | Description probable |
|---|---|---|
| `IpBGetDossierAnimal` | Implémenté | Dossier complet d'un bovin (identifications, mouvements, parents…) |
| `IpBGetInventaire` | Implémenté | Inventaire des animaux présents sur l'exploitation |
| `IpBGetRetourDossiers` | Implémenté | Retours de traitement des notifications envoyées |
| `IpBGetSortiesPresumees` | Implémenté | Animaux sortis selon l'IPG mais non déclarés par l'éleveur |
### Écriture
| Opération | Statut | Description probable |
|---|---|---|
| `IpBCreateEntree` | À faire | Déclaration d'entrée d'un bovin sur l'exploitation |
| `IpBCreateSortie` | À faire | Déclaration de sortie (vente, mort, abattage…) |
| `IpBCreateNaissance` | À faire | Déclaration de naissance |
| `IpBCreateMortNe` | À faire | Déclaration de mort-né |
| `IpBCreateAnimalEchange` | À faire | Échange intra-UE |
| `IpBCreateAnimalImporte` | À faire | Import pays tiers |
| `IpBCreateAvisAnimalImporte` | À faire | Avis d'import |
| `IpBCreateRebouclage` | À faire | Rebouclage / remplacement de boucle |
| `IpBCreateCommandeBoucles` | À faire | Commande de boucles |
| `IpBCreateInsemination` | À faire | Déclaration d'insémination |
---
## 2. wsDmB\* — Déclarations de Mouvement Bovin
Famille orientée gestion des mouvements / transporteurs.
### wsDmBConsultation
- `DmBConsultationGetListeDonneesIT` — consultation de données (IT = identifiants traces ?)
- `DmBConsultationGetListeStatutDeplacement` — statuts de déplacement
### wsDmBGestion
- `DmBGestionCreateDroitAccesListeAnimalActeur` — gestion droits d'accès
- `DmBGestionCreateListeICA` — création listes ICA (information chaîne alimentaire)
### wsDmBListe
- `DmBListeCreateListeBovins` / `DmBListeGetListeBovins` — listes de bovins (lots)
### wsDmBTransport
- `DmBTransportCreateChargement` — chargement camion
- `DmBTransportCreateDechargement` — déchargement camion
---
## 3. wsMdBEdel — Maîtrise des Données Bovin (Edel)
Consultation en lecture seule : génétique, lactation, IA, races.
| Opération | Rôle |
|---|---|
| `MdBGetDonneesGenetiquesAnimales` | Données génétiques d'animaux |
| `MdBGetDonneesMalesPublics` | Catalogue mâles reproducteurs publics |
| `MdBGetDonneesOrganismeHabilite` | Référentiel organismes habilités |
| `MdBGetDonneesOrganismeTiers` | Référentiel organismes tiers |
| `ClBGetDonneesCL` | Contrôle laitier |
| `CpBGetDonneesCPB` | Contrôle de performances bouchères |
| `IaBGetDonneesIA` | Données d'insémination |
| `OsBGetDonneesRAC` | Données race (RAC = race certifiée ?) |
| `TkBGetDonneesTE` | Transfert embryonnaire |
| `VaBGetDonneesCPV` | Contrôle performances veaux (?) |
---
## 4. wsMdCEdel — Maîtrise des Données Caprin
Équivalent caprin : CRUD + reproduction + lactation. 15 opérations (`MdCCreate*` pour l'écriture, `MdCGet*` avec variantes `MAJ` pour les deltas).
| Groupe | Opérations |
|---|---|
| Caprin | `MdCCreateCaprin`, `MdCGetDonneesCaprin`, `MdCGetDonneesCaprinMAJ` |
| Reproduction | `MdCCreateSaillie`, `MdCCreateFinGestation`, `MdCGetFinGestation[/MAJ]`, `MdCGetEvenementReproduction[/MAJ]` |
| Mouvement | `MdCCreateMouvement` |
| Contrôle laitier | `MdCGetCLDonneesBrutes[/MAJ]`, `MdCGetCLDonneesElaborees[/MAJ]` |
| Contrats | `MdCGetContratsExploitation` |
---
## 5. wsIpEdel — Identification Pérenne Edel
- `IpGetDonneesExploitation` — données descriptives de l'exploitation
---
## 6. wsMrAde — Échanges ICAR
Conforme aux standards ICAR (flux laitiers internationaux).
- `GetHerdList`
- `UpdateAnimal`
- `UpdateDevice`
- `UpdateLivestockLocation`
- `UpdateMilkingResults`
---
## 7. WsAnnuaire — Annuaire Guichet
Métadonnées techniques du guichet (pas du métier).
- `tkGetServices` — liste des WS disponibles
- `tkGetVersionsService` — versions d'un WS
- `tkGetOperationsServiceVersion` — opérations d'une version
- `tkGetUrl` — URL d'un service
---
## Recommandation de priorisation
Proposition d'ordre, à valider selon le périmètre réel du consommateur.
### Phase 1 — Compléter le bovin (priorité haute)
Continuer sur **wsIpBNotif**, en commençant par la **lecture** :
1. `IpBGetInventaire` — donne immédiatement la liste du cheptel, utile pour toute UI
2. `IpBGetRetourDossiers` — indispensable pour savoir si les notifs passent côté IPG
3. `IpBGetSortiesPresumees` — flux de rapprochement éleveur ↔ IPG
**Raison** : le dossier animal seul est peu utile sans l'inventaire qui permet de savoir *pour quels animaux* appeler `getAnimalFile`. Et sans `RetourDossiers`, toute écriture future est aveugle.
### Phase 2 — Écriture bovin (notifications obligatoires)
Implémenter les déclarations **dans l'ordre des cycles de vie d'un animal** :
4. `IpBCreateNaissance`
5. `IpBCreateEntree` / `IpBCreateSortie`
6. `IpBCreateMortNe`
7. `IpBCreateRebouclage` / `IpBCreateCommandeBoucles`
8. `IpBCreateAnimalEchange` / `IpBCreateAnimalImporte` / `IpBCreateAvisAnimalImporte` (si imports/échanges dans le périmètre)
9. `IpBCreateInsemination` (si non couvert par un autre outil)
### Phase 3 — Mouvements / transport
Si le consommateur gère du transport ou des lots :
10. `wsDmBListe` (lots bovins)
11. `wsDmBTransport` (chargement/déchargement)
12. `wsDmBConsultation` et `wsDmBGestion` selon besoin
### Phase 4 — Référentiels génétiques (optionnel)
Si le consommateur fait de la sélection / génétique :
13. `wsMdBEdel` — lectures ponctuelles, ne justifient une implémentation que s'il y a un usage métier concret
### Phase 5 — Caprin / ICAR (optionnel)
À activer uniquement si multi-espèces ou conformité ICAR requise.
### Hors priorité
- **wsIpEdel** : 1 op, à implémenter *en passant* si besoin ponctuel
- **WsAnnuaire** : utile pour du diagnostic / supervision, pas pour le métier
---
## Découpage structurel proposé
Pour garder un code cohérent, reproduire le pattern existant (`src/Bovin/`) par domaine :
```
src/
├── Auth/ (existant)
├── Bovin/ (IpBNotif + IpEdel exploitation)
├── Mouvement/ (DmB*)
├── Genetique/ (MdBEdel, optionnel)
├── Caprin/ (MdCEdel, optionnel)
├── Icar/ (MrAde, optionnel)
├── Annuaire/ (WsAnnuaire, optionnel)
└── Shared/ (existant)
```
Chaque domaine expose une `*ApiInterface` publique + une implémentation `readonly`, avec ses DTOs et mappers dédiés. Le `TokenProvider` et `SoapClientFactory` restent partagés via `Shared/`.