본문으로 건너뛰기

도메인

이 문서로 해결할 질문​

  • Mealio의 핵심 엔티티와 관계는 무엇인가요?
  • 어떤 데이터가 PostgreSQL에, 어떤 데이터가 MongoDB에 저장되나요?
  • 추천·챗봇·이벤트가 어떤 도메인과 연결되나요?

저장소 분리 원칙​

저장소ORM담당 데이터
PostgreSQLPrisma정형 도메인 — User, Recipe, Ingredient, 추천 원본 테이블
MongoDBMongoose상태·로그 — Inventory, ChatbotLog, EventLog
Redis—캐시, 세션, 챗봇 스트림

핵심 엔티티 (RDB)​

User​

소셜 로그인 기반 사용자이며, platformName과 platformId로 식별합니다. creditBalance로 챗봇 사용량을 관리합니다.

Recipe / Ingredient​

  • Recipe: 레시피 메타, 조리 절차(instructions JSON), 영양, 이미지를 담습니다.
  • Ingredient: 재료 마스터입니다.
  • RecipeIngredient: 레시피와 재료의 N:M 관계를 표현합니다.
  • RecipeCategory / IngredientCategory: 카테고리 마스터입니다.
  • RecipeEmbedding: 레시피 semantic 검색용 pgvector 인덱스입니다.

UserRecipeRecommendation​

개인화 추천 원본 테이블로, 사용자별 recipeId·rank·score·reason을 저장합니다. Producer API가 이 테이블을 조회하고, Consumer가 이벤트에 따라 갱신합니다.

→ 추천 시스템

상태·로그 도메인 (NoSQL)​

Inventory (inventory)​

사용자별 보유 재료·관심 재료·관심 레시피 ID 목록을 담은 로그인 유저 전용 상태 문서입니다.

ChatbotLog (chatbot_logs)​

LLM 대화 기록이며, 30일 TTL이 적용됩니다.

EventLog (event_logs)​

도메인 이벤트 스트림(recipe.view, ingredient.add 등)을 저장하며, 90일 TTL이 적용됩니다. KPI 롤업·추천 보정의 원본입니다.

→ 이벤트/분석 파이프라인

도메인 관계 요약​

기능별 도메인 매핑​

기능주요 엔티티저장소
소셜 로그인UserPostgreSQL
레시피 검색·상세Recipe, RecipeStatsPostgreSQL + Redis 캐시
보유/관심 재료Inventory, IngredientMongoDB + PostgreSQL
개인화 추천UserRecipeRecommendationPostgreSQL + Redis
챗봇ChatbotLog, User.creditBalance, RecipeEmbeddingMongoDB + PostgreSQL
행동 분석EventLogMongoDB → KPI 롤업

변경 시 참고 경로​

스키마를 변경할 때는 코드·공개 문서·내부 명세를 같은 작업 단위로 갱신합니다.

변경 대상코드 기준
RDB 스키마server/shared/.../schema.prisma
NoSQL 스키마server/shared/.../schemas/
의미·필드 설명데이터 모델

관련 문서​