finish onboarding

Author: SaqAsh

backend/typescript/graphql/index.ts

@@ -1,4 +1,4 @@
-import { makeExecutableSchema, gql } from "apollo-server-express";
+import { gql, makeExecutableSchema } from "apollo-server-express";
 import { applyMiddleware } from "graphql-middleware";
 import { merge } from "lodash";
 
@@ -8,16 +8,18 @@ import {
   isAuthorizedByUserId,
 } from "../middlewares/auth";
 import authResolvers from "./resolvers/authResolvers";
-import authType from "./types/authType";
+import dashboardResolvers from "./resolvers/dashboardResolvers";
 import entityResolvers from "./resolvers/entityResolvers";
-import entityType from "./types/entityType";
 import simpleEntityResolvers from "./resolvers/simpleEntityResolvers";
-import simpleEntityType from "./types/simpleEntityType";
+import teamMemberResolvers from "./resolvers/teamMemberResolvers";
 import userResolvers from "./resolvers/userResolvers";
-import userType from "./types/userType";
+import authType from "./types/authType";
 import dashboardType from "./types/dashboardType";
-import dashboardResolvers from "./resolvers/dashboardResolvers";
+import entityType from "./types/entityType";
 import reviewType from "./types/reviewType";
+import simpleEntityType from "./types/simpleEntityType";
+import teamMemberType from "./types/teamMemberType";
+import userType from "./types/userType";
 
 const query = gql`
   type Query {
@@ -41,13 +43,15 @@ const executableSchema = makeExecutableSchema({
     simpleEntityType,
     userType,
     dashboardType,
+    teamMemberType,
   ],
   resolvers: merge(
     authResolvers,
     entityResolvers,
     simpleEntityResolvers,
     userResolvers,
     dashboardResolvers,
+    teamMemberResolvers,
   ),
 });
 

backend/typescript/graphql/resolvers/teamMemberResolvers.ts

@@ -0,0 +1,31 @@
+import TeamMemberService from "../../services/implementations/teamMemberService";
+import { CreateTeamMemberDTO, TeamMemberDTO } from "../../types";
+import { getErrorMessage } from "../../utilities/errorUtils";
+
+const teamMemberService = new TeamMemberService();
+
+const teamMemberResolvers = {
+  Query: {
+    teamMembers: async (): Promise<TeamMemberDTO[]> => {
+      try {
+        return await teamMemberService.getTeamMembers();
+      } catch (error) {
+        throw new Error(getErrorMessage(error));
+      }
+    },
+  },
+  Mutation: {
+    createTeamMember: async (
+      _: unknown,
+      { input }: { input: CreateTeamMemberDTO },
+    ): Promise<TeamMemberDTO> => {
+      try {
+        return await teamMemberService.createTeamMember(input);
+      } catch (error) {
+        throw new Error(getErrorMessage(error));
+      }
+    },
+  },
+};
+
+export default teamMemberResolvers;

backend/typescript/graphql/types/teamMemberType.ts

@@ -0,0 +1,33 @@
+import { gql } from "apollo-server-express";
+
+const teamMemberType = gql`
+  enum TeamRole {
+    PM
+    DESIGNER
+    PL
+    DEVELOPER
+  }
+
+  type TeamMemberDTO {
+    id: ID!
+    firstName: String!
+    lastName: String!
+    teamRole: TeamRole!
+  }
+
+  input CreateTeamMemberDTO {
+    firstName: String!
+    lastName: String!
+    teamRole: TeamRole!
+  }
+
+  extend type Query {
+    teamMembers: [TeamMemberDTO!]!
+  }
+
+  extend type Mutation {
+    createTeamMember(input: CreateTeamMemberDTO!): TeamMemberDTO!
+  }
+`;
+
+export default teamMemberType;

backend/typescript/migrations/20251004163844-create-team-member-table.ts

@@ -0,0 +1,44 @@
+import { DataTypes } from "sequelize";
+import { Migration } from "../umzug";
+
+const TABLE_NAME = "team_members";
+
+export const up: Migration = async ({ context: sequelize }) => {
+  await sequelize.getQueryInterface().createTable(TABLE_NAME, {
+    id: {
+      type: DataTypes.UUID,
+      defaultValue: DataTypes.UUIDV4,
+      allowNull: false,
+      primaryKey: true,
+    },
+    firstName: {
+      type: DataTypes.STRING,
+      allowNull: false,
+    },
+    lastName: {
+      type: DataTypes.STRING,
+      allowNull: false,
+    },
+    teamRole: {
+      type: DataTypes.ENUM("PM", "DESIGNER", "PL", "DEVELOPER"),
+      allowNull: false,
+    },
+    createdAt: {
+      type: DataTypes.DATE,
+      allowNull: false,
+      defaultValue: DataTypes.NOW,
+    },
+    updatedAt: {
+      type: DataTypes.DATE,
+      allowNull: false,
+      defaultValue: DataTypes.NOW,
+    },
+  });
+};
+
+export const down: Migration = async ({ context: sequelize }) => {
+  await sequelize.getQueryInterface().dropTable(TABLE_NAME);
+  await sequelize
+    .getQueryInterface()
+    .sequelize.query('DROP TYPE IF EXISTS "enum_team_members_teamRole";');
+};

backend/typescript/models/teamMember.model.ts

@@ -0,0 +1,25 @@
+/* eslint import/no-cycle: 0 */
+import { Column, DataType, Model, Table } from "sequelize-typescript";
+import { TeamRole, teamRoleValues } from "../types";
+
+@Table({ tableName: "team_members" })
+export default class TeamMember extends Model {
+  @Column({
+    type: DataType.UUID,
+    defaultValue: DataType.UUIDV4,
+    primaryKey: true,
+  })
+  id!: string;
+
+  @Column({ type: DataType.STRING, allowNull: false })
+  firstName!: string;
+
+  @Column({ type: DataType.STRING, allowNull: false })
+  lastName!: string;
+
+  @Column({
+    type: DataType.ENUM(...teamRoleValues),
+    allowNull: false,
+  })
+  teamRole!: TeamRole;
+}

backend/typescript/services/implementations/TeamMemberService.ts

@@ -0,0 +1,46 @@
+import TeamMember from "../../models/teamMember.model"; // <- Sequelize model
+import { CreateTeamMemberDTO, TeamMemberDTO } from "../../types";
+import { getErrorMessage } from "../../utilities/errorUtils";
+import logger from "../../utilities/logger";
+import ITeamMemberService from "../interfaces/teamMemberService";
+
+const Logger = logger(__filename);
+
+function toDTO(model: TeamMember): TeamMemberDTO {
+  return {
+    id: model.id,
+    firstName: model.firstName,
+    lastName: model.lastName,
+    teamRole: model.teamRole,
+  };
+}
+
+class TeamMemberService implements ITeamMemberService {
+  getTeamMembers = async (): Promise<TeamMemberDTO[]> => {
+    try {
+      const teamMembers = await TeamMember.findAll();
+      return teamMembers.map(toDTO);
+    } catch (error: unknown) {
+      Logger.error(
+        `Failed to get team members. Reason = ${getErrorMessage(error)}`,
+      );
+      throw error;
+    }
+  };
+
+  createTeamMember = async (
+    teamMember: CreateTeamMemberDTO,
+  ): Promise<TeamMemberDTO> => {
+    try {
+      const newTeamMember = await TeamMember.create(teamMember);
+      return toDTO(newTeamMember);
+    } catch (error: unknown) {
+      Logger.error(
+        `Failed to create team member. Reason = ${getErrorMessage(error)}`,
+      );
+      throw error;
+    }
+  };
+}
+
+export default TeamMemberService;

backend/typescript/services/interfaces/ITeamMemberService.ts

@@ -0,0 +1,20 @@
+import { CreateTeamMemberDTO, TeamMemberDTO } from "../../types";
+
+interface ITeamMemberService {
+  /**
+   * Get all team member information
+   * @returns array of TeamMemberDTO
+   * @throws Error if team member retrieval fails
+   */
+  getTeamMembers(): Promise<TeamMemberDTO[]>;
+
+  /**
+   * Create a team member
+   * @param teamMember the team member to be created
+   * @returns a TeamMemberDTO with the created team member's information
+   * @throws Error if team member creation fails
+   */
+  createTeamMember(teamMember: CreateTeamMemberDTO): Promise<TeamMemberDTO>;
+}
+
+export default ITeamMemberService;

backend/typescript/types.ts

@@ -1,5 +1,8 @@
 export type Role = "User" | "Admin";
 
+export const teamRoleValues = ["PM", "Designer", "PL", "Developer"] as const;
+export type TeamRole = (typeof teamRoleValues)[number];
+
 export enum StatusType {
   ACCEPTED = "accepted",
   APPLIED = "applied",
@@ -236,3 +239,12 @@ export type ReviewedApplicantRecordDTO = {
   review: Review;
   status: ReviewStatus;
 };
+
+export type TeamMemberDTO = {
+  id: string;
+  firstName: string;
+  lastName: string;
+  teamRole: TeamRole;
+};
+
+export type CreateTeamMemberDTO = Omit<TeamMemberDTO, "id">;