corp-web-v2

프로젝트 개요

• QueryPie 회사 홍보·소개 웹사이트
• Next.js App Router 기반 다국어 사이트
• 지원 locale: en, ko, ja
• 주요 공개 영역: Product, Features, Demo, Documentation, Company, Plans, Legal
• Admin CMS: Demo / Documentation / News 콘텐츠 편집·게시

---

기술 스택

항목	버전
Next.js App Router	15.x
React	19.x
TypeScript	5.8
Tailwind CSS	3.4
Tiptap	3.x
Vitest	3.x

---

디렉토리 개요

src/
├── app/
│   ├── [locale]/       # 공개 페이지: en / ko / ja
│   ├── admin/          # Admin CMS
│   └── api/            # 서버 API 라우트
├── components/
│   ├── ui/             # Button, Input, Select 등 UI primitive
│   ├── content/        # 콘텐츠 미리보기, Tiptap, rich text 렌더링
│   ├── mockups/        # 제품 화면 mockup 컴포넌트
│   ├── sections/       # 페이지 섹션
│   │   ├── common/     # Cta, DetailContentList, FeatureMediaList 등 공유 섹션
│   │   └── *.tsx       # Home*, Aip* 등 페이지/도메인 접두사 섹션
│   ├── site/           # 쿠키 배너, UTM capture 등 전역 사이트 동작
│   ├── forms/          # 공유 form 조각
│   ├── layout/         # GNB, Footer, Admin shell
│   ├── admin/          # Admin 전용 화면 컴포넌트
│   └── pages/          # 공개 페이지 조립 컴포넌트
├── features/           # content, seo, contact 등 도메인 로직
├── content/            # demo, documentation, news, legal 콘텐츠
├── constants/          # i18n, navigation, plans, legal 등
├── public/assets/      # 이미지, mockup asset 등 정적 리소스
└── styles/             # 전역 스타일

---

콘텐츠 구조

Admin 진입점: /admin

관리형 콘텐츠는 src/content/{demo,documentation,news}/**/cnt_xxxxxx/ 아래 파일로 저장됩니다.

• meta.json: 제목, slug, 카테고리, 게시 상태 등 메타데이터
• en.html, ko.html, ja.html: locale별 본문
• *.tiptap.json: Admin editor 원본 데이터

---

라우팅 / 다국어

• 지원 locale: en, ko, ja
• 공개 URL은 항상 locale prefix 사용. 예: /en/solutions/aip
• locale 없는 public path는 /en/...으로 redirect
• 콘텐츠 legacy redirect: src/features/content/legacyRedirects.ts, next.config.ts

---

SEO

SEO 메타데이터와 OG 이미지는 src/features/seo에서 관리합니다.

• 메타데이터 생성: src/features/seo/metadata.ts
• OG 이미지: src/features/seo/ogImage.tsx
• OG 제목 포맷: src/features/seo/ogTitle.ts

---

배포

환경	도메인	트리거
Staging	stage-v2.querypie.com	main push
Production	www-v2.querypie.com	workflow_dispatch
Preview	Vercel preview URL	PR open / sync

상세 내용은 docs/reference/vercel-deployment.md를 확인합니다.

---

관련 문서

문서	설명
Vercel 배포	GitHub Actions / Vercel 배포 구조
Lead Capture Forms	Contact Us, Community License, 콘텐츠 게이팅 폼 흐름
Contact Us API	Contact Us 폼 API 처리, Slack/Salesforce 연동, UTM 전달
Community License	Community License 신청·발급 API와 외부 연동
UTM Attribution	UTM 쿠키 저장과 리드폼 전달 흐름