Документација за функцијата за извештаи од админ панелот

Опис на функцијата Оваа функција, означена како getDashboardStats, се користи за собирање и враќање на различни статистики и метрики од базата на податоци за административниот панел на апликацијата. Функцијата е асинхрона и повикува повеќе SQL прашања за да ги добие потребните податоци.

Податоци што ги враќа

Функцијата враќа објект со следниве податоци:

• employeeSales: Листа на вработени со број на продажби и вкупна вредност на продажбите.
• maintenanceStats: Листа на вработени (техничари) со број на завршени одржувања.
• customerTotals: Листа на купувачи со број на нарачки и вкупна потрошена сума
• averageMaintenanceTime: Просечно време (во минути) потребно за завршување на одржување
• totalProcurements: Вкупен број на барања за набавка
• avgProcurementValue: Просечна вредност на набавка
• totalRevenue: Вкупен приход од сите трансакции
• revenueSplit: Распределба на приход по тип на трансакција

Детали за SQL прашањата

• Продажби по вработен: Групира по вработен и дава број на продажби и вкупна вредност на продажбите
• Завршени одржувања по техничар: Групира по вработен и дава број на завршени одржувања, филтрирани само за оние со статус „Completed“
• Купувачи и нивните нарачки: Групира по купувач и дава број на нарачки и вкупна потрошена сума
• Просечно време на одржување: Го пресметува просечното време (во минути) помеѓу почетокот и крајот на завршените одржувања
• Вкупен број на барања за набавка: Брои колку барања за набавка има во базата
• Просечна вредност на набавка: Го пресметува просекот на вредноста на сите набавки
• Вкупен приход: Ги собира вредностите на сите трансакции
• Распределба на приход по тип: Групира по тип на трансакција и ги дава вредностите

Ракување со грешки

Доколку дојде до грешка при извр2шување на SQL прашањата, функцијата враќа HTTP статус 500 и порака за грешка. Исто така, во случај на празни резултати, се користат стандардни вредности (0) за да се избегнат грешки.

Предлози за подобрување

• Индексирање: Препорачливо е да се индексираат клучните колони како TransactionID, Status, EmployeeID и слично.
• Кеширање: За чести повици, може да се користи кеширање на податоците.
• Филтрирање по датум: Во иднина може да се додадат филтри за изве2стување по временски период.

const pool = require('../models/db');

  exports.getDashboardStats = async (req, res) => {
    try {
        const [employeeSales] = await pool.query(`
          SELECT e.EmployeeID, e.EmployeeName AS Name, e.EmployeeSurName AS Surname, COUNT(*) AS SalesCount, 
                 SUM(t.TotalPrice) AS TotalSales
          FROM procurement p
          JOIN t_type t ON t.TransactionID = p.TransactionID
          JOIN employee e ON e.EmployeeID = p.EmployeeID
          GROUP BY e.EmployeeID
        `);
        
        
        const [maintenanceStats] = await pool.query(`
          SELECT e.EmployeeID, e.EmployeeName AS Name, e.EmployeeSurName AS Surname, COUNT(*) AS MaintenanceDone
          FROM maintenance m
          JOIN employee e ON e.EmployeeID = m.EmployeeID
          WHERE m.Status = 'Completed'
          GROUP BY e.EmployeeID
        `);
  
      const [customerTotals] = await pool.query(`
        SELECT c.CustomerID, c.CustomerName, c.CustomerSurName, COUNT(*) AS Purchases, 
               SUM(t.TotalPrice) AS TotalSpent
        FROM procurement p
        JOIN customer c ON c.CustomerID = p.CustomerID
        JOIN t_type t ON t.TransactionID = p.TransactionID
        GROUP BY c.CustomerID
      `);
  
      const [averageMaintenanceTime] = await pool.query(`
        SELECT AVG(TIMESTAMPDIFF(MINUTE, StartTime, EndTime)) AS AvgMinutes
        FROM maintenance
        WHERE Status = 'Completed' AND StartTime IS NOT NULL AND EndTime IS NOT NULL
      `);
  
      const [totalProcurements] = await pool.query(`
        SELECT COUNT(*) AS TotalProcurements FROM procurement_request
      `);
  
      const [avgProcurementValue] = await pool.query(`
        SELECT AVG(TotalPrice) AS AvgProcurementValue FROM t_type
      `);
  
      const [totalRevenue] = await pool.query(`
        SELECT SUM(TotalPrice) AS TotalRevenue FROM t_type
      `);
  
      const [revenueSplit] = await pool.query(`
        SELECT Type, SUM(TotalPrice) AS Revenue FROM t_type GROUP BY Type
      `);
  
      res.json({
        employeeSales,
        maintenanceStats,
        customerTotals,
        averageMaintenanceTime: averageMaintenanceTime[0]?.AvgMinutes || 0,
        totalProcurements: totalProcurements[0]?.TotalProcurements || 0,
        avgProcurementValue: avgProcurementValue[0]?.AvgProcurementValue || 0,
        totalRevenue: totalRevenue[0]?.TotalRevenue || 0,
        revenueSplit
      });
    } catch (err) {
      console.error("Dashboard metrics fetch error:", err);
      res.status(500).json({ error: "Failed to fetch admin stats" });
    }
  };