How charisnetwork/bill_easy works
Bill Easy is a multi-company billing and business-management SaaS, with a separate platform-admin portal. The main workflow is a business user signing in, creating invoices or purchases, and managing related customers, stock, payments, and reporting; document previews and PDFs support the billing lifecycle. The tree documents additional quotation, purchase-order, e-way-bill, expense, AI, and subscription capabilities. Sampled source confirms invoice and purchase state updates, plus admin plan/coupon/affiliate management; several feature paths are represented from the tree, so their detailed wiring is not inferred.
Main entry points: server.js Core API · database.js Core business database · invoiceController.js Invoice lifecycle · App.jsx Business portal
Components 26
Business workspace
- Business portal
packages/core-app/frontend/src/App.jsx - Identity and company context
packages/core-app/backend/controllers/authController.js - Core API
packages/core-app/backend/server.js - Plans and usage
packages/core-app/backend/services/subscriptionService.js
Sales and operations
- Sales workspace
packages/core-app/frontend/src/pages/CreateInvoicePage.jsx - Invoice lifecycle
packages/core-app/backend/controllers/invoiceController.js - Numbering and PDF
packages/core-app/backend/services/invoicePdfService.js - Purchasing and stock
packages/core-app/backend/controllers/purchaseController.js - Customer and product records
packages/core-app/backend/controllers/customerController.js - Quotes and orders
packages/core-app/backend/controllers/quotationController.js - E-way bills
packages/core-app/backend/controllers/ewayBillController.js - Expenses and reports
packages/core-app/backend/controllers/reportController.js - AI assistant
packages/core-app/backend/controllers/aiController.js
Platform administration
- Admin control center
packages/admin-app/frontend/src/App.jsx - Admin gateway
admin/server.js - Admin API and auth
packages/admin-app/backend/server.js - Admin routes
packages/admin-app/backend/routes/adminRoutes.js - Plans coupons affiliates
packages/admin-app/backend/controllers/managementController.js - Platform analytics
packages/admin-app/backend/controllers/analyticsController.js
Persistence and integrations
- Core business database
packages/core-app/backend/config/database.js - Asset storage
packages/core-app/backend/utils/storage.js - SaaS database
packages/admin-app/backend/config/db.js - Admin database
packages/admin-app/backend/config/db.js
Other components
- Business user
- Platform administrator
- Google Cloud Storage
Connections 31
- Business user → Business portal: uses
- Business portal → Identity and company context: authenticates via
- Business portal → Sales workspace: opens
- Sales workspace → Core API: requests API
- Core API → Invoice lifecycle: routes requests
- Core API → Purchasing and stock: routes requests
- Core API → Customer and product records: routes requests
- Core API → Quotes and orders: routes requests
- Core API → E-way bills: routes requests
- Core API → Expenses and reports: routes requests
- Core API → AI assistant: routes requests
- Core API → Plans and usage: routes requests
- Invoice lifecycle → Numbering and PDF: generates documents
- Invoice lifecycle → Core business database: reads and writes
- Purchasing and stock → Core business database: updates stock
- Customer and product records → Core business database: reads and writes
- Quotes and orders → Core business database: reads and writes
- E-way bills → Core business database: reads and writes
- Expenses and reports → Core business database: queries records
- Plans and usage → Core business database: reads and writes
- Invoice lifecycle → Plans and usage: updates usage
- Platform administrator → Admin control center: uses
- Admin control center → Admin gateway: requests API
- Admin gateway → Admin API and auth: proxies API
- Admin API and auth → Admin routes: dispatches
- Admin routes → Plans coupons affiliates: calls
- Admin routes → Platform analytics: calls
- Plans coupons affiliates → SaaS database: manages plans and coupons
- Plans coupons affiliates → Admin database: manages affiliates
- Platform analytics → SaaS database: queries metrics
- Asset storage → Google Cloud Storage: uploads assets