46 lines
1.8 KiB
Markdown
46 lines
1.8 KiB
Markdown
# Proxy Pool 项目交付计划
|
||
|
||
## 目标
|
||
|
||
以 `对话内容.md` 的 9404 行完整讨论为唯一需求基线，交付设计文案、
|
||
开发文档和可编译、可测试、可扩展的 Go 项目架构。
|
||
|
||
## 需求覆盖原则
|
||
|
||
- 同一主题存在多轮修订时，以文件中最后出现的明确结论为准。
|
||
- 用户补充的集群峰值为 100,000 QPS，覆盖文档早期 10,000 并发示例。
|
||
- Extract API 固定采用一次性独占发放；早期 Lease/Release 设计作废。
|
||
- 不保留空实现、TBD、TODO 或没有接口契约的占位目录。
|
||
|
||
## 阶段
|
||
|
||
1. [已完成] 完整读取对话并识别覆盖关系
|
||
2. [进行中] 建立需求追踪矩阵与统一领域模型
|
||
3. [待开始] 编写总体设计、详细设计和 ADR
|
||
4. [待开始] 编写开发、配置、API、测试和运维文档
|
||
5. [待开始] 搭建 Go 模块、命令、核心包、契约和部署目录
|
||
6. [待开始] 实现核心状态机、路由、容量、提取与配置校验
|
||
7. [待开始] 执行单元测试、竞态检查、静态检查和构建
|
||
8. [待开始] 按需求矩阵逐项审计并打包交付
|
||
|
||
## 串并行关系
|
||
|
||
```text
|
||
全文解析 ─> 需求矩阵 ─> 统一设计 ─┬─> 设计/开发文档 ─┐
|
||
├─> API/配置契约 ───┼─> 集成验证
|
||
└─> Go 项目架构 ────┘
|
||
```
|
||
|
||
## 测试约束
|
||
|
||
- 单条后台测试命令最长运行 60 秒。
|
||
- 核心并发代码必须执行 `go test -race`。
|
||
- 100k QPS 只能由可复现的集群压测结果证明，架构文档不得把设计容量
|
||
写成已验证性能。
|
||
|
||
## 已知环境限制
|
||
|
||
- Docker CLI 已安装，但 Linux daemon 状态需在集成验证前再次确认。
|
||
- 当前仓库尚无提交；`对话内容.md` 和 `.gitignore` 为现有文件。
|
||
|