genichinandClaude Sonnet 4.6
4bf6b554a7
dcy-003/004 기반 v1 API surface 완성 및 BAT-008~011 구현·검증 완료:
- BAT-008 (REQ-019~021,024): 토큰 surface baseline 문서 갱신
- BAT-009 (REQ-025~028): POST/PATCH/DELETE/GET /v1/portfolios CRUD 신설
- _require_write_token, _get_portfolio_or_404, soft delete, daemon-scoped list
- BAT-010 (REQ-030~032): portfolio tag/comment 서브 라우트 신설 + baseline 갱신
- GET/POST/DELETE /v1/portfolios/{id}/tags
- POST/GET/PATCH/DELETE /v1/portfolios/{id}/comments
- BAT-011 (REQ-029): ledger path migration
- POST /v1/assets/{asset_id}/ledger/trades → /v1/portfolios/{portfolio_id}/ledger/trades
- v1_ledger.py 제거, disabled 차단(409) 추가
- test_v1.py / test_daemon_assignment.py 구 path 갱신
- 신규 tests: test_v1_portfolios_crud.py, test_v1_portfolios_list.py,
test_v1_portfolios_tags_comments.py, test_v1_portfolios_ledger.py
- 전체 suite: 340 passed
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
120 lines
5.2 KiB
Markdown
120 lines
5.2 KiB
Markdown
# REQ-020: 토큰 발급 권한 매트릭스 정의
|
||
|
||
- Status: Implemented
|
||
- Type: Documentation
|
||
- Priority: Medium
|
||
- Owner: Justin Ko
|
||
|
||
## Intent
|
||
- 누가 어떤 token type을 발급/회전/폐기할 수 있는가가 현재 코드에 흩어진 dependency(require_admin/require_read)로만 표현되고 baseline 문서에 없어 운영 일관성과 정책 추적이 어렵다. 토큰 발급 권한 매트릭스를 baseline에 명시해 정책 source of truth를 확보한다.
|
||
|
||
## Requirement
|
||
- `docs/interface-contract.md`에 "토큰 발급 권한 매트릭스" 섹션을 추가한다. 매트릭스 차원: token type(session / service / env) × 발급 동사(issue / rotate / rebind / revoke / list) × 발급자 권한(admin / trade-write / read).
|
||
- client token은 REQ-016에서 폐지되므로 표에서 제거한다.
|
||
- admin 자기 발급 정책 명시: admin이 본인 user_id 대상으로 daemon-bound 또는 unbound service token 발급 가능(dcy-004 OQ-4 결정). 매트릭스 주석에 "관행상 최소 권한 발급 권장" 명시.
|
||
- 매트릭스 위반 호출은 HTTP 403 fail-closed로 통일한다(dcy-004 NFR-4).
|
||
- 매트릭스 정의는 현행 코드 dependency(require_admin/require_read, AuthService 발급 메서드의 분기 로직)와 1:1 매핑되어야 한다. 불일치 시 본 REQ가 우선이며 코드 보정은 REQ-018 또는 별도 후속에서 처리.
|
||
|
||
## Acceptance Criteria
|
||
1. Given `docs/interface-contract.md` 검토, When 본 REQ 구현 후, Then "토큰 발급 권한 매트릭스" 섹션이 존재하고 token type 3종(session/service/env) × 발급 동사 5종(issue/rotate/rebind/revoke/list) × 발급자 권한 3종(admin/trade-write/read) 조합이 모두 명시된다.
|
||
2. Given 매트릭스의 admin 자기 발급 정책 항목, When 본 REQ 구현 후 검토, Then admin이 본인 user_id로 service token 발급 가능함이 명시되고 최소 권한 권장 주석이 포함된다.
|
||
3. Given 매트릭스 위반 호출 정책, When 본 REQ 구현 후 검토, Then 모든 위반 호출에 HTTP 403 fail-closed 응답이 명시된다.
|
||
4. Given 매트릭스와 현행 코드 dependency(`require_admin`/`require_read`) 매핑, When 사람 리뷰, Then 1:1 매핑이 확인되고 불일치 항목은 별도 follow-up으로 기록된다.
|
||
|
||
## Impacted Area
|
||
- Docs:
|
||
- `docs/interface-contract.md` — "토큰 발급 권한 매트릭스" 섹션 신규 추가
|
||
- Modules: 없음 (문서 전용. 코드 dependency 불일치 발견 시 별도 REQ 또는 REQ-018 보강)
|
||
- Tests: 없음 (문서 전용. NFR-4 위반 호출 403 검증은 REQ-016/018/022 등 코드 REQ의 회귀 테스트에 포함)
|
||
|
||
## Notes
|
||
- 본 REQ는 매트릭스 baseline 문서화만 다룬다. 매트릭스 위반 호출의 코드 레벨 enforcement는 기존 dependency 체계로 충분하며 본 REQ에서는 정책 정의만 한다.
|
||
- env admin token의 회전 주기·강도 가이드는 REQ-024(env admin SOP)가 별도로 다룬다. 본 REQ는 발급 권한 매트릭스에만 집중한다.
|
||
- Source: dcy-004 FR-5, dcy-004 NFR-4, dcy-004 OQ-4 결정.
|
||
|
||
## Change Log
|
||
|
||
### CHG-20260521-01
|
||
- Date: 2026-05-21
|
||
- Author: Justin Ko
|
||
|
||
#### Change Summary
|
||
- Status: Approved → Implemented
|
||
|
||
#### Intent
|
||
- BAT-008 confirm-batch-verification 완료: AC-1~4 모두 검증됨(grep + 사람 리뷰). docs/interface-contract.md에 "Token Issuance Authorization Matrix" 섹션 신규 추가 확인.
|
||
|
||
#### Acceptance Criteria Delta
|
||
- No change
|
||
|
||
#### Impacted Area Delta
|
||
- No change
|
||
|
||
#### Delivery Trace Delta
|
||
- Batches: BAT-008 (release-candidate)
|
||
- Releases: none (미정)
|
||
|
||
#### Revalidation Impact
|
||
- Reverification Needed: no
|
||
- Existing Implementation Invalidated: no
|
||
- Status Recommendation: promote-to-implemented
|
||
- Follow-up Action: 없음
|
||
|
||
### CHG-20260520-02
|
||
- Date: 2026-05-20
|
||
- Author: Justin Ko
|
||
|
||
#### Change Summary
|
||
- Status: Proposed → Approved
|
||
|
||
#### Intent
|
||
- 승인 게이트 통과: 필수 필드(Status/Type/Priority/Owner/Intent/Requirement/AC/Impacted Area/Change Log) 모두 충족, AC 구체성 확인 완료, blocker 없음
|
||
|
||
#### Acceptance Criteria Delta
|
||
- No change
|
||
|
||
#### Impacted Area Delta
|
||
- No change
|
||
|
||
#### Delivery Trace Delta
|
||
- Batches: none (미정)
|
||
- Releases: none (미정)
|
||
|
||
#### Revalidation Impact
|
||
- Reverification Needed: no
|
||
- Existing Implementation Invalidated: no
|
||
- Status Recommendation: promote-to-approved
|
||
- Follow-up Action: batch 계획 편입
|
||
|
||
### CHG-20260520-01
|
||
- Date: 2026-05-20
|
||
- Author: Justin Ko
|
||
|
||
#### Change Summary
|
||
- 최초 생성 — dcy-004 confirm-discovery 후 draft-req 실행. dcy-004 FR-5 산출물.
|
||
|
||
#### Intent
|
||
- 토큰 발급 권한 정책 source of truth 확보 + admin 자기 발급 허용 정책 baseline 명시.
|
||
|
||
#### Acceptance Criteria Delta
|
||
- Added:
|
||
- AC-1~4 최초 작성
|
||
|
||
#### Impacted Area Delta
|
||
- Docs: docs/interface-contract.md — 최초 지정
|
||
- Modules: 없음
|
||
- Tests: 없음
|
||
|
||
#### Delivery Trace Delta
|
||
- Batches: none (미정)
|
||
- Releases: none (미정)
|
||
|
||
#### Revalidation Impact
|
||
- Reverification Needed: no
|
||
- Existing Implementation Invalidated: no
|
||
- Status Recommendation: keep-current
|
||
- Follow-up Action: confirm-req 후 batch 계획 편입; REQ-019 baseline 정합 작업과 동일 batch 권장
|
||
|
||
#### Validation Plan
|
||
- 사람 리뷰로 AC-1~4 검증; 매트릭스-코드 dependency 매핑 사전 검토
|