← 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)

#제목영역모델의의
#657chore — stale task·ADR drift·untracked 잔재 정리orchestratoropusADR 0088 Proposed→Accepted 격상 + backlog §0 stale 정정 + task 21건 archive + untracked 제거 (.agents/.codex/AGENTS.md)
#658fix — KIS_TPS LIVE 1차 hotfix (200ms 종목 간 sleep)market-dataopusLiveDailyCandleScheduler burst 완화 1차 시도 — 효과 0 (옵션 B fluke 가설)
#659fix — KIS_TPS 종합 fix (H1 페이지 + H4 retry + priority=BACKFILL) ★market-dataopus페이지 150ms sleep + EGW00201 1초 backoff + priority 재배치. 3 cycle LIVE GREEN ok=6 fail=0
#660fix — QA 첫 임무 P0 (NXT 30% + stale 30분)backend-coreopusSymbolMetaService 휴리스틱 강화. stale=true 검증 LIVE GREEN. 62% 경계 case는 backlog §59 sunset
#661fix — consumer block() reactor-http-nio ERROR (publishOn 위임)market-dataopusKisOrderInquireCcldHttpAdapter + Daily 2건 → boundedElastic 위임. LIVE 0건
#662chore — baseline v3.8.0 init (5 slot + 폴더)orchestratoropusCHANGELOG 5 anchor + README skeleton + baseline 폴더
#663docs — baseline 05-ui-inventory.mdfrontendopus14 route + 13 nav + 4 Mermaid + LWC v4 이관 + qa Visual baseline 본문
#664docs — baseline 03-use-sequences.md (KIS-first raw)market-dataopus7 sequence diagram + 10 raw 인용 (R21 신규 oauth2/tokenP)
#665docs — baseline 02 + 04backend-coreopus16 트랙 (14→16 +2: T-OPS·T-QA) + 12 mermaid + Flyway V43 (system_event)
#666docs — baseline README + 01 + 06 + 07 ★architectopus운영 단계 진입 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.0GitHub 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
2KIS_TPS LIVE root cause hotfix (1차)market-dataPR #658옵션 B (200ms 종목 간 sleep). 효과 0 LIVE 검증 — fluke 가설
3KIS_TPS 종합 fix (H1+H4)market-dataPR #659페이지 150ms + EGW00201 retry + BACKFILL priority. 3 cycle ok=6 fail=0 LIVE GREEN
4QA 첫 임무 P0 fix (NXT + stale)backend-corePR #660SymbolMetaService 30% 휴리스틱 + 30분 stale 검증. 17 unit test
5consumer block() ERROR fixmarket-dataPR #661publishOn(boundedElastic) — 2 adapter (Inquire Ccld + Daily). 9건 잔여 backlog 권고
6baseline architect (README + 01 + 06 + 07)architectPR #6661525 LOC · 5 mermaid · 운영 단계 진입 baseline 본문화 (가장 큰 sub-agent)
7baseline backend-core (02 + 04)backend-corePR #6651404 LOC · 12 mermaid · 16 트랙 (T-OPS + T-QA 신규)
8baseline market-data (03 KIS-first raw)market-dataPR #6641026 LOC · 7 sequence · 10 raw 인용 (R21 oauth2/tokenP 신규)
9baseline frontend (05)frontendPR #663423 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/failelapsedMsTPS signal Δstatus=500
1st17:42:43ok=6 fail=077.2s+00
2nd17:47:41ok=6 fail=074.8s+00
3rd18:03:08ok=6 fail=082.5s+11
이전(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)

종목currentPricestaleexpectRange평가
005930 삼성전자292,000true ★[30K, 200K]NXT 62% 경계 case 잔존 (backlog §59)
000660 SK하이닉스1,919,000true ★[100K, 400K]NXT 62% 경계 case 잔존
004090 한국석유13,470true ★[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 산출물

파일작성자LOCMermaid비고
README.mdarchitect181한 장 요약 + 7 파일 인덱스
01-architecture.mdarchitect60648 모듈 + 외부 통합 + Flyway 시계열
02-data-flow.mdbackend-core73112모듈별 데이터 흐름 + Kafka 19 + Redis
03-use-sequences.mdmarket-data10266 (7 sequence)7 시나리오 + KIS raw 10건
04-feature-spec.mdbackend-core67316 트랙 표준 명세
05-ui-inventory.mdfrontend423414 route + 8 STOMP + LWC + qa Visual
06-history-traceability.mdarchitect285PR + ADR 시계열 + backlog 처리표
07-policy-evolution.mdarchitect453헌법 §1~§10 진화 + ADR 96건
합계437826+ blocks8 html 변환 GREEN

8. 다음 세션 일정 (우선순위)

우선순위의제사이즈예정 트랙
P1candle venue 컬럼 (옵션 B — 005930·000660 NXT 62% case 해소)~150 LOC + Flyway V44backlog §59 · chart-curator(archived) 책임 → market-data + backend-core 합류
P2Phase 3 Circuit Breaker + EGW00201 1초 backoff + caller priority queue~300 LOCbacklog §0-A Phase 3
P2§57 KIS EGW00123 self-heal 잔여 어댑터 확장 (5 어댑터)~650 LOCbacklog §57
P2§58 EGW00201 폭주 차단 — frontend exponential backoff~50 LOCbacklog §58
P3stale local branches 8건 force deletegit 명령사용자 결재 (-D 권한 차단)
P3consumer block() 동일 패턴 9건 (KisApprovalAdapter·KisRestPriceAdapter·KisHashKeyAdapter 등)~50 LOC eachBlockHound 도입 검토 backlog
P4W4 진입 (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 릴리즈 🔒