← devlog index
2026-05-22 (금) — v3.8.0 cut ★
작성: 19:18 KST · 회차 1 · KIS_TPS LIVE 해소 + QA 첫 임무 fix + consumer block() ERROR + v3.8.0 baseline cycle 마감
0. 세션 한 줄 요약
"오늘 할거" 질문 → KIS_TPS_EXCEEDED LIVE 진단(12:58~14:22 KST count=109) → 3 hotfix 사이클 → QA 첫 임무 NXT/stale fix → consumer block() ERROR fix → v3.8.0 baseline 4 sub-agent 병렬 + tag cut + release 발행. 10 PR 머지 · 8 sub-agent 디스패치 · v3.8.0 cut .
1. 머지 PR 매트릭스 (10건 — chronological)
# 제목 영역 모델 의의
#657 chore — stale task·ADR drift·untracked 잔재 정리 orchestrator opus ADR 0088 Proposed→Accepted 격상 + backlog §0 stale 정정 + task 21건 archive + untracked 제거 (.agents/.codex/AGENTS.md)
#658 fix — KIS_TPS LIVE 1차 hotfix (200ms 종목 간 sleep) market-data opus LiveDailyCandleScheduler burst 완화 1차 시도 — 효과 0 (옵션 B fluke 가설)
#659 fix — KIS_TPS 종합 fix (H1 페이지 + H4 retry + priority=BACKFILL) ★ market-data opus 페이지 150ms sleep + EGW00201 1초 backoff + priority 재배치. 3 cycle LIVE GREEN ok=6 fail=0
#660 fix — QA 첫 임무 P0 (NXT 30% + stale 30분) backend-core opus SymbolMetaService 휴리스틱 강화. stale=true 검증 LIVE GREEN. 62% 경계 case는 backlog §59 sunset
#661 fix — consumer block() reactor-http-nio ERROR (publishOn 위임) market-data opus KisOrderInquireCcldHttpAdapter + Daily 2건 → boundedElastic 위임. LIVE 0건
#662 chore — baseline v3.8.0 init (5 slot + 폴더) orchestrator opus CHANGELOG 5 anchor + README skeleton + baseline 폴더
#663 docs — baseline 05-ui-inventory.md frontend opus 14 route + 13 nav + 4 Mermaid + LWC v4 이관 + qa Visual baseline 본문
#664 docs — baseline 03-use-sequences.md (KIS-first raw) market-data opus 7 sequence diagram + 10 raw 인용 (R21 신규 oauth2/tokenP)
#665 docs — baseline 02 + 04 backend-core opus 16 트랙 (14→16 +2: T-OPS·T-QA) + 12 mermaid + Flyway V43 (system_event)
#666 docs — baseline README + 01 + 06 + 07 ★ architect opus 운영 단계 진입 baseline 본문화 + ADR 0094 amend 7 actor + P0 OPS 6/6 LOCK
v3.8.0 tag :
ef43d403 머지 직후 cut +
release/v3.8.0 brunch push (ADR 0031 immutable) +
scripts/release.sh v3.8.0 →
GitHub Release · README 37 tags · master.html 124.5 KB.
2. PostgreSQL 테이블 변경
오늘 신규 Flyway 0건. 본 세션은 hotfix + docs 위주 — schema 변경 없음. no change
참고: 어제 V43 system_event 테이블 (severity P1~P4, correlation_id, viewed_at, resolved_at) 신설이 baseline 02-data-flow.md에 본문화됨.
3. Kafka 토픽·데이터 흐름 변경
오늘 신규 토픽 0건. no change
참고: 19 토픽 매트릭스 (system.event.v1 포함 — ADR 0094) baseline 02-data-flow.md 본문화.
4. Redis 사용처 변경
오늘 신규 key 0건. no change
참고: 5종 신규 key (killswitch race-safe 3 + kis:tps:pause + nxt:stale:check) baseline 02-data-flow.md 본문화.
5. sub-agent 디스패치 내역 (8건 — chronological)
# 임무 Agent 결과 비고
1 §0-A Phase 2 KIS Rate Limit acquire 합류 market-data 변경 0 정찰 결과 Phase 2 이미 PR #571 머지 완료 확인 → 변경 없이 종결. worktree isolation 누수로 main에 KisAuthAdapter 변경 흘림 → orchestrator restore
2 KIS_TPS LIVE root cause hotfix (1차) market-data PR #658 옵션 B (200ms 종목 간 sleep). 효과 0 LIVE 검증 — fluke 가설
3 KIS_TPS 종합 fix (H1+H4) market-data PR #659 페이지 150ms + EGW00201 retry + BACKFILL priority. 3 cycle ok=6 fail=0 LIVE GREEN
4 QA 첫 임무 P0 fix (NXT + stale) backend-core PR #660 SymbolMetaService 30% 휴리스틱 + 30분 stale 검증. 17 unit test
5 consumer block() ERROR fix market-data PR #661 publishOn(boundedElastic) — 2 adapter (Inquire Ccld + Daily). 9건 잔여 backlog 권고
6 baseline architect (README + 01 + 06 + 07) architect PR #666 1525 LOC · 5 mermaid · 운영 단계 진입 baseline 본문화 (가장 큰 sub-agent)
7 baseline backend-core (02 + 04) backend-core PR #665 1404 LOC · 12 mermaid · 16 트랙 (T-OPS + T-QA 신규)
8 baseline market-data (03 KIS-first raw) market-data PR #664 1026 LOC · 7 sequence · 10 raw 인용 (R21 oauth2/tokenP 신규)
9 baseline frontend (05) frontend PR #663 423 LOC · 4 mermaid · 14 route + LWC v4 이관 + qa Visual baseline
worktree leak 사건 2건 : ① sub-agent 1 (market-data Phase 2 정찰)이 main worktree에 KisAuthAdapter·CandleRefreshService·KisApprovalAdapter 변경 흘림 → restore + 재디스패치. ② architect baseline 작업 시 root main HEAD로 첫 commit 직진 → git update-ref refs/heads/main origin/main + cherry-pick + amend로 복구. 둘 다 자가 회복 GREEN.
6. sanity / dogfooding 결과
6-1. KIS_TPS_EXCEEDED LIVE 검증 (PR #659 — 3 cycle GREEN ★)
Cycle 시각 (KST) ok/fail elapsedMs TPS signal Δ status=500
1st 17:42:43 ok=6 fail=0 77.2s +0 0
2nd 17:47:41 ok=6 fail=0 74.8s +0 0
3rd 18:03:08 ok=6 fail=0 82.5s +1 1
이전(PR #658 시점) ok=0 fail=6 100% 7 cycle 누적 → PR #659 머지 후 ok=6 fail=0 3 cycle 연속. 자본 path 0 / 데이터 수집 50% fail → 0% fail 회복.
6-2. QA fix 효과 (PR #660 — stale GREEN, NXT 부분 GREEN)
종목 currentPrice stale expectRange 평가
005930 삼성전자 292,000 true ★ [30K, 200K] NXT 62% 경계 case 잔존 (backlog §59)
000660 SK하이닉스 1,919,000 true ★ [100K, 400K] NXT 62% 경계 case 잔존
004090 한국석유 13,470 true ★ [5K, 50K] baseline 정합 회귀 0
6-3. consumer block() ERROR fix (PR #661 — 0건 LOCK)
재배포 후 docker logs magicjar-consumer --since 3m | grep "block()" → 0건 . KisExecutionBackfillService 정상 동작 (응답row=1 체결row=1).
6-4. 9 컨테이너 상태
api-app healthy
batch-app healthy
consumer-app healthy
frontend healthy
kafka healthy
kafka-ui healthy
postgres healthy
redis healthy
dozzle up
7. baseline v3.8.0 산출물
파일 작성자 LOC Mermaid 비고
README.md architect 181 — 한 장 요약 + 7 파일 인덱스
01-architecture.md architect 606 4 8 모듈 + 외부 통합 + Flyway 시계열
02-data-flow.md backend-core 731 12 모듈별 데이터 흐름 + Kafka 19 + Redis
03-use-sequences.md market-data 1026 6 (7 sequence) 7 시나리오 + KIS raw 10건
04-feature-spec.md backend-core 673 — 16 트랙 표준 명세
05-ui-inventory.md frontend 423 4 14 route + 8 STOMP + LWC + qa Visual
06-history-traceability.md architect 285 — PR + ADR 시계열 + backlog 처리표
07-policy-evolution.md architect 453 — 헌법 §1~§10 진화 + ADR 96건
합계 4378 26+ blocks 8 html 변환 GREEN
8. 다음 세션 일정 (우선순위)
우선순위 의제 사이즈 예정 트랙
P1 candle venue 컬럼 (옵션 B — 005930·000660 NXT 62% case 해소) ~150 LOC + Flyway V44 backlog §59 · chart-curator(archived) 책임 → market-data + backend-core 합류
P2 Phase 3 Circuit Breaker + EGW00201 1초 backoff + caller priority queue ~300 LOC backlog §0-A Phase 3
P2 §57 KIS EGW00123 self-heal 잔여 어댑터 확장 (5 어댑터) ~650 LOC backlog §57
P2 §58 EGW00201 폭주 차단 — frontend exponential backoff ~50 LOC backlog §58
P3 stale local branches 8건 force delete git 명령 사용자 결재 (-D 권한 차단)
P3 consumer block() 동일 패턴 9건 (KisApprovalAdapter·KisRestPriceAdapter·KisHashKeyAdapter 등) ~50 LOC each BlockHound 도입 검토 backlog
P4 W4 진입 (T-AI·T-MCP) — Spring AI + Anthropic + MCP server 대규모 사용자 결재 대기 (현재 LOCK)
9. 마감 요약
v3.8.0 cut 완료 ★ — 운영 단계 진입 후 첫 minor. 자본 path 안정성 회복 (KIS_TPS GREEN + consumer block() GREEN). QA Visual 첫 가동 evidence 흡수. baseline 7 md (4378 LOC) + 8 html. Release:
v3.8.0 릴리즈 🔒
SoT: docs/architecture/master-architecture.md · _workspace/backlog.md · _workspace/baseline/v3.8.0/ · _workspace/arch/adr/README.md