🎭 멀티진진가 (진짜 진짜 가짜) · made by 문수네집

학생들이 진짜 사실 5가지를 적으면 그중 하나를 그럴듯한 가짜로 바꿔, 반 전체가 "어느 것이 가짜일까?"를 맞히는 실시간 교실 게임입니다. QR로 입장하고 api.moonsunezip.com의 PostgreSQL REST API와 방 단위 WebSocket으로 동기화합니다. 화면은 index.html, 데이터 연결은 postgres-adapter.v1.js입니다. 방·학생·문제·투표는 임시 데이터입니다.

made by 문수네집 — 🏠 문수네집 · 📷 인스타그램 · ✨ moonsune.zip

✅ 배포 완료 — 바로 사용 가능

👉 https://jinjinga.moonsunezip.com

• 데이터 원본: 홈서버 PostgreSQL (api.moonsunezip.com)
• 배포: GitHub main 푸시 후 홈서버 자동 배포. Firebase 데이터 저장은 사용하지 않습니다.

봇 학생 (촬영 시연 · 실제 수업에 섞어 쓰기)

1. 선생님으로 실제 방을 만듭니다. 대기실의 🤖 봇 학생 추가에서 주제를 고릅니다.
2. 나를 소개합니다·음식 취향 소개·운동 취향 소개·동물 취향 소개 중 하나를 선택하고 봇 1명 추가, 봇 5명 추가, 최대 50명 채우기를 누릅니다. 선생님은 학생 수에 포함되지 않습니다.
3. 실제 학생이 이미 들어와 있어도 봇을 추가할 수 있습니다. 봇과 실제 학생을 합쳐 50명까지입니다. 실제 학생이 있으면 선생님이 정한 방 주제를 그대로 두고, 학생이 없는 촬영 방이면 방 주제가 봇 주제로 바뀝니다.
4. 제출이 끝나면 발표 시작하기를 누릅니다. 봇은 자기 문제를 빼고 실제 학생의 문제와 다른 봇의 문제에 모두 투표합니다.
5. 정답 공개·다음 문제·게임 종료는 기존 버튼으로 조작합니다. 봇 일시정지 / 계속 진행으로 봇 투표를 멈추거나 이어갈 수 있습니다.

• 각 주제에 미리 만든 가상 소개 프로필 100개(진짜 5문장과 대응하는 가짜 문장)가 있습니다. '나를 소개합니다'는 가족 수·좋아하는 과목·취미·장래희망·생일 계절 같은 항목에서 5개를 골라 만들고, 가짜는 같은 항목의 값만 바꿉니다. 외부 AI 호출 없이 무작위로 고릅니다. 가상 학생의 설정이며 실제 사람에 대한 내용이 아닙니다.
• 50명 기준 문제별 정답률은 약 42→50→58→66→72→62→52→44→36→46% 순서로 변합니다. 맞히는 봇과 오답 선택지는 매번 무작위입니다. 인원이 적으면 표 수에 맞춰 반올림됩니다.
• 대기실에서 봇만 비우기로 봇의 참가·문제만 비울 수 있습니다. 실제 학생의 데이터는 비우지 않습니다. 주제를 바꾸려면 먼저 봇을 비웁니다.
• 교사 화면을 열어 둬야 봇이 자동으로 투표합니다. 새로고침 후에도 방 설정에 저장된 봇을 이어받습니다. 생성 중 다른 방으로 이동하면 나머지 생성은 멈춥니다.
• 2026-10-31 고침: 선생님이 자동 제한시간을 바꾸면 settings가 통째로 바뀌어 봇 목록(demoTopic·demoBotIds)이 지워지고 봇 투표가 멈추던 문제를 고쳤습니다. 어댑터의 child('settings').update()가 Firebase처럼 기존 값에 합쳐 보냅니다.
• 데이터 등급: 기존 진진가와 같은 임시 데이터입니다. 기존 api.moonsunezip.com/v1/jinjinga/rooms/...의 학생·문제·투표별 행을 사용하며 별도 API·DB·서버·소켓을 만들지 않습니다. 100ms 이상 간격으로 생성하고 한 번에 1표씩 전송합니다. 기존 requestId 및 제한된 재시도를 유지합니다.
• 운영 서버 설정: 정적 화면 3001, 공용 PostgreSQL API 3100. 기존 API 주소·스키마·PM2·Cloudflare 설정 변경은 필요 없습니다.

검증: node --test demo-bots.test.mjs postgres-adapter.test.mjs. 50명 생성, 25명 투표, 50명 정답률 변화, 중복 클릭, 새로고침·방 이동, 학생별 제출 플래그 저장, 실제 학생이 있는 방에 봇 추가 후 실제 학생 문제에 투표, 제한시간 변경 후 봇 목록 유지를 확인합니다. 브라우저 검증은 운영 API와 분리한 로컬 API 모형을 사용했습니다.

게임 흐름

자동 다음 문제와 재입장 안내 (2026-10-16)

• 선생님 대기실의 정답 공개 후 자동으로 다음 문제에서 정답을 보여줄 시간을 **5~10초(1초 단위)**로 선택하고 켭니다. 기본값은 꺼짐이며 기존 방의 수동 진행은 유지합니다.
• 기존 문제별 자동 제한시간은 투표 시간을 정합니다. 새 설정은 정답 공개가 끝난 뒤 기다릴 시간입니다. 마지막 문제는 결과 화면으로 이동합니다.
• 발표 화면에서도 시간 변경·켜기·끄기가 가능하고, 정답 팝업의 자동 다음 문제 멈추기로 설명할 시간을 확보할 수 있습니다. 시간을 바꾸거나 다시 켜면 선택한 시간만큼 새로 기다립니다.
• 선생님 화면을 열어 두어야 자동으로 진행합니다. 다음 이동 시각은 방의 present.nextAt에 한 번 기록하고 학생 화면은 같은 시각으로 남은 시간을 표시합니다. 매초 서버에 요청하지 않으며, 새로고침해도 기존 이동 시각을 유지합니다.
• 학생 닉네임 입력란에 기억할 닉네임 또는 번호를 안내합니다. 같은 방에 같은 이름·번호로 재입장하면 기존 문제·투표·자리를 이어받으므로 친구끼리 겹치지 않도록 설명합니다.

검증: node --test auto-next.test.mjs demo-bots.test.mjs postgres-adapter.test.mjs (34개). 운영 API와 분리한 로컬 모형 API + 실제 Chrome에서 5초·10초, 멈춤·재개, 새로고침, 교사·학생 동시 이동, 마지막 결과, 390px 닉네임 안내와 번호 재입장을 확인했습니다. 이 앱은 정적 HTML/JS라 별도 빌드 과정이 없으며 인라인 JS 문법 검사를 포함합니다.

1. 선생님: 접속 → 문제 방 만들기 → 주제 입력 + 가짜 방식 선택(AI / 직접 작성) → 방 생성
2. QR코드·방 코드가 표시됨. 학생은 QR을 찍거나 코드 입력 → 이름 입력 → 입장
3. 학생: 진짜 사실 5개 작성 → 그중 1개를 골라 비슷한 가짜로 직접 변경(예시·팁 자동 안내) → 제출
4. 선생님 화면: 누가 제출했는지 실시간 표시 (○/○ 완료)
5. 선생님: 발표 시작하기 → 학생 한 명씩 문제 슬라이드 표시
6. 학생: 각자 폰에서 가짜라고 생각하는 보기에 투표 (실시간 집계)
7. 선생님: 정답 공개 → 가짜 강조 + 진짜값 + 정답률 → 다음 → 반복
8. 마지막에 문제별 정답률 요약

가짜 만드는 방식

학생이 진짜 5개 중 하나를 골라 직접 비슷한 가짜로 바꿉니다. 작성 화면에 예시·팁이 자동으로 표시돼요:

• 🔢 숫자·개수: "강아지를 3마리 → 2마리 키운다"
• 📍 장소: "제주도 → 부산에서 태어났다"
• 📅 연도·이름: "2015년 → 2016년에 이사했다"

AI·외부 API를 전혀 쓰지 않습니다. API 키·요금·네트워크 호출이 필요 없어 100% 무료로 동작합니다.

데이터 구조 (Realtime Database)

rooms/JJG_<코드>
  ├─ topic, state(writing|presenting|done)
  ├─ players/<pid>   : name, submitted
  ├─ problems/<pid>  : items[5], fakeIndex, realValue, submittedAt
  ├─ present         : order[], idx, revealed
  └─ votes/<주인pid>/<투표자pid> : 선택한 보기 index

기존 qr-bingo 보안 규칙(rooms/$room 읽기·쓰기 허용)을 그대로 사용하므로 규칙 수정이 필요 없습니다.

파일

• index.html — 앱 전체 (HTML/CSS/JS + Firebase + QR, 빌드 불필요)
• firebase.json, .firebaserc — 배포 설정 (hosting target: jinjinga → 사이트 jinjinga-class)

🏠 홈서버 배포 정보 (moonsunezip 노트북 서버)

다른 세션·다른 AI 에서 이 앱을 고치기 전에 이 섹션을 먼저 읽으세요. 서버 관리자가 관리하는 섹션입니다(마지막 갱신 2026-09-27). 앱 설명은 위쪽 본문을 보세요.

멀티진진가 — 운영 정보

항목	값
주소	https://jinjinga.moonsunezip.com
서버 포트	3001 (PM2 이름 jinjinga)
배포 브랜치	main
배포 방식	빌드 없음 — 저장소 루트의 index.html 등을 그대로 정적 서버가 제공
서버 위치	C:\homeserver\apps\multijinjinga

이 앱만의 주의점

• 빌드 과정이 없어서 저장소 루트의 파일이 그대로 공개됩니다. 비밀값이나 내부 메모 파일을 루트에 두지 마세요.
• 데이터는 postgres-adapter.v1.js → https://api.moonsunezip.com/v1/jinjinga/…, 실시간은 wss://api.moonsunezip.com/v1/realtime?room=방코드 입니다(쿼리 이름은 room, code 아님). 실시간은 서버→화면 단방향이고, 보내는 것은 HTTP 로 합니다.
• 진진가 데이터(jjg_* 테이블)는 임시 데이터입니다. PostgreSQL UNLOGGED 테이블이라 빠르지만, 24시간이 지나면 자동 삭제되고 서버가 비정상 종료되면 비워집니다. 선생님이 오래 남길 기능(문제 저장 등)은 /v1/documents 같은 영구 저장소를 쓰세요.
• firebase.json, pb-adapter.js 는 예전 흔적입니다. 새 코드에서 쓰지 마세요.
• 실측 수용량: 권장 5,000명(200개 반), 동시 WebSocket 10,400개까지 끊김 없음 확인.

이 서버는 어떤 곳인가

• 집 노트북 1대(Lenovo IdeaPad L340 · i5-9300H 4코어 8스레드 · RAM 8GB · Windows 11)가 moonsunezip.com 의 앱 전부를 서비스합니다.
• 모든 앱은 127.0.0.1 에만 열리고, 외부 접속은 Cloudflare Tunnel 이 전담합니다(집 IP·포트 비노출, HTTPS 자동).
• 프로세스는 PM2 가 관리하고, 5분마다 감시(watchdog) 가 죽은 앱을 되살립니다.
• 데이터 저장은 PostgreSQL 17 + 공용 API(https://api.moonsunezip.com) 입니다. Firebase·PocketBase 는 새로 쓰지 않습니다.
• 여유 자원: RAM 여유 약 0.8GB(넉넉하지 않음), 집 인터넷 업로드 약 170Mbps(Wi-Fi).

배포 흐름 — 반드시 이해하고 수정하세요

1. 배포 브랜치에 push 하면 서버가 3분 안에 감지합니다.
2. 서버는 git reset --hard origin/<브랜치> 로 코드를 통째로 덮어쓰고 → npm ci → npm run build → PM2 재시작 순서로 배포합니다.
3. 빌드나 헬스체크가 실패하면 이전 버전으로 자동 롤백되고 사이트는 이전 상태로 유지됩니다.

This is the beginning of the README. Read the rest at the original. Read the full README ↗