feat(tools/risk-form-filler): automate filling out carleton's risk assessment form

apps/docs/content/docs/contribution-guidelines/coding-standards/tooling.mdx

@@ -7,9 +7,13 @@ icon: Braces
 A number of tools developed internally are used to eliminate manual, repetitive work for other teams.
 
 ## Community Engagement
-### Carleton University Room Booking
+### [Event Risk Management Form](https://stuapps.carleton.ca/sarms/event-risk) Filler
 
-[PR #197](https://github.com/cuhacking/2025/pull/179) in-progress by Jeremy Friesen.
+Originally authored by [Jeremy Friesen](https://github.com/JeremyFriesenGitHub).
+
+```
+ pnpm nx run risk-form-filler:e2e --ui
+```
 
 <video className="w-max h-[240px]" controls>
   <source src="https://github.com/user-attachments/assets/8d01f3fc-d593-4830-98ae-c50cdb65c612" type="video/mp4" />

commitlint.config.ts

@@ -42,6 +42,7 @@ const Configuration: UserConfig = {
       'web-e2e',
       'portal',
       'portal-e2e',
+      'tools',
     ]],
     // 'scope-empty': [2, 'never'], // Scope should always be provided
 

tools/risk-form-filler/README.md

@@ -0,0 +1,15 @@
+# Workflow Execution Guide
+
+To run the script, use either one of these commands in the CLI to run a specific workflow:
+
+1. `pnpm nx run risk-form-filler:online` --> for submitting online events
+2. `pnpm nx run risk-form-filler:in-person` --> for submitting in-person events
+3. `pnpm nx run risk-form-filler:hybrid` --> for submitting hybrid events
+
+This will compile and automatically run a workflow for that specifc type of form.
+
+Be sure to change the input for that according workflow (for instance, change your hybrid input answers in src/input/hybrid-input.ts to something that is to your liking)
+
+Note that although these forms automate answers, please make a review to ensure that all the information on the form is filled completely and accurate before submission.
+
+Don't forget to end your session by pressing `CTRL C`.

tools/risk-form-filler/eslint.config.js

@@ -0,0 +1,19 @@
+import playwright from 'eslint-plugin-playwright'
+import baseConfigPromise from '../../eslint.config.js'
+
+export default (async () => {
+  const baseConfig = await baseConfigPromise
+
+  return [
+    playwright.configs['flat/recommended'],
+    ...baseConfig,
+    {
+      files: ['**/*.ts', '**/*.js'],
+      // Override or add rules here
+      rules: {
+        'playwright/no-conditional-in-test': 'off',
+        'playwright/expect-expect': 'off',
+      },
+    },
+  ]
+})()

tools/risk-form-filler/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "risk-form-filler",
+  "type": "module",
+  "description": "",
+  "license": "",
+  "sideEffects": false,
+  "scripts": {}
+}

tools/risk-form-filler/playwright.config.ts

@@ -0,0 +1,45 @@
+// TODO: Investigate node global process usage
+
+import { fileURLToPath } from 'node:url'
+import { nxE2EPreset } from '@nx/playwright/preset'
+
+import { defineConfig, devices } from '@playwright/test'
+
+const __filename = fileURLToPath(import.meta.url)
+
+// // For CI, you may want to set BASE_URL to the deployed application.
+// const baseURL = process.env.BASE_URL || 'http://127.0.0.1:3000'
+
+/**
+ * Read environment variables from file.
+ * https://github.com/motdotla/dotenv
+ */
+// require('dotenv').config();
+
+/**
+ * See https://playwright.dev/docs/test-configuration.
+ */
+export default defineConfig({
+  ...nxE2EPreset(__filename, { testDir: './src' }),
+  /* Shared settings for all the projects below. See https://playwright.dev/docs/api/class-testoptions. */
+  retries: 2,
+  use: {
+    // baseURL,
+    /* Collect trace when retrying the failed test. See https://playwright.dev/docs/trace-viewer */
+    trace: 'on-first-retry',
+  },
+  /* Run your local dev server before starting the tests */
+  //   webServer: {
+  //     command: 'pnpm nx start risk-form-filler',
+  //     // url: 'http://127.0.0.1:3000',
+  //     // reuseExistingServer: !process.env.CI,
+  //     cwd: workspaceRoot,
+  //     timeout: 120 * 1000,
+  //   },
+  projects: [
+    {
+      name: 'chromium (desktop)',
+      use: { ...devices['Desktop Chrome'] },
+    },
+  ],
+})

tools/risk-form-filler/project.json

@@ -0,0 +1,28 @@
+{
+  "name": "risk-form-filler",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "tools/risk-form-filler",
+  "projectType": "application",
+  "tags": [],
+  "// targets": "to see all targets run: nx show project risk-form-filler --web",
+  "targets": {
+    "online": {
+      "command": "npx tsx src/input/online-input.ts",
+      "options": {
+        "cwd": "tools/risk-form-filler"
+      }
+    },
+    "in-person": {
+      "command": "npx tsx src/input/in-person-input.ts",
+      "options": {
+        "cwd": "tools/risk-form-filler"
+      }
+    },
+    "hybrid": {
+      "command": "npx tsx src/input/hybrid-input.ts",
+      "options": {
+        "cwd": "tools/risk-form-filler"
+      }
+    }
+  }
+}

tools/risk-form-filler/src/data/config.data.ts

@@ -0,0 +1,123 @@
+export class Config {
+  static LINK = {
+    BASE: 'https://stuapps.carleton.ca/sarms/event-risk',
+    IN_PERSON: 'in-person',
+    HYBRID: 'hybrid',
+    ONLINE: 'online',
+  }
+
+  static testData = {
+    primaryOrganizer: {
+      firstName: 'Raef',
+      lastName: 'Sarofiem',
+      carletonId: '101152872',
+      position: 'Community Engagement Lead',
+      role: 'Student',
+      email: '[email protected]',
+      emailConfirm: '[email protected]',
+      phone: '123-456-7890',
+    },
+    secondaryOrganizer: {
+      firstName: 'Ajaan',
+      lastName: 'Nalliah',
+      carletonId: '101151873',
+      position: 'Community Engagement',
+      role: 'Student',
+      email: '[email protected]',
+      phone: '123-456-7891',
+    },
+    generalEvent: {
+      eventTitle: 'cuHacking Weekly General Meeting',
+      eventDate: '2024-12-15',
+      eventStartTime: '18:00',
+      eventEndTime: '23:00',
+      eventDescription: 'cuHacking Weekly General Meeting',
+      eventLocation: 'NN 374',
+      eventLocationReserved: 'Yes',
+      eventParticipantsNumber: '20',
+      eventAudience: ['Carleton University Students', 'Staff and Faculty'],
+      eventFood: 'Yes',
+      eventFoodDetail: 'None',
+      eventHealthInsurance: 'No',
+      eventPhotoID: 'No',
+      eventMinors: 'No',
+      eventVIP: 'No',
+    },
+    riskManagement: {
+      alcohol: 'Yes',
+      smartServe: 'Yes',
+      entranceTicket: 'No',
+      food: 'Yes',
+      volunteers: {
+        volunteer1: 'Alice',
+        volunteer2: 'Bob',
+        volunteer3: 'Charlie',
+      },
+      campusSafety: 'Yes',
+      privateSecurity: 'No',
+      speaker: 'Yes',
+      topics: 'cuHacking',
+      names: 'Raef Sarofiem',
+      website: 'https://cuhacking.ca/',
+    },
+    emergencyPreparedness: {
+      firstAid: 'Yes',
+      hospitalAwareness: 'Yes',
+      evacuationPlan: 'Yes',
+      openFlames: 'No',
+    },
+    safetyRiskAssessment: {
+      crowdControl: 'Yes',
+      crowdControlDetails: 'Monitors will control entrance/exit points.',
+      specialCircumstances: 'No',
+      additionalRisks: 'No',
+    },
+    contractsInsurance: {
+      vendorContracts: 'No',
+      liabilityInsurance: 'Yes',
+      insuranceInRental: 'Not Applicable',
+      insuranceCertificate: 'Yes',
+    },
+    travel: {
+      transportationRequired: 'Yes',
+      groupTransportation: 'No',
+      rentingVehicles: 'Yes',
+      insurance: 'Yes',
+      rentalDetails: {
+        companyName: 'Rent-A-Van Inc.',
+        companyAddress: '123 Main St, Ottawa, ON',
+        companyPhone: '123-456-7892',
+        additionalInfo: 'Insurance is fully covered in the rental fee.',
+      },
+      personalVehicles: 'No',
+      timesCommunicated: 'Yes',
+      contingencyPlan: 'Yes',
+      contingencyDetails: 'Plan includes backup transportation via taxis.',
+      alcoholOnboard: 'No',
+      intoxicatedIndividuals: 'No',
+    },
+    outOfProvinceEvents: {
+      outOfProvince: 'Yes',
+      healthCoverage: 'Yes',
+      documentsAdvised: 'Yes',
+    },
+    maintenanceServices: {
+      garbageProvision: 'Yes',
+      cleanupCrew: 'Yes',
+      cleanupDetails: 'Volunteer group will clean up after the event.',
+      overnightSetup: 'No',
+    },
+    humanRights: {
+      rightsImplications: 'Yes',
+      rightsRisks: 'No',
+      otherRisks: 'None identified.',
+    },
+    onlineInformation: {
+      onlinePlatform: 'Zoom',
+      onlineTopic: 'cuHacking Weekly General Meeting',
+      onlineLocation: 'NN 374',
+      onlinePeople: '10',
+      onlineOriginAttendance: '5',
+    },
+  }
+}