---
name: 2026-04-25 가희 명의 2계좌 추가 + owner 블록 도입
description: 관리자님이 가희 명의 키움 일반/ISA 계좌 2개를 레이 관리 범위에 추가. 라벨 `가희_일반`/`가희_ISA`. 리포트는 owner 그룹(본인/가희) 블록 형태로 전환.
type: project
---

## 변경 사항

- `credentials/kiwoom.json`에 가희 명의 키움 계좌 2개 자격증명 추가:
  - `가희_일반`, `가희_ISA` (각각 별도 AppKey/SecretKey, 토큰 캐시 분리 저장)
- 검증: 토큰 발급 + 잔고 조회 정상
  - 가희_일반 예수금 769,717원 · 대용금 2,111,460원
  - 가희_ISA 예수금 2,325,223원 · 대용금 5,940,300원
- `stock_portfolio_report.py` 리팩토링: 라벨 prefix로 owner 그룹 자동 도출 (`_` 없으면 본인, `가희_*`은 가희). 기본 표시는 **본인 블록 + 가희 블록** (그룹 내에서만 종목 합산, 본인↔가희 자금은 절대 합산 안 함). `--by-account`는 owner 블록 안에서 4계좌 분리.
- `state/portfolio_daily_snapshot.json` 포맷이 owner 중첩 구조로 전환. legacy flat(2026-04-24 이전)은 자동으로 본인 그룹으로 승격.
- 텔레그램 요약: owner별 합계 + 전체 합계 + 당일 매매에 owner/계좌 태그.

## 운영 영향

- **본인 + 가희 합산 평가금액 약 127M원** (당일 시점). 본인 ~114.5M / 가희 ~12.5M.
- 가희 그룹은 첫 영업일이라 day-diff 생략. 월요일 20:10 launchd 본 실행 이후부터 전날대비 표시 시작.
- 가희 명의 자금은 본인 자금과 회계상 분리 — 보고·제안 시 항상 자금 주체 명시. 합산 표현은 텔레그램의 "전체 합계" 라인 외에는 지양.

## 컨벤션

- 신규 가족·계좌 추가 시 `<이름>_<상품>` 라벨 패턴 유지 (그래야 owner 그룹 prefix 분기가 자동 동작). 예: `어머니_일반`, `자녀_ISA`.
- portfolio.json (참고용 스냅샷)에는 아직 가희 섹션을 비워둔 상태. 실시간 리포트는 REST ground truth라 영향 없음.

## 매매 절대 원칙

가희 명의 계좌도 동일하게 조회 전용. 가희 계좌의 매수·매도 함수도 절대 추가하지 않음. 워치리스트·목표가 도달 등 트리거 시에도 텔레그램 알림까지가 한계 — 영웅문에서 가희 본인 또는 관리자님이 직접 실행.