생성일: 2026-02-23

이 문서는 TakeoutPhotoSanitizer 실행 후 _Uncertain 폴더에 분류된 파일을 SHA-256 원본을 변경하지 않고 안전하게 재분류하는 절차를 설명한다.

핵심 원칙:

• 기존 SHA-256.txt는 절대 수정하지 않는다.
• 파일 바이트(이미지 내용)는 절대 수정하지 않는다.
• 재분류는 별도의 오버라이드(override) 기록 파일로 관리한다.
• 향후 앨범, 인물, 장소 등 확장 가능성을 고려한다.

다음과 같이 From_Google_Takeout과 같은 레벨로 _ops 및 하위 폴더를 생성한다.

(작업 디렉토리)
 └─ Photos_Backup/
    ├─ From_Google_Takeout/
    │   ├─ 2019/
    │   ├─ 2020/
    │   ├─ ...
    │   └─ SHA-256.txt   ← hash DB
    └─ _ops/
         ├─ reclass/
         └─ notes/

이 폴더 및 그 하위에는 운영 및 관리 파일만 저장한다.

PowerShell 명령:

$root = "Photos_Backup"
 
$unc = Join-Path $root "From_Google_Takeout\_Uncertain"
$out = Join-Path $root "_ops\reclass\uncertain_review.csv"
 
Get-ChildItem $unc -File -Recurse |
Select-Object FullName, Name, Length, LastWriteTime |
Export-Csv $out -NoTypeInformation -Encoding UTF8

생성 파일:

Photos_Backup/_ops/reclass/uncertain_review.csv

엑셀에서 uncertain_review.csv를 열고 다음 열을 추가한다.

• year_final (확정 연도, 예: 2014)
• note (판단 근거 메모)

확신이 있는 파일만 year_final을 채운다.

저장 파일:

Photos_Backup/_ops/reclass/uncertain_review_done.csv

PowerShell 스크립트:

# 작업 디렉토리(= Photos_Backup)에서 실행한다고 가정
 
$in  = "_ops\reclass\uncertain_review_done.csv"
$out = "_ops\reclass\year_override.tsv"
 
# 입력 파일 확인
if (!(Test-Path $in)) {
    throw "입력 파일이 없습니다: $in"
}
 
# 출력 폴더가 없으면 생성
$outDir = Split-Path -Parent $out
if (!(Test-Path $outDir)) { New-Item -ItemType Directory -Path $outDir | Out-Null }
 
Import-Csv $in |
ForEach-Object {
    # year_final 정리(공백 제거)
    $yy = ("" + $_.year_final).Trim()
 
    # 확정 연도(4자리)만 처리
    if ($yy -notmatch '^\d{4}$') { return }
 
    # FullName 확인
    $src = $_.FullName
    if ([string]::IsNullOrWhiteSpace($src)) { return }
    if (!(Test-Path -LiteralPath $src)) { return }
 
    # note 정리 (TSV 깨짐 방지: 탭/개행 제거)
    $note = ("" + $_.note)
    $note = $note -replace "`t", " "
    $note = $note -replace "(\r\n|\n|\r)", " "
    $note = $note.Trim()
 
    # sha256 계산
    $h = (Get-FileHash -LiteralPath $src -Algorithm SHA256).Hash
 
    # TSV 한 줄 출력
    "{0}`t{1}`t{2}`t{3}" -f $h, $yy, (Get-Date -Format "yyyy-MM-dd"), $note
} | Set-Content -LiteralPath $out -Encoding UTF8

파일 형식:

sha256<TAB>year_final<TAB>date<TAB>note

이 파일은 “수동 재분류 패치 기록”이다.

파일을 해당 연도 폴더로 이동한다.

# Photos_Backup 폴더에서 실행한다고 가정
$in  = "_ops\reclass\uncertain_review_done.csv"
$rootMedia = "From_Google_Takeout"
$log = "_ops\reclass\move_log.tsv"
 
# 로그 폴더가 없으면 생성
$logDir = Split-Path -Parent $log
if (!(Test-Path $logDir)) { New-Item -ItemType Directory -Path $logDir | Out-Null }
 
Import-Csv $in | Where-Object { $_.year_final -match '^\d{4}$' } |
ForEach-Object {
 
    $src = $_.FullName
    $yy  = $_.year_final
 
    # 목적 연도 폴더 (없으면 생성)
    $dstDir = Join-Path $rootMedia $yy
    if (!(Test-Path $dstDir)) { New-Item -ItemType Directory -Path $dstDir | Out-Null }
 
    # 동일 파일명 충돌 시 sha256 prefix를 붙여 회피
    $dst = Join-Path $dstDir $_.Name
    if (Test-Path $dst) {
        $h8 = (Get-FileHash $src -Algorithm SHA256).Hash.Substring(0,8)
        $dst = Join-Path $dstDir ("{0}_{1}" -f $h8, $_.Name)
    }
 
    Move-Item -LiteralPath $src -Destination $dst
 
    "{0}`t{1}`t{2}`t{3}" -f (Get-Date -Format "yyyy-MM-dd HH:mm:ss"), $src, $dst, "moved" |
      Add-Content $log -Encoding UTF8
}

이 과정은 파일 바이트를 변경하지 않으므로 SHA-256은 유지된다.

생성 가능 파일:

Photos_Backup/_ops/notes/annotations.tsv

형식:

sha256<TAB>key<TAB>value<TAB>date

예:

AAA...    place    Jeju Seongsan    2026-02-23
AAA...    people   Mom;Dad          2026-02-23

이 구조는 향후 앨범, 인물, 장소, 키워드 확장에 사용된다.

1. _Uncertain 검토
2. year_final 입력
3. year_override.tsv 생성
4. 파일 이동
5. _Uncertain 감소 확인
6. 반복

• 파일은 불변 객체이다.
• SHA-256은 영구 식별자이다.
• 재분류는 메타데이터이다.
• 앨범 및 주석은 관계 레이어이다.

문서 끝