How gartgetget/pesoledger-accounting-financial-management-system works
ChaChing is a workspace-based accounting and operations application. Staff sign in, work in a selected accounting area (such as revenue, expenses, jobs, payroll, vehicles, or inventory), and review dashboards, reports, and period summaries. The frontend keeps shared accounting state and uses an API client; the Express backend authenticates requests, dispatches them to domain routes, and connects to MongoDB. The README documents only local startup, so feature coverage comes from the source tree and excerpts; several feature-to-route links are therefore omitted where request wiring was not shown.
Main entry points: App.tsx App navigation · AccountingContext.tsx Accounting state · routes Domain routes · ReportsView.tsx Reports
Components 23
Web application
- App navigation
src/App.tsx - Authentication state
src/context/AuthContext.tsx - Accounting state
src/context/AccountingContext.tsx - API client
src/api/client.ts - Date filtering
src/utils/date.ts - Spreadsheet import/export
src/utils/excel.ts
Accounting operations
- Accounting views
src/components/revenue/RevenueView.tsx - Daily accounting
src/components/daily/DailyAccountingView.tsx - Period summaries
src/components/monthly/MonthlyAccountingView.tsx - Dashboard
src/components/dashboard/DashboardView.tsx - Reports
src/components/reports/ReportsView.tsx
Business operations
- Job orders
src/components/jobs/JobModal.tsx - Customers and payroll
src/components/customers/CustomersView.tsx - Vehicles
src/components/vehicles/VehiclesView.tsx - Inventory
src/components/inventory/InventoryView.tsx - Workspace settings
src/components/settings/SettingsView.tsx
API and persistence
- Express API
backend/index.ts - Domain routes
backend/routes - Request authentication
backend/middleware/auth.ts - Async router
backend/middleware/createRouter.ts - Domain records
backend/models - MongoDB connection
backend/db.ts
Other components
- Staff user
Connections 31
- Staff user → App navigation: uses
src/App.tsx - App navigation → Authentication state: checks session
src/App.tsx - App navigation → Accounting state: provides state
src/App.tsx - App navigation → Accounting views: renders views
src/App.tsx - App navigation → Dashboard: renders dashboard
src/App.tsx - App navigation → Daily accounting: renders daily view
src/App.tsx - App navigation → Period summaries: renders summaries
src/App.tsx - App navigation → Reports: renders reports
src/App.tsx - App navigation → Job orders: renders jobs
src/App.tsx - App navigation → Customers and payroll: renders operations
src/App.tsx - App navigation → Vehicles: renders vehicles
src/App.tsx - App navigation → Inventory: renders inventory
src/App.tsx - App navigation → Workspace settings: renders settings
src/App.tsx - Authentication state → API client: requests auth
src/context/AuthContext.tsx - Accounting state → API client: requests data
src/context/AccountingContext.tsx - Accounting state → Date filtering: calculates ranges
src/context/AccountingContext.tsx - Dashboard → Accounting state: reads state
src/components/dashboard/DashboardView.tsx - Daily accounting → Accounting state: reads state
src/components/daily/DailyAccountingView.tsx - Period summaries → Accounting state: reads state
- Reports → Accounting state: reads state
src/components/reports/ReportsView.tsx - Reports → Spreadsheet import/export: exports data
src/components/reports/ReportsView.tsx - Inventory → Spreadsheet import/export: imports data
src/components/inventory/InventoryView.tsx - Vehicles → Spreadsheet import/export: exports data
src/components/vehicles/VehiclesView.tsx - API client → Express API: sends HTTP
- Express API → Domain routes: mounts routes
backend/index.ts - Domain routes → Request authentication: authenticates requests
backend/routes/jobOrderRoutes.ts - Domain routes → Async router: creates routers
backend/routes/jobOrderRoutes.ts - Domain routes → Domain records: reads and writes
backend/routes/jobOrderRoutes.ts - Express API → MongoDB connection: connects database
backend/index.ts - Request authentication → Domain records: looks up user
backend/middleware/auth.ts - Domain routes → Domain records: synchronizes job revenue
backend/routes/jobOrderRoutes.ts