How uwt-tcss460-sp26/group-project-backend-group-2-3 works
This is an Express API for a movie and TV review platform. Clients use media search, popular and detail endpoints, submit issues, and manage ratings and reviews; authenticated requests map token identities to local users. Discovery ranks community ratings and enriches results with TMDB metadata. The graph preserves the documented issue queue, profile, and media capabilities, though some controller and route implementations were not sampled. Edges reflect README statements or source-index references and excerpts; unsampled internals are not inferred.
Main entry points: index.ts V1 route mount · reviews.ts Review management · prisma.ts PostgreSQL · tmdb-client.ts TMDB client
Components 27
API and routing
- Express app
src/app.ts - V1 route mount
src/routes/v1/index.ts - Issue routes
src/routes/v1/issues.ts - Media routes
src/routes/v1/movies.ts - TV routes
src/routes/v1/tv-shows.ts - Community routes
src/routes/v1/reviews.ts - Profile routes
src/routes/v1/me.ts
Identity and access
- Token authentication
src/middleware/requireAuth.ts - Local role gate
src/middleware/requireLocalRole.ts - Local user mapping
src/services/local-user.ts
Media catalog
- Movie catalog
src/controllers/v1/movies.ts - TV catalog
src/controllers/v1/tv-shows.ts - Top-rated discovery
src/controllers/v1/discover.ts - TMDB client
src/services/tmdb-client.ts - TMDB enrichment
src/services/tmdb-meta.ts
Community content
- Issue handling
src/controllers/v1/issues.ts - Rating management
src/controllers/v1/ratings.ts - Review management
src/controllers/v1/reviews.ts - User profile
src/controllers/v1/me.ts - Community summaries
src/services/community-summary.ts - Content responses
src/transformers/user-content.ts
Data and errors
- PostgreSQL
src/lib/prisma.ts - Error handling
src/middleware/error-handler.ts - Error mapping
src/errors/error-mapper.ts
Other components
- API client
- Auth2 issuer
- TMDB service
Connections 38
- API client → Express app: sends requests
README.md - Express app → V1 route mount: mounts routes
src/app.ts - Express app → Error handling: uses middleware
src/app.ts - V1 route mount → Issue routes: mounts
src/routes/v1/index.ts - V1 route mount → Media routes: mounts
src/routes/v1/index.ts - V1 route mount → TV routes: mounts
src/routes/v1/index.ts - V1 route mount → Community routes: mounts
src/routes/v1/index.ts - V1 route mount → Profile routes: mounts
src/routes/v1/index.ts - Issue routes → Issue handling: routes to
src/routes/v1/issues.ts - Media routes → Movie catalog: routes to
- TV routes → TV catalog: routes to
src/routes/v1/tv-shows.ts - Community routes → Review management: routes to
src/routes/v1/reviews.ts - Profile routes → User profile: routes to
src/routes/v1/me.ts - Profile routes → Review management: routes to
src/routes/v1/me.ts - Issue routes → Token authentication: requires auth
src/routes/v1/issues.ts - Issue routes → Local role gate: checks local role
src/routes/v1/issues.ts - Community routes → Token authentication: requires auth
src/routes/v1/reviews.ts - Profile routes → Token authentication: requires auth
src/routes/v1/me.ts - Token authentication → Auth2 issuer: validates tokens
src/middleware/requireAuth.ts - Local role gate → PostgreSQL: reads roles
src/middleware/requireLocalRole.ts - Review management → Local user mapping: resolves user
src/controllers/v1/reviews.ts - Rating management → Local user mapping: resolves user
src/controllers/v1/ratings.ts - Review management → PostgreSQL: reads and writes
src/controllers/v1/reviews.ts - Rating management → PostgreSQL: reads and writes
src/controllers/v1/ratings.ts - Issue handling → PostgreSQL: uses persistence
src/controllers/v1/issues.ts - Movie catalog → TMDB client: fetches catalog data
src/controllers/v1/movies.ts - TV catalog → TMDB client: fetches catalog data
- Top-rated discovery → PostgreSQL: aggregates ratings
README.md - Top-rated discovery → TMDB client: enriches results
src/controllers/v1/discover.ts - Review management → TMDB enrichment: fetches metadata
src/controllers/v1/reviews.ts - TMDB enrichment → TMDB client: requests metadata
src/services/tmdb-meta.ts - TMDB client → TMDB service: calls API
src/services/tmdb-client.ts - Movie catalog → Community summaries: loads summaries
src/controllers/v1/movies.ts - Community summaries → PostgreSQL: queries ratings
src/services/community-summary.ts - Community summaries → Content responses: uses response mapping
src/services/community-summary.ts - Review management → Content responses: maps responses
src/controllers/v1/reviews.ts - Rating management → Content responses: maps responses
src/controllers/v1/ratings.ts - Error handling → Error mapping: maps errors
src/middleware/error-handler.ts