Resolving locale, route permissions, and workspace projection.
Current scope: Guest
Category: 80_chain | Version: v1.0.0
Owner: DOCUMENT_CUSTODIAN | Review cycle: 60 days
Approval authority: GOVERNANCE_ADMIN, CHAIN_OFFICER
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, Status, Owner Role, Last Review Date, Next Review Date, Change Log
Last updated: 2026-03-06
| Topic | Purpose | Producer | Consumer / Tooling | | --- | --- | --- | --- | | | KES proxy mutation events () | ( route) | | | | Dead-letter events for failed processing | | | | | Domain events from DB outbox ( + streams) | | |
kes.orchestrator.eventsmethod/path/statusCodeservices/apikes-orchestratorservices/svc-tendersconsume:kes-eventskes.orchestrator.events.dlqkes.orchestrator.eventsservices/svc-tenderskesEventConsumerreplay:kes-dlqkes.orchestrator.domain-eventstenderskes_orchestratorservices/svc-tendersrelay:kes-outboxconsume:kes-domain-eventskes.orchestrator.domain-events)Current envelope version: schemaVersion = "1.0.0"
Top-level fields:
eventIdeventTypeeventVersionoccurredAtintentIdproducerpayloadpayload common fields (from outbox triggers):
eventTypeeventVersionactorIdsourcePayloadtenderId (for tenders stream) or caseId (for kes_orchestrator stream)Source: tenders_events table + outbox trigger (0028_tenders_events_outbox.sql)
| Event Type | Emitted from API | Stream | Persisted in tenders_events | Enqueued to outbox |
| --- | --- | --- | --- | --- |
| TENDER_SUBMITTED | POST /tenders/submit | tenders | Yes | Yes |
| TENDER_APPROVED | POST /admin/tenders/:id/approve | tenders | Yes | Yes |
| TENDER_REJECTED | POST /admin/tenders/:id/reject | tenders | Yes | Yes |
Source: legacy_tender_events table + outbox trigger (0031_legacy_tender_events_outbox.sql)
| Event Type | Emitted from API legacy flow | Stream | Persisted in legacy_tender_events | Enqueued to outbox |
| --- | --- | --- | --- | --- |
| TENDER_CREATED | POST /api/v1/tenders/legacy/propose | tenders_legacy | Yes | Yes |
| BID_SUBMITTED | POST /api/v1/tenders/legacy/:id/bids | tenders_legacy | Yes | Yes |
| BIDDING_CLOSED | POST /api/v1/tenders/legacy/:id/close | tenders_legacy | Yes | Yes |
| AWARD_PROPOSED | POST /api/v1/tenders/legacy/:id/award/propose | tenders_legacy | Yes | Yes |
| AWARD_RATIFIED | POST /api/v1/tenders/legacy/:id/award/ratify | tenders_legacy | Yes | Yes |
Source: kes_orchestrator_events table + outbox trigger (0027_kes_outbox.sql)
| Event Type | Typical action | Stream | Enqueued to outbox |
| --- | --- | --- | --- |
| CASE_CREATED | Create case | kes_orchestrator | Yes |
| LANDOWNER_APPROVED | Landowner approval | kes_orchestrator | Yes |
| AUCTION_PUBLISHED | Auction publication | kes_orchestrator | Yes |
| FUNDING_CONFIRMED | Funding confirmation | kes_orchestrator | Yes |
| TASK_ASSIGNED | Task assignment | kes_orchestrator | Yes |
| INSPECTION_SUBMITTED | Inspection submission | kes_orchestrator | Yes |
| PAYMENT_REQUESTED | Payment request | kes_orchestrator | Yes |
| PAYMENT_APPROVED | Payment approval | kes_orchestrator | Yes |
| PAYMENT_SETTLED | Payment settlement | kes_orchestrator | Yes |
| CASE_CLOSED | Case close | kes_orchestrator | Yes |
consume:kes-domain-events is implemented and writes to:
kes_domain_event_projection_eventskes_domain_event_projection_counterskes_domain_event_projection_aggregateskafka_consumer_idempotency.replay:kes-outbox-poison.kes.orchestrator.domain-events:
schemaVersion, eventType, eventVersion, eventId, occurredAt, intentId, producer, payloadreasonCode.TENDER_CANCELLED event (requires cancel endpoint wiring in svc-tenders API layer).TENDER_REOPENED event (requires reopen endpoint wiring in svc-tenders API layer).kes.orchestrator.domain-events.eventType + schema evolution rules per event family).