This commit is contained in:
2026-07-15 18:33:33 +09:00
parent 6b1583103f
commit f533082537
201 changed files with 19776 additions and 563 deletions
+275
View File
@@ -0,0 +1,275 @@
# Graph Report - wiki (2026-07-12)
## Corpus Check
- 69 files · ~23,462 words
- Verdict: corpus is large enough that graph structure adds value.
## Summary
- 530 nodes · 511 edges · 46 communities (43 shown, 3 thin omitted)
- Extraction: 100% EXTRACTED · 0% INFERRED · 0% AMBIGUOUS
- Token cost: 0 input · 0 output
## Graph Freshness
- Built from commit: `35c65c92`
- Run `git rev-parse HEAD` and compare to check if the graph is stale.
- Run `graphify update .` after code changes (no API cost).
## Community Hubs (Navigation)
- DB: 로그/모니터링 테이블
- auth_rbac.md
- workflow_state.md
- 개념 (Concepts)
- Wiki Log
- ui_templates.md
- A09_Security — Backend
- A00_Common — App Shell Framework
- UI Templates — Localization & Components
- A04_NewsHistory — Frontend
- A07_Register — Frontend
- A08_Support — Backend
- A08_Support — Frontend
- B02_ProjRegister — Frontend
- 인증 / RBAC
- A01_Home — Frontend
- A05_EduDetail — Frontend
- A06_Login — Backend
- A06_Login — Frontend
- A09_Security — Frontend
- B02_ProjRegister — Backend
- Workflow 상태 관리 — 구현 완료 (실 DB 확인됨)
- A03_CompDetail — Frontend
- B04_wf1_Surface — Backend
- DB: 경로/종횡단 테이블
- A07_Register — Backend
- B04_wf1_Surface — Frontend
- B07_wf4_DesignDetail — Frontend
- B09_wf6_Estimation — Frontend
- B05_wf2_Route — Backend
- A01_Home — 세부 구현
- A02_ProgDetail — 세부 구현
- A02_ProgDetail — Frontend
- B05_wf2_Route — Frontend
- B02_ProjRegister — DB
- B04_wf1_Surface — DB
- B04_wf1_Surface — Dependencies
- B06_wf3_ProfileCross — Frontend
- wiki/ 폴더 규칙
- wiki/ 폴더 규칙
- B04_wf1_Surface — API
- B05_wf2_Route — DB 사용 관계
- B06_wf3_ProfileCross — DB 사용 관계
- B01_Dashboard — DB 사용 관계
- B03_FileInput — DB 사용 관계
- B08_wf5_Quantity — DB
## God Nodes (most connected - your core abstractions)
1. `Wiki Log` - 33 edges
2. `개념 (Concepts)` - 12 edges
3. `DB: 로그/모니터링 테이블` - 11 edges
4. `인증 / RBAC` - 10 edges
5. `페이지 — 로그인 후 워크플로우 (B01~B09)` - 10 edges
6. `페이지 — 로그인 전 (A01~A09)` - 10 edges
7. `A07_Register — Frontend` - 10 edges
8. `A08_Support — Backend` - 10 edges
9. `A08_Support — Frontend` - 10 edges
10. `B02_ProjRegister — Frontend` - 10 edges
## Surprising Connections (you probably didn't know these)
- None detected - all connections are within the same source files.
## Communities (46 total, 3 thin omitted)
### Community 0 - "DB: 로그/모니터링 테이블"
Cohesion: 0.05
Nodes (38): DB: 파일/지표면분석 테이블, input_files.status 값, input_files (입력 원본 파일), processed_point_cloud (필터/변환 포인트클라우드), surface_models.status / processed_point_cloud.status 값, surface_models (지표면 모델 및 등고선), terrain_layers (지형 레이어), upload_chunks (업로드 청크 데이터) (+30 more)
### Community 1 - "auth_rbac.md"
Cohesion: 0.05
Nodes (33): API 공통 (여러 페이지가 공유하는 엔드포인트), 공통 오류 응답 포맷 (전 라우터), 워크플로우 상태 조회, 폴링 패턴 (legacy workflow.json 설계; 현재 구현은 workflow-state API 사용), companies (회사), DB: 사용자/인증/조직 테이블, email_otps (이메일 OTP), join_requests (회사 가입 신청) (+25 more)
### Community 2 - "workflow_state.md"
Cohesion: 0.06
Nodes (28): 공통 유틸 (common_util/), 리소스 모니터링 (common_util_resource_monitor.py), 이메일 발송 (common_util_email.py), 백엔드 (Python 3.12.7), 선정 원칙 (agent.md 3절), 외부 라이브러리 의존성, 프론트엔드 (TypeScript/Node.js), DB 컬럼 ↔ 실제 경로 매핑 (+20 more)
### Community 3 - "개념 (Concepts)"
Cohesion: 0.06
Nodes (35): [[a00_app_shell_framework]], [[a00_app_shell_framework_scaffold]], [[A01_Home/A01_frontend|A01_Home]], [[A02_ProgDetail/A02_frontend|A02_ProgDetail]], [[A03_CompDetail/A03_frontend|A03_CompDetail]], [[A04_NewsHistory/A04_frontend|A04_NewsHistory]], [[A05_EduDetail/A05_frontend|A05_EduDetail]], [[A06_Login/A06_backend|A06_Login]] (+27 more)
### Community 4 - "Wiki Log"
Cohesion: 0.06
Nodes (33): [2026-07-12] ingest | A01_Home 실 코드 반영, [2026-07-12] ingest | A02_ProgDetail + A00_Common Framework, [2026-07-12] ingest | A03_CompDetail, [2026-07-12] ingest | A04_NewsHistory, [2026-07-12] ingest | A05_EduDetail, [2026-07-12] ingest | A06_Login (backend + frontend 상세화), [2026-07-12] ingest | A07_Register (backend + frontend 상세화), [2026-07-12] ingest | A08_Support (backend + frontend 상세화) (+25 more)
### Community 5 - "ui_templates.md"
Cohesion: 0.07
Nodes (23): A00_Common — 스캐폴드·CSS·종속성, b_page_scaffold, CSS 인젝션, 사용처, 종속성, B01_Dashboard — Dependencies, 프로젝트 공통 모듈, B01_Dashboard — Frontend (+15 more)
### Community 6 - "A09_Security — Backend"
Cohesion: 0.17
Nodes (11): A09_Security — Backend, API 엔드포인트, DB 저장 (activity_logs), 권한 헬퍼, 마스터(회사 관리자) 전용 — `require_master`, 시스템 관리자 전용 — `require_system_admin`, 요청 스키마 (Pydantic), 의존성 (공통 유틸) (+3 more)
### Community 7 - "A00_Common — App Shell Framework"
Cohesion: 0.18
Nodes (11): A00_Common — App Shell Framework, app_shell 구성요소, router 라우팅 테이블, 로그아웃 (onApp_Logout_Click), 세부 스캐폴드·CSS·종속성, 인증 가드, 인증 버튼 (비동기 fillAuthActions), 테마 & 언어 관리 (+3 more)
### Community 8 - "UI Templates — Localization & Components"
Cohesion: 0.18
Nodes (11): theme.css (스타일 변수), ui_template_elements.ts (공통 컴포넌트), ui_template_locale.ts (다국어 관리), UI Templates — Localization & Components, 사용처 (역참조), 사용처 (역참조), 의존성, 제공 컴포넌트 (+3 more)
### Community 9 - "A04_NewsHistory — Frontend"
Cohesion: 0.18
Nodes (10): A04_NewsHistory — Frontend, CSS 클래스 구조, Mock 데이터 구조, 로컬라이제이션, 미해결 사항, 반응형, 스타일 (CSS), 의존성 (+2 more)
### Community 10 - "A07_Register — Frontend"
Cohesion: 0.18
Nodes (10): A07_Register — Frontend, API 클라이언트 함수, 로컬라이제이션, 스타일 (CSS), 약관 동의 (아코디언), 의존성, 이벤트 핸들러, 제출 로직 (2단계 폼 전환) (+2 more)
### Community 11 - "A08_Support — Backend"
Cohesion: 0.18
Nodes (10): A08_Support — Backend, API 엔드포인트, ⚠️ DB 스키마 불일치 (확인 필요), DB 저장 컬럼 (실 코드 INSERT 기준), 내부 헬퍼, 요청 스키마 (Pydantic), 의존성 (공통 유틸), 접수 로직 (+2 more)
### Community 12 - "A08_Support — Frontend"
Cohesion: 0.18
Nodes (10): A08_Support — Frontend, 로컬라이제이션, 세션 자동 채움, 스타일 (CSS), 의존성, 이벤트 핸들러, 제출 로직, 참고 (+2 more)
### Community 13 - "B02_ProjRegister — Frontend"
Cohesion: 0.18
Nodes (10): B02_ProjRegister — Frontend, 로컬라이제이션, 스타일 (CSS), 의존성, 이벤트 핸들러, 입력 필드, 제출 로직, 참고 (+2 more)
### Community 14 - "인증 / RBAC"
Cohesion: 0.20
Nodes (10): OTP / 비밀번호, ⚠️ 계획서-실코드 불일치 (A그룹 인제스트 발견), 권한 검증 헬퍼 (B01_Dashboard), 라우팅 가드 (frontend.md 5.2), 사용자 상태 생명주기, 사용처 (역참조), 세션 인증 (backend.md 6.3), 역할 (users.role) (+2 more)
### Community 15 - "A01_Home — Frontend"
Cohesion: 0.20
Nodes (9): A01_Home — Frontend, Hero 섹션, 로컬라이제이션, 세부 구현, 이벤트 핸들러, 주요 기능 섹션, 최신 소식 섹션, 컴포넌트 (+1 more)
### Community 16 - "A05_EduDetail — Frontend"
Cohesion: 0.20
Nodes (9): A05_EduDetail — Frontend, CSS 클래스 구조, 로컬라이제이션, 반응형, 스타일 (CSS), 의존성, 이벤트 핸들러, 컴포넌트 (섹션 빌더) (+1 more)
### Community 17 - "A06_Login — Backend"
Cohesion: 0.20
Nodes (9): A06_Login — Backend, API 엔드포인트, ⚠️ 계획서와 실 코드 불일치, 내부 헬퍼, 로그인 로직 흐름, 보안 정책 (실 코드 기준), 요청 스키마 (Pydantic), 의존성 (공통 유틸) (+1 more)
### Community 18 - "A06_Login — Frontend"
Cohesion: 0.20
Nodes (9): A06_Login — Frontend, API 클라이언트 함수, 로컬라이제이션, 스타일 (CSS), 의존성, 이벤트 핸들러, 제출 로직 (2단계 폼 전환), 컴포넌트 / 함수 (+1 more)
### Community 19 - "A09_Security — Frontend"
Cohesion: 0.20
Nodes (9): A09_Security — Frontend, API 클라이언트 함수 (⚠️ 미사용, 정의만), 로컬라이제이션, 스타일 (CSS), 약관 데이터 (A09_Security_Terms.ts), ⚠️ 약관 텍스트와 실 코드 불일치, 의존성, 컴포넌트 / 함수 (+1 more)
### Community 20 - "B02_ProjRegister — Backend"
Cohesion: 0.20
Nodes (9): API 엔드포인트, B02_ProjRegister — Backend, DB 저장 컬럼 (projects INSERT), 생성 로직 (create_project 트랜잭션), 요청/응답 스키마 (Pydantic), 의존성 (공통 유틸), 참고, 파일 구조 (+1 more)
### Community 21 - "Workflow 상태 관리 — 구현 완료 (실 DB 확인됨)"
Cohesion: 0.22
Nodes (9): B04 상태 조회 — 레거시 폴백 (당초 "잔재"로 표기했으나 정정), projects.status 문자열 캐시 (호환용, 계획서 방침대로 유지 중), SSOT: `project_workflow_stages` 테이블 (실 DB 확인), Workflow 상태 관리 — 구현 완료 (실 DB 확인됨), 공통 유틸 `common_util/common_util_workflow_state.py`, 미해결 사항 (계획서 원문, 아직 결정 안 됨), 상태 전이 (구현대로), 실 연동 현황 (파일:줄번호) (+1 more)
### Community 22 - "A03_CompDetail — Frontend"
Cohesion: 0.22
Nodes (8): A03_CompDetail — Frontend, CSS 클래스 구조, 로컬라이제이션, 반응형, 스타일 (CSS), 의존성, 컴포넌트 (섹션 빌더), 파일 구조
### Community 23 - "B04_wf1_Surface — Backend"
Cohesion: 0.22
Nodes (8): B04_wf1_Surface — Backend, ⚠️ 레거시 폴백 (416,420줄), 엔진 서브모듈, 워크플로우 상태 전이, 의존성, 주요 함수 (Router), 책임, 파일 구성 (오케스트레이터/저장소/라우터)
### Community 24 - "DB: 경로/종횡단 테이블"
Cohesion: 0.25
Nodes (8): cross_sections.data.structures, cross_sections (횡단면 설계), DB: 경로/종횡단 테이블, longitudinal_sections (종단면 설계), route_points (경로 좌표점), route_statistics (노선 통계), routes.status 흐름, routes (노선 경로)
### Community 25 - "A07_Register — Backend"
Cohesion: 0.25
Nodes (7): A07_Register — Backend, API 엔드포인트, 가입 로직 흐름, 요청 스키마 (Pydantic), 의존성 (공통 유틸), 참고, 파일 구조
### Community 26 - "B04_wf1_Surface — Frontend"
Cohesion: 0.25
Nodes (7): API 클라이언트 함수, B04_wf1_Surface — Frontend, ⚠️ 계획서와 실 코드 불일치 (3D 뷰어), 의존성, 처리 흐름, 컴포넌트 / 함수, 파일 구조
### Community 27 - "B07_wf4_DesignDetail — Frontend"
Cohesion: 0.25
Nodes (7): B07_wf4_DesignDetail — Frontend, 로컬라이제이션, 백엔드/DB — 미착수 (계획적 범위 제외), 의존성, 참고, 컴포넌트 / 함수, 파일 구조
### Community 28 - "B09_wf6_Estimation — Frontend"
Cohesion: 0.25
Nodes (7): B09_wf6_Estimation — Frontend, 로컬라이제이션, 백엔드/DB — 미착수, 의존성, 참고, 컴포넌트 / 함수, 파일 구조
### Community 29 - "B05_wf2_Route — Backend"
Cohesion: 0.29
Nodes (6): B05_wf2_Route — Backend, 경로 계산 엔진, 기술부채, 기하·결과 변환, 라우터·workflow, 요청·응답 모델
### Community 30 - "A01_Home — 세부 구현"
Cohesion: 0.33
Nodes (5): A01_Home — 세부 구현, 데이터 흐름, 미해결, 스타일, 의존성
### Community 31 - "A02_ProgDetail — 세부 구현"
Cohesion: 0.33
Nodes (5): A02_ProgDetail — 세부 구현, 데이터 흐름, 미해결 / 특이사항, 스타일 (CSS), 의존성
### Community 32 - "A02_ProgDetail — Frontend"
Cohesion: 0.33
Nodes (5): A02_ProgDetail — Frontend, 구조, 세부 구현, 제약 준수, 컴포넌트 분석
### Community 33 - "B05_wf2_Route — Frontend"
Cohesion: 0.33
Nodes (5): API 클라이언트, B05_wf2_Route — Frontend, 기술부채, 입력 그룹, 화면과 상호작용
### Community 34 - "B02_ProjRegister — DB"
Cohesion: 0.40
Nodes (4): B02_ProjRegister — DB, 쓰는 테이블, 저장소(파일시스템), 참고 (계획 당시 의도)
### Community 35 - "B04_wf1_Surface — DB"
Cohesion: 0.40
Nodes (4): B04_wf1_Surface — DB, Repository 함수, 쓰는 테이블, 참고
### Community 36 - "B04_wf1_Surface — Dependencies"
Cohesion: 0.40
Nodes (4): B04_wf1_Surface — Dependencies, ⚠️ dependencies concept 정정 필요, 백엔드 (Python), 프론트엔드 (TypeScript)
### Community 37 - "B06_wf3_ProfileCross — Frontend"
Cohesion: 0.40
Nodes (4): API 클라이언트, B06_wf3_ProfileCross — Frontend, 입력 옵션, 화면·workflow
### Community 38 - "wiki/ 폴더 규칙"
Cohesion: 0.50
Nodes (3): wiki/ 폴더 규칙, 구조, 작성 규칙
### Community 39 - "wiki/ 폴더 규칙"
Cohesion: 0.50
Nodes (3): wiki/ 폴더 규칙, 구조, 작성 규칙
### Community 40 - "B04_wf1_Surface — API"
Cohesion: 0.50
Nodes (3): B04_wf1_Surface — API, 엔드포인트, 요청/응답 스키마 (Pydantic)
### Community 41 - "B05_wf2_Route — DB 사용 관계"
Cohesion: 0.50
Nodes (3): B05_wf2_Route — DB 사용 관계, Repository 함수, 저장 경로
### Community 42 - "B06_wf3_ProfileCross — DB 사용 관계"
Cohesion: 0.50
Nodes (3): B06_wf3_ProfileCross — DB 사용 관계, Repository 함수, 파일 경로
## Knowledge Gaps
- **379 isolated node(s):** `구조`, `작성 규칙`, `구조`, `작성 규칙`, `파일 구성` (+374 more)
These have ≤1 connection - possible missing edges or undocumented components.
- **3 thin communities (<3 nodes) omitted from report** — run `graphify query` to explore isolated nodes.
## Suggested Questions
_Questions this graph is uniquely positioned to answer:_
- **Why does `UI Templates — Localization & Components` connect `UI Templates — Localization & Components` to `ui_templates.md`?**
_High betweenness centrality (0.015) - this node is a cross-community bridge._
- **Why does `A00_Common — App Shell Framework` connect `A00_Common — App Shell Framework` to `ui_templates.md`?**
_High betweenness centrality (0.014) - this node is a cross-community bridge._
- **What connects `구조`, `작성 규칙`, `구조` to the rest of the system?**
_379 weakly-connected nodes found - possible documentation gaps or missing edges._
- **Should `DB: 로그/모니터링 테이블` be split into smaller, more focused modules?**
_Cohesion score 0.045454545454545456 - nodes in this community are weakly interconnected._
- **Should `auth_rbac.md` be split into smaller, more focused modules?**
_Cohesion score 0.05110336817653891 - nodes in this community are weakly interconnected._
- **Should `workflow_state.md` be split into smaller, more focused modules?**
_Cohesion score 0.06156156156156156 - nodes in this community are weakly interconnected._
- **Should `개념 (Concepts)` be split into smaller, more focused modules?**
_Cohesion score 0.05555555555555555 - nodes in this community are weakly interconnected._