zipsAI ERD
테이블 (16)
건물 (Buildings)
- 건물 ID (building_id) — BIGINT — 기본 키 — NOT NULL
- 관리자 ID (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — UNIQUE
- 주소 (road_address) — VARCHAR(200) — NOT NULL — 주소검색 API 결과 저장
- 건물명 (building_name) — VARCHAR(20) — NOT NULL
- 생성일 (created_at) — DATETIME — NOT NULL
- 수정일 (updated_at) — DATETIME — NOT NULL
- 삭제일 (deleted_at) — DATETIME
규칙 문서 (Rule_Documents)
- 문서 ID (document_id) — BIGINT — 기본 키 — NOT NULL
- 건물 ID (building_id) — BIGINT — 외래 키 → 건물.건물 ID — NOT NULL
- 첨부 ID (attachment_id) — BIGINT — 외래 키 → 첨부파일.첨부 ID — NOT NULL — 첨부파일 고유 ID
- 규칙 제목 (document_title) — VARCHAR(20) — NOT NULL — 규칙 제목
- 문서 내용 (content) — TEXT — NOT NULL — AI를 통해 전처리해 파일을 텍스트화
- 문서 버전 (version) — INT — NOT NULL — 동일 제목을 가진 문서를 수정할 때마다 증가
- 문서유효여부 (is_valid) — BOOLEAN — NOT NULL — 최신 버전, 혹은 유효한 규칙에 대한 문서 파악 용도
- 생성일 (created_at) — DATETIME — NOT NULL
- 수정일 (updated_at) — DATETIME — NOT NULL
- 삭제일 (deleted_at) — DATETIME
메시지 이미지 그룹 (Message_file_groups)
- 메시지 첨부 ID (file_group_id) — BIGINT — 기본 키 — NOT NULL
- 메시지 ID (message_id) — BIGINT — 외래 키 → 채팅메시지.메시지 ID — NOT NULL
- 첨부 ID (attachment_id) — BIGINT — 외래 키 → 첨부파일.첨부 ID — NOT NULL — 첨부파일 고유 ID
- 이미지 파일 순서 (file_group_seq) — INT — NOT NULL — 메세지 첨부파일 순서, CHECK BETWEEN 1 AND 3
- 생성일 (created_at) — DATETIME — NOT NULL
- 수정일 (updated_at) — DATETIME — NOT NULL
- 삭제일 (deleted_at) — DATETIME
민원 (Complaints)
- 민원 ID (complaint_id) — BIGINT — 기본 키 — NOT NULL
- 채팅방 ID (conversation_id) — BIGINT — 외래 키 → 채팅방.채팅방 ID — NOT NULL — UNIQUE
- 건물 ID (building_id) — BIGINT — 외래 키 → 건물.건물 ID — NOT NULL
- 민원 접수자 ID (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL
- 첨부 ID (attachment_id) — BIGINT — 외래 키 → 첨부파일.첨부 ID — 민원 대표 이미지
- AI 요약 제목 (title) — VARCHAR(50) — NOT NULL
- 처리상태 (complaint_status) — VARCHAR(20) — NOT NULL — PENDING(처리전), IN_PROGRESS(처리중), DONE(처리완료)
- AI 산정 긴급도 (urgency) — ENUM — NOT NULL — ENUM('0','1','2','3','4','5','6','7','8','9','10'), AI가 민원 생성 시 산정.
- 민원 해결일 (resolved_at) — DATETIME
- 호실 (room_no) — VARCHAR(5) — NOT NULL
- 생성일 (created_at) — DATETIME — NOT NULL — 민원 접수 시각
- 수정일 (updated_at) — DATETIME — NOT NULL
- 삭제일 (deleted_at) — DATETIME
민원 그룹 (Complaint_Groups)
- 민원그룹 ID (complaint_group_id) — BIGINT — 기본 키 — NOT NULL
- 민원 ID (complaint_id) — BIGINT — 외래 키 → 민원.민원 ID — NOT NULL
- 인사이트 ID (insight_id) — BIGINT — 외래 키 → 인사이트 보고서.인사이트 ID — NOT NULL
- 생성일 (created_at) — DATETIME — NOT NULL
- 수정일 (updated_at) — DATETIME — NOT NULL
- 삭제일 (deleted_at) — DATETIME
민원상세 (Complaint_Details)
- 민원 ID (complaint_id) — BIGINT — 외래 키 → 민원.민원 ID — NOT NULL
- 발생 위치 (location) — VARCHAR(50) — NOT NULL — AI 추출 위치
- 증상 (symptom) — VARCHAR(100) — NOT NULL — AI 추출 증상
- 발생 시점 (occurred_time) — VARCHAR(50) — NOT NULL — AI 추출 시점(민원 증상이 발생한 시점)
- 상세 요약 (ai_summary) — VARCHAR(200) — NOT NULL — AI로 생성된 민원 요약
- 생성일 (created_at) — DATETIME — NOT NULL
- 수정일 (updated_at) — DATETIME — NOT NULL
- 삭제일 (deleted_at) — DATETIME
방 (Rooms)
- 방 ID (room_id) — BIGINT — 기본 키 — NOT NULL
- 건물 ID (building_id) — BIGINT — 외래 키 → 건물.건물 ID — NOT NULL
- 입주민 ID (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — UNIQUE 입주민. 공실이면 NULL
- 입주현황 (room_status) — ENUM — NOT NULL — EMPTY(공실), INVITED(초대중), LIVING(거주중)
- 호실 번호 (room_no) — VARCHAR(5) — NOT NULL
- 생성일 (created_at) — DATETIME — NOT NULL
- 수정일 (updated_at) — DATETIME — NOT NULL
- 삭제일 (deleted_at) — DATETIME
사용자 (Users)
- 사용자 ID (user_id) — BIGINT — 기본 키 — NOT NULL
- 이메일 (email) — VARCHAR(254) — NOT NULL — UNIQUE
- 비밀번호 (password) — VARCHAR(60) — NOT NULL — 회원가입 시 해시처리
- 이름 (user_name) — VARCHAR(7) — NOT NULL
- 전화번호 (phone) — VARCHAR(13)
- 활성 상태 (user_status) — VARCHAR(20) — NOT NULL — ACTIVE(활성), INACTIVE(비활성)
- 유저 역할 (user_role) — VARCHAR(10) — NOT NULL — MANAGER(관리자),RESIDENT(입주민),NONE(역할 미 선택)
- 생성일 (created_at) — DATETIME — NOT NULL
- 수정일 (updated_at) — DATETIME — NOT NULL
- 삭제일 (deleted_at) — DATETIME
사용자 수신 알림 (User_notifications)
- 알림 ID (user_noti_id) — BIGINT — 기본 키 — NOT NULL
- 사용자 ID (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL
- 알림 원본 ID (noti_id) — BIGINT — 외래 키 → 알림.알림 ID — NOT NULL
- 읽은 시각 (read_at) — DATETIME — 알림읽은시간
- 생성일 (created_at) — DATETIME — NOT NULL
- 수정일 (updated_at) — DATETIME — NOT NULL
- 삭제일 (deleted_at) — DATETIME
알림 (Notifications)
- 알림 ID (noti_id) — BIGINT — 기본 키 — NOT NULL
- 알림 내용 (content) — TEXT — NOT NULL
- 생성일 (created_at) — DATETIME — NOT NULL
- 수정일 (updated_at) — DATETIME — NOT NULL
- 삭제일 (deleted_at) — DATETIME
약관 동의 (User_agreements)
- 약관동의 ID (agreement_id) — BIGINT — 기본 키 — NOT NULL
- 사용자 ID (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL
- 약관타입 (terms_type) — VARCHAR(20) — NOT NULL — SERVICE(이용약관), PRIVACY(개인정보 수집 및 이용), MARKETING(마케팅 정보 수신)
- 약관동의여부 (is_agreed) — BOOLEAN — NOT NULL
- 약관동의시각 (agreed_at) — DATETIME — NOT NULL
- 생성일 (created_at) — DATETIME — NOT NULL
- 수정일 (updated_at) — DATETIME — NOT NULL
- 삭제일 (deleted_at) — DATETIME
인사이트 보고서 (Insights)
- 인사이트 ID (insight_id) — BIGINT — 기본 키 — NOT NULL
- 건물 ID (building_id) — BIGINT — 외래 키 → 건물.건물 ID — NOT NULL
- AI 요약 제목 (title) — VARCHAR(50) — NOT NULL — AI가 생성한 한줄 요약 및 핵심내용
- 추정 원인 (estimated_cause) — TEXT — NOT NULL — 추정 원인
- 분석 기준 시각 (analyzed_at) — DATETIME — NOT NULL — AI분석 기준 일자
- 긴급도 (urgency) — ENUM — NOT NULL — ENUM('0','1','2','3','4','5','6','7','8','9','10'), AI가 인사이트 생성 시 산정.
- 생성일 (created_at) — DATETIME — NOT NULL
- 수정일 (updated_at) — DATETIME — NOT NULL
- 삭제일 (deleted_at) — DATETIME
채팅메시지 (Messages)
- 메시지 ID (message_id) — BIGINT — 기본 키 — NOT NULL
- 채팅방 ID (conversation_id) — BIGINT — 외래 키 → 채팅방.채팅방 ID — NOT NULL
- 내용 (content) — VARCHAR(200) — NOT NULL — 채팅 내용
- 발신자 역할 (sender_type) — VARCHAR(10) — NOT NULL — RESIDENT(입주민), MANAGER(관리자), ASSISTANT(AI 응답)
- 메시지타입 (message_type) — VARCHAR(20) — NOT NULL — TEXT, IMAGE
- 생성일 (created_at) — DATETIME(3) — NOT NULL — 채팅 발송 시각
- 수정일 (updated_at) — DATETIME — NOT NULL
- 삭제일 (deleted_at) — DATETIME
채팅방 (Conversations)
- 채팅방 ID (conversation_id) — BIGINT — 기본 키 — NOT NULL
- 사용자 ID (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL
- 타입 (conversation_type) — VARCHAR(20) — NOT NULL — INQUIRY(질의), COMPLAINT(민원)
- 채팅방 상태 (conversation_status) — VARCHAR(20) — NOT NULL — ACTIVE(활성), RESOLVED(해결됨, 질의), COMPLAINT_CREATED(민원 생성됨. 민원)
- 제목 (conversation_title) — VARCHAR(100) — 질의의 경우 첫 메세지 앞부분, 민원의 경우 AI 요약 제목으로 변경.
- 마지막채팅시각 (last_message_at) — DATETIME(3) — 최근 대화 정렬 및 미응답 대화 종료 추적 용도
- 생성일 (created_at) — DATETIME — NOT NULL
- 수정일 (updated_at) — DATETIME — NOT NULL
- 삭제일 (deleted_at) — DATETIME
첨부파일 (Files)
- 첨부 ID (attachment_id) — BIGINT — 기본 키 — NOT NULL — 첨부파일 고유 ID
- 파일키 (file_key) — VARCHAR(255) — NOT NULL — S3파일키
- 사이즈 (file_size) — INT — NOT NULL — 파일크기10MB제한, 저장 형식은 바이트
- 파일형식 (file_type) — VARCHAR(50) — NOT NULL — jpg·png·heic·PDF 허용
- 원본파일이름 (original_name) — VARCHAR(255) — NOT NULL — 사용자가올린 원본파일이름
- 생성일 (created_at) — DATETIME — NOT NULL — 업로드 일시
- 수정일 (updated_at) — DATETIME — NOT NULL — 수정일. 초기값은 생성일과 동일.
- 삭제일 (deleted_at) — DATETIME — 삭제 일시
초대코드 (Invitation_codes)
- 초대코드 ID (code_id) — BIGINT — 기본 키 — NOT NULL
- 방 ID (room_id) — BIGINT — 외래 키 → 방.방 ID — NOT NULL
- 초대코드 (code) — CHAR(6) — NOT NULL — UNIQUE, I, 1, O, 0 처럼 혼동값 제외
- 만료상태 (status) — ENUM — NOT NULL — ACTIVE(유효),USED(사용됨),EXPIRED(만료됨)
- 만료시간 (expires_at) — DATETIME — NOT NULL
- 생성일 (created_at) — DATETIME — NOT NULL
- 수정일 (updated_at) — DATETIME — NOT NULL
- 삭제일 (deleted_at) — DATETIME