40 lines
5.4 KiB
Markdown
40 lines
5.4 KiB
Markdown
## Why
|
||
|
||
七月迭代的标准评审稿、28 条技术/业务线、已评审 PRD、既有 Tickets、代码完成证据和发布约束目前分散在多个 `.scratch` 目录及提交记录中，已出现“代码已落地但元数据未收口”“后端完成被误认为整体验收完成”和跨 PRD 阻塞仍引用已暂缓审计专项等状态漂移。为在 2026-07-27 前形成可部署到测试环境的唯一剩余实施入口，需要建立一个统一、可勾选且保留来源追溯的 OpenSpec Change。
|
||
|
||
本 Change（功能 ID：`feature-july-iteration-test-release`）不重写既有 PRD，也不实施业务代码；它以已评审标准稿为冲突裁决来源，将既有 PRD 冻结为业务事实来源，并统一状态、依赖、纵向任务、测试环境发布门槛和生产前延期治理项。
|
||
|
||
## What Changes
|
||
|
||
- 建立覆盖 28 条技术/业务线的唯一总台账，逐条记录稳定编号、来源 PRD/Ticket、主/辅助架构通道、具体上游任务、后端状态、前端状态、验证状态和发布状态。
|
||
- 按真实证据预置状态：TECH 七月公共开发基础和 UR55 标记已完成；UR45 标记“后端完成、原 Ticket 元数据待收口”；UR46、UR60、UR86 仅标记后端完成，保留前端与人工验收未完成；其余 22 条线保持未开始。
|
||
- 将已有 Tickets 直接纳入统一执行契约；将 UR33、UR34、UR35、UR42、UR44、UR53、UR57、UR62、UR73、UR97 的冻结 PRD 转换为可独立实施和验证的纵向任务，不再创建新的 `.scratch/issues`。
|
||
- 按三批实施：共享核心与独立 frontier、共享核心下游、复杂业务；最终收口已落地需求的前端契约、测试环境装配、迁移和人工验收准备。
|
||
- 将用户已确认的紧急交付决策写入契约：本里程碑目标是测试环境部署，不是生产验收；不新增 `_test.go`、不运行 `go test`、不执行真实 PostgreSQL/Redis/企微/支付/Gateway 自动验收，仅执行 `gofmt`、必要代码生成、按批次 `go build ./...` 与部署检查。
|
||
- 暂缓全局 Audit Event 专项及其七月发布阻塞边：保留提交 `ff44305` 及既有审计代码、迁移和 Access Log 脱敏，不继续开发审计中心、Audit Event 写入、历史投影或一次性审计发布门禁；生产发布前必须恢复为延期治理项，不得永久标记 N/A。
|
||
- 保留 Integration Log、Outbox、幂等、事务和外部调用恢复能力，它们继续作为业务可靠性设施，不随 Audit Event 暂缓而删除、回滚或绕过。
|
||
- 永久排除已于 2026-07-14 移出本期的需求16；不得创建分销码、代理申请、分销关系、佣金提现相关表、API、页面、领域目录或迁移。
|
||
- 统一接口与工程约束：Fiber、GORM、PostgreSQL、Redis、Asynq、Viper、Zap、sonic；复杂写、简单写、Query 三通道触碰式迁移；统一响应 `{code,msg,data,timestamp}`；错误使用 `pkg/errors`；列表默认 20、最大 100；数据权限、幂等、无外键和文档生成器更新继续遵守项目标准。
|
||
- **BREAKING**：按冻结 PRD 和标准评审稿实施时，退款与平台线下充值将停机切换到企微审批并下线旧本地审批/入账动作接口；系列授权等明确要求同批切换的旧混合命令语义不保留长期兼容层。
|
||
|
||
## Capabilities
|
||
|
||
### New Capabilities
|
||
|
||
- `july-iteration-master-ledger`: 定义 28 条线的唯一稳定编号、来源权威、真实完成状态、具体依赖和需求16排除规则。
|
||
- `july-iteration-delivery-contract`: 定义冻结业务来源、DDD 三通道、API/权限/分页/错误契约、可靠性设施及前后端纵向交付边界。
|
||
- `july-iteration-test-release-gate`: 定义测试环境发布豁免、审计冻结边界、部署与回滚顺序、状态真实性以及生产发布前必须恢复的延期门禁。
|
||
|
||
### Modified Capabilities
|
||
|
||
无。本 Change 不直接改写 `openspec/specs/` 中现有能力规格；七月业务行为以标准评审稿和各冻结 PRD 为来源，由上述三个总控能力约束统一实施与发布。
|
||
|
||
## Impact
|
||
|
||
- **规划与权威关系**：后续七月迭代只从本 Change 的 `tasks.md` 领取剩余工作；原 `.scratch` PRD/Tickets 保留溯源和业务细节，不废弃、不另行扩展。冲突时依次以用户本次确认、七月标准评审稿、冻结 PRD、既有 Ticket 为准。
|
||
- **后端**：后续实施将触及资产、套餐、钱包、订单、退款、充值、企微、通知、导出、Gateway、运营商回调、异步任务、系统配置及相关迁移、API/Worker 组合根；本次提案本身不修改这些业务代码。
|
||
- **前端**：涉及后台管理端、代理端和 C 端 H5/公众号的页面、状态、上传、轮询、审批、支付、导出和人工验收契约；当前仓库无前端源码，只交付框架无关契约与联调清单。
|
||
- **外部系统**：企业微信、微信支付、支付宝、Gateway、运营商回调、对象存储、PostgreSQL、Redis/Asynq；本测试环境里程碑仅完成装配与人工验收准备，真实外部验收延期。
|
||
- **性能与安全**：继续要求 API P95 < 200ms、P99 < 500ms、数据库查询 < 50ms，列表分页、批量查询避免 N+1；Access Log 脱敏继续生效，敏感配置和底层错误不得对外泄露。
|
||
- **文档**：后续每个纵向切片仍需同步中文功能文档、README 索引、OpenAPI 文档生成器及跨仓前端契约；本 Change 作为七月迭代唯一总台账和剩余实施入口。
|