// package.json (Next.js 14 App Router + pnpm 최적화)
// 💡 JSON 파일은 원래 주석이 안 되지만, 설명의 편의를 위해 작성했습니다.
// 실제 프로젝트에 복사할 때는 주석을 지워주세요! 😁
{
  "name": "@youngsu/community",
  "version": "0.1.0",
  "private": true,
  
  // 🦁 [핵심] packageManager 필드: 이 프로젝트가 사용할 패키지 매니저 버전을 명시합니다.
  // 이 한 줄 덕분에 팀원들의 pnpm 버전이 자동으로 통일되고, CI(GitHub Actions)에서도 알아서 버전을 맞춰줍니다.
  "packageManager": "pnpm@9.15.0",
  
  "engines": {
    "node": ">=20.0.0", // 🦁 Node 20 미만에서는 설치 자체를 막아서 "내 컴퓨터에선 되는데?" 를 방지합니다.
    "pnpm": ">=9.0.0"
  },
  
  "scripts": {
    // 💡 평소 자주 쓰는 실행 명령어들
    "dev": "next dev --turbo", // 속도가 빠른 터보팩으로 개발 서버 실행
    "build": "next build", // 실제 배포를 위한 프로덕션 빌드 (이때 standalone 파일이 생성됨)
    "start": "next start",
 
    // 💡 코드 품질 관리 명령어
    "lint": "next lint",
    "lint:fix": "next lint --fix",
    "typecheck": "tsc --noEmit", // 타입스크립트 에러만 검출 (빌드 전 CI에서 돌리기 좋음)
    "format": "prettier --write .",
 
    // 💡 DB 명령어 (Prisma)
    "db:generate": "prisma generate", // DB 스키마 바뀔 때마다 타입 자동완성 생성
    "db:migrate": "prisma migrate dev", // 로컬 DB에 변경사항 적용
    "db:migrate:prod": "prisma migrate deploy", // (중요) 실제 운영 서버 배포 시 실행하는 DB 마이그레이션
 
    // 🦁 [핵심] install 직후 자동 실행: 빈번한 '타입 에러'를 막아줍니다.
    "postinstall": "prisma generate"
  },
  
  // 👉 실제 런타임(운영 서버)에서 필요한 필수 패키지들
  "dependencies": {
    "next": "^14.2.0",
    "react": "^18.2.0",
    "react-dom": "^18.2.0",
    "@prisma/client": "^5.9.1",
    "@tanstack/react-query": "^5.17.15",
    "axios": "^1.6.7",
    "zod": "^3.22.4", // 폼 데이터 검증용
    "next-auth": "^4.24.5", // 로그인 등 인증 관리
    "clsx": "^2.1.0",
    "tailwind-merge": "^2.2.1"
  },
  
  // 👉 개발할 때만 필요하고 운영 빌드 시에는 빠지는 패키지들 (용량 최적화의 핵심!)
  "devDependencies": {
    // pnpm은 npm과 달리 devDependencies를 철저하게 격리합니다.
    // 그래서 이곳에 있는 패키지가 dependencies 인 척 작동하는 일이 없습니다. (유령 의존성 방지)
    "prisma": "^5.9.1",
    "typescript": "^5.3.3",
    "@types/node": "^20.11.0",
    "@types/react": "^18.2.0",
    "@types/react-dom": "^18.2.0",
    "tailwindcss": "^3.4.1",
    "postcss": "^8.4.35",
    "autoprefixer": "^10.4.17",
    "eslint": "^8.57.0",
    "eslint-config-next": "^14.2.0",
    "@typescript-eslint/eslint-plugin": "^7.0.2",
    "@typescript-eslint/parser": "^7.0.2",
    "prettier": "^3.2.5",
    "prettier-plugin-tailwindcss": "^0.5.11",
    "jest": "^29.7.0",
    "@testing-library/react": "^14.2.1",
    "@testing-library/jest-dom": "^6.4.2",
    "jest-environment-jsdom": "^29.7.0",
    "tsx": "^4.7.1",
    "husky": "^9.0.10",
    "lint-staged": "^15.2.2"
  },
  
  // Git Commit 하기 전에 변경된 파일만 자동으로 Lint & Prettier 돌려주는 설정
  "lint-staged": {
    "*.{ts,tsx}": ["eslint --fix", "prettier --write"],
    "*.{json,md,yaml,yml}": ["prettier --write"]
  }
}

# .npmrc (프로젝트 루트 — git 에 커밋)
 
# 🦁 TypeScript, ESLint 계열은 루트로 호이스팅
public-hoist-pattern[]=*types*
public-hoist-pattern[]=*eslint*
public-hoist-pattern[]=prettier
public-hoist-pattern[]=postcss
public-hoist-pattern[]=tailwindcss
public-hoist-pattern[]=autoprefixer
 
# 엔진 버전 강제 (잘못된 Node.js 버전으로 설치 시 에러)
engine-strict=true
 
# 보안: audit 항상 활성화
audit=true
 
# 🦁 lock 파일 없으면 에러 (실수로 npm install 방지)
# (pnpm ci = pnpm install --frozen-lockfile 으로 처리)
 
# 저장소 캐시 경로 명시 (선택 사항)
# store-dir=~/.pnpm-store

# -----------------------------------------------------------
# [기초 상식] 🐳 멀티스테이지 빌드란?
# Docker 빌드 과정을 여러 단계(Stage)로 나누어, 최종 이미지에는 실행에 필요한 엑기스만 남기고 불필요한 빌드 도구를 싹 버리는(경량화) 기법입니다.
# -----------------------------------------------------------
 
# 🦁 base 단계: 공통 환경 설정 (다른 단계들이 이 base를 가져다 씁니다)
FROM node:20-slim AS base
# 💡 '-slim' 이 붙은 이미지는 운영체제의 불필요한 도구를 제거하여 용량이 아주 가볍습니다 (약 900MB -> 200MB)
 
# pnpm 사용을 위한 기본 설정
ENV PNPM_HOME="/pnpm"
ENV PATH="$PNPM_HOME:$PATH"
# Node.js 에 내장된 패키지 매니저 관리 도구인 corepack 을 켜서 pnpm 을 쓸 수 있게 만듭니다.
RUN corepack enable
 
# -----------------------------------------------------------
# Stage 1: prod-deps (운영 배포용 의존성만 설치)
# -----------------------------------------------------------
FROM base AS prod-deps
 
WORKDIR /app
COPY package.json pnpm-lock.yaml .npmrc ./
 
# 🦁 [초핵심] BuildKit 캐시 마운트 (--mount=type=cache)
# 일반적인 Docker 빌드는 명령어를 실행할 때마다 다운로드부터 다시 합니다.
# 하지만 이 옵션을 쓰면, pnpm이 패키지를 임시 저장하는 글로벌 폴더(/pnpm/store)를 Docker 외부에 안전하게 캐싱해둡니다.
# 다음 번 빌드할 때는 다운로드 없이 즉석에서 0.1초만에 하드링크만 걸어주어 빌드 속도가 획기적으로 향상됩니다!
RUN --mount=type=cache,id=pnpm,target=/pnpm/store \
    pnpm install --prod --frozen-lockfile 
    # `--prod`: devDependencies(테스트 도구, 린트 등)를 제외하고 가볍게 설치합니다.
    # `--frozen-lockfile`: lock 파일을 무조건 신뢰하고, 버전이 달라지면 에러를 냅니다. (운영 배포 시 필수)
 
# -----------------------------------------------------------
# Stage 2: build (전체 소스코드 빌드)
# -----------------------------------------------------------
FROM base AS build
 
WORKDIR /app
COPY package.json pnpm-lock.yaml .npmrc ./
 
# 빌드할 때는 타입스크립트 등 devDependencies 가 필요하므로 `--prod` 없이 풀(full) 설치를 진행합니다.
RUN --mount=type=cache,id=pnpm,target=/pnpm/store \
    pnpm install --frozen-lockfile
 
# 소스코드를 싹 가져옵니다.
COPY . .
# Next.js 빌드를 돌립니다. (결과물은 .next 폴더에 생김)
RUN pnpm run build
 
# -----------------------------------------------------------
# Stage 3: runner (최종 실행 이미지 - 정말 필요한 것만 담습니다)
# -----------------------------------------------------------
FROM base AS runner
 
WORKDIR /app
 
ENV NODE_ENV=production
# Next.js 사용 통계 전송을 끕니다. (살짝 빨라짐)
ENV NEXT_TELEMETRY_DISABLED=1
 
# 🦁 [보안 필수] root 권한을 쓰지 않기 위해 nextjs 라는 일반 사용자 계정을 생성합니다.
RUN addgroup --system --gid 1001 nodejs
RUN adduser --system --uid 1001 nextjs
 
# Stage 1 (prod-deps) 에서 가볍게 설치해 둔 완전체 운영용 node_modules 만 가져옵니다.
COPY --from=prod-deps /app/node_modules ./node_modules
 
# Stage 2 (build) 에서 빌드된 결과물을 취합합니다.
# 💡 Next.js 의 standalone 모드는 "실행에 꼭 필요한 파일들만" 모아주는 꿀 기능입니다. (next.config.js 설정 필요)
COPY --from=build /app/.next/standalone ./
COPY --from=build /app/.next/static ./.next/static
COPY --from=build /app/public ./public
 
# 방금 만든 안전한 일반 사용자 계정으로 전환
USER nextjs
 
EXPOSE 3000
ENV PORT=3000
ENV HOSTNAME="0.0.0.0"
 
# 최종 컨테이너 실행 명령어 (standalone 산출물 실행)
CMD ["node", "server.js"]

// next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
  // 🦁 standalone 모드: 실행에 필요한 파일만 .next/standalone 에 모음
  // → 이미지 크기 대폭 감소
  output: 'standalone',
};
 
module.exports = nextConfig;

# Dockerfile (모노레포 루트)
FROM node:20-slim AS base
ENV PNPM_HOME="/pnpm"
ENV PATH="$PNPM_HOME:$PATH"
RUN corepack enable
 
# ──────────────────────────────────────────────
# Stage 1: 전체 빌드
# ──────────────────────────────────────────────
FROM base AS build
 
COPY . /usr/src/app
WORKDIR /usr/src/app
 
RUN --mount=type=cache,id=pnpm,target=/pnpm/store \
    pnpm install --frozen-lockfile
 
# 모든 패키지 빌드 (의존 순서 자동 처리)
RUN pnpm run -r build
 
# 🦁 pnpm deploy — community 앱에 필요한 파일만 /prod/community 로 분리
# --prod: devDependencies 제외
# --filter: 대상 앱 지정
RUN pnpm deploy --filter=@youngsu/community --prod /prod/community
RUN pnpm deploy --filter=@youngsu/admin --prod /prod/admin
 
# ──────────────────────────────────────────────
# Stage 2: community 앱 실행 이미지
# ──────────────────────────────────────────────
FROM base AS community
 
COPY --from=build /prod/community /prod/community
WORKDIR /prod/community
 
EXPOSE 3000
CMD ["pnpm", "start"]
 
# ──────────────────────────────────────────────
# Stage 3: admin 앱 실행 이미지
# ──────────────────────────────────────────────
FROM base AS admin
 
COPY --from=build /prod/admin /prod/admin
WORKDIR /prod/admin
 
EXPOSE 3001
CMD ["pnpm", "start"]

# 앱별 이미지 빌드
docker build . --target community --tag youngsu-community:latest
docker build . --target admin --tag youngsu-admin:latest

# .github/workflows/ci.yml
name: CI
 
# 💡 이 파이프라인이 언제 실행될지 정의합니다. (방아쇠 역할)
on:
  push:
    branches: [main, develop] # main이나 develop 브랜치에 코드가 푸시될 때
  pull_request:
    branches: [main] # 코드를 main으로 합쳐달라(PR)고 요청했을 때
 
jobs:
  ci:
    runs-on: ubuntu-latest # 💡 임대받은 가장 최신버전 리눅스 깡통 컴퓨터에서 시작합니다.
    strategy:
      matrix:
        node-version: [20] # Node.js 20버전에서 테스트
 
    steps:
      # 1️⃣ GitHub에서 우리 프로젝트 코드를 우분투 컴퓨터로 다운로드 받습니다.
      - uses: actions/checkout@v4
 
      # 2️⃣ 🦁 [핵심] 컴퓨터에 pnpm을 설치합니다. (pnpm 공식 Action 사용)
      # 버전 명시를 생략하면 package.json 의 "packageManager": "pnpm@9.x.x" 필드를 읽어다 자동으로 깔아줍니다! 진짜 편함!
      - name: Setup pnpm
        uses: pnpm/action-setup@v4
 
      # 3️⃣ 컴퓨터에 Node.js 를 세팅합니다.
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node-version }}
          # 🦁 [극강의 최적화 핵심] cache: 'pnpm' 단 한 줄!
          # 이 한 줄을 적으면 "GitHub 저장소 어딘가에 기존 pnpm-store를 압축해뒀다가 다음 빌드에 재사용" 합니다.
          # pnpm install이 2분에서 10초로 줄어드는 기적을 볼 수 있습니다.
          cache: 'pnpm'
 
      # 4️⃣ 의존성 설치 (물론 위에서 캐시해둔 게 있다면 하드링크 교체만으로 번개같이 끝남)
      - name: Install dependencies
        run: pnpm install --frozen-lockfile # lock 파일을 절대 신뢰. 버전 달라지면 에러!
 
      # 5️⃣ 빌드 전 타입스크립트 문법 에러가 없는지 체크
      - name: Type check
        run: pnpm typecheck
 
      # 6️⃣ 코드 스타일이나 룰을 잘 지켰는지 린트(잔소리머신) 체크
      - name: Lint
        run: pnpm lint
 
      # 7️⃣ 작성해둔 단위 테스트 통과하는지 확인
      - name: Test
        run: pnpm test:ci
 
      # 8️⃣ 아무 문제 없다면 정말로 빌드를 진행합니다!
      - name: Build
        run: pnpm build
        env: # 빌드할 때 필요한 비밀번호, Key 같은 것들은 GitHub Secrets 창고에서 꺼내옵니다.
          NEXTAUTH_SECRET: ${{ secrets.NEXTAUTH_SECRET }}
          NEXTAUTH_URL: ${{ secrets.NEXTAUTH_URL }}
          DATABASE_URL: ${{ secrets.DATABASE_URL }}

# .github/workflows/ci-monorepo.yml
name: Monorepo CI
 
on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
 
jobs:
  changes:
    runs-on: ubuntu-latest
    outputs:
      community: ${{ steps.filter.outputs.community }}
      admin: ${{ steps.filter.outputs.admin }}
      ui: ${{ steps.filter.outputs.ui }}
    steps:
      - uses: actions/checkout@v4
      - uses: dorny/paths-filter@v3
        id: filter
        with:
          filters: |
            community:
              - 'apps/community/**'
              - 'packages/ui/**'
              - 'packages/types/**'
            admin:
              - 'apps/admin/**'
              - 'packages/ui/**'
            ui:
              - 'packages/ui/**'
 
  test-community:
    needs: changes
    if: ${{ needs.changes.outputs.community == 'true' }}
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: 'pnpm'
      - run: pnpm install --frozen-lockfile
      - run: pnpm --filter @youngsu/community typecheck
      - run: pnpm --filter @youngsu/community build
 
  test-admin:
    needs: changes
    if: ${{ needs.changes.outputs.admin == 'true' }}
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: 'pnpm'
      - run: pnpm install --frozen-lockfile
      - run: pnpm --filter @youngsu/admin build

# .github/workflows/deploy.yml
name: Deploy
 
on:
  push:
    branches: [main]
 
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
 
      - uses: pnpm/action-setup@v4
 
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: 'pnpm'
 
      - name: Install
        run: pnpm install --frozen-lockfile
 
      # Prisma 마이그레이션 (프로덕션 DB)
      - name: Run migrations
        run: pnpm db:migrate:prod
        env:
          DATABASE_URL: ${{ secrets.DATABASE_URL }}
 
      # Docker 이미지 빌드 & push
      - name: Build and push Docker image
        uses: docker/build-push-action@v5
        with:
          context: .
          push: true
          tags: ghcr.io/youngsu/community:latest
          cache-from: type=gha
          cache-to: type=gha,mode=max

- uses: actions/setup-node@v4
  with:
    cache: 'pnpm'
    # 내부적으로 아래를 자동 처리:
    # 1. pnpm store path 실행 → 경로 확인
    # 2. pnpm-lock.yaml 해시를 캐시 키로 사용
    # 3. 캐시 히트 시 store 복원 → pnpm install 이 하드링크만 생성
    # 4. 캐시 미스 시 설치 후 store 저장

# pnpm-lock.yaml 이 변경되지 않은 PR 에서의 install 시간
# 캐시 없음: ~120초
# 캐시 있음: ~15초  (스토어 복원 + 하드링크 생성)
 
# 🦁 캐시 키 전략
# setup-node cache: 'pnpm' 이 자동으로 처리하므로 별도 설정 불필요
# 단, 캐시를 수동으로 제어하고 싶다면:
- name: Get pnpm store directory
  id: pnpm-cache
  run: echo "dir=$(pnpm store path --silent)" >> $GITHUB_OUTPUT
 
- uses: actions/cache@v4
  with:
    path: ${{ steps.pnpm-cache.outputs.dir }}
    key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
    restore-keys: |
      ${{ runner.os }}-pnpm-store-

- name: Security audit
  run: pnpm audit --audit-level=high
 
- name: Check for unused dependencies
  run: pnpm dlx depcheck