clqms-be/openspec/changes/archive/2026-03-08-backend-specs/tasks.md

0. Backend Coordination (clqms01-be repo)

These backend changes must be completed before dependent frontend tasks:

• 0.1 Add Specimen delete endpoint to Routes.php
• 0.2 Implement SpecimenController::delete() method
• 0.3 Create UserController with CRUD methods
• 0.4 Create UserModel for database operations
• 0.5 Add user routes to Routes.php
• 0.6 Test backend endpoints with Postman/curl

1. Backend TODOs - Patient Delete

• 1.1 Import deletePatient function in patients/+page.svelte
• 1.2 Uncomment delete API call in handleDelete function
• 1.3 Add error handling for delete operation
• 1.4 Test patient delete functionality

2. Backend TODOs - Order Detail View

• 2.1 Create OrderDetailModal.svelte component
• 2.2 Add order header display (number, date, status, patient)
• 2.3 Add test list display with status indicators
• 2.4 Add status history timeline
• 2.5 Wire up modal to order list click handler
• 2.6 Test order detail modal

3. Backend TODOs - Barcode Printing Structure

• 3.1 Create barcode.js utility file with print functions
• 3.2 Add printPatientWristband stub function
• 3.3 Add printSpecimenLabel stub function
• 3.4 Wire up barcode printing to patient order list
• 3.5 Wire up barcode printing to orders page
• 3.6 Test print dialog opens correctly

4. Backend TODOs - TestMap Delete Documentation

• 4.1 Add informative error message for TestMap delete limitation
• 4.2 Document API limitation in code comments
• 4.3 Add console warning with explanation

5. Specimens Page

• 5.1 Create specimens API client file (src/lib/api/specimens.js)
• 5.2 Create specimens/+page.svelte route
• 5.3 Add specimen search/filter bar
• 5.4 Add specimen data table with columns
• 5.5 Create SpecimenFormModal component
• 5.6 Implement specimen creation
• 5.7 Implement specimen editing
• 5.8 Implement specimen deletion [BLOCKED: Requires task 0.1-0.2]
• 5.9 Create SpecimenDetailModal component
• 5.10 Wire up detail view
• 5.11 Test full specimen CRUD workflow

6. Users Page

• 6.1 Create users API client file (src/lib/api/users.js)
• 6.2 Create master-data/users/+page.svelte route [BLOCKED: Requires task 0.3-0.5]
• 6.3 Add user search functionality [BLOCKED: Requires task 0.3-0.5]
• 6.4 Add user data table [BLOCKED: Requires task 0.3-0.5]
• 6.5 Create UserFormModal component [BLOCKED: Requires task 0.3-0.5]
• 6.6 Implement user creation [BLOCKED: Requires task 0.3-0.5]
• 6.7 Implement user editing [BLOCKED: Requires task 0.3-0.5]
• 6.8 Implement user deletion with self-delete prevention [BLOCKED: Requires task 0.3-0.5]
• 6.9 Test user management workflow [BLOCKED: Requires task 0.3-0.5]

7. Navigation Updates

• 7.1 Verify specimens link in sidebar works
• 7.2 Verify users link in sidebar works [BLOCKED: Requires task 6.x]
• 7.3 Update any broken navigation paths
• 7.4 Test all navigation flows [PARTIALLY BLOCKED]

8. Integration & Testing

• 8.1 Run development server
• 8.2 Test patient delete end-to-end
• 8.3 Test order detail modal
• 8.4 Test barcode print dialogs
• 8.5 Test specimens page CRUD [PARTIALLY BLOCKED: Delete pending backend]
• 8.6 Test users page CRUD [BLOCKED: Pending backend]
• 8.7 Verify no console errors
• 8.8 Code review and cleanup

9. Deployment

• 9.1 Coordinate backend deployment
• 9.2 Deploy frontend changes
• 9.3 Verify all features in production
• 9.4 Update API documentation