Resolving locale, route permissions, and workspace projection.
النطاق الحالي: ضيف
الفئة: 10_normative | الإصدار: v1.0.0
المالك: DOCUMENT_CUSTODIAN | دورة المراجعة: 90 يومًا
جهة الاعتماد: GOVERNANCE_ADMIN
بوابة الوثائق للقراءة فقط. نقاط نهاية التعديل والتغيير معطلة.
منصة Kvary أُنشئت أصلًا باللغة الجورجية. وحيثما تتوفر نسخة جورجية، تبقى الجورجية هي اللغة المعتمدة لواجهة المنصة والوثائق والتفسير القانوني.
تُوفَّر الترجمات إلى اللغات الأخرى لسهولة الاستخدام فقط. وقد تنشأ بعض السجلات بلغات أخرى وتحمل لغة مصدر أو لغة قانونية خاصة بذلك المسار، ولكن حيثما تتوفر نسخة جورجية تكون الأولوية للنسخة الجورجية في صياغة المنصة وتفسيرها.
البيانات الوصفية غير مكتملة: Document ID, Version, Status, Owner Role, Last Review Date, Next Review Date, Change Log
This document is a grounded inventory of the current AI assistant and RAG foundation already present in this repository as of Sprint inventory review. It describes code and documentation truth, not aspirational architecture.
The repo already contains the beginnings of a real AI-native assistant stack, but it is not yet a broad general assistant.
What is already real:
apps/web/api/ai/ask backend routeWhat is not yet true:
The current implementation is best described as:
The most concrete current assistant path is:
/api/ai/askapps/web/lib/docsRagBootstrap.tsanswerPositioningQuestion(...)Important truth:
| Item | Location | Verified | State | Surface Type | Current Truth |
| --- | --- | --- | --- | --- | --- |
| Assistant chat widget and drawer | apps/web/src/components/ai/* and apps/web/src/ui/components/ActionRail.tsx | VERIFIED | IMPLEMENTED | PRODUCT SURFACE | Real user-facing assistant UI is mounted in the product shell. |
| AI ask endpoint | apps/web/src/app/api/ai/ask/route.ts | VERIFIED | IMPLEMENTED | INFRA SURFACE / PRODUCT SURFACE | Real assistant backend route with intent classification, docs retrieval, memory access, answer assembly, and audit logging. |
| AI status endpoint | apps/web/src/app/api/ai/status/route.ts | VERIFIED | IMPLEMENTED | INFRA SURFACE | Exposes docs RAG provider, document count, chunk count, and embedding mode. |
| AI audit endpoints | apps/web/src/app/api/ai/audit/* | VERIFIED | IMPLEMENTED | INFRA SURFACE | Admin-visible AI audit read and verification surface exists. |
| AI gateway and model registry | packages/ai-layer/src/gateway/* | VERIFIED | IMPLEMENTED | INFRA SURFACE | Real OpenAI request path, allowlist, rate limiting, token/cost tracking, and model registry. |
| Current answer engine | packages/ai-layer/src/assistants/positioning/answer.ts | VERIFIED | IMPLEMENTED | INFRA SURFACE | Deterministic evidence-based responder, not a broad tool-using assistant. |
| Intent classifier | packages/ai-layer/src/intent/classifier.ts | VERIFIED | IMPLEMENTED | INFRA SURFACE | Real classifier for greeting, governance, strategic, unknown. |
| Docs RAG bootstrap | apps/web/lib/docsRagBootstrap.ts | VERIFIED | IMPLEMENTED | INFRA SURFACE | Loads docs, chunks them, embeds them, and serves retrieval from an in-memory vector store. |
| RAG pipeline primitives | packages/ai-layer/src/rag/* | VERIFIED | IMPLEMENTED | INFRA SURFACE | Chunking, embeddings, vector store, retrieval filters, citations, ranking helpers. |
| Conversation memory storage | packages/memory-layer/* | VERIFIED | IMPLEMENTED | INFRA SURFACE | Real DB-backed founder chat sessions/messages persistence. |
| Memory retrieval/ranking beyond recency | packages/memory-layer/* | VERIFIED | PARTIAL | INFRA SURFACE | Recent-message recall exists, but richer semantic or long-horizon memory retrieval is not present. |
| Repo/code context provider | packages/ai-layer/src/code/* | VERIFIED | PARTIAL | INFRA SURFACE | Interfaces/helpers exist, but no verified product path uses them as a real assistant repo-context layer. |
| Butkhuzi norms retrieval | services/svc-butkhuzi/*, services/api/src/routes/butkhuzi.ts, apps/web/src/portal/api.ts | VERIFIED | IMPLEMENTED | KNOWLEDGE SURFACE | Strong domain corpus with list, suggest, chunk search, upsert, rebuild. |
| Butkhuzi product consumption | apps/web/src/app/[locale]/(portal)/kes/page.tsx, apps/web/src/app/snip-manual/page.tsx | VERIFIED | IMPLEMENTED | PRODUCT SURFACE / KNOWLEDGE SURFACE | Norms and chunk search are already consumed in real product workflows. |
| Document registry | apps/web/src/lib/docs/documentRegistry.ts | VERIFIED | IMPLEMENTED | KNOWLEDGE SURFACE | Structured document catalog with metadata suitable for retrieval and filtering. |
| Document manifest metadata | docs/_manifest/* | VERIFIED | IMPLEMENTED | KNOWLEDGE SURFACE / DOC-ONLY | Rich structured metadata for procedures, tags, audiences, governance links. |
| Governance docs portal | apps/web/src/components/docs/DocsPortalPage.tsx | VERIFIED | IMPLEMENTED | PRODUCT SURFACE / KNOWLEDGE SURFACE | Docs are already rendered, filtered, role-scoped, and acknowledged in product UI. |
| Document access log | apps/web/src/lib/docs/documentAccessLog.ts | VERIFIED | IMPLEMENTED | KNOWLEDGE SURFACE / INFRA SURFACE | Read/acknowledgement history exists, but not yet integrated as assistant retrieval context. |
| AI governance policy source | docs/10_normative/KVARY_AI_* | VERIFIED | IMPLEMENTED | DOC-ONLY / KNOWLEDGE SURFACE | Clear policy and audit/memory guardrails exist and are queryable through docs RAG. |
| Evidence storage | services/svc-tenders/src/evidenceStorage.ts and web evidence APIs | VERIFIED | IMPLEMENTED | KNOWLEDGE SURFACE / INFRA SURFACE | Evidence objects exist operationally, but assistant-oriented indexing/retrieval is not yet implemented. |
| KES traceability UI | apps/web/src/features/kesTrace/* | VERIFIED | PARTIAL | UI-ONLY / KNOWLEDGE SURFACE | Traceability surface exists, but current data is generated/fixture-like rather than a verified assistant knowledge backend. |
| Event history as assistant source | services/*/kafka/*, event docs | VERIFIED | PARTIAL | KNOWLEDGE SURFACE / INFRA SURFACE | Real event backbone exists, but no general assistant retrieval interface over it was verified. |
| Embeddings-backed persistent knowledge store | repo-wide | VERIFIED | MISSING | INFRA SURFACE | Embeddings exist, but no generalized persistent vector DB or cross-domain assistant retrieval store was verified. |
Current status:
Why it is strong:
This is currently the most mature assistant-ready corpus in the repo.
Current status:
Why it is strong:
This is currently the strongest non-doc domain knowledge source for an assistant.
Current status:
Why:
Current status:
Why:
Current status:
Why:
Current status:
Why:
Current status:
Why:
Current status:
Why:
apps/web/api/ai/askBased on code truth, the platform is not “fully AI-native” yet, but it is no longer at zero.
The current direction is best described as:
The repo already has enough real pieces to justify assistant development, but the right framing is not “generic chatbot.” The right framing is a grounded knowledge assistant built from:
Build the next assistant step as a multi-source retrieval hardening pass centered on docs plus Butkhuzi, not as a generic new chat UI.
Concretely, the strongest next move is:
/api/ai/ask can query both:
Why this is strongest:
If the team wants a narrower first product slice, build a management-system documentation assistant first.
That would lean on:
This is lower risk than broad assistant work and could become the cleanest production-grade assistant slice quickly.
The repo already contains a real assistant foundation. It is strongest today in two knowledge areas:
The next practical direction should therefore be a grounded docs + Butkhuzi retrieval assistant with source-aware citations, not a broad speculative AI rewrite.