clqms-be/app/Controllers/Test/DemoOrderController.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

86 lines
2.8 KiB
PHP

<?php
namespace App\Controllers\Test;
use CodeIgniter\API\ResponseTrait;
use CodeIgniter\Controller;
use App\Libraries\ValueSet;
use App\Models\Patient\PatientModel;
use App\Models\OrderTestModel;
class DemoOrderController extends Controller {
use ResponseTrait;
protected $db;
protected $patientModel;
protected $orderModel;
public function __construct() {
$this->db = \Config\Database::connect();
$this->patientModel = new PatientModel();
$this->orderModel = new OrderTestModel();
}
public function createDemoOrder() {
$input = $this->request->getJSON(true);
$patientData = [
'PatientID' => $input['PatientID'] ?? 'DEMO' . time(),
'Gender' => $input['Gender'] ?? '1',
'NameFirst' => $input['NameFirst'] ?? 'Demo',
'NameLast' => $input['NameLast'] ?? 'Patient',
'Birthdate' => $input['Birthdate'] ?? '1990-01-01'
];
$patient = $this->patientModel->where('PatientID', $patientData['PatientID'])->findAll();
if (empty($patient)) {
$internalPID = $this->patientModel->createPatient($patientData);
} else {
$internalPID = $patient[0]['InternalPID'];
}
$orderData = [
'InternalPID' => $internalPID,
'PatVisitID' => $input['PatVisitID'] ?? null,
'Priority' => $input['Priority'] ?? 'R',
'OrderingProvider' => $input['OrderingProvider'] ?? 'Dr. Demo',
'DepartmentID' => $input['DepartmentID'] ?? 1,
'Tests' => $input['Tests'] ?? []
];
$orderID = $this->orderModel->createOrder($orderData);
return $this->respond([
'status' => 'success',
'message' => 'Demo order created successfully',
'data' => [
'PatientID' => $patientData['PatientID'],
'InternalPID' => $internalPID,
'OrderID' => $orderID,
'OrderStatus' => 'ORD'
]
], 201);
}
public function listDemoOrders() {
$orders = $this->db->table('ordertest ot')
->select('ot.OrderID, ot.InternalPID, p.PatientID, ot.OrderDateTime, ot.Priority, ot.OrderStatus')
->join('patient p', 'p.InternalPID = ot.InternalPID')
->where('ot.DelDate', null)
->orderBy('ot.OrderDateTime', 'DESC')
->limit(50)
->get()
->getResultArray();
$orders = ValueSet::transformLabels($orders, [
'Priority' => 'order_priority',
'OrderStatus' => 'order_status',
]);
return $this->respond([
'status' => 'success',
'message' => 'Data fetched successfully',
'data' => $orders
], 200);
}
}