AndreFerreira5/starranja
1
0
Fork 0
Code Issues 3 Pull requests Projects Releases Packages Wiki Activity Actions

Implement Routes for WorkOrders #167

New issue
Closed
opened 2025-12-11 17:39:46 +00:00 by GFMpt13 · 0 comments
GFMpt13 commented 2025-12-11 17:39:46 +00:00 (Migrated from github.com)
Copy link

Implement the REST endpoints for the WorkOrder entity, connecting the API layer to the existing WorkOrderRepo.

This includes handling the creation flow (triggering auto-numbering), enforcing Business Rule RB02 (one active WO per vehicle), and advanced filtering.

Technical Requirements:

  • File: src/routers/work_orders.py
  • Prefix: /work-orders
  • Tags: ["Work Orders"]
  • Dependency: Inject WorkOrderRepo using Depends().
  • Testing: Use AsyncMock to mock the repository layer. Do not connect to the real database.

Exception Mapping Strategy:

  • WorkOrderNotFoundError -> 404 Not Found
  • ActiveWorkOrderExistsError -> 409 Conflict (Message: "This vehicle already has an active work order")
  • WorkOrderNumberConflictError -> 500 Internal Server Error (This is a race condition/system error)
  • WorkOrderDatabaseError -> 500 Internal Server Error

TDD Checklist:

Implement the REST endpoints for the WorkOrder entity, connecting the API layer to the existing WorkOrderRepo. This includes handling the creation flow (triggering auto-numbering), enforcing Business Rule RB02 (one active WO per vehicle), and advanced filtering. Technical Requirements: - File: src/routers/work_orders.py - Prefix: /work-orders - Tags: ["Work Orders"] - Dependency: Inject WorkOrderRepo using Depends(). - Testing: Use AsyncMock to mock the repository layer. Do not connect to the real database. Exception Mapping Strategy: - WorkOrderNotFoundError -> 404 Not Found - ActiveWorkOrderExistsError -> 409 Conflict (Message: "This vehicle already has an active work order") - WorkOrderNumberConflictError -> 500 Internal Server Error (This is a race condition/system error) - WorkOrderDatabaseError -> 500 Internal Server Error TDD Checklist: - [x] #170 - [x] #171 - [x] #172
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
routes-invoices
No results found.
Labels
Clear labels   
CI/CD

   
MongoDB

   
PostgreSQL

   
api

   
authentication

   
bug

Something isn't working

  
documentation

Improvements or additions to documentation

  
duplicate

This issue or pull request already exists

  
enhancement

New feature or request

  
example issue

issue that aims to show how to create issues

  
fix

   
good first issue

Good for newcomers

  
help wanted

Extra attention is needed

  
high-level requirement

   
infrastructure

   
invalid

This doesn't seem right

  
low-level requirement

   
medium-level requirement

   
question

Further information is requested

  
security

   
test

   
wontfix

This will not be worked on

No labels
CI/CD
MongoDB
PostgreSQL
api
authentication
bug
documentation
duplicate
enhancement
example issue
fix
good first issue
help wanted
high-level requirement
infrastructure
invalid
low-level requirement
medium-level requirement
question
security
test
wontfix
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
AndreFerreira5/starranja#167
No description provided.