How mjsharma1234/ca-agentic-platform works
CA Firm OS is a multi-tenant operations tracker and compliance-preparation platform for Indian CA firms; professionals, not automation, make filing decisions. The workflow runs from client and document intake through reconciliation and return preparation to human review and partner approval, while tracking filing status rather than filing returns. The graph also preserves the documented statutory calendar, billing, Tally exchange, audit, and agent capabilities. Relationships for unsampled modules are included only where documented in the README; source excerpts do not establish every internal call.
Main entry points: main.py API Application · firm_os.py Firm State API · auth.py Authentication · returns.py Return Preparation
Components 20
User Interface and API
- Firm OS Web
firm_os_web - API Application
backend/app/main.py - Authentication
backend/app/api/v1/auth.py
Firm Operations
- Client Intake
backend/app/api/v1/clients.py - Document Intake
backend/app/api/v1/documents.py - Ops Tracker
backend/app/api/v1/ops.py - Statutory Calendar
backend/app/deterministic_core/statutory_calendar_live.py - Billing and Recovery
backend/app/api/v1/billing.py - Return Preparation
backend/app/api/v1/returns.py - Firm State API
backend/app/api/v1/firm_os.py
Preparation Engines
- Agent Runtime
backend/app/agents/runtime.py - OCR Engine
backend/app/deterministic_core/ocr_engine.py - Reconciliation
backend/app/deterministic_core/reconciler.py - Bank Reconciliation
backend/app/deterministic_core/bank_reconciler.py - Tally Exchange
backend/app/deterministic_core/tally_bridge.py
State and Governance
- Human Review Gates
backend/app/api/v1/gates.py - Audit Chain
backend/app/deterministic_core/audit_chain.py - Relational Database
backend/app/core/database.py - Tenant and User Records
backend/app/models/tenant.py
Other components
- Firm Staff
Connections 23
- Firm Staff → Firm OS Web: uses
- Firm OS Web → API Application: requests APIs
- API Application → Authentication: mounts routes
backend/app/main.py - API Application → Client Intake: mounts routes
backend/app/main.py - API Application → Document Intake: mounts routes
backend/app/main.py - API Application → Ops Tracker: mounts routes
backend/app/main.py - API Application → Billing and Recovery: mounts routes
backend/app/main.py - API Application → Return Preparation: mounts routes
backend/app/main.py - API Application → Human Review Gates: mounts routes
backend/app/main.py - API Application → Firm State API: mounts routes
backend/app/main.py - Document Intake → OCR Engine: extracts documents
backend/app/api/v1/documents.py - Return Preparation → Reconciliation: runs reconciliation
backend/app/api/v1/returns.py - Firm State API → Reconciliation: runs reconciliation
backend/app/api/v1/firm_os.py - Firm State API → Tally Exchange: exports XML
backend/app/api/v1/firm_os.py - Bank Reconciliation → Tally Exchange: exchanges data
- Ops Tracker → Statutory Calendar: tracks deadlines
- Human Review Gates → Audit Chain: records decisions
backend/app/api/v1/gates.py - Firm State API → Audit Chain: serves audit trail
backend/app/api/v1/firm_os.py - Client Intake → Relational Database: reads and writes
backend/app/api/v1/clients.py - Billing and Recovery → Relational Database: reads and writes
backend/app/api/v1/billing.py - Authentication → Tenant and User Records: looks up users
backend/app/api/v1/auth.py - Authentication → Audit Chain: appends login event
backend/app/api/v1/auth.py - Agent Runtime → Return Preparation: prepares returns