Skip to content

CTC Rebuild-Readiness Gap And Evidence Register

  • Status: CURRENT DOCUMENTATION-ONLY EVIDENCE PLAN
  • Current source baseline: qa/master@13991b627eb95b5b675a4eb05048d56f20538439
  • Current Roadmap: docs/ROADMAP.md
  • Coverage: SYSTEM_RECONSTRUCTION_COVERAGE_MATRIX.md
  • Phase implementation: USER HOLD
  • Important: defining an evidence package does not authorize it to run.

1. Evidence Principles

source inspection != runtime execution
runtime execution != target-role acceptance
target-role acceptance != provider/physical acceptance
source release != current DB/Wiki/stabilization
detailed documentation != M3 != M4

Every executed package must state:

  • exact source revision;
  • environment/deployment/DB;
  • tenant/profile;
  • actor/subject/role;
  • page/API/command/record;
  • authorized effect;
  • before state/action/expected result;
  • authoritative reread;
  • cleanup/rollback;
  • sensitive-data handling;
  • PASS/FAIL/BLOCKED/NOT_RUN;
  • accepting owner.

2. Evidence Classes

Code Evidence
SRC source/caller/consumer/drift
SCH schema/index/constraint
DAT authoritative rows/relations/balances
ROL role/page/API/action/record
RUN normal/denied/duplicate/timeout/recovery
PHY physical Yard/Scale/Loader/Driver
PRO provider/search/callback/reconciliation
FIL object/metadata/link/readability
WIK Wiki row/render/role/findability
DEP deployed source/config/schema/service
BAK backup/restore/RPO/RTO
MIG read parity/one writer/rollback/caller-zero
OBS stabilization/usage/error/backlog

3. Cross-Cutting Packages

RBR-EV-001 — Current refs and source drift

  • confirm synchronized qa/master;
  • list source commits after family packet baselines;
  • classify each family as no relevant drift, documentation-only, source affected, or unknown;
  • update current source-authority/delta documents.

RBR-EV-010 — Client 1 access matrix

role
x menu/page
x initial data API
x action API
x record predicate
x state predicate
x visible action/result
x expected allow/deny

RBR-EV-011 — Client 2 expected matrix

Define expected profile/module/capability/config/access before operation. Do not compensate for missing setup through customer-specific source branches.

RBR-EV-020 — Current schema inventory

Read-only:

  • DB identity/version;
  • table/column/index/constraint list;
  • applied migration state;
  • differences from canonical docs and source packets.

RBR-EV-030 — Current Wiki inventory

Per priority slug:

  • row and Markdown hash;
  • page-route mapping;
  • rendered page;
  • role visibility/findability;
  • current labels/screenshots;
  • current/stale/missing classification.

RBR-EV-040 — Deployed identity

  • remote refs;
  • deployed source/service identity;
  • effective config reference;
  • DB identity/schema;
  • installed service/scheduler definitions;
  • no mutation/restart.

RBR-EV-050 — Backup/restore inventory

  • database snapshot/PITR owner and age;
  • archive scope;
  • object/file backup/versioning;
  • config/credential recovery;
  • service-local state;
  • last restore rehearsal;
  • approved/measured RPO/RTO.

4. Current Audit Package

RBR-AUDIT-002 — Current Audit And Transition Environment Inventory

Owner inputs:

Required read-only evidence:

KJ diagnostic

  • actual current log shape and redaction;
  • statement/table/affected-row/transaction/error fields;
  • confirm no general before/after business-row snapshots;
  • request ID/correlation support;
  • retention/location/rotation owner.

Transition schema

  • table existence;
  • columns/indexes/constraints;
  • context/envelope version;
  • tenant/idempotency/hash uniqueness;
  • retention/legal-hold fields.

Writer inventory

  • selected Loader writer callers;
  • exact transitions and transaction mode;
  • any other writers;
  • no-writer processes;
  • current deployed/source identity.

Rows

  • current counts by Process/transition/result/effect boundary;
  • idempotent duplicates/conflicts if present;
  • evidence-reference readability;
  • no raw secret/payload leakage.

Notification boundary

  • T_OPERATION_EVENT ACK means read only;
  • no code/path treats ACK as business approval/completion.

Result classification:

SCHEMA VERIFIED
WRITER SOURCE VERIFIED
RUNTIME WRITER VERIFIED or NOT_ESTABLISHED
CURRENT ROWS VERIFIED or EMPTY/UNKNOWN
RETENTION POLICY OPEN

No DB write is authorized by this package definition.

5. Loader Work Assignment Packages

RBR-LOAD-001 — Existing Planning/Loader parity

  • planning/assignment/start/complete;
  • multi-loader behavior;
  • queue order;
  • Break/Clock interaction;
  • Office override;
  • response loss and exact reread.

RBR-AWCO-002 — Current Dual-Contract Reconciliation

Owner:

Source/callers

  • active /work-assignments route callers;
  • current Board/Loader UI callers;
  • typed helper callers;
  • terminal-guard callers;
  • queue resolver and status consumers;
  • dead/unreferenced functions.

Schema/data

  • ASSIGNMENT_DATA column/index state;
  • rows using ASSIGNMENT_DATA;
  • rows using QUEUE_WORK_ASSIGNMENT/FINAL_DRAFT;
  • rows using both;
  • active current/terminal duplicates;
  • JSON validity;
  • CANCELED/CANCELLED values;
  • event links.

Role/UI

  • Office/Manager create/list/cancel;
  • Loader own-record current/start/complete;
  • foreign Loader denial;
  • pre-Start concealment;
  • Clock advice tooltip hover/focus across assignment groups;
  • mobile/keyboard behavior.

Integrity/recovery

  • create response loss;
  • same-Loader concurrent create/start;
  • Work/Load/Break shared queue;
  • terminal Clock Out blocking later Work/Break for both representations;
  • one active/current job;
  • duplicate Job/Clock/Break events;
  • cancel/reorder.

Provider

  • assignment committed/message failed;
  • message recovery on existing row;
  • local Clock Out committed/external time failed;
  • no local replay.

Wiki

  • current named rows/rendered pages;
  • current labels and role navigation;
  • stale historical/future wording.

Current state:

DEFINED / NOT AUTHORIZED TO RUN

6. Final Loading Review Packages

RBR-FLR-001 — Normal, display, Confirm and recovery

  • Pending/Completed queues;
  • Data/Source/Leftover/Weight/Ready/Confirmed;
  • Confirm/Bulk/Reopen;
  • Source/Leftover/ledger;
  • Shipper/CTC comparison;
  • Avg/Bale/inconsistent/high-average states;
  • selected-row continuity;
  • role/mobile/current Wiki.

RBR-FLR-002 — Pending Outbound Correction

Owner:

Required:

Access/state

  • intended Office role and denied roles;
  • Pending-only behavior;
  • TRANSLOADED and SPARE variants;
  • Confirmed/reopened behavior.

Validation

  • positive whole quantity;
  • required positive weight;
  • effective weight-optional disposition;
  • customer-name compatibility and target policy mapping;
  • null/zero/UOM handling.

Concurrency/recovery

  • expected old quantity/weight conflict;
  • simultaneous operators;
  • response loss;
  • exact state reread;
  • no duplicate correction.

Result

  • updated outbound values;
  • reason clear behavior;
  • recalculated state;
  • Loading Difference/Avg/Bale/warnings;
  • Source/Leftover/ledger unchanged unless separately commanded;
  • Confirm after correction.

Audit/Wiki

  • old/new/reason evidence gap;
  • current page labels/mobile selected-row behavior;
  • current Wiki row/render wording.

7. Street Turn Package

RBR-STREET-001 — Street Turn Create And Guarded Revert

Owner:

Create

  • eligible Import Empty source;
  • same SSL/size multi-selection;
  • matching export Booking/cutoff/capacity;
  • original EMPTY -> RETURNED;
  • generated export EMPTY;
  • container Booking/AVAILABLE state;
  • per-row mixed result;
  • response loss and concurrent create.

Revert

  • exact generated export load;
  • container still AVAILABLE;
  • no Delivery/Transload history;
  • exact prior returned import load;
  • generated load inactive;
  • prior import EMPTY;
  • Booking cleared/state reset;
  • stale/concurrent guards;
  • response loss.

Role/UI/Wiki

  • Import/Export/Container roles;
  • backend action/record denial;
  • mobile/keyboard/per-row result;
  • current Wiki rows/rendered pages;
  • no universal rollback wording.

Data gap

  • absence/presence of durable Street Turn relation/request identity;
  • current historical duplicates/ambiguous source pairs;
  • audit/evidence linkage.

8. Other CTC Packages

RBR-APPT-001

Appointment/Gmail intake duplicate/reschedule/cancel/reply reconciliation.

RBR-YARD-001

Yard queue, Pull Out partial result, queue-after-clear, Driver, parking, and no repeated physical action.

RBR-BILL-001

Local Billing/AR confirmation and correction.

RBR-QBO-001

Provider unknown-result search/reconcile and no duplicate invoice.

RBR-FILE-001

File object/metadata/link/readability/delete/orphan recovery.

RBR-MAIL-001

BOL/Packing mail message/recipient/part unknown-result recovery.

9. MK Packages

RBR-MKCORE-001

Commercial/Inbound/Outbound/Booking normal and compatibility behavior.

RBR-ALLOC-001

Allocation quantity/weight/UOM/concurrency/idempotency/reversal.

RBR-SCALE-001

Purchase/Doortrade/Sales/Export stage direction, role, browser/API/DB/device evidence.

RBR-TRADE-001

Trade projection, Export job, Cost, Rate, and output document evidence.

10. Platform Packages

RBR-TENANT-001

Tenant/Profile/Module/Capability/Config effective-state parity.

RBR-IDENTITY-001

Session/actor/subject/impersonation/current timeout/revocation.

RBR-ACCESS-001

Page/API/action/record authorization parity.

RBR-INTEGRATION-001

Provider/callback/scheduler/current recovery inventory.

RBR-DEPLOY-001

Deployed source/config/schema/service identity.

RBR-RESTORE-001

Complete backup set, isolated restore, reconciliation, and measured RPO/RTO.

11. Migration Packages

RBR-MIG-001 read parity
RBR-MIG-002 one-writer cutover
RBR-MIG-003 rollback without replay
RBR-MIG-004 caller-zero

Migration packages remain inactive while Phase implementation is held.

12. Evidence Result Format

Package ID
Source revision
Environment/tenant/role
Authorized effects
Scenario IDs
Before state
Action
Expected result
Authoritative reread
Cleanup/rollback
Sensitive-data handling
PASS/FAIL/BLOCKED/NOT_RUN
Accepting owner
Open defects

13. Current Overall State

Evidence definitions: PRESENT
Current execution authorization: NONE FROM THIS REGISTER
Accepted M3: NONE established here
M4: NONE
Phase implementation: USER HOLD

14. Maintenance

Update this register when source drift, policy acceptance, current role/DB/provider/physical/Wiki/deployment evidence, migration activation, or stabilization changes.

---

Source: docs/reconstruction/REBUILD_READINESS_GAP_AND_EVIDENCE_REGISTER.md — ctc repository · This page is an English translation of the source document. Identifiers, file paths and code symbols are unchanged.