init

docs/api/v1/admin-auth.md

@@ -0,0 +1,48 @@
+# AdminAuth · 管理员鉴权
+
+JWT (jsonwebtoken)。请求时 Header `Authorization: Bearer <token>`。
+
+## 接口表
+
+| Method | Path | 鉴权 | 说明 |
+|---|---|---|---|
+| POST | `/api/v1/admin/auth/login` | - | 登录 |
+| GET | `/api/v1/admin/auth/me` | ✅ | 当前账号 |
+| POST | `/api/v1/admin/auth/change-password` | ✅ | 修改密码 |
+
+## POST /api/v1/admin/auth/login
+
+**请求体**
+```json
+{ "username": "admin", "password": "Yygh@2026#Admin" }
+```
+
+**响应**
+```json
+{
+  "code": 0,
+  "message": "登录成功",
+  "data": {
+    "token": "eyJhbGc...",
+    "admin": { "id": "u-001", "username": "admin", "nickname": "系统管理员", "role": "super" }
+  }
+}
+```
+
+**错误码**
+- 400 用户名 / 密码必填
+- 401 用户名或密码错误
+- 500 服务器内部错误
+
+## POST /api/v1/admin/auth/change-password
+
+**请求体**
+```json
+{ "oldPassword": "...", "newPassword": "新密码至少 8 位" }
+```
+
+**错误码**
+- 400 原密码 / 新密码必填
+- 400 新密码至少 8 位
+- 400 原密码错误
+- 404 账号不存在