SSAFYnity Renewal

GitHub Pages 안에서 # 없는 정적 경로를 유지하기 위한 공식 홈페이지 마이그레이션 준비 프로젝트입니다.

목표

• 기존 ssafynity.github.io의 경로 구조를 그대로 유지합니다.
• 기존 콘텐츠, 데이터, 스타일, 인터랙션 코드를 그대로 재사용합니다.
• Astro 정적 출력으로 각 경로마다 실제 HTML 파일을 생성합니다.
• GitHub Pages 배포 구조 안에서 직접 접속 가능한 URL을 보장합니다.

현재 구조

• docs/design-system.md 공식 홈페이지 저장소 안에서 완결되는 디자인 토큰과 UI 사용 기준입니다.
• src/site 기존 ssafynity.github.io/src에서 React 라우팅 레이어를 걷어내고, Astro에서 재사용하는 데이터·유틸리티·스타일 소스입니다.
• src/pages 실제 Astro 파일 라우팅 엔트리입니다.
• src/components Astro 페이지가 공통으로 사용하는 프레젠테이션 컴포넌트입니다.
• ../.migration-snapshot/ssafynity-renewal/src 원본 React 구현을 비교 검증용으로 보관한 외부 스냅샷입니다. 리뉴얼 프로젝트의 라이브 빌드와 타입체크에는 포함되지 않습니다.
• public 기존 ssafynity.github.io/public 전체를 그대로 복사한 정적 자산입니다.
• scripts/generate-astro-pages.mjs 경로 누락이 생기지 않도록 Astro 페이지 파일을 보조 생성하는 스크립트입니다.
• scripts/verify-migration.mjs 원본과 리뉴얼의 데이터/정적 자산 동일성, 정적 라우트 생성 여부, 대표 페이지 출력 결과를 검증하는 스크립트입니다.

확인된 내용

• /events/archive/2025-night-of-ssafynity 같은 상세 경로가 실제 정적 파일로 생성됩니다.
• /community는 /community/sns로 정적 리다이렉트됩니다.
• 원본 data와 public은 현재 리뉴얼 복사본과 동일합니다.
• 라우팅은 더 이상 React Router 중심이 아니라 Astro 파일 라우팅 기준입니다.
• 라이브 페이지 출력에는 React island와 React Router 호환 런타임이 남아 있지 않습니다.

디자인 시스템

• 공식 홈페이지의 디자인 기준은 docs/design-system.md를 따릅니다.
• 디자인 토큰은 src/site/index.css와 tailwind.config.ts에 저장소 내부 값으로 선언합니다.
• 블로그나 상위 작업공간 파일을 import하지 않으며, 이 저장소만으로 설치·빌드·배포할 수 있어야 합니다.

실행 명령

Node.js 22.12.0 이상과 npm 10 이상이 필요합니다.

npm install
npm run generate:pages
npm run build
npm run verify:migration