# team-youngkk/masit-on architecture

> Architecture diagram of the GitHub repository team-youngkk/masit-on, 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/team-youngkk/masit-on
- Repository: https://github.com/team-youngkk/masit-on

## Overview

Masit-on lets diners discover restaurants visited by YouTube creators, inspect creator and restaurant details, and use member features to save and revisit places. The main journey is public search or map exploration, followed by restaurant/creator detail and visit-video context; members can then favorite places, organize collections, and receive notifications. Administrators maintain content and review AI-extracted registrations. The README establishes the product capabilities and frontend-to-API boundary; sampled query services clarify selected backend compositions, while many other feature implementations were not sampled.

Main entry points: [`frontend/app`](https://github.com/team-youngkk/masit-on/tree/main/frontend/app) (Public web screens), [`frontend/components/admin/AdminPage.tsx`](https://github.com/team-youngkk/masit-on/blob/main/frontend/components/admin/AdminPage.tsx) (Admin workspace), [`src/main/java/com/masiton/restaurant/application/query/RestaurantSearchQueryService.java`](https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/restaurant/application/query/RestaurantSearchQueryService.java) (Restaurant search), [`frontend/components/map/MapScreen.tsx`](https://github.com/team-youngkk/masit-on/blob/main/frontend/components/map/MapScreen.tsx) (Map exploration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Public discovery"]
  node_web["Public web screens"]
  node_restaurant_search["Restaurant search"]
  node_map["Map exploration<br/>[MapScreen.tsx]"]
  node_map_query["Map point query"]
  node_restaurant_detail["Restaurant detail"]
  node_visit_content["Visit videos"]
  node_creator_detail["Creator profiles"]
  node_creator_visits["Creator visits"]
  node_course["Restaurant courses<br/>[CourseScreen.tsx]"]
  node_popular_curations["Popular and curated<br/>[page.tsx]"]
end

subgraph group_identity["Member features"]
  node_member_auth["Member authentication<br/>[MemberAuthForm.tsx]"]
  node_personal["Favorites and collections"]
  node_notifications["Member notifications"]
  node_participation["Member requests"]
end

subgraph group_operations["Admin operations"]
  node_admin["Admin workspace<br/>[AdminPage.tsx]"]
  node_registration["Content registration"]
end

subgraph group_content["Content and AI"]
  node_ai_review["AI extraction review"]
  node_ai_service["AI job review"]
  node_curation_service["Curation management"]
end

subgraph group_backend["Backend query services"]
  node_creator_query["Creator references"]
  node_visit_query["Creator visit IDs"]
  node_restaurant_data[("Restaurant domain<br/>[Region.java]")]
end

node_diners(("Diners"))
node_youtube{{"YouTube"}}
node_kakao{{"Kakao Maps"}}

node_diners -->|"browse"| node_web
node_web -->|"requests API"| node_restaurant_search
node_web -.->|"requests API"| node_restaurant_detail
node_web -.->|"requests API"| node_creator_detail
node_web -->|"opens map"| node_map
node_map -.->|"requests points"| node_map_query
node_map -->|"renders map"| node_kakao
node_restaurant_detail -->|"fetches content"| node_visit_content
node_creator_visits -->|"checks visibility"| node_creator_query
node_restaurant_search -->|"resolves creator filter"| node_visit_query
node_map_query -->|"resolves creator filter"| node_visit_query
node_restaurant_search -->|"queries filters"| node_restaurant_data
node_map_query -->|"queries filters"| node_restaurant_data
node_creator_detail -.->|"uses stored details"| node_youtube
node_diners -->|"signs up"| node_member_auth
node_member_auth -->|"uses member features"| node_personal
node_member_auth -->|"opens notifications"| node_notifications
node_diners -->|"submits requests"| node_participation
node_admin -.->|"registers content"| node_registration
node_admin -->|"reviews jobs"| node_ai_review
node_ai_review -.->|"requests review"| node_ai_service
node_admin -->|"manages curation"| node_curation_service
node_ai_service -.->|"extracts video"| node_youtube
node_web -->|"explores highlights"| node_popular_curations
node_web -->|"plans course"| node_course

click node_web "https://github.com/team-youngkk/masit-on/tree/main/frontend/app"
click node_restaurant_search "https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/restaurant/application/query/RestaurantSearchQueryService.java"
click node_map "https://github.com/team-youngkk/masit-on/blob/main/frontend/components/map/MapScreen.tsx"
click node_map_query "https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/restaurant/application/query/RestaurantMapPointsQueryService.java"
click node_restaurant_detail "https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/orchestration/application/query/RestaurantDetailQueryService.java"
click node_visit_content "https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/orchestration/application/query/VisitContentQueryService.java"
click node_creator_detail "https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/creator/application/query/CreatorDetailQueryService.java"
click node_creator_visits "https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/orchestration/application/query/CreatorVisitedRestaurantsQueryService.java"
click node_course "https://github.com/team-youngkk/masit-on/blob/main/frontend/app/course/CourseScreen.tsx"
click node_popular_curations "https://github.com/team-youngkk/masit-on/blob/main/frontend/app/popular/page.tsx"
click node_member_auth "https://github.com/team-youngkk/masit-on/blob/main/frontend/components/member/MemberAuthForm.tsx"
click node_personal "https://github.com/team-youngkk/masit-on/blob/main/frontend/components/personal/CollectionDetail.tsx"
click node_notifications "https://github.com/team-youngkk/masit-on/blob/main/frontend/components/notification/NotificationListScreen.tsx"
click node_participation "https://github.com/team-youngkk/masit-on/blob/main/frontend/components/participation/ParticipationRequestScreen.tsx"
click node_admin "https://github.com/team-youngkk/masit-on/blob/main/frontend/components/admin/AdminPage.tsx"
click node_registration "https://github.com/team-youngkk/masit-on/blob/main/frontend/components/admin/RegistrationFlow.tsx"
click node_ai_review "https://github.com/team-youngkk/masit-on/blob/main/frontend/components/admin/AiVideoExtractionDetail.tsx"
click node_ai_service "https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/ai/application/AdminAiExtractionQueryService.java"
click node_curation_service "https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/curation/application/AdminCurationService.java"
click node_creator_query "https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/creator/application/CreatorReferenceQueryService.java"
click node_visit_query "https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/visit/application/query/VisitQueryService.java"
click node_restaurant_data "https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/restaurant/domain/model/Region.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_web,node_restaurant_search,node_map,node_map_query,node_restaurant_detail,node_visit_content,node_creator_detail,node_creator_visits,node_course,node_popular_curations toneBlue
class node_member_auth,node_personal,node_notifications,node_participation toneAmber
class node_admin,node_registration toneMint
class node_ai_review,node_ai_service,node_curation_service toneRose
class node_creator_query,node_visit_query,node_restaurant_data,node_diners,node_youtube,node_kakao toneIndigo
```

## Components

### Public discovery

- [Public web screens](https://github.com/team-youngkk/masit-on/tree/main/frontend/app): `frontend/app`
- [Restaurant search](https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/restaurant/application/query/RestaurantSearchQueryService.java): `src/main/java/com/masiton/restaurant/application/query/RestaurantSearchQueryService.java`
- [Map exploration](https://github.com/team-youngkk/masit-on/blob/main/frontend/components/map/MapScreen.tsx): `frontend/components/map/MapScreen.tsx`
- [Map point query](https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/restaurant/application/query/RestaurantMapPointsQueryService.java): `src/main/java/com/masiton/restaurant/application/query/RestaurantMapPointsQueryService.java`
- [Restaurant detail](https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/orchestration/application/query/RestaurantDetailQueryService.java): `src/main/java/com/masiton/orchestration/application/query/RestaurantDetailQueryService.java`
- [Visit videos](https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/orchestration/application/query/VisitContentQueryService.java): `src/main/java/com/masiton/orchestration/application/query/VisitContentQueryService.java`
- [Creator profiles](https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/creator/application/query/CreatorDetailQueryService.java): `src/main/java/com/masiton/creator/application/query/CreatorDetailQueryService.java`
- [Creator visits](https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/orchestration/application/query/CreatorVisitedRestaurantsQueryService.java): `src/main/java/com/masiton/orchestration/application/query/CreatorVisitedRestaurantsQueryService.java`
- [Restaurant courses](https://github.com/team-youngkk/masit-on/blob/main/frontend/app/course/CourseScreen.tsx): `frontend/app/course/CourseScreen.tsx`
- [Popular and curated](https://github.com/team-youngkk/masit-on/blob/main/frontend/app/popular/page.tsx): `frontend/app/popular/page.tsx`

### Member features

- [Member authentication](https://github.com/team-youngkk/masit-on/blob/main/frontend/components/member/MemberAuthForm.tsx): `frontend/components/member/MemberAuthForm.tsx`
- [Favorites and collections](https://github.com/team-youngkk/masit-on/blob/main/frontend/components/personal/CollectionDetail.tsx): `frontend/components/personal/CollectionDetail.tsx`
- [Member notifications](https://github.com/team-youngkk/masit-on/blob/main/frontend/components/notification/NotificationListScreen.tsx): `frontend/components/notification/NotificationListScreen.tsx`
- [Member requests](https://github.com/team-youngkk/masit-on/blob/main/frontend/components/participation/ParticipationRequestScreen.tsx): `frontend/components/participation/ParticipationRequestScreen.tsx`

### Admin operations

- [Admin workspace](https://github.com/team-youngkk/masit-on/blob/main/frontend/components/admin/AdminPage.tsx): `frontend/components/admin/AdminPage.tsx`
- [Content registration](https://github.com/team-youngkk/masit-on/blob/main/frontend/components/admin/RegistrationFlow.tsx): `frontend/components/admin/RegistrationFlow.tsx`

### Content and AI

- [AI extraction review](https://github.com/team-youngkk/masit-on/blob/main/frontend/components/admin/AiVideoExtractionDetail.tsx): `frontend/components/admin/AiVideoExtractionDetail.tsx`
- [AI job review](https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/ai/application/AdminAiExtractionQueryService.java): `src/main/java/com/masiton/ai/application/AdminAiExtractionQueryService.java`
- [Curation management](https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/curation/application/AdminCurationService.java): `src/main/java/com/masiton/curation/application/AdminCurationService.java`

### Backend query services

- [Creator references](https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/creator/application/CreatorReferenceQueryService.java): `src/main/java/com/masiton/creator/application/CreatorReferenceQueryService.java`
- [Creator visit IDs](https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/visit/application/query/VisitQueryService.java): `src/main/java/com/masiton/visit/application/query/VisitQueryService.java`
- [Restaurant domain](https://github.com/team-youngkk/masit-on/blob/main/src/main/java/com/masiton/restaurant/domain/model/Region.java): `src/main/java/com/masiton/restaurant/domain/model/Region.java`

### Other components

- **Diners**
- **YouTube**
- **Kakao Maps**

## Connections

- Diners → Public web screens: browse (evidence: `README.md`)
- Public web screens → Restaurant search: requests API (evidence: `README.md`)
- Public web screens → Restaurant detail: requests API
- Public web screens → Creator profiles: requests API
- Public web screens → Map exploration: opens map (evidence: `README.md`)
- Map exploration → Map point query: requests points
- Map exploration → Kakao Maps: renders map (evidence: `README.md`)
- Restaurant detail → Visit videos: fetches content (evidence: `src/main/java/com/masiton/orchestration/application/query/RestaurantDetailQueryService.java`)
- Creator visits → Creator references: checks visibility (evidence: `src/main/java/com/masiton/orchestration/application/query/CreatorVisitedRestaurantsQueryService.java`)
- Restaurant search → Creator visit IDs: resolves creator filter (evidence: `src/main/java/com/masiton/restaurant/application/query/RestaurantSearchQueryService.java`)
- Map point query → Creator visit IDs: resolves creator filter (evidence: `src/main/java/com/masiton/restaurant/application/query/RestaurantMapPointsQueryService.java`)
- Restaurant search → Restaurant domain: queries filters (evidence: `src/main/java/com/masiton/restaurant/application/query/RestaurantSearchQueryService.java`)
- Map point query → Restaurant domain: queries filters (evidence: `src/main/java/com/masiton/restaurant/application/query/RestaurantMapPointsQueryService.java`)
- Creator profiles → YouTube: uses stored details
- Diners → Member authentication: signs up (evidence: `README.md`)
- Member authentication → Favorites and collections: uses member features (evidence: `README.md`)
- Member authentication → Member notifications: opens notifications (evidence: `README.md`)
- Diners → Member requests: submits requests (evidence: `README.md`)
- Admin workspace → Content registration: registers content
- Admin workspace → AI extraction review: reviews jobs (evidence: `README.md`)
- AI extraction review → AI job review: requests review
- Admin workspace → Curation management: manages curation (evidence: `README.md`)
- AI job review → YouTube: extracts video
- Public web screens → Popular and curated: explores highlights (evidence: `README.md`)
- Public web screens → Restaurant courses: plans course (evidence: `README.md`)
