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