Skip to content

SecureTrack_Backlog

ulruchdev edited this page Mar 29, 2026 · 1 revision

# SecureTrack Logistics – Backlog Jira-Ready

Version : 1.1 (ultra-granulaire)
Date : 29 mars 2026
DoD (Definition of Done) pour CHAQUE tâche : Code compilé, testé localement, commit signé, PR créée, documentation mise à jour.

EPIC 1 – Core Logistics Engine (Semaines 1-2)

US-001 – Enregistrer un nouveau colis

Tâches (chaque tâche = < 1h) :

  • Créer la classe d’entité Package.java (avec @Entity, @Id, Lombok)
  • Ajouter les champs : packageId, description, weight, fragile, status, createdAt, updatedAt
  • Créer l’enum PackageStatus.java (CREATED, IN_TRANSIT, AT_CHECKPOINT, DELIVERED, BLOCKED)
  • Créer l’interface PackageRepository.java (extends JpaRepository)
  • Créer le DTO PackageCreateRequest.java + Bean Validation (@NotBlank, @Positive, etc.)
  • Créer le DTO PackageResponse.java
  • Créer la classe mapper PackageMapper.java (MapStruct)
  • Implémenter la méthode create dans PackageService.java
  • Ajouter @Service et @Transactional sur PackageService
  • Implémenter le endpoint POST /api/v1/packages dans PackageController.java
  • Ajouter @RestController et @RequestMapping
  • Écrire 3 tests unitaires pour PackageService (JUnit 5 + Mockito) – cas nominal + 2 erreurs
  • Ajouter le Dockerfile pour le service
  • Ajouter le service au docker-compose.yml (port 8081)

US-002 – Consulter un colis par ID

Tâches :

  • Ajouter méthode findById dans PackageRepository
  • Ajouter méthode getById dans PackageService
  • Implémenter GET /api/v1/packages/{id} dans PackageController
  • Gérer exception 404 avec ProblemDetail
  • Ajouter 2 tests unitaires

(Et ainsi de suite pour US-003, US-004, US-005 – chaque CRUD est découpé en 10-12 tâches minuscules identiques.)

US-006 à US-007 – Gestion des lieux (LocationService – MongoDB)

Même découpage ultra-granulaire (entity, repository Mongo, DTO, mapper, controller, FeignClient, etc.)

US-008 – Enregistrer un passage sécurisé à un checkpoint

Même niveau de découpage + tâches spécifiques Spring Security Basic Auth et Feign.

EPIC 2 – Security & Governance (Semaine 3)

EPIC 3 – Real-time Intelligence (Semaine 4)

(Toutes les User Stories seront découpées de la même façon quand nous y arriverons.)

Labels Jira : backend, database, docker, testing, documentation, security
Components : PackageService, LocationService, SecurityCheckpointService, TrackingService