create-expresss 1.0.0

package/template/EPMS/Davina_LastName_National_Practical_Exam_2026/backend-project/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "epms-backend",
+  "version": "1.0.0",
+  "description": "PayMaster Ltd Employee Payroll Management System - Backend",
+  "main": "server.js",
+  "scripts": {
+    "start": "node server.js",
+    "dev": "node --watch server.js",
+    "seed": "node scripts/seedUser.js"
+  },
+  "dependencies": {
+    "bcryptjs": "^2.4.3",
+    "cors": "^2.8.5",
+    "dotenv": "^16.4.5",
+    "express": "^4.21.0",
+    "jsonwebtoken": "^9.0.2",
+    "mysql2": "^3.11.0"
+  }
+}

package/template/EPMS/Davina_LastName_National_Practical_Exam_2026/backend-project/routes/auth.js

@@ -0,0 +1,53 @@
+const express = require('express');
+const bcrypt = require('bcryptjs');
+const jwt = require('jsonwebtoken');
+const pool = require('../config/db');
+
+const router = express.Router();
+
+router.post('/login', async (req, res) => {
+  const { username, password } = req.body;
+  if (!username || !password) {
+    return res.status(400).json({ message: 'Username and password are required' });
+  }
+  try {
+    const [rows] = await pool.query('SELECT * FROM User WHERE username = ?', [username]);
+    if (rows.length === 0) {
+      return res.status(401).json({ message: 'Invalid credentials' });
+    }
+    const user = rows[0];
+    const valid = await bcrypt.compare(password, user.passwordHash);
+    if (!valid) {
+      return res.status(401).json({ message: 'Invalid credentials' });
+    }
+    const token = jwt.sign(
+      { userId: user.userId, username: user.username },
+      process.env.JWT_SECRET || 'epms_paymaster_secret_change_in_production',
+      { expiresIn: '8h' }
+    );
+    res.json({ token, username: user.username });
+  } catch (err) {
+    console.error(err);
+    res.status(500).json({ message: 'Server error during login' });
+  }
+});
+
+router.post('/register', async (req, res) => {
+  const { username, password } = req.body;
+  if (!username || !password) {
+    return res.status(400).json({ message: 'Username and password are required' });
+  }
+  try {
+    const hash = await bcrypt.hash(password, 10);
+    await pool.query('INSERT INTO User (username, passwordHash) VALUES (?, ?)', [username, hash]);
+    res.status(201).json({ message: 'User account created successfully' });
+  } catch (err) {
+    if (err.code === 'ER_DUP_ENTRY') {
+      return res.status(409).json({ message: 'Username already exists' });
+    }
+    console.error(err);
+    res.status(500).json({ message: 'Server error during registration' });
+  }
+});
+
+module.exports = router;

package/template/EPMS/Davina_LastName_National_Practical_Exam_2026/backend-project/routes/departments.js

@@ -0,0 +1,38 @@
+const express = require('express');
+const pool = require('../config/db');
+const auth = require('../middleware/auth');
+
+const router = express.Router();
+router.use(auth);
+
+router.post('/', async (req, res) => {
+  const { departmentCode, departmentName } = req.body;
+  if (!departmentCode || !departmentName) {
+    return res.status(400).json({ message: 'Department code and name are required' });
+  }
+  try {
+    await pool.query(
+      'INSERT INTO Department (departmentCode, departmentName) VALUES (?, ?)',
+      [departmentCode, departmentName]
+    );
+    res.status(201).json({ message: 'Department added successfully' });
+  } catch (err) {
+    if (err.code === 'ER_DUP_ENTRY') {
+      return res.status(409).json({ message: 'Department code already exists' });
+    }
+    console.error(err);
+    res.status(500).json({ message: 'Failed to add department' });
+  }
+});
+
+router.get('/', async (req, res) => {
+  try {
+    const [rows] = await pool.query('SELECT * FROM Department ORDER BY departmentName');
+    res.json(rows);
+  } catch (err) {
+    console.error(err);
+    res.status(500).json({ message: 'Failed to fetch departments' });
+  }
+});
+
+module.exports = router;

package/template/EPMS/Davina_LastName_National_Practical_Exam_2026/backend-project/routes/employees.js

@@ -0,0 +1,70 @@
+const express = require('express');
+const pool = require('../config/db');
+const auth = require('../middleware/auth');
+
+const router = express.Router();
+router.use(auth);
+
+router.post('/', async (req, res) => {
+  const {
+    employeeNumber,
+    firstName,
+    lastName,
+    address,
+    position,
+    telephone,
+    gender,
+    hiredDate,
+    departmentCode,
+  } = req.body;
+
+  if (!employeeNumber || !firstName || !lastName || !gender || !hiredDate) {
+    return res.status(400).json({ message: 'Required employee fields are missing' });
+  }
+
+  try {
+    await pool.query(
+      `INSERT INTO Employee 
+       (employeeNumber, firstName, lastName, address, position, telephone, gender, hiredDate, departmentCode)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      [
+        employeeNumber,
+        firstName,
+        lastName,
+        address || null,
+        position || null,
+        telephone || null,
+        gender,
+        hiredDate,
+        departmentCode || null,
+      ]
+    );
+    res.status(201).json({ message: 'Employee added successfully' });
+  } catch (err) {
+    if (err.code === 'ER_DUP_ENTRY') {
+      return res.status(409).json({ message: 'Employee number already exists' });
+    }
+    if (err.code === 'ER_NO_REFERENCED_ROW_2') {
+      return res.status(400).json({ message: 'Invalid department code' });
+    }
+    console.error(err);
+    res.status(500).json({ message: 'Failed to add employee' });
+  }
+});
+
+router.get('/', async (req, res) => {
+  try {
+    const [rows] = await pool.query(
+      `SELECT e.*, d.departmentName 
+       FROM Employee e 
+       LEFT JOIN Department d ON e.departmentCode = d.departmentCode 
+       ORDER BY e.lastName, e.firstName`
+    );
+    res.json(rows);
+  } catch (err) {
+    console.error(err);
+    res.status(500).json({ message: 'Failed to fetch employees' });
+  }
+});
+
+module.exports = router;

package/template/EPMS/Davina_LastName_National_Practical_Exam_2026/backend-project/routes/reports.js

@@ -0,0 +1,71 @@
+const express = require('express');
+const pool = require('../config/db');
+const auth = require('../middleware/auth');
+
+const router = express.Router();
+router.use(auth);
+
+function dateFilter(period) {
+  switch (period) {
+    case 'daily':
+      return 'DATE(createdAt) = CURDATE()';
+    case 'weekly':
+      return 'YEARWEEK(createdAt, 1) = YEARWEEK(CURDATE(), 1)';
+    case 'monthly':
+      return 'YEAR(createdAt) = YEAR(CURDATE()) AND MONTH(createdAt) = MONTH(CURDATE())';
+    default:
+      return '1=1';
+  }
+}
+
+router.get('/:period', async (req, res) => {
+  const period = req.params.period;
+  if (!['daily', 'weekly', 'monthly'].includes(period)) {
+    return res.status(400).json({ message: 'Period must be daily, weekly, or monthly' });
+  }
+  const where = dateFilter(period);
+  try {
+    const [employees] = await pool.query(
+      `SELECT e.*, d.departmentName FROM Employee e
+       LEFT JOIN Department d ON e.departmentCode = d.departmentCode
+       WHERE ${where.replace(/createdAt/g, 'e.createdAt')}`
+    );
+    const [departments] = await pool.query(
+      `SELECT * FROM Department WHERE ${where}`
+    );
+    const [salaries] = await pool.query(
+      `SELECT s.*, e.firstName, e.lastName FROM Salary s
+       JOIN Employee e ON s.employeeNumber = e.employeeNumber
+       WHERE ${where.replace(/createdAt/g, 's.createdAt')}`
+    );
+    const salaryTotals = salaries.reduce(
+      (acc, row) => {
+        acc.gross += Number(row.grossSalary);
+        acc.deduction += Number(row.totalDeduction);
+        acc.net += Number(row.netSalary);
+        return acc;
+      },
+      { gross: 0, deduction: 0, net: 0 }
+    );
+    res.json({
+      period,
+      generatedAt: new Date().toISOString(),
+      summary: {
+        employeeCount: employees.length,
+        departmentCount: departments.length,
+        salaryRecordCount: salaries.length,
+        totalGross: salaryTotals.gross,
+        totalDeduction: salaryTotals.deduction,
+        totalNet: salaryTotals.net,
+      },
+      employees,
+      departments,
+      salaries,
+    });
+  } catch (err) {
+    console.error(err);
+    res.status(500).json({ message: 'Failed to generate report' });
+  }
+});
+
+module.exports = router;

package/template/EPMS/Davina_LastName_National_Practical_Exam_2026/backend-project/routes/salaries.js

@@ -0,0 +1,92 @@
+const express = require('express');
+const pool = require('../config/db');
+const auth = require('../middleware/auth');
+
+const router = express.Router();
+router.use(auth);
+
+router.post('/', async (req, res) => {
+  const { grossSalary, totalDeduction, netSalary, monthOfPayment, employeeNumber } = req.body;
+  if (!grossSalary || !monthOfPayment || !employeeNumber) {
+    return res.status(400).json({ message: 'Gross salary, month, and employee number are required' });
+  }
+  const deduction = totalDeduction ?? 0;
+  const net = netSalary ?? Number(grossSalary) - Number(deduction);
+  try {
+    const [result] = await pool.query(
+      `INSERT INTO Salary (grossSalary, totalDeduction, netSalary, monthOfPayment, employeeNumber)
+       VALUES (?, ?, ?, ?, ?)`,
+      [grossSalary, deduction, net, monthOfPayment, employeeNumber]
+    );
+    res.status(201).json({ message: 'Salary record added', salaryId: result.insertId });
+  } catch (err) {
+    if (err.code === 'ER_NO_REFERENCED_ROW_2') {
+      return res.status(400).json({ message: 'Invalid employee number' });
+    }
+    console.error(err);
+    res.status(500).json({ message: 'Failed to add salary' });
+  }
+});
+
+router.get('/', async (req, res) => {
+  try {
+    const [rows] = await pool.query(
+      `SELECT s.*, e.firstName, e.lastName, e.position
+       FROM Salary s
+       JOIN Employee e ON s.employeeNumber = e.employeeNumber
+       ORDER BY s.createdAt DESC`
+    );
+    res.json(rows);
+  } catch (err) {
+    console.error(err);
+    res.status(500).json({ message: 'Failed to fetch salaries' });
+  }
+});
+
+router.get('/:id', async (req, res) => {
+  try {
+    const [rows] = await pool.query(
+      `SELECT s.*, e.firstName, e.lastName
+       FROM Salary s
+       JOIN Employee e ON s.employeeNumber = e.employeeNumber
+       WHERE s.salaryId = ?`,
+      [req.params.id]
+    );
+    if (rows.length === 0) return res.status(404).json({ message: 'Salary record not found' });
+    res.json(rows[0]);
+  } catch (err) {
+    console.error(err);
+    res.status(500).json({ message: 'Failed to fetch salary' });
+  }
+});
+
+router.put('/:id', async (req, res) => {
+  const { grossSalary, totalDeduction, netSalary, monthOfPayment, employeeNumber } = req.body;
+  const deduction = totalDeduction ?? 0;
+  const net = netSalary ?? Number(grossSalary) - Number(deduction);
+  try {
+    const [result] = await pool.query(
+      `UPDATE Salary SET grossSalary=?, totalDeduction=?, netSalary=?, monthOfPayment=?, employeeNumber=?
+       WHERE salaryId=?`,
+      [grossSalary, deduction, net, monthOfPayment, employeeNumber, req.params.id]
+    );
+    if (result.affectedRows === 0) return res.status(404).json({ message: 'Salary record not found' });
+    res.json({ message: 'Salary updated successfully' });
+  } catch (err) {
+    console.error(err);
+    res.status(500).json({ message: 'Failed to update salary' });
+  }
+});
+
+router.delete('/:id', async (req, res) => {
+  try {
+    const [result] = await pool.query('DELETE FROM Salary WHERE salaryId = ?', [req.params.id]);
+    if (result.affectedRows === 0) return res.status(404).json({ message: 'Salary record not found' });
+    res.json({ message: 'Salary deleted successfully' });
+  } catch (err) {
+    console.error(err);
+    res.status(500).json({ message: 'Failed to delete salary' });
+  }
+});
+
+module.exports = router;

package/template/EPMS/Davina_LastName_National_Practical_Exam_2026/backend-project/scripts/seedUser.js

@@ -0,0 +1,25 @@
+const bcrypt = require('bcryptjs');
+const mysql = require('mysql2/promise');
+require('dotenv').config({ path: require('path').join(__dirname, '..', '.env') });
+
+async function seed() {
+  const conn = await mysql.createConnection({
+    host: process.env.DB_HOST || 'localhost',
+    user: process.env.DB_USER || 'root',
+    password: process.env.DB_PASSWORD || '',
+    database: process.env.DB_NAME || 'EPMS',
+  });
+  const hash = await bcrypt.hash('hradmin123', 10);
+  await conn.query(
+    `INSERT INTO User (username, passwordHash) VALUES (?, ?)
+     ON DUPLICATE KEY UPDATE passwordHash = VALUES(passwordHash)`,
+    ['hradmin', hash]
+  );
+  console.log('Default user seeded: username=hradmin, password=hradmin123');
+  await conn.end();
+}
+
+seed().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/template/EPMS/Davina_LastName_National_Practical_Exam_2026/backend-project/server.js

@@ -0,0 +1,29 @@
+const express = require('express');
+const cors = require('cors');
+require('dotenv').config();
+
+const authRoutes = require('./routes/auth');
+const departmentRoutes = require('./routes/departments');
+const employeeRoutes = require('./routes/employees');
+const salaryRoutes = require('./routes/salaries');
+const reportRoutes = require('./routes/reports');
+
+const app = express();
+const PORT = process.env.PORT || 5000;
+
+app.use(cors());
+app.use(express.json());
+
+app.get('/api/health', (req, res) => {
+  res.json({ status: 'ok', service: 'EPMS Backend - PayMaster Ltd' });
+});
+
+app.use('/api/auth', authRoutes);
+app.use('/api/departments', departmentRoutes);
+app.use('/api/employees', employeeRoutes);
+app.use('/api/salaries', salaryRoutes);
+app.use('/api/reports', reportRoutes);
+
+app.listen(PORT, () => {
+  console.log(`EPMS backend running on http://localhost:${PORT}`);
+});

package/template/EPMS/Davina_LastName_National_Practical_Exam_2026/database/epms_schema.sql

@@ -0,0 +1,53 @@
+-- EPMS Database Schema
+-- Run: mysql -u root -p < epms_schema.sql
+
+CREATE DATABASE IF NOT EXISTS EPMS;
+USE EPMS;
+
+CREATE TABLE IF NOT EXISTS Department (
+  departmentCode VARCHAR(20) PRIMARY KEY,
+  departmentName VARCHAR(100) NOT NULL,
+  createdAt TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE TABLE IF NOT EXISTS Employee (
+  employeeNumber VARCHAR(20) PRIMARY KEY,
+  firstName VARCHAR(50) NOT NULL,
+  lastName VARCHAR(50) NOT NULL,
+  address VARCHAR(200),
+  position VARCHAR(80),
+  telephone VARCHAR(20),
+  gender ENUM('Male', 'Female', 'Other') NOT NULL,
+  hiredDate DATE NOT NULL,
+  departmentCode VARCHAR(20),
+  createdAt TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (departmentCode) REFERENCES Department(departmentCode)
+    ON UPDATE CASCADE ON DELETE SET NULL
+);
+
+CREATE TABLE IF NOT EXISTS Salary (
+  salaryId INT AUTO_INCREMENT PRIMARY KEY,
+  grossSalary DECIMAL(12, 2) NOT NULL,
+  totalDeduction DECIMAL(12, 2) NOT NULL DEFAULT 0,
+  netSalary DECIMAL(12, 2) NOT NULL,
+  monthOfPayment VARCHAR(20) NOT NULL,
+  employeeNumber VARCHAR(20) NOT NULL,
+  createdAt TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (employeeNumber) REFERENCES Employee(employeeNumber)
+    ON UPDATE CASCADE ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS User (
+  userId INT AUTO_INCREMENT PRIMARY KEY,
+  username VARCHAR(50) NOT NULL UNIQUE,
+  passwordHash VARCHAR(255) NOT NULL,
+  createdAt TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Default user: run `npm run seed` in backend-project after schema import
+
+-- Sample departments (optional)
+INSERT IGNORE INTO Department (departmentCode, departmentName) VALUES
+('LOG', 'Logistics'),
+('TRN', 'Transportation'),
+('HR', 'Human Resources');

package/template/EPMS/Davina_LastName_National_Practical_Exam_2026/docs/ERD.md

@@ -0,0 +1,75 @@
+# EPMS Entity Relationship Diagram
+
+## Entities & Attributes
+
+| Entity | Attributes | Primary Key |
+|--------|------------|-------------|
+| **Department** | departmentCode, departmentName | departmentCode |
+| **Employee** | employeeNumber, firstName, lastName, address, position, telephone, gender, hiredDate | employeeNumber |
+| **Salary** | grossSalary, totalDeduction, netSalary, monthOfPayment | salaryId (surrogate) |
+| **User** | username, password | userId |
+
+## Relationships & Cardinalities
+
+```
+Department (1) ────────< (M) Employee
+Employee   (1) ────────< (M) Salary
+```
+
+| Relationship | Cardinality | FK Location |
+|--------------|-------------|-------------|
+| Department employs Employee | 1:N | Employee.departmentCode → Department.departmentCode |
+| Employee receives Salary | 1:N | Salary.employeeNumber → Employee.employeeNumber |
+
+## Crow's Foot Notation (for draw.io / Lucidchart)
+
+1. **Department** — one side (|), **Employee** — many side (crow's foot)
+2. **Employee** — one side (|), **Salary** — many side (crow's foot)
+
+## Mermaid Diagram (import into draw.io or view in GitHub)
+
+```mermaid
+erDiagram
+    DEPARTMENT ||--o{ EMPLOYEE : employs
+    EMPLOYEE ||--o{ SALARY : receives
+
+    DEPARTMENT {
+        varchar departmentCode PK
+        varchar departmentName
+    }
+
+    EMPLOYEE {
+        varchar employeeNumber PK
+        varchar firstName
+        varchar lastName
+        varchar address
+        varchar position
+        varchar telephone
+        enum gender
+        date hiredDate
+        varchar departmentCode FK
+    }
+
+    SALARY {
+        int salaryId PK
+        decimal grossSalary
+        decimal totalDeduction
+        decimal netSalary
+        varchar monthOfPayment
+        varchar employeeNumber FK
+        datetime createdAt
+    }
+
+    USER {
+        int userId PK
+        varchar username UK
+        varchar passwordHash
+    }
+```
+
+## Notes for Paper ERD
+
+- Draw **Department** at top, **Employee** in middle, **Salary** at bottom.
+- Use solid lines for identifying relationships; label "employs" and "receives".
+- Mark PK with underline; FK with (FK) annotation.
+- Optional: minimum cardinality 0 on Employee→Department if employees can exist without department (schema allows NULL FK).

package/template/EPMS/Davina_LastName_National_Practical_Exam_2026/frontend-project/README.md

@@ -0,0 +1,16 @@
+# React + Vite
+
+This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+
+Currently, two official plugins are available:
+
+- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Oxc](https://oxc.rs)
+- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/)
+
+## React Compiler
+
+The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
+
+## Expanding the ESLint configuration
+
+If you are developing a production application, we recommend using TypeScript with type-aware lint rules enabled. Check out the [TS template](https://github.com/vitejs/vite/tree/main/packages/create-vite/template-react-ts) for information on how to integrate TypeScript and [`typescript-eslint`](https://typescript-eslint.io) in your project.

package/template/EPMS/Davina_LastName_National_Practical_Exam_2026/frontend-project/eslint.config.js

@@ -0,0 +1,21 @@
+import js from '@eslint/js'
+import globals from 'globals'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import { defineConfig, globalIgnores } from 'eslint/config'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{js,jsx}'],
+    extends: [
+      js.configs.recommended,
+      reactHooks.configs.flat.recommended,
+      reactRefresh.configs.vite,
+    ],
+    languageOptions: {
+      globals: globals.browser,
+      parserOptions: { ecmaFeatures: { jsx: true } },
+    },
+  },
+])

package/template/EPMS/Davina_LastName_National_Practical_Exam_2026/frontend-project/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>PayMaster EPMS</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.jsx"></script>
+  </body>
+</html>