feat: PLANNING体系首版(00路线图/02任务总表/03执行协议/I-03/I-04/registry42口径)+M1止血交付

This commit is contained in:
2026-09-12 14:25:25 +08:00
commit 39af400fc8
472 changed files with 36277 additions and 0 deletions
@@ -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 完成