Files
Aislo/docs/output/wiki_recovery/graph_relationship_audit_2026-08-16.md
T
eomsangdonandClaude Opus 5 eb30b774f8 chore(docs): docs 폴더 git 추적 전환 · PLAN·OWNERS 최상위 이관
- `docs/` 를 .gitignore 에서 빼 git 추적 대상으로 전환 (위키·완료 이력·검증 기록)
- `docs/raw/PLAN.md` · `docs/raw/OWNERS.md` 를 저장소 최상위로 이동 후 .gitignore 에 등록
  — 창끼리 공유하되 저장소에는 안 올리는 장부
- 살아 있는 경로 참조 7개 파일 정정 (아카이브 107건은 그때 사실이라 그대로 둠)
- graphify 날짜별 산출물(`docs/wiki/graphify-out/20*/`) 제외 — `graphify update` 가 다시 만듦

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-09 18:19:07 +09:00

2.7 KiB

type, status, last_updated
type status last_updated
graph-relationship-audit draft 2026-08-16

Graphify 저연결 노드 감사 — 2026-08-16

기준선

항목
전체 노드 86
차수 0 17
차수 1 40
저연결 합계 57

판정

분류 처리
관계 보강 대상 24 상위 지도·공유 자원·canonical 페이지에 직접 관계 추가
정상 말단 문서 32 개별 Router·UI·하위 컴포넌트이므로 유지
의도적 참고 문서 1 외부 WebCAD 비교환경; 현행 구현 관계와 분리

관계 보강 대상

유형 대상 보강 관계
상위 지도 공개·인증·관리 지도, 프로젝트 지도, 구현 현황 프로젝트 지도와 상호 연결
공통 개념 인증, 배수, 유토, 저장 경로, UI Templates, dependencies 공유 자원 지도와 실제 소비 단계 연결
공통 프레임워크 A00 Common App Shell·Router·UI Templates 연결
공개 화면 A01~A05 Frontend 공개·인증·관리 지도와 연결
단계 API B01·B03·B04·B05·B06 API 해당 Backend와 연결
세부 엔진 B06 Engine Areas B06 Backend와 연결
B07 DB workflow 상태와 연결 전용 수량 DB가 없음을 명시
B08 Dependencies B08 Backend/Frontend와 dependencies 연결 CAD 의존성 범위 명시

정상 말단 판정 원칙

  • 파일 단위 Router는 상위 Backend 하나와 연결돼 있으면 정상이다.
  • 파일 단위 UI 컴포넌트는 상위 Frontend 또는 조립 컴포넌트 하나와 연결돼 있으면 정상이다.
  • 연결 수를 늘리기 위해 호출·데이터 관계가 없는 링크를 추가하지 않는다.
  • 저연결 수 자체를 품질 목표로 삼지 않고, 상위 탐색 경로가 존재하는지를 기준으로 삼는다.

의도적 참고 문서

B07 외부 WebCAD 비교 실행환경은 과거 후보 비교 기록이다. 현행 B08 OpenWebCAD 구현의 직접 의존성으로 연결하지 않고, historical_reference로만 분류한다.

보강 후 결과

항목 보강 전 보강 후
전체 노드 86 87
전체 관계 58 75
차수 0 17 0
차수 1 40 50
  • 차수 0은 모두 해소됐다.
  • 차수 1 증가는 API·Router·UI·페이지 요약을 별도 canonical 노드로 정확히 분리한 결과다.
  • 최종 차수 1 구성은 page summary 21, backend file 10, frontend file 8, concept 9, architecture 2다.
  • 말단 문서를 억지로 다중 연결하지 않고 상위 탐색 경로만 보장하는 원칙을 유지한다.
  • 모든 노드와 관계의 source_filedocs/wiki/ 아래이며 누락 근거는 0이다.