# ProjectQuint 사이트

ProjectQuint 소개, 사용 안내, 외부 BMS 자료 링크와 macOS 배포 정보를 제공하는 Astro 사이트입니다.

## 개발과 검증

저장소의 `Website/projectquint-site`에서 실행합니다.

```bash
npm ci
npm run check
npm run build
```

생성된 정적 파일은 `dist/`에 저장됩니다. 공개 사이트 주소는
`https://projectquint.duckdns.org`입니다.

## 배포 설정

실제 서버 주소와 SSH 키 경로는 저장소 루트의 `.release.local.json` 또는
`PROJECTQUINT_DEPLOY_HOST`, `PROJECTQUINT_DEPLOY_KEY`,
`PROJECTQUINT_REMOTE_SOURCE` 환경 변수로 지정합니다. 설정 파일은 Git에서 제외합니다.
설정 방법은 `Tools/RELEASE.md`를 참고합니다.

빌드를 확인한 뒤 `./ops/deploy-oci.sh`로 배포합니다. 기존 배포 대상과 다른
디렉터리를 지정하기 전에 해당 디렉터리의 소유 서비스와 내용을 확인해야 합니다.
스크립트는 정적 사이트 디렉터리를 동기화하고 Nginx 설정을 검증한 뒤 다시 로드합니다.

앱 배포 파일은 정적 사이트와 별도 경로에 보존합니다. 버전과 체크섬은
`src/pages/download.astro`, `src/pages/changelog.astro`, `public/updates/`에서 관리합니다.

## 공개 자료의 범위

- 개인 이름, 개인 계정, 개인 GitHub 링크를 공개 페이지에 넣지 않습니다.
- BMS 음원·재킷·BGA 원본 파일은 사이트에서 배포하지 않습니다. 게임 스크린샷에는 외부 BMS를 사용한 실행 예시임을 명시합니다.
- 외부 BMS 콘텐츠는 원 제작자 또는 커뮤니티 페이지로 연결합니다.
- 배포 전에 소스맵과 이미지·HTML 메타데이터를 확인합니다.