Viz - 재무제표 구조 차트 묶음

절차

1. 원표 기준을 먼저 고정한다. 연결/별도, 연간/분기, 결산기, 통화를 섞지 않는다.
2. 손익 구조는 specIncomeTrendMatrix(view) 로 만들고, 기간별 매출·영업이익·순이익·마진의 같은 방향성을 검산한다.
3. 재무상태 구조는 specBalanceStructureTrend(view) 로 만들고, 각 기간 자산총계 = 부채총계 + 자본총계 정합성을 확인한다.
4. 현금흐름은 specCashflowSignedMatrix(view) 로 만들고, 영업CF·투자CF·재무CF의 부호와 규모를 같이 보여준다.
5. 데이터가 2개 기간 미만이면 chart 대신 원표 요약과 coverage note 로 낮춘다.

공개 호출 방식

from dartlab.viz.generators import (
    specIncomeTrendMatrix,
    specBalanceStructureTrend,
    specCashflowSignedMatrix,
)

income_spec = specIncomeTrendMatrix(income_view)
balance_spec = specBalanceStructureTrend(balance_view)
cashflow_spec = specCashflowSignedMatrix(cashflow_view)

호출 동작

• 입력 view 또는 rows 를 검산 가능한 ChartSpec 으로 변환한다.
• evidenceBinding 또는 evidenceIds 가 없으면 emit 하지 않는다.
• 데이터가 부족하면 값을 추정하지 않고 표, coverage note, 또는 bullet path 로 낮춘다.

대표 반환 형태

• dict ChartSpec: chartType, title, series 또는 data, categories, evidenceBinding, meta.
• Mermaid 계열은 diagram source 와 node/edge evidence refs 를 함께 남긴다.

기본 검증

• 각 spec 에 evidenceBinding.topic 이 IS / BS / CF 중 실제 원표와 맞는지 확인한다.
• missing 계정은 0 으로 대체하지 않고 warnings 또는 answer coverage note 에 남긴다.
• 차트 해석 문단은 기간·계정·값을 하나 이상 직접 인용해야 한다.