# 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 起点基线：

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

当前 coverage summary：

```text
233	147	86	0	0	0
```

当前 Account 状态：

```text
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` 语义、同一路径测试要求，以及本轮只改三份文档。

## 已执行检查

已执行并通过：

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

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

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

protected 路径未修改：

```text
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。