How shabanraza/gst-accounting-software works
HisaabKro is a web and mobile GST billing, inventory, khata-ledger, and accounting workspace. The principal flow is a business user signing in, selecting or creating a company, maintaining parties and items, and creating sales or purchase vouchers; those transactions calculate GST and update accounting and stock records. The tRPC API exposes these domain services to the clients. Other major capabilities include payments, bank reconciliation, GST reporting, OCR-assisted purchase entry, and dashboard summaries. Source excerpts show key service calls and API registrations; unsampled capabilities are included from the README and tree.
Main entry points: router.ts tRPC API · purchase-bill-service.ts Purchase Bills · dashboard-owner-service.ts Dashboard · app.tsx Web Workspace
Components 20
User Workspaces
- Web Workspace
src/routes/app.tsx - Mobile Workspace
mobile/app/(app)/(tabs)/dashboard.tsx
Access and Companies
- Authentication
src/lib/auth-client.ts - Company Workspace
src/features/companies - tRPC API
src/integrations/trpc/router.ts
Business Transactions
- Parties
src/features/parties/party-service.ts - Inventory
src/features/inventory/item-service.ts - Sales Invoices
src/features/sales/sales-invoice-service.ts - Purchase Bills
src/features/purchases/purchase-bill-service.ts - Orders and GRNs
src/features/purchases - Payments and Returns
src/features/payments
Books and Compliance
- GST Compliance
src/features/gst - Ledger Posting
src/features/accounting/posting-engine.ts - Accounting and Reports
src/features/accounting - PostgreSQL Data
src/db/schema.ts
Operations and Insight
- Bank Reconciliation
src/features/banking - Purchase OCR
src/features/ocr - Dashboard
src/features/dashboard/dashboard-owner-service.ts - Voucher Documents
src/features/documents
Other components
- Business User
Connections 27
- Business User → Web Workspace: uses
- Business User → Mobile Workspace: uses
- Web Workspace → Authentication: checks session
src/routes/app.tsx - Web Workspace → Company Workspace: loads companies
src/routes/app.tsx - Web Workspace → tRPC API: queries companies
src/routes/app.tsx - tRPC API → Company Workspace: registers routes
src/integrations/trpc/router.ts - tRPC API → Parties: registers routes
src/integrations/trpc/router.ts - tRPC API → Inventory: registers routes
src/integrations/trpc/router.ts - tRPC API → Purchase Bills: registers routes
src/integrations/trpc/router.ts - tRPC API → Orders and GRNs: registers routes
src/integrations/trpc/router.ts - tRPC API → Payments and Returns: registers routes
src/integrations/trpc/router.ts - tRPC API → Bank Reconciliation: registers routes
src/integrations/trpc/router.ts - tRPC API → Accounting and Reports: registers routes
src/integrations/trpc/router.ts - tRPC API → Voucher Documents: registers routes
src/integrations/trpc/router.ts - Sales Invoices → Ledger Posting: posts ledger
src/features/sales/sales-invoice-service.ts - Sales Invoices → GST Compliance: validates invoice
src/features/sales/sales-invoice-service.ts - Sales Invoices → Inventory: checks stock
src/features/sales/sales-invoice-service.ts - Purchase Bills → Ledger Posting: posts ledger
src/features/purchases/purchase-bill-service.ts - Purchase Bills → GST Compliance: validates invoice
src/features/purchases/purchase-bill-service.ts - Purchase Bills → Inventory: records stock
src/features/purchases/purchase-bill-service.ts - Ledger Posting → PostgreSQL Data: persists entries
- Bank Reconciliation → Ledger Posting: reconciles postings
src/features/banking/bank-reconciliation-service.ts - Purchase OCR → Purchase Bills: prefills bills
src/features/ocr/ocr-draft-service.ts - Dashboard → Accounting and Reports: reads ageing
src/features/dashboard/dashboard-owner-service.ts - Dashboard → Sales Invoices: reads invoices
src/features/dashboard/dashboard-owner-service.ts - Dashboard → Purchase Bills: reads bills
src/features/dashboard/dashboard-owner-service.ts - Dashboard → Inventory: reads stock
src/features/dashboard/dashboard-owner-service.ts