DOCUMENTATION DRIFT REPORT

Current scope: Gest

Category: 10_normative | Version: v1.0.0

Owner: DOCUMENT_CUSTODIAN | Review cycle: 90 days

Approval Authority: GOVERNANCE_ADMIN

Read-only Documentation Portal. Editing and mutation endpoints are disabled.

METADATA INCOMPLETE: Document ID, Version, Owner Role, Last Review Date, Next Review Date, Change Log

Documentation Drift Report

Status: ACTIVE
Audit Date: 2026-03-16
Audit Basis: code-verified repository inspection

Executive Truth

VERIFIED: several top-level docs teach a cleaner topology than the repo actually runs.
VERIFIED: the safest architecture truth is currently in code plus a small subset of event/outbox docs.
VERIFIED: future AI coding sessions are likely to inherit wrong assumptions unless architecture docs are corrected.

Docs Matrix

| Document | What it claims | Match to code | Status | Notes | | --- | --- | --- | --- | --- | | README.md | apps/web is UI-only; packages/sdk exists; repo is cleanly microservice-first | poor match | MISLEADING | apps/web calls REST directly and has fallback/session-local logic; packages/sdk not found | | ARCHITECTURE.md | gateway is ; SDK layer exists; event-driven is future-oriented | poor match | MISLEADING | actual gateway is ; Kafka is already real in KES | | | stateless gateway + endpoint examples | partial match | PARTIALLY OUTDATED | some concepts right, several endpoint examples are stale/inaccurate | | | tender service with Kafka/outbox/DLQ/projection flows | strong match | CORRECT | one of the safest docs | | | KES/outbox topic catalog | strong match | CORRECT | good source for KES event truth | | | operational outbox flow/runbook | strong match | CORRECT | useful operator doc | | | high-level chain orientation | limited runtime truth | PARTIALLY OUTDATED | too abstract for current topology truth | | | multichain orchestration architecture | partial demo match | PARTIALLY OUTDATED | should be framed explicitly as target/demo, not current platform core | | | single-operator orchestration mode | demo/script aligned | PARTIALLY OUTDATED | not representative of everyday product runtime | | | governance service framing | weak match | MISLEADING | service is doc/artifact-heavy, not a real runnable backend | | | topology overview | too abstract | PARTIALLY OUTDATED | not enough to guide engineering truth | | | audit log folder overview | narrow scope | CORRECT | but not useful for runtime topology |

Loading workspace

Loading module

Loading workspace

DOCUMENTATION DRIFT REPORT

Documentation Drift Report

Executive Truth

Docs Matrix

Safest Docs For AI Tools

Dangerous Docs For AI Tools

Specific Drift Findings

1. Wrong gateway name

2. Non-existent SDK layer

3. “UI only” web claim is false

4. Gateway docs understate fallback engines

5. Reviewer workflow docs are incomplete

Missing Docs That Need To Exist

Replacement Guidance

Replace or supersede

Keep, but reframe