Payroll SystemDocumentation

A web-based Philippine payroll management system — setup, testing, and thesis-defense preparation, all in one place.

The System in Plain English

A jargon-free explanation of what the system is and how it works — for non-technical panelists, stakeholders, and testers.

Testing Guide

Step-by-step setup, database seeding, verifying payroll math, and the demo/test script to run before testers arrive.

Tester Handouts

One-page sheets to give each tester — technical and plain-English versions — with accounts, the flow to follow, and where to leave feedback.

Final Defense Guide

Architecture in plain language, the computation engine explained, a worked payslip, a panelist question bank with model answers, and how to defend limitations.

Defense-Day Cheat Sheet

One printable page to hold during the defense — the pitch, the stack, the worked numbers, key formulas, and rapid answers.

Project Summary

The current feature status and future-work list for the system.

Documentation index

The System in Plain English — jargon-free overview for anyone.
Testing Guide — setup, seeding, verifying payroll math, and the demo/test script.
Tester Handout · Plain-English Handout — sheets to give testers.
Final Defense Guide — deep defense preparation with a panelist Q&A bank.
Defense-Day Cheat Sheet — printable one-pager.
Project Summary — current feature status and future work.

Quick start (TL;DR)

bash

# 1. Create .env from the template and fill in DATABASE_URL
cp .env.example .env

# 2. Install, reset+seed the database, run
bun install
bun run db:reset-seed
bun run dev            # → http://localhost:3000

# 3. Verify payroll numbers before anyone tests
bun run tsx --env-file=.env scripts/verify-payroll.ts

Seeded login accounts are listed in the Testing Guide.