1. 프로젝트 소개

1.1 프로젝트 개요

• 프로젝트 명: RICIPI
• 프로젝트 형태: 개인 프로젝트
• 개발 목적: 실사용 서비스 지향
• 프로젝트 기간: 2026.01.14~

1.2 기획 배경

• 기존 레시피 서비스(만 개의 레시피 등)에서 가지는 한계
  • 직접 레시피를 하나하나 골라야 함.
  • 내 상황과 달리 새로운 재료들을 사와야 함.(별도의 수고)

1.3 프로젝트 목표

• 메뉴 선택의 피로↓
• 재료 낭비↓

1.4 프로젝트 소개

• 요리 레시피, 냉장고 관리, 재료/음식 관리 앱.
• 영수증의 사진을 토대로 Text를 인식해서 재료의 유통기한을 기억(따로 수정 가능)
• 기억해둔 유통기한을 기반으로 빠르게 소진해야할 재료를 선정. 냉장고에 있는 재료/음식을 기반으로 소진해야할 재료와 조합하여 만들 만한 음식 등을 추천.
• 사용자가 좋아하는 음식등을 기억하고 비슷한 카테고리의 음식 추천

2. 문제 정의

• 매 식사마다 메뉴 선택의 피로함
• 냉장고의 재료가 낭비
• 레시피가 과잉되게 많음.(음식마다 레시피 다수 존재)

3. 서비스 개요

3.1 핵심 기능

• 남은 재료 기반 활용 레시피 추천
• 메뉴 결정 보조 기능
• 사용자의 취향에 맞춘 레시피 추천

3.2 향후 확장 기능

• 알레르기 / 식단 필터
• AI 추천 및 고도화
• 커뮤니티 기능을 통한 레시피 등록/조회

4. 기술 스택

4.1 Backend

• Java
• Spring Boot
• Spring Data JPA

4.2 Frontend

• Flutter

4.3 Database

4.4 Infra & Tools

• Git / GitHub
• VS Code
• Docker

5. 시스템 아키텍처

5.1 전체 구조

Client ↔ Server 구조 설명

5.2 API 통신 구조

REST API

JSON 기반 통신

5.3 인증 및 보안 설계 (선택)

JWT 인증 방식

토큰 흐름 요약

6. ERD 및 도메인 설계 6.1 도메인 모델링 개요

핵심 도메인 설명

6.2 ERD

사용자

재료

레시피

추천 이력

7. 주요 기능 상세 설명 7.1 레시피 추천 로직

추천 기준

우선순위 정책

7.2 재료 관리 기능

재료 등록

유통기한 관리

7.3 메뉴 결정 흐름

사용자 입력 → 결과 도출 과정

8. API 명세 8.1 인증 API 8.2 레시피 API 8.3 재료 API

(선택) Swagger / Postman 링크

9. 실행 방법 9.1 Backend 실행 ./mvnw spring-boot:run

9.2 Frontend 실행 flutter run

9.3 환경 변수 설정

DB 설정

API URL

10. 트러블슈팅 & 기술적 고민 10.1 기술 선택 이유

Spring Boot 선택 배경

Flutter 선택 이유

10.2 문제 해결 사례

환경 세팅 이슈

성능 / 구조 고민

11. 프로젝트 회고 11.1 잘한 점 11.2 아쉬운 점 11.3 개선 방향
12. 개발자 정보

이름: 김석현

GitHub

기술 블로그 (선택)