46 lines
2.9 KiB
Markdown
46 lines
2.9 KiB
Markdown
# PLAN: 위키 린트(Lint) 결과 조치 및 건강도 개선
|
|
|
|
본 계획은 위키 린트 결과 발견된 구조적 문제들을 정밀 수정(Surgical Edit)하여 위키 건강도 및 무결성을 회복하는 것을 목표로 합니다.
|
|
|
|
## 작업 대상 및 조치 계획
|
|
|
|
### 1. frontmatter status 누락 조치
|
|
* **대상 파일**: `docs/wiki/concepts/db_schema/unconfirmed/README.md`
|
|
* **조치 내용**: YAML frontmatter를 추가하고 `status: draft`를 명시하여 상태 관리 정합성을 맞춥니다.
|
|
|
|
### 2. 파일 줄 수 제한 초과 조치 (100줄 이내 축소)
|
|
* **대상 파일**: `docs/wiki/concepts/db_schema/logs_monitoring.md`
|
|
* **조치 내용**: 현재 103줄로 100줄 제한을 약간 초과한 상태입니다. 하단부의 사용처 설명 단락의 개행을 정리하여 파일 크기를 100줄 이하로 최적화합니다.
|
|
|
|
### 3. 고아 페이지(Orphaned Pages) 연결 보완 ✅ 완료
|
|
* **대상 파일**: 4개의 의존성(`dependencies.md`) 페이지들
|
|
- `pages/B01_Dashboard/B01_dependencies.md`
|
|
- `pages/B03_FileInput/B03_dependencies.md`
|
|
- `pages/B05_wf2_Route/B05_dependencies.md`
|
|
- `pages/B06_wf3_ProfileCross/B06_dependencies.md`
|
|
* **조치 내용**: 각 폴더의 메인 문서(예: `B01_backend.md`, `B03_backend.md` 등) frontmatter의 `related_pages` 리스트에 해당 의존성 문서 링크(예: `"[[B01_Dashboard/B01_dependencies]]"`)를 추가하여, 고아 상태를 해제하고 문서 간 유기적 연결을 형성합니다.
|
|
|
|
### 4. 위키 링크 정비 (Broken Links 교정)
|
|
* **대상 파일**: `docs/wiki/AGENTS.md` 및 `docs/wiki/CLAUDE.md`
|
|
* **조치 내용**: 문서 내 특수문자나 인코딩으로 인해 비정상적으로 생성된 깨진 위키링크(`[[]]` 등)를 확인하여 삭제하거나 정상화합니다.
|
|
|
|
### 5. support_requests 컬럼 불일치 확인 및 동기화
|
|
* **대상**: `[[A08_Support/A08_backend]]`, `[[db_schema/logs_monitoring]]`, 실 DB
|
|
* **조치 내용**: 계획서 vs 실 코드 vs 실 DB의 컬럼 정의를 맞춘다.
|
|
- 계획서: user_id/title/priority/status
|
|
- 실 코드: company_id/company_name/user_name/user_email/user_phone/subject/message
|
|
|
|
### 6. A07/A09 구버전 코드 정리
|
|
* **대상**: `A07_Register_UI_Page.ts` (구버전 잔재), `A09_Security_Api_Fetch.ts` (미연동)
|
|
* **조치 내용**: 불필요한 코드 제거 및 wiki 문서 갱신
|
|
|
|
### 7. B04 레거시 코드 명확화
|
|
* **대상**: `B04_wf1_Surface_Router.py:412-427`, `B04_wf1_Surface_Router.py:76`
|
|
* **조치 내용**: `projects.status` 문자열 비교의 의도(폴백 vs 구형) 명확화 및 `update_project_status()` 호출처 추적
|
|
|
|
---
|
|
|
|
## 검증 계획
|
|
1. 수정 완료 후 `wiki_lint.py`를 다시 실행하여 린트 오류가 모두 제거(또는 정상 수준으로 감소)되었는지 확인합니다.
|
|
2. 검증이 완료되면 `verify` 보고서를 작성하고 `PLAN.md`를 초기화합니다.
|