Graph — graphify 산출물 메타

이 디렉토리는 /graphify 가 생성하는 지식 그래프 산출물의 메타 정보만 커밋한다. HTML/JSON/audit 본체는 .gitignore 대상이며 재생성 가능하다.

설치·적용 가이드는 atp-graphify add-on 번들의 graphify-usage.md 참조.

엔트리포인트 사용법

구조 탐색이 필요한 작업 전에 이 파일의 last_generated_at 과 source_commit 을 확인한다.
메인 브랜치 기준 마지막 소스 커밋보다 뒤쳐져 있다면 graph-refresh-checker 서브에이전트를 호출해 staleness 판정을 받는다.
판정 결과가 partial-stale / fully-stale 이면 메인 에이전트가 /graphify 를 호출해 재생성하고, 이 파일을 갱신한다.
더 이상 관련 없는 scope (제거된 모듈 등) 의 산출물은 재생성 전 삭제 한다.

산출물 레이아웃

docs/graph/
├── index.md               # 이 파일 — 메타, 커밋 대상
├── .gitignore             # 본체 무시
└── <scope>/               # scope 별 산출물 디렉토리 (무시됨)
    ├── graph.html
    ├── graph.json
    └── audit.md

scope 예시: src, src-features, docs, full 등. 한 번에 여러 scope 를 운용할 수 있다.

Scopes

scope	마지막 생성	소스 커밋	대상 경로	요약
`src`	2026-06-29	`305cc73`	`src/` (Java + AST)	W3(잔여)+W4 워크스트림 반영(a74bf74→305cc73, 77파일 +10163/-103, AST 1825노드/4292엣지/79커뮤니티). 신규 군집: 태그/검색(Tag·Search 컨트롤러 + Tags/GameTags/JamTags/GameViews 매퍼 + TagSanitizer + searchGamesAdvanced), 메인허브 keyset(WebMvcController cursor + GamesMapper listVisibleKeyset/searchVisibleKeyset + idx_games_visible_keyset), 게시판/SSRF/유니티피드(Post·PostAdmin·UnityFeedAdmin 컨트롤러 + PostMarkdownService + OgPreviewService + UnityFeedPoller + FeedParser + SsrfSafeFetcher + SchedulingConfig), 업로드보안(ZipSecurity·ZipRejectException + GameUploadController 보강 + GameAssetCleanupService + GameUploadAuditMapper), 배지/평판(BadgeService·ReputationService·BadgeKeys + Badges/UserBadges/UserBadgesQuery/ReputationEvents 매퍼 + BadgeCatalogSeeder + BADGE_MANAGE). 기존 W1 RBAC·W2 게임잼·리뷰·댓글 군집 유지. 정적 이미지/업로드 제외(AST 기반).
`docs`	2026-06-29	`305cc73`	`docs/` (md + DDL)	W3/W4 스키마·변경이력 반영(semantic 198노드/282엣지/14커뮤니티). 신규 DDL 5: tag-ddl·games-hub-ddl·board-ddl·game-upload-ddl·badge-ddl(테이블/뷰 12 + 인덱스) — tags/game_tags/jam_tags/game_views·post_categories/posts/unity_feed_sources/unity_feed_items·game_upload_audit_log·badges/user_badges/reputation_events 스키마 군집. changes 2026-06-29 W3/W4 변경이력 + 구현추적 갱신. 기존 W1/W2 스키마·문서 카테고리·보안·검증·로드맵 군집 유지. graphify 본체(docs/graph/{src,docs}/) 자기참조 제외.

갱신 시 체크리스트

frontmatter 의 last_generated_at, source_commit, scopes 갱신
아래 "Scopes" 표에 한 줄 추가/갱신
폐기된 scope 가 있다면 해당 디렉토리 rm -rf + 표에서 제거

3.4 KiB Raw Blame History

Graph — graphify 산출물 메타

엔트리포인트 사용법

산출물 레이아웃

Scopes

갱신 시 체크리스트

3.4 KiB

Raw Blame History