Popcorn Society · Application

Popcorn Society · Application An architecture diagram generated by Archify. Browser · React + TypeScript · Architecture component Browser React + TypeScript Traefik · HTTPS ingress / routing · Architecture component Traefik HTTPS ingress / routing Frontend server · Nginx · static assets · Architecture component Frontend server Nginx · static assets Java backend · Spring Boot · domain API · Architecture component Java backend Spring Boot · domain API Python Concierge · FastAPI · voice + tools · Architecture component Python Concierge FastAPI · voice + tools PostgreSQL · Source of truth · Architecture component PostgreSQL Source of truth OpenSearch · Hybrid search index · Architecture component OpenSearch Hybrid search index RustFS · S3-compatible media · Architecture component RustFS S3-compatible media llama.cpp · Local text embeddings · Architecture component llama.cpp Local text embeddings OpenAI / xAI · Models + realtime voice · Architecture component OpenAI / xAI Models + realtime voice HTTPS REST / auth SQL Web assets WebSocket Protected MCP Voice / model API Embeddings Search / index S3 API Legend Frontend Backend Database Cloud External

One home cluster

  • • Single-node k3s; Traefik routes public traffic.
  • • React runs in the browser; Nginx serves its build.

Domain ownership

  • • Java owns catalog, accounts and personal actions.
  • • Python calls MCP tools, never the data stores.

Selected paths

  • • Search is rebuilt from PostgreSQL through Java.
  • • Public media, OAuth and TMDB paths are omitted.