@carsayo/types 1.1.892081 → 1.1.892083

package/dist/types/modules/repair/interface.d.ts

@@ -0,0 +1,659 @@
+import { SidoName } from "../../../data";
+import { Admin_RepairShop, RepairShop } from "../accidentReport";
+import { FileInfo } from "../file";
+import { CustomerCarInfo } from "../member";
+import { CarPartitionKey, RepairBidState, RepairSettlementUnitState, RepairState, RepairType, TireSize } from "./type";
+export interface RepairCustomer {
+    /** MemberID */
+    id: string;
+    /** 고객 이름
+     * @note RepaieBid에서는 예약시 고객이 예약 당시 입력한 연락처가 들어옵니다.
+     */
+    name: string | null;
+    /** 고객 전화번호
+     * @note RepaieBid에서는 예약시 고객이 예약 당시 입력한 연락처가 들어옵니다.
+     */
+    phoneNumber: string | null;
+}
+/** 고객이 수리 요청시 생성 */
+export interface Repair {
+    /** 견적 번호
+     * YYYYMMDD_(T)0001
+     * (T)는 A: 사고 수리, E: 외장 수리, O: 엔진오일 교체, T: 타이어 교체
+     */
+    id: string;
+    state: RepairState;
+    type: RepairType;
+    /** 차량번호 */
+    carName: string;
+    /** 차량 모델명 */
+    carModel: string;
+    /** 견적 요청 위치
+     * @note 견적 요청 위치를 기준으로 공업사가 요청을 할 수 있습니다.
+     */
+    location: RepairAddress;
+    /** 견적 요청 내용 */
+    request: RepairRequest;
+    /** 요청 고객 정보 */
+    member: RepairCustomer;
+    /** 고객이 작성한 리뷰 */
+    review: RepairReview | null;
+    /** 고객이 선택한 견적 내용 */
+    accepted_bid: RepairBid | null;
+    /** 견적 제출 일시 */
+    submitted_at: Date;
+    /** 만기 일시
+     * @note 견적 제출 후 만기 일시가 지나면 서버단에서 견적 제출 취소 처리
+     */
+    expire_at: Date;
+    /** 견적 수락 일시 */
+    reserved_at: Date | null;
+    /** 견적 예약 취소 일시 */
+    reserve_canceled_at: Date | null;
+    /** 입고 일시 */
+    checked_in_at: Date | null;
+    /** 수리 시작 일시 */
+    in_repair_at: Date | null;
+    /** 수리 완료 일시 */
+    repaired_at: Date | null;
+}
+/**
+ * 견적 발송 내용
+ * @description 공업사가 견적 제출할 때 생성
+ * @description 해당 견적에 대하여 고객이 수락할 수 있음
+ * @description 견적서 내용, 정비 명세서 데이터 JSON 형식으로 저장
+ */
+export interface RepairBid {
+    id: string;
+    state: RepairBidState;
+    /** 예약 번호
+     * @note 고객이 예약 완료할 때 저장되는 유니크 키값
+     * YYYYMMDD_(T)0001
+     * (T)는 A: 사고 수리, E: 외장 수리, O: 엔진오일 교체, T: 타이어 교체
+     */
+    reservationNumber: string | null;
+    /** 고객 정보 */
+    customer: RepairCustomer;
+    /** 견적 설명 */
+    description: string;
+    /** 공업사 위치와 견적 요청 위치간 거리 (m단위) */
+    distance: number;
+    /** 견적 발송 내용 */
+    estimate: RepairEstimate;
+    /** 정비 명세서 */
+    progress: RepairProgress | null;
+    /** 견적 발송 공업사 정보 */
+    repairShop: RepairShop;
+    /** 진행 이력 (공업사) */
+    history: RepairHistory[];
+    /** 예약 정보
+     * @note 예약 일시
+     * @note DB엔 날짜, 시간 컬럼 나누어서 저장 & 날짜에 인덱싱 처리
+     */
+    reservation: RepairReservation | null;
+    /** 견적과 연결된 채팅방 Id */
+    chatRoomId: string | null;
+    /** 견적 취소 사유
+     * @note 견적 취소 시 저장
+     */
+    cancelReason: string | null;
+    /** 견적 취소 주체 */
+    canceled_by: "customer" | "partner" | null;
+    /** 고객이 읽은 시간
+     * @note 이 값이 non-null이면 공업사가 견적서를 삭제할 수 없습니다.
+     */
+    estimate_read_at: Date | null;
+    /** 견적 제출 일시 */
+    submitted_at: Date;
+    /** 견적 수락 일시 */
+    reserved_at: Date | null;
+    /** 견적 취소 일시 */
+    canceled_at: Date | null;
+    price: {
+        /** 견적서 비용
+         * @note VAT 포함 가격
+         */
+        estimate: number;
+        /** 정비 명세서 비용
+         * @note VAT 포함 가격
+         */
+        progress: number | null;
+    };
+}
+/** 사고접수 진행 이력 */
+export interface RepairHistory {
+    title: {
+        content: string;
+        color?: string;
+    };
+    contents: {
+        title: string;
+        content: string;
+        additionalInfo?: {
+            content: string;
+            color?: string;
+        };
+    }[];
+    features: RepairHistoryFeature[];
+}
+export type RepairHistoryFeature = {
+    type: "copy";
+    title: string;
+    value: string;
+} | {
+    type: "download";
+    title: string;
+    value: string;
+};
+export interface RepairReservation {
+    /** YYYY-MM-DD */
+    day: string;
+    /** HH:MM */
+    time: string;
+}
+/** 견적 요청 내용 */
+export type RepairRequest = {
+    /** 수리 요청 타입 */
+    type: RepairType;
+    /** 선택 차량 정보 */
+    selectedCar: CustomerCarInfo;
+    /** 견적 요청 위치
+     * @note 견적 요청 위치를 기준으로 공업사가 요청을 할 수 있습니다.
+     * @note 주문 유형에 따라 클라이언트에서 값을 잘 처리해야 합니다.
+     * @example ex) 사고접수 > 비보험사고일 경우 견적주소를 사용, 사고접수 > 보험사고 & 견인요청 시 견인주소를 사용 (견인 위치를 기준으로 공업사 호출하여야 하므로)
+     */
+    location: RepairAddress;
+    /** 사고수리 요청 내용 */
+    accident: {
+        /** 수리 부분 사진 3장 이상 첨부 URL */
+        pictures: string[];
+        /** 수리 부위에 대한 설명 */
+        description: string;
+        method: {
+            /** 견인요청과 픽업이 동시에 true일 수 없습니다. */
+            비보험수리: {
+                견인요청: boolean;
+                픽업: boolean;
+                딜리버리: boolean;
+            } | null;
+            /** 견인요청과 픽업이 동시에 true일 수 없습니다. */
+            보험수리: {
+                type: "자차" | "피해차";
+                견인요청: boolean;
+                픽업: boolean;
+                딜리버리: boolean;
+            } | null;
+        };
+        address: {
+            /** 견적주소를 기준으로 공업사에 견적 요청 */
+            견적주소: RepairAddress;
+            /**
+             * @condition 견인 선택 시
+             */
+            견인주소: {
+                /** 견인 주소 (검색 주소) */
+                검색주소: RepairAddress;
+                /** 상세 위치 (고객 입력) */
+                상세위치: string;
+            } | null;
+            픽업주소: {
+                /** 견인 주소 (검색 주소) */
+                검색주소: RepairAddress;
+                /** 상세 위치 (고객 입력) */
+                상세위치: string;
+            } | null;
+            /** 차량을 인도받을 위치
+             * @condition 딜리버리 선택 시
+             */
+            딜리버리주소: {
+                /** 견인 주소 (검색 주소) */
+                검색주소: RepairAddress;
+                /** 상세 위치 (고객 입력) */
+                상세위치: string;
+            } | null;
+        };
+    } | null;
+    /** 외부수리 요청 내용 */
+    exterior: {
+        /** 수리 부분 사진 3장 이상 첨부 URL */
+        pictures: string[];
+        /** 수리 부위에 대한 설명 */
+        description: string;
+        /** 수리 방식 */
+        method: {
+            비보험수리: {
+                픽업: boolean;
+                딜리버리: boolean;
+            } | null;
+            보험수리: {
+                type: "자차" | "피해차";
+                픽업: boolean;
+                딜리버리: boolean;
+                렌트카: boolean;
+            } | null;
+        };
+        address: {
+            /** 견적주소를 기준으로 공업사에 견적 요청 */
+            견적주소: RepairAddress;
+            픽업주소: {
+                /** 견인 주소 (검색 주소) */
+                검색주소: RepairAddress;
+                /** 상세 위치 (고객 입력) */
+                상세위치: string;
+            } | null;
+            /** 차량을 인도받을 위치
+             * @condition 딜리버리 선택 시
+             */
+            딜리버리주소: {
+                /** 견인 주소 (검색 주소) */
+                검색주소: RepairAddress;
+                /** 상세 위치 (고객 입력) */
+                상세위치: string;
+            } | null;
+        };
+        damagedParts: CarPartitionKey[];
+    } | null;
+    /** 엔진오일 요청 내용 */
+    engineOil: {
+        /** 견적 서비스 */
+        service: {
+            type: "출장교환" | "방문교환";
+            /** 출장교환일 때 필수 */
+            출장교환위치: {
+                검색주소: RepairAddress;
+                내차량상세위치: string;
+            } | null;
+            /** 방문교환일 때 필수 */
+            방문교환위치: RepairAddress | null;
+        };
+        /** 교환 내용 */
+        method: {
+            에어필터: boolean;
+            에어컨필터: boolean;
+        };
+        /** 추가 요청 사항 (선택) */
+        additionalRequest: string | null;
+    } | null;
+    /** 타이어 요청 내용 */
+    tire: {
+        /** 견적 요청 위치 */
+        address: RepairAddress;
+        /** 추가 요청 사항 (선택) */
+        additionalRequest: string | null;
+        /** 선택 타이어 정보 */
+        tire: {
+            size: TireSize;
+            count: number;
+        };
+    } | null;
+};
+/** 견적서 내용 */
+export interface RepairEstimate {
+    /** 수리 항목 견적서 내용
+     * @note 사고수리, 외장수리일 때 정의
+     */
+    repairItems: {
+        /** 수리부위 */
+        repairPart: string;
+        /** 수리방법 */
+        repairMethod: string;
+        /** 부품 */
+        part: {
+            /** 부품명 */
+            name: string;
+            /** 새 부품 여부 */
+            isNew: boolean;
+            /** 부품비
+             * @note VAT 포함 가격
+             */
+            price: number;
+        } | null;
+        /** 공임비
+         * @note VAT 포함 가격
+         */
+        price: number;
+    }[] | null;
+    /** 엔진 오일 견적서 내용
+     * @note 엔진오일일 때 정의
+     */
+    engineOilItems: {
+        /** 엔진 오일 항목 */
+        engineOil: {
+            name: string;
+            /** 부품비
+             * @note VAT 포함 가격
+             */
+            price: number;
+        };
+        /** 추가 사항
+         * @example 에어필터, 에어컨필터 등
+         */
+        part: {
+            type: "오일필터" | "에어필터" | "에어컨필터";
+            /** 부품명 */
+            name: string;
+            /** 부품비
+             * @note VAT 포함 가격
+             */
+            price: number;
+            /** 새 부품 여부 */
+            isNew: boolean;
+        }[];
+        /** 공임비
+         * @note VAT 포함 가격
+         */
+        price: number;
+    } | null;
+    /** 타이어 견적서 내용
+     * @note 타이어일 때 정의
+     */
+    tireItems: {
+        /** 타이어 항목 */
+        tire: {
+            /** 타이어 브랜드 */
+            brandName: string;
+            /** 타이어 사이즈 */
+            size: TireSize;
+            /** 타이어 개수 */
+            count: number;
+            /** 타이어 비용
+             * @note 이 가격은 타이어 총 가격입니다. (타이어 한짝 가격 = price/count)
+             * @note VAT 포함 가격
+             */
+            price: number;
+        };
+        /** 장착 옵션
+         * @example 장착 옵션 1, 장착 옵션 2 등
+         */
+        options: {
+            type: "장착비용" | "휠 밸런스" | "휠 얼라인먼트";
+            /** 장착 옵션 비용
+             * @note VAT 포함 가격
+             */
+            price: number;
+            /** 무상 제공 여부 */
+            isFree: boolean;
+        }[];
+    } | null;
+    /** 추가 요청 사항 비용 */
+    additionalPrice?: {
+        /** 견인
+         * @note 사고수리에서만 가능
+         */
+        견인: {
+            /** 견인 비용
+             * @note VAT 포함 가격
+             * @note null: 무료 선택 시
+             */
+            price: number | null;
+        } | null;
+        /** 픽업 */
+        픽업: {
+            /** 픽업 비용
+             * @note VAT 포함 가격
+             * @note null: 무료 선택 시
+             * @note 사고수리, 외부수리에서만 가능
+             */
+            price: number | null;
+        } | null;
+        /** 딜리버리
+         * @note 사고수리, 외부수리에서만 가능
+         */
+        딜리버리: {
+            /** 딜리버리 비용
+             * @note null: 무료 선택 시
+             * @note VAT 포함 가격
+             */
+            price: number | null;
+        } | null;
+        /** 출장 */
+        출장: {
+            /** 출장 비용
+             * @note VAT 포함 가격
+             * @note null: 무료 선택 시
+             * @note 엔진오일 > 출장 방문일때
+             */
+            price: number | null;
+        } | null;
+    };
+    /** 예상 기간
+     * @note 엔진오일, 타이어일 경우 null
+     * @case null: 처리 X
+     * @case 0: 입고 당일로 처리
+     */
+    estimatedPeriod: number | null;
+    /** 무상 제공 가능 서비스 리스트 */
+    freeServices: string[];
+    /** 명세서 총 비용
+     * @note VAT 포함 가격
+     */
+    totalPrice: number;
+}
+/** 정비 진행 내용 */
+export interface RepairProgress {
+    /** 사고수리, 외부수리에서 사용 */
+    입고정보: {
+        /** 입고일
+         * @note YYYYMMDD
+         */
+        in_date: string;
+        /** 입고시 주행거리(km) */
+        mileage: number;
+        /** 입고 사진 URL */
+        pictures: string[];
+    } | null;
+    /** 사고수리, 외부수리에서 사용 */
+    수리정보: {
+        /** 수리일
+         * @note YYYYMMDD
+         */
+        start_date: string;
+        /** 수리 사진 URL */
+        pictures: string[];
+    } | null;
+    /** 사고수리, 외부수리에서 사용 */
+    수리완료정보: {
+        /** 수리 완료일 (출고일)
+         * @note YYYYMMDD
+         */
+        finish_date: string;
+        /** 수리 완료 사진 URL */
+        pictures: string[];
+        /** @note VAT 포함 가격 */
+        price: {
+            부품비: number;
+            공임비: number;
+            /** 차감되는 비용 (값이 -로 들어옴)
+             * @example 보험 차감금액이 "50000"이면 "-50000"을 저장
+             */
+            보험: number;
+            additionalPrice?: {
+                견인: RepairEstimate["additionalPrice"]["견인"] | null;
+                픽업: RepairEstimate["additionalPrice"]["픽업"] | null;
+                딜리버리: RepairEstimate["additionalPrice"]["딜리버리"] | null;
+            };
+            /** 총 비용
+             * @note VAT 포함 가격
+             */
+            totalPrice: number;
+        };
+        files: {
+            /** 파일 첨부 내용 */
+            "보험사 제출용 수리명세서": FileInfo | null;
+        };
+    } | null;
+    /** 엔진오일, 타이어에서 사용 */
+    교체완료정보: {
+        /** 입고일
+         * @note YYYYMMDD
+         */
+        in_date: string;
+        /** 입고시 주행거리(km) */
+        mileage: number;
+        /** 출고일
+         * @note YYYYMMDD
+         */
+        finish_date: string;
+        /** 교체 완료 사진 URL */
+        pictures: string[];
+        /** 엔진오일 교체 정보 */
+        engineOilItems: RepairEstimate["engineOilItems"] | null;
+        /** 타이어 교체 정보 */
+        tireItems: RepairEstimate["tireItems"] | null;
+        additionalPrice?: {
+            출장: RepairEstimate["additionalPrice"]["출장"] | null;
+        };
+        /** 총 비용
+         * @note VAT 포함 가격
+         */
+        totalPrice: number;
+    } | null;
+}
+/** 정비 리뷰 내용 */
+export interface RepairReview {
+    id: string;
+    /** 작성자 */
+    writer: {
+        id: string;
+        nickname: string;
+    };
+    /** 공업사 */
+    partner: {
+        id: string;
+        name: string;
+        location: string;
+    };
+    /**
+     * @true 좋아요
+     * @false 별로에요
+     */
+    isGood: boolean;
+    /** 평점 */
+    rating: number;
+    /** 선택 태그 내용 */
+    tags: string[];
+    /** 리뷰 내용 */
+    content: string;
+    /** 리뷰 내 첨부 이미지 url */
+    images: string[];
+    /** 공업사가 작성한 답글 */
+    partnerReply: {
+        content: string;
+        created_at: Date;
+    } | null;
+    /** 리뷰 작성 일시 */
+    created_at: Date;
+}
+/** 수리 주소 정보 */
+export interface RepairAddress {
+    /** 주소
+     * @example 서울특별시 중구 세종대로 110 1004호
+     */
+    address: string;
+    /** 위도 */
+    latitude: number;
+    /** 경도 */
+    longitude: number;
+}
+export interface RepairBidDescription {
+    id: number;
+    /** 이 값만 꺼내서 사용 */
+    content: string;
+    /** 생성/수정 일시 */
+    updated_at: Date;
+}
+/** 서버에서 조회한 서비스 가능 지역 데이터 */
+export interface RepairServiceAvailableRegionData {
+    엔진오일_출장정비_국산: RepairServiceAvailableRegion[];
+    엔진오일_출장정비_수입: RepairServiceAvailableRegion[];
+}
+/** 수리 가능 지역 정보 */
+export interface RepairServiceAvailableRegion {
+    /** 시도 */
+    name: SidoName;
+    /** undefined일 경우 "전 지역"
+     * @note 시군구
+     */
+    sigungu?: string[];
+}
+export interface Admin_RepairBid extends RepairBid {
+    repairShop: Admin_RepairShop;
+}
+/** 관리자가 조회한 스마트 정비 내용 */
+export interface Admin_Repair extends Repair {
+    member: RepairCustomer & {
+        name_real: string;
+    };
+    accepted_bid: Admin_RepairBid | null;
+    biddableRepairShop: {
+        repairShop: Admin_RepairShop;
+        bid: Admin_RepairBid | null;
+    }[];
+}
+export interface Repair_Settlement {
+    id: number;
+    amount: number;
+    /** 정산 정보 생성 일시 */
+    created_at: Date;
+    /** 정산 취소 사유 */
+    cancel_reason: string | null;
+    /** 정산 취소 일시 */
+    canceled_at: Date | null;
+    /** 대상 입찰 Id */
+    repair_bid_id: string;
+    /** 정산 대상 단위 Id */
+    repair_settlement_unit_id: number | null;
+    /** 견적 번호 */
+    repair_id: string;
+    /** 예약 번호 */
+    reservationNumber: string | null;
+    /** 견적 요청 유형 */
+    repairType: RepairType;
+    /** 정비 명세서 */
+    progress: RepairProgress | null;
+    /** 정산 대상 변경 내역 */
+    repair_settlement_history: Repair_Settlement_History[];
+}
+export interface Repair_Settlement_Unit {
+    id: number;
+    state: RepairSettlementUnitState;
+    /** 대상 공업사 Id */
+    partner_repairshop_id: string;
+    /** 정산 년월 */
+    year: number | null;
+    month: number | null;
+    /** 세금계산서 승인번호
+     * @note 세금계산서 승인번호가 있어야만 정산 요청이 가능합니다.
+     */
+    tax_invoice_approval_number: string | null;
+    /** 관리자에서 추가한 납부 정보 */
+    payment_info: {
+        /** 입금 계좌 */
+        account_number: string;
+        /** 예금주명 */
+        account_owner: string;
+        /** 입금 금액 */
+        amount: number;
+        /** 입금 기한 (YYYYMMDD) */
+        due_day: string;
+    } | null;
+    /** 정산 요청 일시 */
+    created_at: Date;
+    /** 정산 요청 일시 */
+    pending_at: Date | null;
+    /** 정산 취소 일시 */
+    canceled_at: Date | null;
+    /** 정산 완료 일시 */
+    finished_at: Date | null;
+    repair_settlement: Repair_Settlement[];
+}
+export interface Admin_Repair_Settlement_Unit extends Repair_Settlement_Unit {
+    partner_repairshop: Admin_RepairShop;
+    admin_memo: string | null;
+    repair_settlement_unit_history: Repair_Settlement_History[];
+}
+export interface Repair_Settlement_History {
+    title: string;
+    content: string;
+    created_at: Date;
+}

package/dist/types/modules/repair/interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });