oh-my-muse/docs/archive/2026-06-14-P1RAccountStageA收敛进度.md

P1R Account Stage A 收敛进度

日期：2026-06-14

结论

本轮已把 Account 剩余 21 个 operation 的解锁路线收敛到文档层，并新增 Stage A New-API / quota / integration 执行版。

本轮没有进入 implementation，没有推进任何 operation completed，没有修改 OpenAPI、scanner、coverage report、业务实现、SQL migration 或测试代码。

当前仍不能直接开始 Stage A implementation；final review 已收口，下一步必须由用户明确批准 implementation。

当前基线

本轮 final review 起点基线：

main...origin/main
HEAD=862fe9e docs(p1r): 收敛 Account Stage A 解锁计划
origin/main=862fe9e
origin/dev/1.0.0=862fe9e

当前 coverage summary：

233	147	86	0	0	0

当前 Account 状态：

33 total / 12 completed / 21 needs_verification

本轮新增或更新

新增：

• docs/agent-specs/2026-06-14-P1RAccountRemaining21解锁审阅版.md
• docs/agent-specs/2026-06-14-P1RAccountRemaining21解锁执行版.md
• docs/agent-specs/2026-06-14-P1RAccountStageA-NewAPIQuotaIntegration解锁执行版.md
• docs/memorys/2026-06-14-P1RAccountStageA收敛进度.md

更新：

• docs/agent-specs/.agent

Review 状态

已通过：

• Account Remaining21 审阅版 fresh 双 review PASS。
• Account Remaining21 执行版 final fresh review PASS。
• Stage A 执行版 scope review PASS。
• Stage A 执行版 scope final re-check PASS。
• Stage A 执行版 feasibility/testing final re-check PASS。

已修并收口：

• Stage A 执行版 feasibility/testing review 第一轮 FAIL，已修。
• Stage A 执行版 feasibility/testing re-review 第二轮 FAIL，3 个 P1 已按收敛要求修订。
• Stage A 执行版 feasibility/testing final review 第三轮 FAIL，2 个 P1 与 1 个 P2 已按收敛要求修订。
• Stage A 执行版 feasibility/testing final re-check 第四轮 FAIL，1 个 P1 已按收敛要求修订。

因此 Stage A 执行版目前是“final review 已收口，可进入用户批准后的 Stage A implementation 准备”，但仍不是 implementation approved，也不是 completed approval。

Stage A 当前边界

Stage A 只覆盖 9 个 operation：

• account:adminListNewApiBindings
• account:adminCreateNewApiBinding
• account:getAppNewApiBinding
• account:appRecheckNewApiBinding
• account:adminCreateQuotaRequest
• account:appCreateQuotaRequest
• account:appGetQuotaRequest
• account:adminGetIntegrationCallByCorrelation
• account:appGetIntegrationCallByCorrelation

Stage A 执行版已固定：

• A0：NewApiAccountFacade fallback 从 @Component 改为 auto-configuration + @ConditionalOnMissingBean 的后续实现方向。
• A1：必须先查证 New-API Account 管理端点合同；查不到不能实现真实 HTTP adapter。
• A2：binding runtime adapter 只有 A1 通过后才允许实现。
• A3：quota submit worker 默认不新增 SQL migration，复用 muse_account_integration_call.retry_count/next_retry_at/status/errorCode/errorMessage 承载 retry / lease / dead-letter。
• A4：HTTP+DB _test 只证明 Muse Account 侧真实入口和本地闭环；test-local facade 不能作为外部 New-API completed 证据。

已修 review 问题

Hypatia 反馈已修：

• _test 命令不得通过 -Dp1r.*password 传密码，改为环境变量读取，并要求 IT 拒绝 password system property。
• diff gate 必须覆盖 tracked、cached、untracked，并使用 git -c core.quotePath=false 避免中文路径转义误判。
• coverage check 必须在 repo root 运行；Maven 命令补 -am。

Meitner 反馈已修：

• runtime unavailable 与全表 no-write 分场景表达：参数校验、幂等冲突、越权、cross tenant、missing resource 全表 no-write；runtime unavailable 允许 failed integration call allowed-delta。
• quota worker claim/retry/事务边界已固定为不新增 SQL 的默认方案。
• Stage A 与 Remaining21 Maven 模板补 -Dsurefire.failIfNoSpecifiedTests=false。

Huygens 反馈已修：

• quota worker 已进一步冻结为短事务模型：claimNext 独立事务、外部 New-API submit 不在数据库事务内、finalizeSuccess / finalizeFailure / finalizeRetryable 独立事务，并补 double-claim、runtime unavailable allowed-delta、finalize conflict、lease 恢复、maxAttempts terminal failed 测试要求。
• Stage A 两条 member Maven 命令已补 -am。
• Stage A 执行版与本 memory 的基线提交号已更新为 862fe9e。

Sagan 反馈已修：

• quota worker retry / lease 恢复路径已冻结为唯一状态合同：初次 claim 从 queued 进入 processing；runtime unavailable / timeout / 外部 5xx 的 finalizeRetryable 必须保持 quota request 为 processing 并只推进 integration call retry_count/next_retry_at/errorCode/errorMessage；下一轮 claim 只允许 processing + next_retry_at <= now 的恢复路径，不再允许实现者自行选择回写 queued。

Volta final re-check 结论：

• Feasibility/testing final re-check PASS，无 P0/P1/P2 findings。
• 已确认唯一状态路径、finalizeRetryable 语义、同一路径测试要求，以及本轮只改三份文档。

已执行检查

已执行并通过：

git diff --check
jq -r '.summary | [.totalOperations,.completedOperations,.needsVerificationOperations,.incompleteOperations,.genericPersistenceOperations,.ssePlaceholderOperations] | @tsv' docs/superpowers/reports/p1r-api-coverage.json

doc-only diff gate 已通过，当前变更只在：

docs/agent-specs/
docs/memorys/2026-06-14-P1RAccountStageA收敛进度.md

protected 路径未修改：

docs/api-contracts/**
muse-cloud/scripts/p1r-audit-api-coverage.py
docs/superpowers/reports/**
muse-cloud/muse-module-member/muse-module-member-server/src/main/java/**
muse-cloud/muse-module-member/muse-module-member-server/src/test/java/**
muse-cloud/muse-server/src/test/java/**
muse-cloud/sql/muse/**

下一步

如果继续 Stage A：

1. 等用户明确批准 Stage A implementation。
2. implementation 先做 A0 facade 装配硬化。
3. A1 查证 New-API Account 管理端点；查不到则停止，不实现伪造 HTTP adapter。
4. A1 查证成功后再继续 A2/A3/A4。
5. Stage A implementation fresh 双 review PASS 后，另起 operation-level completed approval。