mahdahar/clqms-be
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
clqms-be/openspec/changes/archive/2026-03-08-backend-specs/proposal.md
mahdahar 282c642da6 feat: add OpenSpec workflow, Serena integration, User API, and Specimen delete endpoint 
- Add OpenSpec experimental workflow with commands (opsx-apply, opsx-archive, opsx-explore, opsx-propose)
- Add Serena memory system for project context
- Implement User API (UserController, UserModel, routes)
- Add Specimen delete endpoint
- Update Test definitions and Routes
- Sync API documentation (OpenAPI)
- Archive completed 2026-03-08-backend-specs change
2026-03-09 07:00:12 +07:00

2.8 KiB
Raw Blame History

Why

The CLQMS frontend has several incomplete features marked with TODO comments that block core workflows. Additionally, the sidebar links to Specimens and Users pages that don't exist yet. Completing these TODOs and adding the missing pages will provide a fully functional laboratory management system with complete patient-to-results tracking and user administration capabilities.

What Changes

Backend TODOs (F)

  • Patient Delete: Wire up existing deletePatient() API (currently commented out)
  • Order Detail View: Create modal component to display order details, test list, and status history
  • Barcode Printing: Add print stubs and structure for patient wristbands and specimen labels
  • TestMap Delete: Document API limitation and add error handling for missing TestMapID

New Pages

  • Specimens Page (A): Full CRUD page for specimen tracking with search, list, and detail views
  • Users Page (B): User management interface with CRUD operations

Backend Requirements (Coordinate with clqms01-be)

  • Specimen Delete API: Add DELETE /api/specimen/(:num) endpoint to backend
  • User Management API: Create complete CRUD API for user management:
    • GET /api/users - List users
    • GET /api/users/(:num) - Get user details
    • POST /api/users - Create user
    • PATCH /api/users - Update user
    • DELETE /api/users/(:num) - Delete user

Minor Improvements

  • Update sidebar navigation to point to new pages
  • Add proper error handling for incomplete features

Capabilities

New Capabilities

  • specimen-management: Specimen tracking and management interface
  • user-management: User administration and role management
  • barcode-printing: Barcode generation and printing for patients and specimens
  • order-detail-view: Detailed order inspection with test breakdown

Modified Capabilities

  • patient-management: Add delete functionality to complete CRUD operations

Impact

  • Frontend: 3 new route pages, 2 new modal components, API integrations
  • Backend: New endpoints for specimen delete and user CRUD operations
  • User Experience: Completes core lab workflow from patient registration to results
  • Breaking Changes: None - additive changes only

Dependencies

Backend Changes Required (clqms01-be repo):

Feature Backend Work Status
Patient Delete ✅ Already exists Ready
Specimens ⚠️ Add DELETE endpoint BLOCKS specimen delete
Users ❌ Create full CRUD API BLOCKS users page
Order Detail ✅ Already exists Ready

Coordination Strategy:

  1. Backend team creates specimen delete endpoint
  2. Backend team creates user management API
  3. Frontend implements features as APIs become available
  4. Parallel development possible for non-dependent features