tasks on gantt chart

Author: chpy04

src/backend/src/controllers/tasks.controllers.ts

@@ -5,7 +5,7 @@ import { validateWBS, WbsNumber } from 'shared';
 export default class TasksController {
   static async createTask(req: Request, res: Response, next: NextFunction) {
     try {
-      const { title, deadline, priority, status, assignees, notes } = req.body;
+      const { title, deadline, startDate, priority, status, assignees, notes } = req.body;
       const wbsNum: WbsNumber = validateWBS(req.params.wbsNum);
 
       const task = await TasksService.createTask(
@@ -17,6 +17,7 @@ export default class TasksController {
         status,
         assignees,
         req.organization,
+        startDate ? new Date(startDate) : undefined,
         deadline ? new Date(deadline) : undefined
       );
 
@@ -28,7 +29,7 @@ export default class TasksController {
 
   static async editTask(req: Request, res: Response, next: NextFunction) {
     try {
-      const { title, notes, priority, deadline } = req.body;
+      const { title, notes, priority, deadline, startDate } = req.body;
       const { taskId } = req.params;
 
       const updateTask = await TasksService.editTask(
@@ -38,7 +39,8 @@ export default class TasksController {
         title,
         notes,
         priority,
-        deadline
+        startDate ? new Date(startDate) : undefined,
+        deadline ? new Date(deadline) : undefined
       );
 
       res.status(200).json(updateTask);

src/backend/src/prisma/migrations/20250930025621_task_start_dates/migration.sql

@@ -0,0 +1,2 @@
+-- AlterTable
+ALTER TABLE "public"."Task" ADD COLUMN     "startDate" TIMESTAMP(3);

src/backend/src/prisma/schema.prisma

@@ -630,6 +630,7 @@ model Task {
   title           String
   notes           String
   deadline        DateTime?
+  startDate       DateTime?
   assignees       User[]        @relation(name: "assignedTo")
   priority        Task_Priority
   status          Task_Status

src/backend/src/routes/tasks.routes.ts

@@ -9,6 +9,7 @@ tasksRouter.post(
   '/:wbsNum',
   nonEmptyString(body('title')),
   isOptionalDate(body('deadline')),
+  isOptionalDate(body('startDate')),
   body('notes').isString(),
   isTaskPriority(body('priority')),
   isTaskStatus(body('status')),
@@ -23,6 +24,7 @@ tasksRouter.post(
   nonEmptyString(body('title')),
   nonEmptyString(body('notes')),
   isOptionalDate(body('deadline')),
+  isOptionalDate(body('startDate')),
   isTaskPriority(body('priority')),
   TasksController.editTask
 );

src/backend/src/services/tasks.services.ts

@@ -40,6 +40,7 @@ export default class TasksService {
     status: Task_Status,
     assignees: string[],
     organization: Organization,
+    startDate?: Date,
     deadline?: Date
   ): Promise<Task> {
     const requestedWbsElement = await prisma.wBS_Element.findUnique({
@@ -93,6 +94,7 @@ export default class TasksService {
         },
         title,
         notes,
+        startDate,
         deadline,
         priority,
         status,
@@ -127,7 +129,8 @@ export default class TasksService {
     title: string,
     notes: string,
     priority: Task_Priority,
-    deadline: Date
+    startDate?: Date,
+    deadline?: Date
   ) {
     const hasPermission = await userHasPermission(user.userId, organizationId, notGuest);
     if (!hasPermission) throw new AccessDeniedException('Guests cannot edit tasks');
@@ -144,7 +147,7 @@ export default class TasksService {
 
     const updatedTask = await prisma.task.update({
       where: { taskId },
-      data: { title, notes, priority, deadline },
+      data: { title, notes, priority, startDate, deadline },
       ...getTaskQueryArgs(originalTask.wbsElement.organizationId)
     });
     return taskTransformer(updatedTask);

src/backend/src/transformers/tasks.transformer.ts

@@ -13,6 +13,7 @@ const taskTransformer = (task: Prisma.TaskGetPayload<TaskQueryArgs>): Task => {
     title: task.title,
     notes: task.notes,
     deadline: task.deadline ?? undefined,
+    startDate: task.startDate ?? undefined,
     priority: convertTaskPriority(task.priority),
     status: convertTaskStatus(task.status),
     createdBy: userTransformer(task.createdBy),

src/frontend/src/apis/tasks.api.ts

@@ -12,10 +12,12 @@ import { taskTransformer } from './transformers/tasks.transformers';
  * Api call to create a task.
  * @param wbsNum wbsNum of the wbsElement that the task is associated with
  * @param title the title of the task
- * @param deadline the datestring deadline of the task
  * @param priority the priority of the task
  * @param status the status of the task
  * @param assignees the ids of the users assigned to the task
+ * @param notes the notes for the task
+ * @param deadline the datestring deadline of the task
+ * @param startDate the datestring start date of the task
  * @returns
  */
 export const createSingleTask = (
@@ -25,13 +27,15 @@ export const createSingleTask = (
   status: TaskStatus,
   assignees: string[],
   notes: string,
-  deadline?: string
+  deadline?: string,
+  startDate?: string
 ) => {
   return axios.post<Task>(
     apiUrls.tasksCreate(wbsPipe(wbsNum)),
     {
       title,
       deadline,
+      startDate,
       priority,
       status,
       assignees,
@@ -50,15 +54,23 @@ export const createSingleTask = (
  * @param notes the new notes
  * @param priority the new priority
  * @param deadline the new deadline
- * @param assignees the new assignees
+ * @param startDate the new start date
  * @returns the edited task
  */
-export const editTask = (taskId: string, title: string, notes: string, priority: TaskPriority, deadline?: Date) => {
+export const editTask = (
+  taskId: string,
+  title: string,
+  notes: string,
+  priority: TaskPriority,
+  deadline?: Date,
+  startDate?: Date
+) => {
   return axios.post<{ message: string }>(apiUrls.editTaskById(taskId), {
     title,
     notes,
     priority,
-    deadline
+    deadline,
+    startDate
   });
 };
 

src/frontend/src/apis/transformers/tasks.transformers.ts

@@ -11,6 +11,7 @@ export const taskTransformer = (task: Task): Task => {
     ...task,
     dateCreated: new Date(task.dateCreated),
     dateDeleted: task.dateDeleted ? new Date(task.dateDeleted) : undefined,
-    deadline: task.deadline ? new Date(task.deadline) : undefined
+    deadline: task.deadline ? new Date(task.deadline) : undefined,
+    startDate: task.startDate ? new Date(task.startDate) : undefined
   };
 };

src/frontend/src/hooks/tasks.hooks.ts

@@ -8,33 +8,46 @@ import { WbsNumber, TaskPriority, TaskStatus, Task } from 'shared';
 import { createSingleTask, deleteSingleTask, editSingleTaskStatus, editTask, editTaskAssignees } from '../apis/tasks.api';
 
 export interface CreateTaskPayload {
+  wbsNum: WbsNumber;
   title: string;
+  startDate?: string;
   deadline?: string;
   priority: TaskPriority;
   status: TaskStatus;
   notes?: string;
   assignees: string[];
 }
 
-export const useCreateTask = (wbsNum: WbsNumber) => {
-  return useMutation<Task, Error, CreateTaskPayload>(['tasks'], async (createTaskPayload: CreateTaskPayload) => {
-    const { data } = await createSingleTask(
-      wbsNum,
-      createTaskPayload.title,
-      createTaskPayload.priority,
-      createTaskPayload.status,
-      createTaskPayload.assignees,
-      createTaskPayload.notes ?? '',
-      createTaskPayload.deadline
-    );
-    return data;
-  });
+export const useCreateTask = () => {
+  const queryClient = useQueryClient();
+  return useMutation<Task, Error, CreateTaskPayload>(
+    ['tasks', 'create'],
+    async (createTaskPayload: CreateTaskPayload) => {
+      const { data } = await createSingleTask(
+        createTaskPayload.wbsNum,
+        createTaskPayload.title,
+        createTaskPayload.priority,
+        createTaskPayload.status,
+        createTaskPayload.assignees,
+        createTaskPayload.notes ?? '',
+        createTaskPayload.deadline,
+        createTaskPayload.startDate
+      );
+      return data;
+    },
+    {
+      onSuccess: () => {
+        queryClient.invalidateQueries(['projects']);
+      }
+    }
+  );
 };
 
 export interface TaskPayload {
   taskId: string;
   notes?: string;
   title: string;
+  startDate?: Date;
   deadline?: Date;
   priority: TaskPriority;
 }
@@ -53,7 +66,8 @@ export const useEditTask = () => {
         taskPayload.title,
         taskPayload.notes ?? '',
         taskPayload.priority,
-        taskPayload.deadline
+        taskPayload.deadline,
+        taskPayload.startDate
       );
 
       return data;