# lazyuns/dnc architecture

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

- Interactive diagram: https://gitdiagram.com/lazyuns/dnc
- Repository: https://github.com/lazyuns/dnc

## Overview

당낭콩은 Expo 모바일 앱과 Spring Boot API를 중심으로 한 CGM·식단 기반 혈당 관리 서비스이며, FastAPI는 음식 탐지와 식후 혈당 예측을 담당합니다. 주요 흐름은 식사 사진 분석·기록과 Dexcom 혈당 수집에서 개인화 리포트·알림까지입니다. README와 SOURCE INDEX, 제공된 소스 발췌로 확인되는 관계만 표시했습니다. 일부 기능은 트리와 README에만 근거하므로 해당 연결의 증거는 README입니다.

Main entry points: [`apps/backend/dnc/src/main/java/com/djjko/dnc/ai/food/service/AiFoodService.java`](https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/ai/food/service/AiFoodService.java) (Food Analysis), [`apps/backend/dnc/src/main/java/com/djjko/dnc/DncApplication.java`](https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/DncApplication.java) (Spring API), [`apps/backend/dnc/src/main/java/com/djjko/dnc/glucose/service/CgmPipelineService.java`](https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/glucose/service/CgmPipelineService.java) (CGM Pipeline), [`apps/backend/dnc/src/main/java/com/djjko/dnc/alert/service/GlucoseAlertService.java`](https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/alert/service/GlucoseAlertService.java) (Glucose Alerts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Mobile Client"]
  node_mobile["Expo App<br/>[index.tsx]"]
  node_authui["Sign-in Screens<br/>[login.tsx]"]
end

subgraph group_identity["Identity &amp; Profile"]
  node_auth["Auth Service<br/>[AuthService.java]"]
  node_userprofile["User Profile<br/>[UserService.java]"]
  node_userdb[("User Records<br/>[User.java]")]
end

subgraph group_glucose["CGM &amp; Alerts"]
  node_cgm["CGM Pipeline"]
  node_dexcomclient["Dexcom Client"]
  node_glucosedb[("Glucose &amp; Sensors<br/>[GlucoseData.java]")]
  node_alerts["Glucose Alerts"]
end

subgraph group_food["Meals &amp; AI"]
  node_meals["Meal Service<br/>[MealService.java]"]
  node_foodanalysis["Food Analysis<br/>[AiFoodService.java]"]
  node_aiserver["AI Server<br/>[main.py]"]
  node_foodmodel["Food Detection<br/>[food_detection.py]"]
  node_prediction["Glucose Prediction"]
  node_mealdb[("Meal Records<br/>[FoodRecord.java]")]
  node_storage["Image Storage"]
  node_guide["AI Food Guide"]
end

subgraph group_insights["Reports &amp; Notifications"]
  node_reports["Report Service<br/>[ReportService.java]"]
  node_notifications["Notifications"]
end

node_person(("User"))
node_api["Spring API"]
node_dexcom["Dexcom API"]
node_gemini["Gemini API"]
node_fcm["Firebase Messaging"]

node_person -->|"uses"| node_mobile
node_mobile -->|"calls API"| node_api
node_person -->|"signs in"| node_authui
node_authui -->|"authenticates"| node_api
node_api -.->|"handles auth"| node_auth
node_auth -->|"reads/writes"| node_userdb
node_api -.->|"serves profile"| node_userprofile
node_userprofile -->|"updates"| node_userdb
node_cgm -->|"requests data"| node_dexcomclient
node_dexcomclient -->|"fetches CGM"| node_dexcom
node_cgm -->|"loads user"| node_userdb
node_cgm -.->|"stores readings"| node_glucosedb
node_cgm -->|"checks readings"| node_alerts
node_alerts -->|"creates notice"| node_notifications
node_alerts -->|"sends push"| node_fcm
node_meals -->|"analyzes meal"| node_foodanalysis
node_foodanalysis -->|"requests analysis"| node_aiserver
node_aiserver -->|"dispatches detection"| node_foodmodel
node_aiserver -->|"dispatches prediction"| node_prediction
node_foodanalysis -->|"persists analysis"| node_mealdb
node_meals -->|"reads/writes"| node_mealdb
node_foodanalysis -.->|"stores image"| node_storage
node_foodanalysis -.->|"queues guide"| node_guide
node_guide -.->|"generates coaching"| node_gemini
node_api -.->|"serves reports"| node_reports
node_reports -->|"aggregates readings"| node_glucosedb
node_person -.->|"views results"| node_mobile

click node_mobile "https://github.com/lazyuns/dnc/blob/main/apps/mobile/app/(tabs)/index.tsx"
click node_authui "https://github.com/lazyuns/dnc/blob/main/apps/mobile/app/(auth)/login.tsx"
click node_api "https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/DncApplication.java"
click node_auth "https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/auth/service/AuthService.java"
click node_userprofile "https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/user/service/UserService.java"
click node_userdb "https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/auth/entity/User.java"
click node_cgm "https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/glucose/service/CgmPipelineService.java"
click node_dexcomclient "https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/glucose/client/DexcomApiClient.java"
click node_glucosedb "https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/glucose/entity/GlucoseData.java"
click node_alerts "https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/alert/service/GlucoseAlertService.java"
click node_meals "https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/meal/service/MealService.java"
click node_foodanalysis "https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/ai/food/service/AiFoodService.java"
click node_aiserver "https://github.com/lazyuns/dnc/blob/main/apps/ai-server/ai/main.py"
click node_foodmodel "https://github.com/lazyuns/dnc/blob/main/apps/ai-server/ai/services/food_detection.py"
click node_prediction "https://github.com/lazyuns/dnc/blob/main/apps/ai-server/ai/services/glucose_prediction.py"
click node_mealdb "https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/meal/domain/FoodRecord.java"
click node_storage "https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/storage/FileStorageService.java"
click node_guide "https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/ai/gemini/service/AiFoodGuideService.java"
click node_reports "https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/report/service/ReportService.java"
click node_notifications "https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/notification/service/UserNotificationService.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_mobile,node_authui,node_person toneBlue
class node_auth,node_userprofile,node_userdb toneAmber
class node_cgm,node_dexcomclient,node_glucosedb,node_alerts,node_api,node_dexcom,node_gemini toneMint
class node_meals,node_foodanalysis,node_aiserver,node_foodmodel,node_prediction,node_mealdb,node_storage,node_guide toneRose
class node_reports,node_notifications,node_fcm toneIndigo
```

## Components

### Mobile Client

- [Expo App](https://github.com/lazyuns/dnc/blob/main/apps/mobile/app/(tabs)/index.tsx): `apps/mobile/app/(tabs)/index.tsx`
- [Sign-in Screens](https://github.com/lazyuns/dnc/blob/main/apps/mobile/app/(auth)/login.tsx): `apps/mobile/app/(auth)/login.tsx`

### Identity & Profile

- [Auth Service](https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/auth/service/AuthService.java): `apps/backend/dnc/src/main/java/com/djjko/dnc/auth/service/AuthService.java`
- [User Profile](https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/user/service/UserService.java): `apps/backend/dnc/src/main/java/com/djjko/dnc/user/service/UserService.java`
- [User Records](https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/auth/entity/User.java): `apps/backend/dnc/src/main/java/com/djjko/dnc/auth/entity/User.java`

### CGM & Alerts

- [CGM Pipeline](https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/glucose/service/CgmPipelineService.java): `apps/backend/dnc/src/main/java/com/djjko/dnc/glucose/service/CgmPipelineService.java`
- [Dexcom Client](https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/glucose/client/DexcomApiClient.java): `apps/backend/dnc/src/main/java/com/djjko/dnc/glucose/client/DexcomApiClient.java`
- [Glucose & Sensors](https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/glucose/entity/GlucoseData.java): `apps/backend/dnc/src/main/java/com/djjko/dnc/glucose/entity/GlucoseData.java`
- [Glucose Alerts](https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/alert/service/GlucoseAlertService.java): `apps/backend/dnc/src/main/java/com/djjko/dnc/alert/service/GlucoseAlertService.java`

### Meals & AI

- [Meal Service](https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/meal/service/MealService.java): `apps/backend/dnc/src/main/java/com/djjko/dnc/meal/service/MealService.java`
- [Food Analysis](https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/ai/food/service/AiFoodService.java): `apps/backend/dnc/src/main/java/com/djjko/dnc/ai/food/service/AiFoodService.java`
- [AI Server](https://github.com/lazyuns/dnc/blob/main/apps/ai-server/ai/main.py): `apps/ai-server/ai/main.py`
- [Food Detection](https://github.com/lazyuns/dnc/blob/main/apps/ai-server/ai/services/food_detection.py): `apps/ai-server/ai/services/food_detection.py`
- [Glucose Prediction](https://github.com/lazyuns/dnc/blob/main/apps/ai-server/ai/services/glucose_prediction.py): `apps/ai-server/ai/services/glucose_prediction.py`
- [Meal Records](https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/meal/domain/FoodRecord.java): `apps/backend/dnc/src/main/java/com/djjko/dnc/meal/domain/FoodRecord.java`
- [Image Storage](https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/storage/FileStorageService.java): `apps/backend/dnc/src/main/java/com/djjko/dnc/storage/FileStorageService.java`
- [AI Food Guide](https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/ai/gemini/service/AiFoodGuideService.java): `apps/backend/dnc/src/main/java/com/djjko/dnc/ai/gemini/service/AiFoodGuideService.java`

### Reports & Notifications

- [Report Service](https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/report/service/ReportService.java): `apps/backend/dnc/src/main/java/com/djjko/dnc/report/service/ReportService.java`
- [Notifications](https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/notification/service/UserNotificationService.java): `apps/backend/dnc/src/main/java/com/djjko/dnc/notification/service/UserNotificationService.java`

### Other components

- **User**
- [Spring API](https://github.com/lazyuns/dnc/blob/main/apps/backend/dnc/src/main/java/com/djjko/dnc/DncApplication.java): `apps/backend/dnc/src/main/java/com/djjko/dnc/DncApplication.java`
- **Dexcom API**
- **Gemini API**
- **Firebase Messaging**

## Connections

- User → Expo App: uses
- Expo App → Spring API: calls API
- User → Sign-in Screens: signs in
- Sign-in Screens → Spring API: authenticates
- Spring API → Auth Service: handles auth
- Auth Service → User Records: reads/writes (evidence: `apps/backend/dnc/src/main/java/com/djjko/dnc/auth/service/AuthService.java`)
- Spring API → User Profile: serves profile
- User Profile → User Records: updates (evidence: `apps/backend/dnc/src/main/java/com/djjko/dnc/user/service/UserService.java`)
- CGM Pipeline → Dexcom Client: requests data (evidence: `apps/backend/dnc/src/main/java/com/djjko/dnc/glucose/service/CgmPipelineService.java`)
- Dexcom Client → Dexcom API: fetches CGM
- CGM Pipeline → User Records: loads user (evidence: `apps/backend/dnc/src/main/java/com/djjko/dnc/glucose/service/CgmPipelineService.java`)
- CGM Pipeline → Glucose & Sensors: stores readings (evidence: `apps/backend/dnc/src/main/java/com/djjko/dnc/glucose/service/CgmPipelineService.java`)
- CGM Pipeline → Glucose Alerts: checks readings (evidence: `apps/backend/dnc/src/main/java/com/djjko/dnc/glucose/service/CgmPipelineService.java`)
- Glucose Alerts → Notifications: creates notice (evidence: `apps/backend/dnc/src/main/java/com/djjko/dnc/alert/service/GlucoseAlertService.java`)
- Glucose Alerts → Firebase Messaging: sends push (evidence: `apps/backend/dnc/src/main/java/com/djjko/dnc/alert/service/GlucoseAlertService.java`)
- Meal Service → Food Analysis: analyzes meal (evidence: `apps/backend/dnc/src/main/java/com/djjko/dnc/meal/service/MealService.java`)
- Food Analysis → AI Server: requests analysis (evidence: `apps/backend/dnc/src/main/java/com/djjko/dnc/ai/food/service/AiFoodService.java`)
- AI Server → Food Detection: dispatches detection (evidence: `apps/ai-server/ai/main.py`)
- AI Server → Glucose Prediction: dispatches prediction (evidence: `apps/ai-server/ai/main.py`)
- Food Analysis → Meal Records: persists analysis (evidence: `apps/backend/dnc/src/main/java/com/djjko/dnc/ai/food/service/AiFoodService.java`)
- Meal Service → Meal Records: reads/writes (evidence: `apps/backend/dnc/src/main/java/com/djjko/dnc/meal/service/MealService.java`)
- Food Analysis → Image Storage: stores image (evidence: `apps/backend/dnc/src/main/java/com/djjko/dnc/ai/food/service/AiFoodService.java`)
- Food Analysis → AI Food Guide: queues guide (evidence: `apps/backend/dnc/src/main/java/com/djjko/dnc/ai/food/service/AiFoodService.java`)
- AI Food Guide → Gemini API: generates coaching
- Spring API → Report Service: serves reports
- Report Service → Glucose & Sensors: aggregates readings (evidence: `apps/backend/dnc/src/main/java/com/djjko/dnc/report/service/ReportService.java`)
- User → Expo App: views results
