Plan Consolidation Master Table

Newsfork 논리적 문서 구조

모든 문서 루트: docs/src/content/docs/ko/. 제목은 영어, 본문은 한국어.

---

1. v1/api/ (Core Interface)

신규 경로	기존 문서 소스	비고
seeds-api.md	health.md, research.md, seeds.md	Seeds·Research·Health API 통합 (엔진 핵심 인터페이스)
data-management-api.md	datasets.md, metadata.md	Datasets·Metadata API (데이터 처리)
infrastructure-api.md	queues.md	Queues API (비동기 처리)
category-reference.md	reference/category-reference.md	API 공통 카테고리·규격 참조

---

2. v1/guides/ (Engineering & System Design)

system-architecture/

신규 경로	기존 문서 소스	비고
personalization-engine-design.md	v1/guides/personalization-engine-design.md	뉴스 개인화 엔진 설계
seed-engine-workflow.md	v1/guides/seed-engine-workflow.md	Seed 엔진 설계 및 워크플로우
error-handling-design.md	plan/design/error-handling-design.md	에러 처리 및 디버깅 설계

deployment-ops/

신규 경로	기존 문서 소스	비고
environment-setup.md	user-manual/environment.md, plan/setup/*	환경 설정 및 setup 스크립트 분석 통합
cicd-pipeline-guide.md	plan/deploy/README, deploy-yml-, deploy-error-, checkout-, plan/ci-cd/	deploy.yml 7개 문서 + CI/CD 통합 가이드
cloudflare-migration.md	plan/infra/cloudflare-migration-plan.md, cloudflare-error-analysis-and-improvement.md	Cloudflare 마이그레이션 및 운영 가이드

development-workflow/

신규 경로	기존 문서 소스	비고
local-testing-optimized.md	user-manual/local-testing.md, plan/ci-cd/local-test-and-ci-optimization.md	로컬 테스트 환경 및 최적화
code-quality-standard.md	plan/code-quality/README, code-review-and-cleanup-plan, code-cleanup-completed, refactoring-plan	리팩토링·코드 리뷰 표준 (코드 정리 완료 통합)
cursor-rules-standard.md	plan/cursor-rules/README, cursor-rules-improvement-plan, cursorrules-upgrade-plan, cursorrules-missing-content	Cursor Rules 업그레이드 및 최적화 가이드

---

3. user-manual/ (Product & Operations)

신규 경로	기존 문서 소스	비고
manual-overview.md	index.md 또는 신규	전체 사용자 매뉴얼 개요
translation-pipeline.md	v1/guides/translation.md, automated-translation-pipeline-design.md	자동 다국어 문서 파이프라인 (KO→EN)
logpush-r2-guide.md	plan/logpush/README, logpush-r2-secrets-guide, logpush-integration-plan, logpush-unify-plan	Logpush 설정 및 R2 시크릿 관리
deployment.md	user-manual/deployment.md	배포 절차 (유지)
environment.md	(environment-setup으로 guides 이동 시 삭제 또는 링크)	환경 가이드 (guides와 역할 구분)
local-testing.md	(local-testing-optimized로 guides 이동 시 삭제 또는 링크)	로컬 테스트 (guides와 역할 구분)

---

4. archive/whitepaper/ (Historical & Strategic Records)

project-milestones/

신규 경로	기존 문서 소스	비고
phase2-analysis.md	plan/default/phase2-analysis.md	Phase 2 분석
phase2-completed.md	plan/default/phase2-completed.md	Phase 2 완료
phase3-completed.md	plan/default/phase3-completed.md	Phase 3 완료
phase3-test-results.md	plan/default/phase3-test-results.md	Phase 3 테스트 결과
local-test-results.md	plan/default/local-test-results.md	로컬 테스트 결과

incident-reports/

신규 경로	기존 문서 소스	비고
incident-reports.md	plan/deploy/deploy-error-analysis.md, deploy-error-analysis-and-solution.md, deploy-logpush-failure-analysis.md, plan/ci-cd/logpush-ci-failure-analysis.md, plan/build/build-error-analysis.md	배포 에러·Logpush 실패·빌드 에러 등 트러블슈팅 기록 통합

market-research/

신규 경로	기존 문서 소스	비고
competitor-comparison.md	reference/competitor-comparison-table.md	경쟁사 비교 분석

루트

신규 경로	기존 문서 소스	비고
seed-engine-design.md	archive/whitepaper/seed-engine-design.md	Seed Engine 설계 (유지)
change-log.md	changelog.md	프로젝트 전체 변경 이력 (신규 기능 기록 통합)

---

정리 전략 요약

• 중복 제거: deploy.yml 관련 7개 문서 → cicd-pipeline-guide.md 하나로 통합.
• 결과 중심: 기획·완료·요약으로 나뉜 코드 정리 문서 → code-quality-standard.md 등 결과 중심 Standard 문서로 변환 후 나머지 삭제.
• 트러블슈팅 통합: 배포 에러·Logpush 실패·빌드 에러 분석 → incident-reports/ 단일 문서 또는 소수 문서로 통합.
• 파일명 표준화: 모든 파일명 kebab-case 영문. 날짜 포함 기획 문서는 archive로 이동 또는 최신 가이드에 병합.