playuniare.sori.studio/docs/history.md

구조 및 의사결정 이력

2026-06-19: 독립 Vue 프로젝트로 시작

• 기존 UA Deck Builder와 별도 Git 저장소로 분리했다.
• 덱 빌더는 카드 선택과 덱 데이터 제공을 담당한다.
• Play Uniare는 카드 조작과 실시간 세션을 담당한다.
• 카드 이미지의 대규모 복제를 피하기 위해 기존 카드 자산 도메인을 참조한다.

2026-06-19: Vue 3, Vite, Tailwind CSS 채택

• 사용자가 직접 유지보수할 수 있는 Vue 3를 선택했다.
• 정적 빌드와 빠른 개발 서버를 위해 Vite를 사용한다.
• 일관된 UI 작성을 위해 Tailwind CSS를 기본 스타일 방식으로 정했다.

2026-06-19: 카드 소유자만 조작하는 권한 모델

• 플레이어는 자신이 소유한 카드만 조작한다.
• 전투나 효과로 내 카드가 제거되어도 내 카드 소유자가 직접 정리한다.
• 이 원칙으로 동시에 같은 카드를 수정하는 충돌을 줄인다.
• 온라인 모드에서는 서버가 소유권을 최종 검증한다.

2026-06-19: Docker 기반 NAS 배포

• UGREEN NAS에서 재현 가능한 배포를 위해 Docker Compose를 사용한다.
• Vue 빌드에는 Node.js를 사용하고 실행 이미지는 Nginx를 사용한다.
• 초기에는 테스트와 운영 컨테이너를 분리했으며 이후 운영 단일 구조로 단순화했다.

2026-06-19: 기존 카드 이미지 읽기 전용 공유

• 기존 Uniare의 실제 웹 루트는 /volume1/docker/projects/apps/uniare/config/www로 확인했다.
• 카드 원본은 해당 웹 루트의 images 폴더를 사용한다.
• 새 프로젝트의 NAS 위치는 /volume1/docker/projects/apps/playuniare로 정했다.
• 이미지 중복 저장을 막기 위해 Docker bind mount를 사용한다.
• 원본 보호를 위해 컨테이너에는 읽기 전용으로 연결한다.
• 브라우저에는 같은 출처의 /card-assets 경로로 제공한다.

2026-06-19: 실시간 서버 포트 정책

• 흔히 사용하는 3000 대신 로컬 Socket.IO 기본 포트를 31873으로 정했다.
• Docker 내부 포트는 다른 컨테이너와 중복될 수 있음을 명시했다.
• NAS 호스트 공개 포트만 중복되지 않도록 관리한다.
• 운영 환경에서는 포트를 직접 공개하지 않고 /socket.io 리버스 프록시를 사용한다.

2026-06-19: NAS HTTP 포트 환경변수화

• 기존 테스트 포트 18080이 NAS의 다른 서비스와 충돌했다.
• 테스트 기본 포트를 41808, 운영 기본 포트를 41809로 변경했다.
• NAS별 포트 충돌에 대응할 수 있도록 .env와 Compose 변수로 관리한다.

2026-06-19: NAS 카드 이미지 ACL 대응

• NAS 카드 파일은 POSIX 권한이 열려 있어도 ACL 때문에 기본 Nginx UID 101에서 읽기가 거부되었다.
• 카드 파일 소유자 UID가 1000인 것을 확인했다.
• Nginx 워커를 UID 1000의 cardreader 사용자로 실행하도록 변경했다.
• Vue 정적 파일에는 빌드 단계에서 명시적인 읽기 권한을 적용했다.

2026-06-19: 로컬 테스트와 NAS 운영 단일화

• 기능 및 Docker 검증은 개발 Mac에서 수행한다.
• NAS에는 운영 컨테이너 하나만 유지한다.
• 테스트 Compose 파일과 테스트 포트 환경변수를 제거했다.
• 운영 주소를 http://playuniare.sori.studio로 확인했다.
• 영구 데이터가 생길 때 적용할 마이그레이션 운영 원칙을 문서화했다.

2026-06-19: 대기실과 게임 화면 분리

• Vue Router를 도입해 / 대기실과 /game 게임 화면을 분리했다.
• Pinia를 도입해 방 코드와 플레이어 준비 상태를 관리한다.
• 덱 등록 시 50장, 동일 카드, 트리거, AP 기본 규칙을 검사한다.
• 게임 시작 준비로 첫 손패, 1회 멀리건, 라이프 7장을 구현했다.

2026-06-19: Socket.IO 온라인 대기실

• Node.js Socket.IO 서버를 추가하고 방 상태를 서버 메모리에서 관리한다.
• 6자리 방 생성, 방 코드 참가, 서버 덱 재검증, 준비 상태 동기화를 구현했다.
• 양쪽 준비 완료 시 플레이어별 좌석과 자신의 덱 쿼리를 전달한다.
• 브라우저는 같은 출처의 /socket.io로 연결하고 Nginx가 Docker 내부 playuniare-server:31873으로 프록시한다.
• Socket.IO 포트는 NAS 호스트에 직접 공개하지 않는다.
• 현재 서버 재시작 시 방이 사라지는 단순한 구조를 유지하고, 게임 상태 동기화와 재접속 복구는 후속 단계에서 구현한다.