chaddungnam.github.io
House Duck와 Quirky Ball의 공개 웹 자산(개인정보처리방침, 이용약관,
고객지원, app-ads.txt, House Duck 운영 콘솔 화면)을 GitHub Pages로 호스팅하는 저장소입니다.
이 저장소는 웹사이트처럼 누구나 볼 수 있습니다. 게임 소스, Supabase 키, 비밀번호, 서명 키, 데이터베이스, 사용자 데이터는 넣지 않습니다.
커밋 전에 아래 검사를 실행합니다.
scripts/check_public_repo.sh
scripts/check_legal_site.sh
scripts/check_house_duck_console.sh
node scripts/test_console_model.js
node scripts/test_gmail_model.js
로컬 보호 훅은 이 저장소에 설정되어 있으며, GitHub에서도 같은 검사를
자동 실행합니다. 보안 문제 제보 절차는 SECURITY.md를 따릅니다.
House Duck Console
- 플레이어 검색 → 상세의
최초 튜토리얼에서 시작·완료·완료 후 홈 도착을 확인합니다. 기존 Supabase 이벤트를 동일 실행의 계정 생성~최초 홈 방문 구간에 연결하며, 복수 계정의 구간이 겹쳐 식별할 수 없으면 제외합니다. 기록 없음은 미완료 확정이 아니며 Google 광고 전환 수신 여부와 별개입니다. 앱 재배포는 필요하지 않습니다. /console/은 Google 허용 계정과 서버의 2차 질문 확인을 모두 통과해야 열립니다.- 재화·점수·운영 변경은 브라우저가 데이터베이스를 직접 쓰지 않고 관리자 Edge Function과 감사 RPC만 사용합니다. 플레이어 수정 플래그의 기본값은
false입니다. - 플레이어 상세의
감사 기록에서 보기로 해당 계정의 전체 관리자 변경 이력을 조회합니다. 상세에도 성공·실패와 오류 코드가 표시됩니다. 이 기록은 관리자 지급·조정 이력이며 게임 내 자동 미션 보상의 시도 로그가 아닙니다. 계정 전환·필터 해제·응답 역전은node scripts/test_console_audit_navigation.js로 검증하며 공용 콘솔 검사에도 포함됩니다. /analytics/는 호환 주소이며 통합 콘솔의 분석 화면으로 이동합니다.- Gmail CS는
gmail.modify토큰을 CS 화면에서만 요청하고 브라우저 메모리에만 둡니다. 메일·첨부·토큰은 Supabase와 저장소에 복사하지 않습니다. 이 내용은 공용 개인정보처리방침 제14항에 공개되어 있으므로, Gmail·로그인·요약 동작을 바꾸면 제14항(영·한·독)도 함께 고칩니다. - 동무와 멋진신세계는 준비 중입니다. 구매 화면은 서버에 기록된 구매·환불만 표시하며, 가격이 없으면
금액 미기록으로 표시합니다.
HEXAWORLD 1984
프로젝트 선택 화면의 HEXAWORLD 1984 카드는 두 번째 게임의 운영 화면입니다(운영 개요 · 공지 · 출석 보상 · 우편 발송 · 앱 설정 · 감사 로그). Quirky Ball과 완전히 분리된 Supabase 프로젝트(console/app.js의 HEXAWORLD_CONFIG)를 별도 apikey로 호출하며, console/api.js의 ConsoleAPI.postProject("hexaworld", "hx-admin", ...)만 사용합니다. Quirky Ball 클라이언트(ConsoleAPI.post)는 손대지 않았으므로 기존 요청은 그대로입니다.
- 인증은 Quirky Ball 로그인 화면과 72시간 세션 티켓을 그대로 재사용합니다. HEXAWORLD 서버는
ADMIN_SESSION_SECRET환경변수가 설정되어 있으면 세션 티켓만으로 인증하고, 아직 설정 전이면 Google ID 토큰(1시간 유효)을 직접 검증합니다. 소유자가 할 일: HEXAWORLD Supabase 프로젝트(frepunpqswciugwoyvxo)의ADMIN_SESSION_SECRET를 Quirky Ball 콘솔 프로젝트와 같은 값으로 설정하면, Google 로그인이 만료돼도 세션 티켓만으로 계속 작동합니다. 설정 전에는 약 1시간마다 재로그인이 필요할 수 있습니다 — HEXAWORLD 화면에서 403(admin_session_required)을 받으면 Quirky Ball 세션(티켓)은 그대로 둔 채 인라인 Google 로그인 버튼만 다시 표시합니다(console/auth.js의renderGoogleButton). - 이 계정이 HEXAWORLD 관리자 목록(
hx_admins테이블)에 없으면 403(admin_required)과 함께 같은 안내가 표시됩니다. - 공지는 분류(
notice/event/update/maintenance)·한/영 제목·본문·링크·이미지·고정·우선순위·게시 시작/종료(KST)를 가지며 소프트 삭제됩니다. 출석 보상은 1일차부터 연속된 최대 28일 사이클이고, 우편 발송은 전체 플레이어 대상 즉시 발송, 앱 설정은 강제 업데이트 버전·점검 모드·스토어 링크·기능 플래그를 다룹니다. 모든 쓰기 작업은 요청마다 새request_id를 보내고, 삭제·점검 켜기 같은 영향이 큰 작업은 효과를 다시 설명하는 확인 대화상자를 거칩니다. - 공지 본문 미리보기와 링크 검사는
assets/notice-links.js(공개 공지 페이지와 공유)의NoticeLinks.render/NoticeLinks.isYouTubeUrl을 그대로 사용합니다. - 검사:
scripts/check_house_duck_console.sh,node scripts/test_notice_links_parser.js,node scripts/test_console_regressions.js.
법적 문서 문구 수정 방법
- 법적 문서는 영어(기본), 한국어, 독일어로 유지합니다(소유자 2026-10-20: 독일어 복원, GDPR).
ja.html법적 주소는 앱이 열 수 있으므로 지우지 않고, 같은 문서의 영어판으로 보내는 작은 리디렉트로 둡니다. 언어 선택index.html은 브라우저 언어 목록에서 영어보다 한국어가 먼저면ko.html, 독일어가 먼저면de.html, 그 밖에는(일본어 포함)en.html로 보냅니다. 딸깍 서바이벌(10key Survival) 이용약관은 영어·한국어만 있고, 독일어 페이지는 영어 약관을 연결합니다. - 개인정보처리방침은 House Duck 공용
privacy/<언어>.html하나이고(딸깍 서바이벌은 제13항, 고객지원 메일·직원 전용 운영 콘솔·Gmail 접근은 모든 게임 공통인 제14항, 변경 이력은 제15항), 이용약관은 게임마다quirky-ball/terms/,10key/terms/에 있습니다. 동무(hexaworld1984/)는 출시 전까지 자체 방침을 유지합니다.quirky-ball/privacy/<언어>.html,10key/privacy/<언어>.html은 공용 방침으로 가는 리디렉트입니다. - 게임 이름(소유자 2026-10-20, 출시 전 변경): 영어·독일어 문서는
10key Survival, 한국어 문서는딸깍 서바이벌(문서에서 처음 나올 때 한 번(10key Survival)을 붙임).10KEY는 프로젝트 이름일 뿐이며, 설치된 앱과 스토어가 링크하는 주소·파일·앵커(/10key/,#10key,#section-13,10key/config.json)는 바꾸지 않습니다. 변경 이력의 이름 변경 줄에만 옛 이름10KEY가 남습니다. - 스토어·앱·Google이 링크하는 입구 주소(
/privacy/,/quirky-ball/privacy/,/10key/privacy/,/quirky-ball/terms/,/10key/terms/,/hexaworld1984/privacy/,/hexaworld1984/terms/)는 언어 선택이나 리디렉트가 아니라 영어 문서 전문을 바로 보여 줍니다(2026-10-20, Google OAuth 브랜드 검토에서 언어 선택 화면이 "내용 부족"으로 거절됨). 이index.html은python3 scripts/build_legal_entry_pages.py가 영어 원문에서 만들므로 직접 고치지 않습니다. 영어 원문을 고친 뒤 이 스크립트를 실행하고,scripts/check_legal_site.sh는 사본이 원문과 다르면 실패합니다. 브라우저 언어 목록에서 한국어(또는 독일어 문서가 있으면 독일어)가 영어보다 먼저인 사람만 그 언어 문서로 옮기고,/10key/privacy/는 제13항에서 열립니다. - 홈페이지 바닥글의
House Duck Console (staff only)는 콘솔의 Google 로그인 용도를 설명하는 제14항으로 연결됩니다. - 제목·시행일은
문서 메타데이터 시작/끝, 본문은문서 본문 시작/끝주석 안에서만 수정합니다. - 섹션 제목의
id="section-..."는 자동 목차가 사용하므로 지우지 않습니다. - 색상·간격·모바일·인쇄 모양은
assets/legal-site.css, 목차·연도는assets/legal-site.js가 공통 관리합니다. - 문구 수정 후
python3 scripts/build_legal_entry_pages.py,scripts/check_legal_site.sh,scripts/check_policy_content.sh,node scripts/test_legal_operations_tools.js를 실행합니다.
공지 블록 편집
운영 → 게임 공지는 모드 전환 없는 단일 작성 영역입니다. 글을 쓰다 이미지를 붙여넣거나 파일을 선택하면 커서 위치에 브라우저 압축 WebP를 업로드·삽입합니다. 문단 크기, 굵게·기울임·밑줄, 정렬, 이미지 너비·대체 텍스트를 지원합니다. HTTPS 링크는 작성 영역과 실제 공지 본문에서 카드로 표시하고, YouTube는 썸네일을 표시합니다. 일반 웹에서는 클릭 후에만 개인정보 강화 플레이어를 로드하며 자동 재생하지 않습니다. 앱 embed는 기존 네이티브 링크 제한을 유지하므로 썸네일만 표시하고 외부 재생은 지원하지 않으며, YouTube 링크(썸네일·본문 내 링크 모두)는 네이티브 WebView가 가로채도록 target=_self로 렌더링합니다(해당 네이티브 가로채기 자체는 별도로 고치는 중입니다). 기존 일반 텍스트와 v1 공지 콘텐츠는 같은 저장 계약을 유지하며 원격 OG 메타데이터는 수집하지 않습니다. 분류 선택에서 [공지]·[이벤트]·[예고]를 고르며 목록·상세에는 문구와 색상 배지가 함께 표시됩니다. 기존 글의 수정으로 분류·본문·날짜를 바꾸고 삭제는 사유와 확인란을 거친 뒤 노출을 중지합니다. 삭제된 글의 감사 기록과 공용 이미지는 보관합니다.
- PNG/JPEG/정적 WebP를 브라우저에서 최대 긴 변 1,600px의 WebP로 변환합니다. 목표는 200 KiB, 업로드 상한은 300 KiB입니다. 필요하면 품질과 해상도를 단계적으로 낮춥니다. 큰 원본을 별도로 보관하지 않고 검증된 최종 WebP만 전송합니다. 이미 작고 메타데이터가 없는 정적 WebP는 재압축으로 더 커지지 않도록 그대로 사용합니다.
- 공지당 최대 60블록·이미지 8개를 허용합니다. 본문·문단 구분·이미지 설명을 포함한 원문 한도는 2,000자입니다.
- 서버는 구조화된 문단만 번역하고 이미지 경로·서식은 보존합니다. 이미지는
announcement-media의 SHA-256 경로로 중복 저장을 피하며 공개 공지용 자산입니다. 공개 화면은 HTML을 실행하지 않고 텍스트와 허용된 이미지 경로만 렌더링합니다. - 배포 순서: 게임 서버 저장소의
20260906120000_rich_announcement_content_and_media.sql와20260906130000_announcement_category_and_soft_delete.sql마이그레이션,admin-console·public-noticeEdge Function, 이 웹사이트 순서입니다. 서버 반영 전에는 새 편집기만 먼저 배포하지 않습니다. 기존 앱의 텍스트 폴백은 유지되며 웹뷰에서 서식·이미지를 표시합니다. - 검사:
node --test tests/notice-content.test.mjs tests/notice-contract.test.mjs,node scripts/test_console_regressions.js,npx playwright test tests/console-announcement.spec.js tests/console-announcement-editor.spec.js tests/console-announcement-delete.spec.js tests/notice-rich-content.spec.js.