clqms-be/app/Controllers/OrderTestController.php
mahdahar 40ecb4e6e8 feat(api): transition to headless architecture and enhance order management
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`.
2026-01-31 09:27:32 +07:00

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());
}
}
}