eKlotho Nexus — Internal Report

Milestone History & Project Status

Healthcare Administration Platform · CEO Dashboard · 94 of 95 phases shipped · v2.6 Production QA Sweep active
As of
May 14, 2026
Next: Phase 95 (340B)
Live: nexus.eklotho.com
Platform: EC2 Docker Compose via deploy.sh
Stack: Next.js 14 · FastAPI · MySQL 8 · Redis
Shipped: 94 / 95 phases
Active: v2.6 Production QA Sweep
Next: Phase 95 — 340B Registration
Executive Summary / read this first
Nexus is production-complete across 8 milestones, covering 94 of 95 phases, 225+ routes, and ~185K lines of code. The platform is live on nexus.eklotho.com, serves eight role personas, and has passed every ship gate from v1.0 through v2.5. v2.6 is an active QA sweep — Phase 92 (BACKLOG-91-A, 10 CRUD endpoints) shipped via 7 PRs; the QA campaign (PRs #87–#93) fixed 2 cross-org 500s, added 5 composite indexes, gated Slack admin permissions, and secured MFA disable with password reauth. Phase 94 (FQHC HRSA Grants) shipped and is live. Phase 95 (340B Covered Entity Registration) is planned next.
Phase 92 BACKLOG-91-A: all 10 CRUD items resolved
10/10
QA campaign PRs #87–#93: 500 fixes, perf indexes, security gates
7 PRs
Phase 94 FQHC HRSA Grants — live on nexus.eklotho.com
Ph 94 ✓
Provider profiling 17s → 1.5s · clinical dashboard 15.8s → 1.9s
10× faster
Phase 95 (340B Registration) — spec written, not yet started
Up next
At a Glance / 6 key metrics
Total phases
95
across 8 milestones
Phases shipped
+13 since May 2
94 / 95
live on nexus.eklotho.com
Codebase size
+10K
185K
TS + Python LOC
Git commits
+526
2,517+
7 PRs in v2.6 QA campaign
Pages built
+20
245
routes across 9 entity types
Next phase
planned
Ph 95
340B Covered Entity Reg.
Milestone Timeline / click a node to jump
Foundation
v1.0
Phases 1–17
✓ Shipped
Apr 6
Expansion
v2.0
Phases 18–49
✓ Shipped
Apr 12
UX Polish
v2.1
Phases 50–51
✓ Shipped
Apr 12
Infra
v2.2
Phases 53–54
✓ Shipped
Apr 12
Gap Fix
v2.3
Phases 60–72
✓ Shipped
Apr 18
Production
v2.4
Phases 73–87
✓ Shipped
Apr 28
Polish
v2.5
Phases 88–90
✓ Shipped
Apr 30
QA Sweep
v2.6
Phases 91–95
⟳ Active
May 2026
Platform Feature Completeness
Relative to the full demo HTML reference (~250 pages)
99%
v1.0 v2.0 v2.1 v2.2 v2.3 v2.4 v2.5 v2.6 (active) Ph 95
Risks & Blockers / 1 open
Low owner: vendor
Ph 08 Oracle migration permanently deferred
Legacy Oracle DDL import awaiting vendor VPC access. Intentionally excluded from production-complete definition — no downstream dependency on any in-flight phase.
Impact: none today Status: parked indefinitely
Info owner: engineering
Phase 95 (340B) — SPEC written, execution not yet started
340B Covered Entity Registration spec is complete. No blockers identified. Execution begins when Phase 94 HRSA follow-up work settles. Scope is self-contained to the FQHC module.
Impact: none until started Status: planned Mitigation: SPEC.md written; can start any time
What's Next / Phase 95 scope

Phase 95 — 340B Covered Entity Registration

FQHC module extension · SPEC written · execution pending · estimated ~1 week solo
Status: Planned · v2.6 scope
Ph 95-01
340B Model + Migration
CE registration table, covered drugs, audit trail
Ph 95-02
API Endpoints
GET/POST /api/fqhc/340b · entity-scoped
Ph 95-03
Registration UI
CE registration form + status dashboard
Ph 95-04
QA + Deploy
Harness + live smoke test
Milestone Details / click any milestone to collapse

v1.0 — Core Platform Foundation

✓ Shipped
Phases 1–17 · Shipped Apr 6, 2026 · First production deployment
Requirements
25/31
E2E Flows
5/7
Phases
16/17
Layer Map
InfraPh 01 Foundation · Ph 02 Auth & Entity Graph
OpsPh 03 Dashboard · Ph 04 Delegations · Ph 05 Cred+UM · Ph 06 Provider+Claims · Ph 07 HEDIS
DeferredPh 08 Oracle Migration — awaiting vendor VPC
ClinicalPh 09 Patients · Ph 10 Clinical Records · Ph 11 Vitals/RPM
WorkflowPh 12 Auth · Ph 13 Claims · Ph 14 Billing · Ph 15 Enrollment · Ph 16 Network · Ph 17 Care Coord
Score Card
DimensionScoreNote
Requirements25/316 gaps → fixed in v2.3
E2E flows5/72 bugs fixed in v2.3
Phases complete16/17Ph 8 permanently deferred
Tech debt4 itemsActivityEvent, dashboard count, npm pkg
Ph# Name & Purpose Status Key Deliverable
01
Foundation
Docker, MySQL, CI/CD pipeline, base project structure
DoneRunnable platform skeleton
02
Auth & Entity Graph
RS256 JWT, 9-entity type hierarchy, access graph computation
DoneSecure multi-tenant auth
03
IPA Dashboard
KPI cards, activity feed, operational stats
DonePrimary homepage
04
Delegations
Delegation lifecycle — create, activate, terminate, track
DoneCore IPA workflow
05
Credentialing & UM
Provider credentialing queue, UM authorization workflow
DoneRegulatory workflows
06
Provider & Claims
Provider directory, basic claims listing
DoneProvider management
07
HEDIS
Quality measure performance tracking and reporting
DoneQuality compliance
08
Oracle Migration
Legacy Oracle DDL import — awaiting vendor DDL schema + VPC access
DeferredPermanently deferred
09
Patient Management
Patient records, demographics, attributed member list
DonePatient 360 base
10
Clinical Records
Clinical history, encounters, diagnoses
DoneClinical data layer
11
Vitals & RPM
Remote patient monitoring, vitals trend tracking
DoneRPM program support
12
Authorizations
Full UM authorization lifecycle — intake, review, determination, appeals
DoneUM full workflow
13
Claims Processing
Claims submission, adjudication, status tracking
DoneRevenue cycle base
14
Billing
AR aging, billing cycles, invoice management
DoneFinancial operations
15
Enrollment
Member enrollment records, eligibility, plan assignment
DoneMember management
16
Provider Network
Network contracts, provider participation, specialty management
DoneNetwork management
17
Care Coordination
Care team, referrals, care transitions, case management
DoneCare management

v2.0 — Platform Expansion

✓ Shipped
Phases 18–49 · Shipped Apr 12, 2026 · 4 days · ~165K LOC · 899 commits
Requirements
28/35
E2E Flows
45/50
Phases
32
Population & Analytics
Ph 18, 19, 28, 31, 36
Financial
Ph 21, 29, 41
Claims & UM
Ph 30, 33, 37, 39
Admin & Compliance
Ph 20, 24, 42
Platform Services
Ph 22–27, 32–40, 44–49
Ph#Name & PurposeStatusKey Deliverable
18
Population Health
Risk stratification, chronic disease registries, preventive care gap reporting
DoneRAF scoring, care gap dashboard
19
Analytics & Reporting
Custom report builder, PDF/CSV/XLSX export, scheduled delivery, KPI trends
DoneReport builder + exports
20
Administration
User management, entity settings, RBAC custom roles, immutable audit log
DoneRBAC + audit trail
21
Financial Management
PMPM capitation rates, payment ledger, MLR metrics, revenue cycle
DoneCapitation + MLR
22
Plan Products
Health plan benefit structures, network tier configs, drug formularies
DoneBenefit definitions
23
Employer Groups, Risk Pools & Grievances
Group enrollment, shared risk pool metrics, grievance/appeals lifecycle
DoneRisk pool + grievances
24
FQHC, Multi-Tenant & Regulatory
FQHC-specific workflows, tenant isolation, regulatory report generation
DoneFQHC + regulatory
25
Scheduling, Alerts, SMS & Documents
Appointment scheduling, Twilio SMS/email alerts, versioned documents
DoneScheduling + notifications
26
Documentation & Manuals
Contextual in-app help, searchable knowledge base, admin CMS
DoneIn-app help system
27
AI Assistant & Chat
Natural language data queries, inline AI suggestions, persistent chat
DoneClaude-powered AI chat
28
Canned Analytics Dashboards
Pre-built Executive, Finance, Clinical, Operations dashboards; budget vs actual
Done8 pre-built dashboards
29
Financial Completeness
MLR drill-down, payment batch posting, cross-delegation rate editor
DoneMLR + batch payments
30
Claims Forms
Multi-line claim submission, CMS-1500 professional form view/PDF, UB-04 institutional
DoneCMS-1500 + UB-04 PDFs
31
Population Health Outreach
Outreach logging against care gaps, CSV export, RAF trend sparkline
DoneCare gap outreach
32
Enrollment Enhancements
Enrollment detail page, CSV export, renewals alert banner
DoneEnrollment detail + export
33
UM Determination Letters
PDF determination letters for authorization decisions, Download Letter button
DoneUM PDF letters
34
Network Provider Search
Search/filter by specialty, provider detail slide-over
DoneProvider search + filter
35
Tenant Admin Dashboard
Entity directory, detail view, name/status edit — scoped to EntityDataAccess
DoneEntity directory
36
Population Health Extensions
CMS Stars Ratings dashboard, HCC/RAF risk adjustment, SDOH data capture
DoneStars + HCC + SDOH
37
Claims & UM Extensions
ERA 835/EOB remittance viewer, claims CSV export, medical director queue
DoneERA 835 + remittance
38
Enrollment Sub-pages
Carve-out tracking, plan benefits tab, retroactive eligibility workflow
DoneCarve-outs + retro elig.
39
UM & Admin Extensions
Clinical criteria library, referral processing queue, SLA configuration
DoneCriteria + SLA config
40
Network Extensions + Multi-Tenant Dashboard
Provider profiling analytics, specialty networks, regulatory filing calendar
DoneNetwork analytics
41
Financial + Admin Extensions
Benefit accumulators, medical code catalog, alert rules admin, open enrollment periods
DoneAccumulators + codes
42
Audit Rules Config + MFA
Claims adjudication rules config, TOTP-based MFA setup with backup codes
DoneMFA + adjudication rules
44–49
Gap Closure & Requirements Traceability
6 verification phases — closed all audit gaps, synced 50 requirements, added UMDL/ENRL/NETSRCH requirements
DoneFull requirements sync

v2.1 & v2.2 — UX Polish + Infrastructure

✓ Shipped
Phases 50–54 · Shipped Apr 12, 2026 · Same day as v2.0
v2.1 Req.
6/6
v2.1 Flows
4/4
Ph#Name & PurposeStatusKey Deliverable
50
Header Refactor + Panel System
Floating panel architecture — Slack, Help, Search panels with mutual exclusion and toggle-to-close
DonePanel system + TooltipProvider fix
51
Admin Slack Settings
Fernet-encrypted webhook storage, Slack notification dispatch backend
DoneEncrypted Slack integration
53
Performance Optimization
Backend query optimization, frontend bundle analysis, API response improvements
DoneQuery + bundle perf
54
E2E Testing Infrastructure
Playwright test harness, smoke test suite (NAV_CONFIG coverage), soft assertions, JSON triage log
DoneFull Playwright harness

v2.3 — Platform Gap Remediation

✓ Shipped — Perfect Score
Phases 60–72 · Shipped Apr 18, 2026 · 21/21 requirements · 172/172 integrations
Requirements
21/21
Integrations
172/172
E2E Flows
36/36
Requirements
21/21
100% — best score
Integrations
172
surfaces fixed
E2E Flows
36/36
Harness green
Visual Parity
0
major deltas
Nyquist
12/12
all phases compliant
Ph#Name & PurposeStatusScoreKey Deliverable
60
Assessments + Billing Compliance Tabs
Done10/10Patient clinical tabs 1+2
61
Care Notes + Devices Tabs
Done12/12Patient clinical tabs 3+4
62
Documents + Immunizations Tabs
Done12/12Patient clinical tabs 5+6
63
Monthly Review + Screenings Tabs
Done30/30Patient clinical tabs 7+8
64
Interaction Audit Report
Baseline audit — found 361 broken interaction surfaces across platform
Needs UAT9/9 +1 advisoryAudit baseline report
65
Fix Wave 1 — IPA Core
Fixed broken buttons, row-clicks, nav items in IPA core modules
Done9/9IPA interactions fixed
66
Fix Wave 2 — Financial/Analytics
Done9/9Financial interactions fixed
67
Fix Wave 3 — Support/Admin
172 total interaction surfaces remediated across full platform
Needs UAT3/4 +SC4 remote172 interactions fixed
68
Care Team + Documents History
Done11/11Care team + doc history
69
OCR Scan + Risk Stratification Cohorts
Done11/11Document OCR + cohorts
70
Help Article Seeding + Page-Aware Panel
26 help articles live-seeded; panel auto-surfaces correct article per route
Done4/426 articles live-seeded
71
Memos
Optional — intentionally skipped, no downstream dependency
SkippedOptionalOut of scope
72
v2.3 Verification + Visual Parity Audit
Route inventory reconciled 208→214; visual parity: 178 match / 24 minor / 0 major; Harness green
DoneAll greenFull regression + parity

v2.4 — Production Completeness

✓ Shipped
Phases 73–87 · Shipped Apr 28, 2026 · 15 phases complete · Mock purge, backend completion, IPA/Financial/Analytics/Admin, row-click audit, styling
Phases
15/15
Shipped
Apr 28
Why v2.4 exists — 4 gap types found after v2.3 shipped
Type C 27
missing pages
Routes that exist in demo but not in codebase
Type D 63
thin wrappers
Pages that exist but lack demo depth (no KPIs, no actions)
Type E 35
mock violations
Pages with hardcoded const MOCK_DATA[] (CLAUDE.md violation)
Type F ~75
missing APIs
Backend endpoints absent or stub-only
Gap Analysis by Cluster
Cluster Demo Pages Impl Routes Missing Partial Mock Violations Missing API
IPA Core (Patients, Claims, UM, Cred)48395184TBD
Financial (Billing, Risk Pools, Plans)~35~25514~12~25
Analytics (Dashboards, Pop Health, Quality)3531413910
Admin/Tenant (Admin, Comms, Network, AI)6295 files1318~10~15
TOTAL~180~1902763~35~75
Sub-Phase Tracker
P0
Ph 73
🧹
Mock Data Purge
Done Apr 24
P0
Ph 74
⚙️
Backend Completion
Done Apr 24
P0
Ph 75
🏥
IPA Core Completion
Done +UAT
P1
Ph 76
💰
Financial Completion
Done +UAT
P1
Ph 77
📊
Analytics Completion
Done Apr 24
P1
Ph 78
🏛️
Admin/Tenant Completion
Done Apr 28
P1
Ph 79
🖱️
Row-Click Audit
Done Apr 23
P1
Ph 82
🔖
Display IDs
Done Apr 28
P1
Ph 83
🩺
UM Visual Parity
Done Apr 25
P1
Ph 84
📅
Appt Schedule Grid
Done Apr 25
P1
Ph 85
🔔
Alert Settings Depth
Done Apr 26
P1
Ph 86
🌐
Tiered Networks
Done Apr 26
P2
Ph 87
📝
Documentation
Done Apr 26
P2
Ph 88
🎨
Styling Reconciliation
Done Apr 27 · UAT partial
P1
Ph 90
🔍
Spec Alignment
Done Apr 29
P0
Ph 81
🚢
QA + Ship Gate
Done Apr 30
Ph# Name & What It Delivers Priority Est. Status Business Impact If Skipped
73
Mock Data Purge
52 hardcoded data arrays removed from 63 files (115 occurrences); 11 taxonomy files allowlisted
P01 weekDoneFabricated numbers would show to users
74
Backend Completion
~75 missing API endpoints across 11 routers; communications, risk-pool settlement, credentialing workflow, CMS submissions, accumulators; wired 16 empty pages to real DB
P01 weekDonePages return 503 / empty arrays
75
IPA Core Completion
19 missing patient sub-pages; CMS-1500 + UB-04 interactive claim intake forms; UM Dashboard with KPI cards; credentialing multi-step workflow (CAQH intake, PSV, committee review)
P01.5 weeksDone +UATCore IPA workflows incomplete — can't submit claims via form
76
Financial Completion
Financial dashboard with live KPIs from DB; risk pools dashboard + configuration; employer groups wizard; grace period state machine; CMS plan submissions
P11.5 weeksDone +UATFinancial dashboard shows no data; employer onboarding broken
77
Analytics Completion
Global date-range filter wired across all analytics; ACO REACH, Value-Based, Query Builder pull real data; population health predictive models + pharmacy PDC live; PDF export
P11 weekDoneAnalytics shows fabricated numbers
78
Admin/Tenant Completion
Entity CRUD (create/edit/delete IPAs, ACOs, PHOs, MCOs, Health Plans); admin console KPIs with real data; provider sub-networks; scheduling calendar; workflow action buttons. BestCareIPA rename (migration 096→100) also shipped.
P1DoneDoneAdmin console complete; org onboarding via UI now works
82
Human-Readable Display IDs
All entities, claims, authorizations, and cases now surface short human-readable IDs (e.g. CLM-00042) instead of raw UUIDs throughout the UI.
P1DoneDoneSupport teams can reference records by readable ID
83
UM Visual Parity
9 UM pages rebuilt to altbiolab.com parity: new /um/new (prior auth form), /um/denials (denials & appeals workstation), rebuilt medical-director split-panel, referral-network, edi-278, dashboard charts, criteria, auto-approval.
P1DoneDoneUM module now matches demo reference (9/9 verification PASS)
79
Row-Click + Action Audit
Systematic pass: every DataTable on every page — onRowClick wired, detail route exists, every demo button has impl equivalent
P1DoneDone Apr 23All table rows wired; UX navigation complete
84
Appointment Schedule Grid
Multi-provider schedule grid with drag-to-reschedule, BookAppointmentDialog pre-fill, 10 scheduling sub-pages wired to nav.
P1DoneDone Apr 25Scheduling calendar complete; human UAT passed
85
Alert Settings Depth
Provider notification channel matrix (SMS/email/in-app per rule); vital threshold table; escalation rule dialog; per-provider alert configuration.
P1DoneDone Apr 26Alert settings fully wired; human UAT passed
86
Tiered Networks & Incentive Programs
Tiered network sub-network management, tier criteria editor, incentive program lifecycle, re-evaluation workflow.
P1DoneDone Apr 26Network tiering live; 3 bugs fixed post-deploy
87
Comprehensive Documentation
In-app help article expansion, API docs sync, admin user guide update.
P2DoneDone Apr 26Help system articles updated for all v2.4 additions
88
Styling Reconciliation
Per-page compare impl vs demo; align to DESIGN.md; resolve 24 minor visual deltas from v2.3 audit.
P2DoneDone · UAT partialAutomated checks passed; visual typography sign-off pending
90
Spec Alignment & Visual Audit
Stale checkbox corrections in REQUIREMENTS.md, Phase 89 VERIFICATION.md fix, structural layout parity audit for 8 core IPA modules.
P1DoneDoneSpecs match live implementation
81
QA + Integration Verification — Ship Gate
Full E2E regression suite; deploy to nexus.eklotho.com; post-deploy smoke test per 8 role personas
P0DoneDonev2.4 production-complete gate passed

v2.5 — Production Polish & QA

✓ Shipped
Phases 88–90 · Shipped Apr 30, 2026 · Styling reconciliation, full QA verification, spec alignment — no net-new features
Phases
3/3
Shipped
Apr 30
Ph#Name & PurposeStatusKey Deliverable
88
Styling Reconciliation
Per-page compare impl vs demo; align to DESIGN.md; resolve 24 minor visual deltas from v2.3 audit. 6 wave plans across all modules.
DoneAll pages DM Sans, terra cotta, 8pt grid
89
QA + Integration Verification
Playwright E2E, backend pytest ≥97%, TypeScript noEmit 0, deploy pipeline green, manual UAT smoke across all v2.4 phases.
DoneFull stack verified green
90
Human Verification & Spec Alignment
Closed v2.5 audit gaps — live site structural parity confirmed, REQUIREMENTS.md checkboxes corrected (STYLE-03, QA-04), stale docs fixed.
Donev2.5 milestone audit: all gaps closed

v2.6 — Production QA Sweep + Phase 92 Pickup

⟳ Active
Phases 91–95 · Active since May 6, 2026 · QA form coverage, bug-bash PRs, FQHC HRSA grants, 340B registration next
Phases done
4/5
PRs merged
7
QA Harness
760 probes × 4 admins
Bug-bash PRs
#87–#93
Perf indexes
Migration 131 · 5 tables
FQHC HRSA
Ph 94 — live
340B
Ph 95 — planned
Ph#Name & PurposeStatusKey Deliverable
91
Interaction Fix Wave 4 — Missing CRUD UI
Added Add/Submit UI to 21 NO-FORM pages + 33 SKIP pages from the deep QA audit. 8 wave plans across BUILD/RENAME/DESCOPE/BACKLOG buckets.
DoneAll NO-FORM → PASS; 10 items → Ph 92 backlog
92
Backend Completion — CRUD Endpoints (BACKLOG-91-A)
10 items from Phase 91 backlog: contracts, practices, fee-schedules, care-plans, specialty-programs, community-resources, provider-alerts, lab-reference, prior-auth-templates, care-protocols. All shipped via PRs #67 #72 #73 #75 #76 #77 #81.
Done10/10 BACKLOG-91-A items resolved
93
QA Campaign — Bug-bash PRs #87–#93
760-probe harness × 4 admin orgs. Fixed: 2 cross-org 500s (insurance_verifications literal mismatch, retroactive enrollments broken join), 5 composite indexes (migration 131), Slack admin permission gate, MFA disable password reauth, migration 131 idempotency, cron log spam summarized.
DoneProvider profiling 17s→1.5s · clinical dashboard 15.8s→1.9s
94
FQHC HRSA Grants Tracking
Grant lifecycle management for FQHC entities: grant applications, award tracking, reporting periods, compliance monitoring, budget vs actual.
DoneFQHC grants module live on nexus.eklotho.com
95
340B Covered Entity Registration — NEXT
340B CE registration form, covered drug tracking, audit trail, compliance monitoring for FQHC entities. SPEC.md written — execution pending.
P0~1 week340B compliance for FQHC clients