How omerdlw/guffin works
Guffin is a film-and-TV diary: users discover catalogue titles, inspect details, then record watches, ratings, reviews, lists, and show progress; profiles and activity expose that history socially. The graph groups route-facing product features, catalogue integrations, identity and persistence, and the shared interface. Several feature branches are documented in the README or apparent from the tree, but their internal calls were not sampled; those links are omitted rather than inferred. Database access is scoped by viewer identity under Postgres RLS, and TMDB supplies catalogue data.
Main entry points: app App routes · tmdb/server.ts TMDB client · search/server.ts Search · tv/server.ts Show tracking
Components 22
Product features
- App routes
src/app - Home feed
src/features/home/server.ts - Search
src/features/search/server.ts - Film details
src/features/movie/movie.ts - Show tracking
src/features/tv/server.ts - People
src/features/person/credits.ts - Profiles and diary
src/features/profile - Reviews
src/features/reviews/server.ts - Lists
src/features/lists/server.ts - Spotlights
src/features/spotlights/server.ts - Social
src/features/social
Catalogue services
- TMDB client
src/lib/tmdb/server.ts - TMDB
- Catalogue quality
src/features/catalog/quality.ts
Identity and data
- Auth and sessions
src/lib/auth/server.ts - Auth workflows
src/features/auth/server.ts - Postgres
- Scoped DB access
src/lib/db/client.ts - Domain schema
src/lib/db/schema.ts
Interface system
- Design system
src/design - Motion engine
src/motion/engine.ts
Other components
- Viewer
Connections 32
- Viewer → App routes: uses routes
- App routes → Home feed: composes
- App routes → Search: composes
src/app/api/search/route.ts - App routes → Film details: composes
src/app/api/backdrop/route.ts - App routes → Show tracking: composes
src/app/api/cron/shows/route.ts - App routes → Profiles and diary: composes
- App routes → Reviews: composes
- App routes → Lists: composes
- App routes → Spotlights: composes
- App routes → People: composes
src/app/api/backdrop/route.ts - App routes → Social: routes
src/app/api/social/follows/route.ts - Home feed → Auth workflows: reads identity
src/features/home/server.ts - Home feed → Postgres: reads activity
src/features/home/server.ts - Search → TMDB client: searches titles
src/features/search/server.ts - Search → Catalogue quality: filters results
src/features/search/server.ts - Search → Postgres: queries community
src/features/search/server.ts - Show tracking → TMDB client: loads episodes
src/features/tv/server.ts - Show tracking → Catalogue quality: checks airing
src/features/tv/server.ts - Show tracking → Postgres: reads progress
src/features/tv/server.ts - Reviews → Postgres: reads and writes
src/features/reviews/server.ts - Lists → Postgres: reads and writes
src/features/lists/server.ts - Spotlights → TMDB client: loads catalogue
src/features/spotlights/server.ts - Spotlights → Catalogue quality: filters titles
src/features/spotlights/server.ts - Auth workflows → Auth and sessions: configures sessions
src/features/auth/server.ts - Auth and sessions → Postgres: stores auth data
src/lib/auth/server.ts - Auth workflows → Scoped DB access: creates viewer scope
src/features/auth/server.ts - Scoped DB access → Postgres: scopes transactions
src/lib/db/client.ts - Scoped DB access → Domain schema: binds schema
src/lib/db/client.ts - TMDB client → TMDB: fetches catalogue
src/lib/tmdb/server.ts - TMDB client → Catalogue quality: uses shared rules
- App routes → Design system: renders with
- App routes → Motion engine: uses choreography