1.3 KiB
1.3 KiB
Quickstart: Archive Curator (Phase 1)
Purpose
Run the service in a safe, local-only configuration and confirm read-only browsing, untagged review, and audit visibility behaviors.
Prerequisites
- Local archive directories available (untagged, whitelisted, kept, trash)
- Download list file path available
- Nix installed and flake support enabled
Setup Steps
-
Configure required paths and safety flags:
- untagged root
- whitelisted root
- kept root
- trash/staging root
- download list file path
- audit log path
- state database path
- read-only mode
- hard delete enabled (default off)
-
Start the service via NixOS module or local run target.
-
Open the web UI on the configured bind address and port.
Smoke Checks
- Read-only mode blocks all mutations while allowing browsing.
- Untagged directory collage loads with directory name, size, file count, and samples.
- Resample changes the collage without leaving the directory.
- Preview/confirm flow is required before any destructive action.
- Audit view shows recent actions with paths and timestamps.
Safety Verification
- Whitelisted directories cannot be deleted by directory-level actions.
- Deletions are staged to trash by default.
- List-file edits are previewed, optional, and case-insensitive after trimming surrounding whitespace.