dcce82a630
- /v1/negotiation/sessions/{id}/chat/{init,messages,send} 추가
- agent(9500) 위임 어댑터(IAgentClient) + mock(use_mock) 격리 → agent 미연동 시 1402 graceful degrade
- negotiation.chats 메시지 영속화(meta JSONB) + 종료 시 세션 입찰/거부 확정(단일 트랜잭션)
- 동시전송 가드(유저 메시지 pre-claim/CHAT_IN_PROGRESS) + 실패 시 롤백, 마감/만료 분기, init 만료 정리
- ChatSender enum, chat 에러코드(1400~1403), chats ORM 모델, AgentConfig
- 테스트 10건(test_chat.py), AGENT_INTEGRATION.md 연동 규약 문서
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
143 lines
5.7 KiB
Python
143 lines
5.7 KiB
Python
from enum import Enum, auto
|
|
|
|
from fastapi import HTTPException
|
|
|
|
|
|
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_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()
|
|
TOKEN_REVOKED = auto() # 제시된 토큰이 저장된 토큰과 불일치(로그아웃/타기기 로그인으로 교체됨)
|
|
|
|
# 협상(negotiation) 관련 에러 — 프론트 toast 용 코드
|
|
NEGO_FORBIDDEN = 1300 # 공급사 불일치(권한 없음)
|
|
NEGO_NOT_PARTICIPABLE = auto() # 1301 세션 상태가 미참여/협상거부라 참여 불가
|
|
NEGO_QUOTATION_CLOSED = auto() # 1302 견적 마감 상태
|
|
NEGO_DEADLINE_PASSED = auto() # 1303 견적 마감 시간 초과
|
|
NEGO_NOT_FOUND = auto() # 1304 세션/견적 없음
|
|
|
|
# 채팅(chat) 관련 에러
|
|
CHAT_NOT_IN_PROGRESS = 1400 # 협상중 상태가 아니라 대화 불가(미참여/완료/거부)
|
|
CHAT_PRICE_OUT_OF_RANGE = auto() # 1401 제시가가 허용 범위를 벗어남
|
|
CHAT_AGENT_UNAVAILABLE = auto() # 1402 협상 에이전트(agent) 호출 실패
|
|
CHAT_IN_PROGRESS = auto() # 1403 직전 턴 처리 중(동시 전송 가드)
|
|
|
|
|
|
# ErrorType 의 HTTP_* 값과 status_code 를 맞춰 router 단에서 raise 한다.
|
|
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 의 맵에 등록만 하면 된다.
|
|
물리적으로 같은 negosium_db 라도 도메인별 논리 구분으로 나눠 둘 수 있다(커넥션 config 는 재사용).
|
|
"""
|
|
|
|
USER = 1 # 기본 유저 (supplier_users 테이블)
|
|
PARTNER = 2 # partner 도메인 (partner.suppliers, partner.items 등)
|
|
NEGOTIATION = 3 # negotiation 도메인 (negotiation.sessions 등)
|
|
QUOTATION = 4 # quotation 도메인 (quotation.quotations 등)
|
|
|
|
|
|
class DBWRType(Enum):
|
|
"""Read / Write 접속 구분. 조회는 DB_READ, 변경은 DB_WRITE 엔진을 사용한다."""
|
|
|
|
DB_READ = 1
|
|
DB_WRITE = 2
|
|
|
|
|
|
# ============================================================
|
|
# 도메인 코드값. 스키마는 SMALLINT 정수 코드(1부터)로 두고, 의미 매핑은 여기 enum 으로 한다.
|
|
# (postgres-init/01-schema.sql: "코드값(status/role/type 등)은 SMALLINT 정수 코드로 둔다")
|
|
# ============================================================
|
|
class AccountStatus(Enum):
|
|
"""계정 상태 코드. company.users / supplier.supplier_users 의 status 컬럼."""
|
|
|
|
ACTIVE = 1 # 활성
|
|
INACTIVE = 2 # 비활성
|
|
|
|
|
|
class UserRole(Enum):
|
|
"""유저 권한 코드. company.users / supplier.supplier_users 의 role 컬럼."""
|
|
|
|
USER = 1 # 일반 유저
|
|
MANAGER = 2 # 매니저
|
|
|
|
|
|
class TokenType(Enum):
|
|
"""토큰 종류 코드. supplier.supplier_user_tokens 의 type 컬럼."""
|
|
|
|
ACCESS = 1
|
|
REFRESH = 2
|
|
|
|
|
|
class QtType(Enum):
|
|
"""견적/세션 유형 코드. quotation.quotations.type / negotiation.sessions.qt_type."""
|
|
|
|
RENEGO = 1 # 재협상(1:1)
|
|
REQUOTE = 2 # 재견적(1:N)
|
|
|
|
|
|
class SessionStatus(Enum):
|
|
"""협상 세션 진행 상태 코드. negotiation.sessions.status.
|
|
⚠️ 세션을 생성/갱신하는 쪽(바이어/agent)과 코드값이 일치해야 한다.
|
|
"""
|
|
|
|
CREATED = 1 # 협상생성
|
|
IN_PROGRESS = 2 # 협상중
|
|
DONE = 3 # 협상완료
|
|
NOT_PARTICIPATED = 4 # 미참여
|
|
REJECTED = 5 # 협상거부
|
|
|
|
|
|
class QuotationStatus(Enum):
|
|
"""견적 진행 상태 코드. quotation.quotations.status.
|
|
⚠️ 견적을 생성/갱신하는 쪽(바이어/agent)과 코드값이 일치해야 한다.
|
|
"""
|
|
|
|
CREATED = 1 # 견적생성
|
|
IN_PROGRESS = 2 # 견적진행중
|
|
CLOSED = 3 # 견적마감
|
|
|
|
|
|
class ChatSender(Enum):
|
|
"""채팅 발신자 코드. negotiation.chats.sender.
|
|
BOT 은 갑(바이어/agent)이 제시하는 협상 메시지, USER 는 공급사(접속 유저)의 입력이다.
|
|
"""
|
|
|
|
BOT = 1 # 갑(바이어/agent) — bot 메시지
|
|
USER = 2 # 공급사(을) — user 입력
|