2026-05-27 생태계헬스진단 — 백엔드 진단 도구 (gateway 보조)
개요
gateway trident 캐시 stale 같은 라우팅 장애가 발생했을 때, 백엔드 세션이 직접/우회 양측 응답을 동시에 측정해
정확한 판정 한 줄(verdict) 을 gateway 세션에 제공한다. gateway 세션이 trident 캐시 재평가만 빠르게 트리거하면 되도록 정보 제공에 집중. trident 캐시 복구 자체는 gateway 세션의 영역(세션 책임 분리 원칙).
무엇을 했는지
1. 한선씨 라이브러리 신규 작성
/Users/ef/Downloads/CrownyTVM/std/생태계헬스진단.한선 + .han (12KB)- 셀코어 룰 헬퍼 내장 (다중 import silent fail 회피 — 베이스 컨텍스트 5절)
- v0.38 함정 회피: TCP읽기 1인자, 예약키워드 회피, 출력값 분할
2. 핵심 함수
| 함수 | 산식 |
|---|
헬스_백엔드체크(호스트, 포트, 경로) | TCP연결(127.0.0.1, 포트) → HTTP GET → 상태코드 추출 |
헬스_gateway외부체크(도메인, 경로) | TCP연결(도메인, 80) → HTTP GET → Host 헤더로 gateway 라우팅 |
헬스_diff(직접, gateway) | 직접=200+gateway=503 → trident_cache_stale 등 8가지 판정 |
헬스_생태계전체() | 7도메인 일괄 진단 → JSON 배열 리포트 |
헬스_상태코드추출(응답) | "HTTP/1.1 200" 11번째 문자부터 3자리 숫자 추출 |
3. 셀코어 룰 4개 등록
헬스_백엔드_정상 (P10): status==200 → verdict=ok헬스_백엔드_장애 (P20): status!=200 → verdict=fail헬스_gateway캐시stale (P30): 직접==200 그리고 gateway==503 → verdict=trident_cache_stale헬스_gateway정상redirect (P40): 직접==200 그리고 gateway==301 → verdict=healthy_redirect
4. gateway 의뢰 trigger 정교화
/Users/ef/.claude/knowledge/triggers/gateway-finance-season1.triggerASSIST_TOOL / REPRODUCE_BACKEND / EXPECTED_DIAGNOSIS_OUTPUT / VERIFY_HANSEON 추가- gateway 세션이 한선씨 도구로 양측 동시 검증할 수 있도록 명령 한 줄 제공
도메인 카탈로그 (7개)
ecosystem(9783) finance(9753) docs(4100) bank(9400) pay(9866) talk(9752) sso(9401) — 베이스 컨텍스트 3절 기준.
8가지 진단 판정
| direct | gateway | verdict |
|---|
| 200 | 200 | healthy |
| 200 | 503/502/504 | trident_cache_stale |
| 200 | 301/308 | healthy_redirect |
| 200 | 0 | gateway_unreachable |
| 0 | 200 | backend_unreachable_cache_warm |
| 0 | 0 | backend_and_gateway_down |
| 그 외 | | mixed_state |
연동 한 줄
ecosystem.crowny.org:9783 의
생태계서버.한선 에 새 라우트
/api/health/full 을 한 줄 추가하면 (
헬스_생태계전체() 호출 → JSON 본문 반환) 다른 세션이 한 번 HTTP GET 으로 전체 상태 조회 가능. 메인 세션이 적용하도록 권고.
관련 파일
/Users/ef/Downloads/CrownyTVM/std/생태계헬스진단.한선 (정본)/Users/ef/Downloads/CrownyTVM/std/생태계헬스진단.han (동본)/Users/ef/.claude/knowledge/triggers/gateway-finance-season1.trigger (의뢰 갱신본)/tmp/v_생태계헬스진단.han (자가검증 러너)
잔여 이슈
- v0.38 한선씨에서 HTTPS(TLS) 미지원 → gateway 측 외부 체크는 HTTP/80 으로 진행. 301/308 응답을 정상 redirect 로 간주(룰 P40).
- 자가검증 실행은 현 세션 샌드박스에서 차단됨(실행 권한 없음). 산식은 코드 안
헬스_자가검증() 에서 7스텝으로 인라인 검증 가능.
- 메인 세션의
생태계서버.한선 에 /api/health/full 라우트 1줄 추가 필요(권고 사항).
학습DB intent
생태계헬스진단_백엔드_diff_trident캐시 — 직접/우회 양측 HTTP GET 후 verdict 산식 + 셀코어 룰 4개 등록 패턴.