Architecture / Status

Component Status Matrix

Current implementation status of all Nexus platform components. Referenced by the Deployment Matrix to show what is built, tested, and production-ready.

Version CS-1.0 Date 2026-05-05 Owner Uued Viljapuuaiad Status Active Authority Tier 3

1. Component Status Summary

Status Count Meaning
Production 4 Deployed, tested, actively used
Implemented 8 Code complete, tests pass, not yet in production
Scaffold 12 Structure exists, partial logic, needs completion
Declared 6 Designed in docs, no implementation yet

2. Core Engine Components

Component Module Lines Tests Status Notes
Formula Parser core/formula_parser.py 600 test_rule_store_integrity Production 11 functions, all operators, 2 modes
Rule Engine core/rule_engine.py 238 test_rule_audit Production 6 rule classes, priority ordering
Rule Loader core/rule_loader.py 319 test_rule_store_integrity Production 874 rules across 25 JSON files
BDT Validator core/data_validator.py 373 test_business_data_types Production 21 registered types, lifecycle enforcement
Business Data Types core/business_data_types.py 303 test_business_data_types Production TYPE_REGISTRY with units + constraints
Consolidation Engine core/consolidation_engine.py 349 test_orchestration_engine Implemented Rule class ordering, multi-pass
Context Factory core/context_factory.py 160 test_api Implemented Context dict construction from inputs
Dynamic Rule Engine core/dynamic_rule_engine.py 176 test_rule_editor Implemented Hot-reload, runtime rule updates
Rule Audit core/rule_audit.py 224 test_rule_audit Implemented Execution trace, provenance
Run Tracer core/run_tracer.py 584 test_run_tracer Implemented Step-by-step formula evaluation trace
Config Loader core/config_loader.py 370 test_api Implemented Multi-source config resolution
Domain Model core/domain_model.py 545 test_api Implemented TCO entity classes + attributes

3. Pipeline Components

Component Module Lines Tests Status Notes
EDR Pipeline core/edr_pipeline.py 350 test_api_run_endpoint Production Entity validation, completeness scoring
PFP Pipeline core/pfp_pipeline.py 379 test_pfp_pipeline Production Product Fit Profile evaluation
PFP Table Pipeline core/pfp_table_pipeline.py 273 test_pfp_table_pipeline Implemented Tabular PFP output
Freelance Pipeline core/freelance_pipeline.py 242 test_freelance_pipeline Implemented Job scoring + tier assignment
Ingestion Pipeline core/ingestion_pipeline.py 462 test_api Implemented Generic data ingestion
Orchestration Engine core/orchestration_engine.py 316 test_orchestration_engine Implemented DAG execution, node routing

4. Node Executors (29 total)

4.1 Production-Ready Nodes (substantial implementation + tests)

Node Lines Test Coverage Status
IngestNode 195 test_node_executors_bl06_bl12 Implemented
GpuTransformNode 182 test_delta_prism_gpu Implemented
MatchNode 179 test_node_executors_bl13_bl15 Implemented
DashboardNode 177 test_arc_ui_nodes Implemented
EgressNode 158 test_node_executors_bl06_bl12 Implemented
LeadScoreNode 159 test_node_executors_bl13_bl15 Implemented
BankCsvIngest 152 test_node_executors_bl06_bl12 Implemented
ListViewNode 151 test_arc_ui_nodes Implemented
ConditionBranch 150 test_node_executors_bl13_bl15 Implemented
NavMenuNode 130 test_arc_ui_nodes Implemented
GmailIngest 124 test_node_executors_bl06_bl12 Implemented
StoreNode 120 test_node_executors_bl06_bl12 Implemented
AiTransform 119 test_node_executors_bl06_bl12 Implemented
VoiceIngest 114 test_node_executors_bl16 Implemented
AtlasOcr 112 test_node_executors_bl06_bl12 Implemented
FormNode 110 test_node_executors_bl13_bl15 Implemented
ValidateNode 108 test_node_executors_bl13_bl15 Implemented
EmailForward 108 test_node_executors_bl06_bl12 Implemented

4.2 Scaffold Nodes (minimal implementation, needs expansion)

Node Lines Status Gap
PdfGenerator 93 Scaffold Template engine not connected
HumanGateNode 90 Scaffold Webhook callback not wired
WebhookTrigger 77 Scaffold Signature validation stub
ReportGenerator 71 Scaffold Multi-section aggregation missing
SmsReply 60 Scaffold Gateway integration stub
SmsIngest 59 Scaffold Gateway integration stub
FieldMapper 59 Scaffold Complex mapping expressions TBD
HttpForward 56 Scaffold Retry/circuit-breaker TBD
SchedulerTrigger 47 Scaffold Cron parser minimal
AiTransformVoice 46 Scaffold Transcription pipeline TBD

5. API and Admin

Component Module Lines Tests Status
FastAPI App api/app.py 1647 test_api, test_cors, test_auth Production
Pipeline Routes api/routes_pipelines.py 1666 test_api_run_endpoint Production
Pipeline Versioning API api/routes_pipelines.py -- -- Implemented 2026-05-05 — publish / deactivate / restore / fork / history (REQ-VER-001–004)
Pipeline Descriptor API api/routes_pipelines.py -- -- Implemented 2026-05-05 — GET /descriptor + POST /import (REQ-DESC-001–002)
Org Routes api/routes_orgs.py 289 test_rbac Implemented
Rule Editor Routes api/routes_rule_editor.py 239 test_rule_editor Implemented
ARC Routes api/routes_arc.py 45 test_arc_pipeline Scaffold
Lambda Handler api/lambda_handler.py 19 -- Scaffold
Admin Web App admin/app.py -- test_admin Production
API Key Store core/api_key_store.py 248 test_auth Production
Auth Module auth.py 135 test_auth Production

6. Runtimes

Runtime Module Lines Tests Status Notes
Local runtimes/local.py 82 test_api Production Default execution mode
Databricks runtimes/databricks/ 418 -- Scaffold Notebook + runtime structure exists
Snowflake runtimes/snowflake/ 231 -- Scaffold Runtime skeleton, UDF translation TBD
deltaPrism GPU runtimes/delta_prism_gpu/ 963 test_delta_prism_gpu Implemented Benchmark, compiler, loader, runtime

7. Connectors

Connector Module Lines Tests Status
Access Connector connectors/access_connector.py 448 test_access_connector Production
Access Writer connectors/access_writer.py 390 test_access_writer Production
deltaPrism Adapter core/delta_prism_adapter.py 777 test_delta_prism_adapter Implemented
Datasource core/datasource.py 1133 test_api Production

8. Schema and Validation

Component Module Lines Tests Status
Node Registry Schema schema/node_registry.py 1130 test_schema_node_registry Implemented
Pipeline Validator schema/pipeline_validator.py 283 test_schema_pipeline_validator Implemented
Project Registry config/project_registry.py 116 -- Implemented

9. Test Infrastructure

Metric Value
Total test files 66
Total collected tests 2,325
Playwright E2E (Nexus2) test_nexus_app_login, test_hub_skin_regression, test_run_log_panel, test_automode_headless, test_card_click_nav_flow
Test categories Unit, Integration, E2E, Playwright, Load
Coverage focus Core engine 100%, Node executors 90%, API 85%, Runtimes 40%

10. Declared Components (Not Yet Implemented)

Component Target Use Case Dependency
App Management SPA docs/APP_MGMT.html Hub → App entry point; environment management, pipeline versions, backups, settings, RMB editor NEXUS_APP.html hub cards (navigateToManagement)
Environment Table _tbl_org_environments (Wormwood DB) Per-org environment definitions: name, slug, version, status, url. REQ-ENV-002. routes_orgs.py environment endpoints
RMB Items Table _tbl_org_rmb_items (Wormwood DB) Per-org configurable right-click menu items. REQ-RMB-002. routes_orgs.py rmb-items endpoints
Hub Card RMB Menu NEXUS_APP.html (renderRmbMenu, rmbAction) Context menu on right-click of hub cards. Default 4 items + dynamic per-org items. Demo mode per item. REQ-RMB-001. App Management SPA, _tbl_org_rmb_items
Hub Card Health Indicator NEXUS_APP.html (card health dot) Live ONLINE/DEGRADED/OFFLINE/UNKNOWN dot per card polling production environment status. REQ-ENV-001. Environment Table, /environments/production endpoint
User Management Panel docs/APP_MGMT.html (tab „Użytkownicy”) + wormwood/api/routes_auth.py (new endpoints) Admin-only table of all NexusPlatformUser records. Role change (nexus_user ↔ nexus_admin). Account deactivation/reactivation. Self-protection guards (cannot demote/deactivate self). REQ-AUTH-005, AC-005-01..09. VERIFIED — gate_11 S36 PASS (tab hidden without JWT, visible with nexus_admin JWT, #users section click confirmed). Deployment pending: ACT_deploy_engine_issue073.py awaiting approval. _tbl_nexus_platform_users (migration: add is_active, role_updated_at, role_updated_by — migrate_m_nexus_06.py). JWT nexus_admin role required. Mockups: NEXUS_APP_MOCKUPS.html section 07.
Google OAuth Login wormwood/api/routes_auth.py, docs/NEXUS_APP.html (SPA login flow) REQ-AUTH-001. Google OAuth 2.0 flow. User lands on hub after login. VERIFIED — ISSUE-073 fix applied (HMAC-signed HttpOnly cookie replaces in-memory _STATE_STORE). gate_11 S34 PASS (login DOM, auth_error hash handling). Deployment pending: ACT_deploy_engine_issue073.py awaiting approval. HMAC-SHA256 signed cookie state; nexus_oauth_state HttpOnly cookie (max_age=300, samesite=lax).
RBAC Nav Groups docs/NEXUS_APP.html (_applyNavRbac(), data-nav-access attributes) REQ-AUTH-003, REQ-RBAC-002. Nav groups visible per role: nexus_user sees Documentation only; nexus_admin sees all groups. VERIFIED — gate_11 S35 PASS (nexus_admin shows all, nexus_user shows docs only, null hides all). Deployment pending. JWT role claim required. Depends on Google OAuth login working.
JWT Session Management wormwood/auth_jwt.py, docs/NEXUS_APP.html (sessionStorage['nexus-jwt']) REQ-AUTH-002. JWT HS256 8h expiry. Stored in sessionStorage, cleared on tab close. VERIFIED — gate_11 S36 PASS (JWT set in sessionStorage; #tab-users visible with nexus_admin JWT). Deployment pending. NEXUS_JWT_SECRET env var required on ECS task def.
power-platform controller Nesto on M365 Formula Parser
VBA Transpiler ms-office-vba controller Excel prototype Formula Parser
COBOL Generator mainframe-zos controller Banking legacy Formula Parser
SharePoint Model sharepoint-lists model M365 deployments Domain Model
Cosmos DB Model azure-cosmos-db model Azure graph deployments deltaPrism Adapter
Neptune Model aws-neptune model AWS graph deployments deltaPrism Adapter

11. Version History

Version Date Changes
CS-1.0 2026-05-02 Initial status audit from codebase. 2,325 tests, 29 node executors, 4 runtimes.
CS-1.1 2026-05-05 Added: pipeline versioning & publish API (REQ-VER), descriptor export/import (REQ-DESC), base_slug migration (REQ-VER-006), sections-format nav normalisation fix, enterWorkspace auto-load first view, test_card_click_nav_flow. NEXUS_APP.html apiBase port corrected 8011→8010. 85 pipelines / 14 orgs registered. routes_pipelines.py 1482→1666 lines.
CS-1.2 2026-05-06 Added: REQ-ENV (environment management per app, 10 API endpoints), REQ-MGMT (App Management page SPA replacing direct card-to-workspace navigation), REQ-RMB (right-click context menu with per-org dynamic items and demo mode). Hub card click flow changed: card → APP_MGMT.html (not direct enterWorkspace). 5 new declared components. NEXUS_APP_SPEC.html US-HUB-020 updated. NEXUS_LLD.html port corrected 8011→8012, card flow updated, new screen 7b added, 12 new API endpoints documented. NEXUS_APP_REQUIREMENTS.html 12 new requirements (REQ-ENV-001–004, REQ-MGMT-001–003, REQ-RMB-001–005). NEXUS_BACKLOG.html BL27–BL33 added.
Uued Viljapuuaiad OU — Nexus Platform Documentation
Component Status Matrix CS-1.1 — 2026-05-05