#2149-work-package-template-endpoint

src/backend/src/controllers/work-packages.controllers.ts

@@ -75,6 +75,37 @@ export default class WorkPackagesController {
     }
   }
 
+  // Create a work package template with the given details
+  static async createWorkPackageTemplate(req: Request, res: Response, next: NextFunction) {
+    try {
+      const { templateName, templateNotes, workPackageName, duration, expectedActivities, deliverables, blockedBy } =
+        req.body;
+
+      let { stage } = req.body;
+      if (stage === 'NONE') {
+        stage = null;
+      }
+
+      const user = await getCurrentUser(res);
+
+      const workPackageTemplate: WorkPackageTemplate = await WorkPackagesService.createWorkPackageTemplate(
+        user,
+        templateName,
+        templateNotes,
+        workPackageName,
+        stage,
+        duration,
+        expectedActivities,
+        deliverables,
+        blockedBy
+      );
+
+      res.status(200).json(workPackageTemplate);
+    } catch (error: unknown) {
+      next(error);
+    }
+  }
+
   // Edit a work package to the given specifications
   static async editWorkPackage(req: Request, res: Response, next: NextFunction) {
     try {

src/backend/src/prisma/migrations/20240517233042_init/migration.sql → src/backend/src/prisma/migrations/20240518160744_init/migration.sql

@@ -596,7 +596,7 @@ CREATE TABLE "Work_Package_Template" (
     "workPackageName" TEXT,
     "stage" "Work_Package_Stage",
     "duration" INTEGER,
-    "dateCreated" TIMESTAMP(3) NOT NULL,
+    "dateCreated" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
     "userCreatedId" INTEGER NOT NULL,
     "dateDeleted" TIMESTAMP(3),
     "userDeletedId" INTEGER,

src/backend/src/prisma/schema.prisma

@@ -788,7 +788,7 @@ model Work_Package_Template {
   blockedBy             Work_Package_Template[] @relation("blocking")
   blocking              Work_Package_Template[] @relation("blocking")
   descriptionBullets    Description_Bullet[]
-  dateCreated           DateTime
+  dateCreated           DateTime                @default(now())
   userCreated           User                    @relation(fields: [userCreatedId], references: [userId], name: "workPackageTemplateCreator")
   userCreatedId         Int
   dateDeleted           DateTime?

src/backend/src/prisma/seed.ts

@@ -41,6 +41,7 @@ import DesignReviewsService from '../services/design-reviews.services';
 import BillOfMaterialsService from '../services/boms.services';
 import UsersService from '../services/users.services';
 import { transformDate } from '../utils/datetime.utils';
+import WorkPackagesService from '../services/work-packages.services';
 
 const prisma = new PrismaClient();
 
@@ -1924,6 +1925,42 @@ const performSeed: () => Promise<void> = async () => {
       links: []
     }
   );
+
+  const workPackageTemplate1 = await WorkPackagesService.createWorkPackageTemplate(
+    batman,
+    'Batmobile Config 1',
+    'This is the first Batmobile configuration',
+    null,
+    null,
+    5,
+    [],
+    [],
+    organizationId
+  );
+
+  const schematicWpTemplate = await WorkPackagesService.createWorkPackageTemplate(
+    batman,
+    'Schematic',
+    'This is the schematic template',
+    null,
+    WorkPackageStage.Design,
+    4,
+    [],
+    [],
+    organizationId
+  );
+
+  const layoutWpTemplate = await WorkPackagesService.createWorkPackageTemplate(
+    batman,
+    'Layout ',
+    'This is the Layout  template',
+    null,
+    WorkPackageStage.Design,
+    4,
+    [],
+    [schematicWpTemplate.workPackageTemplateId],
+    organizationId
+  );
 };
 
 performSeed()

src/backend/src/routes/work-package-templates.routes.ts

@@ -28,4 +28,22 @@ workPackageTemplatesRouter.post(
   WorkPackagesController.editWorkPackageTemplate
 );
 
+workPackageTemplatesRouter.post(
+  '/create',
+  nonEmptyString(body('templateName')),
+  nonEmptyString(body('templateNotes')),
+  nonEmptyString(body('workPackageName').optional()),
+  isWorkPackageStageOrNone(body('stage').optional()),
+  intMinZero(body('duration').optional()),
+  body('expectedActivities').isArray(),
+  nonEmptyString(body('expectedActivities.*')),
+  body('deliverables').isArray(),
+  nonEmptyString(body('deliverables.*')),
+  body('blockedBy').isArray(),
+  nonEmptyString(body('blockedByInfo.*.name')),
+  isWorkPackageStageOrNone(body('blockedByInfo.*.stage').optional()),
+  validateInputs,
+  WorkPackagesController.createWorkPackageTemplate
+);
+
 export default workPackageTemplatesRouter;

src/backend/src/routes/work-packages.routes.ts

@@ -35,6 +35,7 @@ workPackagesRouter.post(
   validateInputs,
   WorkPackagesController.createWorkPackage
 );
+
 workPackagesRouter.post(
   '/edit',
   intMinZero(body('workPackageId')),

src/backend/src/services/work-packages.services.ts

@@ -32,9 +32,10 @@ import {
   descriptionBulletToChangeListValue,
   descriptionBulletsToChangeListValues,
   editDescriptionBullets,
-  markDescriptionBulletsAsDeleted
+  markDescriptionBulletsAsDeleted,
+  validateDescriptionBullets
 } from '../utils/description-bullets.utils';
-import { getBlockingWorkPackages, validateBlockedByTemplates, validateBlockedBys } from '../utils/work-packages.utils';
+import { getBlockingWorkPackages, validateBlockedBys, validateBlockedByTemplates } from '../utils/work-packages.utils';
 import { workPackageTemplateTransformer } from '../transformers/work-package-template.transformer';
 import { getWorkPackageTemplateQueryArgs } from '../prisma-query-args/work-package-template.query-args';
 import { getDescriptionBulletQueryArgs } from '../prisma-query-args/description-bullets.query-args';
@@ -605,6 +606,81 @@ export default class WorkPackagesService {
     return workPackageTemplates.map(workPackageTemplateTransformer);
   }
 
+  /**
+   * Creates a Work_Package_Template in the database
+   *
+   * @param user the user creating the work package template
+   * @param templateName the template name
+   * @param templateNotes the template notes
+   * @param workPackageName the name of the work packge
+   * @param stage the stage
+   * @param duration the duration of the work package template in weeks
+   * @param expectedActivities the expected activities descriptions for this WPT
+   * @param deliverables the expected deliverables descriptions for this WPT
+   * @param blockedBy the WBS elements that need to be completed before this WPT
+   * @param organizationId the id of the organization that the user is currently in
+   * @returns the WBS number of the successfully created work package template
+   * @throws if the work package template could not be created
+   */
+  static async createWorkPackageTemplate(
+    user: User,
+    templateName: string,
+    templateNotes: string,
+    workPackageName: string | null,
+    stage: WorkPackageStage | null,
+    duration: number,
+    descriptionBullets: DescriptionBulletPreview[],
+    blockedByIds: string[],
+    organizationId: string
+  ): Promise<WorkPackageTemplate> {
+    if (!(await userHasPermission(user.userId, organizationId, isAdmin)))
+      throw new AccessDeniedAdminOnlyException('create work package templates');
+
+    // get the corresponding IDs of all work package templates in BlockedBy,
+    // and throw an errror if the template doesn't exist
+    await Promise.all(
+      blockedByIds.map(async (workPackageTemplateId) => {
+        const template = await prisma.work_Package_Template.findFirst({
+          where: { workPackageTemplateId }
+        });
+
+        if (!template) {
+          throw new NotFoundException('Work Package Template', templateName);
+        }
+        return template.workPackageTemplateId;
+      })
+    );
+
+    await validateDescriptionBullets(descriptionBullets, organizationId);
+
+    // add to the db
+    const created = await prisma.work_Package_Template.create({
+      data: {
+        templateName,
+        templateNotes,
+        workPackageName,
+        stage,
+        duration,
+        userCreatedId: user.userId,
+        organizationId,
+        blockedBy: {
+          connect: blockedByIds.map((blockedById) => ({ workPackageTemplateId: blockedById }))
+        }
+      },
+
+      ...getWorkPackageTemplateQueryArgs(organizationId)
+    });
+
+    await addRawDescriptionBullets(
+      descriptionBullets,
+      DescriptionBulletDestination.TEMPLATE,
+      created.workPackageTemplateId,
+      created.organizationId
+    );
+
+    return workPackageTemplateTransformer(created);
+  }
+
   /**
    * Edits a work package template given the specified parameters
    * @param submitter user who is submitting the edit
@@ -613,7 +689,7 @@ export default class WorkPackagesService {
    * @param templateNotes notes about the work package template
    * @param duration duration value on the template
    * @param stage stage value on the template
-   * @param blockedByInfo array of templates blocking this
+   * @param blockedByIds array of templates blocking this
    * @param expectedActivities array of expected activity values on the template
    * @param deliverables array of deliverable values on the template
    * @param workPackageName name value on the template

src/frontend/src/utils/urls.ts

@@ -156,6 +156,7 @@ const workPackageTemplates = () => `${API_URL}/templates`;
 const workPackageTemplatesById = (workPackageTemplateId: string) => `${workPackageTemplates()}/${workPackageTemplateId}`;
 const workPackageTemplatesEdit = (workPackageTemplateId: string) =>
   `${workPackageTemplatesById(workPackageTemplateId)}/edit`;
+const workPackageTemplatesCreate = () => `${workPackageTemplates()}/create`;
 
 /**************** Other Endpoints ****************/
 const version = () => `https://api.github.com/repos/Northeastern-Electric-Racing/FinishLine/releases/latest`;
@@ -281,7 +282,9 @@ export const apiUrls = {
   designReviewDelete,
 
   workPackageTemplates,
+  workPackageTemplatesById,
   workPackageTemplatesEdit,
+  workPackageTemplatesCreate,
 
   version
 };