다크 모드
도메인 용어 사전
주의
이 문서는 팀 전체가 공유하는 기준 용어집입니다.
용어의 의미가 불분명하거나 팀원 간 해석이 다를 때 이 문서를 참조하세요.
새로운 도메인 용어가 추가되면 반드시 이 문서도 함께 업데이트해주세요.
브랜딩 표기 규칙
정보
서비스명은 항상 소문자 truloop으로 표기합니다.
대문자 Truloop, TRULOOP 등은 사용하지 않습니다.
문장 시작이나 제목에서도 소문자를 유지합니다.
- 올바른 표기: truloop, truloop-core, truloop-ios
- 잘못된 표기:
Truloop,TRULOOP,TruLoop
핵심 도메인 용어
| 용어 | 한국어 | 정의 | 관련 용어 | 비고 / 혼동 포인트 |
|---|---|---|---|---|
| User | 사용자 | truloop에 가입한 사람. 프로필, 설정, 미션 등 앱의 기능을 사용하는 주체. | 회원 참여자 | "회원"은 "비회원"과 대비할 때만 사용. 단독으로 지칭할 때는 항상 "사용자". |
| Loop | 룹 | 모임(이벤트)의 최소 단위. 참여자 초대, 일정 조율, 미디어 공유, 리캡 생성까지의 전체 흐름을 포괄한다. | 참여자, 룹 상태 | "그룹"이나 "채팅방"과 다름. 룹은 하나의 모임을 뜻함. |
| LoopCategory | 룹 카테고리 | 룹의 유형을 분류하는 카테고리. 식사(Dining), 음료(Drink), 파티/소셜(Social & Party), 액티비티(Activity), 학습(Learning), 비즈니스(Business), 가족(Family) 등이 있다. | 룹 | 기존에 만들어진 룹에는 카테고리가 없을 수 있음. |
| (참여자) | 참여자 | 룹에 참여하는 모든 사람의 총칭. 회원 참여자와 비회원 참여자를 포함한다. 코드 엔티티가 아닌 상위 개념. | 회원 참여자, 비회원 참여자 | 회원만 지칭할 때는 반드시 "회원 참여자"로 표기. |
| Participant | 회원 참여자 | 룹에 참여하는 가입 사용자. 참여자의 하위 유형. 호스트 여부, 응답 상태, 가능 일정 등의 정보를 갖는다. | 참여자, 룹, 참여자 상태 | 비회원 참여자와 구분 필요. 회원 참여자는 항상 가입된 사용자. |
| Guest Participant | 비회원 참여자 | 앱에 가입하지 않은 상태로 룹에 참여하는 사람. 참여자의 하위 유형. 이름, 전화번호 기반으로 SMS 초대를 받으며, 나중에 회원 가입하면 기존 비회원 기록과 연결된다. | 참여자, 비회원 참여자 요약 | 나중에 회원 가입하면 기존 비회원 기록과 연결됨. |
| GuestParticipantSummary | 비회원 참여자 요약 | 룹 상태를 계산할 때 사용하는 비회원 참여자 통계. 비회원의 수락/대기 수를 요약하여 룹 상태 판단에 활용한다. | 비회원 참여자, 룹 상태 | 기본값은 회원만 있는 룹과 동일하게 동작. |
| Host | 호스트 | 룹을 만든 참여자. 하나의 룹에 호스트는 반드시 1명이다. | 회원 참여자, 룹 | 룹을 만든 참여자가 호스트. |
| Recap | 리캡 | 룹의 미디어를 기반으로 AI가 생성하는 요약 콘텐츠. 제목, 본문, 썸네일 등으로 구성된다. | 룹, 콘텐츠 템플릿 | 내부 시스템에서는 아직 Story로 사용 중. 생성 중 → 완료 → 실패 순서로 진행. |
| RecapCreationHistory | 리캡 생성 이력 | 리캡 생성 시도의 이력 기록. 재시도 횟수, 에러 메시지 등을 추적한다. | 리캡 | 내부 시스템에서는 StoryCreationHistory. |
| Mission | 미션 | 사용자에게 주어지는 보상 미션. 다국어를 지원한다. | 사용자 미션 | 미션별로 보상 포인트가 정해져 있음. |
| UserMission | 사용자 미션 | 사용자별 미션 완료 상태를 추적하는 모델. 미션을 완료하면 완료로 표시된다. | 미션 | |
| Secretary | 비서 | AI 비서 캐릭터. 채팅과 연동되며 다국어 이름/설명을 지원한다. truloop-assistant 서비스가 Secretary의 구현체이다. | 룹, 채팅 | Secretary는 도메인 용어이며, truloop-assistant는 이를 구현하는 서비스. |
| Trigger | 트리거 | 특정 시간 조건에 의해 자동 실행되는 작업. 모임 확정 시 생성되며, 지정 시각에 대상 참여자에게 리마인더를 전달한다. | 룹, AI 비서 | 모임 전날과 당일 아침에 자동 발송. |
| LoopMedia | 룹 미디어 | 룹에 연결된 미디어(사진, 동영상, 포스터, 하이라이트). 미디어 유형으로 구분된다. | 룹, 미디어 유형 | 포스터, 하이라이트, 사진, 동영상, 그룹 유형이 존재. |
| MediaContentType | 미디어 콘텐츠 유형 | 룹 미디어의 콘텐츠 유형. 포스터, 하이라이트, 사진, 동영상, 그룹. | 룹 미디어 | |
| MediaLike | 미디어 좋아요 | 사용자가 룹 미디어에 남긴 좋아요 기록. | 룹 미디어 | |
| MediaBookmark | 미디어 북마크 | 사용자가 룹 미디어에 남긴 북마크 기록. | 룹 미디어 | |
| LoopComment | 룹 댓글 | 룹, 미디어, 리캡에 달리는 댓글. 룹에는 항상 소속되며, 미디어나 리캡에는 선택적으로 연결된다. | 룹, 룹 미디어, 리캡 | 대댓글을 달 수 있음. |
| ContentTemplate | 콘텐츠 템플릿 | AI 콘텐츠 생성에 사용되는 템플릿. 리캡, 하이라이트, 포스터 등의 스타일/톤을 정의한다. | 리캡, 룹 미디어 | 리캡, 하이라이트 기본, 포스터 스타일, 포스터 톤, 하이라이트 스타일, 하이라이트 톤 유형이 있음. |
| CoverSelection | 커버 설정 | 사용자별 룹 커버 커스터마이징 정보. 미디어 또는 템플릿 기반으로 커버를 설정할 수 있다. | 룹, 커버 템플릿 | |
| CoverTemplate | 커버 템플릿 | 룹 커버 이미지 템플릿. 관리자가 CMS에서 등록하며 호스트가 선택한다. | 커버 설정, 커버 상태 | 초안 → 게시됨 → 보관됨 상태 흐름. |
| LoopInviteToken | 룹 초대 토큰 | 룹 초대 링크 생성을 위한 토큰. 만료 시간이 설정되어 있다. | 룹, 비회원 참여자 | |
| LoopView | 룹 조회 필터 | 룹 목록 조회 시 시간 관점 필터. HISTORY(지난 모임), UPCOMING(예정/진행 중), ALL(전체). | 룹 | HISTORY는 날짜가 현재보다 과거인 룹, UPCOMING은 날짜 미정이거나 미래인 룹. |
| Eta | 도착 예정 시간 | 참여자의 도착 예정 시간(ETA). 도착하면 도착 완료 상태로 바뀐다. | 룹, 회원 참여자 | |
| Notification | 알림 | 알림 센터의 알림 모델. 대기 → 발송 완료 → 실패 상태를 가지며 딥링크를 포함할 수 있다. | 룹, 사용자 | |
| UserReferral | 사용자 레퍼럴 | 레퍼럴 코드를 통한 사용자 간 추천 관계. 추천인과 피추천인을 연결한다. | 사용자 | |
| Report | 신고 | 사용자가 룹이나 다른 사용자를 신고하는 기능. 신고 사유를 포함하며, 접수 후 검토 과정을 거친다. | 사용자, 룹 | 신고 대상은 룹(LOOP) 또는 사용자(USER). |
| UserBlock | 사용자 차단 | 사용자 간 차단 관계. 한 방향으로만 작동하며, 차단한 쪽에서 차단당한 사용자를 볼 수 없다. | 사용자 | |
| RecapLike | 리캡 좋아요 | 사용자가 리캡에 남긴 좋아요 기록. | 리캡 | 내부 시스템에서는 StoryLike. |
| LPY | 루피 | truloop의 가상 화폐 단위(Loop Points). 미션 완료 등의 보상으로 지급된다. | 미션, 사용자 미션 | "루피"로 읽음. |
정보
용어 선택 가이드
- 앱 주체를 지칭할 때: "사용자" (
유저,회원단독 사용 금지) - 비회원과 대비할 때: "회원" / "비회원" (예: "회원 참여자", "비회원 참여자")
- 룹에 참여하는 모든 사람: "참여자" (회원 + 비회원 포함 총칭)
- 룹에 참여하는 가입 사용자만: "회원 참여자" ("참여자" 단독 사용 시 비회원 포함으로 해석됨)
게스트: 사용 금지. "비회원" 또는 "비회원 참여자"로 표기참석자: 사용 금지. "참여자"로 표기- 유저네임: 허용 (username의 한국어 복합어로 정착)
비즈니스 상태 용어
| 용어 | 한국어 | 정의 | 관련 용어 | 비고 / 혼동 포인트 |
|---|---|---|---|---|
| LoopStatus | 룹 상태 | 룹의 현재 상태. 만남 날짜와 참여자 응답 상태로부터 계산된다. | 룹, 참여자 상태 | 저장되지 않고 매번 계산됨. |
| WAITING | 대기 중 | 회원 참여자가 호스트 1명뿐이고 비회원 참여자도 없는 상태. 초대를 기다리는 단계. | 룹 상태 | 비회원 참여자가 1명이라도 있으면 COLLECTING으로 전환. |
| COLLECTING | 조율 중 | 참여자에게 가능 일정을 조율 중인 상태. 아직 응답하지 않은 참여자가 있다. | 룹 상태 | 날짜가 미정이고 아직 응답하지 않은 참여자가 있는 상태. |
| COLLECTED | 조율 완료 | 모든 참여자가 응답을 마치고 1명 이상이 참여 확정한 상태, 또는 응답 마감 시각이 경과한 상태. 참여자가 최종 일정을 확정할 수 있다. | 룹 상태 | 모든 참여자가 거절하면 "조율 완료"가 아닌 "조율 중" 상태로 유지. 응답 마감 시각이 경과하면 미응답 참여자가 있어도 조율 완료. |
| CONFIRMED | 확정됨 | 만남 날짜가 정해진 상태. 가장 우선순위가 높은 상태이다. | 룹 상태 | 만남 날짜가 정해진 상태. |
| ParticipantStatus | 참여자 상태 | 일정 조율에서의 참여자 응답 상태. PENDING(응답 대기), ACCEPTED(참여 확정), REJECTED(거절). | 회원 참여자, 룹 상태 | 비회원 참여자도 동일한 3가지 상태를 가짐. |
| PENDING | 응답 대기 | 참여자가 아직 초대에 응답하지 않은 상태. | 참여자 상태 | |
| ACCEPTED | 참여 확정 | 참여자가 초대를 수락하고 가능 일정을 제출한 상태. | 참여자 상태 | |
| REJECTED | 거절 | 참여자가 초대를 거절한 상태. | 참여자 상태 | |
| RecapStatus | 리캡 상태 | 리캡의 생성 상태. PROCESSING(생성 중), COMPLETED(완료), FAILED(실패). | 리캡 | 내부 시스템에서는 아직 StoryStatus로 사용 중. |
| CoverStatus | 커버 상태 | 커버 템플릿의 게시 상태. DRAFT(초안) → PUBLISHED(게시됨) → ARCHIVED(보관됨). 보관됨에서 게시됨으로 재게시 가능. | 커버 템플릿 | |
| RecapCreationStatus | 리캡 생성 시도 상태 | 리캡 생성 이력의 진행 상태. PENDING(대기), IN_PROGRESS(진행 중), COMPLETED(완료), FAILED(실패). | 리캡 생성 이력 | RecapStatus(리캡 자체 상태)와 별개. 내부 시스템에서는 StoryCreationStatus. |
| ReportStatus | 신고 상태 | 신고의 처리 상태. PENDING(접수됨), REVIEWING(검토 중), RESOLVED(처리 완료), DISMISSED(기각됨). | 신고 | |
| NotificationStatus | 알림 상태 | 알림의 발송 상태. PENDING(대기), SENT(발송 완료), FAILED(실패). | 알림 |
엔티티 관계 다이어그램
코드명 매핑
도메인 용어와 코드/DB에서 실제 사용하는 이름이 다른 경우를 정리합니다.
| 도메인 용어 (위키) | 코드/DB 이름 | 비고 |
|---|---|---|
| Recap | Story | 리브랜딩됨. 코드 전환 진행 중 |
| RecapCreationHistory | StoryCreationHistory | Recap과 동일 사유 |
| RecapStatus | StoryStatus | Recap과 동일 사유 |
| RecapCreationStatus | StoryCreationStatus | Recap과 동일 사유 |
| RecapLike | StoryLike | Recap과 동일 사유 |
| Secretary | Secretary | 동일. truloop-assistant 서비스가 Secretary의 구현체 |
| Trigger | trigger-dispatcher | truloop-functions 레포에서 관리 |
| Loop 상태 (LoopStatus) | 계산 값 (DB 미저장) | 날짜·참여자 응답으로 런타임 계산 |
주의
새로운 코드명-도메인 용어 불일치가 발생하면 이 테이블을 업데이트하세요.
장기적으로는 코드명을 도메인 용어에 맞추는 것을 권장합니다.
Deprecated 용어
더 이상 사용하지 않는 용어 목록입니다. 기존 코드/문서에 남아 있을 수 있으나, 새 문서 작성 시에는 현재 용어를 사용하세요.
| Deprecated 용어 | 현재 용어 | 변경 시점 | 사유 |
|---|---|---|---|
| Story | Recap | 2026-03 | 사용자 관점의 "요약/회고" 의미를 더 잘 전달 |
| StoryCreationHistory | RecapCreationHistory | 2026-03 | Story → Recap 변경에 따름 |
| StoryStatus | RecapStatus | 2026-03 | Story → Recap 변경에 따름 |
| StoryCreationStatus | RecapCreationStatus | 2026-03 | Story → Recap 변경에 따름 |
| StoryLike | RecapLike | 2026-03 | Story → Recap 변경에 따름 |
| ShortForm | (폐기) | 2026-03 | 초기 기획 기능(사진 여러장 → AI 숏폼 영상 생성). 우선순위 변경으로 폐기 |
| 게스트 | 비회원 또는 비회원 참여자 | 2026-03 | 용어 혼란 방지. "비회원" 또는 "비회원 참여자"로 통일 |
| 유저 | 사용자 | 2026-03 | "사용자"로 통일. 단, "유저네임"은 username의 한국어 복합어로 허용 |
| 참석자 | 참여자 | 2026-03 | "참여자"로 통일 |
변경 이력
| 날짜 | 변경 내용 |
|---|---|
| 2026-03-11 | COLLECTED 정의에 응답 마감 시각 경과 조건 추가 |
| 2026-03-11 | 용어 표준화: User/사용자, 참여자(총칭) 정의 추가. 게스트/유저/참석자 폐기. 용어 선택 가이드 신설 |
| 2026-03-10 | Trigger 용어, 코드명 매핑, ER 다이어그램 관계 복원 (이전 사이클에서 truloop-functions 미sync로 인한 오판 수정) |
| 2026-03-10 | LoopCategory 영어명 병기. Trigger 용어 및 ER 다이어그램 관계 삭제 (소스 코드에 미구현 확인) |
| 2026-03-10 | 코드 대조를 통한 용어 검증 및 보완: Report, UserBlock, MediaLike, MediaBookmark, RecapLike, RecapCreationStatus, ReportStatus 추가. WAITING/LoopView 정의 정확도 개선. ER 다이어그램 및 코드명 매핑 보강 |
| 2026-03-10 | ShortForm을 핵심 도메인 용어에서 Deprecated로 이동 (초기 기획 기능, 우선순위 변경으로 폐기) |