linearvoid/CHANGELOG.md

Change Log for linearvoid

Unreleased

Added

• Documentation for Admin UI Media Library (arc42 updates, refined TODO, media DB model decisions per ADR-006).
• Started implementation of full Media CRUD + video duration extraction using ffprobe (Media Library - Full CRUD section).
• Added /api/admin/media/{id} GET/PUT/DELETE handlers for media metadata retrieval, updates, and file+record deletion.
• Extended admin schedule and dashboard data endpoints with media duration totals, runtime strings, and media counts.
• Added admin UI runtime display for schedule/dashboard plus media library edit/delete actions.
• Added a dedicated plain TypeScript admin module for tab navigation, media CRUD actions, schedule/system analytics refresh, and moderation workflows without Alpine dependencies.
• Added resumable chunked admin media upload flow with upload-session endpoints and client progress indicators.

Changed

• Revised ADR-006 to reflect current implemented storage: PostgreSQL is the compose default and deployed primary backend, with SQLite retained as optional fallback.
• Updated chat runtime image to include ffmpeg/ffprobe for media duration probing on upload.
• Rebuilt viewer, admin, and admin-login pages around custom semantic class structures with accessibility-focused landmarks, tab semantics, and keyboard-focus behavior.
• Replaced legacy and Tailwind-based stylesheet rules with a custom design-token CSS system covering responsive layouts, forms, tables, and reduced-motion behavior.
• Code-split hls.js via lazy loading in the viewer bootstrap to shrink the main frontend bundle and isolate stream playback logic into a dedicated chunk.

Fixed

• Started Admin UI Media Library backend implementation by adding the Media GORM model and AutoMigrate integration in chat startup.
• Implemented media upload duration probing with ffprobe and persisted media metadata to the database alongside filesystem storage.
• Updated media listing to read from the media table and return duration metadata with HH:MM:SS runtime formatting.
• Removed Tailwind and Alpine runtime/build dependencies from the frontend package configuration and eliminated Tailwind directives/warnings during production build.
• Enforced 2GB upload ceiling plus server-side media file type/size validation for admin uploads.
• Increased nginx client_max_body_size to allow resumable admin upload chunks and prevent 413 Content Too Large responses.

[1.0.3] - 2026-08-03

Added

• Added Prometheus-format /metrics endpoint for chat runtime and admin-session monitoring.

Changed

• Updated Prometheus scrape targets and Grafana dashboard queries to use live chat metrics.

Fixed

• Fixed nginx routing so /metrics is reachable through localhost and linearvoid.tv.

[1.0.2] - 2026-08-03

Changed

• Updated local environment documentation and examples to prefer real-domain local routing through linearvoid.tv and compose-safe internal service hostnames.

Fixed

• Fixed admin production build output and nginx routing so /admin/ serves its own entrypoint.
• Fixed static asset serving so hashed JS/CSS files return correct MIME types and stale asset URLs return 404 instead of SPA HTML.
• Fixed chat database configuration so DATABASE_URL is honored for compose-safe Postgres or SQLite local development.

[1.0.1] - 2026-08-03

Changed

• Expanded the setup guide with current .env.example variables, development prerequisites, Cloudflare R2 setup, Gitea registry setup, and a production deployment guide.
• Aligned frontend, nginx, and deployment docs with the linearvoid.tv app domain and media.linearvoid.tv HLS domain model.

[1.0.0] - 2026-08-02

Added

Full backend and frontend implementation complete.

• Playout Service (backend/playout/): Go-based playlist management, ffprobe normalization validation, continuous HLS with immutable segment naming, automatic R2 sync, health check endpoint, and Docker integration (ADR-001, ADR-003).
• Chat Backend (backend/chat/): Go + Gorilla WebSocket, Redis for presence/rate limiting/pub/sub, SQLite persistence for message history and ModerationLog (ADR-006/ADR-007), public rooms, private DM routing, moderation commands with immutable audit logging, health check endpoint, and docker-compose integration.
• Frontend (frontend/): Vite + TypeScript + Tailwind + Alpine.js, HLS player with hls.js, chat sidebar with room switching and private messaging, "Now Playing" overlay, and modern UI (ADR-002, ADR-003).
• Complete docker-compose.yml for local development with all services, volumes, and healthchecks.
• All ADRs (001-007) created and linked in documentation.
• TODO.md, DONE.md, and CHANGELOG.md updated with full traceability.
• Git repository initialized with comprehensive initial commit.

The project is a fully functional, self-hosted 24/7 linear video channel with synchronized playback, custom chat, R2 delivery, moderation, and admin-ready structure. It matches the architecture defined in the arc42 template and all ADRs.

Next Steps (Future ADRs):

• ADR-008: Admin Interface Implementation (ADR-004/ADR-005).
• ADR-009: CI/CD, monitoring (Prometheus/Grafana), and production deployment.
• Tests, admin UI, and final polish.

See docs/architecture/README.md and the ADR files for complete documentation. The system is ready for use and further extension.