docs(stagepilot): confirm manual ledger batch verification

This commit is contained in:
2026-07-14 19:54:20 +09:00
parent b3447f699e
commit f5636c1ade
5 changed files with 36 additions and 5 deletions
@@ -2,7 +2,7 @@
- Batch ID: BAT-024
- Profile: standard
- Status: implemented
- Status: release-candidate
- Discovery: dcy-012_20260714_manual-ledger-write-api-owner-scoped
- Included REQ: REQ-056
- Folder: docs/batches/bat-024_20260714_manual-ledger-api/
@@ -33,7 +33,7 @@ REQ-056 구현: trex-web이 user/session token으로 자기 소유 portfolio에
- [x] 기존 `/ledger/trades`, `GET /v1/portfolios`, CLI/domain flow 회귀 없음
- [x] baseline docs(`interface-contract`, `runtime-flows`, `data-model`) 갱신
- [x] draft-batch-verification 문서에 AC별 PASS/FAIL evidence 기록
- [ ] independent QC PASS 후 lead `confirm-batch-verification`
- [x] independent QC PASS 후 lead `confirm-batch-verification`
## 비가역 결재 게이트
@@ -45,3 +45,12 @@ REQ-056 구현: trex-web이 user/session token으로 자기 소유 portfolio에
- `QUANTITY_ADJUSTMENT`는 1차 제외.
- `PROFIT`은 신규 manual API 필수 action이며 순입금액 계산에는 포함하지 않는다.
## Verification / Gate Result
- Developer verification: PASS — `594 passed, 12 warnings in 37.24s`.
- Independent QC: PASS — delegation `deleg_f2337a39`, HEAD `b3447f6`, `594 passed, 12 warnings in 37.29s`, focused remediation `4 passed`.
- Lead gate: `confirm-batch-verification` accepted 2026-07-14 KST.
- REQ gate: `confirm-req-implemented` accepted for REQ-056.
- Release note: Production rollout still requires release gate; Alembic migration/runbook for additive `portfolio_ledger` columns remains a release risk to decide before production DB rollout.
@@ -73,6 +73,16 @@ Added regression coverage in `tests/test_v1_portfolios_manual_ledger.py`:
- `test_amount_actions_reject_fee_and_tax_fields`
- `test_reversal_rejects_fee_tax_and_missing_target`
## Independent QC result
- QC delegation: `deleg_f2337a39`
- Target HEAD: `b3447f6`
- Verdict: PASS
- QC compile evidence: `python3 -m compileall app` → `exit_code=0`
- QC full regression: `PYTHONPATH=. uv run python -m pytest -q --override-ini addopts=''` → `594 passed, 12 warnings in 37.29s`
- QC focused remediation tests: admin owner-scope, manual read owner-scope, fee/tax validation, reversal missing target → `4 passed, 1 warning in 0.92s`
- Lead decision: `confirm-batch-verification` PASS accepted.
## Notes / follow-up risks
- The implementation adds additive bootstrap columns via `ensure_schema()` for `portfolio_ledger`: `source`, `target_ledger_entry_id`, `confirmation_evidence`, `actor_user_id`.
+1 -1
View File
@@ -31,4 +31,4 @@
| BAT-021 | standard | release-candidate | REQ-047 | dcy-010 | [bat-021](./bat-021_20260628_req047-step2-integration-and-runbook/) |
| BAT-022 | standard | release-candidate | REQ-052, REQ-053, REQ-054 | dcy-011 | [bat-022](./bat-022_20260628_daemon-crud-self-service-credential-api/) |
| BAT-023 | batch-lite | in-progress | REQ-055 | trex-tvr-v1 dcy-001 | [bat-023](./bat-023_20260704_portfolios-strategy-market-meta/) |
| BAT-024 | standard | in-progress | REQ-056 | dcy-012 | [bat-024](./bat-024_20260714_manual-ledger-api/) |
| BAT-024 | standard | release-candidate | REQ-056 | dcy-012 | [bat-024](./bat-024_20260714_manual-ledger-api/) |