サークル写真管理の分散・重複問題をSHA256ハッシュで解決 - drive-gallery開発事例

Luke Avenue Drive Gallery
├── フロントエンド (React 19 + TypeScript)
│   ├── イベント別フォルダ表示
│   ├── ドラッグ&ドロップアップロード
│   └── リアルタイム更新表示
├── バックエンド (Go + Firebase Admin SDK)
│   ├── ファイルアップロード処理
│   ├── SHA256ハッシュベース重複排除
│   └── WebSocketによるリアルタイム通信
└── ストレージ (Firebase Storage + Firestore)
    ├── メディアファイル保存
    └── メタデータ管理

type FileMetadata struct {
    ID          string `json:"id"`
    Name        string `json:"name"`
    MimeType    string `json:"mimeType"`
    StoragePath string `json:"storagePath"`
    DownloadURL string `json:"downloadURL"`
    FolderID    string `json:"folderId"`
    Hash        string `json:"hash"`
}

type FolderMetadata struct {
    ID   string `json:"id"`
    Name string `json:"name"`
}

func CalculateFileHash(fileContent []byte) string {
    hash := sha256.Sum256(fileContent)
    return hex.EncodeToString(hash[:])
}

func UploadFileToStorageAndFirestore(fileContent []byte, fileName, mimeType, folderID string) error {
    hash := CalculateFileHash(fileContent)
    
    // 既存ファイルのハッシュ値をチェック
    existingFiles := checkExistingHash(hash)
    if len(existingFiles) > 0 {
        // 重複ファイルの場合、既存のダウンロードURLを返却
        return &existingFiles[0].DownloadURL, nil
    }
    
    // 新規ファイルのみFirebase Storageにアップロード
    return uploadToFirebaseStorage(fileContent, fileName, mimeType, hash)
}

// React コンポーネントでのファイルアップロード
const handleFileUpload = async (files: FileList) => {
  const formData = new FormData();
  for (const file of files) {
    formData.append('files', file);
  }
  
  await uploadFiles(folderID, formData);
  // WebSocketで自動更新
};

// 大量ファイルの一括アップロード
func main() {
    targetFolder := flag.String("target", ".", "Target folder path")
    folderName := flag.String("folder", "", "Folder name for upload")
    
    filepath.Walk(*targetFolder, func(path string, info os.FileInfo, err error) error {
        if isImageOrVideo(path) {
            uploadFileToAPI(path, *folderName)
        }
        return nil
    })
}

// WebSocket実装による即座のUI更新
func handleWebSocket(w http.ResponseWriter, r *http.Request) {
    conn, err := upgrader.Upgrade(w, r, nil)
    if err != nil {
        return
    }
    defer conn.Close()
    
    // ファイルアップロード完了時に全接続クライアントに通知
    for {
        select {
        case update := <-updateChannel:
            conn.WriteJSON(update)
        }
    }
}

// 将来的な実装構想
type AdvancedDuplicateDetector struct {
    SHA256Hash      string  // 完全一致用
    PerceptualHash  string  // 類似画像検出用
    SimilarityScore float64 // 類似度閾値
}