How kakaotechcampus-4/ktc4-chungnam-5 works
든든지기는 GLP-1 투약자의 끼니 사진을 평가하고 코칭하는 Android 우선 서비스입니다. 사용자는 식사를 등록하고, 백엔드는 비동기 분석을 접수해 워커가 AI 음식 인식을 호출합니다. 사용자가 음식을 확인하면 백엔드는 투약 단계별 기준으로 Q/Q/S 점수를 산출하고 AI가 점수를 문장화합니다. API와 저장·큐 계층, 영양·식사 상태 및 챗봇·안전 기능도 표시했습니다. 관계는 README와 발췌·SOURCE INDEX로 확인되는 것만 연결했습니다. Flutter 화면 소스는 트리에 없어 앱 내부 흐름은 표현하지 않았습니다.
Main entry points: main.py AI HTTP API · meal.py 식사 처리 · session.py PostgreSQL · loop.py 워커 루프
Components 21
사용자 앱
- Android 앱 진입
frontend/android/app/src/main/kotlin/com/ktc4/chungnam5/frontend/MainActivity.kt
백엔드 API
- 공개 API
backend/app/api/v1/endpoints - 식사 처리
backend/app/services/meal.py - Q/Q/S 규칙 채점
backend/app/services/evaluation - 코칭·요약 서비스
backend/app/services
비동기 처리
AI 서비스
도메인 데이터
- PostgreSQL
backend/app/db/session.py - 식사·음식 데이터
backend/app/models/meal.py - 피드백 데이터
backend/app/models/feedback.py - 투약 데이터
backend/app/models/medication.py
Other components
- 식사 사용자
Connections 20
- 식사 사용자 → Android 앱 진입: 등록·조회
- Android 앱 진입 → 공개 API: API 요청
- 공개 API → 식사 처리: 호출
- 식사 처리 → 작업 큐: 작업 등록
backend/app/services/meal.py - 식사 처리 → 사진 저장소: 사진 저장
backend/app/services/meal.py - 워커 루프 → 작업 큐: 작업 가져오기
backend/app/worker/loop.py - 워커 루프 → 작업 핸들러: 작업 전달
- 워커 루프 → AI 클라이언트: AI 호출
backend/app/worker/loop.py - AI 클라이언트 → AI HTTP API: HTTP 요청
- AI HTTP API → 음식 인식: 호출
ai/app/main.py - AI HTTP API → 짧은 피드백: 호출
ai/app/main.py - AI HTTP API → 대화 코치: 호출
ai/app/main.py - AI HTTP API → 안전 검사: 검사
ai/app/main.py - AI HTTP API → AI 계약 스키마: 검증
ai/app/main.py - 식사 처리 → Q/Q/S 규칙 채점: 채점 요청
- 식사 처리 → PostgreSQL: 세션 사용
backend/app/services/meal.py - PostgreSQL → 식사·음식 데이터: 영속화
- PostgreSQL → 피드백 데이터: 영속화
- PostgreSQL → 투약 데이터: 영속화
- 코칭·요약 서비스 → PostgreSQL: 세션 사용