How officialpk956-wq/ca_saas works
GST Helper is a local GST-workpaper demo. Users create a client and period, import and review purchase/statement records, reconcile selected committed versions, inspect evidence and save decisions, then export a workbook. Separate product branches support purchase categorization, sales preparation, and draft worksheet approval. The README documents these capabilities; sampled source and the SOURCE INDEX support the backend ownership links below. Some frontend-to-API wiring and unsampled subsystem internals are not shown, so those links rely on documented behavior rather than inferred calls.
Main entry points: main.py HTTP API · models.py PostgreSQL data · import_service.py Import processing · reconciliation_service.py Reconciliation service
Components 23
User experience
- Web workspace
frontend/app/periods/[period_id]/workspace/page.tsx - API client
frontend/lib/api.ts - Client setup
backend/gst_copilot/api/routers/clients.py
Import and reconciliation
- Import endpoints
backend/gst_copilot/api/routers/import_batches.py - Import processing
backend/gst_copilot/services/import_service.py - CSV parser
backend/gst_copilot/parser.py - Row validation
backend/gst_copilot/validation.py - Reconcile endpoint
backend/gst_copilot/api/routers/reconciliation.py - Reconciliation service
backend/gst_copilot/services/reconciliation_service.py - Matching engine
backend/gst_copilot/reconciliation.py
Review and reporting
- Review decisions
backend/gst_copilot/api/routers/resolutions.py - Evidence projections
backend/gst_copilot/services/review_service.py - Export endpoint
backend/gst_copilot/api/routers/exports.py - Workbook export
backend/gst_copilot/services/export_service.py
Preparation extensions
- Category review
backend/gst_copilot/api/routers/categories.py - Category suggestions
backend/gst_copilot/model_gateway/categorization.py - Sales preparation
backend/gst_copilot/api/routers/sales.py - Draft worksheet
backend/gst_copilot/api/routers/worksheet.py - GST assistant
backend/gst_copilot/api/routers/assist.py
Persistence and access
- HTTP API
backend/gst_copilot/api/main.py - PostgreSQL data
backend/gst_copilot/db/models.py - Database sessions
backend/gst_copilot/db/database.py
Other components
- GST reviewer
Connections 31
- GST reviewer → Web workspace: uses
README.md - Web workspace → API client: requests
- API client → HTTP API: calls API
- HTTP API → Client setup: routes
backend/gst_copilot/api/main.py - HTTP API → Import endpoints: routes
backend/gst_copilot/api/main.py - HTTP API → Reconcile endpoint: routes
backend/gst_copilot/api/main.py - HTTP API → Review decisions: routes
backend/gst_copilot/api/main.py - HTTP API → Export endpoint: routes
backend/gst_copilot/api/main.py - HTTP API → Category review: routes
backend/gst_copilot/api/main.py - HTTP API → Sales preparation: routes
backend/gst_copilot/api/main.py - HTTP API → Draft worksheet: routes
backend/gst_copilot/api/main.py - HTTP API → GST assistant: routes
backend/gst_copilot/api/main.py - Import endpoints → Import processing: processes uploads
backend/gst_copilot/api/routers/import_batches.py - Import processing → CSV parser: parses rows
backend/gst_copilot/services/import_service.py - Import processing → Row validation: validates rows
backend/gst_copilot/services/import_service.py - Reconcile endpoint → Reconciliation service: runs reconciliation
backend/gst_copilot/api/routers/reconciliation.py - Reconciliation service → Matching engine: matches records
backend/gst_copilot/services/reconciliation_service.py - Review decisions → Evidence projections: projects evidence
- Export endpoint → Workbook export: builds workbook
backend/gst_copilot/api/routers/exports.py - Category review → Category suggestions: requests suggestions
backend/gst_copilot/api/routers/categories.py - Client setup → PostgreSQL data: reads and writes
backend/gst_copilot/api/routers/clients.py - Import processing → PostgreSQL data: persists imports
backend/gst_copilot/services/import_service.py - Reconciliation service → PostgreSQL data: persists runs
backend/gst_copilot/services/reconciliation_service.py - Evidence projections → PostgreSQL data: reads history
backend/gst_copilot/services/review_service.py - Workbook export → PostgreSQL data: reads records
- Database sessions → PostgreSQL data: connects sessions
backend/gst_copilot/db/database.py - HTTP API → Database sessions: provides sessions
- GST reviewer → Category review: reviews categories
README.md - GST reviewer → Sales preparation: prepares sales
README.md - GST reviewer → Draft worksheet: prepares drafts
README.md - GST reviewer → GST assistant: asks for help