freshman

# 臺科新生懶人包 (freshman) 「臺科新生懶人包」은 국립대만과학기술대학교 학생들이 공동으로 유지 관리하는 오픈소스 신입생 가이드입니다. 이 프로젝트는 신입생들이 수강 신청, 기숙사, 일상생활 등에서 자주 겪는 어려움과 질문을 체계적으로 정리하고, 오픈소스 방식으로 누구나 콘텐츠를 기여하고 수정할 수 있도록 하는 것을 목표로 합니다. ## 주요 콘텐츠 가이드는 다음 네 가지 영역을 다룹니다: * **수강 신청**: 전문 용어 이해부터 실전 팁까지. * **생활**: 기숙사, 식당, 교통, 동아리 정보 포함. * **정보**: 캠퍼스 계정 사용, 납부 절차, 유용한 도구 추천 및 커뮤니티 링크. * **기타**: 신입생 자주 묻는 질문(FAQ)과 대만과기대 냉지식. ## 주요 기능 * **학과별 맞춤 콘텐츠**: 사용자가 선택한 학과에 따라 직속 선배의 조언과 정보를 표시합니다. * **학년도 학사 일정**: 학교 공지에서 가져온 학년도 학사 일정을 자동으로 동기화하여 표시합니다. * **오픈 기여**: 모든 문서는 순수 Markdown 파일로 작성되어, 기여자는 GitHub 웹 인터페이스에서 직접 오타 수정이나 내용 보충을 할 수 있어 기여门槛이 낮습니다. ## 기술 아키텍처 * **프레임워크**: Astro 7을 사용한 정적 사이트 생성(SSG). * **콘텐츠 관리**: Markdown과 content collections, zod strict schema를 사용하여 구조적으로 관리합니다. * **배포**: Cloudflare Pages에 호스팅됩니다. * **문법 확장**: 사용자 정의 remark-directive와 serializer를 통해 특수 Markdown 문법을 지원합니다. ## 개발 및 기여 프로젝트는 Node.js 22.12 이상 환경을 요구합니다. 기여자는 Conventional Commits 규칙을 준수해야 하며, `feat/` 또는 `fix/` 접두사로 브랜치 이름을 지정해야 합니다. 콘텐츠 수정 시 출처나 직접 경험을 첨부해야 하며, 연도별 데이터(예: 금액, 요율)는 확인 날짜를 명시해야 합니다. UI 문구와 콘텐츠는 번체 중국어를 사용하고, 코드 주석은 영어를 사용합니다. ## 라이선스 및 면책 이 프로젝트는 GNU Affero General Public License v3.0에 따라 라이선스가 부여됩니다. 특히 이 프로젝트는 국립대만과학기술대학교와 공식적인 관련이 없으며, 콘텐츠는 학생들이 경험을 바탕으로 정리한 것으로 실제 규정, 금액, 일정은 항상 학교 공지를 기준으로 합니다.