Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Use Cases — Cerops

Extraits des fichiers de tests (packages/api/test/) qui constituent la spécification exécutable du système.


Acteurs

ActeurDescription
AgriculteurPublie des missions, gère ses parcelles et plans d’action
PiloteAccepte et exécute des missions de drone
AdminGère les datasets RPG, la tarification, les options d’analyse
SystèmeImporte les parcelles RPG, calcule les prix, gère le score pilote

UC-01 : Gestion des parcelles

Acteur principal : Agriculteur

#Cas d’utilisationPréconditionRésultat attendu
1.1Consulter ses parcellesAuthentifiéListe des parcelles ordonnée par date de modification
1.2Créer une parcelle manuellementAuthentifié, géométrie valide (< 500 ha)Parcelle créée avec surface calculée depuis la géométrie
1.3Créer une parcelle avec type de cultureAuthentifiéParcelle créée avec cultureType
1.4Modifier une parcelleAuthentifié, propriétaireNom et/ou type de culture mis à jour
1.5Supprimer une parcelleAuthentifié, propriétaireParcelle supprimée
1.6Accéder à une parcelle RPG activeAuthentifiéAccès autorisé même sans ownership
1.7Revendiquer des parcelles RPGAuthentifié, parcelles non encore revendiquéesParcelles rattachées à l’agriculteur
1.8Consulter la carte (viewport)Authentifié, zoom suffisantGeoJSON des parcelles dans le viewport

Cas d’erreur notables :

  • Parcelle > 500 ha → rejetée
  • Parcelle qui chevauche une parcelle existante de l’utilisateur → rejetée
  • Accès à la parcelle d’un autre utilisateur → FORBIDDEN
  • Parcelle RPG inactive → NOT_FOUND

UC-02 : Marketplace des missions

Acteurs : Agriculteur (publication), Pilote (acceptation/livraison)

#Cas d’utilisationActeurRésultat attendu
2.1Estimer le prix d’une missionAgriculteurPrix total + détail des lignes (base + ha + options)
2.2Créer une missionAgriculteurMission PUBLISHED, prix calculé automatiquement, config de tarification associée
2.3Lister les missions disponiblesPiloteMissions PUBLISHED, filtrées par compatibilité capteurs, prix min/max, distance
2.4Accepter une missionPilote compatibleMission passe à SCHEDULED, pilote assigné
2.5Annuler une mission (pilote)Pilote assignéMission repasse à PUBLISHED, score pilote -2
2.6Annuler une mission (agriculteur)Agriculteur propriétaireMission CANCELLED, score pilote non affecté
2.7Livrer un livrablePilote assigné (mission SCHEDULED ou IN_PROGRESS)Mission DELIVERED, score pilote +1, fichiers stockés
2.8Consulter ses missions (agriculteur)AgriculteurListe de ses missions avec statut, pilote assigné, livrable
2.9Consulter ses missions (pilote)PiloteMissions groupées par date d’acceptation

Cas d’erreur notables :

  • Prix fourni par le client → rejeté (prix calculé côté serveur uniquement)
  • Parcelles appartenant à un autre agriculteur → rejeté
  • Aucun config de tarification publiée → rejeté
  • Deuxième pilote tente d’accepter → CONFLICT
  • Pilote déjà à 5 missions SCHEDULEDFORBIDDEN
  • Pilote sans capteurs requis → FORBIDDEN
  • Score pilote plancher à -20 (ne peut pas descendre plus bas)

UC-03 : Plans d’action

Acteur principal : Agriculteur

#Cas d’utilisationRésultat attendu
3.1Créer un plan d’actionPlan créé, titre unique par utilisateur
3.2Créer une tâche dans un planTâche créée avec statut todo par défaut
3.3Associer une tâche à une parcelleTâche liée à une parcelle de l’utilisateur
3.4Modifier le statut d’une tâcheStatut mis à jour (todoin_progresscompleted)
3.5Réordonner les tâchesrank mis à jour
3.6Définir une échéancedeadline enregistrée
3.7Supprimer un plan d’actionPlan et toutes ses tâches supprimés (cascade)

Cas d’erreur notables :

  • Accès au plan d’action d’un autre utilisateur → FORBIDDEN
  • Association d’une tâche à la parcelle d’un autre utilisateur → FORBIDDEN

UC-04 : Profil pilote

Acteur principal : Pilote

#Cas d’utilisationRésultat attendu
4.1Consulter son profilProfil auto-créé si inexistant, avec liste de drones et capteurs
4.2Mettre à jour son profilChamps scalaires mis à jour
4.3Mettre à jour sa flotte de dronesListe de drones remplacée intégralement
4.4Mettre à jour ses capteursListe de capteurs remplacée intégralement

UC-05 : Import RPG (Admin)

Acteur principal : Admin

#Cas d’utilisationRésultat attendu
5.1Créer un dataset RPGDataset DRAFT créé
5.2Lancer un import par régionJob créé, pipeline asynchrone déclenché (téléchargement → extraction → parsing → import)
5.3Activer un datasetParcelles RPG rendues visibles aux agriculteurs
5.4Archiver un datasetParcelles masquées

UC-06 : Assistant IA agronomique

Acteur principal : Agriculteur

#Cas d’utilisationRésultat attendu
6.1Poser une question agronomiqueRéponse de l’assistant
6.2Soumettre une photo de cultureAnalyse visuelle : diagnostic, causes probables, actions recommandées