ITProjectManagemnetApp is a web application developed in the Node.js environment using the Express.js framework. It is designed to manage tasks within projects for development teams. The application allows users to create tasks, assign them to specific developers, manage their status and track their execution time.
\nKey functionalities:
\nThis endpoint allows the client to register a new user.
\nprojectId (array): An array of project IDs.first_name (string): The first name of the user.last_name (string): The last name of the user.email (string): The email address of the user.password (string): The password for the user account.specialization (string): The specialization of the user.role (string): The role of the user.status (string): The status of the response.data (array): An array containing user details including projectId, first_name, last_name, email, password, specialization, role, _id, estimationStats, and __v.message (string): A message related to the response.Example Response:
\n{\n \"status\": \"\",\n \"data\": [\n {\n \"projectId\": [],\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"email\": \"\",\n \"password\": \"\",\n \"specialization\": \"\",\n \"role\": \"\",\n \"_id\": \"\",\n \"estimationStats\": [],\n \"__v\": 0\n }\n ],\n \"message\": \"\"\n}\n\nThis endpoint allows users to log in via a POST request to localhost:3000/login. The request should include a JSON payload in the raw request body type with the user's email and password. Upon successful execution, the endpoint returns a JSON response with a status and a message.
\n{\n \"status\": \"\",\n \"message\": \"\"\n}\n\nThis endpoint sends an HTTP GET request to localhost:3000/logout. It returns a status code of 200 and a JSON response with a message key. Below are some examples of responses for this request:
\n{\"message\":\"\"}\n\nThis endpoint sends an HTTP GET request to localhost:3000/isDeveloper to check if the user is a developer. The last execution returned a 401 status with a content type of text/plain, and the message \"Unauthorized\". The response body may include a status and message field, both of which are empty in the provided example.
\n","urlObject":{"port":"3000","path":["isDeveloper"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"19a25cdc-d736-4575-a6ee-7757797b90f9","name":"Is Developer","originalRequest":{"method":"GET","header":[],"url":"localhost:3000/isDeveloper"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"63"},{"key":"ETag","value":"W/\"3f-waOLBwqPmu2OFgT8LIfBpA27Q9k\""},{"key":"Date","value":"Mon, 15 Apr 2024 18:27:31 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"message\": \"Welcome to the your Dashboard!\"\n}"},{"id":"80ed3bc4-d14c-48ac-b56b-963b0dad77cb","name":"Is Developer","originalRequest":{"method":"GET","header":[],"url":"localhost:3000/isDeveloper"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"plain","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"text/plain; charset=utf-8"},{"key":"Content-Length","value":"12"},{"key":"ETag","value":"W/\"c-dAuDFQrdjS3hezqxDTNgW7AOlYk\""},{"key":"Date","value":"Mon, 15 Apr 2024 18:27:44 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"Unauthorized"}],"_postman_id":"f5069a8d-962c-4438-82cc-541ad6373871"},{"name":"Is Admin","id":"2c841e72-8d00-4595-a330-b42593de5ce6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"localhost:3000/isAdmin","description":"This endpoint is used to check if the user is an admin.
\nThe response will have a status code of 200 and a JSON body with the following parameters:
\nIt mainly comes down to two functions:
\nTo receive a response from get endpoints, you must be logged in at least as developer (get/users exception). For other endpoints you must be logged in as admin.
\n","_postman_id":"d9547dbc-515a-44f6-ad09-7db8d3d67982"},{"name":"Users","item":[{"name":"All Users","id":"9dbc6d5e-67e8-44c0-87bb-ce374d82a3f2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"localhost:3000/users","description":"This endpoint makes an HTTP GET request to localhost:3000/users to retrieve a list of users. The response will be in JSON format with a status code of 200. An example of the response body is as follows:
\n{\n \"result\": [\n {\n \"_id\": \"\",\n \"projectId\": [],\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"email\": \"\",\n \"specialization\": \"\",\n \"role\": \"\",\n \"estimationStats\": [],\n \"__v\": 0\n }\n ]\n}\n\nThe \"result\" array contains user objects with attributes such as _id, projectId, first_name, last_name, email, specialization, role, estimationStats, and __v.
\n","urlObject":{"port":"3000","path":["users"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"e4f07075-e578-4375-99cc-96e791c94322","name":"All Users","originalRequest":{"method":"GET","header":[],"url":"localhost:3000/users"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"593"},{"key":"ETag","value":"W/\"251-vrSUrpr5NsltE0xAOKo7fDCwkho\""},{"key":"Date","value":"Mon, 15 Apr 2024 18:44:58 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"result\": [\n {\n \"_id\": \"661d7557438e77e6f2431d61\",\n \"projectId\": [],\n \"first_name\": \"Jan\",\n \"last_name\": \"Kowalski\",\n \"email\": \"jan@gmail.com\",\n \"specialization\": \"BACKEND\",\n \"role\": \"developer\",\n \"estimationStats\": [],\n \"__v\": 0\n },\n {\n \"_id\": \"661d7564438e77e6f2431d66\",\n \"projectId\": [],\n \"first_name\": \"Bartek\",\n \"last_name\": \"Kowalski\",\n \"email\": \"bartek@gmail.com\",\n \"specialization\": \"BACKEND\",\n \"role\": \"developer\",\n \"estimationStats\": [],\n \"__v\": 0\n },\n {\n \"_id\": \"661d75a7438e77e6f2431d75\",\n \"projectId\": [],\n \"first_name\": \"Dawid\",\n \"last_name\": \"Błaszczyk\",\n \"email\": \"dawid@gmail.com\",\n \"specialization\": \"BACKEND\",\n \"role\": \"admin\",\n \"estimationStats\": [],\n \"__v\": 0\n }\n ]\n}"}],"_postman_id":"9dbc6d5e-67e8-44c0-87bb-ce374d82a3f2"},{"name":"Single User","id":"b4e7d943-d6dc-4096-96a7-77c5177f0cf4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"localhost:3000/user/:userId","description":"This endpoint retrieves the details of a specific user identified by the userId.
GET localhost:3000/user/:userId
userId (string) - The unique identifier of the user.Example response body:
\n{\n \"result\": {\n \"_id\": \"\",\n \"projectId\": [],\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"email\": \"\",\n \"specialization\": \"\",\n \"role\": \"\",\n \"estimationStats\": [],\n \"__v\": 0\n }\n}\n\nThis endpoint retrieves a list of users based on their specialization.
\nThe response will be a JSON object with a \"result\" array containing user information such as _id, projectId, first_name, last_name, email, specialization, role, and estimationStats.
\nExample response:
\n{\n \"result\": [\n {\n \"_id\": \"\",\n \"projectId\": [],\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"email\": \"\",\n \"specialization\": \"\",\n \"role\": \"\",\n \"estimationStats\": [],\n \"__v\": 0\n }\n ]\n}\nThis endpoint retrieves the tasks associated with a specific project and user. It makes an HTTP GET request to localhost:3000/user/:userId/project/:projectId/tasks.
\nThe response to this request will have a status code of 200 and a content type of application/json. The response body will contain an array of task objects, with each object containing various properties such as _id, projectId, credentials, state, createdBy, dateRange, executionTime, createdAt, and __v.
\nHere is an example of the response body:
\n{\n \"result\": [\n {\n \"_id\": \"\",\n \"projectId\": \"\",\n \"credentials\": {\n \"name\": \"\",\n \"assignedTo\": \"\",\n \"estimation\": 0,\n \"specialization\": \"\",\n \"_id\": \"\"\n },\n \"state\": \"\",\n \"createdBy\": \"\",\n \"dateRange\": {\n \"startDate\": \"\",\n \"endDate\": \"\",\n \"_id\": \"\"\n },\n \"executionTime\": null,\n \"createdAt\": \"\",\n \"__v\": 0\n }\n ]\n}\n\nThis endpoint retrieves the projects associated with a specific user.
\nGET localhost:3000/user/:userId/projects
Example response body:
\n[\n {\n \"_id\": \"\",\n \"developerID\": \"\",\n \"projectCredentials\": {\n \"name\": \"\",\n \"developers\": [\"\"],\n \"_id\": \"\"\n },\n \"description\": \"\",\n \"status\": \"\",\n \"priority\": \"\",\n \"__v\": 0\n }\n]\n\nThis endpoint retrieves the tasks associated with a specific user.
\nGET /user/:userId/tasks
Example response body:
\n{\n \"result\": [\n {\n \"_id\": \"\",\n \"projectId\": \"\",\n \"credentials\": {\n \"name\": \"\",\n \"assignedTo\": \"\",\n \"estimation\": 0,\n \"specialization\": \"\",\n \"_id\": \"\"\n },\n \"state\": \"\",\n \"createdBy\": \"\",\n \"dateRange\": {\n \"startDate\": \"\",\n \"endDate\": \"\",\n \"_id\": \"\"\n },\n \"executionTime\": null,\n \"createdAt\": \"\",\n \"__v\": 0\n }\n ]\n}\n\nThis endpoint is used to update the last name of a user with the specified userId.
\nlast_name (string, required): The updated last name of the user.msg (string): A message indicating the success of the operation.developer (object): An object containing the updated user details, including _id, projectId, first_name, last_name, email, specialization, role, and estimationStats.{\n \"msg\": \"\",\n \"developer\": {\n \"_id\": \"\",\n \"projectId\": [],\n \"first_name\": \"\",\n \"last_name\": \"\",\n \"email\": \"\",\n \"specialization\": \"\",\n \"role\": \"\",\n \"estimationStats\": [],\n \"__v\": 0\n }\n}\nThis HTTP PATCH request is used to update a specific project for a user identified by the userId and projectId. The request should be sent to localhost:3000/user/:userId/project/:projectId.
\nThe response to this request will have a status code of 200 and a content type of application/json. The response body will contain a message and the updatedDeveloper object, which includes details such as _id, projectId, first_name, last_name, email, specialization, role, and estimationStats.
\nHere is an example of the response:
\n{\n \"message\":\"\",\n \"updatedDeveloper\":{\n \"_id\":\"\",\n \"projectId\":[\"\"],\n \"first_name\":\"\",\n \"last_name\":\"\",\n \"email\":\"\",\n \"specialization\":\"\",\n \"role\":\"\",\n \"estimationStats\":[],\n \"__v\":0\n }\n}\nThis endpoint is used to delete a specific user identified by the userId.
200 OK : The user has been successfully deleted. The response will contain a JSON object with a msg key.{\n \"msg\": \"\"\n}\nThis HTTP DELETE request is used to delete a user from the localhost server at port 3000. Upon successful execution, the server returns a 200 status with a JSON response containing a message. An example of the response would be:
\n{\n \"msg\": \"\"\n}\nThis endpoint retrieves a list of projects.
\nExample response body:
\n{\n \"result\": [\n {\n \"_id\": \"\",\n \"developerID\": \"\",\n \"projectCredentials\": {\n \"name\": \"\",\n \"developers\": [],\n \"_id\": \"\"\n },\n \"description\": \"\",\n \"status\": \"\",\n \"priority\": \"\",\n \"__v\": 0\n }\n ]\n}\n\nThis endpoint retrieves the details of a specific project identified by the projectId parameter.
\nGET localhost:3000/project/:projectId
Example response body:
\n{\n \"result\": {\n \"_id\": \"\",\n \"developerID\": \"\",\n \"projectCredentials\": {\n \"name\": \"\",\n \"developers\": [],\n \"_id\": \"\"\n },\n \"description\": \"\",\n \"status\": \"\",\n \"priority\": \"\",\n \"__v\": 0\n }\n}\n\nThe response contains the details of the project including its ID, developer ID, project credentials, description, status, priority, and version.
\n","urlObject":{"port":"3000","path":["project",":projectId"],"host":["localhost"],"query":[],"variable":[{"type":"any","value":"661789ce09d30c2e16ca433e","key":"projectId"}]}},"response":[{"id":"150deaa6-4565-4bae-974d-21c64c00a52a","name":"Single Project","originalRequest":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":{"raw":"localhost:3000/project/:projectId","host":["localhost"],"port":"3000","path":["project",":projectId"],"variable":[{"key":"projectId","value":"661d79028884860578f5ba0b"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"310"},{"key":"ETag","value":"W/\"136-KFnhUcAvMY16y/dWS/7MzG5cRNk\""},{"key":"Date","value":"Mon, 15 Apr 2024 19:01:22 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"result\": {\n \"_id\": \"661d79028884860578f5ba0b\",\n \"developerID\": \"661b223239e4ffdf83693bfb\",\n \"projectCredentials\": {\n \"name\": \"Projekt Alfa\",\n \"developers\": [],\n \"_id\": \"661d79028884860578f5ba0c\"\n },\n \"description\": \"To jest przykładowy projekt Alfa, który służy jako demonstracja.\",\n \"status\": \"Planned\",\n \"priority\": \"High\",\n \"__v\": 0\n }\n}"}],"_postman_id":"3fee13ca-ae33-4ba1-91bc-2321c70cd5f1"},{"name":"Project's Tasks","id":"cf85eb3a-be23-483d-a25b-0d9e30887f45","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"localhost:3000/project/:projectId/tasks","description":"This endpoint retrieves the tasks associated with a specific project.
\nThe response will be a JSON object with a \"result\" array containing task objects. Each task object includes properties such as \"_id\", \"projectId\", \"credentials\", \"state\", \"createdBy\", \"dateRange\", \"executionTime\", \"createdAt\", and \"__v\". The \"credentials\" object within each task includes properties like \"name\", \"assignedTo\", \"estimation\", \"specialization\", and \"_id\".
\nHere is an example of the response:
\n{\n \"result\": [\n {\n \"_id\": \"\",\n \"projectId\": \"\",\n \"credentials\": {\n \"name\": \"\",\n \"assignedTo\": null,\n \"estimation\": 0,\n \"specialization\": \"\",\n \"_id\": \"\"\n },\n \"state\": \"\",\n \"createdBy\": \"\",\n \"dateRange\": {\n \"startDate\": \"\",\n \"endDate\": \"\",\n \"_id\": \"\"\n },\n \"executionTime\": null,\n \"createdAt\": \"\",\n \"__v\": 0\n }\n ]\n}\n\nThis API endpoint retrieves the assignments for a specific project identified by the projectId parameter. The response will contain an array of assignments, each with details such as _id, developerId, tasks, and version (**v). Each task within the assignments array includes projectId, credentials, state, createdAt, createdBy, dateRange, executionTime, and version (**v).
\nExample response:
\n{\n \"result\": [\n {\n \"_id\": \"\",\n \"developerId\": \"\",\n \"tasks\": [\n {\n \"projectId\": \"\",\n \"credentials\": {\n \"name\": \"\",\n \"assignedTo\": null,\n \"estimation\": 0,\n \"specialization\": \"\",\n \"_id\": \"\"\n },\n \"state\": \"\",\n \"createdAt\": \"\",\n \"createdBy\": \"\",\n \"dateRange\": {\n \"startDate\": \"\",\n \"endDate\": \"\",\n \"_id\": \"\"\n },\n \"executionTime\": null,\n \"_id\": \"\",\n \"__v\": 0\n }\n ],\n \"__v\": 0\n }\n ]\n}\n\nThis HTTP POST request is used to add an assignment to a specific project identified by the projectId parameter in the URL. The request should contain the necessary data for the assignment. Upon successful execution, the server returns a 200 status with a JSON response containing the details of the added assignment.
\nOperation of the allocation algorithm:
\nDivide unassigned shuffles by specialties.
\nDividing developers by specialties.
\nFor each specialization, we choose a particular specialization.
\nSelect tasks from a given specialization one by one.
\nCheck the estimation of a given task.
\nCreate an array sorted from the best developers (the best developer is selected on the basis of the average number of hours needed to complete tasks with the given estimation)
\nAssign a task to the best developer.
\nIn addition, the selection of a given developer for task assignment is also affected by the number of new tasks assigned to him during this algorithm.
\nAn example of the response for this request is as follows:
\n[\n {\n \"developerId\": \"\",\n \"tasks\": [\n {\n \"projectId\": \"\",\n \"credentials\": {\n \"name\": \"\",\n \"assignedTo\": null,\n \"estimation\": 0,\n \"specialization\": \"\",\n \"_id\": \"\"\n },\n \"state\": \"\",\n \"createdAt\": \"\",\n \"createdBy\": \"\",\n \"dateRange\": {\n \"startDate\": \"\",\n \"endDate\": \"\",\n \"_id\": \"\"\n },\n \"executionTime\": null,\n \"_id\": \"\",\n \"__v\": 0\n }\n ],\n \"_id\": \"\",\n \"__v\": 0\n }\n]\n\nThis response provides the details of the added assignment, including developerId, tasks with their respective details, and other relevant information.
\n","urlObject":{"port":"3000","path":["project",":projectId","assignment"],"host":["localhost"],"query":[],"variable":[{"type":"any","value":"661b166f4f3e9f78619bda11","key":"projectId"}]}},"response":[{"id":"01d0fe4e-19b7-45de-9752-acfbf316376b","name":"Assignment Tasks","originalRequest":{"method":"POST","header":[],"url":{"raw":"localhost:3000/project/:projectId/assignment","host":["localhost"],"port":"3000","path":["project",":projectId","assignment"],"variable":[{"key":"projectId","value":"661d79c08884860578f5ba21"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"1568"},{"key":"ETag","value":"W/\"620-nNehqA9ri+2OX9vVNYyE0WbT42U\""},{"key":"Date","value":"Mon, 15 Apr 2024 19:47:44 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"developerId\": \"661d7557438e77e6f2431d61\",\n \"tasks\": [\n {\n \"projectId\": \"661d79c08884860578f5ba21\",\n \"credentials\": {\n \"name\": \"Implement new API endpoint\",\n \"assignedTo\": null,\n \"estimation\": 13,\n \"specialization\": \"BACKEND\",\n \"_id\": \"661d7c6aaef84bd15bc6eeeb\"\n },\n \"state\": \"OPEN\",\n \"createdAt\": \"2024-04-15T19:13:46.231Z\",\n \"createdBy\": \"661d7557438e77e6f2431d61\",\n \"dateRange\": {\n \"startDate\": \"2024-02-01T00:00:00.000Z\",\n \"endDate\": \"2024-04-15T00:00:00.000Z\",\n \"_id\": \"661d7c6aaef84bd15bc6eeec\"\n },\n \"executionTime\": null,\n \"_id\": \"661d7c6aaef84bd15bc6eeea\",\n \"__v\": 0\n }\n ],\n \"_id\": \"661d846094e60f8b8daa9e17\",\n \"__v\": 0\n },\n {\n \"developerId\": \"661d7564438e77e6f2431d66\",\n \"tasks\": [\n {\n \"projectId\": \"661d79c08884860578f5ba21\",\n \"credentials\": {\n \"name\": \"Create new application\",\n \"assignedTo\": null,\n \"estimation\": 3,\n \"specialization\": \"BACKEND\",\n \"_id\": \"661d7debc08968459302a030\"\n },\n \"state\": \"OPEN\",\n \"createdAt\": \"2024-04-15T19:20:11.227Z\",\n \"createdBy\": \"661d7557438e77e6f2431d61\",\n \"dateRange\": {\n \"startDate\": \"2024-05-21T00:00:00.000Z\",\n \"endDate\": \"2024-08-12T00:00:00.000Z\",\n \"_id\": \"661d7debc08968459302a031\"\n },\n \"executionTime\": null,\n \"_id\": \"661d7debc08968459302a02f\",\n \"__v\": 0\n },\n {\n \"projectId\": \"661d79c08884860578f5ba21\",\n \"credentials\": {\n \"name\": \"Delete all tasks\",\n \"assignedTo\": null,\n \"estimation\": 3,\n \"specialization\": \"BACKEND\",\n \"_id\": \"661d7e0ac08968459302a038\"\n },\n \"state\": \"OPEN\",\n \"createdAt\": \"2024-04-15T19:20:42.085Z\",\n \"createdBy\": \"661d7557438e77e6f2431d61\",\n \"dateRange\": {\n \"startDate\": \"2024-05-21T00:00:00.000Z\",\n \"endDate\": \"2024-05-22T00:00:00.000Z\",\n \"_id\": \"661d7e0ac08968459302a039\"\n },\n \"executionTime\": null,\n \"_id\": \"661d7e0ac08968459302a037\",\n \"__v\": 0\n }\n ],\n \"_id\": \"661d846094e60f8b8daa9e1c\",\n \"__v\": 0\n }\n]"}],"_postman_id":"82132806-11f6-4886-aabe-8195e5551d1e"},{"name":"Create Project","id":"bda09107-7943-4c43-b590-b2496fd16d20","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"developerID\": \"6619baaa4676ddbfb76a8129\",\r\n \"projectCredentials\": {\r\n \"name\": \"Projekt Alfa\",\r\n \"developers\": []\r\n },\r\n \"description\": \"To jest przykładowy projekt Alfa, który służy jako demonstracja.\",\r\n \"status\": \"Completed\",\r\n \"priority\": \"High\"\r\n}","options":{"raw":{"language":"json"}}},"url":"localhost:3000/project","description":"This endpoint allows you to create a new project.
\ndeveloperID (string, optional): The ID of the developer creating the project.projectCredentials.name (string, optional): The name of the project.projectCredentials.developers (array, optional): An array of developers involved in the project.description (string, optional): Description of the project.status (string, optional): Status of the project.priority (string, optional): Priority of the project.Upon successful creation of the project, the server responds with a status code of 201 and a JSON object containing the following fields:
\ndeveloperID (string): The ID of the developer.projectCredentials.name (string): The name of the project.projectCredentials.developers (array): An array of developers involved in the project.projectCredentials._id (string): The ID of the project.description (string): Description of the project.status (string): Status of the project.priority (string): Priority of the project._id (string): The ID of the project.__v (number): Version of the project.{\n \"developerID\": \"\",\n \"projectCredentials\": {\n \"name\": \"\",\n \"developers\": [],\n \"_id\": \"\"\n },\n \"description\": \"\",\n \"status\": \"\",\n \"priority\": \"\",\n \"_id\": \"\",\n \"__v\": 0\n}\n\nThis endpoint allows you to update the assignment for a specific project by making an HTTP PUT request to localhost:3000/project/:projectId/assignment. The request should include a payload with the raw request body type. The payload should contain a key \"action\" with a corresponding value to specify the action to be performed.
\nThe endpoint returns a status code of 422 and a JSON object with an \"error\" key. The \"error\" object contains a key \"action\" with a corresponding value to indicate the error related to the action.
\nExample:\nRequest:
\n{\n \"action\": \"complete\"\n}\nResponse:
\nStatus: 422\nContent-Type: application/json\n{\n \"error\": {\n \"action\": \"Invalid action\"\n }\n}\nThis endpoint is used to update the status of a specific project.
\nstatus (string, required): The new status of the project.msg (string): A message related to the update.project (object): The updated project details._id (string): The unique identifier of the project.developerID (string): The ID of the developer associated with the project.projectCredentials (object): The credentials of the project.name (string): The name of the project.developers (array): An array of developers associated with the project._id (string): The unique identifier of the project credentials.description (string): The description of the project.status (string): The updated status of the project.priority (string): The priority of the project.__v (number): Version control field.{\n \"msg\": \"\",\n \"project\": {\n \"_id\": \"\",\n \"developerID\": \"\",\n \"projectCredentials\": {\n \"name\": \"\",\n \"developers\": [\"\"],\n \"_id\": \"\"\n },\n \"description\": \"\",\n \"status\": \"\",\n \"priority\": \"\",\n \"__v\": 0\n }\n}\nThis endpoint is used to delete a specific project identified by the project ID.
\nlocalhost:3000/project/:projectIdStatus: 200
\nContent-Type: application/json
\nBody:
\n{\n \"msg\": \"\"\n}\n\nExample:
\n{\n \"msg\": \"\"\n}\n\nThis endpoint is used to delete a project. Upon a successful deletion, it returns a 200 status with an empty JSON response body containing a \"msg\" key.
\n{\n \"msg\": \"\"\n}\nThis endpoint makes an HTTP GET request to localhost:3000/tasks to retrieve a list of tasks. The response will be in JSON format with a 200 status code. An example of the response body is as follows:
\n{\n \"result\": [\n {\n \"_id\": \"\",\n \"projectId\": \"\",\n \"credentials\": {\n \"name\": \"\",\n \"assignedTo\": null,\n \"estimation\": 0,\n \"specialization\": \"\",\n \"_id\": \"\"\n },\n \"state\": \"\",\n \"createdBy\": \"\",\n \"dateRange\": {\n \"startDate\": \"\",\n \"endDate\": \"\",\n \"_id\": \"\"\n },\n \"executionTime\": null,\n \"createdAt\": \"\",\n \"__v\": 0\n }\n ]\n}\n\nThis indicates that the response will contain an array of tasks with various properties such as _id, projectId, credentials, state, createdBy, dateRange, executionTime, createdAt, and __v.
\n","urlObject":{"port":"3000","path":["tasks"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"bffbf4d2-67d4-4cc5-92c2-29a9f08da18a","name":"All Tasks","originalRequest":{"method":"GET","header":[],"url":"localhost:3000/tasks"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"1391"},{"key":"ETag","value":"W/\"56f-CIoEEyblVudIUmeoQlOAdnc+u5s\""},{"key":"Date","value":"Mon, 15 Apr 2024 19:20:47 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"result\": [\n {\n \"_id\": \"661d7c6aaef84bd15bc6eeea\",\n \"projectId\": \"661b225c39e4ffdf83693c02\",\n \"credentials\": {\n \"name\": \"Implement new API endpoint\",\n \"assignedTo\": null,\n \"estimation\": 13,\n \"specialization\": \"BACKEND\",\n \"_id\": \"661d7c6aaef84bd15bc6eeeb\"\n },\n \"state\": \"OPEN\",\n \"createdBy\": \"661d7557438e77e6f2431d61\",\n \"dateRange\": {\n \"startDate\": \"2024-02-01T00:00:00.000Z\",\n \"endDate\": \"2024-04-15T00:00:00.000Z\",\n \"_id\": \"661d7c6aaef84bd15bc6eeec\"\n },\n \"executionTime\": null,\n \"createdAt\": \"2024-04-15T19:13:46.231Z\",\n \"__v\": 0\n },\n {\n \"_id\": \"661d7debc08968459302a02f\",\n \"projectId\": \"661b225c39e4ffdf83693c02\",\n \"credentials\": {\n \"name\": \"Create new application\",\n \"assignedTo\": null,\n \"estimation\": 3,\n \"specialization\": \"BACKEND\",\n \"_id\": \"661d7debc08968459302a030\"\n },\n \"state\": \"OPEN\",\n \"createdBy\": \"661d7557438e77e6f2431d61\",\n \"dateRange\": {\n \"startDate\": \"2024-05-21T00:00:00.000Z\",\n \"endDate\": \"2024-08-12T00:00:00.000Z\",\n \"_id\": \"661d7debc08968459302a031\"\n },\n \"executionTime\": null,\n \"createdAt\": \"2024-04-15T19:20:11.227Z\",\n \"__v\": 0\n },\n {\n \"_id\": \"661d7e0ac08968459302a037\",\n \"projectId\": \"661b225c39e4ffdf83693c02\",\n \"credentials\": {\n \"name\": \"Delete all tasks\",\n \"assignedTo\": null,\n \"estimation\": 1,\n \"specialization\": \"BACKEND\",\n \"_id\": \"661d7e0ac08968459302a038\"\n },\n \"state\": \"OPEN\",\n \"createdBy\": \"661d7557438e77e6f2431d61\",\n \"dateRange\": {\n \"startDate\": \"2024-05-21T00:00:00.000Z\",\n \"endDate\": \"2024-05-22T00:00:00.000Z\",\n \"_id\": \"661d7e0ac08968459302a039\"\n },\n \"executionTime\": null,\n \"createdAt\": \"2024-04-15T19:20:42.085Z\",\n \"__v\": 0\n }\n ]\n}"}],"_postman_id":"44cf5675-2b88-401e-b199-d05bca573a1e"},{"name":"Single Task","id":"80eb0eb4-4fa2-4c72-a43f-85cbb302c399","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"localhost:3000/task/:taskId","description":"This endpoint retrieves the details of a specific task identified by the taskId.
Request:
\nlocalhost:3000/task/:taskIdResponse:
\nStatus: 200
\nContent-Type: application/json
\nBody:
\n{\n \"result\": {\n \"_id\": \"\",\n \"projectId\": \"\",\n \"credentials\": {\n \"name\": \"\",\n \"assignedTo\": null,\n \"estimation\": 0,\n \"specialization\": \"\",\n \"_id\": \"\"\n },\n \"state\": \"\",\n \"createdBy\": \"\",\n \"dateRange\": {\n \"startDate\": \"\",\n \"endDate\": \"\",\n \"_id\": \"\"\n },\n \"executionTime\": null,\n \"createdAt\": \"\",\n \"__v\": 0\n }\n}\n\nExample Response:
\n{\n \"result\": {\n \"_id\": \"\",\n \"projectId\": \"\",\n \"credentials\": {\n \"name\": \"\",\n \"assignedTo\": null,\n \"estimation\": 0,\n \"specialization\": \"\",\n \"_id\": \"\"\n },\n \"state\": \"\",\n \"createdBy\": \"\",\n \"dateRange\": {\n \"startDate\": \"\",\n \"endDate\": \"\",\n \"_id\": \"\"\n },\n \"executionTime\": null,\n \"createdAt\": \"\",\n \"__v\": 0\n }\n}\n\nThis endpoint allows you to add a new task.
\nprojectId (string, required): The ID of the project.credentials (object, required): The credentials for the task.name (string, required): The name of the task.estimation (number, required): The estimation for the task.specialization (string, required): The specialization for the task.state (string, required): The state of the task.createdBy (string, required): The user who created the task.dateRange (object, required): The date range for the task.startDate (string, required): The start date of the task.endDate (string, required): The end date of the task.The task has been successfully created.
\nprojectId (string): The ID of the project.credentials (object): The credentials for the task.name (string): The name of the task.assignedTo (string): The user assigned to the task.estimation (number): The estimation for the task.specialization (string): The specialization for the task._id (string): The ID of the task.state (string): The state of the task.createdBy (string): The user who created the task.dateRange (object): The date range for the task.startDate (string): The start date of the task.endDate (string): The end date of the task.executionTime (null): The execution time of the task._id (string): The ID of the task.createdAt (string): The creation date of the task.__v (number): Version key.{\n \"projectId\": \"\",\n \"credentials\": {\n \"name\": \"\",\n \"assignedTo\": null,\n \"estimation\": 0,\n \"specialization\": \"\",\n \"_id\": \"\"\n },\n \"state\": \"\",\n \"createdBy\": \"\",\n \"dateRange\": {\n \"startDate\": \"\",\n \"endDate\": \"\",\n \"_id\": \"\"\n },\n \"executionTime\": null,\n \"_id\": \"\",\n \"createdAt\": \"\",\n \"__v\": 0\n}\nThis endpoint is used to update a specific task identified by the taskId. The HTTP PATCH request should be sent to localhost:3000/task/:taskId with the payload in the raw request body type.
\ncredentials.estimation (number): The estimation value to be updated for the task.msg (string): A message, if any.task (object): The updated task object with various properties including _id, projectId, credentials, state, createdBy, dateRange, executionTime, createdAt, and __v.{\n \"msg\": \"\",\n \"task\": {\n \"_id\": \"\",\n \"projectId\": \"\",\n \"credentials\": {\n \"name\": \"\",\n \"assignedTo\": null,\n \"estimation\": 0,\n \"specialization\": \"\",\n \"_id\": \"\"\n },\n \"state\": \"\",\n \"createdBy\": \"\",\n \"dateRange\": {\n \"startDate\": \"\",\n \"endDate\": \"\",\n \"_id\": \"\"\n },\n \"executionTime\": null,\n \"createdAt\": \"\",\n \"__v\": 0\n }\n}\n\nThis endpoint is used to close a specific task identified by its taskId. When a PATCH request is sent to localhost:3000/task/:taskId/close, with the \"executionTime\" parameter in the request body, the task is closed with the provided execution time.
\nexecutionTime (number): The time taken to execute the task.message (string): A message indicating the result of the task closure.{\n \"message\": \"\"\n}\n\nThis endpoint is used to delete a specific task identified by its taskId. Upon successful deletion, the server returns a 200 status with an empty JSON response containing a \"msg\" key.
\nDELETE localhost:3000/task/:taskId\n\nExample:
\n{\n \"msg\": \"\"\n}\n\nThis endpoint sends an HTTP DELETE request to localhost:3000/tasks to delete a task. The response will have a status code of 200 and a content type of application/json. The response body will contain a message indicating the result of the deletion.
\n{\n \"msg\": \"\"\n}\n\n