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
parent d7cb14f416
commit eb30b774f8
527 changed files with 43083 additions and 2 deletions
@@ -0,0 +1,7 @@
+# output/ 폴더 규칙
+
+wiki/ 내용을 바탕으로 생성한 최종 산출물(보고서, 슬라이드, 요약 문서 등)을 둔다.
+
+## 규칙
+- 여기 있는 파일은 wiki/의 특정 시점 스냅샷이다. 원본이 아니므로, 내용 갱신이 필요하면 wiki/를 먼저 갱신한 뒤 다시 생성한다.
+- 파일명에 생성 날짜를 포함해 버전을 구분한다.
@@ -0,0 +1,7 @@
+# output/ 폴더 규칙
+
+wiki/ 내용을 바탕으로 생성한 최종 산출물(보고서, 슬라이드, 요약 문서 등)을 둔다.
+
+## 규칙
+- 여기 있는 파일은 wiki/의 특정 시점 스냅샷이다. 원본이 아니므로, 내용 갱신이 필요하면 wiki/를 먼저 갱신한 뒤 다시 생성한다.
+- 파일명에 생성 날짜를 포함해 버전을 구분한다.
@@ -0,0 +1,63 @@
+---
+type: graph-relationship-audit
+status: draft
+last_updated: 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_file`은 `docs/wiki/` 아래이며 누락 근거는 0이다.
@@ -0,0 +1,50 @@
+---
+type: wiki-lint-report
+status: draft
+last_updated: 2026-08-16
+---
+
+# 위키 의미 린트 보고서 — 2026-08-16
+
+## 요약
+
+| 항목 | 값 |
+|---|---:|
+| 검사 문서 | 157 |
+| error | 0 |
+| warning | 18 |
+| info | 0 |
+
+> error가 남아 있으면 Graphify 재생성을 진행하지 않는다.
+
+## error (0)
+
+- 없음
+
+## warning (18)
+
+| 규칙 | 파일 | 내용 |
+|---|---|---|
+| `line-limit-exception` | `log.md` | 운영 문서가 992줄이다. |
+| `source-missing` | `log.md` | 존재하지 않는 근거: docs/raw/plans/2026-07-12_plan_add_phase4_role.md |
+| `wikilink-unresolved` | `log.md` | 대상: A08_Support/backend |
+| `wikilink-unresolved` | `log.md` | 대상: A07_Register/backend |
+| `wikilink-unresolved` | `log.md` | 대상: B01_Dashboard/backend |
+| `wikilink-unresolved` | `log.md` | 대상: A09_Security/backend |
+| `wikilink-unresolved` | `log.md` | 대상: ui_template_locale |
+| `wikilink-unresolved` | `log.md` | 대상: ui_template_elements |
+| `wikilink-unresolved` | `log.md` | 대상: A06_Login/backend |
+| `wikilink-unresolved` | `log.md` | 대상: A00_Common/app_shell_framework |
+| `wikilink-unresolved` | `log.md` | 대상: ../../concepts/... |
+| `wikilink-unresolved` | `log.md` | 대상: db_schema/... |
+| `wikilink-unresolved` | `log.md` | 대상: db_schema |
+| `wikilink-unresolved` | `log.md` | 대상: 페이지/backend/파일명 |
+| `wikilink-unresolved` | `log.md` | 대상: B02_ProjRegister/backend |
+| `wikilink-unresolved` | `log.md` | 대상: A01_Home/frontend |
+| `wikilink-unresolved` | `log.md` | 대상: B09_Estimation/frontend |
+| `wikilink-unresolved` | `log.md` | 대상: B08_DesignDetail/frontend |
+
+## info (0)
+
+- 없음
+