endpoint should work as expected now with search for both firstName and lastName supported.

docs/openapi.yml

@@ -2,7 +2,7 @@ openapi: 3.0.3
 info:
   title: Team Dev Server API
   description: |-
-  version: 1.0
+  version: '1.0'
 
 servers:
   - url: http://localhost:4000/
@@ -65,6 +65,37 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/Error'
+
+  /users/profile/{id}:
+    post:
+      tags:
+        - profile
+      summary: Create profile
+      description: Create new profile
+      operationId: createProfile
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: id
+          in: path
+          description: 'The name that needs to be fetched. Use user1 for testing. '
+          required: true
+          schema:
+            type: string
+      requestBody:
+        description: User registration details
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/CreateProfile'
+      responses:
+        '201':
+          description: Created
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/CreatedProfile'
+
   /login:
     post:
       tags:
@@ -88,6 +119,46 @@ paths:
 
         '400':
           description: Invalid username/password supplied
+
+  /users/search:
+    get:
+      tags:
+        - user
+      summary: Search users by first name and/or last name
+      description: 'Search for users by their first name, last name, or both. Either parameter is optional.'
+      operationId: searchUsers
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: firstName
+          in: query
+          description: 'Search users by their first name (optional).'
+          schema:
+            type: string
+        - name: lastName
+          in: query
+          description: 'Search users by their last name (optional).'
+          schema:
+            type: string
+      responses:
+        '200':
+          description: 'Users found successfully'
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AllUsers'
+        '400':
+          description: 'Bad request, invalid query parameters.'
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+        '404':
+          description: 'No users found matching the query.'
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
 
   /users/{id}:
     get:
@@ -183,13 +254,13 @@ paths:
                 content:
                   type: string
       responses:
-        201:
+        '201':
           description: success
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/Post'
-        400:
+        '400':
           description: fail
           content:
             application/json:
@@ -244,7 +315,7 @@ paths:
                       content:
                         type: string
       responses:
-        201:
+        '201':
           description: success
           content:
             application/json:
@@ -266,7 +337,7 @@ paths:
       security:
         - bearerAuth: []
       responses:
-        201:
+        '201':
           description: success
           content:
             application/json:
@@ -279,7 +350,70 @@ paths:
                     properties:
                       cohort:
                         $ref: '#/components/schemas/Cohort'
-        400:
+        '400':
+          description: fail
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+    get:
+      tags:
+        - cohort
+      summary: Get all cohorts
+      description: This can only be done by a logged in user.
+      operationId: getAllCohorts
+      security:
+        - bearerAuth: []
+      responses:
+        '200':
+          description: successful operation
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AllUsers'
+        '500':
+          description: fail
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+  /cohorts/{id}:
+    get:
+      tags:
+        - cohort
+      summary: Get cohort by id
+      description: This can only be done by a logged in user.
+      operationId: getCohortById
+      security:
+        - bearerAuth: []
+      parameters:
+        - name: id
+          in: path
+          description: 'Id of the cohort to fetch'
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: success
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  status:
+                    type: string
+                  data:
+                    properties:
+                      cohort:
+                        $ref: '#/components/schemas/Cohort'
+        '404':
+          description: fail
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Error'
+        '500':
           description: fail
           content:
             application/json:
@@ -307,6 +441,19 @@ components:
                 content:
                   type: string
 
+    AllCohorts:
+      type: object
+      properties:
+        status:
+          type: string
+        data:
+          type: object
+          properties:
+            cohorts:
+              type: array
+              items:
+                $ref: '#/components/schemas/Cohort'
+
     Cohort:
       type: object
       properties:
@@ -368,6 +515,30 @@ components:
         password:
           type: string
 
+    CreateProfile:
+      type: object
+      properties:
+        firstName:
+          type: string
+        lastName:
+          type: string
+        bio:
+          type: string
+        githubUrl:
+          type: string
+        username:
+          type: string
+        mobile:
+          type: string
+        startDate:
+          type: string
+        endDate:
+          type: string
+        specialism:
+          type: string
+        jobTitle:
+          type: string
+
     UpdateUser:
       type: object
       properties:
@@ -457,6 +628,40 @@ components:
                   type: string
                 githubUrl:
                   type: string
+
+    CreatedProfile:
+      type: object
+      properties:
+        status:
+          type: string
+          example: success
+        data:
+          properties:
+            user:
+              properties:
+                id:
+                  type: integer
+                firstName:
+                  type: string
+                lastName:
+                  type: string
+                bio:
+                  type: string
+                githubUrl:
+                  type: string
+                username:
+                  type: string
+                mobile:
+                  type: string
+                startDate:
+                  type: string
+                endDate:
+                  type: string
+                specialism:
+                  type: string
+                jobTitle:
+                  type: string
+
     login:
       type: object
       properties:

prisma/migrations/20250226143811_update_user_profile/migration.sql

@@ -0,0 +1,7 @@
+-- AlterTable
+ALTER TABLE "Profile" ADD COLUMN     "endDate" TEXT,
+ADD COLUMN     "jobTitle" TEXT,
+ADD COLUMN     "mobile" TEXT,
+ADD COLUMN     "specialism" TEXT,
+ADD COLUMN     "startDate" TEXT,
+ADD COLUMN     "username" TEXT;

prisma/migrations/20250227124254_update_cohort_added_specialism/migration.sql

@@ -0,0 +1,31 @@
+/*
+  Warnings:
+
+  - You are about to drop the column `endDate` on the `Profile` table. All the data in the column will be lost.
+  - You are about to drop the column `jobTitle` on the `Profile` table. All the data in the column will be lost.
+  - You are about to drop the column `specialism` on the `Profile` table. All the data in the column will be lost.
+  - You are about to drop the column `startDate` on the `Profile` table. All the data in the column will be lost.
+
+*/
+-- AlterTable
+ALTER TABLE "Cohort" ADD COLUMN     "endDate" TEXT,
+ADD COLUMN     "jobTitle" TEXT,
+ADD COLUMN     "specialismId" INTEGER,
+ADD COLUMN     "startDate" TEXT;
+
+-- AlterTable
+ALTER TABLE "Profile" DROP COLUMN "endDate",
+DROP COLUMN "jobTitle",
+DROP COLUMN "specialism",
+DROP COLUMN "startDate";
+
+-- CreateTable
+CREATE TABLE "Specialism" (
+    "id" SERIAL NOT NULL,
+    "specialismName" TEXT NOT NULL,
+
+    CONSTRAINT "Specialism_pkey" PRIMARY KEY ("id")
+);
+
+-- AddForeignKey
+ALTER TABLE "Cohort" ADD CONSTRAINT "Cohort_specialismId_fkey" FOREIGN KEY ("specialismId") REFERENCES "Specialism"("id") ON DELETE SET NULL ON UPDATE CASCADE;

prisma/schema.prisma

@@ -36,12 +36,25 @@ model Profile {
   lastName    String
   bio         String?
   githubUrl   String?
+  username    String?
+  mobile      String?
 }
 
 model Cohort {
   id            Int           @id @default(autoincrement())
+  specialismId  Int?
+  specialism    Specialism?   @relation(fields: [specialismId], references: [id])
   users         User[]
   deliveryLogs  DeliveryLog[]
+  startDate     String?
+  endDate       String?
+  jobTitle      String?
+}
+
+model Specialism {
+  id              Int           @id @default(autoincrement())
+  specialismName  String
+  cohorts         Cohort[]
 }
 
 model Post {
@@ -66,4 +79,4 @@ model DeliveryLogLine {
   content   String
   logId     Int
   log       DeliveryLog   @relation(fields: [logId], references: [id])
-}
+}