# madison-yoon/momo architecture

> Architecture diagram of the GitHub repository madison-yoon/momo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/madison-yoon/momo
- Repository: https://github.com/madison-yoon/momo

## Overview

MOMO is a movie-discovery and social-review application: users browse and search films, inspect movie and person details, and participate through reviews, comments, reactions, and favorites. The frontend also supports accounts and live chat; the backend includes catalog synchronization, metadata/poster handling, and external movie-data clients. Sampled evidence shows frontend routing and review-controller delegation, but not every endpoint-to-service connection, so uncertain links are omitted or marked unverified.

Main entry points: [`momo-frontend/src/pages/ReviewDetail.js`](https://github.com/madison-yoon/momo/blob/main/momo-frontend/src/pages/ReviewDetail.js) (Review detail), [`momo-backend/src/main/java/com/momo/backend/service/ReviewService.java`](https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/service/ReviewService.java) (Review workflows), [`momo-frontend/src/App.js`](https://github.com/madison-yoon/momo/blob/main/momo-frontend/src/App.js) (React routes), [`momo-frontend/src/api/AxiosApi.js`](https://github.com/madison-yoon/momo/blob/main/momo-frontend/src/api/AxiosApi.js) (HTTP client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web experience"]
  node_webapp["React routes<br/>[App.js]"]
  node_moviepages["Movie pages<br/>[MovieDetail.js]"]
  node_reviewpage["Review detail<br/>[ReviewDetail.js]"]
  node_safeimage["Image fallback<br/>[SafeImage.js]"]
  node_apiclient["HTTP client<br/>[AxiosApi.js]"]
end

subgraph group_identity["Accounts"]
  node_authui["Account pages<br/>[Login.js]"]
  node_authcontroller["Authentication API"]
  node_authservice["Account service<br/>[AuthService.java]"]
  node_userstore[("User records<br/>[User.java]")]
end

subgraph group_movies["Movie discovery"]
  node_catalog["Catalog and search<br/>[MovieService.java]"]
  node_people["Person details<br/>[PersonService.java]"]
  node_tmdb["TMDb integration<br/>[TmdbService.java]"]
  node_movieentity[("Movie records<br/>[Movie.java]")]
end

subgraph group_community["Reviews and chat"]
  node_reviewcontroller["Review API"]
  node_reviewservice["Review workflows<br/>[ReviewService.java]"]
  node_reviewstore[("Review records<br/>[Review.java]")]
  node_reactionservice["Review reactions"]
  node_chat["Live chat"]
end

subgraph group_backend["Backend services"]
  node_otherfeatures["Comments, favorites, ratings, posters"]
  node_catalogsync["Catalog sync and enrichment"]
  node_storage["Poster and image storage"]
end

node_user(("Movie fan"))

node_user -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_moviepages
node_webapp -->|"routes to"| node_reviewpage
node_reviewpage -->|"requests data"| node_apiclient
node_reviewpage -->|"renders"| node_safeimage
node_user -.->|"signs in"| node_authui
node_apiclient -.->|"calls HTTP API"| node_authcontroller
node_authcontroller -.->|"delegates to"| node_authservice
node_authservice -->|"reads/writes"| node_userstore
node_reviewcontroller -->|"delegates to"| node_reviewservice
node_reviewservice -->|"queries and saves"| node_reviewstore
node_reviewservice -->|"reads movie data"| node_movieentity
node_reviewservice -->|"loads counts"| node_otherfeatures
node_reactionservice -->|"locks review"| node_reviewstore
node_reviewpage -.->|"uses review API"| node_reviewcontroller
node_catalogsync -.->|"may enrich from"| node_tmdb

click node_webapp "https://github.com/madison-yoon/momo/blob/main/momo-frontend/src/App.js"
click node_moviepages "https://github.com/madison-yoon/momo/blob/main/momo-frontend/src/pages/MovieDetail.js"
click node_reviewpage "https://github.com/madison-yoon/momo/blob/main/momo-frontend/src/pages/ReviewDetail.js"
click node_safeimage "https://github.com/madison-yoon/momo/blob/main/momo-frontend/src/components/common/SafeImage.js"
click node_apiclient "https://github.com/madison-yoon/momo/blob/main/momo-frontend/src/api/AxiosApi.js"
click node_authui "https://github.com/madison-yoon/momo/blob/main/momo-frontend/src/pages/Login.js"
click node_authcontroller "https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/controller/AuthController.java"
click node_authservice "https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/service/AuthService.java"
click node_userstore "https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/entity/User.java"
click node_catalog "https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/service/MovieService.java"
click node_people "https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/service/PersonService.java"
click node_tmdb "https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/service/TmdbService.java"
click node_movieentity "https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/entity/Movie.java"
click node_reviewcontroller "https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/controller/ReviewController.java"
click node_reviewservice "https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/service/ReviewService.java"
click node_reviewstore "https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/entity/Review.java"
click node_reactionservice "https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/service/ReviewReactionService.java"
click node_chat "https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/websocket/ChatWebSocketHandler.java"
click node_otherfeatures "https://github.com/madison-yoon/momo/tree/main/momo-backend/src/main/java/com/momo/backend/service"
click node_catalogsync "https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/service/MovieCatalogSyncService.java"
click node_storage "https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/service/PosterFileStorageService.java"

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_webapp,node_moviepages,node_reviewpage,node_safeimage,node_apiclient toneBlue
class node_authui,node_authcontroller,node_authservice,node_userstore toneAmber
class node_catalog,node_people,node_tmdb,node_movieentity toneMint
class node_reviewcontroller,node_reviewservice,node_reviewstore,node_reactionservice,node_chat toneRose
class node_otherfeatures,node_catalogsync,node_storage,node_user toneIndigo
```

## Components

### Web experience

- [React routes](https://github.com/madison-yoon/momo/blob/main/momo-frontend/src/App.js): `momo-frontend/src/App.js`
- [Movie pages](https://github.com/madison-yoon/momo/blob/main/momo-frontend/src/pages/MovieDetail.js): `momo-frontend/src/pages/MovieDetail.js`
- [Review detail](https://github.com/madison-yoon/momo/blob/main/momo-frontend/src/pages/ReviewDetail.js): `momo-frontend/src/pages/ReviewDetail.js`
- [Image fallback](https://github.com/madison-yoon/momo/blob/main/momo-frontend/src/components/common/SafeImage.js): `momo-frontend/src/components/common/SafeImage.js`
- [HTTP client](https://github.com/madison-yoon/momo/blob/main/momo-frontend/src/api/AxiosApi.js): `momo-frontend/src/api/AxiosApi.js`

### Accounts

- [Account pages](https://github.com/madison-yoon/momo/blob/main/momo-frontend/src/pages/Login.js): `momo-frontend/src/pages/Login.js`
- [Authentication API](https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/controller/AuthController.java): `momo-backend/src/main/java/com/momo/backend/controller/AuthController.java`
- [Account service](https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/service/AuthService.java): `momo-backend/src/main/java/com/momo/backend/service/AuthService.java`
- [User records](https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/entity/User.java): `momo-backend/src/main/java/com/momo/backend/entity/User.java`

### Movie discovery

- [Catalog and search](https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/service/MovieService.java): `momo-backend/src/main/java/com/momo/backend/service/MovieService.java`
- [Person details](https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/service/PersonService.java): `momo-backend/src/main/java/com/momo/backend/service/PersonService.java`
- [TMDb integration](https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/service/TmdbService.java): `momo-backend/src/main/java/com/momo/backend/service/TmdbService.java`
- [Movie records](https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/entity/Movie.java): `momo-backend/src/main/java/com/momo/backend/entity/Movie.java`

### Reviews and chat

- [Review API](https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/controller/ReviewController.java): `momo-backend/src/main/java/com/momo/backend/controller/ReviewController.java`
- [Review workflows](https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/service/ReviewService.java): `momo-backend/src/main/java/com/momo/backend/service/ReviewService.java`
- [Review records](https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/entity/Review.java): `momo-backend/src/main/java/com/momo/backend/entity/Review.java`
- [Review reactions](https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/service/ReviewReactionService.java): `momo-backend/src/main/java/com/momo/backend/service/ReviewReactionService.java`
- [Live chat](https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/websocket/ChatWebSocketHandler.java): `momo-backend/src/main/java/com/momo/backend/websocket/ChatWebSocketHandler.java`

### Backend services

- [Comments, favorites, ratings, posters](https://github.com/madison-yoon/momo/tree/main/momo-backend/src/main/java/com/momo/backend/service): `momo-backend/src/main/java/com/momo/backend/service`
- [Catalog sync and enrichment](https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/service/MovieCatalogSyncService.java): `momo-backend/src/main/java/com/momo/backend/service/MovieCatalogSyncService.java`
- [Poster and image storage](https://github.com/madison-yoon/momo/blob/main/momo-backend/src/main/java/com/momo/backend/service/PosterFileStorageService.java): `momo-backend/src/main/java/com/momo/backend/service/PosterFileStorageService.java`

### Other components

- **Movie fan**

## Connections

- Movie fan → React routes: uses (evidence: `momo-frontend/src/App.js`)
- React routes → Movie pages: routes to (evidence: `momo-frontend/src/App.js`)
- React routes → Review detail: routes to (evidence: `momo-frontend/src/App.js`)
- Review detail → HTTP client: requests data (evidence: `momo-frontend/src/pages/ReviewDetail.js`)
- Review detail → Image fallback: renders (evidence: `momo-frontend/src/pages/ReviewDetail.js`)
- Movie fan → Account pages: signs in
- HTTP client → Authentication API: calls HTTP API
- Authentication API → Account service: delegates to
- Account service → User records: reads/writes (evidence: `momo-backend/src/main/java/com/momo/backend/service/AuthService.java`)
- Review API → Review workflows: delegates to (evidence: `momo-backend/src/main/java/com/momo/backend/controller/ReviewController.java`)
- Review workflows → Review records: queries and saves (evidence: `momo-backend/src/main/java/com/momo/backend/service/ReviewService.java`)
- Review workflows → Movie records: reads movie data (evidence: `momo-backend/src/main/java/com/momo/backend/service/ReviewService.java`)
- Review workflows → Comments, favorites, ratings, posters: loads counts (evidence: `momo-backend/src/main/java/com/momo/backend/service/ReviewService.java`)
- Review reactions → Review records: locks review (evidence: `momo-backend/src/main/java/com/momo/backend/service/ReviewReactionService.java`)
- Review detail → Review API: uses review API
- Catalog sync and enrichment → TMDb integration: may enrich from
