Shared main libraries and hub-mediated sync for large media files. https://mediasink.valleygeek.net/
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Grok 25b1493a97 docs: scaffold Media Sink product and runtime documents
Adds the authority chain for a new FastAPI site-app on Guildhall:
DESIGN (product), TECHNICAL (schema, HTTP, blobs, scripts), LAYOUT,
USER_GUIDE, VERSIONING (pre-beta), and PROMOTION (dev/main Coolify).

Application modules and operator scripts are omitted; LAYOUT names
their placement. Closed registration, username login, hub-mediated
byte flow, and script variants are recorded as product rules rather
than left to the generic site-app shell.
2026-09-17 19:57:58 -07:00
docs docs: scaffold Media Sink product and runtime documents 2026-09-17 19:57:58 -07:00
.gitignore docs: scaffold Media Sink product and runtime documents 2026-09-17 19:57:58 -07:00
AGENTS.md docs: scaffold Media Sink product and runtime documents 2026-09-17 19:57:58 -07:00
CHANGELOG.md docs: scaffold Media Sink product and runtime documents 2026-09-17 19:57:58 -07:00
LICENSE docs: scaffold Media Sink product and runtime documents 2026-09-17 19:57:58 -07:00
README.md docs: scaffold Media Sink product and runtime documents 2026-09-17 19:57:58 -07:00
VERSION docs: scaffold Media Sink product and runtime documents 2026-09-17 19:57:58 -07:00

Media Sink

Shared main libraries and hub-mediated sync for large media files. Accounts scan local libraries, curators approve what appears on the main library, and bytes move only through a designated hub.

Forge: ai-collab/media-sink. Production: mediasink.valleygeek.net.

This repository holds the product and runtime documents. Application modules, images, and operator scripts are absent; known state is in AGENTS.md.

Documentation

File Role
docs/DESIGN.md Product rules
docs/TECHNICAL.md Schema, HTTP, blobs, script protocol
docs/LAYOUT.md Package tree and module roles
docs/USER_GUIDE.md Account help (also /help once the app exists)
docs/VERSIONING.md Version policy
docs/PROMOTION.md Preview/prod hosts and cadence

The application shell (sessions, mail, admin chrome, Docker, HTTP hardening) is specified in ai-collab/project-templates as fastapi-site-app. Working reference: ai-collab/spin-the-activity. Domain rules in docs/DESIGN.md outrank the shell.

Versioning is pre-beta. Canonical file: VERSION. Display form may add a v prefix; the file does not.

Stack

Python 3.12, FastAPI, Jinja2, PostgreSQL, vanilla JavaScript. Published instances run on Guildhall (Coolify) with a dedicated Postgres container and a NAS blob volume.

License

MIT. See LICENSE.