feat: アクティビティ入退室エンドポイントの実装

document/bundle.gen.yml

@@ -27,6 +27,8 @@ tags:
     description: Mattermost system
   - name: mail
     description: Mail system
+  - name: activity
+    description: Activity system
 paths:
   /status:
     get:
@@ -1609,6 +1611,116 @@ paths:
           $ref: '#/components/responses/Unauthorized'
         '500':
           $ref: '#/components/responses/InternalServer'
+  /activity/checkin:
+    post:
+      tags:
+        - activity
+      description: Activity checkin
+      security:
+        - BearerAuth: []
+      requestBody:
+        description: Activity checkin request
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/ReqPostActivityCheckin'
+      responses:
+        '200':
+          $ref: '#/components/responses/BlankSuccess'
+        '400':
+          $ref: '#/components/responses/BadRequest'
+        '403':
+          $ref: '#/components/responses/Unauthorized'
+        '500':
+          $ref: '#/components/responses/InternalServer'
+  /activity/checkout:
+    post:
+      tags:
+        - activity
+      description: Activity checkout
+      security:
+        - BearerAuth: []
+      requestBody:
+        description: Activity checkout request
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/ReqPostActivityCheckout'
+      responses:
+        '200':
+          $ref: '#/components/responses/BlankSuccess'
+        '400':
+          $ref: '#/components/responses/BadRequest'
+        '403':
+          $ref: '#/components/responses/Unauthorized'
+        '404':
+          $ref: '#/components/responses/NotFound'
+        '500':
+          $ref: '#/components/responses/InternalServer'
+  '/activity/checkout/{userId}':
+    post:
+      tags:
+        - activity
+      description: Admin force activity checkout
+      security:
+        - BearerAuth: []
+      parameters:
+        - name: userId
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        description: Activity checkout request
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/ReqPostActivityCheckout'
+      responses:
+        '200':
+          $ref: '#/components/responses/BlankSuccess'
+        '400':
+          $ref: '#/components/responses/BadRequest'
+        '403':
+          $ref: '#/components/responses/Unauthorized'
+        '404':
+          $ref: '#/components/responses/NotFound'
+        '500':
+          $ref: '#/components/responses/InternalServer'
+  '/activity/record/{recordId}':
+    put:
+      tags:
+        - activity
+      description: Update activity record times
+      security:
+        - BearerAuth: []
+      parameters:
+        - name: recordId
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        description: Activity record update request
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/ReqPutActivityRecordRecordId'
+      responses:
+        '200':
+          $ref: '#/components/responses/BlankSuccess'
+        '400':
+          $ref: '#/components/responses/BadRequest'
+        '403':
+          $ref: '#/components/responses/Unauthorized'
+        '404':
+          $ref: '#/components/responses/NotFound'
+        '500':
+          $ref: '#/components/responses/InternalServer'
 components:
   schemas:
     ResGetStatus:
@@ -2989,8 +3101,10 @@ components:
       properties:
         addresses:
           type: array
+          minItems: 1
           items:
             type: string
+            format: email
           x-oapi-codegen-extra-tags:
             validate: required
             ja: 送信先アドレス
@@ -3027,6 +3141,45 @@ components:
                 type: string
               error:
                 type: string
+    ReqPostActivityCheckin:
+      required:
+        - place
+      properties:
+        place:
+          type: string
+          minLength: 3
+          maxLength: 10
+          x-oapi-codegen-extra-tags:
+            validate: 'required,min=3,max=10'
+            ja: 場所名
+    ReqPostActivityCheckout:
+      required:
+        - place
+      properties:
+        place:
+          type: string
+          minLength: 3
+          maxLength: 10
+          x-oapi-codegen-extra-tags:
+            validate: 'required,min=3,max=10'
+            ja: 場所名
+    ReqPutActivityRecordRecordId:
+      required:
+        - activity_type
+        - time
+      properties:
+        activity_type:
+          type: string
+          enum:
+            - checkin
+            - checkout
+          x-oapi-codegen-extra-tags:
+            ja: アクティビティタイプ
+        time:
+          type: string
+          format: date-time
+          x-oapi-codegen-extra-tags:
+            ja: 更新時刻
     Error:
       required:
         - level

document/paths.yml

@@ -90,3 +90,11 @@
   $ref: "./paths/budget_budget_id_admin.yml"
 /mail:
   $ref: "./paths/mail.yml"
+/activity/checkin:
+  $ref: "./paths/activity_checkin.yml"
+/activity/checkout:
+  $ref: "./paths/activity_checkout.yml"
+/activity/checkout/{userId}:
+  $ref: "./paths/activity_checkout_user_id.yml"
+/activity/record/{recordId}:
+  $ref: "./paths/activity_record_record_id.yml"

document/paths/activity_checkin.yml

@@ -0,0 +1,22 @@
+post:
+  tags:
+    - activity
+  description: "Activity checkin"
+  security:
+    - BearerAuth: []
+  requestBody:
+    description: "Activity checkin request"
+    required: true
+    content:
+      application/json:
+        schema:
+          $ref: "../schemas/req_post_activity_checkin.yml"
+  responses:
+    200:
+      $ref: "../responses/blank_success.yml"
+    400:
+      $ref: "../responses/bad_request.yml"
+    403:
+      $ref: "../responses/unauthorized.yml"
+    500:
+      $ref: "../responses/internal_server.yml"

document/paths/activity_checkout.yml

@@ -0,0 +1,24 @@
+post:
+  tags:
+    - activity
+  description: "Activity checkout"
+  security:
+    - BearerAuth: []
+  requestBody:
+    description: "Activity checkout request"
+    required: true
+    content:
+      application/json:
+        schema:
+          $ref: "../schemas/req_post_activity_checkout.yml"
+  responses:
+    200:
+      $ref: "../responses/blank_success.yml"
+    400:
+      $ref: "../responses/bad_request.yml"
+    403:
+      $ref: "../responses/unauthorized.yml"
+    404:
+      $ref: "../responses/not_found.yml"
+    500:
+      $ref: "../responses/internal_server.yml"

document/paths/activity_checkout_user_id.yml

@@ -0,0 +1,30 @@
+post:
+  tags:
+    - activity
+  description: "Admin force activity checkout"
+  security:
+    - BearerAuth: []
+  parameters:
+    - name: userId
+      in: path
+      required: true
+      schema:
+        type: string
+  requestBody:
+    description: "Activity checkout request"
+    required: true
+    content:
+      application/json:
+        schema:
+          $ref: "../schemas/req_post_activity_checkout.yml"
+  responses:
+    200:
+      $ref: "../responses/blank_success.yml"
+    400:
+      $ref: "../responses/bad_request.yml"
+    403:
+      $ref: "../responses/unauthorized.yml"
+    404:
+      $ref: "../responses/not_found.yml"
+    500:
+      $ref: "../responses/internal_server.yml"

document/paths/activity_record_record_id.yml

@@ -0,0 +1,30 @@
+put:
+  tags:
+    - activity
+  description: "Update activity record times"
+  security:
+    - BearerAuth: []
+  parameters:
+    - name: recordId
+      in: path
+      required: true
+      schema:
+        type: string
+  requestBody:
+    description: "Activity record update request"
+    required: true
+    content:
+      application/json:
+        schema:
+          $ref: "../schemas/req_put_activity_record_record_id.yml"
+  responses:
+    200:
+      $ref: "../responses/blank_success.yml"
+    400:
+      $ref: "../responses/bad_request.yml"
+    403:
+      $ref: "../responses/unauthorized.yml"
+    404:
+      $ref: "../responses/not_found.yml"
+    500:
+      $ref: "../responses/internal_server.yml"

document/schemas.yml

@@ -166,6 +166,12 @@ ReqPostMail:
   $ref: "./schemas/req_post_mail.yml"
 ResPostMail:
   $ref: "./schemas/res_post_mail.yml"
+ReqPostActivityCheckin:
+  $ref: "./schemas/req_post_activity_checkin.yml"
+ReqPostActivityCheckout:
+  $ref: "./schemas/req_post_activity_checkout.yml"
+ReqPutActivityRecordRecordId:
+  $ref: "./schemas/req_put_activity_record_record_id.yml"
 
 Error:
   $ref: "./schemas/error.yml"

document/schemas/req_post_activity_checkin.yml

@@ -0,0 +1,10 @@
+required:
+  - place
+properties:
+  place:
+    type: string
+    minLength: 3
+    maxLength: 10
+    x-oapi-codegen-extra-tags:
+      validate: required,min=3,max=10
+      ja: 場所名

document/schemas/req_post_activity_checkout.yml

@@ -0,0 +1,10 @@
+required:
+  - place
+properties:
+  place:
+    type: string
+    minLength: 3
+    maxLength: 10
+    x-oapi-codegen-extra-tags:
+      validate: required,min=3,max=10
+      ja: 場所名

document/schemas/req_put_activity_record_record_id.yml

@@ -0,0 +1,16 @@
+required:
+  - activity_type
+  - time
+properties:
+  activity_type:
+    type: string
+    enum:
+      - checkin
+      - checkout
+    x-oapi-codegen-extra-tags:
+      ja: アクティビティタイプ
+  time:
+    type: string
+    format: date-time
+    x-oapi-codegen-extra-tags:
+      ja: 更新時刻

document/tags.yml

@@ -22,3 +22,5 @@
   description: Mattermost system
 - name: mail
   description: Mail system
+- name: activity
+  description: Activity system