Struct PayrollModule 

pub struct PayrollModule { /* private fields */ }

Payroll module configuration

Use the builder pattern to configure and register this module:

let payroll = PayrollModule::builder()
    .with_database(pool.clone())
    .build()?;

// Unguarded full CRUD (trusted/admin); compose a guarded router for production.
let router = payroll.all_crud_routes();

Implementations

impl PayrollModule

pub fn builder() -> PayrollModuleBuilder

Create a new module builder

pub fn all_crud_routes(&self) -> Router

Mount ALL generated CRUD endpoints (12 per entity) with NO domain validation — the fully unguarded surface. A well-formed request can create invalid rows or soft-delete a referenced master out from under its dependents. Prefer a guarded composition (read + validated writes) for any real deployment; use this only in trusted/admin/seeding contexts.

pub fn routes(&self) -> Router

👎Deprecated:

mounts unvalidated generic CRUD; prefer readonly_routes() + validated writes, or all_crud_routes() for the full/unguarded surface

Deprecated alias for Self::all_crud_routes. routes() reads like “the routes” but mounts UNVALIDATED generic CRUD on every entity — a naive mount exposes unguarded writes. Compose a guarded router (read + validated writes) for production, or call all_crud_routes() to opt into the full unguarded surface explicitly.

pub fn readonly_routes(&self) -> Router

Read-only routes for every entity (GET endpoints only) — the safe base.

Generic mutation can’t reach here, so this surface cannot bypass a validated write service’s invariants. Use this as the production base and merge validated write routes (or a write service’s HTTP layer) onto it.

pub fn payroll_write_service(&self) -> Arc<PayrollWriteService>

The module-held validated write service (run verbs, computed slips, seams).

pub fn with_payroll_write_service(self, svc: Arc<PayrollWriteService>) -> Self

Replace the write service at the composition root — the way a host wires real adapters over the fail-closed seams (e.g. staging domain events into an outbox) or swaps the pool-default input ports for adapters over the attendance/employee exports. Consuming self keeps the builder chain reading naturally:

let payroll = PayrollModule::builder()
    .with_database(pool.clone())
    .build()?
    .with_payroll_write_service(Arc::new(
        PayrollWriteService::new(pool.clone()).with_event_sink(my_outbox_sink),
    ));

Call before mounting routes; the module is consumed once at startup.