Resolving locale, route permissions, and workspace projection.
Current scope: Guest
Category: 10_normative | Version: v1.0.0
Owner: DOCUMENT_CUSTODIAN | Review cycle: 90 days
Approval authority: GOVERNANCE_ADMIN
Documentation portal is read-only. Editing and mutation endpoints are disabled.
Kvary platform is originally created in Georgian. Where a Georgian version exists, Georgian is authoritative for platform UI, documentation, and legal interpretation.
Translations into other languages are provided for convenience. Some records may originate in other languages and carry their own source or legal locale for a specific flow, but where a Georgian version is available, the Georgian version prevails for platform-level wording and interpretation.
Metadata incomplete: Document ID, Version, Owner Role, Last Review Date, Next Review Date, Change Log
Status: ACTIVE
Audit Date: 2026-03-16
Audit Basis: code-verified repository inspection
| 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 services/gateway; SDK layer exists; event-driven is future-oriented | poor match | MISLEADING | actual gateway is services/api; Kafka is already real in KES |
| services/api/README.md | stateless gateway + endpoint examples | partial match | PARTIALLY OUTDATED | some concepts right, several endpoint examples are stale/inaccurate |
| services/svc-tenders/README.md | tender service with Kafka/outbox/DLQ/projection flows | strong match | CORRECT | one of the safest docs |
| docs/80_chain/EVENT_CATALOG.md | KES/outbox topic catalog | strong match | CORRECT | good source for KES event truth |
| docs/80_chain/OUTBOX_E2E_RUNBOOK.md | operational outbox flow/runbook | strong match | CORRECT | useful operator doc |
| docs/80_chain/CHAIN_OVERVIEW.md | high-level chain orientation | limited runtime truth | PARTIALLY OUTDATED | too abstract for current topology truth |
| docs/80_chain/MULTICHAIN_ORCHESTRATION_C4.md | multichain orchestration architecture | partial demo match | PARTIALLY OUTDATED | should be framed explicitly as target/demo, not current platform core |
| docs/80_chain/SINGLE_OPERATOR_MODE.md | single-operator orchestration mode | demo/script aligned | PARTIALLY OUTDATED | not representative of everyday product runtime |
| services/governance/README.md | governance service framing | weak match | MISLEADING | service is doc/artifact-heavy, not a real runnable backend |
| docs/90_topology/TOPOLOGY_OVERVIEW.md | topology overview | too abstract | PARTIALLY OUTDATED | not enough to guide engineering truth |
| docs/99_audit_logs/AUDIT_LOG_OVERVIEW.md | audit log folder overview | narrow scope | CORRECT | but not useful for runtime topology |
Use these first:
Treat these as historical hypotheses, not source of truth:
README.mdARCHITECTURE.mdservices/governance/README.mdARCHITECTURE.md references services/gatewayservices/api/src/server.tsREADME.md and ARCHITECTURE.md reference packages/sdkREADME.md says apps/web -> UI onlyapps/web/src/portal/api.tsapps/web/src/app/apiservices/api contains local auction and tender engines/fallback behavior.501 in services/api/src/routes/stakeholder-applications.tspackages/identity-infra/src/server.tsdocs/CURRENT_ARCHITECTURE.mddocs/EVENT_DRIVEN_ARCHITECTURE.mddocs/MOCK_VS_REAL_MATRIX.mddocs/CANONICAL_WRITE_PATHS.mddocs/SERVICE_BOUNDARIES.mddocs/AUTH_AND_IDENTITY_BOUNDARY.mddocs/KAFKA_TOPIC_CATALOG.mddocs/DOCUMENTATION_DRIFT_REPORT.mdREADME.md architecture sections should be trimmed and point to docs/CURRENT_ARCHITECTURE.mdARCHITECTURE.md should be rewritten or archived