Gather

테이블 (20)

Refresh Token (refresh_token)

  • 리프레시 토큰 ID (id) — BIGINT — 기본 키 — NOT NULL — Auto Increment
  • 유저 ID (user_id) — BIGINT — 외래 키 → 회원.id — NOT NULL — users.id 참조
  • 토큰 해시 (token_hash) — VARCHAR(255) — NOT NULL — SHA-256, 받은 토큰을 해시해서 그 값으로 조회
  • 만료일시 (expires_at) — DATETIME — NOT NULL — Refresh Token 만료 시간
  • 폐기 여부 (revoked) — BOOLEAN — NOT NULL
  • 생성일시 (created_at) — DATETIME — NOT NULL — 토큰 생성 시간
  • 수정일시 (updated_at) — DATETIME — 토큰 폐기/갱신 시간

공고검색기록 (posting_search_log)

  • id — BIGINT — 기본 키 — NOT NULL
  • 키워드 (keyword) — VARCHAR(100) — NOT NULL
  • 검색일자 (searched_at) — DATETIME(6) — NOT NULL

공고추천검색어 (posting_recommended_keyword)

  • id — BIGINT — 기본 키 — NOT NULL
  • 키워드 (keyword) — VARCHAR(50) — NOT NULL
  • 가중치 (score) — INT — NOT NULL
  • 수정일 (uodated_at) — DATETIME(6) — NOT NULL

데이터 모니터링용 테이블 (api_sync_log)

  • id — BIGINT — 기본 키 — NOT NULL
  • 동기화일시 (sync_time) — DATETIME — NOT NULL
  • 상태 (status) — VARCHAR — NOT NULL — 'SUCCESS / FAIL'
  • 추가된공고 (upsert_count) — INT — NOT NULL — 새롭게 추가되거나 갱신된 공고의 개수
  • 에러 (error_message) — TEXT

모임 (meeting)

  • id — BIGINT — 기본 키 — NOT NULL
  • 모임명 (name) — VARCHAR — NOT NULL
  • 설명 (description) — VARCHAR
  • 최대인원 (max_member) — BIGINT — NOT NULL
  • 마감일 (deadline) — DATETIME
  • 메모 (memo) — VARCHAR
  • 생성일시 (created_at) — DATETIME
  • 카테고리 ID (category_id) — BIGINT — 외래 키 → 카테고리.id — NOT NULL
  • 지역 ID (region_id) — BIGINT — 외래 키 → 활동 지역.id — NOT NULL
  • 호스트 ID (host_id) — BIGINT — 외래 키 → 회원.id — NOT NULL — users.id 참조
  • 현재인원 (current_member_count) — INT
  • 신청 조건 (participation_condition) — VARCHAR
  • 모임 상태 (status) — VARCHAR
  • 수정일 (updated_at) — DATETIME
  • 삭제일 (deleted_at) — DATETIME
  • 봉사공고ID (volunteer_posting_id) — BIGINT — 외래 키 → 봉사 공고.id
  • 활동시작날짜 (activity_start_at) — DATETIME
  • 활동종료날짜 (activity_end_at) — DATETIME

모임 검색 이력 (meeting_search_history)

  • id — BIGINT — 기본 키 — NOT NULL
  • 검색어 (keyword) — VARCHAR
  • 검색일 (searched_at) — DATETIME
  • 유저ID (user_id) — BIGINT — 외래 키 → 회원.id — NOT NULL

모임 게시글 (post)

  • id — BIGINT — 기본 키 — NOT NULL
  • 유저 ID (user_id) — BIGINT — 외래 키 → 회원.id — NOT NULL
  • 모임 ID (meeting_id) — BIGINT — 외래 키 → 모임.id — NOT NULL
  • 게시글제목 (title) — VARCHAR — NOT NULL
  • 게시글내용 (content) — TEXT — NOT NULL
  • 등록시기 (created_at) — DATETIME
  • 삭제시기 (deleted_at) — DATETIME
  • 수정시기 (updated_at) — DATETIME
  • 유형 (type) — VARCHAR — NOT NULL — NOTICE / REVIEW / RECRUIT / FREE
  • 모집공고의 정원 (recruit_capacity) — INT — RECRUIT 유형일 때만
  • 좋아요 수 (like_count) — INT
  • 댓글 수 (comment_count) — INT
  • Key (Key2) — 외래 키 — NOT NULL

모임 멤버 (meeting_member)

  • id — BIGINT — 기본 키 — NOT NULL
  • 역할 (role) — VARCHAR — NOT NULL — LEADER/MEMBER
  • 참여일시 (joined_at) — DATETIME — NOT NULL
  • 유저 ID (user_id) — BIGINT — 외래 키 → 회원.id — NOT NULL — (meeting_id, user_id) 복합 UNIQUE
  • 모임 ID (meeting_id) — BIGINT — 외래 키 → 모임.id — NOT NULL
  • 상태 (status) — VARCHAR — PENDING/APPROVED
  • 생성일시 (created_at) — DATETIME
  • 수정일시 (updated_at) — DATETIME
  • Key (Key2) — 외래 키 — NOT NULL

모임 북마크 (meeting_bookmark)

  • id — BIGINT — 기본 키 — NOT NULL
  • 북마크 생성일 (created_at) — DATETIME
  • 유저ID (user_id) — BIGINT — 외래 키 → 회원.id — NOT NULL
  • 모임ID (meeting_id) — BIGINT — 외래 키 → 모임.id — NOT NULL
  • Key (Key2) — 외래 키 — NOT NULL

봉사 공고 (volunteer_posting)

  • id — BIGINT — 기본 키 — NOT NULL
  • 외부공고ID (ext_id) — VARCHAR — 1365 API 원본 공고 ID (중복적재 방지용)유니크
  • 제목 (title) — VARCHAR — NOT NULL — 봉사제목
  • 상태 (status) — VARCHAR — NOT NULL — 모집상태 (모집중/마감 등)
  • 내용 (content) — TEXT — 내용
  • 모집기관 (recruit_org) — VARCHAR — 모집기관
  • 등록기관 (register_org) — VARCHAR — 등록기관
  • 활동일 (activity_date) — DATE — NOT NULL — 활동일
  • 봉사시작일자 (act_start_date) — DATE — 봉사시작일자
  • 봉사종료일자 (act_end_date) — DATE — 봉사종료일자
  • 봉사시작시간 (act_start_time) — VARCHAR — 봉사시작시간 (HH:mm)
  • 봉사종료시간 (act_end_time) — VARCHAR — 봉사종료시간 (HH:mm)
  • 모집시작일 (notice_start_date) — DATE — 모집시작일
  • 모집종료일 (notice_end_date) — DATE — 모집종료일
  • 활동요일 (act_wkdy) — VARCHAR — 활동요일
  • 모집인원 (recruit_count) — INT — 모집인원
  • 신청인원수 (applicant_count) — INT — 신청인원수
  • 성인가능여부 (is_adult) — BOOLEAN — 성인가능여부
  • 청소년가능여부 (is_teen) — BOOLEAN — 청소년가능여부
  • 단체가능여부 (is_group) — BOOLEAN — 단체가능여부
  • 활성화여부 (is_active) — BOOLEAN — 공고 삭제시 404나 null이 뜨지 않게 하기 위함
  • 봉사 장소 (act_place) — VARCHAR — 봉사장소
  • 봉사 장소 도로명주소 (post_address) — VARCHAR — 봉사 장소 도로명 주소
  • 담장자명 (manager_name) — VARCHAR — 모집기관
  • 전화번호 (manager_tel) — VARCHAR — 전화번호
  • FAX번호 (manager_fax) — VARCHAR — FAX번호
  • 이메일 (manager_email) — VARCHAR — 이메일
  • 위도 (latitude) — decimal(10, 7) — 봉사장소 위도 (변환 실패시 null)
  • 경도 (longitude) — decimal(11, 7) — 봉사장소 경도 (변환 실패시 null)
  • 생성일시 (created_at) — DATETIME — 최초 적재 일시
  • 수정일시 (updated_at) — DATETIME — API 동기화 일시
  • 담당자주소 (manager_address) — VARCHAR
  • 지역 ID (region_id) — BIGINT — 외래 키 → 활동 지역.id — 봉사장소 행정구역 FK (온라인/전국 봉사는 null)
  • 카테고리ID (category_id) — BIGINT — 외래 키 → 카테고리.id — NOT NULL — 봉사분야 FK

봉사장소 (volunteer_posting_location)

  • id — BIGINT — 기본 키 — NOT NULL
  • 몇번째 장소인지 (location_seq) — INT — NOT NULL
  • 주소 (address) — VARCHAR(255) — NOT NULL
  • 위도 (latitude) — DECIMAL(10, 7)
  • 경도 (longitude) — DECIMAL(11, 7)
  • 생성시간 (created_at) — DATETIME — NOT NULL
  • 공고id (posting_id) — BIGINT — 외래 키 → 봉사 공고.id — NOT NULL

봉사참여기록 (posting_participation)

  • id — BIGINT — 기본 키 — NOT NULL
  • 상태 (status) — VARACHAR(20) — NOT NULL
  • 생성시간 (created_at) — DATETIME(6) — NOT NULL
  • 수정시간 (Field) — DATETIME(6) — NOT NULL
  • 사용자봉사인정시간 (recognized_minutes) — INT
  • 봉사완료처리시점 (completed_at) — DATETIME(6)
  • 유저id (user_id) — BIGINT — 외래 키 → 회원.id — NOT NULL — Auto Increment
  • 공고id (posting_id) — BIGINT — 외래 키 → 봉사 공고.id — NOT NULL

북마크 (bookmark)

  • id — BIGINT — 기본 키 — NOT NULL
  • 생성일시 (created_at) — DATETIME — NOT NULL — 북마크생성일시
  • 유저ID (user_id) — BIGINT — 외래 키 → 회원.id — NOT NULL — Auto Increment
  • 공고ID (posting_id) — BIGINT — 외래 키 → 봉사 공고.id — NOT NULL
  • Key (Key2) — 외래 키 — NOT NULL

사용자 관심 카테고리 (user_interest_category)

  • ID (id) — BIGINT — 기본 키 — NOT NULL — Auto Increment
  • 유저 ID (user_id) — BIGINT — 외래 키 → 회원.id — NOT NULL — users.id 참조, (user_id, category_id) UNIQUE
  • 카테고리 ID (category_id) — BIGINT — 외래 키 → 카테고리.id — NOT NULL — category.id 참조, (user_id, category_id) UNIQUE
  • 생성일시 (created_at) — DATETIME — NOT NULL — 등록 시간

사용자 활동 지역 (user_activity_region)

  • ID (id) — BIGINT — 기본 키 — NOT NULL — Auto Increment
  • 유저 ID (user_id) — BIGINT — 외래 키 → 회원.id — NOT NULL — users.id 참조, (user_id, region_id) UNIQUE
  • 지역 ID (region_id) — BIGINT — 외래 키 → 활동 지역.id — NOT NULL — region.id 참조, (user_id, region_id) UNIQUE
  • 생성일시 (created_at) — DATETIME — NOT NULL — 등록 시간

상위활동9권역 (region_group)

  • id — BIGINT — 기본 키 — NOT NULL
  • 코드 (code) — VARCHAR(20) — NOT NULL — 서비스 내부 코드(1365 행정구역 코드 아님)
  • 이름 (name) — VARCHAR(20) — NOT NULL — 버튼 표시명
  • 노출순서 (sort_order) — INT — NOT NULL — 버튼 노출 순서
  • Field

이메일 인증 (email_verification)

  • id — BIGINT — 기본 키 — NOT NULL — Auto Increment
  • 이메일 (email) — VARCHAR(255) — NOT NULL — Unique, 인증 대상 이메일
  • 인증 코드 (code) — VARCHAR(20) — NOT NULL — 사용자가 입력하는 인증 코드
  • 만료일시 (expires_at) — DATETIME — NOT NULL — 인증 코드 만료 기간
  • 인증 완료 여부 (verified) — BOOLEAN — NOT NULL
  • 인증일시 (verified_at) — DATETIME — 인증 완료 시간
  • 생성일시 (created_at) — DATETIME — NOT NULL — 인증 요청 생성 시간
  • 수정일시 (updated_at) — DATETIME — 재발송 등 갱신 시간

카테고리 (categories)

  • id — BIGINT — 기본 키 — NOT NULL
  • 카테고리명 (name) — VARCHAR — NOT NULL — 봉사분야 (분야별 검색용)
  • 카테고리코드 (code) — VARCHAR — NOT NULL — 유니크 키

활동 지역 (region)

  • id — BIGINT — 기본 키 — NOT NULL
  • 지역명 (name) — VARCHAR — NOT NULL — 지역명(행정구역명)
  • 지역레벨 (level) — INT — 시도(1) → 시군구(2) → (3 결번) → 읍면동(4)
  • 지역코드 (code) — VARCHAR — 1365 행정구역 코드 매핑용
  • 상위지역 ID (parent_id) — BIGINT — 외래 키 → 활동 지역.id — 도→시→구→동 셀프참조 (최상위 지역은 null)
  • 상위활동9권역ID (region_group_id) — BIGINT — 외래 키 → 상위활동9권역.id — NOT NULL — 상위 활동지역 권역(9개)

회원 (users)

  • id — BIGINT — 기본 키 — NOT NULL — Auto Increment
  • 이메일 (email) — VARCHAR(255) — NULL 허용(소셜 로그인)
  • 비밀번호 해시 (password_hash) — VARCHAR(255) — NOT NULL — 암호화된 비밀번호
  • 이름 (name) — VARCHAR(30) — 탈퇴 이후 NULL 허용
  • 닉네임 (nickname) — VARCHAR(20) — NOT NULL — Unique, 2-8자
  • 전화번호 (phone_number) — VARCHAR(20) — NOT NULL — UNIQUE
  • 이메일 인증 여부 (email_verified) — BOOLEAN — NOT NULL — 이메일 인증 완료 여부
  • 프로필 이미지 URL (profile_image_url) — VARCHAR(500) — 프로필 이미지
  • 생년월일 (birth_date) — DATE — NOT NULL — 회원가입 입력 필수
  • 성별 (gender) — VARCHAR(20) — NOT NULL — MALE / FEMALE / OTHER
  • 소개 (introduction) — VARCHAR(50) — 소개글, 최대 50자
  • 권한 (role) — VARCHAR(20) — NOT NULL — USER / ADMIN, 기본값 USER
  • 상태 (status) — VARCHAR(20) — NOT NULL — ACTIVE / SUSPENDED / WITHDRAWN, 기본값 ACTIVE
  • 서비스 이용약관 동의 (service_terms_agreed) — BOOLEAN — NOT NULL — TRUE 필수
  • 개인정보 약관 동의 (privacy_policy_agreed) — BOOLEAN — NOT NULL — TRUE 필수
  • 마케팅 수신 동의 (marketing_agreed) — BOOLEAN — NOT NULL — 선택 동의
  • 서비스 이용약관 동의 일시 (service_terms_agreed_at) — DATETIME — NOT NULL — 동의한 시간
  • 개인정보 약관 동의 일시 (privacy_policy_agreed_at) — DATETIME — NOT NULL — 동의한 시간
  • 마케팅 수신 동의 일시 (marketing_agreed_at) — DATETIME — 동의한 시간
  • 가입일시 (created_at) — DATETIME — NOT NULL
  • 수정일시 (updated_at) — DATETIME