Logo Lanfrica

Wyzdmulc265/payroll-web

Domain:

socioeconomic

Record type:

software
Creator:
Wyz
Host:
a web-based payroll for malawi # WizTech Payroll Web App A modern, full-stack payroll management application for Malawi, built with Next.js 16, Prisma, PostgreSQL (Neon), and TypeScript. ## πŸ—οΈ Architecture ``` payroll-web/ β”œβ”€β”€ prisma/ β”‚ β”œβ”€β”€ schema.prisma # Database schema (Employees, PayrollRecords, AuditLogs, Settings) β”‚ └── seed.ts # Seed script with sample data β”œβ”€β”€ src/ β”‚ β”œβ”€β”€ app/ # Next.js App Router pages β”‚ β”‚ β”œβ”€β”€ api/ # API routes β”‚ β”‚ β”‚ β”œβ”€β”€ employees/ # Employee CRUD β”‚ β”‚ β”‚ β”œβ”€β”€ payroll/ # Payroll calculation & processing β”‚ β”‚ β”‚ β”œβ”€β”€ payslips/ # Payslip generation β”‚ β”‚ β”‚ β”œβ”€β”€ reports/ # 6 report types β”‚ β”‚ β”‚ β”œβ”€β”€ dashboard/ # KPIs & charts β”‚ β”‚ β”‚ └── settings/ # Configuration management β”‚ β”‚ β”œβ”€β”€ dashboard/ # Management dashboard with charts β”‚ β”‚ β”œβ”€β”€ employees/ # Employee management UI β”‚ β”‚ β”œβ”€β”€ payroll/ # Payroll processing UI β”‚ β”‚ β”œβ”€β”€ payslips/ # Payslip viewer & PDF export β”‚ β”‚ β”œβ”€β”€ reports/ # Report generator β”‚ β”‚ └── settings/ # System configuration β”‚ β”œβ”€β”€ lib/ β”‚ β”‚ β”œβ”€β”€ payroll-engine.ts # Pure TS Malawi payroll calculations β”‚ β”‚ β”œβ”€β”€ prisma.ts # Prisma client singleton β”‚ β”‚ └── utils.ts # Utility functions β”œβ”€β”€ .env # Environment variables (DATABASE_URL, NEXTAUTH_SECRET) β”œβ”€β”€ package.json └── README.md ``` ## πŸš€ Quick Start ### Prerequisites - Node.js 18+ - Neon PostgreSQL database (or any PostgreSQL) - npm or yarn ### Installation ```bash cd payroll-web # Install dependencies npm install # Generate Prisma client npm run prisma:generate # Push schema to database (requires DATABASE_URL in .env) npm run prisma:push # Seed with sample data npm run prisma:seed # Or run all at once npm run db:setup # Start development server npm run dev ``` ### Environment Variables Create `.env` file: ```env # Neon …