Auto-generated from all feature plans. Last updated: 2025-12-23
Sign in to like and favorite skills
Auto-generated from all feature plans. Last updated: 2025-12-23
src/ tests/
npm test && npm run lint
@if@forINTERDIT:
mastermaingh pr mergeOBLIGATOIRE: Toujours suivre ce workflow:
git checkout -b feature/nom-descriptifgit push -u origin feature/nom-descriptifgh pr creategit checkout master && git pull# ❌ INTERDIT git commit -m "feat: something" git push origin master gh pr merge 123 # JAMAIS merger soi-même! # ✅ CORRECT git checkout -b feature/dark-mode git add -A git commit -m "feat: implement dark mode" git push -u origin feature/dark-mode gh pr create --title "feat: dark mode" --body "..." # STOP ICI - L'utilisateur mergera la PR
RAPPEL: Cette règle s'applique à TOUTES les modifications, même les plus petites.
INTERDIT: Ne JAMAIS utiliser
@RequestHeader// ❌ INTERDIT - Ancienne méthode @GetMapping("/example") public ResponseEntity<?> example( @RequestHeader("X-User-Id") String userId, @RequestHeader("X-Username") String username, @RequestHeader("X-User-Role") String role) { ... }
OBLIGATOIRE: Toujours utiliser
@AuthenticationPrincipal GatewayUserPrincipal// ✅ CORRECT - Nouvelle méthode import com.trucktrack.common.security.GatewayUserPrincipal; import org.springframework.security.core.annotation.AuthenticationPrincipal; @GetMapping("/example") public ResponseEntity<?> example( @AuthenticationPrincipal GatewayUserPrincipal principal) { String userId = principal.userId(); String username = principal.username(); String role = principal.role(); String groups = principal.groups(); // comma-separated UUIDs // ... }
private String getUserId(GatewayUserPrincipal principal) { return principal != null ? principal.userId() : "anonymous"; } private String getUsername(GatewayUserPrincipal principal) { return principal != null ? principal.username() : "anonymous"; } private String getUserRole(GatewayUserPrincipal principal) { return principal != null ? principal.role() : "GUEST"; }
INTERDIT: Appels directs entre services (bypass du gateway)
OBLIGATOIRE: Passer par l'API Gateway avec
SERVICE_ACCOUNT_JWTgateway.service-tokenPOST /admin/users/service-tokenIMPORTANT: Pour tout développement frontend Angular, TOUJOURS consulter et respecter:
frontend/ANGULAR_CONVENTIONS.mdSignal Inputs: Utiliser
input()@Input()readonly items = input<Item[]>([]); readonly id = input.required<string>();
Signal Outputs: Utiliser
output()@Output()readonly clicked = output<void>();
Modern Control Flow: Utiliser
@if@for@switch*ngIf*ngFor*ngSwitch@if (condition()) { ... } @for (item of items(); track item.id) { ... }
Injection: Utiliser
inject()private readonly http = inject(HttpClient);
Standalone Components: Tous les composants doivent être
standalone: trueOnPush: Utiliser
ChangeDetectionStrategy.OnPushStructure des fichiers de composant - JAMAIS inline:
.tscomponent-name.component.tscomponent-name.component.htmlcomponent-name.component.scss// ❌ INTERDIT - Template/styles inline @Component({ selector: 'app-example', template: `<div>...</div>`, styles: [`...`] }) // ✅ CORRECT - Fichiers séparés @Component({ selector: 'app-example', templateUrl: './example.component.html', styleUrls: ['./example.component.scss'] })
NgRx Store - TOUJOURS privilégier le store:
StoreFacade// ❌ INTERDIT - Appel API inutile ngOnInit() { this.authService.getUserProfile().subscribe(user => ...); } // ✅ CORRECT - Données du store readonly user = this.facade.currentUser;
facade.currentUserfacade.trucksComplete trip lifecycle management for dispatchers, fleet managers, and drivers.
PENDING → ASSIGNED → IN_PROGRESS → COMPLETED ↓ ↓ CANCELLED ←─────────┘
Admin Endpoints (
/admin/tripsGET /admin/tripsGET /admin/trips/{id}POST /admin/tripsPUT /admin/trips/{id}POST /admin/trips/{id}/assignPOST /admin/trips/{id}/reassignPOST /admin/trips/{id}/cancelGET /admin/trips/{id}/historyGET /admin/trips/statsGET /admin/trips/analyticsDriver Endpoints (
/location/v1/tripsGET /myGET /{id}POST /{id}/startPOST /{id}/completeTripService.javaAdminTripController.javaTripController.javaTrip.javaTripAnalyticsDTO.javaTripListComponentTripDetailComponentTripStatsComponentTripsScreenTripDetailScreen