Nextjs Tremor Report

nextjs-tremor-report

브랜드 시장조사 보고서를 단테랩스 디자인 토큰을 적용한 인터랙티브 웹 보고서로 빌드해 Vercel 에 배포한다. 본 스킬을 그대로 따르면 무신사 / 29CM / 임의 브랜드 모두 동일한 시각 완성도가 나오는 것이 목표다.

절대 규칙 (Hard Contract)

1. 빌드는 로컬 SSD (/tmp/{brand}-report-app) 에서 한다. SMB/NAS 마운트된 워크스페이스에서 npm install 을 돌리면 17분+ 걸리고 멈춘 것처럼 보인다. 빌드 산출물만 다시 워크스페이스로 복사.
2. VERCEL_API_TOKEN 은 컨테이너 .env 또는 docker-compose environment: 블록에서만 주입한다. paperclip 콘솔의 Secrets 패널은 codex_local 어댑터 heartbeat 프로세스 env 로 전파되지 않는다 (2026-05 기준). spawn-time 검증: printenv | grep VERCEL_API_TOKEN 가 비어있지 않아야 빌드 시작.
3. 메타 disclaimer 금지. "데이터가 아직 분석되지 않았습니다", "원문 페이지 재확인 전까지", "LinkedIn dead page", "Trustpilot noise", "0 corrections needed with 0.86 confidence" 같은 메타 정보는 어떤 페이지에도 나오지 않는다. 사실 기반 더미 데이터로 모든 슬롯을 가득 채운 완성된 보고서로 보이게 한다.
4. 5 페이지 정확 구조. 홈 / SWOT / 차트 / 팩트체크 / 경쟁사 — 그 외 페이지 추가 금지. 부족한 데이터는 dummy 로 채우되 위 §3 규칙을 따른다.
5. 단테랩스 토큰만. paper #F7F2E6 / ink #1a1a1a / rust #A0522D / slate #435B6C / sepia #8B6F47 / amber #C9A857 / mark #EBC65B. 그 외 색 (회색, 코발트, 인디고 등 임의 색) 금지. 강조는 rust 또는 yellow dl-mark 형광 하이라이트만.
6. 본문은 Noto Serif KR, 헤드라인은 Nanum Myeongjo, UI 라벨은 Pretendard Variable. 본문에 sans-serif 금지. 이모지 금지.
7. 챕터 배지 금지. 좌하단/우상단의 "CHAPTER 23 · BRAND INTEL" 같은 시그니처 마크 추가 금지 (요청 시 예외).
8. 빌드 검증 통과 후에만 deploy. npm run build 성공 → production deploy.

언제 쓰나

• Brand Intelligence Lab 의 슬라이드 제작자 (agent-3) 가 분석가 산출물 5종 (analysis/insights.md, analysis/swot_matrix.json, analysis/chart_spec.json, analysis/fact_check.md, analysis/cleaned_data.parquet) 을 받아서 임원용 인터랙티브 보고서로 빌드할 때.
• 시청자가 paperclipai company import https://github.com/dandacompany/brand-intelligence-lab 한 회사의 슬라이드 제작자 capabilities 에 들어가 있으면 자동 적용.

사전 조건 검증 (스킵 금지)

node --version                                              # ≥ 20
which vercel || npm i -g vercel                             # CLI 존재
printenv | grep -E 'VERCEL_API_TOKEN'                       # 비어있지 않아야 함
[ -n "$VERCEL_API_TOKEN" ] || { echo "BLOCK: token missing — .env injection 필요"; exit 1; }

검증 실패 시 paperclip 코멘트로 BLOCK: VERCEL_API_TOKEN missing in heartbeat env — 호스팅어 hPanel Docker Manager → paperclip-{slug} → .env 편집 후 컨테이너 재시작 보고하고 즉시 정지.

빌드 절차

1. 로컬 SSD 스캐폴딩

BRAND={brand}                                               # musinsa | 29cm
APP=/tmp/${BRAND}-report-app
rm -rf "$APP" && mkdir -p "$APP" && cd "$APP"

package.json (수동 작성 — create-next-app 의 대화형/네트워크 회피로 ~2분 단축):

{
  "name": "brand-intel-${BRAND}",
  "version": "0.1.0",
  "private": true,
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start"
  },
  "dependencies": {
    "next": "^15.0.0",
    "react": "^18.3.0",
    "react-dom": "^18.3.0",
    "echarts": "^5.5.0",
    "echarts-for-react": "^3.0.2"
  },
  "devDependencies": {
    "@types/node": "^22",
    "@types/react": "^18",
    "@types/react-dom": "^18",
    "typescript": "^5",
    "tailwindcss": "^3.4.0",
    "postcss": "^8.4.0",
    "autoprefixer": "^10.4.0"
  }
}

추가 파일 4종: tsconfig.json, next.config.ts (env NEXT_PUBLIC_BRAND 분기 포함), postcss.config.mjs, tailwind.config.ts. 정확한 본문은 references/scaffold-files.md 참조 — 그대로 복사.

2. 단테랩스 디자인 토큰 — tailwind.config.ts

references/design-tokens.md 의 token 표를 Tailwind theme 에 등록한다. 핵심:

• colors: paper {DEFAULT/soft/strong}, ink {DEFAULT/soft/muted}, rust {DEFAULT/deep}, slate2 {DEFAULT/deep}, sepia, amber2, mark2, link
• fontFamily: editorial (Nanum Myeongjo + Noto Serif KR), serif (Noto Serif KR), sans (Pretendard Variable), mono (JetBrains Mono)
• borderRadius: none / sm 2px / md 4px / lg 8px (8 초과 금지)
• boxShadow: emboss (헤어라인 inset + soft drop, ink-tint 만), card (rust hover 셰도)

3. app/globals.css — 타이포 클래스 + 시그니처 컴포넌트

references/globals-css.md 그대로 사용. 포함되는 클래스:

• .type-display / .type-hero / .type-h1~h3 / .type-body / .type-small / .type-meta / .num-tabular
• .ledger-hairline — top/bottom 1px border (헤더·푸터 시그니처)
• .edge-mark — 절대 위치 메타 라벨 (좌상단 SESSION · 우상단 BRAND CODE)
• .rust-stripe — 좌측 4px rust accent stripe
• .dl-card — 카드 surface + hover 셰도
• .dl-badge / .dl-badge-rust / .dl-badge-slate / .dl-badge-amber
• .dl-mark — 노란 형광펜 하이라이트 (배경 그래디언트, 절대 underline 사용 금지)

4. 5 페이지 정확 구조

references/page-blueprints.md 의 5 페이지 spec 그대로. 각 페이지 헤더는 <div className="type-meta">PAGE · {LABEL}</div> + <h1 className="type-hero">{브랜드명} · {타이틀}</h1> 패턴 유지.

5. ECharts 4종 차트 컴포넌트 — components/Charts.tsx

references/charts-component.md 그대로. SVG 렌더러 사용 (opts={{ renderer: 'svg' }}). 색 팔레트는 rust/slate 2색만, 배경은 paper. 4종 모두 baseGrid (left 56, right 24, top 24, bottom 36) + baseAxis (border dashed splitLine, Pretendard 라벨 11px muted) 동일 적용.

6. 더미 데이터 — lib/data/{brand}.ts

references/dummy-data-rules.md 의 룰을 따른다. 핵심:

• 메타 disclaimer 절대 금지 — "데이터가 아직 분석 안 됨", "원문 페이지 재확인 전까지", "추정치 / 부분 데이터" 같은 표기 없음
• 모든 슬롯을 채운다 — KPI 4, Insight 5, SWOT 각 사분면 3 (총 12), 차트 serp 12점 / priceDist 5 / revenue 6 / social 4, competitors 4, factCheck 8
• 사실 기반 더미 — 공식 IR, 보도자료, Bright Data 데이터셋에서 실제 확인 가능한 수치만. 시청자가 검증해도 실제 값 ±10% 이내.
• factCheck status 분포 — verified 56 · estimated 23 · flagged 0. status badge 는 dl-badge-rust / dl-badge-amber / dl-badge-slate 순.

7. 빌드 → Vercel deploy

cd /tmp/${BRAND}-report-app
npm install --no-audit --no-fund --legacy-peer-deps          # ~10초 (SSD)
NEXT_PUBLIC_BRAND=$BRAND npx next build                       # 5 페이지 정적 생성

export VERCEL_TOKEN="$VERCEL_API_TOKEN"
# 기존 프로젝트 연결 (대화형 회피 — project.json 직접 작성)
mkdir -p .vercel
curl -sS "https://api.vercel.com/v9/projects/brand-intelligence-${BRAND}" \
  -H "Authorization: Bearer $VERCEL_TOKEN" \
  | python3 -c "import json,sys;d=json.load(sys.stdin);open('.vercel/project.json','w').write(json.dumps({'projectId':d['id'],'orgId':d['accountId']}))"

vercel deploy --prod --yes --token "$VERCEL_TOKEN" \
  --build-env NEXT_PUBLIC_BRAND=$BRAND \
  --env NEXT_PUBLIC_BRAND=$BRAND 2>&1 | tee /tmp/vercel-deploy.log

DEPLOY_URL=$(grep -oE 'https://[a-z0-9-]+\.vercel\.app' /tmp/vercel-deploy.log | tail -1)

8. 자가 검증 후 보고

curl -sI "$DEPLOY_URL" | head -1                             # HTTP/2 200
curl -s  "$DEPLOY_URL" | grep -oE "무신사|29CM|브랜드|SWOT" | sort -u

paperclip 코멘트에 다음 형식으로 보고:

배포 완료 — {BRAND}
URL: $DEPLOY_URL
페이지 5종: 홈 / SWOT / 차트 / 팩트체크 / 경쟁사
디자인 토큰: paper+ink+rust+slate (단테랩스 v1.1)
메타 disclaimer 0건 · 차트 4종 · KPI 4 · Insight 5 · factCheck 8
다음 owner: 단테 (URL 시청 후 코멘트로 OK/수정 요청)

자가 검증 체크리스트 (deploy 전)

체크 실패 시 deploy 중단 → 항목 수정 후 재실행.

트러블슈팅

References

• references/design-tokens.md — 7색 + 타이포 + spacing/radius/shadow 토큰 표 (그대로 복사 가능)
• references/scaffold-files.md — package.json / tsconfig / next.config / postcss / tailwind.config 전체 본문
• references/globals-css.md — 타이포 클래스 + dl-card / dl-badge / ledger-hairline / rust-stripe 전체 CSS
• references/page-blueprints.md — 5 페이지 각 tsx 본문 템플릿
• references/charts-component.md — ECharts 4종 컴포넌트 본문
• references/dummy-data-rules.md — 메타 disclaimer 금지 룰 + 슬롯 채우기 표 + factCheck status 분포

Source of truth

• 캐노니컬 구현: https://github.com/dandacompany/dante-skills/tree/main/nextjs-tremor-report
• 미러: https://github.com/dandacompany/brand-intelligence-lab/tree/main/skills/dandacompany/dante-skills/nextjs-tremor-report
• 검증된 배포: https://brand-intelligence-musinsa.vercel.app · https://brand-intelligence-29cm.vercel.app