codebase-consolidation

Codebase Consolidation

Use this when a codebase has the same data or logic defined independently in multiple places — especially across different runtime environments (frontend JS, backend worker A, backend worker B). Consolidation prevents drift: one source updated, others forgotten.

When to Use

• Same constants (천간/지지/오행 mappings, status enums, lookup tables) appear in 2+ files across frontend/backend
• A backend utility function (retry, sign, validate) is re-implemented in a sibling worker
• Two CSS files load the same component — one via <link> and one via @import
• Config values (API endpoints, client IDs) defined in both frontend and backend
• The user asks about "data duplication" or "master data source"

Core Principle

Single Source of Truth (SSOT) — pick one authoritative location for each piece of data, and make every consumer reference it. When runtime environments can't share code (e.g., separate Cloudflare Workers), use a data-level SSOT: a JSON file that both environments can import at build time.

Before:                    After:
  constants.js: {甲→wood}     src/data/constants.json: {甲→wood}
  worker.ts: ['甲','乙',...]       ↑                     ↑
  analyzer.ts: {甲→'wood'}      worker.ts ───┘    analyzer.ts ───┘
                              constants.js → (standalone copy + comment)

Three-Phase Process

Phase 1: Discovery

Find ALL copies of the same data. Cast a wide net:

# 1. Search for repeating character sequences (천간 10개, 지지 12개)
grep -rn "'甲','乙','丙','丁','戊','己','庚','辛','壬','癸'" --include='*.ts' --include='*.js' source/

# 2. Search for key-value patterns that suggest mapping data
grep -rn "'甲':.*'wood'\|'甲'.*element\|'wood'.*'목'" --include='*.ts' --include='*.js' source/

# 3. Check for the same array literal in multiple files
grep -rn "\[.*'子','丑','寅'.*\]" --include='*.ts' --include='*.js' source/

# 4. For CSS: compare <link> in HTML against @import chain in master CSS
grep -o 'href="[^"]*\.css"' public/**/*.html | sort
grep "@import" public/css/index.css | sort
# Any CSS loaded via <link> but NOT in @import (or vice versa) needs audit