Demo Payroll

Portfolio review path: Start with the capabilities and architecture below, then reproduce the documented verification commands. See SECURITY.md, CONTRIBUTING.md, and RIGHTS.md for the project's operating and reuse boundaries.

Demo Payroll is an enterprise-oriented payroll workflow application built as a Bun monorepo with a Next.js web front end.

Tip

Evaluating this project? Read the Engineering Overview for the payroll calculation model, package architecture, audit and persistence design, verification surface, and guided code tour.

Current Product Highlights

• enterprise employee records with structured identity, org, schedule, and statutory inputs
• payroll run creation, computation, review, approval, and completion flows
• configurable statutory profile templates with employee assignment and historical payroll snapshots
• settings-driven formatting, alert behavior, and persisted local demo-workspace behavior

Repo Layout

• apps/web — Next.js application
• packages/payroll-core — pure payroll and alerts logic
• packages/store — persisted app state, settings, and workflow mutators
• packages/ui — shared UI components
• CLIENT_HANDOFF.md — client-facing setup and scope notes
• handoff/client-export-manifest.md — include/exclude decisions for this snapshot

Supported Local Commands

• bun run bootstrap
• bun run dev
• bun run build
• bun run test:e2e
• bun run verify

Default Local Runtime

• The default local developer experience uses a seeded browser-persisted demo workspace.
• No environment variables are required to explore the app locally in demo mode.
• Firebase-auth deployment remains available through the shipped Firebase config and the sanitized example env file.
• The default demo dataset contains 11 employees, 10 active employees, and 1 inactive employee.
• Legacy five-person local snapshots are upgraded forward on load.

Deployment And Auth Notes

• firebase.json, firestore.rules, firestore.indexes.json, and apps/web/apphosting.yaml are included for hosted deployment review.
• .env.firebase.staging.example shows the environment shape used for Firebase-backed auth/runtime configuration without shipping real secrets.

Notes

• This branch is intentionally curated as a client-safe operational snapshot.
• Internal working materials that are not required for source review or local operation have been excluded from this handoff surface.