Payroll modules
| Module | Public path | Description |
|---|---|---|
| Payroll runs | /api/v1/payroll/payroll/* | Create runs, process, validate |
| Payslips | /api/v1/payroll/payslips/* | View payslip lines and totals |
| Employees (mirror) | /api/v1/payroll/internal/employees/* | HR sync only |
| Contracts (mirror) | /api/v1/payroll/internal/contracts/* | HR contract sync |
Processing pipeline
Payroll runs support a full process / validate pipeline. Heavy computation may be pushed to Kafka for async execution.Events
On completion, payroll publishesPAYROLL_RUN_COMPLETED on topic payroll.events for FluideBooks to post journal entries. See Books payroll GL.
Technology
| Layer | Choice |
|---|---|
| Framework | NestJS 11 |
| ORM | TypeORM |
| DB | PostgreSQL (JSONB for allowances/deductions) |
| Metrics | Prometheus /metrics |