[feature/backend] implement /users handler + switch to username + add display name + user management cli

api/schemas/paths/auth.yaml

@@ -1,3 +1,63 @@
+register:
+  post:
+    tags:
+      - auth
+    summary: 用户注册
+    operationId: register
+    security: []  # 注册接口不需要认证
+    requestBody:
+      required: true
+      content:
+        application/json:
+          schema:
+            type: object
+            required:
+              - username
+              - email
+              - password
+              - role
+            properties:
+              username:
+                type: string
+                minLength: 3
+                maxLength: 32
+              email:
+                type: string
+                format: email
+              password:
+                type: string
+                format: password
+                minLength: 8
+              role:
+                type: string
+                enum:
+                  - admin
+                  - editor
+                  - contributor
+    responses:
+      '200':
+        description: 注册成功
+        content:
+          application/json:
+            schema:
+              type: object
+              required:
+                - token
+                - user
+              properties:
+                token:
+                  type: string
+                user:
+                  $ref: '../components/schemas.yaml#/User'
+      '400':
+        description: 用户名已存在
+        content:
+          application/json:
+            schema:
+              $ref: '../components/schemas.yaml#/Error'
+      '422':
+        $ref: '../components/responses.yaml#/ValidationError'
+
 login:
   post:
     tags:
@@ -12,12 +72,13 @@ login:
           schema:
             type: object
             required:
-              - email
+              - username
               - password
             properties:
-              email:
+              username:
                 type: string
-                format: email
+                minLength: 3
+                maxLength: 32
               password:
                 type: string
                 format: password