fluxq-engine 1.0.1 → 1.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +41 -19
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,28 +1,48 @@
|
|
|
1
|
-
# FluxQ Engine
|
|
1
|
+
# FluxQ Engine ● Telemedicine Queue Optimizer
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[](https://nodejs.org)
|
|
4
|
+
[](https://www.typescriptlang.org)
|
|
5
|
+
[](https://expressjs.com)
|
|
6
|
+
[](https://www.npmjs.com/package/fluxq-engine)
|
|
7
|
+
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
### ● Overview
|
|
4
11
|
FluxQ Engine is a high-performance REST API and core logic engine built for clinical-aware patient triage and intelligent queue management. It optimizes wait times by up to 40% using advanced clinical weight balancing and fairness enforcement.
|
|
5
12
|
|
|
6
13
|
◈ **NPM Package**: [fluxq-engine](https://www.npmjs.com/package/fluxq-engine)
|
|
7
|
-
◈ **Live API Status**: [
|
|
14
|
+
◈ **Live API Status**: [Online (Render)](https://fluxq.onrender.com/health)
|
|
8
15
|
|
|
9
16
|
---
|
|
10
17
|
|
|
11
|
-
|
|
18
|
+
### ● Key Features
|
|
19
|
+
|
|
20
|
+
#### 1 ― Smart Triage Logic
|
|
21
|
+
› Dynamic symptom assessment and severity classification.
|
|
22
|
+
› Clinical priority scoring (Severity × Wait Time × Fairness).
|
|
23
|
+
|
|
24
|
+
#### 2 ― Queue Optimization
|
|
25
|
+
› Real-time reordering based on clinical severity and fairness thresholds.
|
|
26
|
+
› Starvation prevention and dynamic aging boosts.
|
|
27
|
+
|
|
28
|
+
#### 3 ― Fairness Monitoring
|
|
29
|
+
› Real-time identification of starvation risks.
|
|
30
|
+
› Fairness reports with aging boost tracking.
|
|
31
|
+
|
|
32
|
+
#### 4 ― Simulation & Metrics
|
|
33
|
+
› High-level KPIs: Wait time reduction, doctor utilization, and throughput.
|
|
34
|
+
› Full baseline vs. optimized comparison reporting.
|
|
12
35
|
|
|
13
|
-
|
|
14
|
-
• **Queue Optimization**: Real-time reordering based on clinical severity and fairness thresholds.
|
|
15
|
-
• **Fairness Monitoring**: Dynamic aging boosts and starvation risk tracking.
|
|
16
|
-
• **Comprehensive Metrics**: Provides full baseline vs. optimized comparisons with 9+ performance KPIs.
|
|
36
|
+
---
|
|
17
37
|
|
|
18
|
-
|
|
38
|
+
### ● Quick Start
|
|
19
39
|
|
|
20
40
|
▶ **Installation**
|
|
21
41
|
```bash
|
|
22
42
|
npm install fluxq-engine
|
|
23
43
|
```
|
|
24
44
|
|
|
25
|
-
▶ **Usage**
|
|
45
|
+
▶ **API Client Library Usage**
|
|
26
46
|
```typescript
|
|
27
47
|
import { QueueOptimizer } from 'fluxq-engine';
|
|
28
48
|
|
|
@@ -30,15 +50,17 @@ const optimizer = new QueueOptimizer();
|
|
|
30
50
|
const optimizedQueue = optimizer.optimize(patients, config);
|
|
31
51
|
```
|
|
32
52
|
|
|
33
|
-
|
|
34
|
-
◈ `GET /api/v1/config` ― Get current system optimization parameters.
|
|
35
|
-
◈ `POST /api/v1/optimize` ― Submit a patient list for instant re-ordering.
|
|
36
|
-
◈ `POST /api/v1/simulate` ― Run a complete FCFS vs. AI comparison.
|
|
53
|
+
▶ **Direct API Connectivity**
|
|
37
54
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
55
|
+
`GET /api/v1/config` ― Get current system optimization parameters.
|
|
56
|
+
|
|
57
|
+
`POST /api/v1/optimize` ― Submit a patient list for instant re-ordering.
|
|
58
|
+
|
|
59
|
+
`POST /api/v1/simulate` ― Run a complete FCFS vs. AI comparison.
|
|
42
60
|
|
|
43
61
|
---
|
|
44
|
-
|
|
62
|
+
|
|
63
|
+
### ● Developer
|
|
64
|
+
|
|
65
|
+
**Built by [Diksha](https://github.com/dikshaa2909)**
|
|
66
|
+
|
package/package.json
CHANGED