Aislo/docs/raw/PLAN.md

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를 초기화합니다.