Files
word-market/openspec/specs/admin-auth/spec.md
T
voidandClaude Sonnet 4.6 dd928a9513 chore(openspec): 归档 add-admin-console
- 将变更移动到 changes/archive/2026-11-08-add-admin-console
- 同步 7 个能力、37 条需求到 openspec/specs/
- openspec validate --all 全部通过

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-11-08 23:00:53 +08:00

2.1 KiB

admin-auth Specification

Purpose

保护只读管理后台的访问入口,确保只有持有有效凭据的管理员才能查看词库数据,并在会话失效时要求重新登录。

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 并返回登录页