feat session: service, controller, entity

README.md

@@ -1,20 +1,38 @@
-<img src="https://hknpolito.org/wp-content/uploads/2018/05/hkn_logo_blu.png" width="100">
+<img src="https://www.hknpolito.org/Signature/hkn_logo_blu.png" width="100">
 
 # HKrecruitment
-HKrecruitment is the platform used by HKN Polito to handle
-the recruitment process. This repository contains three branches:
-* **apiserver** - tracks the development of the API server
-* **reactapp** - tracks the development of the front-end React application
-* **documentation** - track the documentation for both the API server and the React application
 
-Trello for project state https://trello.com/invite/b/T6YYVYW3/ATTI0e7257a02d61a8b4fe54ac88affe746346110847/hkrecruitment
+HKrecruitment is the platform used by HKN Polito to handle the recruitment process.
 
-## Authors
+This repository follows the strcuture:
 
-* **Riccardo Zaccone** - *API server* - [HKN Polito](https://hknpolito.org/)
-* **Arianna Ravera** - *API server* - [HKN Polito](https://hknpolito.org/)
-* **Marco Pappalardo** - *React application* - [HKN Polito](https://hknpolito.org/)
+- **api** - API endpoints, back-end logic, and data storage
+- **frontend** - React Application UI
+- **shared** - Models, interfaces, and validation logic common to front-end and back-end
 
+## Useful Links
+
+[Reports](https://drive.google.com/drive/folders/1RqGVtzU4TV6RJPmtjZQPpHVybDpU6DZk?usp=sharing)
+
+[Trello](https://trello.com/b/vnLyKH85/hkrecruitment)
+
+[UI Mockups](https://miro.com/app/board/uXjVOdvzKAk=/)
+
+[Database Schema](https://app.diagrams.net/#G19QUWxP5BBB3tWXnATnHP8wFE4wW7NsXw)
+
+## Contributors
+
+- **Riccardo Zaccone** - _API server_ - [HKN Polito](https://hknpolito.org/)
+- **Arianna Ravera** - _API server_ - [HKN Polito](https://hknpolito.org/)
+- **Vincenzo Pellegrini** - _API server_ - [HKN Polito](https://hknpolito.org/)
+- **Alberto Baroso** - _API server_ - [HKN Polito](https://hknpolito.org/)
+- **Marco De Luca** - _API server_ - [HKN Polito](https://hknpolito.org/)
+- **Matteo Mugnai** - _API server_ - [HKN Polito](https://hknpolito.org/)
+- **Pasquale Bianco** - _API server_ - [HKN Polito](https://hknpolito.org/)
+
+- **Marco Pappalardo** - _React application_ - [HKN Polito](https://hknpolito.org/)
+- **Damiano Bonaccorsi** - _React application_ - [HKN Polito](https://hknpolito.org/)
 
 ## License
+
 HKRecruitment is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. See the [COPYING](COPYING) file for details.

api/package.json

@@ -24,6 +24,7 @@
       "@casl/ability": "^6.3.3",
       "@fastify/static": "^6.6.0",
       "@hkrecruitment/shared": "workspace:*",
+      "@joi/date": "^2.1.0",
       "@nestjs/common": "^9.0.0",
       "@nestjs/config": "^2.2.0",
       "@nestjs/core": "^9.0.0",
@@ -34,9 +35,9 @@
       "@types/js-yaml": "^4.0.5",
       "@types/passport-jwt": "^3.0.7",
       "class-transformer": "^0.5.1",
+      "dotenv": "^16.0.3",
       "google-auth-library": "^8.7.0",
       "googleapis": "^118.0.0",
-      "dotenv": "^16.0.3",
       "joi": "^17.7.0",
       "js-yaml": "^4.1.0",
       "jwks-rsa": "^3.0.0",
@@ -49,7 +50,6 @@
       "webpack": "^5.75.0"
    },
    "devDependencies": {
-      "@types/multer": "^1.4.7",
       "@automock/jest": "^1.0.1",
       "@golevelup/ts-jest": "^0.3.6",
       "@nestjs/cli": "^9.0.0",
@@ -59,6 +59,7 @@
       "@swc/jest": "^0.2.26",
       "@types/express": "^4.17.14",
       "@types/jest": "28.1.8",
+      "@types/multer": "^1.4.7",
       "@types/node": "^16.11.10",
       "@types/supertest": "^2.0.11",
       "@typescript-eslint/eslint-plugin": "^5.0.0",
@@ -99,7 +100,7 @@
       ],
       "moduleNameMapper": {
          "^@mocks/(.*)$": "<rootDir>/src/mocks/$1"
-       },
+      },
       "coverageDirectory": "../coverage",
       "testEnvironment": "node"
    }

api/src/mocks/data.ts

@@ -11,6 +11,9 @@ import {
   PhdApplication,
 } from 'src/application/application.entity';
 import { UpdateApplicationDto } from 'src/application/update-application.dto';
+import { RecruitmentSessionState } from '@hkrecruitment/shared/recruitment-session';
+import { CreateRecruitmentSessionDto } from 'src/recruitment-session/create-recruitment-session.dto';
+import { UpdateRecruitmentSessionDto } from 'src/recruitment-session/update-recruitment-session.dto';
 
 export const testDate = new Date(2023, 0, 1);
 export const testDateTimeStart = new Date(2023, 0, 1, 10, 30, 0);
@@ -24,6 +27,39 @@ export const mockTimeSlot = {
   id: 1,
 };
 
+export const testInterviewStart = '11:55' as unknown as Date;
+export const testInterviewEnd = '20:35' as unknown as Date;
+export const testDay1 = '2024-10-20' as unknown as Date;
+export const testDay2 = '2024-10-21' as unknown as Date;
+export const testDay3 = '2024-10-22' as unknown as Date;
+export const testDateCreatedAt = '2024-9-10' as unknown as Date;
+export const testDateLastModified = '2024-9-12' as unknown as Date;
+
+export const mockRecruitmentSession = {
+  id: 1,
+  state: RecruitmentSessionState.Active,
+  slotDuration: 50,
+  interviewStart: testInterviewStart,
+  interviewEnd: testInterviewEnd,
+  days: [testDay1, testDay2, testDay3],
+  createdAt: testDateCreatedAt,
+  lastModified: testDateLastModified,
+};
+
+export const mockCreateRecruitmentSessionDto = {
+  slotDuration: 50,
+  interviewStart: testInterviewStart,
+  interviewEnd: testInterviewEnd,
+  days: [testDay1, testDay2, testDay3],
+} as CreateRecruitmentSessionDto;
+
+export const mockUpdateRecruitmentSessionDto = {
+  slotDuration: 50,
+  interviewStart: testInterviewStart,
+  interviewEnd: testInterviewEnd,
+  days: [testDay1, testDay2, testDay3],
+} as UpdateRecruitmentSessionDto;
+
 export const baseFile = {
   encoding: '7bit',
   mimetype: 'application/pdf',

api/src/recruitment-session/create-recruitment-session.dto.ts

@@ -0,0 +1,18 @@
+import { RecruitmentSession } from '@hkrecruitment/shared/recruitment-session';
+import { ApiProperty } from '@nestjs/swagger';
+
+export class CreateRecruitmentSessionDto
+  implements Partial<RecruitmentSession>
+{
+  @ApiProperty()
+  slotDuration: number;
+
+  @ApiProperty()
+  interviewStart: Date;
+
+  @ApiProperty()
+  interviewEnd: Date;
+
+  @ApiProperty({ isArray: true })
+  days: Date[];
+}

api/src/recruitment-session/recruitment-session-response.dto.ts

@@ -0,0 +1,14 @@
+import {
+  RecruitmentSession,
+  RecruitmentSessionState,
+} from '@hkrecruitment/shared/recruitment-session';
+import { Exclude, Expose } from 'class-transformer';
+
+@Exclude()
+export class RecruitmentSessionResponseDto
+  implements Partial<RecruitmentSession>
+{
+  @Expose() id: number;
+  @Expose() createdAt: Date;
+  @Expose() state: RecruitmentSessionState;
+}