services/api Responsibility Map
Status: ACTIVE
Audit Date: 2026-03-16
Cleanup Sprint: 01
Loading module
Resolving locale, route permissions, and workspace projection.
Resolving locale, route permissions, and workspace projection.
النطاق الحالي: ضيف
الفئة: 10_normative | الإصدار: v1.0.0
المالك: DOCUMENT_CUSTODIAN | دورة المراجعة: 90 يومًا
جهة الاعتماد: GOVERNANCE_ADMIN
بوابة الوثائق للقراءة فقط. نقاط نهاية التعديل والتغيير معطلة.
منصة Kvary أُنشئت أصلًا باللغة الجورجية. وحيثما تتوفر نسخة جورجية، تبقى الجورجية هي اللغة المعتمدة لواجهة المنصة والوثائق والتفسير القانوني.
تُوفَّر الترجمات إلى اللغات الأخرى لسهولة الاستخدام فقط. وقد تنشأ بعض السجلات بلغات أخرى وتحمل لغة مصدر أو لغة قانونية خاصة بذلك المسار، ولكن حيثما تتوفر نسخة جورجية تكون الأولوية للنسخة الجورجية في صياغة المنصة وتفسيرها.
البيانات الوصفية غير مكتملة: Document ID, Version, Owner Role, Last Review Date, Next Review Date, Change Log
Status: ACTIVE
Audit Date: 2026-03-16
Cleanup Sprint: 01
This document classifies services/api route/modules by actual responsibility.
Use these labels:
gatewayfaçadefallbackmock/fixturecompatibilityshould-move-later| Module | Classification | State | Notes |
| --- | --- | --- | --- |
| services/api/src/routes/auth.ts | gateway + façade | REAL | mostly proxies to svc-auth, but /me is gateway-composed |
| services/api/src/routes/profile.ts | gateway | REAL | profile proxy to auth service |
| services/api/src/routes/risk.ts | gateway | REAL | direct service façade |
| services/api/src/routes/icpi.ts | gateway | REAL | direct svc-tenders façade |
| services/api/src/routes/butkhuzi.ts | gateway | REAL | direct svc-tenders façade |
| services/api/src/routes/kes-orchestrator.ts | façade + eventing edge | REAL | proxies to svc-tenders and emits Kafka proxy events |
| services/api/src/routes/kes.ts | façade | MIXED | KES-related surface, not the durable event backbone itself |
| services/api/src/routes/stakeholder-context.ts | gateway | REAL | proxies stakeholder context reads |
| services/api/src/routes/land-owner-onboarding.ts | gateway | REAL | proxies onboarding mutation subflows |
| services/api/src/routes/stakeholder-applications.ts | façade + partial stub | MIXED | draft/submit/events/projection proxied; reviewer actions stubbed |
| services/api/src/routes/tenders.ts | gateway + compatibility | MIXED | modern proxy routes plus mounted legacy flow |
| services/api/src/tenders/gateway.ts | fallback | MIXED | upstream proxy plus read fallback for list/detail |
| services/api/src/tenders/legacyRoutes.ts | compatibility route shell | MIXED | mounts legacy local-engine actions and keeps route-level compatibility behavior explicit |
| services/api/src/tenders/legacyBridge.ts | compatibility bridge | MIXED | gateway-side legacy outbox enqueue bridge used by tender legacy routes |
| services/api/src/tenders/engine.ts | should-move-later | UI-FIRST | local legacy domain engine, not canonical public truth |
| services/api/src/routes/auctions.ts | gateway + fallback surface | MIXED | read proxy plus mounted local engine |
| services/api/src/auctions/gateway.ts | fallback | MIXED | upstream read proxy and local-engine fallback helpers |
| services/api/src/auctions/localEngineRoutes.ts | fallback + compatibility | MIXED | local action flow for create/open/bid/award/settle |
| services/api/src/auctions/engine.ts | should-move-later | UI-FIRST | local auction engine, not canonical service-owned action path |
| services/api/src/routes/map.ts | mock/fixture | SHELL | fixture-backed projection endpoint |
| services/api/src/routes/stakeholders.ts | mock/fixture | SHELL | fixture-backed stakeholder /me |
| services/api/src/routes/registerApiV1Routes.ts | façade composition | REAL | cleanup sprint grouping layer |
| services/api/src/server.ts | runtime boot | REAL | now thin bootstrap only |
/api/v1/auth/*/api/v1/profile/*/api/v1/risk/*/api/v1/icpi/*/api/v1/butkhuzi/*/api/v1/stakeholder-context/*/api/v1/stakeholder-applications/:id/*/api/v1/kes/orchestrator/*/api/v1/stakeholder-applications/*Reason:
/api/v1/auctions/api/v1/auctions/:id/api/v1/tenders/api/v1/tenders/:idReason:
/api/v1/tenders/legacy/*/api/v1/tenders/legacy/*/api/v1/map/overview/api/v1/stakeholders/meroutes/auctions.ts into:
routes/tenders.ts into:
services/api/src/auctions/engine.tsservices/api/src/tenders/engine.tsmap and stakeholders routesReason: