최초 기획 잔여 범위 전체 구현·실행·반복 QA 메뉴얼

DB·생존·실제 수원 공간·멀티 월드·브라우저·100명 검증까지 전체 범위를 유지하고 순차 실행합니다.

작업 중1회차 · 이번 5개 / 전체 12개완료 4 · 남음 8최신 버전에서 갱신 →

목표와 완료 기준

수원 기반 Unity TPS 생존 샌드박스의 최초 프로토타입 잔여 요구사항을 로컬 환경에서 구현·적용·실행 검증합니다. 전투·세력·차량 등 명시된 후속 확장은 제외합니다.

설정 기반 생존·수색·NPC·중립 제한, 실제 수원 원본 공간과 검증된 시작점, PostgreSQL/PostGIS 원자 저장·복원, 독립 월드·주변 채팅·재접속, Windows와 실제 브라우저 플레이, 100명 동시 접속 부하와 전체 회귀 QA, 실행 문서와 실제 화면을 포함한 외부 보고서 배포가 모두 확인되어야 합니다.

순차 작업 메뉴얼

순서대로 구현·QA를 확인합니다. 후속 회차에는1~5개만 선택하며 전체 미완료 목록은 보존합니다.

T01기준점과 전체 실행 범위 보존완료QA 통과

실행: 현재 소스를 로컬 Git 기준점으로 보존하고 최초 기획·기존 검토·실행 메뉴얼 지침을 대조합니다.
완료 기준: 복원 가능한 기준 커밋과 원래 전체 범위를 유지한 유효 메뉴얼이 존재합니다.
QA 절차: 기준 커밋을 실제 조회하고 JSON 계약 검사를 실행합니다.
순서·수정: 선행 작업 없음 · r1 · 이번 회차 대상
실제 결과: 로컬 기준 커밋 a5919c39d16d8835063c880352e26629737fbcfb와 전체 기획 검토를 확인하고 메뉴얼 계약 검사를 실행했습니다.
최근 QA: 기준 커밋 존재, 최초 검토 보고서 및 전체 12개 실행/QA 기준 보존, JSON 계약 검사 성공git rev-list --max-parents=0 HEAD; validateReport(manual, project registry) · 2026-10-30T09:35:20.375Z

T02PostgreSQL·PostGIS 설치와 공간 쿼리완료QA 통과

실행: 프로젝트 전용 바이너리·DB·앱 계정을 구성하고 PostGIS를 활성화합니다.
완료 기준: 실제 앱 접속·좌표 변환이 성공하며 앱 계정은 슈퍼유저가 아닙니다.
QA 절차: db-doctor.ts를 실행해 버전·ST_Transform·계정 권한을 확인합니다.
순서·수정: T01 · r1 · 이번 회차 대상
실제 결과: PostgreSQL 17.11·PostGIS 3.6.2에서 실제 ST_Transform과 일반 앱 계정 접속을 확인했습니다.
최근 QA: PostGIS 좌표 변환이 POINT를 반환하고 app_is_superuser=false입니다.node server/tools/db-doctor.ts; 로컬 증거 docs/qa/database-install.json (원문에는 로컬 경로가 있어 공개 첨부하지 않음) · 2026-10-30T09:35:20.551Z

T03생존·휴식·수색·NPC·월드 재고 규칙완료QA 통과

실행: 미정 수치를 provisional 설정으로 분리하고 활력·고갈 효과·거래·대사·월드별 물자를 구현합니다.
완료 기준: 수치 변화와 행동 제한, 무게·재고·거래·중립 제한이 서버에서 일관되게 판정됩니다.
QA 절차: 고정 시간·재현 가능한 난수로 정상/경계/실패·중복·월드 분리 테스트를 실행합니다.
순서·수정: T02 · r1 · 이번 회차 대상
실제 결과: 16개 실제 도메인 테스트 통과: 활력·휴식·고갈 효과·물자 재고·거래·중립 제한·부정 입력·캐시·복원을 확인했습니다.
최근 QA: 전체 27개 테스트 실행에 현재 생존·수색·NPC 도메인 16개가 포함되어 모두 통과했습니다.server/test/game.test.ts 및 동일 전체 회귀 실행 결과 · 2026-10-30T09:50:59.352Z

T04트랜잭션 저장·중복 방지·복원완료QA 통과

실행: PostGIS 저장소를 서버에 연결하고 기존 JSON 상태를 보존·이관합니다.
완료 기준: 아이템·재고·영수증이 함께 커밋/롤백되며 재시작과 재시도에도 보존됩니다.
QA 절차: 실제 DB에서 실패 유도·동일 ID 재전송·서버 재시작·공간 거리·동시 요청을 검증합니다.
순서·수정: T03 · r1 · 이번 회차 대상
실제 결과: 실제 DB 강제 실패 롤백·중복 8개 동시 요청·300개 후 재시도·프로세스 재시작·기존 JSON 보존 이관이 통과했습니다. 개발 서버 health도 postgres-postgis입니다.
최근 QA: TypeScript 검사 성공, 현재 전체 27개 테스트 통과. 실제 PostgreSQL WebSocket 프로세스 재시작과 JSON 백업 동일성·원문 토큰 제외를 확인했습니다. 초기 TypeScript 검사에서 미사용 자체 WebSocket 파일의 TS2345가 있었고 표준 ws 교체 후 해당 파일 제거·재검사를 수행했습니다.node --test server/test/*.test.ts; pnpm -C server exec tsc --noEmit; docs/qa/postgres-transactions.json; docs/qa/database-runtime.json · 2026-10-30T09:50:58.646Z

T05수원 원본 지리 데이터와 안전한 시작점진행QA 미실행

실행: 라이선스를 확인한 실제 수원 경계·도로·건물을 확보하고 출처를 기록합니다.
완료 기준: 가상 격자가 아닌 원본 좌표가 사용되고 시작점이 범위·건물·중립/위험 조건을 통과합니다.
QA 절차: 원본 OSM 식별자·좌표와 결과를 대조하고 폴리곤·충돌·스폰 테스트를 실행합니다.
순서·수정: T04 · r1 · 이번 회차 대상

T06Unity 실제 공간과 생존 플레이 흐름대기QA 미실행

실행: 지리 형상·건물·수색 장소·캠프를 표시하고 생존·상점·치료·휴식·채팅 UI를 연결합니다.
완료 기준: 탐색→수색→소비/회복→캠프 거래/치료가 실제 TPS에서 동작합니다.
QA 절차: Windows 빌드 후 실제 서버 연동 플레이·조작·모션·HUD를 실행 검증하고 실제 화면을 캡처합니다.
순서·수정: T05 · r1 · 전체 목록 보존

T07멀티 월드·접속 관리·관심 영역대기QA 미실행

실행: 월드별 100명 상한과 NPC/아이템 상태 분리, 재접속·주변 채팅·근처 플레이어 동기화를 완성합니다.
완료 기준: 월드 간 상태가 섞이지 않고 연결 교체·이탈·복원·관심 영역이 정확합니다.
QA 절차: 서로 다른 세션·두 월드에서 실제 클라이언트와 네트워크 통합 QA를 수행합니다.
순서·수정: T06 · r1 · 전체 목록 보존

T08Unity Web 모듈과 브라우저 통신대기QA 미실행

실행: 동일 Unity 버전의 Web 빌드 환경과 WebSocket JS 연결 계층을 설치·구현합니다.
완료 기준: 실제 Web 빌드가 생성되고 네트워크·저장·맵 경로가 브라우저 제약에 맞습니다.
QA 절차: Web 빌드·자바스크립트 메시지·세션 복원 테스트를 실행합니다.
순서·수정: T07 · r1 · 전체 목록 보존

T09실제 브라우저 플레이와 상호 운용대기QA 미실행

실행: 로컬 HTTP 환경에서 Web 클라이언트를 실행하고 Windows 클라이언트와 같은 월드에 접속합니다.
완료 기준: 브라우저 이동·수색·채팅·접속 복원과 서로의 상태가 실제 화면에서 확인됩니다.
QA 절차: 실제 브라우저 렌더·입력·연결 복구·동시 Windows 접속을 검증합니다.
순서·수정: T08 · r1 · 전체 목록 보존

T10100명 부하와 장애 회귀 검증대기QA 미실행

실행: 월드별 부하와 지연/연결 종료/재시작 시나리오를 실행하고 발견 문제를 수정합니다.
완료 기준: 100명 동시 입력·상태 갱신이 검증되고 지연·오류·복원 결과가 측정됩니다.
QA 절차: 100개 실제 WebSocket 클라이언트로 위치·채팅·거래·월드 격리·재접속을 검사하고 재QA합니다.
순서·수정: T09 · r1 · 전체 목록 보존

T11재현 가능한 실행 도구와 문서대기QA 미실행

실행: 로컬 설치·기동·중지·복원·빌드 도구와 README 구현 현황을 최종 결과에 맞춥니다.
완료 기준: 다음 실행에서 소스와 설명을 따라 Windows/브라우저/DB를 기동할 수 있습니다.
QA 절차: 문서의 명령을 실제 실행하고 라이선스·설정·비밀정보 제외·결과 화면을 확인합니다.
순서·수정: T10 · r1 · 전체 목록 보존

T12전체 최종 QA와 아카이브 배포대기QA 미실행

실행: 전체 현재 revision을 함께 회귀 QA하고 실제 화면·시간·남은 제한을 보고합니다.
완료 기준: 모든 현재 작업 QA와 전체 final QA가 통과하고 보고서 외부 URL도 확인됩니다.
QA 절차: 전체 자동 검사·Windows/브라우저 실행·DB 복원·100명 결과를 재검증하고 Pages 배포 및 링크를 확인합니다.
순서·수정: T11 · r1 · 전체 목록 보존

QA 반복 기록

실패 → 수정 → 해당 QA → 영향 범위 회귀 → 전체 최종 QA 순서로 확인합니다. 과거 실패를 삭제하지 않습니다.

Q01 · 작업 QA2026-10-30T09:35:20.375Z1/1 통과

기준점과 메뉴얼 전체 범위 검사

T01 · pass

기준 커밋 존재, 최초 검토 보고서 및 전체 12개 실행/QA 기준 보존, JSON 계약 검사 성공

git rev-list --max-parents=0 HEAD; validateReport(manual, project registry)

Q02 · 작업 QA2026-10-30T09:35:20.551Z1/1 통과

실제 DB 설치·공간 연산·권한 검사

T02 · pass

PostGIS 좌표 변환이 POINT를 반환하고 app_is_superuser=false입니다.

node server/tools/db-doctor.ts; 로컬 증거 docs/qa/database-install.json (원문에는 로컬 경로가 있어 공개 첨부하지 않음)

Q03 · 작업 QA2026-10-30T09:40:35.721Z1/1 통과

현재 생존·수색·NPC 도메인 QA

T03 · pass

node --test server/test/game.test.ts: 16개 통과, 실패 0. 서버/DB 통합 QA를 이 결과에 포함하지 않습니다.

현재 server/test/game.test.ts 실제 실행 결과와 server/src/game.ts 및 config/content 파일 대조

Q04 · 작업 QA2026-10-30T09:50:58.646Z1/1 통과

실제 DB 저장·오류·재시도·이관 QA

T04 · pass

TypeScript 검사 성공, 현재 전체 27개 테스트 통과. 실제 PostgreSQL WebSocket 프로세스 재시작과 JSON 백업 동일성·원문 토큰 제외를 확인했습니다. 초기 TypeScript 검사에서 미사용 자체 WebSocket 파일의 TS2345가 있었고 표준 ws 교체 후 해당 파일 제거·재검사를 수행했습니다.

node --test server/test/*.test.ts; pnpm -C server exec tsc --noEmit; docs/qa/postgres-transactions.json; docs/qa/database-runtime.json

Q05 · 회귀 QA2026-10-30T09:50:59.352Z1/1 통과

DB 연결 이후 생존·거래 회귀 QA

T03 · pass

전체 27개 테스트 실행에 현재 생존·수색·NPC 도메인 16개가 포함되어 모두 통과했습니다.

server/test/game.test.ts 및 동일 전체 회귀 실행 결과

남은 작업과 다음 반복

T05 실제 수원 지리 데이터 확보·검증을 진행합니다. T06~T12와 전체 final QA는 미완료입니다.

변경 이유: 작업 시작 18:17:30 KST 이후 추가된 실행 메뉴얼 지침을 현재 작업에 반영했습니다. 기존 전체 완료 기준은 유지하고 실행·QA 단위를 12개로 구체화했습니다.

다음 작업: T05 · 수원 원본 지리 데이터와 안전한 시작점

남은 작업으로 소수 후속 회차 만들기

다른 버전·회차 17개

4회차 · v1.0.17 · 2026-10-30T12:33:03.664Z · 완료 4회차 · v1.0.16 · 2026-10-30T12:11:50.966Z · 작업 중 4회차 · v1.0.15 · 2026-10-30T12:08:09.392Z · 작업 중 4회차 · v1.0.14 · 2026-10-30T11:46:12.157Z · 작업 중 3회차 · v1.0.13 · 2026-10-30T11:32:09.727Z · 작업 중 3회차 · v1.0.12 · 2026-10-30T11:20:19.514Z · 작업 중 3회차 · v1.0.11 · 2026-10-30T11:11:12.680Z · 작업 중 3회차 · v1.0.10 · 2026-10-30T11:00:32.294Z · 작업 중 3회차 · v1.0.9 · 2026-10-30T10:51:03.294Z · 작업 중 3회차 · v1.0.8 · 2026-10-30T10:40:07.297Z · 작업 중 3회차 · v1.0.7 · 2026-10-30T10:32:00.416Z · 작업 중 2회차 · v1.0.6 · 2026-10-30T10:28:51.217Z · 작업 중 2회차 · v1.0.5 · 2026-10-30T10:16:33.490Z · 작업 중 2회차 · v1.0.4 · 2026-10-30T10:14:50.645Z · 작업 중 2회차 · v1.0.3 · 2026-10-30T10:13:11.500Z · 작업 중 2회차 · v1.0.2 · 2026-10-30T09:52:38.348Z · 작업 중 1회차 · v1.0.0 · 2026-10-30T09:35:20.637Z · 작업 중

작업 시간

제안 시간: 전체 잔여 범위 4~10시간, 최초 DB·생존 실행 단계 30~60분 예상으로 18:17에 안내했습니다.
실제로 완료된 시간: 전체 작업 시작 2026-10-30 18:17:30 KST(Asia/Seoul). 진행 중이며 완료 시각이 아닙니다.
XERJ: 미사용 — XERJ MCP/검색 스크립트가 제공되지 않아 rg와 현재 코드·설정·실행 결과를 대조합니다.