fix CI lockfile sync and simplify Docker docs.

Regenerate package-lock for npm ci, bump Node to 22, and trim compose env to secrets only.

Co-authored-by: Cursor <cursoragent@cursor.com>

README.md

@@ -4,35 +4,111 @@ Nuxt 3 기반 멀티 스크린 화면 공유 플랫폼 (Native WebRTC P2P Mesh +
 
 ## 빠른 시작 (로컬)
 
+로컬 개발은 **`.env` 파일**로 설정을 관리합니다.
+
 ```bash
 cp .env.example .env
+# .env 에서 JWT_SECRET, ADMIN_USERNAME, ADMIN_PASSWORD 등 수정
 npm install
 npx prisma migrate dev
 npm run dev
 ```
 
+`.env.example`을 복사한 뒤 값을 수정합니다.
+
+### 환경 변수
+
+로컬(`.env`)과 Docker(`environment`)에서 동일하게 사용합니다.
+
+| 변수 | 필수 | 기본값 | 설명 |
+|------|------|--------|------|
+| `JWT_SECRET` | 예 | — | 관리자 JWT·방 accessToken 서명 키. 프로덕션에서는 긴 난수로 변경 |
+| `ADMIN_USERNAME` | 예 | `admin` | 관리자 로그인 아이디 |
+| `ADMIN_PASSWORD` | 예 | — | 관리자 로그인 비밀번호 (반드시 변경) |
+| `DATABASE_URL` | 아니오* | 로컬 `file:../data/sejong.db` / 이미지 `file:/app/data/sejong.db` | Prisma SQLite DB 경로 (*Docker 이미지가 기본값 포함) |
+| `MAX_ROOM_MEMBERS` | 아니오 | `8` | 방당 최대 참여자 수 (하드 리밋) |
+| `MAX_CONCURRENT_STREAMS` | 아니오 | `4` | 방당 동시 화면 공유(방송) 수 상한 |
+| `ROOM_ACCESS_TTL_DAYS` | 아니오 | `7` | 방 비밀번호 통과 후 발급되는 accessToken 유효 기간(일) |
+| `HOST` / `NITRO_HOST` | 아니오* | `0.0.0.0` | 바인딩 주소 (*Docker 이미지 기본값) |
+| `PORT` / `NITRO_PORT` | 아니오* | `3000` | 리스닝 포트 (*Docker 이미지 기본값) |
+
+Docker Compose에서는 보통 **`JWT_SECRET` / `ADMIN_USERNAME` / `ADMIN_PASSWORD`만** 지정하면 됩니다.
+
 - 앱: http://localhost:3000
-- 관리자: http://localhost:3000/admin (기본 `admin` / `admin` — `.env`에서 변경)
+- 관리자: http://localhost:3000/admin (계정은 위 `ADMIN_*` 값)
+
+> **참고:** `localhost`의 HTTP는 브라우저가 예외로 허용합니다. 다른 PC·사설 IP·도메인으로 접속할 때는 아래 HTTPS 요구사항을 보세요.
+
+## HTTPS 요구사항 (필수)
+
+**화면 공유·시스템 오디오 등 핵심 기능을 쓰려면 HTTPS로 접속해야 합니다.**
+
+브라우저는 `navigator.mediaDevices.getDisplayMedia()`(화면/창 캡처)를 **보안 컨텍스트(Secure Context)** 에서만 허용합니다.
+
+| 접속 방식 | 화면 공유 | 비고 |
+|-----------|-----------|------|
+| `https://도메인` | 가능 | 프로덕션·LAN 공용 권장 (NPM Plus SSL) |
+| `http://localhost` | 가능 | 개발 PC 본인만 |
+| `http://192.168.x.x` 등 사설 IP | **불가** | UI·입장은 열려도 화면 공유가 차단됨 |
+
+따라서 같은 네트워크의 다른 PC와 테스트하거나 실제로 쓰려면 **NPM Plus 등으로 SSL을 켠 뒤 `https://...`로 접속**하세요. Socket.io 시그널링도 같은 호스트의 **WSS**(WebSocket over TLS)로 붙는 구성이 안전합니다.
 
 ## Docker + NPM Plus
 
-레지스트리 이미지 예:
+### 레지스트리 이미지로 실행 (권장)
 
-```bash
-docker pull docker.sejong.dev/sejong-tv:latest
+아래 `docker-compose.yml` 예시처럼 **시크릿·관리자 계정만** `environment`에 넣고 실행합니다.  
+(`DATABASE_URL`, 포트 등은 이미지 기본값 사용. 로컬 개발은 `.env` 파일.)
+
+```yaml
+services:
+  app:
+    image: docker.sejong.dev/sejong-tv:latest
+    container_name: sejong-tv
+    restart: unless-stopped
+    environment:
+      JWT_SECRET: change-me-to-a-long-random-string
+      ADMIN_USERNAME: admin
+      ADMIN_PASSWORD: change-me
+    volumes:
+      - sqlite_data:/app/data
+    # 직접 포트 노출 (로컬/테스트)
+    ports:
+      - "3000:3000"
+    # NPM Plus 연동 시: ports를 제거하고 아래 네트워크를 사용
+    # networks:
+    #   - npmplus
+
+volumes:
+  sqlite_data:
+
+# networks:
+#   npmplus:
+#     external: true
+#     # docker network ls 로 NPM Plus 네트워크 이름 확인 후 수정
 ```
 
-로컬 빌드:
+```bash
+docker compose pull
+docker compose up -d
+```
+
+NPM Plus Proxy Host 예: `http` → `sejong-tv:3000`, **Websockets Support ON**, **SSL(HTTPS) 필수 활성화**.  
+화면 공유를 포함한 전체 기능은 `https://도메인` 접속에서만 정상 동작합니다.  
+자세한 설정은 [docs/npmplus.md](docs/npmplus.md) 참고.
+
+### 로컬에서 이미지 빌드
 
 ```bash
 docker compose up -d --build
 ```
 
-프록시 설정은 [docs/npmplus.md](docs/npmplus.md) 참고.
+### Gitea CI
 
-Gitea CI: `main` 푸시 시 `docker.sejong.dev/sejong-tv:latest` 및 `sha-<commit>` 태그로 푸시합니다.  
+`main` 푸시 시 `docker.sejong.dev/sejong-tv:latest` 및 `sha-<commit>` 태그로 푸시합니다.  
 시크릿 `REGISTRY_USERNAME`, `REGISTRY_PASSWORD`가 필요합니다.
 
+
 ## 주요 기능
 
 - 관리자 방 생성/삭제 (영속, 방 비밀번호)