# uwt-tcss460-sp26/group-project-backend-group-2-3 architecture

> Architecture diagram of the GitHub repository uwt-tcss460-sp26/group-project-backend-group-2-3, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/uwt-tcss460-sp26/group-project-backend-group-2-3
- Repository: https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3
- Video tour (about a minute): https://gitdiagram.com/uwt-tcss460-sp26/group-project-backend-group-2-3/video

## Overview

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: [`src/routes/v1/index.ts`](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/routes/v1/index.ts) (V1 route mount), [`src/controllers/v1/reviews.ts`](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/controllers/v1/reviews.ts) (Review management), [`src/lib/prisma.ts`](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/lib/prisma.ts) (PostgreSQL), [`src/services/tmdb-client.ts`](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/services/tmdb-client.ts) (TMDB client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and routing"]
  node_app["Express app<br/>[app.ts]"]
  node_v1routes["V1 route mount<br/>[index.ts]"]
  node_issue_routes["Issue routes<br/>[issues.ts]"]
  node_media_routes["Media routes<br/>[movies.ts]"]
  node_tv_routes["TV routes<br/>[tv-shows.ts]"]
  node_community_routes["Community routes<br/>[reviews.ts]"]
  node_profile_routes["Profile routes<br/>[me.ts]"]
end

subgraph group_identity["Identity and access"]
  node_auth["Token authentication<br/>[requireAuth.ts]"]
  node_local_role["Local role gate"]
  node_local_user["Local user mapping<br/>[local-user.ts]"]
end

subgraph group_media["Media catalog"]
  node_movie_handlers["Movie catalog<br/>[movies.ts]"]
  node_tv_handlers["TV catalog<br/>[tv-shows.ts]"]
  node_discovery["Top-rated discovery<br/>[discover.ts]"]
  node_tmdb["TMDB client<br/>[tmdb-client.ts]"]
  node_tmdb_meta["TMDB enrichment<br/>[tmdb-meta.ts]"]
end

subgraph group_community["Community content"]
  node_issue_handlers["Issue handling<br/>[issues.ts]"]
  node_rating_handlers["Rating management<br/>[ratings.ts]"]
  node_review_handlers["Review management<br/>[reviews.ts]"]
  node_profile_handlers["User profile<br/>[me.ts]"]
  node_community_summary["Community summaries"]
  node_content_transform["Content responses<br/>[user-content.ts]"]
end

subgraph group_platform["Data and errors"]
  node_database[("PostgreSQL<br/>[prisma.ts]")]
  node_error_handler["Error handling<br/>[error-handler.ts]"]
  node_error_mapper["Error mapping<br/>[error-mapper.ts]"]
end

node_client(("API client"))
node_auth_provider(("Auth2 issuer"))
node_tmdb_service(("TMDB service"))

node_client -->|"sends requests"| node_app
node_app -->|"mounts routes"| node_v1routes
node_app -->|"uses middleware"| node_error_handler
node_v1routes -->|"mounts"| node_issue_routes
node_v1routes -->|"mounts"| node_media_routes
node_v1routes -->|"mounts"| node_tv_routes
node_v1routes -->|"mounts"| node_community_routes
node_v1routes -->|"mounts"| node_profile_routes
node_issue_routes -->|"routes to"| node_issue_handlers
node_media_routes -.->|"routes to"| node_movie_handlers
node_tv_routes -->|"routes to"| node_tv_handlers
node_community_routes -->|"routes to"| node_review_handlers
node_profile_routes -->|"routes to"| node_profile_handlers
node_profile_routes -->|"routes to"| node_review_handlers
node_issue_routes -->|"requires auth"| node_auth
node_issue_routes -->|"checks local role"| node_local_role
node_community_routes -->|"requires auth"| node_auth
node_profile_routes -->|"requires auth"| node_auth
node_auth -->|"validates tokens"| node_auth_provider
node_local_role -->|"reads roles"| node_database
node_review_handlers -->|"resolves user"| node_local_user
node_rating_handlers -->|"resolves user"| node_local_user
node_review_handlers -->|"reads and writes"| node_database
node_rating_handlers -->|"reads and writes"| node_database
node_issue_handlers -->|"uses persistence"| node_database
node_movie_handlers -->|"fetches catalog data"| node_tmdb
node_tv_handlers -.->|"fetches catalog data"| node_tmdb
node_discovery -->|"aggregates ratings"| node_database
node_discovery -->|"enriches results"| node_tmdb
node_review_handlers -->|"fetches metadata"| node_tmdb_meta
node_tmdb_meta -->|"requests metadata"| node_tmdb
node_tmdb -->|"calls API"| node_tmdb_service
node_movie_handlers -->|"loads summaries"| node_community_summary
node_community_summary -->|"queries ratings"| node_database
node_community_summary -->|"uses response mapping"| node_content_transform
node_review_handlers -->|"maps responses"| node_content_transform
node_rating_handlers -->|"maps responses"| node_content_transform
node_error_handler -->|"maps errors"| node_error_mapper

click node_app "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/app.ts"
click node_v1routes "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/routes/v1/index.ts"
click node_issue_routes "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/routes/v1/issues.ts"
click node_media_routes "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/routes/v1/movies.ts"
click node_tv_routes "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/routes/v1/tv-shows.ts"
click node_community_routes "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/routes/v1/reviews.ts"
click node_profile_routes "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/routes/v1/me.ts"
click node_issue_handlers "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/controllers/v1/issues.ts"
click node_movie_handlers "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/controllers/v1/movies.ts"
click node_tv_handlers "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/controllers/v1/tv-shows.ts"
click node_discovery "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/controllers/v1/discover.ts"
click node_rating_handlers "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/controllers/v1/ratings.ts"
click node_review_handlers "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/controllers/v1/reviews.ts"
click node_profile_handlers "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/controllers/v1/me.ts"
click node_auth "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/middleware/requireAuth.ts"
click node_local_role "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/middleware/requireLocalRole.ts"
click node_local_user "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/services/local-user.ts"
click node_tmdb "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/services/tmdb-client.ts"
click node_tmdb_meta "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/services/tmdb-meta.ts"
click node_community_summary "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/services/community-summary.ts"
click node_content_transform "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/transformers/user-content.ts"
click node_database "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/lib/prisma.ts"
click node_error_handler "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/middleware/error-handler.ts"
click node_error_mapper "https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/errors/error-mapper.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_v1routes,node_issue_routes,node_media_routes,node_tv_routes,node_community_routes,node_profile_routes,node_client toneBlue
class node_auth,node_local_role,node_local_user toneAmber
class node_movie_handlers,node_tv_handlers,node_discovery,node_tmdb,node_tmdb_meta toneMint
class node_issue_handlers,node_rating_handlers,node_review_handlers,node_profile_handlers,node_community_summary,node_content_transform toneRose
class node_database,node_error_handler,node_error_mapper,node_auth_provider,node_tmdb_service toneIndigo
```

## Components

### API and routing

- [Express app](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/app.ts): `src/app.ts`
- [V1 route mount](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/routes/v1/index.ts): `src/routes/v1/index.ts`
- [Issue routes](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/routes/v1/issues.ts): `src/routes/v1/issues.ts`
- [Media routes](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/routes/v1/movies.ts): `src/routes/v1/movies.ts`
- [TV routes](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/routes/v1/tv-shows.ts): `src/routes/v1/tv-shows.ts`
- [Community routes](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/routes/v1/reviews.ts): `src/routes/v1/reviews.ts`
- [Profile routes](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/routes/v1/me.ts): `src/routes/v1/me.ts`

### Identity and access

- [Token authentication](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/middleware/requireAuth.ts): `src/middleware/requireAuth.ts`
- [Local role gate](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/middleware/requireLocalRole.ts): `src/middleware/requireLocalRole.ts`
- [Local user mapping](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/services/local-user.ts): `src/services/local-user.ts`

### Media catalog

- [Movie catalog](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/controllers/v1/movies.ts): `src/controllers/v1/movies.ts`
- [TV catalog](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/controllers/v1/tv-shows.ts): `src/controllers/v1/tv-shows.ts`
- [Top-rated discovery](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/controllers/v1/discover.ts): `src/controllers/v1/discover.ts`
- [TMDB client](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/services/tmdb-client.ts): `src/services/tmdb-client.ts`
- [TMDB enrichment](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/services/tmdb-meta.ts): `src/services/tmdb-meta.ts`

### Community content

- [Issue handling](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/controllers/v1/issues.ts): `src/controllers/v1/issues.ts`
- [Rating management](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/controllers/v1/ratings.ts): `src/controllers/v1/ratings.ts`
- [Review management](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/controllers/v1/reviews.ts): `src/controllers/v1/reviews.ts`
- [User profile](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/controllers/v1/me.ts): `src/controllers/v1/me.ts`
- [Community summaries](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/services/community-summary.ts): `src/services/community-summary.ts`
- [Content responses](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/transformers/user-content.ts): `src/transformers/user-content.ts`

### Data and errors

- [PostgreSQL](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/lib/prisma.ts): `src/lib/prisma.ts`
- [Error handling](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/middleware/error-handler.ts): `src/middleware/error-handler.ts`
- [Error mapping](https://github.com/uwt-tcss460-sp26/group-project-backend-group-2-3/blob/main/src/errors/error-mapper.ts): `src/errors/error-mapper.ts`

### Other components

- **API client**
- **Auth2 issuer**
- **TMDB service**

## Connections

- API client → Express app: sends requests (evidence: `README.md`)
- Express app → V1 route mount: mounts routes (evidence: `src/app.ts`)
- Express app → Error handling: uses middleware (evidence: `src/app.ts`)
- V1 route mount → Issue routes: mounts (evidence: `src/routes/v1/index.ts`)
- V1 route mount → Media routes: mounts (evidence: `src/routes/v1/index.ts`)
- V1 route mount → TV routes: mounts (evidence: `src/routes/v1/index.ts`)
- V1 route mount → Community routes: mounts (evidence: `src/routes/v1/index.ts`)
- V1 route mount → Profile routes: mounts (evidence: `src/routes/v1/index.ts`)
- Issue routes → Issue handling: routes to (evidence: `src/routes/v1/issues.ts`)
- Media routes → Movie catalog: routes to
- TV routes → TV catalog: routes to (evidence: `src/routes/v1/tv-shows.ts`)
- Community routes → Review management: routes to (evidence: `src/routes/v1/reviews.ts`)
- Profile routes → User profile: routes to (evidence: `src/routes/v1/me.ts`)
- Profile routes → Review management: routes to (evidence: `src/routes/v1/me.ts`)
- Issue routes → Token authentication: requires auth (evidence: `src/routes/v1/issues.ts`)
- Issue routes → Local role gate: checks local role (evidence: `src/routes/v1/issues.ts`)
- Community routes → Token authentication: requires auth (evidence: `src/routes/v1/reviews.ts`)
- Profile routes → Token authentication: requires auth (evidence: `src/routes/v1/me.ts`)
- Token authentication → Auth2 issuer: validates tokens (evidence: `src/middleware/requireAuth.ts`)
- Local role gate → PostgreSQL: reads roles (evidence: `src/middleware/requireLocalRole.ts`)
- Review management → Local user mapping: resolves user (evidence: `src/controllers/v1/reviews.ts`)
- Rating management → Local user mapping: resolves user (evidence: `src/controllers/v1/ratings.ts`)
- Review management → PostgreSQL: reads and writes (evidence: `src/controllers/v1/reviews.ts`)
- Rating management → PostgreSQL: reads and writes (evidence: `src/controllers/v1/ratings.ts`)
- Issue handling → PostgreSQL: uses persistence (evidence: `src/controllers/v1/issues.ts`)
- Movie catalog → TMDB client: fetches catalog data (evidence: `src/controllers/v1/movies.ts`)
- TV catalog → TMDB client: fetches catalog data
- Top-rated discovery → PostgreSQL: aggregates ratings (evidence: `README.md`)
- Top-rated discovery → TMDB client: enriches results (evidence: `src/controllers/v1/discover.ts`)
- Review management → TMDB enrichment: fetches metadata (evidence: `src/controllers/v1/reviews.ts`)
- TMDB enrichment → TMDB client: requests metadata (evidence: `src/services/tmdb-meta.ts`)
- TMDB client → TMDB service: calls API (evidence: `src/services/tmdb-client.ts`)
- Movie catalog → Community summaries: loads summaries (evidence: `src/controllers/v1/movies.ts`)
- Community summaries → PostgreSQL: queries ratings (evidence: `src/services/community-summary.ts`)
- Community summaries → Content responses: uses response mapping (evidence: `src/services/community-summary.ts`)
- Review management → Content responses: maps responses (evidence: `src/controllers/v1/reviews.ts`)
- Rating management → Content responses: maps responses (evidence: `src/controllers/v1/ratings.ts`)
- Error handling → Error mapping: maps errors (evidence: `src/middleware/error-handler.ts`)
