This commit marks a significant architectural shift, transitioning the CLQMS backend to a fully headless REST API. All view-related components have been removed to focus solely on providing a robust, stateless API for clinical laboratory workflows.
### Architectural Changes
- **Headless API Transition:**
- Removed all view files (`app/Views/v2`), associated page controllers (`PagesController`), and routes (`Routes.php`). The application no longer serves a front-end UI.
- The root endpoint (`/`) now returns a simple "Backend Running" status message.
- **Developer Tooling & Guidance:**
- Replaced `CLAUDE.md` with `GEMINI.md` to provide updated context and instructional guidelines for Gemini agents.
- Updated `.serena/project.yml` with project configuration.
### Feature Enhancements
- **Advanced Order Management (`OrderTestModel`):**
- **Test Expansion:** The `createOrder` process now automatically expands `GROUP` (panel) tests into their individual components and recursively includes all parameter dependencies for `CALC` (calculated) tests.
- **Order Comments:** Added support for attaching comments to an order via the `ordercom` table.
- **Status Tracking:** Order status updates are now correctly recorded in the `orderstatus` table.
- **Schema Alignment:** Switched from `OrderID` to `InternalOID` as the primary key for internal operations.
- **Reference Range Refactor (`TestsController`):**
- Simplified reference range logic by consolidating `refthold` and `refvset` into the main `refnum` and `reftxt` tables.
- Standardized `RefType` handling to support `NMRC`, `TEXT`, `THOLD`, and `VSET` codes from the `reference_type` ValueSet.
### Other Changes
- **Documentation:**
- `PRD.md`, `README.md`, and `TODO.md` were updated to reflect the headless architecture, refined scope, and current project priorities.
- **Database:**
- Removed obsolete `RefTHoldID` and `RefVSetID` columns from the `patres` table migration.
- **Testing:**
- Added new feature tests for `ContactController`, `OrganizationController`, and `TestsController`.
205 lines
6.9 KiB
PHP
205 lines
6.9 KiB
PHP
<?php
|
|
namespace App\Controllers;
|
|
|
|
use CodeIgniter\API\ResponseTrait;
|
|
use CodeIgniter\Controller;
|
|
use App\Libraries\ValueSet;
|
|
use App\Models\OrderTestModel;
|
|
use App\Models\Patient\PatientModel;
|
|
use App\Models\Patient\PatVisitModel;
|
|
|
|
class OrderTestController extends Controller {
|
|
use ResponseTrait;
|
|
|
|
protected $db;
|
|
protected $model;
|
|
protected $patientModel;
|
|
protected $visitModel;
|
|
protected $rules;
|
|
|
|
public function __construct() {
|
|
$this->db = \Config\Database::connect();
|
|
$this->model = new OrderTestModel();
|
|
$this->patientModel = new PatientModel();
|
|
$this->visitModel = new PatVisitModel();
|
|
$this->rules = [
|
|
'InternalPID' => 'required|is_natural'
|
|
];
|
|
}
|
|
|
|
public function index() {
|
|
$internalPID = $this->request->getVar('InternalPID');
|
|
|
|
try {
|
|
if ($internalPID) {
|
|
$rows = $this->model->getOrdersByPatient($internalPID);
|
|
} else {
|
|
$rows = $this->db->table('ordertest')
|
|
->where('DelDate', null)
|
|
->orderBy('TrnDate', 'DESC')
|
|
->get()
|
|
->getResultArray();
|
|
}
|
|
|
|
$rows = ValueSet::transformLabels($rows, [
|
|
'Priority' => 'order_priority',
|
|
'OrderStatus' => 'order_status',
|
|
]);
|
|
|
|
return $this->respond([
|
|
'status' => 'success',
|
|
'message' => 'Data fetched successfully',
|
|
'data' => $rows
|
|
], 200);
|
|
} catch (\Exception $e) {
|
|
return $this->failServerError('Something went wrong: ' . $e->getMessage());
|
|
}
|
|
}
|
|
|
|
public function show($orderID = null) {
|
|
try {
|
|
$row = $this->model->getOrder($orderID);
|
|
if (empty($row)) {
|
|
return $this->respond([
|
|
'status' => 'success',
|
|
'message' => 'Data not found.',
|
|
'data' => null
|
|
], 200);
|
|
}
|
|
|
|
$row = ValueSet::transformLabels([$row], [
|
|
'Priority' => 'order_priority',
|
|
'OrderStatus' => 'order_status',
|
|
])[0];
|
|
|
|
return $this->respond([
|
|
'status' => 'success',
|
|
'message' => 'Data fetched successfully',
|
|
'data' => $row
|
|
], 200);
|
|
} catch (\Exception $e) {
|
|
return $this->failServerError('Something went wrong: ' . $e->getMessage());
|
|
}
|
|
}
|
|
|
|
public function create() {
|
|
$input = $this->request->getJSON(true);
|
|
|
|
if (!$this->validateData($input, $this->rules)) {
|
|
return $this->failValidationErrors($this->validator->getErrors());
|
|
}
|
|
|
|
try {
|
|
if (!$this->patientModel->find($input['InternalPID'])) {
|
|
return $this->failValidationErrors(['InternalPID' => 'Patient not found']);
|
|
}
|
|
|
|
if (!empty($input['PatVisitID'])) {
|
|
$visit = $this->visitModel->find($input['PatVisitID']);
|
|
if (!$visit) {
|
|
return $this->failValidationErrors(['PatVisitID' => 'Visit not found']);
|
|
}
|
|
}
|
|
|
|
$orderID = $this->model->createOrder($input);
|
|
|
|
return $this->respondCreated([
|
|
'status' => 'success',
|
|
'message' => 'Order created successfully',
|
|
'data' => ['OrderID' => $orderID]
|
|
], 201);
|
|
} catch (\Exception $e) {
|
|
return $this->failServerError('Something went wrong: ' . $e->getMessage());
|
|
}
|
|
}
|
|
|
|
public function update() {
|
|
$input = $this->request->getJSON(true);
|
|
|
|
if (empty($input['OrderID'])) {
|
|
return $this->failValidationErrors(['OrderID' => 'OrderID is required']);
|
|
}
|
|
|
|
try {
|
|
$order = $this->model->getOrder($input['OrderID']);
|
|
if (!$order) {
|
|
return $this->failNotFound('Order not found');
|
|
}
|
|
|
|
$updateData = [];
|
|
if (isset($input['Priority'])) $updateData['Priority'] = $input['Priority'];
|
|
if (isset($input['OrderStatus'])) $updateData['OrderStatus'] = $input['OrderStatus'];
|
|
if (isset($input['OrderingProvider'])) $updateData['OrderingProvider'] = $input['OrderingProvider'];
|
|
if (isset($input['DepartmentID'])) $updateData['DepartmentID'] = $input['DepartmentID'];
|
|
if (isset($input['WorkstationID'])) $updateData['WorkstationID'] = $input['WorkstationID'];
|
|
|
|
if (!empty($updateData)) {
|
|
$this->model->update($order['InternalOID'], $updateData);
|
|
}
|
|
|
|
return $this->respond([
|
|
'status' => 'success',
|
|
'message' => 'Order updated successfully',
|
|
'data' => $this->model->getOrder($input['OrderID'])
|
|
], 200);
|
|
} catch (\Exception $e) {
|
|
return $this->failServerError('Something went wrong: ' . $e->getMessage());
|
|
}
|
|
}
|
|
|
|
public function delete() {
|
|
$input = $this->request->getJSON(true);
|
|
$orderID = $input['OrderID'] ?? null;
|
|
|
|
if (empty($orderID)) {
|
|
return $this->failValidationErrors(['OrderID' => 'OrderID is required']);
|
|
}
|
|
|
|
try {
|
|
$order = $this->model->getOrder($orderID);
|
|
if (!$order) {
|
|
return $this->failNotFound('Order not found');
|
|
}
|
|
|
|
$this->model->softDelete($orderID);
|
|
|
|
return $this->respondDeleted([
|
|
'status' => 'success',
|
|
'message' => 'Order deleted successfully'
|
|
]);
|
|
} catch (\Exception $e) {
|
|
return $this->failServerError('Something went wrong: ' . $e->getMessage());
|
|
}
|
|
}
|
|
|
|
public function updateStatus() {
|
|
$input = $this->request->getJSON(true);
|
|
|
|
if (empty($input['OrderID']) || empty($input['OrderStatus'])) {
|
|
return $this->failValidationErrors(['error' => 'OrderID and OrderStatus are required']);
|
|
}
|
|
|
|
$validStatuses = ['ORD', 'SCH', 'ANA', 'VER', 'REV', 'REP'];
|
|
if (!in_array($input['OrderStatus'], $validStatuses)) {
|
|
return $this->failValidationErrors(['OrderStatus' => 'Invalid status. Valid: ' . implode(', ', $validStatuses)]);
|
|
}
|
|
|
|
try {
|
|
$order = $this->model->getOrder($input['OrderID']);
|
|
if (!$order) {
|
|
return $this->failNotFound('Order not found');
|
|
}
|
|
|
|
$this->model->updateStatus($input['OrderID'], $input['OrderStatus']);
|
|
|
|
return $this->respond([
|
|
'status' => 'success',
|
|
'message' => 'Order status updated successfully',
|
|
'data' => $this->model->getOrder($input['OrderID'])
|
|
], 200);
|
|
} catch (\Exception $e) {
|
|
return $this->failServerError('Something went wrong: ' . $e->getMessage());
|
|
}
|
|
}
|
|
}
|