Documents/proto/general/openapi.yaml

@@ -35,8 +35,7 @@ paths:
           name: type
           required: false 
           schema:
-            type: string
+            $ref: '#components/schemas/Roles'
-            enum: [teacher, student, secretary]
       responses: 
         '200':
           description: OK
@@ -89,6 +88,8 @@ paths:
                 BirthDate:
                   type: string
                   description: Follow the iso 8601 ("YYYY-MM-DD")
+                Role:
+                  $ref: "#/components/schemas/Roles"
               example:
                 {
                 "LastName": "Doe" ,
@@ -98,6 +99,7 @@ paths:
                   "Address": "Rue de Tournais 42",
                   "Country": "BE"},
                 "BirthDate": "1941-02-22",
+                "Role": "student"
                 }
       responses:
         '201':
@@ -244,7 +246,8 @@ paths:
                 faculty:
                   type: string
                 teachers:
-                  $ref: '#/components/schemas/User'
+                  type: integer
+                  description: Teacher's identifier
                 assistants:
                   type: array
                   items:
@@ -800,6 +803,8 @@ components:
         birthDate:
           type: string
           description: Follow the iso 8601 ("YYYY-MM-DD")
+        role:
+          $ref: '#/components/schemas/Roles'
       example:
         {
         "regNo": 42,
@@ -810,7 +815,7 @@ components:
           "address": "Rue de Tournais 42",
           "country": "BE"},
         "birthDate": "1941-02-22",
-        "staffMember": true,
+        "role": "student"
         }
     Address:
       type: object
@@ -869,6 +874,9 @@ components:
         "id": 42,
         "courses": ['Math', 'Info']
         }
+    Roles:
+      type: string
+      enum: [teacher, student, secretary]
     Article:
       type: object
       properties: