API: Access Employee(s) Profile within an Organization

[demola234]

Context

This feature enables organizations to access and manage employee profiles within their organization. It provides authorized users with visibility into employee data and engagement status.

---

Requirements

• 1. Retrieve All Employee Profiles
  As an authorized user, I should be able to view a list of employees within my organization. For each employee, the following mini information should be provided:

  • Full name
  • Number of active contracts with the organization
  • Activation status (e.g., active/inactive)
  • Job title or role (e.g., Frontend Developer)
  • Profile picture
    The employees records created should be by date craeted

• 2. Retrieve Organization Employee Metrics: As an authorized user, I should be able to see the following metrics:

  • Total number of employees engaged with my organization
  • Total number of freelancers
  • Total number of contractors

• 3. Retrieve a Single Employee's Profile Information: As an authorized user, I should be able to access detailed information for any individual employee, including:
  1. Personal Information:

  • Full name
  • Profile picture
  • Email address
  • Phone number
  • Residential address

  2. Engaged Contracts: For each contract, the following should be provided:

  • Contract name
  • Price or compensation amount
  • Timeframe (start and end dates)
  • Status (e.g., Active, Inactive)

• 4. Search for a Specific Employee: Authorized users should be able to search for employees within their organization using their first name, last name, or both. Employees who match the search criteria should be returned along with their mini information.

• 5. Filter Employees by Their Staff Type: Freenlacer or Contractor. I would be provided with employees that fit the criteria