How eklakh-ai-engineer/taxtrace works
TaxTrace is a controlled-pilot compliance platform for CA firms. Its primary workflow takes purchase-register and GSTR-2B data through normalization and deterministic reconciliation, then supports evidence-backed exception review and audit. Separate branches cover notice extraction and drafting, knowledge retrieval, tasks/dashboard follow-up, and chat/WhatsApp. The README documents the capability map; API-to-service wiring beyond the sampled files is not fully shown, so uncertain links are omitted rather than inferred.
Main entry points: notice_service.py Notice workflow · document_service.py Document handling · api.ts API client · api FastAPI routes
Components 34
Reconciliation
- Document handling
backend/app/services/document_service.py - CSV parser
backend/app/parsers/csv_parser.py - JSON parser
backend/app/parsers/json_parser.py - Transaction normalization
backend/app/parsers/normalizer.py - Reconciliation workflow
backend/app/services/reconciliation_service.py - Deterministic matching
backend/app/reconciliation/engine.py - Exception rules
backend/app/reconciliation/rules.py
Notice and AI
- Notice and draft routes
backend/app/api/notices.py - Notice workflow
backend/app/services/notice_service.py - Notice extraction
backend/app/ai/notice_extractor.py - AI assistance
backend/app/services/ai_service.py - Prompt templates
backend/app/ai/prompt_templates.py - AI provider
backend/app/ai/provider.py - Evidence retrieval
backend/app/services/retrieval_service.py - Knowledge ingestion
backend/app/knowledge/ingest.py
Firm workflows
- Task workflows
backend/app/services/task_service.py - Follow-up messages
backend/app/services/communication_service.py - Dashboard
backend/app/services/dashboard_service.py - Dashboard routes
backend/app/api/dashboard.py - Chat command router
backend/app/channels/bot_router.py - Channel adapter
backend/app/channels/adapter.py
Platform services
- FastAPI routes
backend/app/api - Authentication
backend/app/auth.py - Domain database
backend/app/database.py - Domain records
backend/app/models.py - Audit trail
backend/app/services/audit_service.py
Review interface
- Review pages
frontend/src/app - API client
frontend/src/lib/api.ts - Exception review
frontend/src/app/exceptions/page.tsx - Knowledge interface
frontend/src/app/knowledge/page.tsx - Notice review
frontend/src/app/notices/[id]/page.tsx
Other components
- CA staff
- Web user
Connections 33
- CA staff → Web user: uses
README.md - Web user → Review pages: reviews
README.md - Review pages → API client: requests
- API client → FastAPI routes: calls API
- FastAPI routes → Authentication: authenticates
backend/app/api/documents.py - FastAPI routes → Domain database: uses sessions
backend/app/api/documents.py - Domain database → Domain records: stores records
backend/app/models.py - FastAPI routes → Document handling: delegates
backend/app/api/documents.py - Document handling → Audit trail: records events
- Document handling → CSV parser: parses CSV
- Document handling → JSON parser: parses JSON
- CSV parser → Transaction normalization: normalizes
backend/app/parsers/csv_parser.py - Reconciliation workflow → Deterministic matching: runs matching
backend/app/services/reconciliation_service.py - Deterministic matching → Transaction normalization: normalizes records
backend/app/reconciliation/engine.py - Deterministic matching → Exception rules: classifies
backend/app/reconciliation/engine.py - Reconciliation workflow → Audit trail: records outcome
backend/app/services/reconciliation_service.py - Exception review → API client: requests review data
- Notice and draft routes → Notice workflow: delegates
- Notice workflow → Notice extraction: extracts notice
backend/app/services/notice_service.py - Notice workflow → Evidence retrieval: retrieves evidence
backend/app/services/notice_service.py - Notice workflow → Document handling: uses documents
backend/app/services/notice_service.py - Notice workflow → AI provider: generates drafts
backend/app/services/notice_service.py - AI assistance → Prompt templates: formats prompts
backend/app/services/ai_service.py - AI assistance → AI provider: requests AI
backend/app/services/ai_service.py - Evidence retrieval → AI provider: embeds query
backend/app/services/retrieval_service.py - Knowledge ingestion → AI provider: embeds content
backend/app/knowledge/ingest.py - Knowledge interface → API client: requests knowledge
- Notice review → API client: requests drafts
- Dashboard routes → Dashboard: delegates
backend/app/api/dashboard.py - Task workflows → Follow-up messages: supports follow-up
- WhatsApp → Channel adapter: sends messages
- Channel adapter → Chat command router: routes messages
backend/app/api/webhooks.py - Chat command router → AI assistance: explains mismatch
backend/app/channels/bot_router.py