Module map — zerp-be ↔︎ zerp-admin ↔︎ docs
The backend and admin modules do not map 1:1. The admin promotes some backend sub-modules to top-level (e.g.
account,item,taxation,bom), has UI-only modules with no backend (e.g.pos,dashboard,report-settings,setup,profile,preferences,wingold), and the backend has headless modules with no admin screen (e.g.mcp,otp,avg,tenant-config,version). This matrix is the authoritative correspondence; each row points at the zerp doc that covers it.
Legend: BE-only = no admin module · UI-only = no backend module · ⚠ = notable gap/stub found during documentation.
Domains
| zerp doc | zerp-be module(s) | zerp-admin module(s) |
|---|---|---|
| domains/finance/ (account, category, journal, transaction, contra, payment, taxation, cashbook, trade, note, shortcut) | finance/* (account, category, journal, transaction, contra, payment, taxation, cashbook, trade, note, shortcut, report, guards) |
finance/*, account, taxation |
| domains/inventory/ (item, categories-uom, pricing, stock, purchases, sales, transfers, adjustments, costing, fulfillment) | inventory/* (item, stock, order, purchase, sales, transfer, adjustment, goods-receipt, landed-cost, fulfillment, approval-threshold), product, avg ⚠(empty stub) |
inventory/*, item/*, product, store |
| domains/hr/ (employee, department, org-chart, calendar, attendance, timesheet, leave, payroll, claims-loans-advances, ess, training, hr-dashboard) | hr/* (employee, department, org-chart, calendar, attendance, timesheet, leave, payroll, claim, loan, advance, training, ess, dashboard, approval, approval-policy, approval-orchestrator) |
hr/*, employees, department, ess, hr-dashboard |
| domains/manufacturing/ (bom, routing-work-center, production, mrp, quality, accounting-reports) | manufacturing/* (bom, routing, work-center, production, mrp ⚠(stubbed), quality, accounting, dashboard, reports) |
manufacturing/*, bom |
| domains/projects/ (tasks-milestones, time-expense, members-reports) | project/* (project, task, milestone, time-entry, expense, member, report) |
project |
| domains/recruitment/ | recruitment/* (job-posting, job-applicant, interview-schedule, job-offer) |
hr/recruitment |
| domains/sales-pos/ (pos-terminal, pos-settings-session, order-flows) | (none — UI-only over the inventory order/sales engine) | pos/* (terminal, order, session, settings) |
| domains/crm/ (customers, suppliers, kyc) | customer, supplier, kyc |
customers, suppliers, kyc |
| domains/master-data/ (master-reference-data, company-branch, fiscal-period, exchange-rate, config) | master, company, branch, fiscal, exchange, config, tenant-config (BE-only) |
master, company, store, fiscalPeriod, exchange, config, setup (UI-only) |
| domains/assets/ (fixed-assets-depreciation) | assets |
assets |
| domains/budget/ | budget/* (+ item) ⚠(no variance impl) |
budget |
| domains/subscription-config/ (subscription-features) | subscription/* (plan, feature, guards) |
subscription, features/company-features (pages) |
| domains/user-access/ (users, profile-preferences) | user, user-preference |
user, profile (UI-only), preferences (UI-only) |
| domains/integrations/ (mcp, zoom, version, wingold) | mcp (BE-only), zoom, version (BE-only) |
hr/zoom, wingold ⚠(orphaned stub, UI-only) |
Platform (cross-cutting)
| zerp doc | zerp-be module(s) | zerp-admin module(s) |
|---|---|---|
| platform/architecture | (whole codebase / core/) |
(whole codebase / components/) |
| platform/multi-tenancy | tenant-config, config, core/database, context.ts |
(runtime env / NEXT_PUBLIC_SERVER_URL) |
| platform/auth | auth/* (token, strategies, guards, decorators), otp (BE-only) |
auth (signin, password), ess/auth |
| platform/permissions-access | permission/* (group, module, action, client, guards), master-access |
permission/*, master-access |
| platform/workflow-approval-engine | workflow/* (engine, stage, approver, approval, task, event, notification), hr/approval* |
workflow/* |
| platform/audit-trail | audit-trail, log, @AuditMeta interceptor |
audit-trail |
| platform/notifications | notification, workflow/notification, ApMailerModule, Redis pubsub |
notification |
| platform/files-assets-upload | upload, ApUploadModule (S3) |
fileUpload |
| platform/reporting-framework | report, finance/report |
report/* (trial-balance, general-ledger, pnl, balance-sheet, aged-receivable/payable, cashflow, tax, sales, inventory, stock, account, assets, store, trade-receivable/payable), report-settings (UI-only) |
Unmapped / noted
- admin
dashboard+dasboard(typo dir) — operator landing dashboards; data sourced from various domain queries. Covered contextually in domain_overviewdocs and reporting-framework. - admin
template— shared print/PDF templates; referenced from finance/inventory print flows. - BE
log— system activity log; documented in audit-trail. - BE
avg— empty average-costing stub; the real costing engines are in inventory/costing.