B_미디어자료정리 — 01. 프로젝트 계획서

01. 프로젝트 계획서

총 5단계로 구성. 각 단계는 아빠 검토 승인 후 다음 단계로 진행. 중간 보고 의무: 장시간 작업 시 30분 간격 상태 보고.

🗺️ 전체 단계도

┌─────────────────────────────────────────────────────────────┐
│                    B_미디어자료정리 5단계 계획                 │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  [1단계] ──→ [2단계] ──→ [3단계] ──→ [4단계] ──→ [5단계]    │
│  준비기   →  설치기   →  이전기   →  검증기   →  정리기      │
│   (1d)      (1d)       (2d)       (1d)       (0.5d)         │
│                                                              │
│     ↑         ↑         ↑         ↑         ↑              │
│   아빠      아빠      아빠      아빠      아빠              │
│   검토      검토      검토      검토      검토              │
│                                                              │
└─────────────────────────────────────────────────────────────┘

📌 1단계 — 준비기 (예상: 1일)

목적

PhotoView 설치 전 환경 점검 및 필요 자원 확보

작업 목록

#	작업	담당	산출물
1-1	맥미니 Docker 설치 확인	루키	Docker 버전 확인
1-2	맥미니 디스크 용량 확인 (사진 90,577장 ≈ 용량 확인 필요)	루키	df -h 결과
1-3	맥미니 → NAS SMB 마운트 테스트	하늘	마운트 경로 확인
1-4	Tailscale 상태 확인 (맥미니 tailnet 연결)	루키	tailscale status
1-5	PhotoView docker-compose.yml 맥미니용 커스터마이징	하늘	`docker-compose.yml`
1-6	`.env` 파일 작성 (환경변수 설정)	하늘	`.env`

검토 체크리스트 (아빠 확인)

맥미니 사양/용량 충분?
NAS 마운트 경로 확정?
포트 충돌 없음? (8000번 사용 예정)
1단계 → 2단계 진행 승인

📌 2단계 — 설치기 (예상: 1일)

목적

PhotoView Docker 컨테이너 기동 및 초기 설정

작업 목록

#	작업	담당	산출물
2-1	docker-compose.yml + .env 맥미니에 배포	하늘	파일 전송 완료
2-2	`docker compose up -d` 실행	루키	컨테이너 기동
2-3	초기 설정 페이지 완료 (관리자 계정, 사진 경로)	루키	admin 계정 생성
2-4	NAS 사진 폴더를 PhotoView에 “사진 라이브러리”로 등록	루키	라이브러리 경로 설정
2-5	첫 인덱싱 실행 (90,577장 스캔)	PhotoView 자동	썸네일 생성 진행
2-6	30분 간격 진행률 보고 설정	하늘	보고 메시지

⚠️ 주의사항

인덱싱 시간: 90,577장 기준, 썸네일 생성 포함 → 4~8시간 예상
NAS 부하: SMB 마운트 통해 NAS 읽기 → 네트워크 트래픽 발생
맥미니 부하: Docker + 썸네일 생성 → CPU/메모리 사용

검토 체크리스트 (아빠 확인)

PhotoView 웹 UI 정상 접속?
사진 미리보기 잘 보임?
인덱싱 진행률 확인?
2단계 → 3단계 진행 승인

📌 3단계 — 이전기 (예상: 2일)

목적

기존 PhotoVault 데이터 중 유용한 메타데이터만 선택적 이전

검토 필요사항 (아빠 결정)

#	이전 대상	PhotoVault 보유	PhotoView 지원	우선순위
3-1	SHA-256 해시값	✅ 전체 계산 완료	❌ PhotoView 자동 계산	낮음 (중복 제목적이었다면)
3-2	촬영일자 (EXIF)	❌ 추출 못함	✅ PhotoView 자동 추출	낮음
3-3	GPS 좌표	❌ 추출 못함	✅ PhotoView 자동 추출	낮음
3-4	AI 카테고리 (사람/풍경 등)	⚠️ 249장만	✅ PhotoView Face/Place 자동	중간
3-5	즐겨찾기/별표	❌ 없음	✅ PhotoView 제공	없음

결론

PhotoView는 자동으로 EXIF/GPS/Face 인식 수행 → 대부분 메타데이터 이전 불필요
SHA-256 해시값은 이전 불가 (DB 스키마 다름) → 중복 제거는 PhotoView 내장 기능으로 대체
결정 필요: PhotoVault DB는 그대로 보관만 하고, PhotoView는 처음부터 재구축?

검토 체크리스트 (아빠 확인)

메타데이터 이전 필요한가? (아니면 PhotoView 자동 추출에 맡길까?)
PhotoVault DB는 그냥 백업 보관?
3단계 → 4단계 진행 승인

📌 4단계 — 검증기 (예상: 1일)

목적

PhotoView 정상 동작 확인 및 아빠 사용 테스트

작업 목록

#	작업	담당	확인 방법
4-1	전체 90,577장 인덱싱 완료 확인	하늘	PhotoView UI “총 사진 수”
4-2	Face 인식 (사람별 보기) 동작 확인	아빠	사람 탭 클릭
4-3	Place/지도 보기 동작 확인	아빠	지도 탭 클릭
4-4	타임라인 보기 동작 확인	아빠	타임라인 탭 클릭
4-5	검색 기능 테스트	아빠	키워드 검색
4-6	모바일 접속 테스트 (아빠 폰)	아빠	Tailscale 주소로 접속
4-7	업로드/공유 기능 테스트	아빠	사진 1장 업로드

검토 체크리스트 (아빠 확인)

원하는 기능 모두 동작?
속도/반응 만족?
모바일에서도 잘 보임?
4단계 → 5단계 진행 승인

📌 5단계 — 정리기 (예상: 0.5일)

목적

PhotoVault 레거시 정리 및 프로젝트 마무리

작업 목록

#	작업	담당	비고
5-1	PhotoVault 서버 완전 중지	하늘	보조PC uvicorn 종료
5-2	photos.db 백업 → `_자료/보류_photovault/` 복사	하늘	영구 보관
5-3	PhotoVault 소스코드 백업	하늘	GitHub 또는 NAS 백업
5-4	옵시디언 v0.3_진행중에 “완료” 기록	하늘	날짜/결과 기록
5-5	옵시디언 v0.1_구상 상태 → “완료”로 변경	하늘

⚠️ 주의사항

PhotoVault DB 백업 필수: 나중에 참고할 수 있음
소스코드도 보관: 13만 장 스캔 스크립트 등 재사용 가능

검토 체크리스트 (아빠 확인)

PhotoVault 완전 정리됨?
백업 확인?
프로젝트 완료 승인

📊 총 예상 일정

단계	예상 소요	누적
1단계 — 준비기	1일	1일
2단계 — 설치기	1일	2일
3단계 — 이전기	2일	4일
4단계 — 검증기	1일	5일
5단계 — 정리기	0.5일	5.5일

총 예상: 5~6일 (아빠 검토 시간 포함)

🔗 관련 문서

[[백업자료_이전예정/MiniCITY(v0.5_PARA_0502-)/20-29 Efforts/28_미디어자료정리/v0.1_구상/02_PhotoView설치메뉴얼]] — 상세 설치 절차
[[MiniCITY(A.R)/20-29 Efforts/28_미디어자료정리/v0.1_구상/03_데이터이전계획]] — 메타데이터 이전 상세
[[MiniCITY(A.R)/20-29 Efforts/28_미디어자료정리/v0.1_구상/04_운영관리메뉴얼]] — 일상 운영 절차

[!note] 수정이력 | 2026-05-03 18:35, 하늘 (hermes)

5단계 계획서 신규 작성

각 단계별 검토 체크리스트 포함

중간 보고 의무 명시

예상 소요 시간 산정