from enum import Enum, auto from fastapi import HTTPException class CodeEnum(Enum): """OpenAPI 스키마에 x-enum-varnames(멤버 이름)을 실어 orval 이 이름 있는 enum 을 생성하게 하는 베이스.""" @classmethod def __get_pydantic_json_schema__(cls, core_schema, handler): json_schema = handler(core_schema) json_schema = handler.resolve_ref_schema(json_schema) json_schema["x-enum-varnames"] = [m.name for m in cls] return json_schema class ErrorType(Enum): """서버 전역 결과 코드. Res_WebPacketProtocol.result 에 담겨 클라이언트로 전달된다. HTTP status 와 겹치지 않도록 구간을 분리해서 관리한다. """ SUCCESS = 0 FAIL = 1 # DB / Redis 에러 DB_RUN_FAILED = 10 DB_ALREADY_SAME_KEY = auto() DB_INVALID_KEY = auto() DB_EMPTY_DATA = auto() DB_INVALID_TYPE = auto() # 요청/직렬화 에러 JSON_PARSE_ERROR = 100 INVALID_REQUEST_DATA = auto() INTERNAL_EXCEPTION = auto() # http 에러 코드와 겹치지 않게 설정 - router 전용 예외 발생 옵션 HTTP_FORBIDDEN = 403 HTTP_INVALID_CLIENT_REQUEST = 419 HTTP_TO_MANY_REQUEST = 429 HTTP_INVALID_CLIENT_ACCESS = 433 HTTP_ACCESS_TOKEN_EXPIRED = 434 HTTP_REFRESH_TOKEN_EXPIRED = 435 HTTP_INVALID_TOKEN_ACCESS = 436 # 계정 관련 에러 ACCOUNT_INVALID_INFO = 1200 ACCOUNT_ALREADY_EXIST = auto() ACCOUNT_BLOCKED_USER = auto() ACCOUNT_NOT_FOUND = auto() ACCOUNT_FORBIDDEN = auto() # 최고관리자 외 접근 / 다른 회사·최고관리자 대상 변경 시도 # 상품 관련 에러 ITEM_NOT_FOUND = 1300 ITEM_CODE_DUPLICATE = auto() # 협력사 관련 에러 SUPPLIER_NOT_FOUND = 1400 SUPPLIER_CODE_DUPLICATE = auto() SUPPLIER_ITEM_NOT_FOUND = auto() # 협력사-상품 매핑 미존재 SUPPLIER_ACCOUNT_NOT_FOUND = auto() # 채팅(협상) 계정 미발급 SUPPLIER_ACCOUNT_ALREADY_EXISTS = auto() # 협력사당 1계정 — 이미 발급됨 SUPPLIER_ACCOUNT_LOGIN_ID_DUPLICATE = auto() # 로그인 ID 전역 중복(supplier.supplier_users.id) # 견적 관련 에러 QUOTATION_NOT_FOUND = 1500 QUOTATION_NOT_LATEST_ROUND = auto() # 마지막 차수가 아닌 견적을 재생성하려 함 QUOTATION_TARGET_PRICE_UNAVAILABLE = auto() # md_price·인터넷최저가 둘 다 없어 목표가 산정 불가 # 견적 설정 관련 에러 QUOTATION_SETTING_NOT_FOUND = 1600 # 협상카드 관련 에러 CARD_NOT_FOUND = 1700 # 이미지 업로드 관련 에러 IMAGE_INVALID_TYPE = 1800 IMAGE_TOO_LARGE = auto() IMAGE_UPLOAD_FAILED = auto() # 초청 메일 발송 관련 에러 EMAIL_NOT_CONFIGURED = 1900 # ACS/SMTP 둘 다 미설정 — 발송 불가(설정 필요) EMAIL_SEND_FAILED = auto() # 발송 시도했으나 전부 실패(수신자 0 성공) # LPS(인터넷 최저가 검색) 연동 관련 에러 LPS_UNAVAILABLE = 2000 # lps_db 미등록(연동 비활성 환경) — 기능 사용 불가 LPS_REQUEST_FAILED = auto() # LPS 검색요청 API 호출 실패(LPS 다운/네트워크) # ErrorType 의 HTTP_* 값과 status_code 를 맞춰 router 단에서 raise 한다. EXCEPTION_FORBIDDEN = HTTPException(status_code=ErrorType.HTTP_FORBIDDEN.value, detail=ErrorType.HTTP_FORBIDDEN.name) EXCEPTION_INVALID_CLIENT_REQUEST = HTTPException(status_code=ErrorType.HTTP_INVALID_CLIENT_REQUEST.value, detail=ErrorType.HTTP_INVALID_CLIENT_REQUEST.name) EXCEPTION_TO_MANY_REQUEST = HTTPException(status_code=ErrorType.HTTP_TO_MANY_REQUEST.value, detail=ErrorType.HTTP_TO_MANY_REQUEST.name) EXCEPTION_INVALID_CLIENT_ACCESS = HTTPException(status_code=ErrorType.HTTP_INVALID_CLIENT_ACCESS.value, detail=ErrorType.HTTP_INVALID_CLIENT_ACCESS.name) EXCEPTION_ACCESS_TOKEN_EXPIRED = HTTPException(status_code=ErrorType.HTTP_ACCESS_TOKEN_EXPIRED.value, detail=ErrorType.HTTP_ACCESS_TOKEN_EXPIRED.name) EXCEPTION_REFRESH_TOKEN_EXPIRED = HTTPException(status_code=ErrorType.HTTP_REFRESH_TOKEN_EXPIRED.value, detail=ErrorType.HTTP_REFRESH_TOKEN_EXPIRED.name) EXCEPTION_HTTP_INVALID_TOKEN_ACCESS = HTTPException(status_code=ErrorType.HTTP_INVALID_TOKEN_ACCESS.value, detail=ErrorType.HTTP_INVALID_TOKEN_ACCESS.name) class DBType(Enum): """논리 DB 구분. 모델마다 DBType() 으로 자신이 속한 DB 를 반환한다. DB 가 늘어나면 여기에 추가하고 db_session_manager 의 맵에 등록만 하면 된다. """ MAIN = 1 LPS = 2 # 인터넷 최저가 검색(lps_db) — 읽기전용(price_history 동기화 배치용, write 엔진 미등록) class DBWRType(Enum): """Read / Write 접속 구분. 조회는 DB_READ, 변경은 DB_WRITE 엔진을 사용한다.""" DB_READ = 1 DB_WRITE = 2 # 도메인 코드값 class UserStatus(CodeEnum): """users.status 코드값.""" ACTIVE = 1 INACTIVE = 2 class UserRole(CodeEnum): """users.role 코드값. 1=일반, 2=최고관리자(고객사 최상위), 3=개발자(우리 내부 운영 계정). 개발자 계정은 고객사에 존재를 노출하지 않는다 — 회원 목록에서 빼고 총계에도 넣지 않는다.""" USER = 1 OWNER = 2 # 최고관리자: 자기 회사 계정 관리 + 회사 설정 DEVELOPER = 3 # 개발자(내부 운영): 최고관리자 권한 전부 + 고객사에 보이지 않음 class CompanyStatus(CodeEnum): """companies.status 코드값.""" ACTIVE = 1 INACTIVE = 2 class SupplierUserStatus(CodeEnum): """supplier.supplier_users.status 코드값. 협력사의 채팅(협상) 로그인 계정 상태 — 루트 backend 로그인이 ACTIVE 만 허용하므로 INACTIVE 로 두면 접속이 차단된다.""" ACTIVE = 1 INACTIVE = 2 class SupplierUserRole(CodeEnum): """supplier.supplier_users.role 코드값(루트 backend 소유 코드 미러링).""" USER = 1 MANAGER = 2 class QuotationType(CodeEnum): """quotations.type 코드값. 신규/재 × 협상(1:1)/견적(1:N). 1=재협상(1:1), 2=재견적(1:N), 3=신규협상(1:1), 4=신규견적(1:N). 기존 데이터 보존 위해 재협상/재견적 코드(1·2)는 고정, 신규는 3·4로 추가.""" RENEGO = 1 # 재협상(1:1) REQUOTE = 2 # 재견적(1:N) NEW_NEGO = 3 # 신규협상(1:1) NEW_QUOTE = 4 # 신규견적(1:N) @classmethod def is_new(cls, code) -> bool: """신규(NEW_*) 견적유형이면 True. 목표가 후보(신규=인터넷최저가만)가 이 분기에 의존하므로 한 곳에서만 판단한다.""" return code in (cls.NEW_NEGO.value, cls.NEW_QUOTE.value) @classmethod def is_auction(cls, code) -> bool: """1:N 경매(REQUOTE/NEW_QUOTE)면 True. 경매는 낙찰 가격정책 없이 '무조건 최저가 낙찰'(mid=over=AWARD 강제). 나머지(RENEGO/NEW_NEGO)는 1:1 협상 — 사용자가 낙찰 기준을 정하고 협상카드가 발동한다.""" return code in (cls.REQUOTE.value, cls.NEW_QUOTE.value) class QuotationStatus(CodeEnum): """quotations.status 코드값(SMALLINT). 프론트 견적상태 뱃지와 매핑된다.""" CREATED = 1 IN_PROGRESS = 2 CLOSED = 3 class SessionStatus(CodeEnum): """negotiation.sessions.status 코드값. 협력사별 협상 세션 진행 상태.""" CREATED = 1 IN_PROGRESS = 2 DONE = 3 NOT_PARTICIPATED = 4 REJECTED = 5 class CloseOutcome(Enum): """견적 마감 판정 결과(close_and_decide 반환값). 내부 제어·로그용 — DB 저장/프론트 노출 안 함.""" AWARDED = "awarded" # 낙찰 확정(기준 충족 단독 최저가) OPENED = "opened" # 개찰 — 낙찰자 미정으로 마감(자동 재협상/재생성·결렬 없음, 담당자 수동 처리) CLOSED = "closed" # 그냥 마감 (선점 실패로 이미 닫혀 있던 경우 포함) class CloseReason(CodeEnum): """quotations.close_reason 코드값(SMALLINT). 마감 사유 — 낙찰(AWARDED) 또는 개찰(OPEN_*)로 가른다. 개찰=결렬(유찰)이 아니라 '낙찰자 미정으로 마감' — 자동 재협상/재생성 없이 담당자가 수동 처리(수동 재생성 등)한다. (구 자동재협상 사유 REGEN_*(2~4)·유찰 개념은 폐지. 사유 플래그 값 5~8은 보존해 OPEN_* 로 재명명.)""" AWARDED = 1 # 낙찰 (기준 충족 단독 최저가) OPEN_PRICE = 5 # 개찰: 최저가가 낙찰 기준 미달(목표 초과 등) → 낙찰자 미정 OPEN_EQUAL = 6 # 개찰: 동가(최저가 동점) → 낙찰자 미정 OPEN_NOSHOW = 7 # 개찰: 전원 미응찰 OPEN_REJECT = 8 # 개찰: 협상거부 존재 class AwardType(CodeEnum): """quotations.award_type 코드값(SMALLINT). 낙찰이 어떻게 확정됐는지 — 통계에서 AI 협상 성과와 담당자 오프라인 낙찰을 나눈다. 미마감·미낙찰(개찰)이면 NULL. AUTO=시스템이 투찰가로 자동 낙찰 / MANUAL=담당자가 개찰 건을 오프라인 협상해 계약가로 직접 낙찰.""" AUTO = 1 # 자동 낙찰(close_and_decide, 투찰가 기준) MANUAL = 2 # 직접 낙찰(담당자 계약가 입력 — sessions.custom.offline_award 와 짝) class PriceGateAction(CodeEnum): """낙찰 기준(견적 단위) 가격게이트 판정값. '앵커링가<투찰가≤목표가'(mid) / '목표가<투찰가'(over) 구간에 적용. (투찰가≤앵커링가 는 항상 낙찰.) 기준 미달이면 개찰(낙찰자 미정 마감) — 재협상·결렬 없음. 1:1 협상: over 는 항상 OPEN(목표 초과는 개찰), mid 만 앵커/목표 선택. 1:N 경매: mid=over=AWARD(무조건 최저가 낙찰).""" AWARD = 1 # 낙찰(자동) OPEN = 2 # 개찰(낙찰자 미정 마감) class NotificationType(CodeEnum): """company.notifications.type 코드값. 견적 생애 이벤트를 작성자에게 통지. 마감 결과 3종(SUCCESS/REGENERATED/FAILURE)은 close_and_decide 와 1:1. 네이밍은 KTC.""" SUCCESS = 1 # 낙찰(단독 최저가) — KTC SUCCESS REGENERATED = 2 # 다음 라운드 자동 생성(동가/미참여) — KTC 대응어 없어 negodata 유지 FAILURE = 3 # 결렬: 낙찰 없이 마감(거절/부분/한도) — KTC FAILURE CREATED = 4 # 견적 생성됨(작성 직후) — 생성 알림 RENEGO_REQUESTED = 5 # 공급사가 재협상 요청(IMK #15) — 담당자가 승인/반려할 때까지 배너로 상시 노출 # 처리(승인·반려)하기 전에는 사라지지 않고 화면 하단 배너로 상시 노출되는 알림 유형. # 단순 통지(SUCCESS/FAILURE 등)와 달리 담당자의 액션을 기다리는 건이라 읽음 처리만으로 닫지 않는다. ACTION_REQUIRED_NOTIFICATIONS = {NotificationType.RENEGO_REQUESTED} class RenegotiationStatus(CodeEnum): """sessions.custom.renegotiation.status — 공급사 재협상 요청 상태(IMK #15). 전용 테이블 없이 JSONB 에 둔다.""" PENDING = 1 # 접수, 담당자 심사 대기 APPROVED = 2 # 승인 — 다음 라운드 생성 완료 REJECTED = 3 # 반려 — 사유 기록 CANCELED = 4 # 공급사가 철회 class ChatSender(CodeEnum): """negotiation.chats.sender 코드값. 채팅 발신 주체.""" BOT = 1 USER = 2 class DeliveryType(CodeEnum): """items.delivery_type 코드값. 협상 채팅의 배송형태 선택지와 동일 집합.""" SUPPLIER = 1 # 협력사배송 COURIER = 2 # 지정택배배송 PICKUP = 3 # 픽업배송 class CardStatus(CodeEnum): """nego_cards.status 코드값. 와일드카드의 협상 적용 여부(수동 승인). 일반 협상카드는 상시 ACTIVE.""" ACTIVE = 1 INACTIVE = 2 class CardType(CodeEnum): """negotiation.chats.card_type / quotation_cards.type 코드값. 1=nego_card, 2=wild_card.""" NEGO = 1 WILD = 2 class SupplierType(CodeEnum): """partner.supplier_items.supply_type 코드값. 없음(0,미지정)/유통(1)/제조(2)/총판(3). 없음은 상품-협력사 매핑에서 유형 미지정 상태를 뜻한다.""" NONE = 0 # 없음(미지정) DISTRIBUTION = 1 # 유통 MANUFACTURE = 2 # 제조 SOLE_AGENCY = 3 # 총판 class LowestPriceWebsite(CodeEnum): """partner.item_internet_lowest_prices.website — 최저가 수집 사이트 코드. LPS(lps_db.price_history.final_source)의 소스 문자열을 코드값으로 매핑한다.""" NAVER = 1 COUPANG = 2 GMARKET = 3 AUCTION = 4 ST11 = 5 ETC = 99 @classmethod def from_source(cls, source) -> "LowestPriceWebsite": return { "naver": cls.NAVER, "coupang": cls.COUPANG, "gmarket": cls.GMARKET, "auction": cls.AUCTION, "st11": cls.ST11, }.get((source or "").lower(), cls.ETC) class CardUsageType(CodeEnum): """nego_cards/wild_cards.usage_type 코드값. 협상카드 사용 범위(신규/재 견적·협상 양쪽 적용). 공통=모두 적용(기본), 신규견적전용, 재견적전용.""" COMMON = 1 # 공통(모두) — 기본 NEW = 2 # 신규견적전용 REUSE = 3 # 재견적전용