← 목록
기타 2026-06-13 4KB 읽기 4분

에임드 통합보기 실데이터 + API 실측 도구 (2026-06-13 백로그 라운드)

개요

UX 전수고도화 백로그 후속. 잡무집사 기능감사가 "미구현 19건"이라 했으나 전수 실측 결과 진짜 미구현은 /api/cellmap 1건뿐(18건은 GET으로 POST 라우트 찌르기·다중서버·쿼리 미구분에 의한 거짓양성). 데이터 감사의 "16KB 임박"도 본파일 직접 소비자 0건이라 거짓양성. 진짜 결함을 근본 수정하고, 같은 거짓양성을 막을 도구를 축적. 적대 검증(opus)이 1차 수정의 숨은 결함 2건을 추가 적발 → 근본 재수정. 분업 누적 42건 위반 0.

진짜 미구현 1건: GET /api/cellmap (통합보기 핵심)

방금 고친 통합보기 전용 창(core.html, aimed-admin.crowny.org/core)이 정작 /api/cellmap 부재로 가짜 DEMO 데이터만 띄우고 있었음. 관리서버에 신규 구현:

  • 데이터: 모듈카탈로그(클러스터)×모듈자동판정(4상)×모듈친근(라벨) join, awk 전처리(도구/cellmap집계.awk + .sh)로 16KB 회피
  • 응답: 15 클러스터 도메인, 각 셀수·4상 상태·룰·대표 항목. 9946B
  • 적대 검증이 잡은 결함 → 재수정: 자동판정에 없는 322모듈이 빈 값+가짜 옴으로 집계되던 것을 판정 데이터 있는 모듈만 항목 포함으로 정직화(빈값 70→0, 요약 옴 83→48 실판정, 티 15→29, 항목 77). 클러스터 상태 일관성 버그(동일분포 재무=T/운영=O)를 단일규칙(A≥1→A, T>O→T, 그 외 O)으로 통일.

근본 결함: 미스경로가 HTTP 200 반환 (시스템 정직성)

관리서버 미스경로 핸들러가 _JSON응답(200 하드코딩)을 호출 → 존재 안 하는 경로도 200+에러본문 반환. 이것이 "상태코드 오탐"의 뿌리(잡무집사 감사·API도구 모두 라우트 존재 오판). _응답(소켓, 404, ...)(이미 존재)로 교체 → /api/없는것 → 진짜 404, 정상 라우트 전부 회귀(modules/cellmap/accrued/core/overview 200).

축적 도구: API 실측 검증 (사용자 "역할별 필요도구 축적")

거짓양성의 근원(GET/POST·다중서버·소프트404 미구분)을 푸는 재실행 도구 도구/:

  • data/API맵.psv — 7서버 70라우트(서버 소스의 실제 경로 기준, 방식·바디 명시)
  • API검증.sh — 방식대로 curl + 판정(404 또는 200+"경로를 찾을 수 없" 본문 → 미구현; "세션을 찾을 수 없"는 구현 유지로 정확 구분)
  • API검증.한선 — 서버별 구현/미구현 집계 + 4상 + 이력 append
  • API점검.sh — 진입점. 가짜경로 주입 시 9905 미구현 정확 판정(변별력 검증됨). 한계: 9906(상담 Node 단일 POST)은 모든 GET에 200 서비스정보라 GET 변별 불가(라우트 /chat 하나뿐이라 실용 무영향, 기록).

검증 (실측)

  • cellmap: 도메인 15, 항목 77, 빈값 0, 요약 티29/옴48/타0(타=0은 소스에 A우세 0개라 정확), demo:false
  • 미스경로 404 + 정상 라우트 200 회귀
  • API 도구: 가짜경로 미구현 정확, 70 실라우트 구현 유지, 거짓양성 0

핵심 교훈 (지식·메모리 등재)

  1. 기능 감사는 GET/POST·다중서버·소프트404를 가려야 한다 — fetch 경로만 보고 GET 일괄 찌르면 거짓양성 폭증(19→실제 1).
  2. 미스경로는 진짜 404로 — 200+에러본문은 모든 자동 점검을 오염시킨다.
  3. 집계 도구는 조인 부재를 가짜 상태로 메우지 마라 — 미판정을 "진행중"으로 표시하면 통합보기가 거짓.

관련 파일

관리서버.한선(.bak_404cm_, .bak_cellmap_), 도구/{cellmap집계.awk(.sh), API맵.psv, API검증.sh, API검증.한선, API점검.sh, API검증이력.psv}, public/core.html(무수정), 감사/(이전 라운드)

잔여 백로그

경영AI 고아 API 4→경영.html 패널, 크로스도메인 sso 일관화, 상담:/ 57점, 9906 GET 변별(실용 낮음), cellmap 클러스터 cap8 표시 vs 전체 상태 산정 문서화.