2026-01-12 16:53:41 +07:00
|
|
|
<?php
|
|
|
|
|
namespace App\Libraries;
|
|
|
|
|
|
|
|
|
|
use CodeIgniter\Cache\CacheFactory;
|
|
|
|
|
use CodeIgniter\Config\BaseConfig;
|
|
|
|
|
|
|
|
|
|
class ValueSet {
|
|
|
|
|
private static $cache = null;
|
refactor: consolidate migrations and reorganize valueset data structure
Major refactoring to clean up database migrations and reorganize static lookup data:
- Consolidated 13 old migrations (2025) into 10 new numbered migrations (2026-01-01)
- Deleted redundant migrations: Location, Users, Contact, ValueSet, Counter, RefRange,
CRMOrganizations, Organization, AreaGeo, DeviceLogin, EdgeRes
- New consolidated migrations:
- 2026-01-01-000001_CreateLookups: valueset, counter, containerdef, occupation, specialty
- 2026-01-01-000002_CreateOrganization: account, site, location, discipline, department
- 2026-01-01-000003_CreatePatientCore: patient, patidentifier, pataddress, patcontact
- 2026-01-01-000004_CreateSecurity: contact, contactdetail, userdevices, loginattempts
- 2026-01-01-000005_CreatePatientVisits: patvisit, patinsurance
- 2026-01-01-000006_CreateOrders: porder, orderitem
- 2026-01-01-000007_CreateSpecimens: specimen, specmenactivity, containerdef
- 2026-01-01-000008_CreateTestDefinitions: testdefinition, testactivity, refnum, reftxt
- 2026-01-01-000009_CreateResults: patresult, patresultdetail, patresultcomment
- 2026-01-01-000010_CreateLabInfrastructure: edgeres, edgestatus, edgeack, workstation
- Moved 44 JSON files from valuesets/ subdirectory to app/Libraries/Data/ root
- Added new country.json lookup
- Added _meta.json for valueset metadata
- Deleted old valuesets/_meta.json
- Renamed gender.json to sex.json for consistency with patient.Sex column
- Removed duplicate country.json from valuesets/
- AGENTS.md: Updated Lookups library documentation with new methods
- README.md: Complete rewrite of lookup/valueset documentation
- Renamed MVP_TODO.md to TODO.md
- Added VUE_SPA_IMPLEMENTATION_PLAN.md
- Removed deprecated prj_clinical laboratory quality management system_3a.docx
- ValueSet.php: Enhanced with caching and new lookup methods
- Lookups.php: Removed (functionality merged into ValueSet)
Impact: Prepares codebase for 2026 with cleaner migration history and improved
lookup data organization for the name-based valueset system.
2026-01-13 07:22:25 +07:00
|
|
|
private static string $dataPath = APPPATH . 'Libraries/Data/';
|
2026-01-12 16:53:41 +07:00
|
|
|
private static string $cacheKey = 'valueset_all';
|
|
|
|
|
|
|
|
|
|
private static function getCacheHandler() {
|
|
|
|
|
if (self::$cache === null) {
|
|
|
|
|
$config = config('Cache');
|
|
|
|
|
self::$cache = CacheFactory::getHandler($config);
|
|
|
|
|
}
|
|
|
|
|
return self::$cache;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public static function get(string $name): ?array {
|
|
|
|
|
$all = self::getAll();
|
|
|
|
|
$values = $all[$name]['values'] ?? null;
|
|
|
|
|
if ($values === null) return null;
|
|
|
|
|
return self::format($values);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public static function getRaw(string $name): ?array {
|
|
|
|
|
$all = self::getAll();
|
|
|
|
|
return $all[$name]['values'] ?? null;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public static function getAll(): array {
|
|
|
|
|
$handler = self::getCacheHandler();
|
|
|
|
|
$data = $handler->get(self::$cacheKey);
|
|
|
|
|
|
|
|
|
|
if ($data !== null) {
|
|
|
|
|
return $data;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
$data = self::bundleAll();
|
|
|
|
|
$handler->save(self::$cacheKey, $data, 0);
|
|
|
|
|
return $data;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public static function getLabel(string $lookupName, string $key): ?string {
|
|
|
|
|
$raw = self::getRaw($lookupName);
|
|
|
|
|
if ($raw === null) return null;
|
|
|
|
|
foreach ($raw as $item) {
|
|
|
|
|
if (($item['key'] ?? $item['value'] ?? null) === $key) {
|
|
|
|
|
return $item['value'] ?? $item['label'] ?? null;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
return null;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public static function getOptions(string $lookupName): array {
|
|
|
|
|
$raw = self::getRaw($lookupName);
|
|
|
|
|
if ($raw === null) return [];
|
|
|
|
|
return array_map(function ($item) {
|
|
|
|
|
return [
|
|
|
|
|
'key' => $item['key'] ?? '',
|
|
|
|
|
'value' => $item['value'] ?? $item['label'] ?? '',
|
|
|
|
|
];
|
|
|
|
|
}, $raw);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public static function transformLabels(array $data, array $fieldMappings): array {
|
|
|
|
|
foreach ($data as &$row) {
|
|
|
|
|
foreach ($fieldMappings as $field => $lookupName) {
|
|
|
|
|
if (isset($row[$field]) && $row[$field] !== null) {
|
|
|
|
|
$row[$field . 'Text'] = self::getLabel($lookupName, $row[$field]) ?? '';
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
return $data;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
public static function clearCache(): bool {
|
|
|
|
|
$handler = self::getCacheHandler();
|
|
|
|
|
return $handler->delete(self::$cacheKey);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static function bundleAll(): array {
|
|
|
|
|
$result = [];
|
|
|
|
|
foreach (glob(self::$dataPath . '*.json') as $file) {
|
|
|
|
|
$name = pathinfo($file, PATHINFO_FILENAME);
|
|
|
|
|
if ($name[0] === '_') continue;
|
|
|
|
|
$data = self::loadFile($file);
|
|
|
|
|
if ($data) {
|
|
|
|
|
$result[$name] = $data;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
return $result;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static function loadFile(string $path): ?array {
|
|
|
|
|
if (!is_file($path)) return null;
|
|
|
|
|
$content = file_get_contents($path);
|
|
|
|
|
return json_decode($content, true);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static function format(array $values): array {
|
|
|
|
|
return array_map(fn($v) => [
|
|
|
|
|
'value' => (string) ($v['key'] ?? ''),
|
|
|
|
|
'label' => (string) ($v['value'] ?? $v['label'] ?? '')
|
|
|
|
|
], $values);
|
|
|
|
|
}
|
|
|
|
|
}
|