Plan Consolidation Master Table
Newsfork Logical Document Structure
Section titled “Newsfork Logical Document Structure”All documents root: docs/src/content/docs/ko/. Title in English, body in Korean.
1. v1/api/ (Core Interface)
Section titled “1. v1/api/ (Core Interface)”| New Path | Existing Document Source | Notes |
|---|---|---|
| seeds-api.md | health.md, research.md, seeds.md | Seeds·Research·Health API Integration (Engine Core Interface) |
| data-management-api.md | datasets.md, metadata.md | Datasets·Metadata API (Data Processing) |
| infrastructure-api.md | queues.md | Queues API (Asynchronous Processing) |
| category-reference.md | reference/category-reference.md | API Common Category·Specification Reference |
2. v1/guides/ (Engineering & System Design)
Section titled “2. v1/guides/ (Engineering & System Design)”system-architecture/
Section titled “system-architecture/”| New Path | Existing Document Source | Notes |
|---|---|---|
| personalization-engine-design.md | v1/guides/personalization-engine-design.md | News personalization engine Design |
| seed-engine-workflow.md | v1/guides/seed-engine-workflow.md | Seed Engine Design and Workflow |
| error-handling-design.md | plan/design/error-handling-design.md | Error Handling and Debugging Design |
deployment-ops/
Section titled “deployment-ops/”| New Path | Existing Doc Source | Notes |
|---|---|---|
| environment-setup.md | user-manual/environment.md, plan/setup/* | Environment Setup and Setup Script Analysis Integration |
| cicd-pipeline-guide.md | plan/deploy/README, deploy-yml-, deploy-error-, checkout-, plan/ci-cd/ | 7 deploy.yml documents + CI/CD Integration Guide |
| cloudflare-migration.md | plan/infra/cloudflare-migration-plan.md, cloudflare-error-analysis-and-improvement.md | Cloudflare Migration and Operations Guide |
development-workflow/
Section titled “development-workflow/”| New Path | Existing Document Source | Notes |
|---|---|---|
| local-testing-optimized.md | user-manual/local-testing.md, plan/ci-cd/local-test-and-ci-optimization.md | Local Testing Environment and Optimization |
| code-quality-standard.md | plan/code-quality/README, code-review-and-cleanup-plan, code-cleanup-completed, refactoring-plan | Refactoring·Code Review Standard (Code Cleanup Completed Integration) |
| New Path | Existing Doc Source | Notes |
|---|---|---|
| manual-overview.md | index.md or new | Full user manual overview |
| translation-pipeline.md | v1/guides/translation.md, automated-translation-pipeline-design.md | Automated multilingual document pipeline (KO→EN) |
| logpush-r2-guide.md | plan/logpush/README, logpush-r2-secrets-guide, logpush-integration-plan, logpush-unify-plan | Logpush Configuration and R2 Secret Management |
| deployment.md | user-manual/deployment.md | Deployment Procedure (Retain) |
| environment.md | (Delete or link when moving guides to environment-setup) | Environment Guide (Distinguish from guides and roles) |
| local-testing.md | (Delete or link when moving guides to local-testing-optimized) | Local Testing (separate from guides and roles) |
4. archive/whitepaper/ (Historical & Strategic Records)
Section titled “4. archive/whitepaper/ (Historical & Strategic Records)”project-milestones/
Section titled “project-milestones/”| New Path | Existing Document Source | Notes |
|---|---|---|
| phase2-analysis.md | plan/default/phase2-analysis.md | Phase 2 Analysis |
| phase2-completed.md | plan/default/phase2-completed.md | Phase 2 Completed |
| phase3-completed.md | plan/default/phase3-completed.md | Phase 3 Completed |
| phase3-test-results.md | plan/default/phase3-test-results.md | Phase 3 Test Results |
| local-test-results.md | plan/default/local-test-results.md | Local Test Results |
incident-reports/
Section titled “incident-reports/”| New Path | Existing Document Source | Notes |
|---|---|---|
| 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 | Consolidated troubleshooting records for deployment errors, Logpush failures, build errors, etc. |
market-research/
Section titled “market-research/”| New Path | Existing Document Source | Notes |
|---|---|---|
| competitor-comparison.md | reference/competitor-comparison-table.md | Competitor Comparison Analysis |
| New Path | Existing Document Source | Notes |
|---|---|---|
| seed-engine-design.md | archive/whitepaper/seed-engine-design.md | Seed Engine Design (Retain) |
| change-log.md | changelog.md | Project-wide Change History (New feature log consolidation) |
Cleanup Strategy Summary
Section titled “Cleanup Strategy Summary”- Duplicate Removal: 7 deploy.yml-related docs → consolidated into cicd-pipeline-guide.md.
- Result-Oriented: Code organization docs split into Planning·Completion·Summary → Converted to result-focused Standard docs like code-quality-standard.md, then deleted the rest.
- Troubleshooting Consolidation: Deployment errors·Logpush failures·Build error analysis → Consolidated into a single document or a few documents under incident-reports/.
- File Naming Standardization: All filenames in kebab-case English. Planning documents containing dates moved to archive or merged into latest guide.