ddidderr
8d81b436e5
The previous page showed a static "Server online" pill even though it did not track backend liveness. It also left the selected file in an uploadable state after completion, which made it too easy to start the same file again and then land in a saved record that could only fail with "complete file already exists". Remove the misleading server-status UI and make saved uploads describe their next action. Records with every chunk uploaded now show a Finish action, stale server records are cleared, and a terminal "complete file already exists" response clears the saved browser progress instead of inviting another resume. A successful completion also clears the active file selection so the primary actions settle back to idle. Test Plan: - just check Refs: none
upl
upl is a small personal resumable upload service. The intended deployment is:
browser -> nginx -> upl Rust server -> local filesystem
The first implementation milestone provides the Rust server shell and static
browser UI. Upload metadata, chunk persistence, resume state, and completion
assembly are tracked in PLAN.md and will be added in later coherent slices.
Project Structure
upl
Rust server
src/main.rs binary entrypoint and listener setup
src/app.rs Axum router, shared state, static file service
src/api.rs HTTP handlers and API error responses
src/model.rs JSON request, response, and metadata shapes
src/storage.rs local filesystem layout, chunks, and assembly
src/lib.rs library surface used by integration tests
Browser UI
static/index.html upload tool markup
static/styles.css responsive tool styling
static/app.js upload scheduler, retries, and browser resume state
Deployment
deploy/nginx/ nginx reverse proxy example
scripts/ reusable local smoke tests
Validation
tests/ integration tests for server behavior
TESTS.md reusable manual and automated test checklist
Configuration
UPL_BINDsets the listen address. It defaults to127.0.0.1:3000.UPL_STATIC_DIRsets the static asset directory. It defaults tostatic/inside this repository.UPL_DATA_DIRsets the upload data directory. It defaults todata/inside this repository.- The server accepts request bodies up to 64 MiB, which leaves room for the
planned 16 MiB upload chunks and matches the nginx example in
PLAN.md.
Common Commands
Use the justfile for routine tasks:
just check
just run
just check also syntax-checks the static browser JavaScript with node.
nginx
Run upl on localhost and put nginx in front of it for TLS and access control:
UPL_BIND=127.0.0.1:3000 UPL_DATA_DIR=/srv/upl/data upl
Use deploy/nginx/upl.conf.example as the starting point for the nginx site.
Before exposing the service, replace the certificate paths and add a protection
layer such as HTTP basic auth, an IP allowlist, or VPN-only access.
For a local Docker-based reverse-proxy smoke test:
just nginx-smoke
The smoke test binds the Rust server to 0.0.0.0 so the nginx container can
reach it through Docker's host gateway. The production nginx example keeps the
server bound to localhost.