alpe-temp 1.0.2 → 1.0.3

package/backend-project/src/modules/excel/excel.routes.js

@@ -1,13 +0,0 @@
-const { Router } = require('express');
-const ExcelController = require('./excel.controller');
-const { authenticate } = require('../../middleware/auth.middleware');
-
-const router = Router();
-
-// All export routes require authentication
-router.use(authenticate);
-
-router.get('/export/users',  ExcelController.exportUsers);
-router.post('/export/custom', ExcelController.exportCustom);
-
-module.exports = router;

package/backend-project/src/modules/excel/excel.service.js

@@ -1,303 +0,0 @@
-/**
- * excel.service.js
- * ─────────────────────────────────────────────────────────────────────────────
- * A fast, reusable Excel export utility built on ExcelJS.
- *
- * QUICK START
- * ───────────
- *   const ExcelService = require('./excel.service');
- *
- *   // 1. Stream directly to an HTTP response
- *   await ExcelService.exportToResponse(res, 'users-report', [
- *     {
- *       name: 'Users',
- *       columns: [
- *         { header: 'ID',    key: 'id',    width: 36 },
- *         { header: 'Name',  key: 'name',  width: 25 },
- *         { header: 'Email', key: 'email', width: 35 },
- *       ],
- *       rows: users,          // array of objects
- *     },
- *   ]);
- *
- *   // 2. Save to disk and get the file path back
- *   const filePath = await ExcelService.exportToFile('monthly-report', sheets, {
- *     outputDir: './exports',
- *   });
- *
- *   // 3. Get a raw Buffer (e.g. to upload to S3)
- *   const buffer = await ExcelService.exportToBuffer('report', sheets);
- * ─────────────────────────────────────────────────────────────────────────────
- */
-
-const ExcelJS = require('exceljs');
-const fs = require('fs');
-const path = require('path');
-const env = require('../../config/env');
-
-// ─── Colour palette ──────────────────────────────────────────────────────────
-const THEME = {
-  headerBg:   'FF2563EB',   // Blue-600
-  headerFg:   'FFFFFFFF',   // White
-  altRowBg:   'FFF0F4FF',   // Light blue-50
-  borderColor:'FFB0C4DE',   // Muted blue-200
-  totalBg:    'FFEFF6FF',   // Blue-50
-  totalFg:    'FF1D4ED8',   // Blue-700
-};
-
-// ─── Shared styles ────────────────────────────────────────────────────────────
-const HEADER_STYLE = {
-  font:      { name: 'Arial', bold: true, size: 11, color: { argb: THEME.headerFg } },
-  fill:      { type: 'pattern', pattern: 'solid', fgColor: { argb: THEME.headerBg } },
-  alignment: { horizontal: 'center', vertical: 'middle', wrapText: false },
-  border: {
-    top:    { style: 'thin', color: { argb: THEME.borderColor } },
-    bottom: { style: 'medium', color: { argb: THEME.headerBg } },
-  },
-};
-
-const CELL_BORDER = {
-  bottom: { style: 'hair', color: { argb: THEME.borderColor } },
-  right:  { style: 'hair', color: { argb: THEME.borderColor } },
-};
-
-// ─── Helpers ─────────────────────────────────────────────────────────────────
-
-/** Apply header row styling */
-const styleHeaderRow = (row) => {
-  row.height = 28;
-  row.eachCell((cell) => {
-    Object.assign(cell, HEADER_STYLE);
-    cell.font      = { ...HEADER_STYLE.font };
-    cell.fill      = { ...HEADER_STYLE.fill, fgColor: { argb: THEME.headerBg } };
-    cell.alignment = { ...HEADER_STYLE.alignment };
-    cell.border    = { ...HEADER_STYLE.border };
-  });
-};
-
-/** Apply alternating row colours + light borders */
-const styleDataRow = (row, rowIndex) => {
-  row.height = 20;
-  const isAlt = rowIndex % 2 === 0;
-  row.eachCell({ includeEmpty: true }, (cell) => {
-    cell.font      = { name: 'Arial', size: 10 };
-    cell.alignment = { vertical: 'middle' };
-    cell.border    = CELL_BORDER;
-    if (isAlt) {
-      cell.fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: THEME.altRowBg } };
-    }
-  });
-};
-
-/** Format a column's cells according to a `type` hint */
-const applyColumnFormat = (cell, value, type) => {
-  switch (type) {
-    case 'currency':
-      cell.numFmt = '"$"#,##0.00;[Red]("$"#,##0.00)';
-      cell.value  = typeof value === 'string' ? parseFloat(value) || 0 : value;
-      break;
-    case 'percent':
-      cell.numFmt = '0.0%';
-      cell.value  = typeof value === 'string' ? parseFloat(value) || 0 : value;
-      break;
-    case 'date':
-      cell.numFmt = 'yyyy-mm-dd';
-      cell.value  = value instanceof Date ? value : new Date(value);
-      break;
-    case 'number':
-      cell.numFmt = '#,##0.##';
-      cell.value  = typeof value === 'string' ? parseFloat(value) || 0 : value;
-      break;
-    default:
-      cell.value = value ?? '';
-  }
-};
-
-/**
- * buildWorkbook
- * Populates a workbook from a `sheets` array definition.
- *
- * @param {ExcelJS.Workbook} wb
- * @param {SheetDef[]} sheets
- *
- * SheetDef {
- *   name:     string                    – tab name
- *   columns:  ColumnDef[]              – column definitions
- *   rows:     object[]                 – data rows
- *   totals?:  Record<string, string>   – key → Excel formula string, e.g. { amount: '=SUM(C2:C100)' }
- *   freezeHeader?: boolean             – default true
- *   autoFilter?: boolean               – default true
- *   extraSheets?: SheetDef[]           – nested; same API
- * }
- *
- * ColumnDef {
- *   header:   string
- *   key:      string
- *   width?:   number   (default 18)
- *   type?:    'text' | 'number' | 'currency' | 'percent' | 'date'
- *   hidden?:  boolean
- * }
- */
-const buildWorkbook = (wb, sheets) => {
-  for (const sheetDef of sheets) {
-    const {
-      name,
-      columns,
-      rows = [],
-      totals,
-      freezeHeader = true,
-      autoFilter   = true,
-    } = sheetDef;
-
-    const ws = wb.addWorksheet(name, {
-      pageSetup: { fitToPage: true, fitToWidth: 1, orientation: 'landscape' },
-    });
-
-    // ── Columns ──────────────────────────────────────────────────────────────
-    ws.columns = columns.map(({ header, key, width = 18, hidden = false }) => ({
-      header,
-      key,
-      width,
-      hidden,
-    }));
-
-    // ── Header row ───────────────────────────────────────────────────────────
-    styleHeaderRow(ws.getRow(1));
-
-    // ── Data rows ────────────────────────────────────────────────────────────
-    rows.forEach((rowData, idx) => {
-      const row = ws.addRow({});
-      columns.forEach(({ key, type = 'text' }, colIdx) => {
-        const cell = row.getCell(colIdx + 1);
-        applyColumnFormat(cell, rowData[key], type);
-      });
-      styleDataRow(row, idx + 1);
-    });
-
-    // ── Totals row ───────────────────────────────────────────────────────────
-    if (totals && Object.keys(totals).length) {
-      const totalRow = ws.addRow({});
-      totalRow.height = 22;
-      columns.forEach(({ key }, colIdx) => {
-        const cell = totalRow.getCell(colIdx + 1);
-        if (totals[key]) {
-          cell.value = { formula: totals[key] };
-          cell.font  = { name: 'Arial', bold: true, size: 10, color: { argb: THEME.totalFg } };
-          cell.fill  = { type: 'pattern', pattern: 'solid', fgColor: { argb: THEME.totalBg } };
-        } else if (colIdx === 0) {
-          cell.value = 'TOTAL';
-          cell.font  = { name: 'Arial', bold: true, size: 10 };
-          cell.fill  = { type: 'pattern', pattern: 'solid', fgColor: { argb: THEME.totalBg } };
-        }
-        cell.border    = CELL_BORDER;
-        cell.alignment = { vertical: 'middle' };
-      });
-    }
-
-    // ── Auto-filter on header ─────────────────────────────────────────────────
-    if (autoFilter && columns.length) {
-      ws.autoFilter = {
-        from: { row: 1, column: 1 },
-        to:   { row: 1, column: columns.length },
-      };
-    }
-
-    // ── Freeze header row ────────────────────────────────────────────────────
-    if (freezeHeader) {
-      ws.views = [{ state: 'frozen', ySplit: 1 }];
-    }
-  }
-};
-
-// ─── Public API ──────────────────────────────────────────────────────────────
-
-const ExcelService = {
-  /**
-   * exportToResponse
-   * Stream the workbook directly to an Express `res` object.
-   *
-   * @param {import('express').Response} res
-   * @param {string} filename   – without extension
-   * @param {SheetDef[]} sheets
-   */
-  async exportToResponse(res, filename, sheets) {
-    const wb = new ExcelJS.Workbook();
-    wb.creator  = 'App Export';
-    wb.created  = new Date();
-    buildWorkbook(wb, sheets);
-
-    const safe = filename.replace(/[^a-z0-9_-]/gi, '_');
-    res.setHeader('Content-Type', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
-    res.setHeader('Content-Disposition', `attachment; filename="${safe}.xlsx"`);
-    res.setHeader('Cache-Control', 'no-cache');
-
-    await wb.xlsx.write(res);
-    res.end();
-  },
-
-  /**
-   * exportToBuffer
-   * Returns the workbook as a Node.js Buffer (for uploads, email attachments, etc.)
-   *
-   * @param {string}      filename  – metadata only
-   * @param {SheetDef[]}  sheets
-   * @returns {Promise<Buffer>}
-   */
-  async exportToBuffer(filename, sheets) {
-    const wb = new ExcelJS.Workbook();
-    wb.creator = filename;
-    wb.created = new Date();
-    buildWorkbook(wb, sheets);
-    return wb.xlsx.writeBuffer();
-  },
-
-  /**
-   * exportToFile
-   * Saves the workbook to disk and returns the absolute file path.
-   *
-   * @param {string}      filename
-   * @param {SheetDef[]}  sheets
-   * @param {{ outputDir?: string }} options
-   * @returns {Promise<string>}  absolute path to the saved file
-   */
-  async exportToFile(filename, sheets, options = {}) {
-    const outputDir = options.outputDir || env.EXCEL_OUTPUT_DIR;
-    fs.mkdirSync(outputDir, { recursive: true });
-
-    const safe     = filename.replace(/[^a-z0-9_-]/gi, '_');
-    const stamp    = new Date().toISOString().replace(/[:.]/g, '-');
-    const filePath = path.resolve(outputDir, `${safe}_${stamp}.xlsx`);
-
-    const wb = new ExcelJS.Workbook();
-    wb.creator = filename;
-    wb.created = new Date();
-    buildWorkbook(wb, sheets);
-    await wb.xlsx.writeFile(filePath);
-
-    return filePath;
-  },
-
-  /**
-   * buildSheetDef
-   * Convenience factory — infers column keys from the first row of data.
-   *
-   * @param {string}   name   – sheet tab name
-   * @param {object[]} rows   – data rows
-   * @param {object}   opts   – { columnWidths, columnTypes, totals, ... }
-   */
-  buildSheetDef(name, rows, opts = {}) {
-    const { columnWidths = {}, columnTypes = {}, totals, freezeHeader, autoFilter } = opts;
-    const keys = rows.length ? Object.keys(rows[0]) : [];
-
-    const columns = keys.map((key) => ({
-      header: key.replace(/_/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase()),
-      key,
-      width: columnWidths[key] || 18,
-      type:  columnTypes[key]  || 'text',
-    }));
-
-    return { name, columns, rows, totals, freezeHeader, autoFilter };
-  },
-};
-
-module.exports = ExcelService;

package/backend-project/src/modules/salary/salary.controller.js

@@ -1,70 +0,0 @@
-const SalaryService = require('./salary.service');
-const res_ = require('../../utils/response');
-
-const SalaryController = {
-  async create(req, res) {
-    try {
-      const data = req.body;
-      data.netSalary = data.grossSalary - data.totalDeduction;
-      const sal = await SalaryService.create(data);
-      return res_.created(res, sal, 'Salary record created');
-    } catch (err) {
-      console.error(`[SalaryController.create]`, err);
-      return res_.error(res, err.message, err.statusCode || 500);
-    }
-  },
-
-  async list(req, res) {
-    try {
-      const salaries = await SalaryService.list();
-      return res_.success(res, { salaries });
-    } catch (err) {
-      return res_.error(res, err.message, 500);
-    }
-  },
-
-  async getById(req, res) {
-    try {
-      const sal = await SalaryService.getById(req.params.id);
-      if (!sal) return res_.notFound(res, 'Salary record not found');
-      return res_.success(res, sal);
-    } catch (err) {
-      return res_.error(res, err.message, 500);
-    }
-  },
-
-  async update(req, res) {
-    try {
-      const data = req.body;
-      if (data.grossSalary !== undefined && data.totalDeduction !== undefined) {
-        data.netSalary = data.grossSalary - data.totalDeduction;
-      }
-      const sal = await SalaryService.update(req.params.id, data);
-      if (!sal) return res_.notFound(res, 'Salary record not found');
-      return res_.success(res, sal, 'Salary record updated');
-    } catch (err) {
-      return res_.error(res, err.message, 500);
-    }
-  },
-
-  async remove(req, res) {
-    try {
-      const sal = await SalaryService.remove(req.params.id);
-      if (!sal) return res_.notFound(res, 'Salary record not found');
-      return res_.success(res, null, 'Salary record deleted');
-    } catch (err) {
-      return res_.error(res, err.message, 500);
-    }
-  },
-
-  async average(req, res) {
-    try {
-      const avg = await SalaryService.average();
-      return res_.success(res, { averageSalary: avg });
-    } catch (err) {
-      return res_.error(res, err.message, 500);
-    }
-  },
-};
-
-module.exports = SalaryController;

package/backend-project/src/modules/salary/salary.model.js

@@ -1,23 +0,0 @@
-const mongoose = require('mongoose');
-
-const salarySchema = new mongoose.Schema({
-  employee:       { type: mongoose.Schema.Types.ObjectId, ref: 'Employee', required: true },
-  grossSalary:    { type: Number, required: true },
-  totalDeduction: { type: Number, required: true, default: 0 },
-  netSalary:      { type: Number, required: true },
-  month:          { type: String, required: true, trim: true },
-}, { timestamps: true });
-
-const Salary = mongoose.model('Salary', salarySchema);
-
-// Drop stale indexes from previous schema versions
-mongoose.connection.once('open', async () => {
-  try {
-    await Salary.collection.dropIndex('employeeNumber_1');
-  } catch {}
-  try {
-    await Salary.collection.dropIndex('salaryId_1');
-  } catch {}
-});
-
-module.exports = Salary;

package/backend-project/src/modules/salary/salary.routes.js

@@ -1,16 +0,0 @@
-const { Router } = require('express');
-const SalaryController = require('./salary.controller');
-const { authenticate } = require('../../middleware/auth.middleware');
-
-const router = Router();
-
-router.use(authenticate);
-
-router.post('/',      SalaryController.create);
-router.get('/',       SalaryController.list);
-router.get('/avg',    SalaryController.average);
-router.get('/:id',    SalaryController.getById);
-router.put('/:id',    SalaryController.update);
-router.delete('/:id', SalaryController.remove);
-
-module.exports = router;

package/backend-project/src/modules/salary/salary.service.js

@@ -1,44 +0,0 @@
-const Salary = require('./salary.model');
-
-const SalaryService = {
-  async create(data) {
-    const sal = await Salary.create(data);
-    return Salary.populate(sal, { path: 'employee', populate: { path: 'department' } });
-  },
-
-  async list() {
-    return Salary.find()
-      .populate({ path: 'employee', populate: { path: 'department' } })
-      .sort({ createdAt: -1 });
-  },
-
-  async getById(id) {
-    return Salary.findById(id)
-      .populate({ path: 'employee', populate: { path: 'department' } });
-  },
-
-  async update(id, data) {
-    return Salary.findByIdAndUpdate(id, data, { new: true })
-      .populate({ path: 'employee', populate: { path: 'department' } });
-  },
-
-  async remove(id) {
-    return Salary.findByIdAndDelete(id);
-  },
-
-  async average() {
-    const result = await Salary.aggregate([
-      { $group: { _id: null, avgSalary: { $avg: '$netSalary' } } },
-    ]);
-    return result.length > 0 ? result[0].avgSalary : 0;
-  },
-
-  async getMonthlyReport(month) {
-    const match = month ? { month } : {};
-    return Salary.find(match)
-      .populate({ path: 'employee', populate: { path: 'department' } })
-      .sort({ month: -1, createdAt: -1 });
-  },
-};
-
-module.exports = SalaryService;