Box

目標:做一個本機優先的自用雲端檔案庫，支援跨裝置存取、版本紀錄、分享連結與完整匯出。 技術棧建議:Python FastAPI + SQLite + 本機檔案系統，前端使用 React，透過 Docker Compose 啟動；可選 S3 相容儲存作為備份目的地。 需求: - 建立資料夾與子資料夾，支援檔案上傳、下載、重新命名、移動與刪除 - 使用檔案雜湊判斷重複內容，顯示檔案大小、類型、修改時間與雜湊值 - 管理頁提供檔案清單、縮圖預覽、排序、篩選與全文檔名搜尋 - 支援拖放上傳、多檔上傳、上傳進度與中斷後續傳 - 每次修改或覆寫檔案時建立版本，能預覽、下載與還原指定版本 - 產生可設定到期時間與下載次數的唯讀分享連結 - 分享連結可選擇是否需要密碼，並記錄建立時間、到期時間與下載次數 - 提供簡易同步用 API，讓另一個指定資料夾能手動或定時同步 - 偵測同步衝突並保留兩份檔案，不得靜默覆寫較新的內容 - 允許以單一管理密碼保護後台與 API，密碼從環境變數讀取 - 可匯出檔案 metadata、資料夾結構與版本清單為 JSON 和 CSV - 提供完整資料打包匯出，包含原始檔案、metadata 與版本內容 明確不做(out of scope):多人即時文件編輯、企業單一登入、細緻的團隊權限、全球 CDN、手機 App、Office 線上預覽與商用等級高可用架構。 README 要求:說明本機部署、Docker Compose 啟動方式、環境變數、分享連結安全限制、同步衝突處理、備份策略與完整匯出搬移步驟。