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