GACHI
테이블 (11)
AI 전용 검색 인덱스 (newsletter_chunks)
- PK (id) — BIGINT — 기본 키 — NOT NULL
- FK (newsletter_id) — BIGINT — 외래 키 → 가정통신문.PK — NOT NULL — 가정통신문 id
- IDX (chunk_index) — INT — NOT NULL — 문서 내 순서(몇번째 조각인지)
- 쪼개진 실제 텍스트 내용 (content) — TEXT — NOT NULL
- AI 검색용 벡터 데이터 (embedding) — VECTOR(1536) — NOT NULL — 텍스트 조각을 벡터로 변환한 값
- 분석 언어 (language) — ENUM — NOT NULL — US: 영어, ZN: 중국어, VN: 베트남어
- 생성일 (created_at) — TIMESTAMPTZ — NOT NULL
- chunk 시작 위치 (start_offset) — INT — 원문 내 chunk 시작이 어디인지
- chunk 종료 위치 (end_offset) — INT — 원문 내 chunk 종료 위치
가정통신문 (newsletter)
- PK (id) — BIGINT — 기본 키 — NOT NULL — 가정통신문 기본키
- FK (user_id) — BIGINT — 외래 키 → 사용자(학부모).PK — NOT NULL — 사용자 기본키
- OCR 원문 (ocr_text) — TEXT — OCR 엔진이 문서 이미지에서 직접 추출한 원문 텍스트
- OCR 최종 원문 (original_text) — TEXT — NOT NULL — 전처리/정제된 최종 원문
- 번역된 텍스트 (translated_text) — TEXT
- 요약 텍스트 (summary) — TEXT
- 번역 언어 (language) — ENUM — NOT NULL — US: 영어, ZH: 중국어, VI: 베트남
- 번역 끝난 시간 (translated_at) — TIMESTAMPTZ — 번역 결과 생성 완료 시각
- 요약 완료 시간 (summarized_at) — TIMESTAMPTZ — 요약 결과 생성 완료 시각
- 업로드 일시 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일시 (updated_at) — TIMESTAMPTZ
- UK (file_key) — VARCHAR(500) — NOT NULL — 추후에 presigned URL로 생성
- 분석상태 (status) — ENUM — NOT NULL — PENDING(분석대기중), PROCESSING(분석중), COMPLETED(분석완료), FAILED(실패)
- UK (file_hash) — VARCHAR(255) — NOT NULL — Unique를 걸어서 중복 분석 막기- UNIQUE(chiled_id, file_hash)
- 저장여부 (is_saved) — BOOLEAN — NOT NULL — 저장하기 버튼을 눌러야 저장되는 로직. 구현에 사용 예정
- 자녀 이름 (child_name) — VARCHAR(50) — 추가 컬럼으로 추가합니다. 저장 당시의 기록-스냅샷
- 자녀 나이 (child_grade) — TINYINT — 추가 컬럼으로 저장 당시를 기록-스냅샷
- 자녀 캘린더 색상 (child_color) — VARNCHAR(7) — 얘만 예외적으로 동기화 시키기(children 색상 변경시 newsletter로 일괄 업데이트)
- 가정통신문 제목 (title) — VARCHAR(255) — 가정통신문 제목
- Field
- Field2
- Field3
리프레시 토큰 세션 (auth_refresh_tokens)
- PK (id) — BIGINT — 기본 키 — NOT NULL — 세션 레코드 고유 식별자
- FK, IDX (user_id) — BIGINT — 외래 키 → 사용자(학부모).PK — NOT NULL — users.id 참조
- UK (token_hash) — VARCHAR(255) — NOT NULL — 원문 토큰 저장 금지, 해시만 저장
- UK (jti) — NOT NULL — JWT ID 클레임, 토큰 1:1 식별
- 디바이스 정보 (device_info) — VARCHAR(255) — 기기명/브라우저/OS 요약
- 접속 IP 주소 (ip_address) — INET — 로그인 위치/이상징후 분석
- 로그인 유지 여부 (remember_me) — BOOLEAN — NOT NULL — 체크박스 선택값
- IDX (expires_at) — TIMESTAMPTZ — NOT NULL — 이 시각 이후 재발급 불가
- 마지막 사용 일시 (last_used_at) — TIMESTAMPTZ — 재발급 성공 시 갱신
- IDX (revoked_at) — TIMESTAMPTZ — 로그아웃/강제종료 시 설정
- 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL — 최초 로그인 시점
- 수정일시 (updated_at) — TIMESTAMPTZ — NOT NULL — 레코드 변경 시 갱신
사용자(학부모) (users)
- PK (id) — BIGINT — 기본 키 — NOT NULL — 사용자 기본키
- UK (email) — VARCHAR(255) — NOT NULL — 이메일 인증/연락용
- UK (login_id) — VARCHAR(255) — NOT NULL — 로그인 식별자
- 비밀번호 (password_hash) — VARCHAR(255) — NOT NULL — 암호화된 비밀번호
- 이름 (name) — VARCHAR(50) — 학부모 이름
- UK (phone_number) — VARCHAR(20) — NOT NULL — 아이디 찾기/본인 확인용
- 계정 상태 (status) — ENUM — NOT NULL — ACTIVE(활성), WITHDRAWN(탈퇴)
- 생성일시 (created_at) — DATETIME — NOT NULL — 가입 일시
- 수정일시 (updated_at) — DATETIME — NOT NULL — 정보 마지막 수정 일시
- 삭제일시 (deleted_at) — DATETIME — 탈퇴 시 시간 기록 (Soft Delete, 30일 후 물리삭제)
- 이메일 인증 일시 (email_verified_at) — TIMESTAMPTZ — 이메일 인증 완료 시각. 미인증이면 NULL
- 통합 동의 일시 (consent_agreed_at) — TIMESTAMPTZ — NOT NULL — 가입 시 이용약관+개인정보 동의 시각
- 통합 동의 버전 (consent_version) — TIMESTAMPTZ — NOT NULL — 동의한 약관/개인정보 정책 버전 (예: 2026-03-v1)
- 비밀번호 변경 일시 (password_updated_at) — TIMESTAMPTZ — NOT NULL — 마지막 비밀번호 설정/변경 시각(만료 정책, 보안 알림용)
- 설정언어 (language_code) — VARCHAR(10) — NOT NULL — KO,US,VN,CN
- 알림 수신 동의 (notification_enabled) — BOOLEAN — NOT NULL — 전체 알림 수신 여부(T/F)
알림 (notifications)
- PK (id) — BIGINT — 기본 키 — NOT NULL — 알림 기본키
- FK (user_id) — BIGINT — 외래 키 → 사용자(학부모).PK — NOT NULL — 알림 수신 대상(user) 참조
- 알림 유형 (type) — ENUM — NOT NULL — NEWSLETTER, CALENDAR, ACTION_GUIDE, NOTICE
- 알림 제목 (title) — VARCHAR(200) — NOT NULL — 알림 목록에 보일 굵은 제목
- 알림 내용 (body) — TEXT — NOT NULL — 알림 상세 본문 내용
- 이동 화면 타입 (target_type) — ENUM — 클릭 시 이동할 화면 (위 type과 동일 ENUM)
- 이동 화면 ID (target_id) — BIGINT — 클릭 시 이동할 특정 데이터의 PK (예: 가정통신문 id)
- 읽음 여부 (is_read) — BOOLEAN — NOT NULL — T: 읽음, F: 안읽음
- 읽은 일시 (read_at) — DATETIME — 알림을 클릭/확인한 시간
- 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL — 알림 발송 일시
- 삭제일시 (deleted_at) — TIMESTAMPTZ — Soft Delete 용 (실제 운영은 30일 후 Hard Delete 처리)
자녀 (children)
- PK (id) — BIGINT — 기본 키 — NOT NULL — 자녀 기본키
- FK (user_id) — BIGINT — 외래 키 → 사용자(학부모).PK — NOT NULL — 부모(user) 참조
- FK (school_id) — BIGINT — 외래 키 → 학교.PK — 소속 학교(school) 참조 (선택 입력)
- 자녀 이름 (name) — VARCHAR(50) — NOT NULL
- 생년월일 (birth_date) — DATE — NOT NULL
- 학년 (grade) — TINYINT — 1~6학년 (선택 입력)
- 반 (class_no) — TINYINT — (선택 입력)
- 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL — 자녀 등록 일시
- 수정일시 (updated_at) — TIMESTAMPTZ — NOT NULL — 정보 수정 일시
- 삭제일시 (deleted_at) — TIMESTAMPTZ — Soft Delete 용
- 캘린더 색상 (calendar_color) — VARCHAR(7) — NOT NULL — 캘린더에 표기될 자녀 색상, 추후 default 값 등록 예정
챗봇 (chat_sessions)
- PK (id) — BIGINT — 기본 키 — NOT NULL — 챗봇 세션 ID
- FK (user_id) — BIGINT — 외래 키 → 사용자(학부모).PK — NOT NULL — 사용자 기본키
- 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL
- 마지막 메세지 일시 (updated_at) — TIMESTAMPTZ — NOT NULL
챗봇 메세지 (chat_messages)
- PK (id) — BIGINT — 기본 키 — NOT NULL — 메세지 ID
- FK (session_id) — BIGINT — 외래 키 → 챗봇.PK — NOT NULL — 챗봇 세션 ID
- 발신자 (role) — ENUM — NOT NULL — USER(사용자 메세지), ASSISTANT(챗봇 메세지)
- 메세지 내용 (content) — TEXT — NOT NULL
- 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL
체크리스트 (checklist)
- PK (id) — BIGINT — 기본 키 — NOT NULL — 체크리스트 기본키
- FK (user_id) — BIGINT — 외래 키 → 사용자(학부모).PK — NOT NULL — 사용자 기본키
- 항목 종류 (type) — ENUM — NOT NULL — ENUM(todo, checklist)
- 항목 내용 (content) — VARCHAR(255) — NOT NULL
- 완료 여부 (is_completed) — BOOLEAN — Y: 완료, N : 미완료
- 생성일자 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일자 (updated_at) — TIMESTAMPTZ — NOT NULL
- 특정 날짜 (target_date) — DATE — 절대날짜로 변환해서 저장
- 특정날짜 라벨링 (target_date_label) — VARCHAR(50) — 지금 바로, 내일, ~등
- FK (newsletter_id) — BIGINT — 외래 키 → 가정통신문.PK — NOT NULL — 가정통신문 기본키
- FK (calendar_event_id) — BIGINT — 외래 키 → 캘린더.PK — 캘린더 기본키
캘린더 (calendar_events)
- PK (id) — BIGINT — 기본 키 — NOT NULL — 캘린더 기본키
- FK (user_id) — BIGINT — 외래 키 → 사용자(학부모).PK — NOT NULL — 사용자 기본키
- FK (child_id) — BIGINT — 외래 키 → 자녀.PK — 자녀 기본키
- FK (newsletter_id) — BIGINT — 외래 키 → 가정통신문.PK — NOT NULL — 가정통신문 기본키
- 일정 제목 (title) — VARCHAR(200) — NOT NULL
- 일정 상세 설명 (description) — TEXT
- 중복 방지 키 (external_key) — VARCHAR(255) — 자동 생성 일정의 중복 생성을 방지하기 위한 고유 식별 키
- 시작일 (start_at) — TIMESTAMPTZ — NOT NULL — 일정이 하루인 경우는 여기에 저장
- 마감일 (end_at) — TIMESTAMPTZ
- 생성 일시 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정 일시 (updated_at) — TIMESTAMPTZ — NOT NULL
학교 (schools)
- PK (id) — BIGINT — 기본 키 — NOT NULL — 학교 기본키
- UK (neis_school_code) — VARCHAR(50) — NOT NULL — NEIS 표준 학교 코드
- 학교명 (name) — VARCHAR(100) — NOT NULL — 검색용 학교 이름
- 지역코드 (region_code) — VARCHAR(20) — 교육청 지역 코드 (예: 서울, 경기 등)
- 활성상태 (is_active) — BOOLEAN — NOT NULL — 폐교 등 관리용
- 수정일시 (updated_at) — TIMESTAMPTZ — NOT NULL