feat: user upsert by email phone username

Author: zzswang

openapi.json

@@ -1,5 +1,5 @@
 {
-  "hash": "8fa4352badf47ee1a3486b4100f2e79f8f7fe294b54379d7af2067b8eef57d41",
+  "hash": "818cd6240b28c9035aeceb5ae18bfc6270cb162b421a3326113b8d1d1a782d29",
   "openapi": "3.0.0",
   "paths": {
     "/hello": {
@@ -778,9 +778,9 @@
         ]
       }
     },
-    "/users/{employeeId}/@upsertUserByEmployee": {
+    "/users/{employeeId}/@upsertUserByEmployeeId": {
       "post": {
-        "operationId": "upsertUserByEmployee",
+        "operationId": "upsertUserByEmployeeId",
         "summary": "",
         "description": "Upsert user by employeeId",
         "parameters": [
@@ -830,6 +830,162 @@
         ]
       }
     },
+    "/users/{username}/@upsertUserByUsername": {
+      "post": {
+        "operationId": "upsertUserByUsername",
+        "summary": "",
+        "description": "Upsert user by username",
+        "parameters": [
+          {
+            "name": "username",
+            "required": true,
+            "in": "path",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateUserDto"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The user upserted.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/User"
+                }
+              }
+            }
+          },
+          "201": {
+            "description": "",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "user"
+        ]
+      }
+    },
+    "/users/{email}/@upsertUserByEmail": {
+      "post": {
+        "operationId": "upsertUserByEmail",
+        "summary": "",
+        "description": "Upsert user by email",
+        "parameters": [
+          {
+            "name": "email",
+            "required": true,
+            "in": "path",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateUserDto"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The user upserted.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/User"
+                }
+              }
+            }
+          },
+          "201": {
+            "description": "",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "user"
+        ]
+      }
+    },
+    "/users/{phone}/@upsertUserByPhone": {
+      "post": {
+        "operationId": "upsertUserByPhone",
+        "summary": "",
+        "description": "Upsert user by phone",
+        "parameters": [
+          {
+            "name": "phone",
+            "required": true,
+            "in": "path",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateUserDto"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The user upserted.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/User"
+                }
+              }
+            }
+          },
+          "201": {
+            "description": "",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "user"
+        ]
+      }
+    },
     "/users/{userId}/@verifyIdentity": {
       "post": {
         "operationId": "verifyIdentity",

src/user/user.controller.ts

@@ -283,13 +283,13 @@ export class UserController {
   /**
    * Upsert user by employeeId
    */
-  @ApiOperation({ operationId: 'upsertUserByEmployee' })
+  @ApiOperation({ operationId: 'upsertUserByEmployeeId' })
   @ApiOkResponse({
     description: 'The user upserted.',
     type: User,
   })
-  @Post(':employeeId/@upsertUserByEmployee')
-  async upsert(
+  @Post(':employeeId/@upsertUserByEmployeeId')
+  async upsertByEmployeeId(
     @Param('employeeId') employeeId: string,
     @Body() dto: CreateUserDto
   ): Promise<UserDocument> {
@@ -379,6 +379,55 @@ export class UserController {
     return this.userService.upsertByEmployee(employeeId, dto);
   }
 
+  /**
+   * Upsert user by username
+   */
+  @ApiOperation({ operationId: 'upsertUserByUsername' })
+  @ApiOkResponse({
+    description: 'The user upserted.',
+    type: User,
+  })
+  @Post(':username/@upsertUserByUsername')
+  async upsertByUsername(
+    @Param('username') username: string,
+    @Body() dto: CreateUserDto
+  ): Promise<UserDocument> {
+    // TODO: 从返回的数据库错误中，解析数据冲突的字段
+    return this.userService.upsertByUsername(username, dto);
+  }
+
+  /**
+   * Upsert user by email
+   */
+  @ApiOperation({ operationId: 'upsertUserByEmail' })
+  @ApiOkResponse({
+    description: 'The user upserted.',
+    type: User,
+  })
+  @Post(':email/@upsertUserByEmail')
+  async upsertByEmail(
+    @Param('email') email: string,
+    @Body() dto: CreateUserDto
+  ): Promise<UserDocument> {
+    return this.userService.upsertByEmail(email, dto);
+  }
+
+  /**
+   * Upsert user by phone
+   */
+  @ApiOperation({ operationId: 'upsertUserByPhone' })
+  @ApiOkResponse({
+    description: 'The user upserted.',
+    type: User,
+  })
+  @Post(':phone/@upsertUserByPhone')
+  async upsertByPhone(
+    @Param('phone') phone: string,
+    @Body() dto: CreateUserDto
+  ): Promise<UserDocument> {
+    return this.userService.upsertByPhone(phone, dto);
+  }
+
   /**
    * Delete user
    */