How ziyamka2026-art/mka-core works
MKA is a modular Persian-language tax-knowledge assistant, with a Telegram bot and an admin panel for managing knowledge. The visible query API currently generates answers through the LLM gateway using general model knowledge; its source explicitly says retrieval and real citations are not yet connected. Separately, the repository includes document parsing, embedding, indexing, and semantic-search components. The README names additional planned capabilities, but their implementation is not present in the supplied tree. Arrows below are limited to relationships visible in excerpts, the source index, or README.
Main entry points: routeTree.gen.ts Route tree · index_local.py Local indexing · query_service.py Semantic query · auth.tsx Sign in / sign up
Components 25
Admin panel
- Sign in / sign up
packages/admin-panel/src/routes/auth.tsx - Auth guard
packages/admin-panel/src/routes/_authenticated/route.tsx - Registry management
packages/admin-panel/src/routes/_authenticated/registry-admin.tsx - Registry view
packages/admin-panel/src/routes/_authenticated/registry.tsx - Ask page
packages/admin-panel/src/routes/_authenticated/ask.tsx - Circulars page
packages/admin-panel/src/routes/_authenticated/circulars.tsx - Dashboard
packages/admin-panel/src/routes/_authenticated/dashboard.tsx - Settings
packages/admin-panel/src/routes/_authenticated/settings.tsx - Waiver tools
packages/admin-panel/src/routes/_authenticated/waiver.tsx - Route tree
packages/admin-panel/src/routeTree.gen.ts - Router setup
packages/admin-panel/src/router.tsx
Query API
- RAG API
packages/backend-api/app/main.py - LLM gateway
packages/ai-gateway/app/gateway.py - Telegram bot
packages/telegram-bot/app/bot.py
Knowledge pipeline
- Drive sync
packages/google-drive-sync/app/download_circulars.py - Local indexing
packages/google-drive-sync/app/index_local.py - Document parser
packages/document-parser/app/parser.py - Text embeddings
packages/embedding-service/app/embedder.py - Semantic query
packages/retrieval-engine/app/query_service.py - Vector store
packages/retrieval-engine/app/store.py
External providers
- Supabase auth
packages/admin-panel/src/integrations/supabase/client.ts - LLM provider
Shared contracts
- API contracts
packages/shared/mka_shared/models.py
Other components
- Admin user
- Telegram user
Connections 25
- Admin user → Sign in / sign up: signs in
packages/admin-panel/src/routes/auth.tsx - Sign in / sign up → Supabase auth: authenticates
packages/admin-panel/src/routes/auth.tsx - Admin user → Registry management: manages knowledge
README.md - Admin user → Ask page: asks questions
README.md - Router setup → Route tree: loads routes
packages/admin-panel/src/router.tsx - Route tree → Sign in / sign up: registers route
packages/admin-panel/src/routeTree.gen.ts - Route tree → Registry management: registers route
packages/admin-panel/src/routeTree.gen.ts - Route tree → Registry view: registers route
packages/admin-panel/src/routeTree.gen.ts - Route tree → Ask page: registers route
packages/admin-panel/src/routeTree.gen.ts - Route tree → Circulars page: registers route
packages/admin-panel/src/routeTree.gen.ts - Route tree → Dashboard: registers route
packages/admin-panel/src/routeTree.gen.ts - Route tree → Settings: registers route
packages/admin-panel/src/routeTree.gen.ts - Route tree → Waiver tools: registers route
packages/admin-panel/src/routeTree.gen.ts - Auth guard → Supabase auth: checks session
packages/admin-panel/src/routes/_authenticated/route.tsx - Telegram user → Telegram bot: messages
README.md - RAG API → API contracts: uses contracts
packages/backend-api/app/main.py - RAG API → LLM gateway: requests generation
packages/backend-api/app/main.py - LLM gateway → LLM provider: calls provider
packages/ai-gateway/app/gateway.py - Local indexing → Document parser: parses documents
packages/google-drive-sync/app/index_local.py - Local indexing → Text embeddings: generates embeddings
packages/google-drive-sync/app/index_local.py - Local indexing → Vector store: indexes chunks
packages/google-drive-sync/app/index_local.py - Semantic query → Document parser: parses for indexing
packages/retrieval-engine/app/query_service.py - Semantic query → Text embeddings: creates embedder
packages/retrieval-engine/app/query_service.py - Semantic query → Vector store: queries store
packages/retrieval-engine/app/query_service.py - Vector store → Text embeddings: embeds records
packages/retrieval-engine/app/store.py