feat: create user api

API.md

@@ -500,6 +500,7 @@ Base 前缀 `/api/v1/admin`。
 | 方法 | 路径 | 说明 |
 |---|---|---|
 | `GET` | `/api/v1/platform/employees` | 列全平台未软删员工;包含停用、锁定及无平台角色用户 |
+| `POST` | `/api/v1/platform/employees` | 创建平台员工账号(返回 201);不自动加入任何 workspace |
 | `GET` | `/api/v1/platform/workspaces` | 列 workspace(`active`/`archived`);已软删的过滤掉 |
 | `POST` | `/api/v1/platform/workspaces` | 创建 workspace(返回 201);创建者自动成为 admin 成员 |
 | `GET` | `/api/v1/platform/workspaces/{workspace_id}` | 单个 workspace(含已 disabled 的,用于恢复) |
@@ -596,7 +597,8 @@ Base 前缀 `/api/v1/admin`。
 | `role_code` | string | 是 | `admin` \| `developer` | **不可填 `system_admin`**(那是用户级身份,不是 workspace 角色) |
 
 - 服务端默认 `member_status='active'`。
-- 用户不存在 → 404;用户已是该 workspace 成员 → 409。
+- 用户不存在或已软删除 → 404;用户状态不是 `active` → 409;用户已是该 workspace 成员 → 409。
+- 新员工必须先通过 `POST /api/v1/platform/employees` 或现有 workspace 员工创建接口建立用户账号。
 
 ### 7.6 `PATCH /api/v1/platform/workspaces/{workspace_id}/members/{user_id}`
 
@@ -647,6 +649,26 @@ Base 前缀 `/api/v1/admin`。
   }
   ```
 
+### 7.9 `POST /api/v1/platform/employees`
+
+只创建平台员工账号,不创建任何 `workspace_members` 记录。调用者必须是系统管理员;已认证但不是系统管理员时返回 `403`。
+
+- **请求体字段**:
+
+| 字段 | 类型 | 必填 | 限制 | 说明 |
+|---|---|---|---|---|
+| `username` | string | 是 | 2~64 字符 | 全平台唯一登录名 |
+| `display_name` | string | 是 | 1~100 字符 | 显示名称 |
+| `email` | string | 否 | ≤255 字符 | 邮箱,全平台唯一 |
+| `password` | string | 是 | 8~72 字符 | 登录密码 |
+
+- 新用户状态固定为 `active`,且不分配平台角色。
+- 密码使用 bcrypt 哈希保存;响应不包含 `password` 或 `password_hash`。
+- 用户名或邮箱重复 → 409。
+- 创建成功后,可调用 `POST /api/v1/platform/workspaces/{workspace_id}/members` 将用户加入指定 workspace。
+
+- **响应 201**:字段与 §7.8 的员工元素一致,其中 `role_code`、`role_name` 均为 `null`,`meta` 为空对象。
+
 ---
 
 ## 八、Jupyter 路由