feat: PLANNING体系首版(00路线图/02任务总表/03执行协议/I-03/I-04/registry42口径)+M1止血交付
This commit is contained in:
@@ -0,0 +1,10 @@
|
||||
# Checklist
|
||||
|
||||
- [x] 滑块验证码组件成功导入到 ApiDetail 页面
|
||||
- [x] 未验证时显示验证码遮罩,隐藏页面核心内容
|
||||
- [x] 验证成功后隐藏遮罩,展示完整内容
|
||||
- [x] 验证失败时允许重试(最多3次)
|
||||
- [x] 超过最大重试次数后显示手动刷新按钮
|
||||
- [x] Token 过期自动刷新验证码
|
||||
- [x] 暗色模式下验证码组件和遮罩样式正确适配
|
||||
- [x] 页面加载性能无明显影响
|
||||
@@ -0,0 +1,66 @@
|
||||
# API详情页滑块验证码 Spec
|
||||
|
||||
## Why
|
||||
当前API详情页(ApiDetail)直接展示接口调用信息和测试工具,缺乏访问控制。为防止恶意抓取和未授权访问接口测试功能,需要在页面访问时增加滑块验证码验证,验证通过后才展示完整内容。
|
||||
|
||||
## What Changes
|
||||
- 在ApiDetail页面集成SliderCaptcha组件
|
||||
- 验证通过前隐藏接口详情、参数说明、测试工具等敏感内容
|
||||
- 验证通过后展示完整页面内容
|
||||
- 支持重试次数限制和Token过期自动刷新
|
||||
- 暗色模式适配
|
||||
|
||||
## Impact
|
||||
- Affected specs: API接口大全详情页
|
||||
- Affected code:
|
||||
- `src/pages/ApiDetail/ApiDetail.tsx` - 集成滑块验证码
|
||||
- `src/pages/ApiDetail/ApiDetail.css` - 添加验证遮罩样式
|
||||
- `src/components/SliderCaptcha/SliderCaptcha.tsx` - 复用现有组件
|
||||
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: API详情页滑块验证码
|
||||
系统SHALL在用户访问API详情页时要求进行滑块验证码验证。
|
||||
|
||||
#### Scenario: 首次访问页面
|
||||
- **WHEN** 用户打开API详情页
|
||||
- **THEN** 显示滑块验证码遮罩,隐藏页面核心内容
|
||||
- **AND** 用户完成滑块验证后展示完整内容
|
||||
|
||||
#### Scenario: 验证成功
|
||||
- **WHEN** 用户成功完成滑块验证
|
||||
- **THEN** 隐藏验证码遮罩,展示API详情内容
|
||||
- **AND** 显示验证成功状态(绿色勾选图标)
|
||||
|
||||
#### Scenario: 验证失败
|
||||
- **WHEN** 用户验证失败
|
||||
- **AND** 显示失败状态,自动刷新验证码
|
||||
- **AND** 允许用户重试(最多3次)
|
||||
|
||||
#### Scenario: 超过最大重试次数
|
||||
- **WHEN** 用户连续失败超过最大重试次数
|
||||
- **AND** 显示操作按钮让用户手动刷新
|
||||
|
||||
### Requirement: 内容保护
|
||||
验证通过前SHALL隐藏接口敏感信息。
|
||||
|
||||
#### Scenario: 未验证状态
|
||||
- **WHEN** 用户未完成滑块验证
|
||||
- **THEN** 隐藏接口参数、响应示例、测试工具等内容
|
||||
- **AND** 显示验证码组件
|
||||
|
||||
### Requirement: 暗色模式支持
|
||||
滑块验证码组件SHALL支持暗色模式。
|
||||
|
||||
#### Scenario: 暗色模式
|
||||
- **WHEN** 用户切换到暗色模式
|
||||
- **AND** 验证码组件和遮罩适配暗色主题
|
||||
|
||||
## MODIFIED Requirements
|
||||
|
||||
### Requirement: ApiDetail页面
|
||||
现有ApiDetail页面SHALL集成滑块验证码保护。
|
||||
|
||||
#### Scenario: 页面加载
|
||||
- **WHEN** 页面加载
|
||||
- **AND** 默认显示验证状态,验证通过后才渲染完整内容
|
||||
@@ -0,0 +1,21 @@
|
||||
# Tasks
|
||||
|
||||
- [x] Task 1: 集成滑块验证码到ApiDetail页面
|
||||
- [x] SubTask 1.1: 导入 SliderCaptcha 组件
|
||||
- [x] SubTask 1.2: 添加验证状态管理(verified state)
|
||||
- [x] SubTask 1.3: 实现验证成功/失败回调
|
||||
- [x] SubTask 1.4: 根据验证状态条件渲染内容
|
||||
|
||||
- [x] Task 2: 添加验证码遮罩样式
|
||||
- [x] SubTask 2.1: 添加遮罩容器样式
|
||||
- [x] SubTask 2.2: 添加暗色模式适配样式
|
||||
- [x] SubTask 2.3: 添加验证成功动画效果
|
||||
|
||||
- [x] Task 3: 功能验证
|
||||
- [x] SubTask 3.1: 验证未验证时内容隐藏
|
||||
- [x] SubTask 3.2: 验证成功后内容展示
|
||||
- [x] SubTask 3.3: 验证暗色模式切换正常
|
||||
|
||||
# Task Dependencies
|
||||
- Task 2 可以在 Task 1 进行中并行执行
|
||||
- Task 3 依赖 Task 1 和 Task 2 完成
|
||||
Reference in New Issue
Block a user