189 lines
7.0 KiB
Markdown
189 lines
7.0 KiB
Markdown
# 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/`.
|