-
Type:
Task
-
Resolution: Done
-
Priority:
High
-
Affects Version/s: None
-
None
-
Sprint 56, Sprint 57, STOP TB Sprint 8, STOP TB Sprint 9
-
STOP TB
-
UAT
Title: Backend APIs for Drug Master List and Local Stock Management
Description:
Implement backend support for Drug Master List and stock management in StopTB.
Requirements
1. Drug Master List API
- Create a GET API to fetch the Drug Master List from the local server.
- This API should be called immediately after user login.
- The API should return the following details for each drug:
-
- Drug ID
-
- Drug Name
-
- Dose
-
- Available Quantity
-
- (Any additional required fields)
2. Prescription Submission
- When the Nurse submits a prescription, the existing Prescription Submit API will send:
-
- Drug ID
-
- Dispensed Quantity
- After processing the request, the backend should:
-
- Deduct the dispensed quantity from the available stock.
-
- Maintain and update the stock on the local server.
-
- Return the latest available quantity for each submitted drug in the API response.
Acceptance Criteria
- Drug Master List API returns all active drugs with the latest stock.
- Drug Master List API is called after successful user login.
- Prescription Submit API accepts Drug ID and Dispensed Quantity.
- Backend updates the stock after every successful prescription submission.
- Updated available quantity is returned in the Prescription Submit API response.
- Stock is maintained and calculated on the local server.
- Proper validation should be implemented for insufficient stock.
Nurse Prescription & Inventory Management
Nurse Prescription Management
- In the General OPD section, the nurse shall be able to prescribe and add OTC (Over-the-Counter) medicines to the patient's prescription.
- The nurse shall be able to specify the prescribed quantity, dosage, frequency, and duration for each OTC medicine.
- The prescription shall be available for review before final submission.
Inventory Management Integration
- Upon submission of the prescription, the prescribed OTC medicines shall be automatically dispensed from the available stock.
- The inventory system shall automatically deduct the dispensed quantity from the current stock and update the inventory balance in real time.
- The system shall maintain a transaction log for all dispensed medicines, including prescription details, quantity issued, date/time, and user information.
- If the prescribed quantity exceeds the available stock, the system shall display an appropriate alert and prevent dispensing beyond the available inventory.
- The inventory dashboard shall reflect the updated stock position immediately after prescription submission and medicine dispensing.
Business Rule
- Prescription submission and inventory deduction shall occur as a single transaction to ensure consistency between patient prescriptions and inventory records.
- Only medicines configured as OTC medicines in the master inventory list shall be available for selection by nurses in the General OPD module.