[2026.11.10] AI 퀀트 엔진 TDD 8부작 완주, 7대 다이어그램 엔진 및 4대 Fail-Closed 안전 게이트 수립

BUILD LOG · 2026.11.10 · ⏱️ 10 min read

엔지니어링 일지 요약: Track 02 (AI Quant Garage)의 8개 모듈 TDD 파이프라인을 전면 완주하고, PIL 기반 7대 다이어그램 스타일 엔진을 구축하였으며, 실전 모의투자 10/21 체결 대사 장애를 복기하여 4대 Fail-Closed 안전 게이트(ARCH-FINX-001)와 Track 03 (Market Circuit)을 공식 런칭한 여덟째 날의 기록입니다.


1. 오늘의 주요 작업 및 설계 결정 (Key Decisions & Changes)

  • Track 02 (AI Quant Garage) 시즌 1 전 8부작 TDD 완결 및 배포:
  • Warm-up: 퀀트 시스템 전체 3-Tier 아키텍처 수립 및 거버넌스 분리.
  • Lap 01: DuckDB + Parquet 기반 월 0원 로컬 레이크하우스 아키텍처 설계.
  • Lap 02~05: PITDataPortal (Point-in-Time 룩어헤드 방지), ExecutionEngine (슬리피지/수수료 TDD), PortfolioAccount (복식부기 캐시 장부), MetricsCalculator (CAGR, MDD, Sharpe 계산기) 순수 단위 테스트 구축.
  • Lap 06~07: 7대 즉시 기각 심사관(Hard Veto Judge) 및 EVAL-QB-002 6대 영역 24개 지표 총괄 리더보드 완성.
  • 파이썬 7대 다이어그램 스타일 엔진 개발 (scripts/showcase_lap01_styles.py):
  • Style 1: Executive Quant Journal (블룸버그/FT 저널풍)
  • Style 2: Blueprint Engineering Schematic (NASA/Apple CAD 청사진풍)
  • Style 3: Swiss Modernist Grid (디터 람스 모던 그리드풍)
  • Style 4: Layered Architectural Stack (가변 N-Tier 입체 인프라 적층풍)
  • Style 5: Infographic Data-Flow Poster (The Economist 포스터풍)
  • Style 6: Cloud Solution Architecture (GCP/Cloudflare 클라우드 토폴로지풍)
  • Style 7: Dark Bento Matrix (2×2 벤토 그리드 & 미니 차트풍)
  • 외부 GUI 툴 없이 순수 Python PIL로 16:9 와이드 고해상도(1600×900) 이미지를 일괄 렌더링하는 자동화 파이프라인 확립.
  • dipx 자산 관제탑 공식 편입 및 4대 Fail-Closed 안전 게이트 제정 (ARCH-FINX-001):
  • 고베타 기술주/레버리지 ETF(QLD, TQQQ, SOXL) 기반 딥 매수 자산(dipx)을 관제탑 Category 06으로 공식 편입.
  • 10월 21일 모의투자 장부 불일치(position_mismatch) 장애를 심층 복기하여 모의투자와 실전 API 간 12시간 시차 공백을 차단하는 4대 Fail-Closed 안전 게이트 설계.
  • Track 03 (Market Circuit) 실전 텔레메트리 런칭:
  • Lap 01: “무한매수법의 함정과 단순 AI 프롬프트의 한계” (2022년 하락장 -75% MDD 실전 분석).
  • Lap 02: “테스트 300개를 얻고 Claude 토큰을 잃었다” (AI 페어 프로그래밍 컨텍스트 윈도우 휘발과 TDD 모듈 격리).
  • Lap 03: “테스트 301개는 통과했는데 왜 장부는 어긋났을까? 10/21 체결 대사 장애와 4대 Fail-Closed 안전 게이트”.
  • Google Analytics 4 및 Google Tag Manager 무과금 연동:
  • G-0Y1NJWNC03 및 GTM-5MGSLZ2M을 wealth-podium-design.php에 직접 주입하여 방문자 텔레메트리 측정 개시.

2. 핵심 아키텍처 도식 (Architecture Summary)

도식 원본 보기
flowchart TD
    subgraph Track02["Track 02: AI Quant Garage (TDD 8부작)"]
        T1["Warm-up: 3-Tier 아키텍처"] --> T2["Lap 01: DuckDB 레이크하우스"]
        T2 --> T3["Lap 02~05: 모듈별 단위 테스트<br/>(PITDataPortal, ExecutionEngine, Account, Metrics)"]
        T3 --> T4["Lap 06~07: 7대 Hard Veto & 리더보드"]
    end

    subgraph DesignEngine["비주얼 디자인 엔진"]
        D1["PIL 기반 7대 다이어그램 스타일 엔진<br/>(scripts/showcase_lap01_styles.py)"]
        D2["16:9 와이드 고해상도 에디토리얼 카드"]
        D1 --> D2
    end

    subgraph Track03["Track 03: Market Circuit & Fail-Closed"]
        F1["10/21 실전 체결 대사 장애 복기"]
        --> F2["4대 Fail-Closed 안전 게이트 (ARCH-FINX-001)"]
        --> F3["Lap 01~03 실전 텔레메트리 포스트 발행"]
    end

    Track02 --> DesignEngine
    Track03 --> DesignEngine

3. 트러블슈팅 & 기술 검증 (Troubleshooting & Verification)

  • 발생 문제 1 (단일 다이어그램 스타일 반복에 따른 시각적 피로):
  • 모든 포스트에 동일한 스타일의 도식만 반복 배치되어 독자 피로도가 누적됨.
  • 해결 조치: 7대 다이어그램 스타일 엔진을 구축하고, 포스트 내 2개 이상의 도식이 들어갈 경우 서로 다른 스타일(예: Style 2 Blueprint + Style 7 Dark Bento)을 교차 배치하는 Anti-Monotony 헌법을 수립.
  • 발생 문제 2 (영문 전용 폰트 참조로 인한 두부 문자 깨짐):
  • DejaVuSansMono 등 영문 전용 폰트로 렌더링 시 한글 배지와 콜아웃에서 네모 박스(□)가 노출됨.
  • 해결 조치: 한글이 포함된 텍스트는 무조건 NotoSansKR-Bold.ttf로 폴백 처리하고, font.getbbox() 기반의 1:1 수평/수직 정렬 공식을 일괄 적용.
  • 발생 문제 3 (모의투자와 실전 API 간 체결 데이터 대사 불일치):
  • 10월 21일 장 시작 전 슬리브별 주문 수량과 실전 계좌 잔고가 어긋나 주문 거부 위험 발생.
  • 해결 조치: 0.1초 만에 주문을 동결시키는 4대 안전 관문(주문 전 잔고 검증, 체결 즉시 대사, 불일치 시 Fail-Closed, 슬랙 경보)을 구현하여 결함 전파 원천 차단.

4. 완료 산출물 및 다음 단계 (Deliverables & Next Steps)

  • 완료 산출물:
  • docs/track-02-posts/: Warm-up 및 Lap 01~07 전 8편 원고 및 시더 등록.
  • docs/track-03-posts/: Lap 01~03 전 3편 원고 및 커버/다이어그램 제작 배포.
  • scripts/showcase_lap01_styles.py: 7대 다이어그램 스타일 자동화 엔진.
  • mu-plugins/wealth-podium-design.php: GA4 및 GTM 추적 태그 연동.
  • mu-plugins/wealth-podium-seed.php: Track 02 및 Track 03 시딩 파이프라인.
  • 다음 단계: Track 02 시즌 2(매크로 동적 자산배분) 기획 및 실서버 모니터링 체계 강화.

Similar Posts

Leave a Reply

Your email address will not be published. Required fields are marked *