# 项目进度

## 2026-07-29

- 已实现共享 `httpapi`、`httpsecurity` 与 `httpserver`，统一严格 JSON、Problem、
  Request ID、认证、可信代理、Client ID、准入、多监听器生命周期和优雅停机。
- Distribution/Admin Handler 已装配到独立监听器；Gateway 配置认证统一复用
  `httpsecurity`，API 401 与代理 407 语义保持分离。
- 部署配置已使用 `${VAR}` 真实环境变量解析，ConfigMap 与本地配置通过
  `LoadResolved` 回归测试。
- PostgreSQL/Redis Adapter、生产命令入口与代表性 100,000 QPS 集群压测仍待实现。

## 2026-07-28

- 用户删除了先前基于不完整网页内容生成的设计文件。
- 已重新读取当前 `对话内容.md` 全部 9,404 行。
- 已按主题定位配置定稿、实施方案、Distribution API、认证、安全、并发、
  故障语义和最终 Exclusive Extraction 修订。
- 已建立新的任务计划与事实记录，旧网页摘要不再作为需求证据。
- 已建立需求追踪矩阵、统一领域语言、产品设计、总体架构、项目结构、ADR、
  开发、配置、API、安全、测试与运维文档。
- 已提供 20 个严格校验的配置示例、Distribution/Admin OpenAPI、Controller/
  Worker/Checker Protobuf 契约和 35 张 Mermaid 图。
- 已实现并测试 Proxy 状态/TTL/唯一键、打包原子容量、首条路由、Sequential
  并发切换、Fetch 分类、一次性独占提取、严格配置、Snapshot 与本地 Dispatch。
- `go test ./...`、`go vet ./...`、`go build ./...` 通过。
- Protobuf 描述符编译、Compose 静态展开、Kustomize 渲染、Grafana JSON 与
  配置示例校验通过。
- Windows 当前 `CGO_ENABLED=0` 且无 C 编译器，race 测试由 Linux CI 承担。
- 100,000 QPS 仍是未验证设计目标；运行进程、存储适配器、完整网络转发与
  代表性集群压测尚未实施，已在完成审计中明确列出。
- 已生成 `proxy-pool-docs-v1.0.zip`，包含 50 个条目，SHA-256 为
  `A6882B71196210CE3594A10992C2A0A73EA3A1CF31D8A570709CA999133CE104`。
- 已实现 random、roundRobin、weighted、leastConnections，并将 Sequential
  拆成共享 Upstream 空结果状态与每 Routing 版本化游标。
- 已实现 Provider 合并通知、完整 attempt 超时、永久错误契约、指数退避、
  Retry-After、原子 FetchBudget 以及 Pool Reconciler。
- 已强制 Worker 所有权与 Exclusive Extraction 注入同一权威 Repository，
  覆盖 100 轮并发竞争、续期、Drain ACK 和 Worker 过期回收。
- 已实现提取服务层策略映射、幂等审计、来源身份准入和公共 FixedWindow
  全局/Client 限流器。
- 已为 100k Proxy 快照建立 scheme/upstream/tag 索引；本机持续基准中
  `Acquire` 为 640 ns/op、256 B/op、2 allocs/op。该数据仅证明本地选择热路径，
  不代表 100k QPS 集群端到端容量。
- 本轮 `go test -count=1 ./...`、`go vet ./...`、`go build ./...` 和
  `git diff --check` 通过；Windows `CGO_ENABLED=0`，race 仍由 Linux CI 验证。