How ziyamka2026-art/mousavitax-platform works
MousaviTax is an Iranian tax-advice platform combining AI triage, retrieval with citations, tax-specific tools, and human review. The primary user flow is a question submitted in the web Ask page, sent through the API, enriched with knowledge retrieval and optionally an LLM response, then returned with citations. The product also documents tax cases, service discovery, advisors, and human-in-the-loop workflows; unsampled capabilities are represented without asserting unverified runtime links. Source evidence shows the retrieval, embedding, and selected audit-procedure connections; other edges are omitted where wiring was not shown.
Main entry points: main.py API gateway · Ask.tsx Ask page · service.py Knowledge service · embedder.py Text embedder
Components 23
User interfaces
- Ask page
apps/web/src/pages/Ask.tsx - API client
apps/web/src/services/apiClient.ts - Citation list
apps/web/src/components/CitationList.tsx - Platform pages
apps/web/src/app
API and workflows
- API gateway
apps/api/app/main.py - Tax cases
apps/api/app/cases.py - Audit procedure API
apps/api/app/audit_procedure_router.py
Knowledge and AI
- Knowledge service
packages/knowledge-core/knowledge_core/service.py - Vector store
packages/retrieval-engine/app/store.py - Text embedder
packages/embedding-service/app/embedder.py - LLM gateway
packages/ai-gateway/app/gateway.py - APCS parser
packages/prompt-engine/prompt_engine/parser.py - Prompt models
packages/prompt-engine/prompt_engine/models.py
Tax tools
- Audit procedure rules
packages/taxlaw-engine/taxlaw_engine/audit_procedure.py - Waiver calculator
packages/taxlaw-engine/taxlaw_engine/waiver.py
Agent operations
- Agent router
packages/agent-core/orchestrator.py - Agent service tools
packages/agent-core/service_tools.py - Permission gate
packages/agent-core/permissions.py - Agent audit log
packages/agent-core/audit.py - Agent API routes
apps/api/app/agent_routes.py
Other components
- Taxpayer
- LLM provider
- Ollama embeddings
Connections 22
- Taxpayer → Ask page: asks
apps/web/src/pages/Ask.tsx - Ask page → API client: submits question
apps/web/src/pages/Ask.tsx - API client → API gateway: HTTP request
apps/web/src/services/apiClient.ts - Ask page → Citation list: renders citations
apps/web/src/pages/Ask.tsx - API gateway → Knowledge service: queries knowledge
apps/api/app/main.py - API gateway → LLM gateway: generates answer
apps/api/app/main.py - Knowledge service → Vector store: queries and indexes
packages/knowledge-core/knowledge_core/service.py - Knowledge service → Text embedder: creates embeddings
packages/knowledge-core/knowledge_core/service.py - Vector store → Text embedder: embeds queries
packages/retrieval-engine/app/store.py - LLM gateway → LLM provider: calls provider
packages/ai-gateway/app/gateway.py - Text embedder → Ollama embeddings: requests embeddings
packages/embedding-service/app/embedder.py - APCS parser → Prompt models: builds command
packages/prompt-engine/prompt_engine/parser.py - API gateway → Tax cases: imports routes
apps/api/app/main.py - API gateway → Audit procedure API: registers router
apps/api/app/main.py - Audit procedure API → Audit procedure rules: calculates procedure
apps/api/app/audit_procedure_router.py - API gateway → Waiver calculator: uses waiver rules
apps/api/app/main.py - Agent service tools → Permission gate: checks access
packages/agent-core/service_tools.py - Agent service tools → Agent audit log: records actions
packages/agent-core/service_tools.py - API gateway → Agent API routes: agent endpoint wiring
- Agent API routes → Agent router: dispatches requests
- Taxpayer → Platform pages: uses services and tools
- API gateway → Platform pages: serves platform workflows