How zeus-pr/taxos works
TaxOS is a web application for organizing tax information and preparing an Indian income-tax return. The user workflow runs from account creation and tax-profile onboarding through document upload, income and deduction entry, reconciliation, tax calculation, eligibility/checklist review, and return review. The tree also shows investment projections, scenarios, reports, and administration features. Sampled routes confirm profile, income, deduction, authentication, and document storage behavior; the README provides no product detail, and processing, tax preparation, and several UI implementations were not sampled, so uncertain internal links are omitted.
Main entry points: repo.ts Data repository · auth Authentication routes · documents Document routes · tax-engine Tax calculation
Components 26
Access and setup
- Sign-in screens
app/auth - Authentication routes
app/api/auth - Auth service
lib/auth/service.ts - Session handling
lib/auth/session.ts - Profile onboarding
app/app/onboarding - Profile API
app/api/profile/route.ts
Documents and data
- Document workspace
app/app/documents - Document routes
app/api/documents - Document processing
modules/documents/service.ts - Document parsers
modules/documents/parsers - Upload validation
modules/documents/validation.ts - Private file storage
lib/storage/index.ts
Tax preparation
- Income and deductions
app/app/income - Income routes
app/api/income - Income service
modules/income/service.ts - Data reconciliation
modules/reconciliation/index.ts - Tax calculation
modules/tax-engine - Return eligibility
modules/itr-engine - Return review
app/app/review - Tax reports
modules/reports - Investment projections
modules/investments/projection.ts
Administration
- Admin console
app/admin - Data repository
lib/db/repo.ts
Other components
- Taxpayer
- Vercel Blob
- Application database
Connections 29
- Taxpayer → Sign-in screens: starts
- Sign-in screens → Authentication routes: submits credentials
- Authentication routes → Auth service: authenticates
- Authentication routes → Session handling: creates session
- Authentication routes → Data repository: reads users
- Authentication routes → Taxpayer: sets session
- Taxpayer → Profile onboarding: enters profile
- Profile onboarding → Profile API: submits profile
- Profile API → Data repository: reads and writes
- Taxpayer → Document workspace: uploads documents
- Document workspace → Document routes: requests upload
- Document routes → Upload validation: validates file
- Document routes → Vercel Blob: uploads and verifies
- Document routes → Data repository: records document
- Document routes → Private file storage: downloads or deletes
- Private file storage → Vercel Blob: accesses files
- Taxpayer → Income and deductions: enters tax data
- Income and deductions → Income routes: submits entries
- Income routes → Data repository: reads and writes
- Income service → Data repository: accesses income data
- Document processing → Document parsers: parses documents
- Data reconciliation → Tax calculation: supplies reconciled data
- Tax calculation → Return eligibility: provides tax results
- Taxpayer → Return review: reviews return
- Return review → Return eligibility: uses eligibility
- Tax reports → Tax calculation: summarizes tax
- Taxpayer → Investment projections: explores projections
- Admin console → Data repository: manages records
- Data repository → Application database: reads and writes