How ath31st/feedjet works
Feedjet is a digital-signage system: administrators configure kiosks, scenarios, media and schedules; kiosk clients then play those scenarios and refresh configuration over SSE. The client is organized as routes/pages, widgets and features backed by entity API hooks. The server exposes tRPC services, persistent domain data, media processing and device integrations. Several server subsystems are documented but their route-level wiring is not sampled, so those links are shown only where the README or excerpts establish them.
Main entry points: container.ts Service composition · AdminPage.tsx Admin page · router.tsx Route selection · image.storage.service.ts Image processing
Components 28
Kiosk runtime
- Route selection
client/src/app/routes/router.tsx - Kiosk page
client/src/pages/KioskPage.tsx - Kiosk initialization
client/src/app/init/KioskInitializer.tsx - Scenario rotation
client/src/features/kiosk-rotation/model/useScenarioRotation.ts - Scenario rendering
client/src/features/scenario-renderer/ui/ScenarioItemRenderer.tsx - Screen widgets
client/src/widgets - SSE updates
client/src/app/init/useSseStream.ts
Administration
- Admin page
client/src/pages/admin/ui/AdminPage.tsx - Scenario editing
client/src/features/scenario-editor/ui/ScenarioEditor.tsx - Media library
client/src/widgets/media-management/model/useMediaManagementWidget.ts - Admin capabilities
client/src/widgets
Server domain
- Scenario service
server/src/services/scenario.service.ts - Media upload routes
server/src/trpc/routes/image.storage.route.ts - Image processing
server/src/services/image.storage.service.ts - Video processing
server/src/services/video.storage.service.ts - PDF processing
server/src/services/pdf.storage.service.ts - File storage
server/src/services/file.storage.service.ts - Device control
server/src/services/integration.service.ts
Server platform
- tRPC client
client/src/shared/api/trpc/trpc.ts - tRPC API
server/src/trpc/index.ts - Protected procedures
server/src/middleware/auth.ts - Service composition
server/src/container.ts - SQLite data
server/src/db/schema.ts - Philips JointSpace
server/src/integration/philips.jointspace.client.ts - SSE handler
server/src/sse/unified.sse.handler.ts
Other components
- Administrator
- Kiosk screen
- Managed display
Connections 33
- Administrator → Route selection: opens admin
client/src/app/routes/router.tsx - Kiosk screen → Route selection: opens playback
client/src/app/routes/router.tsx - Route selection → Admin page: routes to
client/src/app/routes/router.tsx - Route selection → Kiosk page: routes to
client/src/app/routes/router.tsx - Kiosk page → Kiosk initialization: initializes
- Kiosk initialization → Scenario rotation: loads playback
- Scenario rotation → Scenario rendering: selects items
- Scenario rendering → Screen widgets: renders widgets
- Kiosk initialization → SSE updates: starts updates
- Admin page → Scenario editing: offers editing
- Admin page → Media library: offers library
- Admin page → Admin capabilities: presents tools
- Scenario editing → tRPC client: saves scenarios
- Media library → tRPC client: uploads media
- tRPC client → tRPC API: calls tRPC
- tRPC API → Protected procedures: guards requests
- tRPC API → Service composition: uses services
- Service composition → Scenario service: constructs
server/src/container.ts - Service composition → Image processing: constructs
server/src/container.ts - Service composition → Video processing: constructs
server/src/container.ts - Service composition → PDF processing: constructs
server/src/container.ts - Media upload routes → Image processing: uploads through
server/src/trpc/routes/image.storage.route.ts - Image processing → File storage: inherits storage
- Video processing → File storage: uses storage
server/src/services/video.storage.service.ts - PDF processing → File storage: uses storage
server/src/services/pdf.storage.service.ts - Image processing → SQLite data: stores metadata
server/src/services/image.storage.service.ts - Video processing → SQLite data: stores metadata
server/src/services/video.storage.service.ts - PDF processing → SQLite data: stores metadata
server/src/services/pdf.storage.service.ts - Service composition → Device control: constructs
server/src/container.ts - Device control → Philips JointSpace: controls display
server/src/container.ts - Device control → Managed display: manages
- SSE updates → SSE handler: receives updates
- SSE handler → Kiosk screen: streams config