BoxMon

Tables (17)

ADMIN (관리자)

  • admin_id (관리자 식별자) — BIGINT — Primary key — NOT NULL — auto increment
  • login_id (관리자 로그인 아이디) — VARCHAR — NOT NULL — unique key
  • password (비밀번호) — VARCHAR — NOT NULL
  • name (관리자 이름) — VARCHAR — NOT NULL

CHAT (채팅)

  • chat_id (채팅 식별자) — BIGINT — Primary key — NOT NULL — auto increment
  • shipment_id (운송건 식별자) — BIGINT — Foreign key → SHIPMENT.shipment_id — NOT NULL — 어떤 운송건에 대한 대화인지
  • shipper_id (화주 식별자) — BIGINT — Foreign key → SHIPPER.shipper_id — NOT NULL
  • driver_id (차주 식별자) — BIGINT — Foreign key → DRIVER.driver_id — NOT NULL
  • content (채팅 내용) — TEXT — NOT NULL
  • content_type (채팅 타입(텍스트/사진 URL)) — VARCHAR — NOT NULL — enum(TEXT/IMG_URL)
  • created_at (채팅 입력 시간) — TIMESTAMP — NOT NULL

CONTACT (관리자 문의)

  • contact_id (문의 식별자) — BIGINT — Primary key — NOT NULL — auto_increment
  • user_id (사용자 식별자) — BIGINT — Foreign key → USER.user_id — NOT NULL
  • contact_content (문의 내용) — TEXT — NOT NULL
  • created_at (문의 날짜) — TIMESTAMP — NOT NULL
  • answerer_id (답변한 관리자 ID) — BIGINT — Foreign key → ADMIN.admin_id — 답변하지 않은 문의면 NULL
  • answer_contnet (답변 내용) — TEXT — 답변하지 않은 문의면 NULL
  • answered_at (답변 날짜) — TIMESTAMP — 답변하지 않은 문의면 NULL

CONTACT_ATTATCHMENT (관리자 문의 첨부파일)

  • attatchment_id (첨부파일 식별자) — BIGINT — Primary key — NOT NULL
  • contact_id (문의 식별자) — BIGINT — Foreign key → CONTACT.contact_id — NOT NULL
  • content_type (첨부파일 종류) — VARCHAR — NOT NULL — enum(IMAGE, FILE)
  • content (첨부파일 URL) — VARCHAR — NOT NULL — AWS S3 사용 예정

DRIVER (차주)

  • driver_id (차주 식별자) — BIGINT — Foreign key → USER.user_id — NOT NULL
  • bank_code (계좌 은행 코드) — VARCHAR — 화물 수락 시 없으면 계좌 등록 페이지로
  • account_number (계좌 번호) — VARCHAR — 화물 수락 시 없으면 계좌 등록 페이지로
  • holder_name (예금주) — VARCHAR — 화물 수락 시 없으면 계좌 등록 페이지로

EVENT_LOG (이벤트 로그(상태 변경 관련))

  • log_id (로그 식별자) — BIGINT — Primary key — NOT NULL — auto increment
  • admin_id (처리한 관리자) — BIGINT — Foreign key → ADMIN.admin_id — NOT NULL
  • event_type (이벤트 종류) — VARCHAR — NOT NULL — ENUM(관리자 계정 생성, 운송 강제 취소, 문의 답변, 수수료율 변경)
  • created_at (이벤트 발생 시간) — TIMESTAMP — NOT NULL
  • payload (기타 데이터(관리자 메모)) — JSON — 가입 반려 사유, 제재 사유, 운행 강제취소사유 등 기타 데이터

LOCATION_LOG (차주 실시간 위치)

  • location_id (실시간 위치 식별자) — BIGINT — Primary key — NOT NULL
  • shipment_id (운송건 식별자) — BIGINT — Foreign key → SHIPMENT.shipment_id — NOT NULL
  • shipper_id (화주 식별자) — BIGINT — Foreign key → SHIPMENT.shipper_id — NOT NULL
  • driver_id (차주 식별자) — BIGINT — Foreign key → SHIPMENT.driver_id — NOT NULL
  • location_data (좌표 문자열) — TEXT — NOT NULL
  • created_at (location_data 생성 시점) — TIMESTAMP — NOT NULL — 이를 토대로 정렬 후 클라이언트로 반환 예정(경로 그리기를 위함)

NOTIFICATION (알림)

  • notification_id (알림 식별자) — BIGINT — Primary key — NOT NULL — auto_increment
  • target_id (수신자 id) — BIGINT — Foreign key → USER.user_id — NOT NULL
  • shipment_id (알림에 관련된 운송 식별자) — BIGINT — Foreign key → SHIPMENT.shipment_id — NOT NULL — 프론트에서 상세화면으로 리다이렉션하기 위함
  • notification_type (알림 종류) — VARCHAR — NOT NULL — enum(배차완료, 운송시작, 운송완료, 배차 취소 요청, 채팅알림)
  • notification_title (알림 제목) — VARCHAR — NOT NULL
  • notification_content (알림 내용) — TEXT — NOT NULL — 필요없으면 null 대신 비워서 보낼것
  • extra_data (추가 데이터) — JSON
  • sent_at (전송시각) — TIMESTAMP — NOT NULL
  • firebase_message_id (메시지 id) — VARCHAR — FCM에서 제공하는 메시지 id, 전송 실패시 null

PAYMENT (결제)

  • payment_id (결제 식별자) — BIGINT — Primary key — NOT NULL — auto_increment
  • shipment_id (해당하는 운송건 식별자) — BIGINT — Foreign key → SHIPMENT.shipment_id — NOT NULL — unique, 토스페이측에서 요구하는 order_id를 이 값으로 사용
  • toss_patment_key (토스페이용 결제 식별자) — VARCHAR — NOT NULL — unique, 토스페이측에서 생성(클라이언트가 전송해야함)
  • payment_status (결제 상태) — VARCHAR — NOT NULL — enum(PAID, UNPAID, CANCELED, CANCEL_PROGRESS) : 화주 화물 등록을 위한 선결제가 완료되어야 PAID으로 변경
  • approved_at (결제 승인일) — TIMESTAMP — 승인이 되지 않은 경우 NULL
  • canceled_at (결제 취소일) — TIMESTAMP — 결제 취소가 되지 않은 경우 NULL

PAYMENT_LOG (결제 로그)

  • log_id (결제 로그 식별자) — BIGINT — Primary key — NOT NULL — auto_increment
  • payment_id (결제 식별자) — BIGINT — Foreign key → PAYMENT.payment_id — NOT NULL
  • event_type (결제 이벤트 구분) — VARCHAR — NOT NULL — enum(APPROVED, REJECTED, CANCELED,CANCEL_FAILED)
  • created_at (결제 이벤트 발생시간) — TIMESTAMP — NOT NULL

PENALTIES (사용자 제재 기록)

  • penalty_id (패널티 ID) — BIGINT — Primary key — NOT NULL — autoincrement
  • admin_id (처리한 관리자) — BIGINT — Foreign key → ADMIN.admin_id — NOT NULL — auto increment
  • user_id (제재 당한 사용자) — BIGINT — Foreign key → USER.user_id — NOT NULL — auto increment
  • payload (제재 내용) — TEXT — NOT NULL
  • created_at (제제 날짜) — TIMESTAMP — NOT NULL

SETTLEMENT (정산)

  • settlement_id (정산 식별자) — BIGINT — Primary key — NOT NULL — auto_increment
  • shipment_id (해당하는 운송건 식별자) — BIGINT — Foreign key → SHIPMENT.shipment_id — NOT NULL
  • settlement_status (정산 상태) — VARCHAR — NOT NULL — enum(INELIGIBLE/READY/PAID)
  • settle_at (정산 예정일) — TIMESTAMP — 운송 완료시 등록됨

SHIPMENT (운송건)

  • shipment_id (운송건 식별자) — BIGINT — Primary key — NOT NULL — auto increment
  • shipper_id (화주 식별자) — BIGINT — Foreign key → DRIVER.driver_id — NOT NULL
  • driver_id (차주 식별자) — BIGINT — Foreign key → SHIPPER.shipper_id
  • accepted_at (배차 수락시간) — TIMESTAMP — 타임라인용
  • pickup_point (출발 경위도) — POINT — NOT NULL — 경위도 좌표
  • pickup_address (출발지 주소) — VARCHAR — NOT NULL
  • pickup_desired_at (화주 희망 출발 시간) — TIMESTAMP — NOT NULL
  • pickup_at (실제 출발 시간) — TIMESTAMP — 타임라인용
  • dropoff_point (도착 경위도) — POINT — NOT NULL — 경위도 좌표
  • dropoff_address (도착지 주소) — VARCHAR — NOT NULL
  • dropoff_desired_at (화주 희망 도착 시간(운송 희망일)) — TIMESTAMP — NOT NULL
  • dropoff_at (실제 도착 시간) — TIMESTAMP — 운송 완료 여부 확인으로 사용+타임라인용
  • waypoint1_point (경유지1 경위도) — POINT — 경위도 좌표
  • waypoint1_address (경유지1 주소) — VARCHAR
  • waypoint1_at (경유지1 도착시간) — TIMESTAMP — 타임라인용
  • waypoint2_point (경유지2 경위도) — POINT — 경위도 좌표
  • waypoint2_address (경유지2 주소) — VARCHAR
  • waypoint2_at (경유지2 도착시간) — TIMESTAMP — 타임라인용
  • price (운임 전체 비용) — INT — NOT NULL — 차주 수익+수수료
  • platform_fee (수수료) — INT — NOT NULL
  • profit (차주 수익) — INT — NOT NULL
  • shipment_status (배송상태) — VARCHAR — NOT NULL — enum(REQUESTED/ASSIGNED/IN_TRANSIT/DONE/CANCELED)
  • cargo_type (화물 종류) — VARCHAR — NOT NULL — enum(일반 화물/팔레트 화물/초장축·장축 화물/중량 화물/이사 화물/벌크 화물/위험물)
  • cargo_weight (화물 무게) — DOUBLE — NOT NULL
  • cargo_volume ((선택)화물 부피(규격)) — VARCHAR
  • need_refridgerate (냉장 필요 여부) — TINYINT(1) — NOT NULL — 0/1
  • need_freeze (냉동 필요 여부) — TINYINT(1) — NOT NULL — 0/1
  • description ((선택)특이사항) — TEXT — 파손주의, 긴급배송 등
  • cargo_photo_url (화물 등록용 사진) — VARCHAR — AWS S3 사용 예정
  • dropoff_photo_url (하차 완료 사진) — VARCHAR — AWS S3 사용 예정
  • shipper_cancel_toggle (화주 취소 여부) — TINYINT(1) — NOT NULL — 0/1 | 차주도 취소여야 취소 처리 | 차주에게 알림
  • driver_cancel_toggle (차주 취소 여부) — TINYINT(1) — NOT NULL — 0/1 | 화주도 취소여야 취소 처리 | 화주에게 알림
  • created_at (화물 등록 시간) — TIMESTAMP — NOT NULL — 화물 상세 보기에서 보여줄 용도 혹은 내 화물 목록 조회에서 필터링 용도로 사용 예정
  • current_location_point (차주 최신 위치 좌표) — POINT — 화물 상세 보기 화면 중 지도에서 차주 최신 위치에 마커를 찍기 위함
  • vehicle_type (화주 희망 차량 종류) — VARCHAR — NOT NULL — enum(CARGO/VAN/WINGBODY/TANKER/DUMP/BULK)
  • estimated_distance (운송 예상 거리) — DOUBLE — 미배차 화물 목록에서 보여주기 위한 용도의 컬럼
  • company_name (업체명) — VARCHAR — NOT NULL — 화물 상세보기에서 화주의 이름 혹은 업체명을 보여주기 위함

SHIPPER (화주)

  • shipper_id (화주 식별자) — BIGINT — Foreign key → USER.user_id — NOT NULL

SYSTEM_SETTING (시스템 설정값)

  • setting_id (설정값 식별자) — VARCHAR — Primary key — NOT NULL — 지금은 수수료율밖에 없지만 확장을 고려한 PK
  • value (설정값) — VARCHAR — 설정값(예:0.5)

USER (사용자)

  • user_id (사용자 식별자) — BIGINT — Primary key — NOT NULL — auto increment
  • user_type (유저 종류(차주/화주)) — VARCHAR — NOT NULL — enum(DRIVER/SHIPPER)
  • email (사용자 이메일) — VARCHAR — NOT NULL — unique key
  • password (사용자 비밀번호) — VARCHAR — NOT NULL
  • name (사용자 이름) — VARCHAR — NOT NULL
  • phone (사용자 전화번호) — VARCHAR — NOT NULL
  • business_number (사업자 번호) — VARCHAR — 선택 입력
  • created_at (가입날짜) — TIMESTAMP — NOT NULL
  • birth (생년월일) — DATE — NOT NULL — 차주 운수종사자 자격증 진위 확인용
  • device_token (스마트폰 식별토큰) — VARCHAR — NOT NULL — 회원가입·로그인 시마다 갱신 / 화물 상태 변경(배차 완료, 운송 시작, 완료, 취소 요청 등)
  • is_push_enabled (알림 on/off 여부) — TINYINT(1) — NOT NULL — 0/1(회원가입 시 다이얼로그 등으로 질의 / 혹은 마이페이지에서 토글로 전환)
  • account_status (계정 정지 여부) — TINYINT(1) — NOT NULL — 관리자가 사용자 정지 동작 시 1로 변경
  • is_delete (계정 탈퇴 여부) — TINYINT(1) — NOT NULL — emai : [email protected], name : "탈퇴한 사용자", 전화번호 : "탈퇴한 사용자"

VEHICLE (차량)

  • vehicle_id (차량 식별자) — BIGINT — Primary key — NOT NULL — auto increment
  • driver_id (사용자 식별자) — BIGINT — Foreign key → DRIVER.driver_id — NOT NULL — auto increment
  • vehicle_number (차량 번호) — VARCHAR — NOT NULL — unique
  • vehicle_type (차량 종류) — VARCHAR — enum
  • can_refrigerate (냉장 가능) — TINYINT(1) — NOT NULL — 0/1
  • can_freeze (냉동 가능) — TINYINT(1) — NOT NULL — 0/1
  • weight_capacity (적재 가능 중량) — DOUBLE — NOT NULL