Skip to content
kgu-developersPublic

About

KGU developers land 페이지입니다.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

kgu developers 랜딩 페이지

경기대학교 kgu developers의 공개 랜딩 페이지를 위한 Next.js App Router 프로젝트다.

로컬 실행

Node.js 22와 pnpm 10.9.0 환경에서 저장소 루트에서 실행한다.

pnpm install
pnpm dev

localhost: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 형식을 확인한다.

CI 및 테스트

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:e2e

pnpm 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 내비게이션 링크는 정상 이동한다.

About

KGU developers land 페이지입니다.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages