feat: 스프레드시트 기반 DB 시딩 및 배포 파이프라인 수정

- packages/db/src/seed-spreadsheet.ts: JSON 기반 DB 시딩 스크립트 추가 (유저/가계부/카테고리/계좌/거래)
- packages/db/package.json: db:seed:spreadsheet 커맨드 추가
- .gitignore: packages/db/scripts/ 전체 제외 (개인 데이터 및 시딩 스크립트 보호)
- apps/web/Dockerfile: ARG API_URL=http://api:4000 추가 (빌드 타임 proxy 타겟 주입)
- .github/workflows/deploy.yml: web 이미지 빌드 시 build-args API_URL 추가
- docker-compose.yml: web 서비스 build args 설정

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: sscoderati

.github/workflows/deploy.yml

@@ -74,5 +74,6 @@ jobs:
           platforms: linux/arm64
           push: true
           tags: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME_WEB }}:latest
+          build-args: API_URL=http://api:4000
           cache-from: type=gha
           cache-to: type=gha,mode=max

.gitignore

@@ -38,4 +38,7 @@ yarn-error.log*
 *.pem
 
 # IDE
-.idea/
+.idea/
+
+# Seed scripts & data (private - not for public repo)
+packages/db/scripts/

apps/web/Dockerfile

@@ -7,6 +7,12 @@ RUN turbo prune @marrylife/web --docker
 FROM node:22-alpine AS installer
 RUN npm install -g pnpm
 WORKDIR /app
+
+# vite.config.ts의 nitro routeRules proxy 타겟이 빌드 타임에 결정되므로
+# API_URL을 빌드 ARG로 주입해야 함
+ARG API_URL=http://api:4000
+ENV API_URL=$API_URL
+
 COPY --from=builder /app/out/json/ .
 COPY --from=builder /app/out/pnpm-lock.yaml ./pnpm-lock.yaml
 RUN pnpm install

docker-compose.yml

@@ -32,10 +32,10 @@ services:
     build:
       context: .
       dockerfile: apps/web/Dockerfile
+      args:
+        API_URL: http://api:4000   # nitro proxy 타겟 빌드 타임 주입
     ports:
       - "3000:3000"
-    environment:
-      API_URL: http://api:4000
     depends_on:
       - api
 

packages/db/package.json

@@ -10,7 +10,8 @@
     "db:migrate": "drizzle-kit migrate",
     "db:push": "drizzle-kit push",
     "db:studio": "drizzle-kit studio",
-    "db:seed": "dotenv -e .env -- tsx src/seed.ts"
+    "db:seed": "dotenv -e .env -- tsx src/seed.ts",
+    "db:seed:spreadsheet": "dotenv -e .env -- tsx src/seed-spreadsheet.ts"
   },
   "keywords": [],
   "author": "",

packages/db/src/seed-spreadsheet.ts

@@ -0,0 +1,309 @@
+/**
+ * 스프레드시트 기반 시딩 스크립트
+ *
+ * 사전 준비:
+ *   1. Python으로 xlsx 추출:
+ *      python3 packages/db/scripts/extract-spreadsheet.py <xlsx경로> packages/db/scripts/spreadsheet-data.json
+ *
+ *   2. .env에 아래 환경변수 설정:
+ *      DATABASE_URL=...
+ *      SEED_USER1_EMAIL=...      (유저1 이메일)
+ *      SEED_USER1_NAME=...       (유저1 이름)
+ *      SEED_USER2_EMAIL=...      (유저2 이메일)
+ *      SEED_USER2_NAME=...       (유저2 이름)
+ *      SEED_USER1_PASSWORD=...   (유저1 비밀번호)
+ *      SEED_USER2_PASSWORD=...   (유저2 비밀번호)
+ *      SPREADSHEET_DATA_PATH=packages/db/scripts/spreadsheet-data.json  (선택, 기본값 사용 가능)
+ *
+ *   3. 실행:
+ *      pnpm --filter @marrylife/db db:seed:spreadsheet
+ */
+
+import { and, eq } from 'drizzle-orm'
+import { hash } from 'bcryptjs'
+import { readFileSync } from 'fs'
+import { resolve } from 'path'
+import { createClient } from './index'
+import {
+  accountTypeEnum,
+  accounts,
+  categories,
+  categoryTypeEnum,
+  householdLedgerMembers,
+  householdLedgers,
+  transactionTypeEnum,
+  transactions,
+  users,
+} from './schema'
+
+// ── 타입 정의 ──────────────────────────────────────────────────────────────
+
+interface SpreadsheetData {
+  ledger: {
+    bookName: string
+    goal: string
+    startYear: number
+    fiscalStartDay: number
+  }
+  categories: Array<{
+    type: string
+    major: string
+    minor: string
+    defaultIsFixed: boolean
+    sortOrder: number
+  }>
+  accounts: Array<{
+    accountType: string
+    major: string
+    minor: string
+    name: string
+    amountStarting: number
+    sortOrder: number
+  }>
+  transactions: Array<{
+    date: string
+    type: string
+    categoryKey: string | null
+    accountInName: string | null
+    accountOutName: string | null
+    amount: number
+    memo: string | null
+  }>
+}
+
+// ── 메인 ───────────────────────────────────────────────────────────────────
+
+async function seed() {
+  if (process.env.NODE_ENV === 'production' && process.env.ALLOW_PROD_SEED !== 'true') {
+    throw new Error(
+      'production 환경에서는 ALLOW_PROD_SEED=true 설정이 없으면 seed를 실행할 수 없습니다.',
+    )
+  }
+
+  // JSON 데이터 로드
+  const dataPath = resolve(
+    process.env.SPREADSHEET_DATA_PATH ?? 'packages/db/scripts/spreadsheet-data.json',
+  )
+  let data: SpreadsheetData
+  try {
+    data = JSON.parse(readFileSync(dataPath, 'utf-8'))
+  } catch {
+    throw new Error(
+      `JSON 파일을 읽을 수 없습니다: ${dataPath}\n` +
+        `먼저 Python 추출 스크립트를 실행하세요:\n` +
+        `  python3 packages/db/scripts/extract-spreadsheet.py <xlsx경로> ${dataPath}`,
+    )
+  }
+
+  const db = createClient(process.env.DATABASE_URL!)
+  const now = new Date()
+
+  // ── 유저 ─────────────────────────────────────────────────────────────────
+
+  const user1Email    = process.env.SEED_USER1_EMAIL
+  const user1Name     = process.env.SEED_USER1_NAME
+  const user2Email    = process.env.SEED_USER2_EMAIL
+  const user2Name     = process.env.SEED_USER2_NAME
+  const user1Password = process.env.SEED_USER1_PASSWORD
+  const user2Password = process.env.SEED_USER2_PASSWORD
+  if (!user1Email || !user1Name || !user2Email || !user2Name || !user1Password || !user2Password) {
+    throw new Error(
+      'SEED_USER1_EMAIL, SEED_USER1_NAME, SEED_USER2_EMAIL, SEED_USER2_NAME, ' +
+      'SEED_USER1_PASSWORD, SEED_USER2_PASSWORD 환경변수를 모두 설정해야 합니다.',
+    )
+  }
+
+  const [hash1, hash2] = await Promise.all([hash(user1Password, 10), hash(user2Password, 10)])
+
+  await db
+    .insert(users)
+    .values({ name: user1Name, email: user1Email, passwordHash: hash1, createdAt: now, updatedAt: now })
+    .onConflictDoUpdate({
+      target: users.email,
+      set: { name: user1Name, passwordHash: hash1, updatedAt: now },
+    })
+
+  await db
+    .insert(users)
+    .values({ name: user2Name, email: user2Email, passwordHash: hash2, createdAt: now, updatedAt: now })
+    .onConflictDoUpdate({
+      target: users.email,
+      set: { name: user2Name, passwordHash: hash2, updatedAt: now },
+    })
+
+  const [user1] = await db.select().from(users).where(eq(users.email, user1Email)).limit(1)
+  const [user2] = await db.select().from(users).where(eq(users.email, user2Email)).limit(1)
+
+  if (!user1 || !user2) throw new Error('유저 생성/조회 실패')
+
+  // ── 가계부 ────────────────────────────────────────────────────────────────
+
+  let [ledger] = await db
+    .select()
+    .from(householdLedgers)
+    .where(eq(householdLedgers.bookName, data.ledger.bookName))
+    .limit(1)
+
+  if (!ledger) {
+    await db.insert(householdLedgers).values({
+      bookName: data.ledger.bookName,
+      goal: data.ledger.goal,
+      startYear: data.ledger.startYear,
+      fiscalStartDay: data.ledger.fiscalStartDay,
+      createdAt: now,
+      updatedAt: now,
+    })
+    ;[ledger] = await db
+      .select()
+      .from(householdLedgers)
+      .where(eq(householdLedgers.bookName, data.ledger.bookName))
+      .limit(1)
+  }
+
+  if (!ledger) throw new Error('가계부 생성/조회 실패')
+
+  await db
+    .insert(householdLedgerMembers)
+    .values([
+      { householdLedgerId: ledger.id, userId: user1.id, joinedAt: now },
+      { householdLedgerId: ledger.id, userId: user2.id, joinedAt: now },
+    ])
+    .onConflictDoNothing()
+
+  // ── 카테고리 ──────────────────────────────────────────────────────────────
+
+  for (const cat of data.categories) {
+    const [existing] = await db
+      .select({ id: categories.id })
+      .from(categories)
+      .where(
+        and(
+          eq(categories.householdLedgerId, ledger.id),
+          eq(categories.type, cat.type as (typeof categoryTypeEnum.enumValues)[number]),
+          eq(categories.major, cat.major),
+          eq(categories.minor, cat.minor),
+        ),
+      )
+      .limit(1)
+
+    if (existing) continue
+
+    await db.insert(categories).values({
+      householdLedgerId: ledger.id,
+      type: cat.type as (typeof categoryTypeEnum.enumValues)[number],
+      major: cat.major,
+      minor: cat.minor,
+      defaultIsFixed: cat.defaultIsFixed,
+      sortOrder: cat.sortOrder,
+      isDeleted: false,
+    })
+  }
+
+  const seededCategories = await db
+    .select()
+    .from(categories)
+    .where(eq(categories.householdLedgerId, ledger.id))
+
+  const categoryMap = new Map(seededCategories.map((c) => [`${c.major}:${c.minor}`, c.id]))
+
+  // ── 계좌 ──────────────────────────────────────────────────────────────────
+
+  for (const acc of data.accounts) {
+    const [existing] = await db
+      .select({ id: accounts.id })
+      .from(accounts)
+      .where(
+        and(
+          eq(accounts.householdLedgerId, ledger.id),
+          eq(accounts.name, acc.name),
+        ),
+      )
+      .limit(1)
+
+    if (existing) continue
+
+    await db.insert(accounts).values({
+      householdLedgerId: ledger.id,
+      accountType: acc.accountType as (typeof accountTypeEnum.enumValues)[number],
+      major: acc.major,
+      minor: acc.minor,
+      name: acc.name,
+      amountStarting: acc.amountStarting,
+      isHidden: false,
+      sortOrder: acc.sortOrder,
+      isDeleted: false,
+    })
+  }
+
+  const seededAccounts = await db
+    .select()
+    .from(accounts)
+    .where(eq(accounts.householdLedgerId, ledger.id))
+
+  const accountMap = new Map(seededAccounts.map((a) => [a.name, a.id]))
+
+  // ── 거래 ──────────────────────────────────────────────────────────────────
+
+  // 중복 방지: 동일한 date+type+amount+memo 조합은 skip
+  const existingTxs = await db
+    .select({ date: transactions.transactionDate, type: transactions.type, amount: transactions.amount, memo: transactions.memo })
+    .from(transactions)
+    .where(eq(transactions.householdLedgerId, ledger.id))
+
+  const existingKeys = new Set(
+    existingTxs.map((tx) => `${tx.date}|${tx.type}|${tx.amount}|${tx.memo ?? ''}`),
+  )
+
+  const toInsert = []
+  let skipped = 0
+
+  for (const tx of data.transactions) {
+    const key = `${tx.date}|${tx.type}|${tx.amount}|${tx.memo ?? ''}`
+    if (existingKeys.has(key)) {
+      skipped++
+      continue
+    }
+    existingKeys.add(key) // 같은 배치 내 중복 방지
+
+    const categoryId = tx.categoryKey ? (categoryMap.get(tx.categoryKey) ?? null) : null
+    const accountInId = tx.accountInName ? (accountMap.get(tx.accountInName) ?? null) : null
+    const accountOutId = tx.accountOutName ? (accountMap.get(tx.accountOutName) ?? null) : null
+
+    toInsert.push({
+      householdLedgerId: ledger.id,
+      createdBy: user1.id,
+      transactionDate: tx.date,
+      type: tx.type as (typeof transactionTypeEnum.enumValues)[number],
+      categoryId,
+      amount: tx.amount,
+      accountInId,
+      accountOutId,
+      isFixed: false,
+      memo: tx.memo ?? null,
+      installmentId: null,
+      createdAt: now,
+      updatedAt: now,
+    })
+  }
+
+  // 배치 삽입 (500건씩 나눠서 insert)
+  const BATCH = 500
+  for (let i = 0; i < toInsert.length; i += BATCH) {
+    await db.insert(transactions).values(toInsert.slice(i, i + BATCH))
+  }
+
+  console.log(
+    `Seed complete:\n` +
+      `  users       : 2 (${user1Email}, ${user2Email})\n` +
+      `  ledger      : ${data.ledger.bookName}\n` +
+      `  categories  : ${seededCategories.length}\n` +
+      `  accounts    : ${seededAccounts.length}\n` +
+      `  transactions: ${toInsert.length} inserted, ${skipped} skipped`,
+  )
+  process.exit(0)
+}
+
+seed().catch((err) => {
+  console.error(err)
+  process.exit(1)
+})