Ordo Kino

Ordo Kino is a complete self-hosted media platform that transforms a personal media collection into a Netflix-grade experience. The goal was to provide a private, secure streaming service for family and friends with professional-level UX.

The system operates across two domains: the web interface (kino.ordo.hu) routes through a Contabo VPS reverse proxy — keeping the home server's IP hidden — while video streaming (flumen.ordo.hu) connects directly to the hardware via signed URL tokens for maximum performance.

The platform integrates with TMDB for discovery: trending movies and series, genre filtering, detailed pages with cast and ratings. Search uses debounced autocomplete — suggestions appear instantly as you type. The e-book section features Google Books autocomplete, and downloaded PDFs can be read online or sent to Kindle.

Security was a top priority: JWT authentication with PBKDF2-SHA512 password hashing, registration key system (admin-generated, single-use), role-based access control (admin/user), brute-force protection with rate limiting, and every API call recorded in an activity log.

The zero-downtime deploy system alternates between two ports (blue-green), with Caddy health checks automatically routing to the live instance — users experience zero interruption during updates.

The project was built using Agentic Development methodology: most of the development was performed by an AI assistant under human supervision and creative direction. 100+ tests, TypeScript strict mode (zero 'any' types), WHY-focused JSDoc comments, and detailed Mermaid architecture diagrams document the entire system.