Current Architecture
Status: ACTIVE
Audit Date: 2026-03-16
Audit Basis: code-verified repository inspection
Executive Truth
- VERIFIED: Kvary.Network is currently a hybrid system, not a clean microservice platform.
Resolving locale, route permissions, and workspace projection.
Current scope: Guest
Category: 50_architecture | 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
apps/web as the primary UIservices/api as public façade/gateway plus local fallback enginesservices/svc-tenders as the largest remaining operational domain service plus shared KES event backbone hostservices/svc-kes as the canonical extracted KES HTTP/runtime hostservices/svc-auth, services/svc-risk, services/svc-kyc, services/svc-carbon as real side servicespackages/identity-infra as a second backend-style identity/stakeholder runtime with overlapping responsibilitysvc-tenders.sessionStorage, especially in auctions and logistics/equipment.services/api is not only a gateway. It is a façade, proxy layer, fallback engine, and legacy compatibility surface.apps/webapps/web/src/app does page composition.apps/web/src/portal/api.ts performs direct REST fetches and fallback handling.apps/web/src/app/api/ai/ask/route.ts runs server-side AI route logic.sessionStorage for several auction/logistics UX flows.services/apiservices/api/src/server.ts mounts all public routers.services/api is all of the above: gateway, façade, fallback engine, and compatibility layer.services/svc-tenderssvc-tenders is becoming a domain monolith.services/svc-keskes_orchestrator_events persistence./auth/me resolution and the shared KES event backbone that remains in svc-tenders/src/kafka.services/svc-authservices/svc-riskservices/svc-kycservices/svc-carbonpackages/identity-infrasvc-auth and gateway stakeholder routes.packages/corepackages/tender-domainpackages/financial-layerpackages/memory-layer
packages/memory-layer/src/repository.tsapps/web/lib/docsRagBootstrap.ts
packages/coreservices/svc-tendersservices/svc-authservices/api mixes gateway, local engine, fallback, and compatibility concerns.svc-auth and packages/identity-infra both expose auth-like behavior.svc-tendersservices/apiapps/webservices/api/src/server.ts.svc-tenders owns real routes for:
/tenders/tenders/submit/tenders/:id/auctions/auctions/:idsvc-tenders bid mutation route analogous to the local services/api auction engine POST /auctions/:id/bids.services/api/src/routes/kes-orchestrator.ts to services/svc-kes, not to a colocated svc-tenders KES host.svc-authsvc-tenderssvc-kessvc-tenders/src/kafkasvc-carbon