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