feat(admin): 实现只读词库管理后台
- 新增 Spring Boot 3 后端:JWT 认证、六个业务模块查询接口、Caffeine 聚合缓存与只读事务约束 - 新增 Vue 3 管理前端:登录、概览、词书、词条、词根词族、近反义词与数据质量 - 补充前后端 README、环境变量示例与本地构建部署说明 - 同步 OpenSpec 变更文档与任务进度(64/65,只读数据库账号待确认) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
1 parent
131c2b6353
commit
4e68ba3890
137 files changed
+15423
-10
No files matched your search
@@ -0,0 +1,62 @@
|
||||
## Purpose
|
||||
|
||||
保护只读管理后台的访问入口,确保只有持有有效凭据的管理员才能查看词库数据。
|
||||
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: 管理员登录
|
||||
|
||||
系统 SHALL 提供登录接口,校验单一管理员账号与密码;凭据必须来自外部配置(环境变量),不得硬编码在代码或仓库中。校验成功后签发 JWT,失败时返回统一错误结构。
|
||||
|
||||
#### Scenario: 凭据正确
|
||||
|
||||
- **WHEN** 管理员提交正确的用户名和密码
|
||||
- **THEN** 系统返回 JWT 和过期时间,前端进入后台首页
|
||||
|
||||
#### Scenario: 凭据错误
|
||||
|
||||
- **WHEN** 管理员提交错误的用户名或密码
|
||||
- **THEN** 系统返回 401,且不返回任何 token 或账号信息
|
||||
|
||||
#### Scenario: 请求缺字段
|
||||
|
||||
- **WHEN** 登录请求缺少用户名或密码
|
||||
- **THEN** 系统返回 400,并说明缺少的字段
|
||||
|
||||
#### Scenario: 启动时缺少管理员配置
|
||||
|
||||
- **WHEN** 应用启动时未提供管理员账号或密码哈希
|
||||
- **THEN** 应用拒绝启动并输出明确的配置缺失错误
|
||||
|
||||
### Requirement: 受保护接口鉴权
|
||||
|
||||
除登录接口外,所有业务接口 MUST 要求携带有效 JWT。无效、过期或缺失 token 的请求 SHALL 被拒绝,不得返回业务数据。
|
||||
|
||||
#### Scenario: 未携带 token
|
||||
|
||||
- **WHEN** 请求受保护接口时未提供 Authorization 头
|
||||
- **THEN** 系统返回 401
|
||||
|
||||
#### Scenario: token 无效或过期
|
||||
|
||||
- **WHEN** 请求携带格式错误、签名不匹配或已过期的 token
|
||||
- **THEN** 系统返回 401,且不返回业务数据
|
||||
|
||||
#### Scenario: token 有效
|
||||
|
||||
- **WHEN** 请求携带有效 token
|
||||
- **THEN** 系统正常返回业务数据
|
||||
|
||||
### Requirement: 前端会话处理
|
||||
|
||||
前端 SHALL 在本地保存登录状态;收到 401 时必须清除登录状态并跳转登录页,不得停留在空白或报错页面。
|
||||
|
||||
#### Scenario: token 过期
|
||||
|
||||
- **WHEN** 任意页面请求返回 401
|
||||
- **THEN** 前端清除本地 token 并跳转登录页
|
||||
|
||||
#### Scenario: 主动退出
|
||||
|
||||
- **WHEN** 管理员点击退出
|
||||
- **THEN** 前端清除本地 token 并返回登录页
|
||||
Reference in new issue
Block a user