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