drosync POC source contract
drosync is the supported one-way synchronization path from customer-owned local directories to Baidu Object Storage (BOS). It is not a mounted filesystem: v1 does not download, propagate remote deletion, merge file contents, preserve POSIX ownership/mode, follow symlinks, or create empty remote directories.
Frozen scope
- Control plane: existing Go API plus the
drosync-coordinatorasynchronous worker. - Client: Rust CLI, daemon, read-only Web report viewer, updater, and SQLite crash journal.
- UI:
/object-syncwith role-specific administration, operations, release, and audit surfaces. - Targets: Windows 10/11 x86_64, Ubuntu 22.04/24.04 x86_64/ARM64, and macOS 13+ arm64.
- Limits per session: 1,000,000 files, 1 TiB per object, 20 TiB total; 500 devices per organization and at most 16 client data requests per device.
- Retention: session/item 90 days, versions/audit 1 year, heads indefinitely, staging/multipart 24 hours, conflicts indefinitely.
Document map
- 中文用户使用手册
- Product requirements
- Architecture and state machines
- OpenAPI 3.1 contract
- Installation
- CLI reference
- Permissions and security
- Conflict runbook
- Audit dictionary
- Operations and SLO
- Disaster recovery
- Updates and rollback
- Test and acceptance matrix
- Decisions and external prerequisites
Safety invariant
A space starts blocked/unverified. A successful If-None-Match: * probe permits create-only operation. Original-key update is available only after conditional update and conditional multipart completion probes pass and an administrator explicitly confirms that the shared prefix has no platform-external writer. Any observed drift disables the space. The UI cannot bypass these gates.
当前入口约束:功能入口唯一性。CLI 是唯一操作入口;Web 只读;GUI 和旧命令别名退出支持。历史验收报告保留原始记录,不作为当前命令手册。