경기대학교 kgu developers의 공개 랜딩 페이지를 위한 Next.js App Router 프로젝트다.
Node.js 22와 pnpm 10.9.0 환경에서 저장소 루트에서 실행한다.
pnpm install
pnpm devlocalhost:3000에서 팀 소개를 확인한다. 루트에서 pnpm check로 Prettier, ESLint, 타입 검사, Vitest, 프로덕션 빌드를 실행한다. 빌드 후 pnpm start로 결과를 확인한다.
| 위치 | 용도 |
|---|---|
| apps/land/src/app | 공개 페이지, 레이아웃, 메타데이터, robots, sitemap |
| packages/design-system | OTP에서 복사한 @aics/design-system과 Astryx 스타일 |
| configs/typescript | 디자인 패키지와 앱이 사용하는 OTP TypeScript 설정 |
| .agent | 구현·검증·PR 지침, 테스트 적용 및 검증 |
운영 배포에서만 SITE_URL을 실제 공개 origin으로 지정한다. 이 값으로 canonical, Open Graph URL, sitemap과 robots를 만든다. 미설정 환경에는 noindex를 적용한다. 첫 HTML에 팀 설명과 Organization 구조화 데이터를 함께 제공한다.
Vercel 프로젝트 KD / land에서 Next.js를 직접 배포한다. main 반영 시 Vercel Git 연동으로 운영 배포하고 다른 브랜치는 Preview를 만든다. GitHub Actions는 품질·테스트 검증을 담당한다. 공개 주소는 https://land.kgudevelopers.monster이며 Hosting.kr DNS와 기존 서비스 레코드를 유지한다. 프로젝트 설정, 환경변수와 도메인 연결은 배포 가이드를 따른다.
| URL | 파일 | 역할 |
|---|---|---|
| / | apps/land/src/app/page.tsx | 팀 홈 |
| /apply | apps/land/src/app/apply/page.tsx | 지원 페이지 진입점 |
| /blog | apps/land/src/app/blog/(index)/page.tsx | 팀 블로그 진입점 |
OTP와 같이 기능 브랜치는 feature/<ticket-id> (예: feature/KD3-337), 그 외 브랜치는 <type>/<ticket-id>, 커밋은 <type>(<scope>): <ticket-id> <summary>, PR 제목은 [<ticket-id>] <summary> 형식을 쓴다.
주 컴포넌트는 PascalCase와 default function, 유틸리티는 lowerCamelCase와 named export를 사용한다. App Router 파일은 Next.js 예약 이름을 따른다.
루트에서 pnpm format:write로 OTP Prettier 설정을 적용한다. Lefthook의 commit-msg 훅은 Conventional Commits 형식을 확인한다.
OTP와 같이 GitHub Actions에서 검증 항목을 Job 단위로 분리한다.
- Quality: Prettier(
format), ESLint(lint), 타입 검사(typecheck) - Vitest:
test:logic(Node)과test:ui(jsdom + Testing Library) - Build: Next.js 프로덕션 빌드(
build) - E2E: 빌드 완료 후 Playwright Chromium에서 라우팅 및 SEO 엔드포인트 테스트(
test:e2e)
로컬에서 다음 명령으로 확인한다.
pnpm install
pnpm check
pnpm --filter @kd/land exec playwright install chromium
pnpm build
pnpm test:e2epnpm test는 Vitest 전체를, pnpm test:logic과 pnpm test:ui는 각각의 테스트 프로젝트를 실행한다. pnpm check에는 브라우저 E2E를 포함하지 않는다. E2E는 별도로 실행해야 한다.
pnpm-lock.yaml을 버전 관리하며 CI는 pnpm install --frozen-lockfile과 pnpm 캐시를 사용한다.
CodeRabbit GitHub App에 한국어 PR 자동 리뷰를 설정했다. 다만 공개 저장소의 별이 10개 미만인 동안에는 PR 생성·추가 push 후 수동으로 리뷰를 요청해야 한다. 설정은 .coderabbit.yaml에서 관리하며 Draft PR은 자동 리뷰에서 제외한다. CodeRabbit은 GitHub Actions와 별도의 CodeRabbit 체크를 제공한다. 저장소 연결과 필수 검사 설정은 CodeRabbit 운영 가이드를 따른다.
/terms, /privacy, /copyright는 운영 회의 전 초안이다. 로고는 임시 이미지이며 헤더의 검색·테마·커뮤니티·GitHub·Apply 액션 버튼은 SiteHeader.tsx의 빈 클릭 핸들러를 추후 연결한다. Home/Blog/Apply 내비게이션 링크는 정상 이동한다.