Feature/stats page

src/backend/index.ts

@@ -17,6 +17,7 @@ import workPackageTemplatesRouter from './src/routes/work-package-templates.rout
 import carsRouter from './src/routes/cars.routes';
 import organizationRouter from './src/routes/organizations.routes';
 import recruitmentRouter from './src/routes/recruitment.routes';
+import statisticsRouter from './src/routes/statistics.routes';
 
 const app = express();
 
@@ -68,6 +69,7 @@ app.use('/templates', workPackageTemplatesRouter);
 app.use('/cars', carsRouter);
 app.use('/organizations', organizationRouter);
 app.use('/recruitment', recruitmentRouter);
+app.use('/statistics', statisticsRouter);
 app.use('/', (_req, res) => {
   res.status(200).json('Welcome to FinishLine');
 });

src/backend/src/controllers/statistics.controllers.ts

@@ -0,0 +1,142 @@
+import { NextFunction, Request, Response } from 'express';
+import StatisticsService from '../services/statistics.services';
+import { Graph, GraphCollection } from 'shared';
+
+export default class StatisticsController {
+  static async createGraph(req: Request, res: Response, next: NextFunction) {
+    try {
+      const {
+        startDate,
+        endDate,
+        title,
+        graphType,
+        graphDisplayType,
+        measure,
+        carIds,
+        graphCollectionId,
+        specialPermissions
+      } = req.body;
+
+      const graph: Graph = await StatisticsService.createGraph(
+        req.currentUser,
+        title,
+        graphType,
+        measure,
+        graphDisplayType,
+        req.organization,
+        carIds,
+        specialPermissions,
+        startDate ? new Date(startDate) : undefined,
+        endDate ? new Date(endDate) : undefined,
+        graphCollectionId
+      );
+
+      res.status(200).json(graph);
+    } catch (error: unknown) {
+      next(error);
+    }
+  }
+
+  static async getSingleGraph(req: Request, res: Response, next: NextFunction) {
+    try {
+      const { graphId } = req.params;
+
+      const requestedGraph = await StatisticsService.getSingleGraph(graphId, req.currentUser, req.organization);
+
+      res.status(200).json(requestedGraph);
+    } catch (error: unknown) {
+      next(error);
+    }
+  }
+
+  static async getAllGraphCollections(req: Request, res: Response, next: NextFunction) {
+    try {
+      const graphCollections = await StatisticsService.getAllGraphCollections(req.currentUser, req.organization);
+      res.status(200).json(graphCollections);
+    } catch (error: unknown) {
+      next(error);
+    }
+  }
+
+  static async editGraph(req: Request, res: Response, next: NextFunction) {
+    try {
+      const {
+        startDate,
+        endDate,
+        title,
+        graphType,
+        measure,
+        graphDisplayType,
+        graphCollectionId,
+        carIds,
+        specialPermissions
+      } = req.body;
+      const { graphId } = req.params;
+
+      const updatedGraph = await StatisticsService.editGraph(
+        req.currentUser,
+        graphId,
+        title,
+        graphType,
+        measure,
+        graphDisplayType,
+        req.organization,
+        carIds,
+        specialPermissions,
+        startDate ? new Date(startDate) : undefined,
+        endDate ? new Date(endDate) : undefined,
+        graphCollectionId
+      );
+
+      res.status(200).json(updatedGraph);
+    } catch (error: unknown) {
+      next(error);
+    }
+  }
+
+  static async createGraphCollection(req: Request, res: Response, next: NextFunction) {
+    try {
+      const { title, specialPermissions } = req.body;
+      const graphCollection: GraphCollection = await StatisticsService.createGraphCollection(
+        req.currentUser,
+        title,
+        specialPermissions,
+        req.organization
+      );
+      res.status(200).json(graphCollection);
+    } catch (error: unknown) {
+      next(error);
+    }
+  }
+
+  static async editGraphCollection(req: Request, res: Response, next: NextFunction) {
+    try {
+      const { title, specialPermissions } = req.body;
+      const { graphCollectionId } = req.params;
+      const graphCollection: GraphCollection = await StatisticsService.editGraphCollection(
+        req.currentUser,
+        graphCollectionId,
+        title,
+        specialPermissions,
+        req.organization
+      );
+      res.status(200).json(graphCollection);
+    } catch (error: unknown) {
+      next(error);
+    }
+  }
+
+  static async getSingleGraphCollection(req: Request, res: Response, next: NextFunction) {
+    try {
+      const { graphCollectionId } = req.params;
+      const graphCollection: GraphCollection = await StatisticsService.getSingleGraphCollection(
+        req.currentUser,
+        graphCollectionId,
+        req.organization
+      );
+      res.status(200).json(graphCollection);
+    } catch (error: unknown) {
+      next(error);
+    }
+  }
+}

src/backend/src/prisma-query-args/statistics.query-args.ts

@@ -0,0 +1,25 @@
+import { Prisma } from '@prisma/client';
+import { getUserQueryArgs, getUserWithSettingsQueryArgs } from './user.query-args';
+
+export type GraphQueryArgs = ReturnType<typeof getGraphQueryArgs>;
+export type GraphCollectionQueryArgs = ReturnType<typeof getGraphCollectionQueryArgs>;
+
+export const getGraphQueryArgs = (organizationId: string) =>
+  Prisma.validator<Prisma.GraphDefaultArgs>()({
+    include: {
+      organization: true,
+      userCreated: getUserWithSettingsQueryArgs(organizationId),
+      userDeleted: getUserQueryArgs(organizationId),
+      cars: true
+    }
+  });
+
+export const getGraphCollectionQueryArgs = (organizationId: string) =>
+  Prisma.validator<Prisma.Graph_CollectionDefaultArgs>()({
+    include: {
+      graphs: getGraphQueryArgs(organizationId),
+      organization: true,
+      userCreated: getUserQueryArgs(organizationId),
+      userDeleted: getUserQueryArgs(organizationId)
+    }
+  });

src/backend/src/prisma/migrations/20241227031743_stats_page/migration.sql

@@ -0,0 +1,100 @@
+-- CreateEnum
+CREATE TYPE "Graph_Type" AS ENUM ('PROJECT_BUDGET_BY_PROJECT', 'PROJECT_BUDGET_BY_TEAM', 'PROJECT_BUDGET_BY_DIVISION', 'CHANGE_REQUESTS_BY_PROJECT', 'CHANGE_REQUESTS_BY_TEAM', 'CHANGE_REQUESTS_BY_DIVISION', 'REIMBURSEMENT_TOTAL_BY_PROJECT', 'REIMBURSEMENT_TOTAL_BY_TEAM', 'REIMBURSEMENT_TOTAL_BY_DIVISION');
+
+-- CreateEnum
+CREATE TYPE "Graph_Display_Type" AS ENUM ('PIE', 'BAR');
+
+-- CreateEnum
+CREATE TYPE "Measure" AS ENUM ('SUM', 'AVG');
+
+-- CreateEnum
+CREATE TYPE "Graph_Permission" AS ENUM ('EDIT_GRAPH', 'CREATE_GRAPH', 'VIEW_GRAPH', 'DELETE_GRAPH');
+
+-- CreateEnum
+CREATE TYPE "Graph_Collection_Permission" AS ENUM ('EDIT_GRAPH_COLLECTION', 'CREATE_GRAPH_COLLECTION', 'VIEW_GRAPH_COLLECTION', 'DELETE_GRAPH_COLLECTION');
+
+-- CreateEnum
+CREATE TYPE "Special_Permission" AS ENUM ('FINANCE_ONLY');
+
+-- AlterTable
+ALTER TABLE "Team_Type" ADD COLUMN     "dateDeleted" TIMESTAMP(3),
+ADD COLUMN     "deletedById" TEXT;
+
+-- AlterTable
+ALTER TABLE "User" ADD COLUMN     "additionalPermissions" TEXT[];
+
+-- CreateTable
+CREATE TABLE "Graph" (
+    "id" TEXT NOT NULL,
+    "startDate" TIMESTAMP(3),
+    "endDate" TIMESTAMP(3),
+    "title" TEXT NOT NULL,
+    "graphType" "Graph_Type" NOT NULL,
+    "displayGraphType" "Graph_Display_Type" NOT NULL,
+    "measure" "Measure" NOT NULL,
+    "dateDeleted" TIMESTAMP(3),
+    "dateCreated" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "specialPermissions" "Special_Permission"[],
+    "graphCollectionId" TEXT,
+    "userCreatedId" TEXT NOT NULL,
+    "userDeletedId" TEXT,
+    "organizationId" TEXT NOT NULL,
+
+    CONSTRAINT "Graph_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "Graph_Collection" (
+    "id" TEXT NOT NULL,
+    "title" TEXT NOT NULL,
+    "dateDeleted" TIMESTAMP(3),
+    "viewPermissions" "Special_Permission"[],
+    "dateCreated" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "userCreatedId" TEXT NOT NULL,
+    "userDeletedId" TEXT,
+    "organizationId" TEXT NOT NULL,
+
+    CONSTRAINT "Graph_Collection_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "_graphCars" (
+    "A" TEXT NOT NULL,
+    "B" TEXT NOT NULL
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "_graphCars_AB_unique" ON "_graphCars"("A", "B");
+
+-- CreateIndex
+CREATE INDEX "_graphCars_B_index" ON "_graphCars"("B");
+
+-- AddForeignKey
+ALTER TABLE "Team_Type" ADD CONSTRAINT "Team_Type_deletedById_fkey" FOREIGN KEY ("deletedById") REFERENCES "User"("userId") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Graph" ADD CONSTRAINT "Graph_graphCollectionId_fkey" FOREIGN KEY ("graphCollectionId") REFERENCES "Graph_Collection"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Graph" ADD CONSTRAINT "Graph_userCreatedId_fkey" FOREIGN KEY ("userCreatedId") REFERENCES "User"("userId") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Graph" ADD CONSTRAINT "Graph_userDeletedId_fkey" FOREIGN KEY ("userDeletedId") REFERENCES "User"("userId") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Graph" ADD CONSTRAINT "Graph_organizationId_fkey" FOREIGN KEY ("organizationId") REFERENCES "Organization"("organizationId") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Graph_Collection" ADD CONSTRAINT "Graph_Collection_userCreatedId_fkey" FOREIGN KEY ("userCreatedId") REFERENCES "User"("userId") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Graph_Collection" ADD CONSTRAINT "Graph_Collection_userDeletedId_fkey" FOREIGN KEY ("userDeletedId") REFERENCES "User"("userId") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Graph_Collection" ADD CONSTRAINT "Graph_Collection_organizationId_fkey" FOREIGN KEY ("organizationId") REFERENCES "Organization"("organizationId") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "_graphCars" ADD CONSTRAINT "_graphCars_A_fkey" FOREIGN KEY ("A") REFERENCES "Car"("carId") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "_graphCars" ADD CONSTRAINT "_graphCars_B_fkey" FOREIGN KEY ("B") REFERENCES "Graph"("id") ON DELETE CASCADE ON UPDATE CASCADE;