[feature] 마스터 링크 동기화 및 사용자 폴더 복사 스크립트 추가

[vcz-Chan]

개요

마스터 계정에서 분석을 마친 링크를 다시 AI 처리하지 않고 대상 사용자 계정으로 복사하기 위한 관리자용 스크립트를 추가했습니다.

실제 UT 링크 목록이나 사용자별 데이터는 이 PR에 포함하지 않습니다.

주요 변경

• db:distribute:master-folder
  • 같은 DB 환경에서 마스터의 폴더 하나를 지정한 사용자 한 명에게 복사
  • 대상에 동명 폴더가 있으면 재사용하고, 없으면 생성
  • URL·메타데이터·AI 요약·임베딩·태그 복사
  • 메모·즐겨찾기·조회 시각·리마인더 등 사용자별 상태는 초기값 사용
• db:sync:master-links
  • 개발 DB 마스터의 활성 폴더와 미분류 링크를 운영 DB 마스터로 복사
  • 운영 마스터는 개발 마스터와 같은 이메일로 식별
• 스크립트 공통 복사 로직과 타입 검사 설정 추가
• 실행 방법, 데이터 처리 정책, 실패 처리 절차 문서화

처리 흐름

마스터 계정에서 링크 분석·임베딩 완료
→ 복사 명령 dry-run으로 대상과 건수 확인
→ 운영 반영 옵션을 지정해 실행
→ 같은 명령을 다시 dry-run하여 신규 링크 0개 확인

안전장치

• 기본 실행은 DB를 수정하지 않는 dry-run
• 실제 반영에는 --apply 필요
• 운영 반영에는 --apply --force-production 모두 필요
• 원본에 요약 또는 임베딩 미완료 링크가 있으면 변경 전 중단
• 폴더·링크·태그 삽입을 하나의 트랜잭션으로 처리
• 대상 사용자의 기존 활성 URL은 덮어쓰거나 이동하지 않고 건너뜀
• 같은 사용자에 대한 동시 실행은 사용자 row lock으로 직렬화

검증

• bun run lint
• bun run typecheck:scripts
• bun run build
• 전체 테스트 143개 통과

영향 범위 및 제한

• DB schema 및 migration 변경 없음
• 기존 HTTP API 계약 변경 없음
• 애플리케이션 API가 아닌 관리자용 DB 스크립트
• 사용자 복사는 명령 한 번에 한 명을 대상으로 실행
• 복사 이력을 저장하거나 자동으로 되돌리는 기능은 제공하지 않음

상세 사용법은 docs/database/master-link-distribution.md에 정리했습니다.

[ninaxlee]

스크립트라 문서만 보고 approve 합니당~

[vcz-Chan]

2차 유티 완료로 close할게요~