feat: stabilize dev sync and add history tables

docs/DEVELOPMENT_HISTORY.md

@@ -214,6 +214,16 @@
 - 특정 날짜의 자리배치도 재구성 가능
 - 기간 비교나 변경 추적 UI로 확장 가능
 
+### 현재 반영 상태
+
+- `history_revisions`
+- `member_versions`
+- `seat_assignment_versions`
+- `entity_change_events`
+
+초기 단계로 테이블과 baseline backfill 경로를 먼저 추가했다.
+아직 조직도/자리배치도 쓰기 API가 매 수정마다 version row 를 append 하도록 완전히 전환된 상태는 아니다.
+
 ### 설계 문서
 
 - [HISTORY_ASOF_DB_PLAN.md](/home/hyunho/projects/mh-dashboard-organization/docs/HISTORY_ASOF_DB_PLAN.md)

docs/DEV_PROD_DB_PROTOCOL.md

@@ -11,14 +11,20 @@
 ### 코드 경로
 
 - 공개용 `8080`: `/home/hyunho/projects/mh-dashboard-organization`
-- 작업용 `8081`: `/tmp/mh-dashboard-organization-dev`
+- 작업용 `8081`: `/home/hyunho/projects/mh-dashboard-organization`
+
+### 작업용 Compose 기준
+
+- 공개용 `8080` stack: `docker-compose.yml`
+- 작업용 `8081` stack: `docker-compose.8081.yml`
+- 작업용 project name 기본값: `mh-dashboard-organization-dev`
 
 ### DB 볼륨
 
 - 공개용 `8080`: `mh-dashboard-organization_postgres_data`
 - 작업용 `8081`: `mh-dashboard-organization-dev_postgres_data`
 
-즉 현재는 코드도 분리, DB도 분리 상태다.
+즉 현재는 코드 workspace는 같아도 compose project 와 DB volume 이 분리된 상태다.
 
 ## 정본 기준
 
@@ -161,11 +167,12 @@
 반복 가능한 동기화 스크립트:
 
 - [sync_prod_db_to_dev.sh](/home/hyunho/projects/mh-dashboard-organization/scripts/sync_prod_db_to_dev.sh)
+- [docker-compose.8081.yml](/home/hyunho/projects/mh-dashboard-organization/docker-compose.8081.yml)
 
 사용 방법:
 
 ```bash
-chmod +x scripts/sync_prod_db_to_dev.sh
+docker compose -p mh-dashboard-organization-dev --env-file .env -f docker-compose.8081.yml up -d
 ./scripts/sync_prod_db_to_dev.sh minimal
 ./scripts/sync_prod_db_to_dev.sh full
 ```
@@ -179,6 +186,11 @@ chmod +x scripts/sync_prod_db_to_dev.sh
 
 주의:
 
+- 스크립트는 동기화 전에 `8081`의 `proxy`, `frontend`, `backend` 를 잠시 멈춘다
+- 이유는 중간 상태를 읽는 API 요청과 DB truncate/restore 가 충돌하면 deadlock 또는 부분 검증이 발생할 수 있기 때문이다
 - 스크립트는 `8080` DB 데이터를 덤프해서 `8081` DB의 대상 테이블을 비우고 다시 적재한다
 - `8081`에서만 존재하던 대상 테이블 데이터는 사라진다
+- `seat_positions` 는 portable CSV 경로로 별도 복원한다
+- 복원 후 `members.seat_label`, `auth.users`, history backfill 을 다시 맞춘다
+- 실행 후 주요 테이블 수량과 seat 정합성 수치를 출력한다
 - 따라서 실행 전 현재 작업용 DB 상태를 유지해야 하면 별도 백업 후 실행한다

docs/REGRESSION_CHECKLIST.md

@@ -25,6 +25,7 @@
 - `8081` 작업용 접속 확인
 - `8080` 공개용 접속 확인
 - `docker compose ps`에서 `backend`, `frontend`, `proxy`, `db`가 정상인지 확인
+- `8081`은 기본적으로 `docker compose -p mh-dashboard-organization-dev --env-file .env -f docker-compose.8081.yml up -d` 로 기동
 
 ### 2. 데이터 동기화 범위 결정