Skip to content

Repository files navigation

🍽️ URISIK

알레르기 가족 모두가 안전하게,

한 식탁에서 즐겁게 먹을 수 있도록 돕는 맞춤형 식단 관리 서비스

1

📌 Project Overview

URISIK은 가족 구성원의 서로 다른 알레르기를 고려하여
레시피별 알레르기 위험을 자동 판별하고,
필요 시 식감과 맛이 유사한 대체 재료로 레시피를 자동 변형/생성하는
AI 기반 맞춤형 식단 관리 플랫폼입니다.


🎯 Problem & Solution

❗ Problem

  • 가족 구성원마다 서로 다른 알레르기로 인해 식단 선택이 복잡함
  • 레시피를 고를 때마다 성분을 직접 확인해야 하는 반복 작업
  • 알레르기 재료를 제외하면 선택 가능한 메뉴가 급격히 줄어듦
  • 대체 가능한 식재료와 조리법에 대한 신뢰 가능한 정보 부족

✅ Solution

  • 가족방 단위 알레르기 정보 통합 관리
  • 레시피별 알레르기 위험 자동 판별
  • 단순 제외가 아닌, 식감·맛이 유사한 대체재 기반 레시피 자동 생성
  • 안전성 + 선호도 + 사용자 행동 데이터를 결합한 추천 로직

✨ Key Features

  • 🛡️ 알레르기 자동 판별 (가족 구성원별 알레르기 기반 위험 계산)
  • 🔁 대체 레시피 제공 (대체 재료 + 조리 단계 자동 변형)
  • 안전 / 별점 / 위시리스트 기반 사용자 맞춤 추천
  • 👨‍👩‍👧 가족 단위 알레르기 관리 (가족방 단위 프로필/선호 관리)
  • 📅 알레르기 고려 주간 식단 생성
  • ❤️ 위시리스트 기능
  • 📝 리뷰 및 평점 기반 추천 고도화

🚀 Technical Highlights

  • 🤖 AI 기반 레시피 변형 생성 및 식단 생성

    • 알레르기·중복 제한이 반영된 후보군 기반 생성 파이프라인 설계
    • 알레르기 위험 재료 탐지 → 대체 재료 추천 → 조리 단계 자동 변형 파이프라인 설계
    • 프롬프트 → AI 호출 → 파싱 → 도메인 검증 → fallback으로 이어지는 단계적 책임 분리 로직 설계
      • JSON 스키마 강제 및 도메인 검증기 분리를 통한 안정적인 AI 응답 파싱
      • AI 타임아웃 관리 및 명시적 예외 전파·fallback 로직 설계
  • 🧵 비동기 처리로 UX 개선

    • 이미지 생성 등 비용 큰 작업을 @Async로 분리
    • 사용자 체감 응답 속도 개선
  • ☁️ 운영 환경 배포 자동화

    • Docker + GitHub Actions + Nginx 기반 CI/CD
  • 📊 성능 측정 및 병목 분석 기반 개선

    • k6 기반 p95 기준 성능 측정
    • stage / candidate / assign 로그 분리로 AI generation 병목 구조적 식별
    • 프롬프트·후보군·temperature 최적화를 실험하고 코드 레벨에 반영

📱 Screen Preview

step1 step2 step3 step4

🛠 Tech Stack

🛠 Backend & Framework

🗄 Database

☁ Cloud & Infrastructure

🚀 CI/CD & Deployment

🧪 Testing & Performance


🏗 Architecture

ChatGPT Image 2026년 2월 12일 오후 08_09_04

🗄 ERD

URISIK (9)

📖 API Documentation

프로젝트의 전체 API 명세는 Notion을 통해 관리하고 있습니다.

🔗 Documentation


📂 Directory Structure

📦 src/main/java/com/urisik/backend
 ├──📁 domain          # 핵심 비즈니스 로직
 │   ├── 📁 allergy          # 알레르기 관련 패키지
 │   ├── 📁 familyroom       # 가족방 관련 패키지
 │   ├── 📁 mealplan         # 식단 계획 관련 패키지
 │   ├── 📁 member           # 사용자 관련 패키지
 │   ├── 📁 notification     # 알림 관련 패키지
 │   ├── 📁 recipe           # 레시피 관련 패키지
 │   ├── 📁 recommendation   # 추천 관련 패키지
 │   ├── 📁 review           # 리뷰 관련 패키지
 │   └── 📁 search           # 인기 검색어 관련 패키지
 │ 
 ├── 📁 global          # 공통 모듈
 │   ├── 📁 ai               # AI 연동 관련 패키지
 │   ├── 📁 apiPayload       # 공통 응답/에러/예외 처리 관련 패키지
 │   ├── 📁 auth             # 인증/인가 관련 패키지
 │   ├── 📁 config           # 공통 설정 정의 관련 패키지
 │   ├── 📁 external         # AWS S3 연동 관련 패키지
 │   ├── 📁 util             # 공통 유틸리티 관련 패키지
 │   └── 📄 BaseEntity.java  # 생성/수정 시간 자동 관리
 │ 
 └── 📄 UrisikBackendApplication.java


Devloper

서정춘 이원준 이은채 허건우
서정춘 이원준 이은채 허건우
BE BE BE BE
GitHub GitHub GitHub GitHub

About

가족 구성원의 서로 다른 알레르기를 고려하여 대체 레시피를 제공해주는 AI 기반 맞춤형 식단 관리 플랫폼

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages