---
kind: graphify-meta
last_generated_at: 2026-06-24T14:05:00+0900
source_commit: a74bf74
scopes:
  - src
  - docs
---

# 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-24 | `a74bf74` | `src/` (Java + AST) | **W1 RBAC/거버넌스 + W2 게임잼 워크스트림 반영**(b9d836d→a74bf74, 75파일 +10119/-43). RBAC 군집: RbacInterceptor·PermissionGate·JamRoleGate·Roles·PermissionKeys·InterceptorConfig·PermissionCatalogVerifier + AdminConsoleController(관리자 콘솔·권한 게이트). 게임잼 군집: jam 도메인(JamLifecycle·JamAwardService·RankScores·JamStatus·JamSlugs·JamEvalWindow·AwardTrack) + Jam 컨트롤러 7 + 매퍼 15 + data 9 흐름(jams/judges/criteria/scores/votes/awards). 기존 Spring MVC 컨트롤러→매퍼→data 흐름·리뷰 다축평점·댓글 군집 유지. 정적 이미지 제외. |
| `docs` | 2026-06-24 | `a74bf74` | `docs/` (md + DDL) | **W1/W2 스키마·로그 반영**(16파일 +980/-22). 신규 DDL 4: jam-ddl·jam-judge-ddl·jam-eval-ddl·rbac-ddl(테이블 10 + jam_score_stats VIEW) — jams/judges/criteria/scores/votes/awards + RBAC 권한 스키마 군집. work-log 2 추가. 기존 문서 카테고리 체계 + 보안·검증 + 플랫폼 로드맵 + game_reviews 계열 스키마 군집 유지. |

## 갱신 시 체크리스트

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