프로젝트 소스 공개

2026-09-06 17:11:40 +09:00
commit 0f0431de5a
676 changed files with 106118 additions and 0 deletions
@@ -0,0 +1,37 @@
+# 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 콘텐츠는 원 제작자 또는 커뮤니티 페이지로 연결합니다.
+- 배포 전에 소스맵과 이미지·HTML 메타데이터를 확인합니다.