# jbear-ai/momo-backend architecture

> Architecture diagram of the GitHub repository jbear-ai/momo-backend, 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/jbear-ai/momo-backend
- Repository: https://github.com/jbear-ai/momo-backend

## Overview

MOMO is a movie-discovery and social-review application: people browse movie information, keep favorites, rate and review films, and interact through comments, reactions, and shared chat. The React client calls a Spring Boot API backed by MySQL; the backend also integrates with movie-data providers and Firebase Storage. The graph preserves the documented chat and image capabilities, but many backend controllers, schedulers, and service relationships were not sampled, so those links are omitted or marked unverified rather than asserted.

Main entry points: [`momo-backend/src/main/java/com/momo/backend/service/MovieService.java`](https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/service/MovieService.java) (Movie service), [`momo-frontend/src/api/AxiosApi.js`](https://github.com/jbear-ai/momo-backend/blob/master/momo-frontend/src/api/AxiosApi.js) (HTTP client), [`momo-backend/src/main/java/com/momo/backend/repository`](https://github.com/jbear-ai/momo-backend/tree/master/momo-backend/src/main/java/com/momo/backend/repository) (MySQL persistence), [`momo-frontend/src/App.js`](https://github.com/jbear-ai/momo-backend/blob/master/momo-frontend/src/App.js) (App routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["App routes<br/>[App.js]"]
  node_movie_ui["Movie screens"]
  node_review_ui["Review screens<br/>[ReviewDetail.js]"]
  node_chat_ui["Chat popup<br/>[ChatPopup.js]"]
  node_api_client["HTTP client<br/>[AxiosApi.js]"]
end

subgraph group_identity["Identity and profiles"]
  node_auth_controller["Auth endpoints"]
  node_auth_service["Auth service<br/>[AuthService.java]"]
  node_jwt["JWT security<br/>[TokenProvider.java]"]
end

subgraph group_movies["Movie discovery"]
  node_movie_controller["Movie endpoints"]
  node_movie_service["Movie service<br/>[MovieService.java]"]
  node_person_service["People lookup<br/>[PersonService.java]"]
  node_tmdb_service["TMDb integration<br/>[TmdbService.java]"]
  node_kobis["KOBIS integration"]
  node_kmdb["KMDb integration<br/>[KmdbApiClient.java]"]
end

subgraph group_community["Reviews and chat"]
  node_review_controller["Review endpoints"]
  node_review_service["Review service<br/>[ReviewService.java]"]
  node_reaction_service["Review reactions"]
  node_chat_handler["Chat WebSocket"]
  node_chat_service["Chat messages"]
  node_chat_images["Chat image storage"]
end

subgraph group_backend["Backend and integrations"]
  node_data[("MySQL persistence")]
  node_firebase["Firebase Storage"]
end

node_visitor(("Member"))

node_visitor -->|"uses"| node_app
node_app -->|"routes to"| node_movie_ui
node_app -->|"routes to"| node_review_ui
node_api_client -->|"sends API requests"| node_auth_controller
node_api_client -->|"sends API requests"| node_movie_controller
node_api_client -->|"sends API requests"| node_review_controller
node_review_ui -->|"requests review data"| node_api_client
node_auth_controller -.->|"delegates to"| node_auth_service
node_auth_service -->|"uses repositories"| node_data
node_auth_service -->|"uploads profile images"| node_firebase
node_movie_controller -.->|"delegates to"| node_movie_service
node_movie_service -.->|"reads movie data"| node_data
node_movie_service -.->|"uses metadata"| node_tmdb_service
node_movie_service -.->|"uses box office"| node_kobis
node_movie_service -.->|"uses movie data"| node_kmdb
node_review_controller -->|"calls"| node_review_service
node_review_service -->|"queries and writes"| node_data
node_chat_ui -->|"connects by WebSocket"| node_chat_handler
node_chat_handler -.->|"uses"| node_chat_service
node_chat_handler -.->|"handles image attachments"| node_chat_images
node_chat_images -->|"stores files locally"| node_data

click node_app "https://github.com/jbear-ai/momo-backend/blob/master/momo-frontend/src/App.js"
click node_movie_ui "https://github.com/jbear-ai/momo-backend/tree/master/momo-frontend/src/pages"
click node_review_ui "https://github.com/jbear-ai/momo-backend/blob/master/momo-frontend/src/pages/ReviewDetail.js"
click node_chat_ui "https://github.com/jbear-ai/momo-backend/blob/master/momo-frontend/src/components/chat/ChatPopup.js"
click node_api_client "https://github.com/jbear-ai/momo-backend/blob/master/momo-frontend/src/api/AxiosApi.js"
click node_auth_controller "https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/controller/AuthController.java"
click node_auth_service "https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/service/AuthService.java"
click node_jwt "https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/security/TokenProvider.java"
click node_movie_controller "https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/controller/MovieController.java"
click node_movie_service "https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/service/MovieService.java"
click node_person_service "https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/service/PersonService.java"
click node_tmdb_service "https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/service/TmdbService.java"
click node_kobis "https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/client/KobisApiClient.java"
click node_kmdb "https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/client/KmdbApiClient.java"
click node_review_controller "https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/controller/ReviewController.java"
click node_review_service "https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/service/ReviewService.java"
click node_reaction_service "https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/service/ReviewReactionService.java"
click node_chat_handler "https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/websocket/ChatWebSocketHandler.java"
click node_chat_service "https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/service/ChatMessageService.java"
click node_chat_images "https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/service/ChatImageStorageService.java"
click node_data "https://github.com/jbear-ai/momo-backend/tree/master/momo-backend/src/main/java/com/momo/backend/repository"

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_movie_ui,node_review_ui,node_chat_ui,node_api_client toneBlue
class node_auth_controller,node_auth_service,node_jwt toneAmber
class node_movie_controller,node_movie_service,node_person_service,node_tmdb_service,node_kobis,node_kmdb toneMint
class node_review_controller,node_review_service,node_reaction_service,node_chat_handler,node_chat_service,node_chat_images toneRose
class node_data,node_firebase,node_visitor toneIndigo
```

## Components

### React client

- [App routes](https://github.com/jbear-ai/momo-backend/blob/master/momo-frontend/src/App.js): `momo-frontend/src/App.js`
- [Movie screens](https://github.com/jbear-ai/momo-backend/tree/master/momo-frontend/src/pages): `momo-frontend/src/pages`
- [Review screens](https://github.com/jbear-ai/momo-backend/blob/master/momo-frontend/src/pages/ReviewDetail.js): `momo-frontend/src/pages/ReviewDetail.js`
- [Chat popup](https://github.com/jbear-ai/momo-backend/blob/master/momo-frontend/src/components/chat/ChatPopup.js): `momo-frontend/src/components/chat/ChatPopup.js`
- [HTTP client](https://github.com/jbear-ai/momo-backend/blob/master/momo-frontend/src/api/AxiosApi.js): `momo-frontend/src/api/AxiosApi.js`

### Identity and profiles

- [Auth endpoints](https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/controller/AuthController.java): `momo-backend/src/main/java/com/momo/backend/controller/AuthController.java`
- [Auth service](https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/service/AuthService.java): `momo-backend/src/main/java/com/momo/backend/service/AuthService.java`
- [JWT security](https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/security/TokenProvider.java): `momo-backend/src/main/java/com/momo/backend/security/TokenProvider.java`

### Movie discovery

- [Movie endpoints](https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/controller/MovieController.java): `momo-backend/src/main/java/com/momo/backend/controller/MovieController.java`
- [Movie service](https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/service/MovieService.java): `momo-backend/src/main/java/com/momo/backend/service/MovieService.java`
- [People lookup](https://github.com/jbear-ai/momo-backend/blob/master/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/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/service/TmdbService.java): `momo-backend/src/main/java/com/momo/backend/service/TmdbService.java`
- [KOBIS integration](https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/client/KobisApiClient.java): `momo-backend/src/main/java/com/momo/backend/client/KobisApiClient.java`
- [KMDb integration](https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/client/KmdbApiClient.java): `momo-backend/src/main/java/com/momo/backend/client/KmdbApiClient.java`

### Reviews and chat

- [Review endpoints](https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/controller/ReviewController.java): `momo-backend/src/main/java/com/momo/backend/controller/ReviewController.java`
- [Review service](https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/service/ReviewService.java): `momo-backend/src/main/java/com/momo/backend/service/ReviewService.java`
- [Review reactions](https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/service/ReviewReactionService.java): `momo-backend/src/main/java/com/momo/backend/service/ReviewReactionService.java`
- [Chat WebSocket](https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/websocket/ChatWebSocketHandler.java): `momo-backend/src/main/java/com/momo/backend/websocket/ChatWebSocketHandler.java`
- [Chat messages](https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/service/ChatMessageService.java): `momo-backend/src/main/java/com/momo/backend/service/ChatMessageService.java`
- [Chat image storage](https://github.com/jbear-ai/momo-backend/blob/master/momo-backend/src/main/java/com/momo/backend/service/ChatImageStorageService.java): `momo-backend/src/main/java/com/momo/backend/service/ChatImageStorageService.java`

### Backend and integrations

- [MySQL persistence](https://github.com/jbear-ai/momo-backend/tree/master/momo-backend/src/main/java/com/momo/backend/repository): `momo-backend/src/main/java/com/momo/backend/repository`
- **Firebase Storage**

### Other components

- **Member**

## Connections

- Member → App routes: uses (evidence: `README.md`)
- App routes → Movie screens: routes to (evidence: `momo-frontend/src/App.js`)
- App routes → Review screens: routes to (evidence: `momo-frontend/src/App.js`)
- HTTP client → Auth endpoints: sends API requests (evidence: `README.md`)
- HTTP client → Movie endpoints: sends API requests (evidence: `README.md`)
- HTTP client → Review endpoints: sends API requests (evidence: `README.md`)
- Review screens → HTTP client: requests review data (evidence: `momo-frontend/src/pages/ReviewDetail.js`)
- Auth endpoints → Auth service: delegates to
- Auth service → MySQL persistence: uses repositories (evidence: `momo-backend/src/main/java/com/momo/backend/service/AuthService.java`)
- Auth service → Firebase Storage: uploads profile images (evidence: `momo-backend/src/main/java/com/momo/backend/service/AuthService.java`)
- Movie endpoints → Movie service: delegates to (evidence: `momo-backend/src/main/java/com/momo/backend/controller/MovieController.java`)
- Movie service → MySQL persistence: reads movie data
- Movie service → TMDb integration: uses metadata
- Movie service → KOBIS integration: uses box office
- Movie service → KMDb integration: uses movie data
- Review endpoints → Review service: calls (evidence: `momo-backend/src/main/java/com/momo/backend/controller/ReviewController.java`)
- Review service → MySQL persistence: queries and writes (evidence: `momo-backend/src/main/java/com/momo/backend/service/ReviewService.java`)
- Chat popup → Chat WebSocket: connects by WebSocket (evidence: `README.md`)
- Chat WebSocket → Chat messages: uses (evidence: `momo-backend/src/main/java/com/momo/backend/websocket/ChatWebSocketHandler.java`)
- Chat WebSocket → Chat image storage: handles image attachments
- Chat image storage → MySQL persistence: stores files locally (evidence: `README.md`)
