✍️ 필사 모드: 파이낸스: ISA IRP ETF 자동화 워크플로우 2026

"""ISA 계좌와 일반 계좌의 세후 수익 비교."""


def compare_tax_effect(
    investment: int,
    annual_return: float,
    years: int,
    isa_type: str = "general",  # "general" or "disadvantaged"
) -> dict:
    """ISA와 일반 계좌의 세후 수익을 비교한다.

    Args:
        investment: 연간 투자금 (원)
        annual_return: 연간 수익률 (예: 0.08)
        years: 투자 기간 (년)
        isa_type: ISA 유형 ("general": 일반형/중개형, "disadvantaged": 서민형)
    """
    # ISA 비과세 한도
    tax_free_limit = 2_000_000 if isa_type == "general" else 4_000_000
    isa_excess_tax_rate = 0.099  # 9.9% 분리과세

    # 일반 계좌 배당소득세
    normal_tax_rate = 0.154  # 15.4%

    # ISA 계좌 (비과세 + 분리과세)
    isa_total_invested = 0
    isa_balance = 0
    for year in range(1, years + 1):
        isa_total_invested += investment
        isa_balance = (isa_balance + investment) * (1 + annual_return)

    isa_total_profit = isa_balance - isa_total_invested

    if isa_total_profit <= tax_free_limit:
        isa_tax = 0
    else:
        isa_tax = int((isa_total_profit - tax_free_limit) * isa_excess_tax_rate)

    isa_after_tax = isa_balance - isa_tax

    # 일반 계좌 (매년 수익에 15.4% 과세)
    normal_balance = 0
    normal_total_tax = 0
    for year in range(1, years + 1):
        normal_balance += investment
        yearly_profit = normal_balance * annual_return
        yearly_tax = int(yearly_profit * normal_tax_rate)
        normal_total_tax += yearly_tax
        normal_balance = normal_balance + yearly_profit - yearly_tax

    tax_saving = normal_total_tax - isa_tax

    return {
        "투자 기간": f"{years}년",
        "총 투자금": f"₩{isa_total_invested:,}",
        "ISA 만기 금액": f"₩{int(isa_after_tax):,}",
        "ISA 납부 세금": f"₩{isa_tax:,}",
        "일반 계좌 만기 금액": f"₩{int(normal_balance):,}",
        "일반 계좌 납부 세금": f"₩{normal_total_tax:,}",
        "절세 효과": f"₩{tax_saving:,}",
        "수익 차이": f"₩{int(isa_after_tax - normal_balance):,}",
    }


# 시나리오: 매년 2,000만원 투자, 연 8% 수익, 3년
result = compare_tax_effect(
    investment=20_000_000,
    annual_return=0.08,
    years=3,
    isa_type="general",
)

print("=== ISA vs 일반 계좌 비교 ===")
for key, value in result.items():
    print(f"  {key}: {value}")

# 통합 자산 배분 설정
investor:
  name: '김영주'
  annual_salary: 60_000_000
  tax_deduction_rate: 0.132 # 5,500만원 초과 → 13.2%

accounts:
  isa:
    type: '중개형'
    annual_contribution: 20_000_000 # 연 2,000만원
    tax_free_limit: 2_000_000
    # ISA에 넣을 자산: 배당 + 성장 + 테마
    holdings:
      - ticker: 'TIGER 미국S&P500'
        weight: 0.35
        role: '코어 - 미국 시장'
      - ticker: 'KODEX 200'
        weight: 0.15
        role: '코어 - 한국 시장'
      - ticker: 'TIGER 반도체'
        weight: 0.15
        role: '새틀라이트 - 반도체'
      - ticker: 'TIGER 미국배당다우존스'
        weight: 0.15
        role: '새틀라이트 - 배당'
      - ticker: 'KODEX 2차전지산업'
        weight: 0.10
        role: '새틀라이트 - 2차전지'
      - ticker: 'TIGER 금은선물(H)'
        weight: 0.10
        role: '새틀라이트 - 금'

  irp:
    annual_contribution: 9_000_000 # 연 900만원 (세액공제 한도)
    tax_deduction: 1_188_000 # 900만 x 13.2%
    risk_asset_limit: 0.70
    # IRP에 넣을 자산: 해외지수 + 채권 (세금이연 최대화)
    holdings:
      risk_assets: # 70% 이내
        - ticker: 'TIGER 미국S&P500'
          weight: 0.35
          role: '코어 - 미국 시장 (배당 과세이연)'
        - ticker: 'TIGER 미국나스닥100'
          weight: 0.20
          role: '코어 - 기술주 성장'
        - ticker: 'KODEX 200'
          weight: 0.15
          role: '코어 - 한국 시장'
      safe_assets: # 30% 이상
        - ticker: 'KODEX 종합채권(AA-이상)액티브'
          weight: 0.15
          role: '안전자산 - 국내 채권'
        - ticker: 'TIGER 미국채10년선물'
          weight: 0.15
          role: '안전자산 - 미국 채권'

  general:
    # 위 두 계좌에 넣지 못한 추가 투자금
    holdings:
      - ticker: 'TIGER 미국S&P500'
        weight: 0.50
      - ticker: 'KODEX 200'
        weight: 0.30
      - ticker: 'TIGER 미국채10년선물'
        weight: 0.20

"""ISA/IRP 연간 워크플로우 자동 알림."""
from datetime import date


ANNUAL_TASKS = [
    {
        "month": 1,
        "tasks": [
            "ISA 연간 납입 계획 수립 (월 167만원 적립 or 일시납)",
            "IRP 연간 납입 계획 수립 (월 75만원 적립 or 일시납)",
            "전년도 세액공제 금액 확인 (연말정산 반영 여부)",
            "코어 ETF 정기 리밸런싱",
        ],
    },
    {
        "month": 3,
        "tasks": [
            "ISA 1분기 납입 확인 (목표: 500만원 누적)",
            "IRP 1분기 납입 확인 (목표: 225만원 누적)",
            "ISA 포트폴리오 리밸런싱 (편차 5% 초과 시)",
        ],
    },
    {
        "month": 4,
        "tasks": [
            "새틀라이트 ETF 분기 성과 검토",
            "IRP 위험자산 비율 확인 (70% 이내인지)",
        ],
    },
    {
        "month": 6,
        "tasks": [
            "ISA 상반기 누적 납입 확인 (목표: 1,000만원)",
            "IRP 상반기 누적 납입 확인 (목표: 450만원)",
            "전체 포트폴리오 중간 점검",
        ],
    },
    {
        "month": 7,
        "tasks": [
            "코어 ETF 정기 리밸런싱 (반기 1회)",
            "새틀라이트 ETF 분기 성과 검토",
        ],
    },
    {
        "month": 10,
        "tasks": [
            "ISA 연간 납입 잔여 금액 확인",
            "IRP 세액공제 한도 잔여 확인",
            "연말까지 납입 완료 계획 수립",
            "새틀라이트 ETF 분기 성과 검토 + 내년 전략 수립",
        ],
    },
    {
        "month": 11,
        "tasks": [
            "IRP 세액공제 한도 미달 시 추가 납입",
            "ISA 연간 한도 미달 시 추가 납입",
            "해외 ETF 양도소득 250만원 공제 활용 (연내 매도 검토)",
        ],
    },
    {
        "month": 12,
        "tasks": [
            "12/31까지 ISA, IRP 납입 완료 확인",
            "연간 투자 성과 정리",
            "내년 자산 배분 전략 수립",
            "ISA 3년 만기 도래 시 만기 연장/해지 결정",
        ],
    },
]


def get_current_tasks() -> list:
    """현재 월의 할 일 목록을 반환한다."""
    current_month = date.today().month
    for item in ANNUAL_TASKS:
        if item["month"] == current_month:
            return item["tasks"]
    return ["이번 달은 정기 점검 일정이 없습니다. 편차 모니터링만 수행하세요."]


def get_contribution_status(
    isa_ytd: int,
    irp_ytd: int,
    isa_annual_target: int = 20_000_000,
    irp_annual_target: int = 9_000_000,
) -> dict:
    """연간 납입 진행률을 확인한다."""
    today = date.today()
    year_progress = today.timetuple().tm_yday / 365

    return {
        "ISA": {
            "납입 누계": f"₩{isa_ytd:,}",
            "연간 목표": f"₩{isa_annual_target:,}",
            "달성률": f"{isa_ytd / isa_annual_target * 100:.1f}%",
            "연간 진행률": f"{year_progress * 100:.1f}%",
            "상태": "정상" if isa_ytd / isa_annual_target >= year_progress * 0.8 else "납입 부족",
        },
        "IRP": {
            "납입 누계": f"₩{irp_ytd:,}",
            "연간 목표": f"₩{irp_annual_target:,}",
            "달성률": f"{irp_ytd / irp_annual_target * 100:.1f}%",
            "예상 세액공제": f"₩{int(min(irp_ytd, irp_annual_target) * 0.132):,}",
            "상태": "정상" if irp_ytd / irp_annual_target >= year_progress * 0.8 else "납입 부족",
        },
    }


# 실행 예시
print("=== 3월 할 일 ===")
for task in get_current_tasks():
    print(f"  - {task}")

print("\n=== 납입 현황 ===")
status = get_contribution_status(isa_ytd=4_000_000, irp_ytd=1_500_000)
for account, info in status.items():
    print(f"\n{account}:")
    for key, value in info.items():
        print(f"  {key}: {value}")

"""ISA 계좌 리밸런싱 시 특수 로직."""


def isa_rebalance_check(
    holdings: dict,
    targets: dict,
    total_value: int,
    tax_free_used: int,
    tax_free_limit: int = 2_000_000,
) -> dict:
    """ISA 계좌의 리밸런싱 가능 여부와 세금 영향을 확인한다.

    Args:
        holdings: {종목코드: {"value": 현재가치, "cost": 매수원가}}
        targets: {종목코드: 목표비중}
        total_value: 총 계좌 잔고
        tax_free_used: 이미 사용한 비과세 한도 (원)
        tax_free_limit: 비과세 한도 (원)
    """
    trades = []
    total_realized_gain = 0

    for code, target_weight in targets.items():
        holding = holdings.get(code, {"value": 0, "cost": 0})
        current_weight = holding["value"] / total_value if total_value > 0 else 0
        diff_weight = target_weight - current_weight

        if abs(diff_weight) < 0.02:  # 2% 미만 편차는 무시
            continue

        trade_amount = int(total_value * abs(diff_weight))
        action = "BUY" if diff_weight > 0 else "SELL"

        # 매도 시 실현 손익 계산
        realized_gain = 0
        if action == "SELL" and holding["value"] > holding["cost"]:
            gain_ratio = (holding["value"] - holding["cost"]) / holding["value"]
            realized_gain = int(trade_amount * gain_ratio)
            total_realized_gain += realized_gain

        trades.append({
            "code": code,
            "action": action,
            "amount": trade_amount,
            "realized_gain": realized_gain,
        })

    # 비과세 한도 확인
    remaining_tax_free = tax_free_limit - tax_free_used
    taxable_gain = max(0, total_realized_gain - remaining_tax_free)
    tax_on_excess = int(taxable_gain * 0.099)  # 9.9% 분리과세

    return {
        "trades": trades,
        "total_realized_gain": total_realized_gain,
        "remaining_tax_free": remaining_tax_free,
        "taxable_gain": taxable_gain,
        "estimated_tax": tax_on_excess,
        "recommendation": (
            "리밸런싱 실행 가능 (비과세 범위 내)"
            if taxable_gain == 0
            else f"비과세 한도 초과: ₩{taxable_gain:,}에 대해 9.9% 과세 (₩{tax_on_excess:,})"
        ),
    }


# 사용 예시
result = isa_rebalance_check(
    holdings={
        "360750": {"value": 8_000_000, "cost": 6_500_000},
        "069500": {"value": 3_000_000, "cost": 2_800_000},
        "091230": {"value": 4_000_000, "cost": 3_200_000},
    },
    targets={"360750": 0.40, "069500": 0.20, "091230": 0.20},
    total_value=15_000_000,
    tax_free_used=500_000,
)

print("=== ISA 리밸런싱 점검 ===")
print(f"예상 실현 수익: ₩{result['total_realized_gain']:,}")
print(f"남은 비과세 한도: ₩{result['remaining_tax_free']:,}")
print(f"판정: {result['recommendation']}")

"""IRP 계좌 리밸런싱 시 위험자산 비율 검증."""

# 자산 분류 기준
RISK_ASSET_CODES = {"360750", "133690", "069500", "091230", "305720"}
SAFE_ASSET_CODES = {"443160", "305080", "304660"}


def irp_risk_check(
    holdings: dict,
    max_risk_ratio: float = 0.70,
) -> dict:
    """IRP 포트폴리오의 위험자산 비율을 확인한다."""
    risk_value = sum(
        h["value_krw"] for code, h in holdings.items()
        if code in RISK_ASSET_CODES
    )
    safe_value = sum(
        h["value_krw"] for code, h in holdings.items()
        if code in SAFE_ASSET_CODES
    )
    total = risk_value + safe_value

    risk_ratio = risk_value / total if total > 0 else 0
    safe_ratio = safe_value / total if total > 0 else 0

    compliant = risk_ratio <= max_risk_ratio

    return {
        "total_value": f"₩{total:,}",
        "risk_assets": f"₩{risk_value:,} ({risk_ratio*100:.1f}%)",
        "safe_assets": f"₩{safe_value:,} ({safe_ratio*100:.1f}%)",
        "risk_limit": f"{max_risk_ratio*100:.0f}%",
        "compliant": compliant,
        "action": (
            "위험자산 비율 정상"
            if compliant
            else f"위험자산 비율 초과: {risk_ratio*100:.1f}% > {max_risk_ratio*100:.0f}%. "
                 f"₩{int(risk_value - total * max_risk_ratio):,}만큼 안전자산으로 전환 필요."
        ),
    }


# 사용 예시
irp_result = irp_risk_check({
    "360750": {"value_krw": 3_500_000},  # S&P500 (위험)
    "133690": {"value_krw": 1_800_000},  # 나스닥100 (위험)
    "069500": {"value_krw": 1_200_000},  # KODEX200 (위험)
    "443160": {"value_krw": 1_500_000},  # 종합채권 (안전)
    "305080": {"value_krw": 1_000_000},  # 미국채10년 (안전)
})

print("=== IRP 위험자산 비율 점검 ===")
for key, value in irp_result.items():
    print(f"  {key}: {value}")

1. IRP에 연 300-900만원 납입 (세액공제 최대 활용)
   └─ 세액공제 효과: 즉시 13.2-16.5% 확정 수익
   └─ 단, 55세까지 인출 불가 (유동성 제약)

2. ISA에 연 최대 2,000만원 납입
   └─ 3년 이내에 필요할 수 있는 자금 포함 가능
   └─ 비과세 200-400만원 + 9.9% 분리과세

3. 일반 계좌
   └─ ISA/IRP 한도 초과분
   └─ 유동성이 필요한 자금

"""ISA 만기 전환 시 세제 혜택 계산."""


def isa_to_irp_benefit(
    isa_balance: int,
    max_additional_deduction: int = 3_000_000,
    tax_rate: float = 0.132,
) -> dict:
    """ISA 만기 금액을 IRP로 전환 시 추가 세액공제를 계산한다."""
    eligible_amount = min(isa_balance, isa_balance)  # 전액 전환 가정
    deduction_base = min(int(eligible_amount * 0.1), max_additional_deduction)
    additional_tax_saving = int(deduction_base * tax_rate)

    return {
        "ISA 만기 잔고": f"₩{isa_balance:,}",
        "IRP 전환 금액": f"₩{eligible_amount:,}",
        "추가 세액공제 대상": f"₩{deduction_base:,}",
        "추가 절세 금액": f"₩{additional_tax_saving:,}",
        "참고": "IRP 기존 납입 한도(1,800만원)와 별도로 전환 가능",
    }


result = isa_to_irp_benefit(isa_balance=30_000_000)
print("=== ISA → IRP 전환 혜택 ===")
for key, value in result.items():
    print(f"  {key}: {value}")

┌─────────────────────────────────────────────────────┐
│                 GitHub Actions (Scheduler)            │
│  매주 월요일 09:00 KST → 편차 확인                    │
│  매 분기 첫 영업일 → 정기 리밸런싱                     │
│  매월 1일 → 납입 현황 확인                             │
└────────────────┬────────────────────────────────────┘
                 │
                 ▼
┌─────────────────────────────────────────────────────┐
│              Python 리밸런싱 엔진                     │
│  1. 증권사 API로 ISA/IRP/일반 계좌 잔고 조회          │
│  2. YAML 설정 파일과 현재 비중 비교                    │
│  3. 계좌별 리밸런싱 필요 여부 판단                     │
│     - ISA: 비과세 한도 확인                           │
│     - IRP: 위험자산 70% 한도 확인                     │
│  4. 매매 주문 생성 (dry-run)                          │
└────────────────┬────────────────────────────────────┘
                 │
                 ▼
┌─────────────────────────────────────────────────────┐
│              알림 (Slack / 카카오톡)                   │
│  - 리밸런싱 필요 시: 매매 내역 + 비용 추정            │
│  - 납입 부족 시: 잔여 한도 + 권장 납입액              │
│  - 세액공제 마감 임박 시: 11-12월 긴급 알림           │
└─────────────────────────────────────────────────────┘