123

Tables (16)

Communications

  • message_id — BIGINT — Primary key — 메시지 고유 ID
  • sender_user_id — INT — NOT NULL — 메시지 발신자 ID
  • receiver_user_id — INT — 메시지 수신자 ID (1:1 채팅용)
  • team_id — INT — 팀 채팅 ID
  • channel_id — INT — 커뮤니티 채널 ID
  • content — TEXT — NOT NULL — 메시지 내용
  • message_type — ENUM('chat', 'notice', 'promotion', 'inquiry') — NOT NULL — 메시지 유형
  • sent_at — DATETIME — 메시지 전송 시간

Community_Channels

  • channel_id — INT — Primary key — 채널 고유 ID
  • channel_name — VARCHAR(100) — NOT NULL — 채널 이름
  • channel_type — ENUM('regional', 'topic', 'interest') — NOT NULL — 채널 유형 (지역별, 주제별, 관심사별)
  • region_info — VARCHAR(100) — 지역 정보 (지역 채널용)
  • topic_info — VARCHAR(100) — 주제 정보 (주제 채널용)
  • description — TEXT — 채널 설명
  • created_at — DATETIME — 채널 생성 시간

Logs

  • log_id — BIGINT — Primary key — 로그 고유 ID
  • user_id — INT — 관련 사용자 ID (없을 수 있음)
  • event_type — VARCHAR(100) — NOT NULL — 이벤트 유형 (예: login, quest_start, reward_granted, content_upload)
  • event_detail — TEXT — 이벤트 상세 내용
  • ip_address — VARCHAR(45) — 접속 IP 주소
  • timestamp — DATETIME — 로그 발생 시간

Merchant_Products

  • product_id — INT — Primary key — 상품 고유 ID
  • merchant_id — INT — NOT NULL — 관련 가맹점 ID
  • name — VARCHAR(255) — NOT NULL — 상품명
  • description — TEXT — 상품 상세 설명
  • price — DECIMAL(10, 2) — 상품 가격
  • stock — INT — 재고 수량
  • image_url — VARCHAR(500) — 상품 이미지 URL
  • reward_type_id — INT — 리워드로 제공되는 경우 리워드 종류 ID
  • expiration_date — DATETIME — 상품/쿠폰 만료일
  • created_at — DATETIME — 상품 등록 시간
  • updated_at — DATETIME — 마지막 업데이트 시간

Merchants

  • merchant_id — INT — Primary key — 가맹점 고유 ID
  • user_id — INT — 가맹점 담당자 사용자 ID
  • name — VARCHAR(255) — NOT NULL — 가맹점명 또는 기업명
  • address — VARCHAR(500) — 주소
  • phone_number — VARCHAR(20) — 대표 전화번호
  • category — VARCHAR(100) — 업종 카테고리 (예: 식당, 카페, 문화시설)
  • description — TEXT — 상세 설명
  • approval_status — ENUM('pending', 'approved', 'rejected') — 가맹점 승인 상태
  • created_at — DATETIME — 등록 시간
  • updated_at — DATETIME — 마지막 업데이트 시간

Notifications

  • notification_id — BIGINT — Primary key — 알림 고유 ID
  • user_id — INT — NOT NULL — 수신 사용자 ID
  • type — ENUM('quest_nearby', 'event', 'reward_expiration', 'message', 'announcement') — NOT NULL — 알림 유형
  • title — VARCHAR(255) — NOT NULL — 알림 제목
  • content — TEXT — NOT NULL — 알림 내용
  • sent_at — DATETIME — 알림 발송 시간
  • read_at — DATETIME — 알림 확인 시간
  • is_read — BOOLEAN — 읽음 여부
  • push_id — VARCHAR(255) — FCM 등 푸시 알림 서비스 ID

Quest_Missions

  • mission_id — INT — Primary key — 미션 고유 ID
  • quest_id — INT — NOT NULL — 관련 퀘스트 ID
  • mission_order — INT — NOT NULL — 미션 순서
  • description — TEXT — NOT NULL — 미션 내용
  • type — ENUM('gps_checkin', 'photo_upload', 'qr_scan', 'beacon_scan', 'text_input', 'voice_record') — NOT NULL — 미션 유형 (GPS 체크인, 사진 업로드, QR 스캔, 비콘 스캔 등)
  • location_lat — DECIMAL(10, 7) — 미션 수행 장소 위도 (GPS 미션용)
  • location_lng — DECIMAL(10, 7) — 미션 수행 장소 경도 (GPS 미션용)
  • qr_beacon_id — VARCHAR(255) — QR/Beacon ID (QR/Beacon 미션용)
  • required_image_count — INT — 필수 사진 개수 (사진 업로드 미션용)
  • expected_answer — TEXT — 예상 답변 (텍스트/음성 미션용)
  • created_at — DATETIME — 미션 생성 시간

Quest_Participations

  • participation_id — INT — Primary key — 참여 고유 ID
  • user_id — INT — NOT NULL — 참여자 ID
  • quest_id — INT — NOT NULL — 참여 퀘스트 ID
  • start_at — DATETIME — 퀘스트 시작 시간
  • end_at — DATETIME — 퀘스트 종료 시간
  • status — ENUM('in_progress', 'completed', 'failed', 'paused') — 퀘스트 진행 상태
  • score — DECIMAL(5, 2) — 퀘스트 수행 점수/평가
  • progress_details — JSON — 퀘스트 진행 상황 상세 (미션별 완료 여부 등)
  • last_updated_at — DATETIME — 마지막 업데이트 시간

Quest_Teams

  • team_id — INT — Primary key — 팀 고유 ID
  • quest_id — INT — NOT NULL — 관련 퀘스트 ID
  • team_name — VARCHAR(100) — NOT NULL — 팀 이름
  • created_at — DATETIME — 팀 생성 시간

Quests

  • quest_id — INT — Primary key — 퀘스트 고유 ID
  • team_id — INT — Foreign key → Quest_Teams.team_id — 팀 고유 ID
  • user_id (user_id2) — INT — Foreign key → Users.user_id — 사용자 고유 ID
  • creator_user_id — INT — 퀘스트 생성자 ID (지자체, 소상공인, 시스템 관리자 등)
  • ai_generated — BOOLEAN — AI 자동 생성 여부
  • title — VARCHAR(255) — NOT NULL — 퀘스트 제목
  • description — TEXT — NOT NULL — 퀘스트 상세 설명
  • type — ENUM('game', 'exploration', 'experience', 'volunteer', 'main', 'sub') — NOT NULL — 퀘스트 유형 (게임형, 탐방형, 체험형, 봉사형, 메인, 서브)
  • difficulty — ENUM('easy', 'medium', 'hard') — 퀘스트 난이도
  • min_participants — INT — 최소 참여 인원
  • max_participants — INT — 최대 참여 인원
  • estimated_duration_minutes — INT — 예상 소요 시간 (분)
  • start_date — DATETIME — NOT NULL — 퀘스트 시작 일시
  • end_date — DATETIME — NOT NULL — 퀘스트 종료 일시
  • status — ENUM('active', 'inactive', 'completed', 'scheduled', 'draft') — 퀘스트 상태
  • reusability — ENUM('none', 'template', 'reusable') — 재사용 가능 여부 (템플릿, 재사용)
  • created_at — DATETIME — 퀘스트 생성 시간
  • updated_at — DATETIME — 마지막 업데이트 시간

Region_Stories

  • story_id — INT — Primary key — 지역 스토리 고유 ID
  • user_id — INT — NOT NULL — 스토리 입력 사용자 ID (주민)
  • story_text — TEXT — 텍스트 스토리 내용
  • audio_url — VARCHAR(500) — 음성 스토리 파일 URL
  • image_url — VARCHAR(500) — 이미지 스토리 파일 URL
  • submission_at — DATETIME — 스토리 제출 시간
  • approval_status — ENUM('pending', 'approved', 'rejected') — 검수 상태
  • reward_status — ENUM('pending', 'granted') — 보상 지급 상태
  • reward_amount — DECIMAL(10, 2) — 지급된 보상 금액 (포인트/지역화폐)

Reward_Types

  • reward_type_id — INT — Primary key — 리워드 종류 고유 ID
  • name — VARCHAR(100) — NOT NULL — 리워드 이름 (포인트, 쿠폰, 지역 특산물, 지역화폐, NFT 배지 등)
  • value_type — ENUM('point', 'amount', 'item', 'nft') — NOT NULL — 가치 유형 (포인트, 금액, 상품, NFT)
  • description — TEXT — 리워드 종류에 대한 설명

Team_Members

  • user_id — INT — Primary key — NOT NULL — 팀원 사용자 ID
  • team_id (team_id2) — INT — Foreign key → Quest_Teams.team_id — 팀 고유 ID
  • role_in_team — VARCHAR(50) — 팀 내 역할 (예: 리더, 멤버)
  • joined_at — DATETIME — 팀 합류 시간

User_Generated_Content

  • ugc_id — BIGINT — Primary key — UGC 고유 ID
  • user_id — INT — NOT NULL — 콘텐츠 생성 사용자 ID
  • content_type — ENUM('text', 'image', 'video', 'audio', 'review', 'tip', 'post') — NOT NULL — 콘텐츠 유형
  • content_url — VARCHAR(500) — 콘텐츠 파일 URL (이미지, 비디오, 오디오용)
  • content_text — TEXT — 텍스트 내용 (리뷰, 팁, 게시글용)
  • associated_quest_id — INT — 연관된 퀘스트 ID (퀘스트 후기 등)
  • associated_merchant_id — INT — 연관된 가맹점 ID (상점 리뷰 등)
  • submission_at — DATETIME — 콘텐츠 제출 시간
  • approval_status — ENUM('pending', 'approved', 'rejected') — 콘텐츠 검수 상태
  • rating — DECIMAL(2, 1) — 평점 (리뷰용)
  • likes_count — INT — 좋아요 수

User_Rewards

  • user_reward_id — INT — Primary key — 사용자 리워드 고유 ID
  • user_id — INT — NOT NULL — 리워드 획득 사용자 ID
  • reward_type_id — INT — NOT NULL — 리워드 종류 ID
  • quest_id — INT — 리워드 획득에 연결된 퀘스트 ID
  • amount — DECIMAL(10, 2) — 획득 금액/포인트/수량
  • earned_at — DATETIME — 리워드 획득 시간
  • expiry_date — DATETIME — 리워드 만료일
  • status — ENUM('earned', 'used', 'expired', 'cancelled') — 리워드 상태 (적립, 사용, 만료, 취소)
  • transaction_id — VARCHAR(255) — 지역화폐 연동 시 거래 ID

Users

  • user_id — INT — Primary key — 사용자 고유 ID
  • email — VARCHAR(255) — NOT NULL — 이메일 (로그인 ID)
  • password_hash — VARCHAR(255) — NOT NULL — 비밀번호 (해시값)
  • social_login_id — VARCHAR(255) — 소셜 로그인 ID (SNS OAuth용)
  • phone_number — VARCHAR(20) — 휴대폰 번호 (인증용)
  • role — ENUM('resident', 'visitor', 'gov_admin', 'biz_manager', 'sme_owner', 'sys_admin') — NOT NULL — 사용자 역할 (주민, 방문자, 지자체 관리자, 기업 담당자, 소상공인, 시스템 설계자)
  • nickname — VARCHAR(50) — NOT NULL — 닉네임
  • profile_image_url — VARCHAR(500) — 프로필 이미지 URL
  • onboarding_status — VARCHAR(50) — 온보딩 진행 상태
  • device_id — VARCHAR(255) — 사용자 단말 고유 ID (푸시 알림 등)
  • last_login_ip — VARCHAR(45) — 마지막 로그인 IP 주소
  • last_login_at — DATETIME — 마지막 로그인 시간
  • created_at — DATETIME — 계정 생성 시간
  • updated_at — DATETIME — 마지막 업데이트 시간