How arvindhkrisshna/averqo-invoice-application works
Averqo is a small-business GST invoicing and operations app: signed-in staff manage customers and items, prepare sales documents and invoices, record payments, and track expenses and time; owners also configure the business and team. The Angular client communicates with a Go server backed by MySQL. Major capabilities include recurring invoices, GST return preparation, reports, PDFs, email, and WhatsApp sharing. Relationships between sampled UI and backend handlers are not directly shown, so links rely on README-documented capabilities; unsampled handler internals are not inferred.
Main entry points: api.ts API client · main.go Go API server · invoice-form.ts Invoice editor · app.ts Angular app shell
Components 30
Web application
- Angular app shell
frontend/src/app/app.ts - Sign-in and setup
frontend/src/app/core/auth.ts - API client
frontend/src/app/core/api.ts - Business settings
frontend/src/app/pages/settings
Sales operations
- Customers
frontend/src/app/pages/customers - Items
frontend/src/app/pages/items - Sales documents
frontend/src/app/pages/documents - Invoice editor
frontend/src/app/pages/invoices/invoice-form.ts - Line editor
frontend/src/app/shared/lines-editor.ts - Recurring invoices
frontend/src/app/pages/recurring - Payments received
frontend/src/app/pages/payments
Costs and time
- Expenses
frontend/src/app/pages/expenses/expense-form.ts - Time tracking
frontend/src/app/pages/time - Running timer
frontend/src/app/core/timer.ts
Tax and insight
- GST filing
frontend/src/app/pages/gst/gst-filing.ts - Reports
frontend/src/app/pages/reports
Server services
- Go API server
backend/main.go - Authentication
backend/auth.go - Sales document service
backend/documents.go - Invoice service
backend/invoices.go - Expense service
backend/expenses.go - Time service
backend/timetracking.go - GST return service
backend/gstfiling.go - Report service
backend/reports.go - PDF generation
backend/pdf.go - Email sending
backend/email.go - MySQL database
Other components
- Owner or staff
- Business mail account
Connections 32
- Owner or staff → Angular app shell: uses
- Angular app shell → Sign-in and setup: offers sign-in
frontend/src/app/app.ts - Sign-in and setup → API client: authenticates through
frontend/src/app/core/auth.ts - Angular app shell → API client: loads business data
frontend/src/app/app.ts - Customers → API client: manages customers
frontend/src/app/core/api.ts - Items → API client: manages items
frontend/src/app/core/api.ts - Sales documents → API client: manages documents
frontend/src/app/core/api.ts - Invoice editor → API client: loads and saves
frontend/src/app/pages/invoices/invoice-form.ts - Invoice editor → Line editor: uses lines
frontend/src/app/pages/invoices/invoice-form.ts - Invoice editor → Time tracking: offers unbilled work
- Invoice editor → Expenses: offers billable costs
- Recurring invoices → API client: manages schedules
frontend/src/app/pages/recurring/recurring-form.ts - Payments received → API client: records payments
frontend/src/app/core/api.ts - Expenses → API client: records expenses
frontend/src/app/pages/expenses/expense-form.ts - Time tracking → Running timer: uses timer
frontend/src/app/pages/time/timesheet.ts - Time tracking → API client: manages time
frontend/src/app/pages/time/timesheet.ts - GST filing → API client: requests returns
frontend/src/app/pages/gst/gst-filing.ts - Reports → API client: requests reports
frontend/src/app/pages/reports/report-view.ts - Business settings → API client: updates settings
frontend/src/app/pages/settings/account-settings.ts - API client → Go API server: calls API
- Go API server → Authentication: serves authentication
- Go API server → Sales document service: serves documents
- Go API server → Invoice service: serves invoices
- Go API server → Expense service: serves expenses
- Go API server → Time service: serves time
- Go API server → GST return service: serves filing
- Go API server → Report service: serves reports
- Go API server → PDF generation: generates PDFs
- Go API server → Email sending: sends email
- Email sending → Business mail account: uses account
- Sales documents → WhatsApp: shares documents
- Go API server → MySQL database: persists business data