CTC System Reconstruction Coverage Matrix¶
- Status:
CURRENT CROSS-FAMILY COVERAGE — PHASE IMPLEMENTATION USER HOLD - Current source baseline:
qa/master@13991b627eb95b5b675a4eb05048d56f20538439 - Current Roadmap:
docs/ROADMAP.md - Current correction:
Appendix O - Evidence register:
REBUILD_READINESS_GAP_AND_EVIDENCE_REGISTER.md - Important: documentation coverage is not operational or migration readiness.
1. Interpretation¶
DETAILED INPUT
!= RUNTIME VERIFIED
!= TARGET-ROLE VERIFIED
!= FIELD ACCEPTED
!= M3
!= M4
Coverage labels:
| Label | Meaning |
|---|---|
DETAILED INPUT |
detailed source/rebuild/Runbook/Wiki input exists |
PARTIAL INPUT |
meaningful mapping exists but consequential gaps remain |
CURRENT SOURCE PRESENT |
current source exists; evidence may remain missing |
CURRENT SOURCE DELTA |
source changed after the parent packet baseline |
DUAL CONTRACT |
more than one current representation/owner must be reconciled |
POLICY REQUIRED |
owner decision remains open |
EVIDENCE REQUIRED |
DB/role/runtime/provider/physical/Wiki/deployment evidence missing |
TARGET ONLY |
not current Runtime |
HISTORICAL |
valid only for its exact older source/environment |
Migration readiness:
M0 UNMAPPED
M1 DOCUMENTED
M2 SOURCE-RECONCILED
M3 OPERATIONALLY VERIFIED
M4 MIGRATION READY
M5 MIGRATED AND STABILIZED
No family is declared M4 by this matrix.
2. Current Priority Corrections¶
| Family | Current documentation | Current source disposition | Main gap | Evidence |
|---|---|---|---|---|
| Audit/Transition | detailed source authority + current correction | diagnostic metadata and selected writer source present | environment tables/writer/rows/retention | RBR-AUDIT-002 |
| Loader Work Assignment | current source authority + Runbook/Wiki addenda | DUAL CONTRACT |
caller/rows/terminal guard/role/provider | RBR-AWCO-002 |
| Final Loading Review | parent packet + current source delta | reference/read model and outbound correction added | formulas/policy/role/DB/Wiki | RBR-FLR-001, RBR-FLR-002 |
| Street Turn | Process candidate + rebuild/Runbook/Wiki | current create and guarded revert source present | durable relation/idempotency/role/DB/Wiki | RBR-STREET-001 |
3. CTC Execution Families¶
| Family | Documentation | Source | Policy | Evidence | Readiness |
|---|---|---|---|---|---|
| Appointment/Gmail intake | PARTIAL–DETAILED INPUT | current mapping | REQUIRED | provider/role/runtime | M1–M2 |
| Inbound Planning/existing Loader | DETAILED INPUT | current | REQUIRED | role/API/queue/field | M2 input |
| Work Assignment/Clock Out | DETAILED CURRENT CORRECTION | DUAL CONTRACT | REQUIRED | RBR-AWCO-002 |
source present; not M3 |
| Final Loading Review/Bale | DETAILED INPUT + CURRENT SOURCE DELTA | current through 13991b... |
REQUIRED | RBR-FLR-001/002 |
M2 input |
| Warehouse Placement/Map | PARTIAL–DETAILED INPUT | evolving | REQUIRED | data/role/UI | M1–M2 |
| Street Turn | DETAILED CURRENT INPUT | current create/revert | REQUIRED | RBR-STREET-001 |
process candidate / M1–M2 |
| Yard/Pull Out/Driver | DETAILED INPUT | current with adjacent equipment changes | REQUIRED | physical/role/partial | M2 input |
| Billing/QBO/Files/Email | DETAILED INPUT | current source families | REQUIRED | accounting/provider/file/Wiki | M2 input |
4. MK Families¶
| Family | Documentation | Source | Policy | Evidence | Readiness |
|---|---|---|---|---|---|
| Commercial/Inbound/Outbound/Booking | DETAILED INPUT | source-reconciled with equipment adjacency | REQUIRED | role/DB/Scale/compatibility | M2 input |
| Inventory Allocation | DETAILED INPUT | source-reconciled | REQUIRED | UOM/concurrency/reversal/role | M2 input |
| Physical Scale | DETAILED INPUT | source-reconciled | BLOCKING POLICY | four-flow physical/role/device | M2; write migration blocked |
| Trade/Cost/Rate/Documents | DETAILED INPUT | source-reconciled | REQUIRED | accounting/role/output/provider | M2 input |
5. Platform Foundation Families¶
| Family | Documentation | Current state | Main evidence gap | Readiness |
|---|---|---|---|---|
| Tenant/Profile/Capability/Config | DETAILED INPUT | typed/current compatibility mixed | caller/Admin/Client 1/2/config source | M1–M2 |
| Identity/Session/Impersonation | DETAILED INPUT | PHP compatibility current | timeout/revocation/impersonation | M1–M2 |
| Authorization/Access | DETAILED INPUT | mixed guards | complete page/API/action/record matrix | M1–M2 |
| Audit/Correlation/Evidence | DETAILED INPUT + CURRENT CORRECTION | selected foundations present | RBR-AUDIT-002 |
M1–M2 |
| Integration/Provider | DETAILED INPUT | provider-specific mechanisms | credential/callback/reconciliation | M1–M2 |
| Deployment/Observability/Recovery | DETAILED INPUT | topology documented | service/DB/file/scheduler/restore | M1–M2 |
6. Current Source Corrections¶
Audit¶
request/mutation diagnostic != business before/after snapshot
selected transition writer source present != universal/environment coverage
Loader Work Assignment¶
active routes: QUEUE_WORK_ASSIGNMENT + COMMODITY_NAME + FINAL_DRAFT
typed helper: ASSIGNMENT_DATA + requestToken
current canonical contract: unresolved
Final Review¶
Shipper reference != workflow state
Loading Difference = CTC Outbound - CTC Inbound
Pending outbound correction != Confirm/Adjustment
Street Turn¶
create != downstream completion
revert != universal rollback
7. Cross-Family Invariants¶
Tenant != Profile != Module != Capability != Config != Credential != Authorization
Actor != Subject
Menu visible != Page/API/Action/Record allowed
Request diagnostic != Business transition
Local commit != Provider accepted != Local provider reference saved
Physical work != System commit
File metadata != Object readable != Business links complete
Assignment created != notification delivered
Loader Complete != Final Review/Inventory/Yard/Driver complete
Street Turn create != physical/export completion
Revert Street Turn != downstream rollback
Shipper variance != Loading Difference
Edit Outbound != Confirm/Source/Leftover adjustment
Scale Check-out != Purchase finalize/Outbound close
Outbound Save != Allocation
Booking Save != every child synchronized
Trade status != accounting close
Remote master != deployed Runtime
Service live != ready
Archive != backup
Backup complete != restore verified
8. Target Migration Families¶
| Target | Status | Required before activation |
|---|---|---|
| React + Next.js | TARGET RETAINED / USER HOLD | explicit activation, accepted current capability packet, evidence, one writer, rollback |
| TypeScript application/domain | TARGET RETAINED / USER HOLD | accepted state/data/query/command/error contracts |
| provider-scoped worker | TARGET ONLY | separately approved provider family and reconciliation |
| PostgreSQL | FUTURE CONDITIONAL | React + Next.js + MySQL stabilization and restore parity |
9. M3 Minimum¶
- current source/schema identity;
- target-role normal and denied behavior;
- duplicate/timeout/partial/recovery;
- provider/file/physical evidence where applicable;
- current Runbook/Wiki review;
- cleanup/rollback readback;
- owner acceptance.
10. M4 Minimum¶
M3 plus:
- complete target query/command/repository contract;
- selected cohort;
- read parity;
- one authoritative writer;
- rollback without business/provider/physical replay;
- deployment/config/schema identity;
- backup/restore impact;
- observation plan;
- caller-zero/retirement.
11. Current Overall Result¶
major business documentation: DETAILED INPUT
major platform documentation: DETAILED INPUT
current source freshness: MIXED with named corrections
accepted M3 families: NONE established here
M4 families: NONE
Phase implementation: USER HOLD
12. Next Documentation Work¶
- add current-source headers to high-risk packets;
- finish caller/consumer maps;
- define fixture/account/cleanup plans for evidence packages;
- classify historical document consumers before retirement;
- maintain Process/Runbook/Wiki consistency as operational source changes.
Evidence execution remains separately authorized.
---¶
Source:
docs/reconstruction/SYSTEM_RECONSTRUCTION_COVERAGE_MATRIX.md— ctc repository · This page is an English translation of the source document. Identifiers, file paths and code symbols are unchanged.