API-Draft.yaml

openapi: 3.0.3
info:
  title: JobLinc - OpenAPI 3.0
  description: This is an API Documentation for CMPS302 Project - JobLinc

  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  version: '1.0'

servers:
  - url: https://joblinc.me/api/v1

tags:
  - name: Auth
    description: Authentication - Login, Register, refresh-token and others

  - name: User
    description: Everything about currently logged in user

  - name: Company
    description: Everything about company pages

  - name: Job
    description: Everything about jobs

  - name: Company/Job
    description: Everything about jobs of a specific company

  - name: Company/Job/JobApplication
    description: Everything about company job applicaions and hiring

  - name: Post
    description: Everything about posts, feed and interactions

  - name: Follow
    description: Follow and unfollow users

  - name: Connection
    description: Connection between users (Request, Accept, Reject, Block, Unblock)

paths:
  /auth/login:
    post:
      tags:
        - Auth
      summary: Login
      description: Username and Password Login
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LoginRequest'
      responses:
        '200':
          description: Successfully logged in
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LoginResponse'
        '401':
          description: Incorrect credintials
        '500':
          description: Internal server error

  /auth/register:
    post:
      tags:
        - Auth
      summary: Create account
      description: Create a new user account
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegisterRequest'
      responses:
        '200':
          description: Successfully logged in
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LoginResponse'
        '400':
          description: Bad request
        '409':
          description: Username already exist
        '500':
          description: Internal server error

  /auth/logout:
    post:
      tags:
        - Auth
      summary: Logout currect user
      description: Revoke current session
      responses:
        '200':
          description: Successfully logged out

  /user/edit/personal-info:
    post:
      tags:
        - User
      summary: Edit personal information
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                firstName:
                  type: string
                lastName:
                  type: string
                email:
                  type: string
                address:
                  type: string
      responses:
        '200':
          description: Personal information updated successfully
        '400':
          description: Bad request

  /user/edit/password:
    post:
      tags:
        - User
      summary: Edit password
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                oldPassword:
                  type: string
                newPassword:
                  type: string
      responses:
        '200':
          description: Password updated successfully
        '400':
          description: Bad request

  /user/edit/profile-picture:
    post:
      tags:
        - User
      summary: Edit profile picture
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                profilePicture:
                  type: string
                  format: binary
      responses:
        '200':
          description: Profile picture updated successfully
        '400':
          description: Bad request

  # get:
  /companies:
    get:
      tags:
        - Company
      summary: Get All Companies
      description: Get all available companies
      responses:
        '200':
          description: Successfully got all companies
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAllCompaniesResponse'
        '400':
          description: Bad request
        '500':
          description: Internal server error

    post:
      tags:
        - Company
      summary: Create Company
      description: Create a new company page
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateCompanyRequest'
      responses:
        '201':
          description: Successfully created a new company page
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Company'
        '400':
          description: Bad request
        '403':
          description: Unauthorized
        '500':
          description: Internal server error

  /companies/{id}:
    get:
      tags:
        - Company
      summary: Get A Company
      description: Get a company with id
      parameters:
        - in: path
          name: id
          schema:
            type: string
          required: true
          description: ID of the company to get
      responses:
        '200':
          description: Successfully got a company
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Company'
        '404':
          description: Company not found
        '500':
          description: Internal server error
    patch:
      tags:
        - Company
      summary: Update A Company
      description: Update a company with id
      parameters:
        - in: path
          name: id
          schema:
            type: string
          required: true
          description: ID of the company to update
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateCompanyRequest'
      responses:
        '200':
          description: Successfully updated a company
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Company'
        '400':
          description: Bad request
        '403':
          description: Unauthorized
        '404':
          description: Company not found
        '500':
          description: Internal server error

    delete:
      tags:
        - Company
      summary: Delete A Company
      description: Delete a company with id
      parameters:
        - in: path
          name: id
          schema:
            type: string
          required: true
          description: ID of the company to delete

      responses:
        '204':
          description: Successfully deleted a company
          content:
            application/json:
              schema:
                type: object
        '403':
          description: Unauthorized
        '404':
          description: Company not found
        '500':
          description: Internal server error

  /jobs:
    get:
      tags:
        - Job
      summary: Get All jobs
      description: Get all available jobs
      responses:
        '200':
          description: Successfully got all jobs
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAllJobsResponse'
        '400':
          description: Bad request
        '500':
          description: Internal server error

  /jobs/{id}:
    get:
      tags:
        - Job
      summary: Get A Job
      description: Get a job with id
      parameters:
        - in: path
          name: id
          schema:
            type: string
          required: true
          description: ID of the job to get
      responses:
        '200':
          description: Successfully got a job
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Job'
        '404':
          description: Job not found
        '500':
          description: Internal server error

  /jobs/{id}/apply:
    post:
      tags:
        - Job
      summary: Apply For A Job
      description: Create a job application for a job with id
      parameters:
        - in: path
          name: id
          schema:
            type: string
          required: true
          description: ID of the job to apply for
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateJobApplicationRequest'
      responses:
        '201':
          description: Successfully created a job application for job with id
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobApplication'
        '400':
          description: Bad request
        '403':
          description: Unauthorized
        '404':
          description: Job not found
        '500':
          description: Internal server error

  /companies/{companyId}/jobs:
    get:
      tags:
        - Company/Job
      summary: Get All Company Jobs
      description: Get all jobs specific to a company with id
      parameters:
        - in: path
          name: companyId
          schema:
            type: string
          required: true
          description: ID of the company to get
      responses:
        '200':
          description: Successfully got all company jobs
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAllJobsResponse'
        '404':
          description: Company not found
        '500':
          description: Internal server error
    post:
      tags:
        - Company/Job
      summary: Create A Job At A Company
      description: Create a job at a company with id
      parameters:
        - in: path
          name: companyId
          schema:
            type: string
          required: true
          description: ID of the company to add job to
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateJobRequest'
      responses:
        '201':
          description: Successfully created a job at company with id
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Job'
        '400':
          description: Bad request
        '403':
          description: Unauthorized
        '404':
          description: Company not found
        '500':
          description: Internal server error

  /companies/{companyId}/jobs/{id}:
    get:
      tags:
        - Company/Job
      summary: Get A Job At Company
      description: Get a job with id at company with companyId
      parameters:
        - in: path
          name: companyId
          schema:
            type: string
          required: true
          description: ID of the company to get job from
        - in: path
          name: id
          schema:
            type: string
          required: true
          description: ID of the job to get
      responses:
        '200':
          description: Successfully got a job
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Job'
        '404':
          description: Job not found
        '500':
          description: Internal server error

    patch:
      tags:
        - Company/Job
      summary: Update A Job At A Company
      description: Update a job with id at company with companyId
      parameters:
        - in: path
          name: companyId
          schema:
            type: string
          required: true
          description: ID of the company to update job at
        - in: path
          name: id
          schema:
            type: string
          required: true
          description: ID of the job to update
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateJobRequest'
      responses:
        '200':
          description: Successfully updated a job
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Job'
        '400':
          description: Bad request
        '403':
          description: Unauthorized
        '404':
          description: Company not found
        '500':
          description: Internal server error

    delete:
      tags:
        - Company/Job
      summary: Delete A Job At Company
      description: Delete a job at a company with id
      parameters:
        - in: path
          name: companyId
          schema:
            type: string
          required: true
          description: ID of the company to delete job from
        - in: path
          name: id
          schema:
            type: string
          required: true
          description: ID of the job to delete

      responses:
        '204':
          description: Successfully deleted a job from a company
          content:
            application/json:
              schema:
                type: object
        '403':
          description: Unauthorized
        '404':
          description: Company not found
        '500':
          description: Internal server error

  /companies/{companyId}/jobs/{id}/apply:
    post:
      tags:
        - Company/Job
      summary: Apply For A Job At Company
      description: Create a job application for a job with id at company with companyId
      parameters:
        - in: path
          name: companyId
          schema:
            type: string
          required: true
          description: ID of the company to apply to
        - in: path
          name: id
          schema:
            type: string
          required: true
          description: ID of the job to apply for
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateJobApplicationRequest'
      responses:
        '201':
          description: Successfully created a job application for job with id at cpmpany with companyId
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobApplication'
        '400':
          description: Bad request
        '403':
          description: Unauthorized
        '404':
          description: Job not found
        '500':
          description: Internal server error

  /companies/{companyId}/jobs/{jobId}/job-applications:
    get:
      tags:
        - Company/Job/JobApplication
      summary: Get All Job Applications Of A Company Job
      description: Get all  job applications specific to a job of jobId in company with id
      parameters:
        - in: path
          name: companyId
          schema:
            type: string
          required: true
          description: ID of the company
        - in: path
          name: jobId
          schema:
            type: string
          required: true
          description: ID of the job
      responses:
        '200':
          description: Successfully got all job applications
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAllJobApplicationsResponse'
        '404':
          description: Job application not found
        '500':
          description: Internal server error

  /companies/{companyId}/jobs/{jobId}/job-applications/{id}:
    get:
      tags:
        - Company/Job/JobApplication
      summary: Get A Job Application
      description: Get a job application of specific job at specific company
      parameters:
        - in: path
          name: companyId
          schema:
            type: string
          required: true
          description: ID of the company
        - in: path
          name: jobId
          schema:
            type: string
          required: true
          description: ID of the job
        - in: path
          name: id
          schema:
            type: string
          required: true
          description: ID of the job application
      responses:
        '200':
          description: Successfully got a job application
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobApplication'
        '400':
          description: Bad request
        '403':
          description: Unauthorized
        '404':
          description: Company not found
        '500':
          description: Internal server error
    patch:
      tags:
        - Company/Job/JobApplication
      summary: Update Status Of A Job Application
      description: Update status of a job application of specific job at specific company
      parameters:
        - in: path
          name: companyId
          schema:
            type: string
          required: true
          description: ID of the company
        - in: path
          name: jobId
          schema:
            type: string
          required: true
          description: ID of the job
        - in: path
          name: id
          schema:
            type: string
          required: true
          description: ID of the job application
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateJobApplicationRequest'
      responses:
        '200':
          description: Successfully updated status of a job application
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobApplication'
        '400':
          description: Bad request
        '403':
          description: Unauthorized
        '404':
          description: Company not found
        '500':
          description: Internal server error

  /post/{postId}:
    get:
      tags:
        - Post
      parameters:
        - in: path
          name: postId
          schema:
            type: string
          required: true
          description: ID of the post to get
      responses:
        '200':
          description: Successfully loaded post
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostResponse'
        '403':
          description: Insufficient permissions
        '404':
          description: Post not found

  /post/feed:
    get:
      tags:
        - Post
      parameters:
        - in: query
          name: limit
          schema:
            type: integer
          required: true
          description: The  number of posts to return.
      responses:
        '200':
          description: Successfully loaded feed
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PostResponse'
        '403':
          description: Insufficient permissions
        '404':
          description: No posts found

  /post/add:
    post:
      tags:
        - Post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddPostRequest'
      responses:
        '200':
          description: Post saved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddPostResponse'
        '400':
          description: Bad request
        '403':
          description: Insufficient permissions
        '404':
          description: Post not found

  /post/{postId}/edit:
    post:
      tags:
        - Post
      parameters:
        - in: path
          name: postId
          schema:
            type: string
          required: true
          description: ID of the post to edit
      responses:
        '200':
          description: Post saved successfully
        '400':
          description: Bad request
        '403':
          description: Insufficient permissions
        '404':
          description: Post not found

  /post/{postId}/delete:
    delete:
      tags:
        - Post
      parameters:
        - in: path
          name: postId
          schema:
            type: string
          required: true
          description: ID of the post to delete
      responses:
        '200':
          description: Post deleted successfully
        '403':
          description: Insufficient permissions
        '404':
          description: Post not found

  /post/{postId}/react:
    post:
      tags:
        - Post
      parameters:
        - in: path
          name: postId
          schema:
            type: string
          required: true
          description: ID of the post to react at
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/reactOnPostRequest'
      responses:
        '200':
          description: react added successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddReactResponse' #returns the react id
        '403':
          description: Insufficient permissions
        '404':
          description: Post not found

  /post/{postId}/comment:
    post:
      tags:
        - Post
      parameters:
        - in: path
          name: postId
          schema:
            type: string
          required: true
          description: ID of the post to comment
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddCommentRequest'
      responses:
        '200':
          description: Comment saved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddCommentResponse' #returns the comment id
        '400':
          description: Bad request
        '403':
          description: Insufficient permissions
        '404':
          description: Post not found

  # Follownig
  /follow/{userId}:
    post:
      tags:
        - Follow
      parameters:
        - in: path
          name: userId
          schema:
            type: string
          required: true
          description: ID of user that will be followed
      responses:
        '200':
          description: User followed Successfully
        '400':
          description: Bad request
        '403':
          description: Insufficient permissions
        '404':
          description: followed user not found

  /follow/{userId}/unfollow:
    post:
      tags:
        - Follow
      parameters:
        - in: path
          name: userId
          schema:
            type: string
          required: true
          description: ID of user that will be unfollowed
      responses:
        '200':
          description: User unfollowed Successfully
        '400':
          description: Bad request
        '403':
          description: Insufficient permissions
        '404':
          description: unfollowed user not found

  /follow/{userId}/followers:
    get:
      tags:
        - Follow
      parameters:
        - in: path
          name: userId
          schema:
            type: string
          required: true
          description: ID of user to get followers of
      responses:
        '200':
          description: followers found successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetFollowersResponse'
        '400':
          description: Bad request
        '403':
          description: Insufficient permissions
        '404':
          description: unfollowed user not found

  /follow/{userId}/following:
    get:
      tags:
        - Follow
      parameters:
        - in: path
          name: userId
          schema:
            type: string
          required: true
          description: ID of user to get following of
      responses:
        '200':
          description: following found successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetFollowingResponse'
        '400':
          description: Bad request
        '403':
          description: Insufficient permissions
        '404':
          description: user not found

  /follow/{userId}/remove:
    post:
      tags:
        - Follow
      parameters:
        - in: path
          name: userId
          schema:
            type: string
          required: true
          description: ID of user that will removed from followers
      responses:
        '200':
          description: User removed Successfully
        '400':
          description: Bad request
        '403':
          description: Insufficient permissions
        '404':
          description: user to remove not found

  /connection/{userId}:
    get:
      tags:
        - Connection
      parameters:
        - in: path
          name: userId
          schema:
            type: string
          required: true
          description: ID of user to get connection status
      responses:
        '200':
          description: Connection status found successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetConnectionStatusResponse' # returns the connection details
        '400':
          description: Bad request
        '403':
          description: Insufficient permissions
        '404':
          description: user not found

  /connection/{userId}/connections:
    get:
      tags:
        - Connection
      parameters:
        - in: path
          name: userId
          schema:
            type: string
          required: true
          description: ID of user to get connections
      responses:
        '200':
          description: Connections found successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetConnectionsResponse' # returns the connections
        '400':
          description: Bad request
        '403':
          description: Insufficient permissions
        '404':
          description: user not found

  /connection/{userId}/send:
    post:
      tags:
        - Connection
      parameters:
        - in: path
          name: userId
          schema:
            type: string
          required: true
          description: ID of user that will be sent connection request
      responses:
        '200':
          description: Connection request sent Successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sendConnectionResponse' # returns the connection id
        '400':
          description: Bad request
        '403':
          description: Insufficient permissions
        '404':
          description: user to send request not found

  /connection/{userId}/accept:
    post:
      tags:
        - Connection
      parameters:
        - in: path
          name: userId
          schema:
            type: string
          required: true
          description: ID of user that will be accepted connection request
      responses:
        '200':
          description: Connection request accepted Successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/acceptConnectionResponse' # returns the connection id
        '400':
          description: Bad request
        '403':
          description: Insufficient permissions
        '404':
          description: user to accept request not found

  /connection/{userId}/reject:
    post:
      tags:
        - Connection
      parameters:
        - in: path
          name: userId
          schema:
            type: string
          required: true
          description: ID of user that will be rejected connection request
      responses:
        '200':
          description: Connection request rejected Successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rejectConnectionResponse' # returns the connection id
        '400':
          description: Bad request
        '403':
          description: Insufficient permissions
        '404':
          description: user to reject request not found

  /connection/{userId}/cancel:
    post:
      tags:
        - Connection
      parameters:
        - in: path
          name: userId
          schema:
            type: string
          required: true
          description: ID of user that will be canceled connection
      responses:
        '200':
          description: Connection request canceled Successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/cancelConnectionResponse' # returns the connection id
        '400':
          description: Bad request
        '403':
          description: Insufficient permissions
        '404':
          description: user to cancel connection with not found

  /connection/{userId}/block:
    post:
      tags:
        - Connection
      parameters:
        - in: path
          name: userId
          schema:
            type: string
          required: true
          description: ID of user that will be blocked
      responses:
        '200':
          description: User blocked Successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/blockConnectionResponse' # returns the connection id
        '400':
          description: Bad request
        '403':
          description: Insufficient permissions
        '404':
          description: user to block not found

  /connection/{userId}/unblock:
    post:
      tags:
        - Connection
      parameters:
        - in: path
          name: userId
          schema:
            type: string
          required: true
          description: ID of user that will be unblocked
      responses:
        '200':
          description: User unblocked Successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/unblockConnectionResponse' # returns the connection id
        '400':
          description: Bad request
        '403':
          description: Insufficient permissions
        '404':
          description: user to unblock not found

components:
  schemas:
    LoginRequest:
      type: object
      required:
        - username
        - password
      properties:
        username:
          type: string
          example: john-smith
        password:
          type: string
          example: pass@123

    RegisterRequest:
      type: object
      required:
        - firstname
        - lastname
        - username
        - email
        - password
      properties:
        firstname:
          type: string
          example: john
        lastname:
          type: string
          example: smith
        email:
          type: string
          example: john@mail.com
        username:
          type: string
          example: john-smith
        password:
          type: string
          example: pass@123

    LoginResponse:
      type: object
      properties:
        accessToken:
          type: string
        refreshToken:
          type: string

    GetAllCompaniesResponse:
      type: array
      items:
        $ref: '#/components/schemas/Company'

    CreateCompanyRequest:
      type: object
      properties:
        name:
          type: string
          example: Good company
        email:
          type: string
          example: Good@company.com
        phone:
          example: '02345648946'
        logo:
          type: string
          example: http://company/logo.jpg
        coverPhoto:
          type: string
          example: http://company/coverPhoto.jpg
        industry:
          type: string
          example: Food
        overview:
          type: string
          example: Good Company is known for its delicious dishes that incorporate a fusion of flavors.
        locations:
          type: array
          items:
            $ref: '#/components/schemas/Location'
        founded:
          type: string
          format: timestamp
          example: 2025-02-10T19:30:13.363+00:00

    UpdateCompanyRequest:
      type: object
      properties:
        name:
          type: string
          example: Good company
        email:
          type: string
          example: Good@company.com
        phone:
          example: '02345648946'
        logo:
          type: string
          example: http://company/logo.jpg
        coverPhoto:
          type: string
          example: http://company/coverPhoto.jpg
        industry:
          type: string
          example: Food
        overview:
          type: string
          example: Good Company is known for its delicious dishes that incorporate a fusion of flavors.
        locations:
          type: array
          items:
            $ref: '#/components/schemas/Location'
        founded:
          type: string
          format: timestamp
          example: 2025-02-10T19:30:13.363+00:00
        followers:
          type: integer
          example: 100000
        employees:
          type: integer
          example: 2000

    GetAllJobsResponse:
      type: array
      items:
        $ref: '#/components/schemas/Job'

    CreateJobRequest:
      type: object
      required:
        - title
        - industry
        - company
        - workplace
        - type
      properties:
        title:
          type: string
          example: Chef
        industry:
          type: string
          example: Food
        company:
          $ref: '#/components/schemas/Company'
        description:
          type: string
          example: Accountable for the quality, consistency and production of the restaurant kitchen
        workplace:
          type: string
          enum: [Onsite, Remote, Hybrid]
          example: Onsite
        type:
          type: string
          enum: [FullTime, PartTime]
          example: FullTime
        experienceLevel:
          type: string
          enum: [Freshman, Junior, MidLevel, Senior]
          example: Senior
        salaryRange:
          type: object
          properties:
            lowBound:
              type: integer
              example: 2500
            highBound:
              type: integer
              example: 3000
            currency:
              type: string
              default: USD
              example: USD
        location:
          $ref: '#/components/schemas/Location'
        keywords:
          type: array
          items:
            type: string
          example: [chef, cuisine, Italian food]

    UpdateJobRequest:
      type: object
      properties:
        title:
          type: string
          example: Chef
        industry:
          type: string
          example: Food
        company:
          $ref: '#/components/schemas/Company'
        description:
          type: string
          example: Accountable for the quality, consistency and production of the restaurant kitchen
        workplace:
          type: string
          enum: [Onsite, Remote, Hybrid]
          example: Onsite
        type:
          type: string
          enum: [FullTime, PartTime]
          example: FullTime
        experienceLevel:
          type: string
          enum: [Freshman, Junior, MidLevel, Senior]
          example: Senior
        salaryRange:
          type: object
          properties:
            lowBound:
              type: integer
              example: 2500
            highBound:
              type: integer
              example: 3000
            currency:
              type: string
              default: USD
              example: USD
        location:
          $ref: '#/components/schemas/Location'
        keywords:
          type: array
          items:
            type: string
          example: [chef, cuisine, Italian food]

    GetAllJobApplicationsResponse:
      type: array
      items:
        $ref: '#/components/schemas/JobApplication'

    CreateJobApplicationRequest:
      type: object
      required:
        - applicant
        - job
        - resume
      properties:
        applicant:
          type: object
          properties:
            id:
              type: string
              example: 1432121547f6afs
            name:
              type: string
              example: Omar Metwally
        job:
          type: string
          example: rew132456q
        resume:
          type: string
          example: http://example.com/resume.pdf

    UpdateJobApplicationRequest:
      type: object
      properties:
        status:
          type: string
          enum: [Pending, Viewed, Rejected, Accepted]
          example: Accepted

    PostResponse:
      type: object
      properties:
        id:
          type: string
          format: uuid
        text:
          type: string
        authorId:
          type: string
          format: uuid
        tagedUsers:
          type: array
          items:
            type: string
            format: uuid
        mediaURL:
          type: array
          items:
            type: string
        isActive:
          type: boolean
        createdAt:
          type: string
          format: timestamp
        updatedAt:
          type: string
          format: timestamp
        user:
          type: object
          properties:
            firstname:
              type: string
            lastname:
              type: string
            username:
              type: string
            profilePic:
              type: string
              example: https://example.com/image.jpg

    AddPostRequest:
      type: object
      required:
        - author
      properties:
        text:
          type: string
          example: Hello World
        author:
          type: string
          format: uuid
        mediaURL:
          type: string
          example: https://example.com/image.jpg
        tagedUsers:
          type: array
          items:
            type: string
            format: uuid
        tagedCompanies:
          type: array
          items:
            type: string
            format: uuid

    AddPostResponse:
      type: object
      properties:
        id:
          type: string
          format: uuid

    reactOnPostRequest:
      type: object
      required:
        - type
      properties:
        type:
          type: string
          enum: [like, celebrate, support, love, insightfull, funny]

    AddReactResponse:
      type: object
      properties:
        reactId:
          type: string
          format: uuid

    AddCommentRequest:
      type: object
      required:
        - userId
        - text
      properties:
        userId:
          type: string
          format: uuid
        text:
          type: string
          example: Nice Post!

    AddCommentResponse:
      type: object
      properties:
        commentId:
          type: string
          format: uuid

    GetFollowersResponse:
      type: object
      properties:
        followers:
          type: array
          items:
            type: string
            format: uuid

    GetFollowingResponse:
      type: object
      properties:
        following:
          type: array
          items:
            type: string
            format: uuid

    sendConnectionResponse:
      type: object
      properties:
        connectionId:
          type: string
          format: uuid

    acceptConnectionResponse:
      type: object
      properties:
        connectionId:
          type: string
          format: uuid

    rejectConnectionResponse:
      type: object
      properties:
        connectionId:
          type: string
          format: uuid

    cancelConnectionResponse:
      type: object
      properties:
        connectionId:
          type: string
          format: uuid

    blockConnectionResponse:
      type: object
      properties:
        connectionId:
          type: string
          format: uuid

    unblockConnectionResponse:
      type: object
      properties:
        connectionId:
          type: string
          format: uuid

    GetConnectionStatusResponse:
      type: object
      properties:
        connection:
          type: object
          properties:
            status:
              type: string
            connectionId:
              type: string
              format: uuid

    GetConnectionsResponse:
      type: object
      properties:
        connections:
          type: array
          items:
            type: object
            properties:
              connectionId:
                type: string
                format: uuid
              status:
                type: string
              userId:
                type: string
                format: uuid
              user:
                type: object
                properties:
                  firstname:
                    type: string
                  lastname:
                    type: string
                  username:
                    type: string
                  profilePic:
                    type: string
                    example: https://example.com/image.jpg

    Location:
      type: object
      properties:
        address:
          type: string
          example: 301 Biscayne Blvd, Miami, FL 33132, USA
        description:
          type: string
          example: Miami, USA
        primary:
          type: boolean
          example: true
    Company:
      type: object
      properties:
        id:
          type: string
          example: qrw132456q
        name:
          type: string
          example: Good company
        email:
          type: string
          example: Good@company.com
        phone:
          example: '02345648946'
        logo:
          type: string
          example: http://company/logo.jpg
        coverPhoto:
          type: string
          example: http://company/coverPhoto.jpg
        industry:
          type: string
          example: Food
        overview:
          type: string
          example: Good Company is known for its delicious dishes that incorporate a fusion of flavors.
        locations:
          type: array
          items:
            $ref: '#/components/schemas/Location'
        founded:
          type: string
          format: timestamp
          example: 2025-02-10T19:30:13.363+00:00
        followers:
          type: integer
          example: 100000
        employees:
          type: integer
          example: 2000
        createdAt:
          type: string
          format: timestamp
          example: 2025-02-10T19:30:13.363+00:00
        updatedAt:
          type: string
          format: timestamp
          example: 2025-02-10T19:30:13.363+00:00

    Job:
      type: object
      properties:
        id:
          type: string
          example: qrw132456q
        title:
          type: string
          example: Chef
        industry:
          type: string
          example: Food
        company:
          $ref: '#/components/schemas/Company'
        description:
          type: string
          example: Accountable for the quality, consistency and production of the restaurant kitchen
        workplace:
          type: string
          enum: [Onsite, Remote, Hybrid]
          example: Onsite
        type:
          type: string
          enum: [FullTime, PartTime]
          example: FullTime
        experienceLevel:
          type: string
          enum: [Freshman, Junior, MidLevel, Senior]
          example: Senior
        salaryRange:
          type: object
          properties:
            lowBound:
              type: integer
              example: 2500
            highBound:
              type: integer
              example: 3000
            currency:
              type: string
              default: USD
              example: USD
        location:
          $ref: '#/components/schemas/Location'
        keywords:
          type: array
          items:
            type: string
          example: [chef, cuisine, Italian food]
        createdAt:
          type: string
          format: timestamp
          example: 2025-02-10T19:30:13.363+00:00
        updatedAt:
          type: string
          format: timestamp
          example: 2025-02-10T19:30:13.363+00:00

    JobApplication:
      type: object
      properties:
        id:
          type: string
          example: qrw132456q
        applicant:
          type: object
          properties:
            id:
              type: string
              example: 1432121547f6afs
            name:
              type: string
              example: Omar Metwally
        job:
          type: string
          example: rew132456q
        resume:
          type: string
          example: http://example.com/resume.pdf
        status:
          type: string
          enum: [Pending, Viewed, Rejected, Accepted]
          default: Pending
        createdAt:
          type: string
          format: timestamp
          example: 2025-02-10T19:30:13.363+00:00
        updatedAt:
          type: string
          format: timestamp
          example: 2025-02-10T19:30:13.363+00:00