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

Implement Routes for Clients #173

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

Implement the REST endpoints for the Client entity, connecting the API layer to the existing ClientRepo.

The router must handle standard CRUD operations and specific lookups (by NIF/Email). Crucially, it must map the custom exceptions raised by the repository (e.g., DuplicateClientNIFError) to appropriate HTTP Status Codes.

Technical Requirements:

  • File: src/routers/clients.py
  • Prefix: /clients
  • Tags: ["Clients"]
  • Dependency: Inject ClientRepo using Depends().
  • Testing: Use AsyncMock to mock the repository layer. Do not connect to the real database.

Exception Mapping Strategy:

  • ClientNotFoundError -> 404 Not Found
  • DuplicateClientNIFError -> 409 Conflict
  • DuplicateClientEmailError -> 409 Conflict
  • ClientDatabaseError -> 500 Internal Server Error

TDD Checklist:

Implement the REST endpoints for the Client entity, connecting the API layer to the existing ClientRepo. The router must handle standard CRUD operations and specific lookups (by NIF/Email). Crucially, it must map the custom exceptions raised by the repository (e.g., DuplicateClientNIFError) to appropriate HTTP Status Codes. Technical Requirements: - File: src/routers/clients.py - Prefix: /clients - Tags: ["Clients"] - Dependency: Inject ClientRepo using Depends(). - Testing: Use AsyncMock to mock the repository layer. Do not connect to the real database. Exception Mapping Strategy: - ClientNotFoundError -> 404 Not Found - DuplicateClientNIFError -> 409 Conflict - DuplicateClientEmailError -> 409 Conflict - ClientDatabaseError -> 500 Internal Server Error TDD Checklist: - [x] #174 - [x] #175 - [x] #176
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#173
No description provided.