---
title: "[2026.11.10] AI 퀀트 엔진 TDD 8부작 완주, 7대 다이어그램 엔진 및 4대 Fail-Closed 안전 게이트 수립"
canonical_url: "https://wealth-podium.com/2026/11/10/build-log-day-08-track-02-quant-engine-tdd-and-seven-diagram-styles/"
published_at: "2026-11-10T18:00:00+09:00"
modified_at: "2026-11-14T10:24:51+09:00"
author: "Wealth Max V (Full Stack Engineer & Quantitative Research)"
summary: "Track 02 AI 퀀트 엔진 8부작 TDD 파이프라인(DuckDB 무과금 레이크하우스, PITDataPortal, 복식부기 장부, 7대 Hard Veto)을 완주하고, PIL 기반 7대 다이어그램 스타일 엔진 구축 및 실전 10/21 장부 대사 장애를 복기한 4대 Fail-Closed 안전 게이트(ARCH-FINX-001) 수립과 Track 03 런칭을 기록한 여덟째 날의 엔지니어링 일지입니다."
---
# [2026.11.10] AI 퀀트 엔진 TDD 8부작 완주, 7대 다이어그램 엔진 및 4대 Fail-Closed 안전 게이트 수립

> **엔지니어링 일지 요약**: 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 (2x2 벤토 그리드 & 미니 차트풍)
  - 외부 GUI 툴 없이 순수 Python PIL로 16:9 와이드 고해상도(1600x900) 이미지를 일괄 렌더링하는 자동화 파이프라인 확립.
- **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)

```mermaid
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(매크로 동적 자산배분) 기획 및 실서버 모니터링 체계 강화.
