How grizzy100/callzo-usage-metering works
Callzo combines a webhook-driven usage metering API with a browser-based usage admin console. Telephony events enter the API, are validated and stored, then processed into call and monthly usage records; authenticated account and usage endpoints expose data to the console, which presents overview analytics, account search/management, and settings. Retry and reconciliation are distinct operational stages. Backend service wiring beyond the excerpts is limited to references in the source index; the repository-level README describes the two tasks but not their detailed runtime relationships.
Main entry points: db.js PostgreSQL data · App.jsx Console shell · server.js Express API · webhook.routes.js Webhook route
Components 24
Admin console
- Console shell
client/src/App.jsx - Navigation and header
client/src/components/Sidebar.jsx - Usage overview
client/src/pages/Overview.jsx - Account management
client/src/pages/Accounts.jsx - Account settings
client/src/pages/AccountSettings.jsx - Usage chart
client/src/components/UsageChart.jsx - API client
client/src/services/api.js
API and access
- Express API
server/src/server.js - Authentication routes
server/src/routes/auth.routes.js - Authentication
server/src/controllers/auth.controller.js - Account routes
server/src/routes/account.routes.js - Account listing
server/src/controllers/account.controller.js - Account usage
server/src/controllers/usage.controller.js - Webhook route
server/src/routes/webhook.routes.js - Signature verification
server/src/middleware/signature.middleware.js - Webhook intake
server/src/controllers/webhook.controller.js
Event metering
- Event persistence
server/src/services/webhook.service.js - Call event processing
server/src/services/event-processing.service.js - PostgreSQL data
server/src/config/db.js
Usage operations
- Retry worker
server/src/workers/retry.worker.js - Retry processing
server/src/services/retry.service.js - Usage reconciliation
server/src/services/reconciliation.service.js
Other components
- Admin user
- Telephony provider
Connections 30
- Admin user → Console shell: uses
client/src/App.jsx - Console shell → Navigation and header: renders
client/src/App.jsx - Console shell → Usage overview: selects view
client/src/App.jsx - Console shell → Account management: selects view
client/src/App.jsx - Console shell → Account settings: selects view
client/src/App.jsx - Usage overview → Usage chart: renders
client/src/pages/Overview.jsx - Usage overview → API client: requests data
client/src/pages/Overview.jsx - Account management → Usage chart: renders
client/src/pages/Accounts.jsx - Account management → API client: requests data
client/src/pages/Accounts.jsx - Account settings → API client: requests settings
client/src/pages/AccountSettings.jsx - API client → Express API: HTTP requests
- Express API → Authentication routes: mounts
server/src/server.js - Express API → Account routes: mounts
server/src/server.js - Express API → Webhook route: mounts
server/src/server.js - Authentication routes → Authentication: routes to
server/src/routes/auth.routes.js - Account routes → Account listing: routes to
server/src/routes/account.routes.js - Account routes → Account usage: routes to
server/src/routes/account.routes.js - Account listing → PostgreSQL data: queries
server/src/controllers/account.controller.js - Account usage → PostgreSQL data: queries
server/src/controllers/usage.controller.js - Telephony provider → Webhook route: sends events
- Webhook route → Signature verification: verifies
server/src/routes/webhook.routes.js - Webhook route → Webhook intake: dispatches
server/src/routes/webhook.routes.js - Webhook intake → Event persistence: stores event
server/src/controllers/webhook.controller.js - Event persistence → PostgreSQL data: writes event
server/src/services/webhook.service.js - Call event processing → PostgreSQL data: updates calls and usage
server/src/services/event-processing.service.js - Retry worker → Retry processing: runs retries
server/src/workers/retry.worker.js - Retry processing → Call event processing: reprocesses events
server/src/services/retry.service.js - Retry processing → PostgreSQL data: reads retry state
server/src/services/retry.service.js - Usage reconciliation → Call event processing: reconciles events
server/src/services/reconciliation.service.js - Usage reconciliation → PostgreSQL data: checks records
server/src/services/reconciliation.service.js