How pointfex/pointfex-erp-full-stack works
Pointfex is a role-governed ERP for staff and executives. Users authenticate through the React application, then work with tasks, projects, finance, reports, and organizational access; the NestJS API enforces permissions and persists domain state. The README documents additional governance, audit, and KPI/XP capabilities. Edges for those capabilities reflect that documentation; sampled source confirms selected controller-to-service and UI routing relationships, but unsampled wiring is not inferred.
Main entry points: app.module.ts NestJS API · App.tsx React ERP · kpi-engine.service.ts KPI and XP engine · AppContext.tsx App state and API
Components 22
Client application
- React ERP
frontend/src/App.tsx - App state and API
frontend/src/context/AppContext.tsx - Login and security UI
frontend/src/pages/auth/LoginPage.tsx - Role task views
frontend/src/pages/developer/DeveloperTasksPage.tsx
Identity and access
- Authentication
backend/src/auth/auth.service.ts - Authorization and roles
backend/src/rbac/authorization.service.ts - Permission enforcement
backend/src/common/permissions.guard.ts
ERP operations
- Employee directory
backend/src/employees/employees.service.ts - Projects and proposals
backend/src/projects/projects.service.ts - Task workflows
backend/src/tasks/tasks.service.ts - Finance and budgets
backend/src/finance/finance.service.ts - Reports
backend/src/reports/reports.service.ts - Quality and security alerts
backend/src/engineering/engineering.service.ts
Governance and performance
- Voting and approvals
backend/src/governance/vote-engine.service.ts - KPI and XP engine
backend/src/performance/kpi-engine.service.ts - KPI calculation engine
backend/src/performance/kpi-engine/xp-engine.ts - XP ledger
backend/src/performance/xp-ledger.service.ts - Tamper-evident audit
backend/src/common/audit-logger.service.ts
API and persistence
- NestJS API
backend/src/app.module.ts - Prisma persistence
backend/src/common/prisma.service.ts - PostgreSQL
Other components
- Staff and executives
Connections 26
- Staff and executives → React ERP: uses
README.md - React ERP → Login and security UI: routes to
frontend/src/App.tsx - React ERP → App state and API: provides state
frontend/src/App.tsx - React ERP → Role task views: routes to
frontend/src/App.tsx - App state and API → NestJS API: calls API
frontend/src/context/AppContext.tsx - Login and security UI → Authentication: authenticates via
README.md - NestJS API → Authentication: routes auth
backend/src/auth/auth.service.ts - Authentication → Authorization and roles: loads access profile
backend/src/auth/auth.service.ts - NestJS API → Permission enforcement: enforces access
README.md - Permission enforcement → Authorization and roles: resolves permissions
backend/src/common/permissions.guard.ts - NestJS API → Employee directory: serves directory
README.md - NestJS API → Projects and proposals: routes project work
- NestJS API → Task workflows: routes task work
- Role task views → App state and API: reads task data
frontend/src/pages/developer/DeveloperTasksPage.tsx - NestJS API → Finance and budgets: serves finance
README.md - NestJS API → Reports: serves reports
README.md - NestJS API → Quality and security alerts: serves quality controls
- NestJS API → Voting and approvals: supports executive votes
README.md - NestJS API → KPI and XP engine: runs KPI workflows
README.md - KPI and XP engine → KPI calculation engine: applies calculations
backend/src/performance/kpi-engine.service.ts - KPI and XP engine → XP ledger: records XP
README.md - NestJS API → Tamper-evident audit: records audit events
README.md - NestJS API → Prisma persistence: uses Prisma
README.md - Prisma persistence → PostgreSQL: reads and writes
README.md - Tamper-evident audit → PostgreSQL: appends audit trail
README.md - XP ledger → PostgreSQL: stores ledger events
README.md