'
def stacked_summary_cards_html(
title: str,
cards_inner: str,
) -> str:
"""
제목 한 줄 + 카드 flex 한 줄을 세로 블록으로 묶습니다.
Args:
title: cards-group-title 텍스트(HTML 허용).
cards_inner: .cards 안에 넣을 card div 문자열.
Returns:
cards-row-block HTML.
"""
return (
'
'
f'
{title}
'
f'
{cards_inner}
'
"
"
)
def wrap_chart_report_page(
page_title: str,
heading: str,
meta_line: str,
note_html: str,
legend_html: str,
cards_html: str,
chart_html: str,
sections_html: str,
) -> str:
"""
Plotly 차트·테이블을 ground_truth와 동일 스타일 페이지로 감쌉니다.
Args:
page_title: document title.
heading: h1.
meta_line: 기간·추세 등.
note_html: 안내 박스.
legend_html: 차트 범례 설명.
cards_html: .cards 내부 HTML 또는 .summary-cards 블록 전체.
chart_html: plotly embed.
sections_html: h2·테이블·criteria 등 본문 하단.
Returns:
전체 HTML 문서.
"""
return f"""
{page_title}
{heading}
{meta_line}
{note_html}
{legend_html}
{cards_html if "summary-cards" in cards_html else f'
{cards_html}
'}
{chart_html}
{sections_html}
"""
_COL_LABELS: dict[str, str] = {
"m3_bb_pos": "3분 BB %B",
"m15_bb_pos": "15분 BB %B",
"m30_bb_pos": "30분 BB %B",
"m3_RSI": "3분 RSI",
"m15_RSI": "15분 RSI",
"m30_RSI": "30분 RSI",
"m3_stoch_k": "3분 Stoch %K",
"m15_stoch_k": "15분 Stoch %K",
}
def _col_label(col: str) -> str:
"""지표 컬럼 한글 라벨."""
return _COL_LABELS.get(col, col)
def _format_condition(cond: dict[str, Any]) -> str:
"""
규칙 조건 dict를 읽기 쉬운 문자열로 변환.
Args:
cond: {col, op, lo, hi, value}.
Returns:
한 줄 설명.
"""
col = _col_label(str(cond.get("col", "")))
op = cond.get("op", "")
if op == "between":
return f"{col} ∈ [{cond.get('lo'):.4g}, {cond.get('hi'):.4g}]"
if op == "lte":
return f"{col} ≤ {cond.get('value'):.4g}"
if op == "gte":
return f"{col} ≥ {cond.get('value'):.4g}"
if op == "lt":
return f"{col} < {cond.get('value'):.4g}"
if op == "gt":
return f"{col} > {cond.get('value'):.4g}"
return f"{col} {op} {cond}"
_KIND_LABELS: dict[str, str] = {
"contrast": "대조 — GT 매수·매도 프로필 대비 반대 구간 (m3 중심)",
"compound_tight": "복합 타이트 — GT 프로필 상위 3지표 AND 동시 충족",
"compound": "복합 TOP3 — GT 프로필 상위 3지표 AND",
"atomic": "단일 — GT 프로필 1지표",
"wide": "완화 — 프로필 외곽 구간",
}
def format_rule_kind(kind: str) -> str:
"""규칙 kind 한글 설명."""
return _KIND_LABELS.get(kind, kind)
def rule_criteria_html(rule: dict[str, Any]) -> str:
"""
monitor_rule 1개의 매칭 기준 블록 HTML.
Args:
rule: matched_rules 내 rule dict.
Returns:
.criteria 블록 HTML.
"""
rid = rule.get("rule_id", "")
side = "매수" if rule.get("side") == "buy" else "매도"
kind = rule.get("kind", "")
conds = rule.get("conditions") or []
items = "".join(f"
{_format_condition(c)}
" for c in conds)
m = rule.get("metrics", {}).get("all", {})
hold = rule.get("metrics", {}).get("holdout", {})
return f"""
{rid} ({side} · {format_rule_kind(kind)})
발화 시 3분봉 종가·8TF 지표가 아래를 모두 만족하면 {side} 신호.
{items or '
조건 없음
'}
전구간 EV {m.get('ev_pct', '-')}%% · holdout EV {hold.get('ev_pct', '-')}%% ·
holdout PF {hold.get('profit_factor', '-')}
"""
def go_no_go_table_html(checks: list[dict[str, Any]], go: bool) -> str:
"""
Go/No-Go 검증 테이블 HTML.
Args:
checks: go_no_go.checks.
go: 종합 판정.
Returns:
section HTML.
"""
flag = "go-pass" if go else "go-fail"
label = "GO" if go else "NO-GO"
rows = []
for c in checks:
mark = "PASS" if c.get("pass") else "FAIL"
cls = "pass" if c.get("pass") else "fail"
rows.append(
f"