How indianprogrammer/erp works
This is a multi-tenant ERP and GST suite: staff authenticate into a tenant, then use the browser SPA or MCP tools to reach tenant-scoped business APIs and their MySQL-backed records. The major business branches cover procurement, sales, inventory, CRM, projects/expenses, and GST; shared layers provide authentication, tenant isolation, settings, and dashboard/search access. The README documents several capabilities not sampled in source, so those subsystems are represented at their documented route-directory level; their internal interactions are not inferred.
Main entry points: server.js Express API · pool.js MySQL database · middleware.js Auth and RBAC · auth.js Authentication
Components 27
Entry surfaces
- ERP browser SPA
public/js/app.js - Shared UI
public/js/ui.js - Express API
server.js - MCP tools
mcp/server.js - MCP stdio
mcp/stdio.js
Identity and tenancy
- Authentication
server/routes/auth.js - Auth and RBAC
server/lib/middleware.js - Tenant resolution
server/lib/tenant.js - JWT tokens
server/lib/tokens.js - MySQL database
server/db/pool.js - Staff and administration
server/routes/admin.js - Company settings
server/routes/settings.js
Procurement and sales
- Procurement and vendors
server/routes/rfqs.js - Sales documents
server/routes/salesdocs.js - Customer directory
server/routes/customers.js - Receipts
server/routes/receipts.js
Operations and inventory
- CRM leads
server/routes/leads.js - Lead stages
server/lib/leadStages.js - Projects and costs
server/routes/projects.js - Expenses
server/routes/expenses.js - Items and warehouses
server/routes/items.js - Stock movements
server/routes/stock.js
GST and oversight
- GST reconciliation
server/routes/gst.js - Dashboard KPIs
server/routes/dashboard.js - Global search
server/routes/search.js - API documentation
server/routes/docs.js
Other components
- Business user
Connections 44
- Business user → ERP browser SPA: uses
- ERP browser SPA → Express API: calls APIs
- Express API → Authentication: mounts
server.js - Express API → Auth and RBAC: guards APIs
server.js - Express API → Tenant resolution: resolves tenant
server.js - Express API → Procurement and vendors: mounts routes
server.js - Express API → Sales documents: mounts routes
server.js - Express API → Customer directory: mounts routes
server.js - Express API → Receipts: mounts routes
server.js - Express API → CRM leads: mounts routes
server.js - Express API → Projects and costs: mounts routes
server.js - Express API → Expenses: mounts routes
server.js - Express API → Items and warehouses: mounts routes
server.js - Express API → Stock movements: mounts routes
server.js - Express API → GST reconciliation: mounts routes
server.js - Express API → Dashboard KPIs: mounts routes
server.js - Express API → Global search: mounts routes
server.js - Express API → Staff and administration: mounts routes
server.js - Express API → Company settings: mounts routes
server.js - Express API → API documentation: mounts routes
server.js - MCP tools → Express API: calls tenant API
mcp/server.js - MCP stdio → MCP tools: starts server
mcp/stdio.js - Authentication → Auth and RBAC: loads tenant user
server/routes/auth.js - Authentication → JWT tokens: signs and verifies
server/routes/auth.js - Auth and RBAC → JWT tokens: verifies bearer
server/lib/middleware.js - Auth and RBAC → MySQL database: loads users and audits
server/lib/middleware.js - Tenant resolution → MySQL database: looks up tenants
server/lib/tenant.js - Tenant resolution → Auth and RBAC: reads authenticated user
server/lib/tenant.js - CRM leads → Lead stages: uses stage helpers
server/routes/leads.js - Company settings → Lead stages: ensures stages
server/routes/settings.js - Sales documents → Stock movements: updates stock
server/routes/salesdocs.js - Procurement and vendors → MySQL database: stores procurement
- Customer directory → MySQL database: stores customers
- Receipts → MySQL database: stores receipts
- CRM leads → MySQL database: stores leads
- Projects and costs → MySQL database: stores projects
- Expenses → MySQL database: stores expenses
server/routes/expenses.js - Items and warehouses → MySQL database: stores items
- Stock movements → MySQL database: stores movements
server/routes/stock.js - GST reconciliation → MySQL database: reads and records GST
- Dashboard KPIs → MySQL database: aggregates KPIs
- Global search → MySQL database: searches records
server/routes/search.js - Company settings → MySQL database: reads and writes settings
server/routes/settings.js - Staff and administration → MySQL database: manages administration