images: hetbahn_pack1.jpg, hetbahn_pack2.jpg

{
  "isAppropriate": true,
  "rejectionReason": null,
  "title": "햇반 210g 새 제품 4개 교환해요",
  "content": "햇반 210g 새 제품입니다. 24개입 세트 중 4개를 교환하려고요. 미개봉 상태입니다.",
  "confidence": 0.97
}

{
  "title": "햇반 210g 작은공기",
  "content": "24개입 세트로 구매했는데 다 못 먹을 것 같아서 4개만 교환하려고요. 미개봉 새 제품이고 유통기한은 2027년 6월까지예요."
}

{
  "title": "햇반 210g 작은공기",
  "content": "24개입 세트로 구매했는데 다 못 먹을 것 같아서 4개만 교환하려고요. 미개봉 새 제품이에요.",
  "valueTolerance": 0.6,
  "tradeSpeed": 0.4
}

{
  "referenceUnitPrice": 1300,
  "minUnitPrice": 1090,
  "maxUnitPrice": 1300,
  "priceSource": "new",
  "confidence": null
}

1. prices가 3개 이상이면 이상치 제거 (IQR 기준). 제거 결과 0개가 되면 원본 전체 사용.
   2개 이하면 이상치 제거 생략.
2. 평균 → referenceUnitPrice (10원 단위 반올림)
3. discountRate = (valueTolerance × 0.7 + tradeSpeed × 0.3) × 0.3  (최대 할인폭 30%)
4. maxUnitPrice = referenceUnitPrice
   minUnitPrice = referenceUnitPrice × (1 − discountRate), 10원 단위 반올림

{
  "message": "탈퇴는 어떻게 해요?",
  "history": []
}

{
  "answer": "탈퇴는 마이페이지 > 계정 설정 > 탈퇴하기에서 진행하실 수 있어요. 탈퇴 후 7일 뒤 데이터가 완전히 삭제돼요.",
  "action": { "label": "마이페이지로 이동", "screen": "MY_PAGE" }
}

{
  "candidates": [
    { "item_id": "item_101", "title": "다우니 섬유유연제 4L 새 제품 여분", "description": "대용량으로 구매했는데 2병이 생겨서 1병 교환합니다. 미개봉 새 제품" },
    { "item_id": "item_102", "title": "질레트 퓨전 면도날 8입 중 여분 4개", "description": "새 제품 미개봉, 다른 브랜드로 바꾸면서 여분이 생겼어요" },
    { "item_id": "item_103", "title": "동서 맥심 스틱커피 100개입 중 여분 30개", "description": "새 제품, 다 못 마실 것 같아 나눔합니다" }
  ],
  "preference_text": "세제나 생필품 여분 있으면 좋아요",
  "wishlist_titles": ["질레트 퓨전 면도날 새 제품 여분"],
  "recent_search_keywords": ["섬유유연제", "생필품 나눔"],
  "requested_item_titles": [],
  "completed_trade_titles": ["다우니 섬유유연제 4L 새 제품 여분"]
}

{ "results": ["item_101", "item_102"] }

{
  "original_text": "그건 좀 아닌 것 같은데요 다른 걸로 주세요",
  "my_profile": {
    "tone": "정중하게",
    "explanation_style": "적당히 설명",
    "opinion_expression": "분명하게"
  },
  "opponent_profile": {
    "tone": "친근하게",
    "explanation_style": "자세히 설명",
    "opinion_expression": "부드럽게"
  }
}

{ "refined_text": "말씀 주신 조건은 조금 어려울 것 같아요. 혹시 다른 물건으로 조율해볼 수 있을까요?" }

사용자
 ↓
Frontend
 ↓
Backend
 ↓
AI API Server (FastAPI)
 ↓
Claude API (모델) / 서버 알고리즘
 ↓
Backend
 ↓
Frontend

AI 서버 (FastAPI)
POST /api/vision/analyze-item 요청 수신
        │
        ▼
Claude Vision API (claude-sonnet-5)
검열 + 제품 식별 + 등록용 초안 작성 (JSON 응답)
        │
        ▼
AI 서버 (FastAPI): 응답 매핑 처리
        │
   ┌────┴────┐
   ▼         ▼
검증 실패    검증 통과
(422)       (200)
   │         │
   ▼    ┌────┴────┐
사진     ▼         ▼
재업로드  confidence   confidence
안내    ≥ 0.25       < 0.25
        │            │
        ▼            ▼
     title/content   title/content = null
     그대로 반환      직접 입력 안내

AI 서버 (FastAPI)
POST /api/moderation/check-text 요청 수신
        │
        ▼
Claude API (claude-haiku-4.5)
제목·내용 검증 (JSON 응답)
        │
        ▼
AI 서버 (FastAPI): 응답 매핑 처리
        │
   ┌────┴────┐
   ▼         ▼
검증 실패    검증 통과
(422)       (200, 본문 없음)
   │         │
   ▼         ▼
텍스트 수정   다음 단계(가치 평가) 진행
안내 반환    (등록·DB 저장은 이 API 범위 밖)

AI 서버 (FastAPI)
POST /api/value/estimate-price 요청 수신
        │
        ▼
Claude API (claude-sonnet-5, web_search 활성화)
쇼핑몰 가격 검색 + 산정 (JSON 응답: prices, source, confidence)
        │
        ▼
AI 서버 (FastAPI): 알고리즘 처리
(이상치 제거 → 평균=referenceUnitPrice → 할인율 계산 → minUnitPrice)
        │
        ▼
AI 서버 (FastAPI): 응답 매핑 처리
        │
   ┌────┴────┐
   ▼         ▼
처리 실패    처리 성공
(500)       (200)
   │         │
   ▼         ▼
등록 차단,   referenceUnitPrice / minUnitPrice /
재시도 안내  maxUnitPrice / priceSource / confidence 반환
            (사용자에게 노출되지 않음, 매칭에만 사용)

AI 서버 (FastAPI)
POST /api/chatbot/ask 요청 수신
        │
        ▼
메시지 임베딩 → ChromaDB에서 12개 정책 섹션과 유사도 비교 → 상위 1~2개 추출
        │
        ▼
Claude API (claude-sonnet-5)
정책 답변 생성 또는 화면 이동 판단 (JSON 응답: answer, action)
        │
        ▼
AI 서버 (FastAPI): 응답 파싱 및 반환
        │
        ▼
[프론트] answer 표시 + action 있으면 버튼 렌더링, 클릭 시 이동

[Frontend] 스마트 검색 실행
      │  group_id 함께 전달
      ▼
[Backend] 본인 인증 + 모임 소속 확인
      │
      ▼
[Backend] 후보 필터링 (알고리즘)
      본인 물건 제외, 내 총 가치범위와 겹치는 후보만 추출
      후보 50개 초과 시 최신순으로 50개로 축소
      │
      ▼
[Backend] 취향 신호 일괄 조회 (DB)
      │
┄┄┄┄┄┄┄ 이 아래부터 AI 서버 영역 ┄┄┄┄┄┄┄
      │
신호가 하나라도 있음
      ▼
[AI 서버] POST /api/search/rank-candidates
      │
      ▼
Claude API (claude-sonnet-5)
후보 전체를 직접 읽고 취향 신호와 의미적으로 비교, 순위 매김
      │
      ▼
[AI 서버] 응답 매핑 → 성공(200) / 실패(500)
┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄
      │
신호 전혀 없음 → AI 서버 호출 없이 [Backend]가 가격 근접순 반환
      │
      ▼
[Backend] item_id로 상세정보 재조회 → [Frontend] 카드 표시

[Frontend] 메시지 작성 완료 후 [AI 다듬기] 클릭
      │
      ▼
[Backend] 참여자 검증 + 양측 프로필 조회 (물건정보·대화내역 미조회)
      ▼
[AI Server] → [Claude] 톤 조정
      │
      ▼
[Frontend] 원본/다듬어진 버전 나란히 미리보기
      │
      ▼
[Frontend] [적용하기] → 입력창 텍스트 교체 (전송 아님)

images: hetbahn_pack1.jpg, hetbahn_pack2.jpg

{
  "isAppropriate": true,
  "rejectionReason": null,
  "title": "햇반 210g 새 제품 4개 교환해요",
  "content": "햇반 210g 제품입니다. 24개입 세트로 구매했는데 다 못 먹을 것 같아서 4개만 교환하려고요. 미개봉 새 제품이고 유통기한은 2027년 6월까지예요.",
  "confidence": 0.97
}

{
  "error": "unrelated_photo",
  "message": "상품과 무관한 사진이 섞여 있어요. 교환할 물건이 담긴 사진으로 다시 올려주세요"
}

{
  "title": "햇반 210g 새 제품 4개 교환해요",
  "content": "24개입 세트로 구매했는데 다 못 먹을 것 같아서 4개만 교환하려고요. 미개봉 새 제품이고 유통기한은 2027년 6월까지예요."
}

{
  "title": "햇반 24개입 세트에서 4개 팔아요, 연락은 010-1234-5678로 주세요",
  "content": "미개봉 새 제품, 가격 협의 가능합니다."
}

{ "error": "personal_contact", "message": "개인 연락처는 채팅으로만 주고받을 수 있어요. 게시글에서 연락처를 제거해주세요." }

{
  "title": "햇반 210g 4개 교환해요",
  "content": "미개봉 새 제품이고, 개당 1000원 정도로 생각하시면 돼요."
}

{ "error": "price_mention", "message": "게시글에는 가격을 직접 언급할 수 없어요. 가격 관련 내용은 제거해주세요." }

{
  "title": "햇반 210g 새 제품 4개 교환해요",
  "content": "24개입 세트로 구매했는데 다 못 먹을 것 같아서 4개만 교환하려고요. 미개봉 새 제품이에요.",
  "valueTolerance": 0.6,
  "tradeSpeed": 0.4
}

{
  "referenceUnitPrice": 1300,
  "minUnitPrice": 1090,
  "maxUnitPrice": 1300,
  "priceSource": "new",
  "confidence": null
}

{
  "referenceUnitPrice": 12000,
  "minUnitPrice": 10060,
  "maxUnitPrice": 12000,
  "priceSource": "estimated",
  "confidence": 0.4
}

{
  "message": "탈퇴는 어떻게 해요?",
  "history": []
}

{
  "answer": "탈퇴는 마이페이지 > 계정 설정 > 탈퇴하기에서 진행하실 수 있어요. 탈퇴 후 7일 뒤 데이터가 완전히 삭제돼요.",
  "action": { "label": "마이페이지로 이동", "screen": "MY_PAGE" }
}

{
  "message": "환불 정책이 뭐예요?",
  "history": []
}

{
  "answer": "정확한 답변을 찾지 못했어요. 1:1 문의로 연결해드릴까요?",
  "action": { "label": "1:1 문의하기", "screen": "INQUIRY" }
}

{
  "candidates": [
    { "item_id": "item_101", "title": "다우니 섬유유연제 4L 새 제품 여분", "description": "대용량으로 구매했는데 2병이 생겨서 1병 교환합니다. 미개봉 새 제품" },
    { "item_id": "item_102", "title": "질레트 퓨전 면도날 8입 중 여분 4개", "description": "새 제품 미개봉, 다른 브랜드로 바꾸면서 여분이 생겼어요" },
    { "item_id": "item_103", "title": "동서 맥심 스틱커피 100개입 중 여분 30개", "description": "새 제품, 다 못 마실 것 같아 나눔합니다" }
  ],
  "preference_text": "세제나 생필품 여분 있으면 좋아요",
  "wishlist_titles": ["질레트 퓨전 면도날 새 제품 여분"],
  "recent_search_keywords": ["섬유유연제", "생필품 나눔"],
  "requested_item_titles": [],
  "completed_trade_titles": ["다우니 섬유유연제 4L 새 제품 여분"]
}

{ "results": ["item_101", "item_102"] }

{
  "original_text": "그건 좀 아닌 것 같은데요 다른 걸로 주세요",
  "my_profile": {
    "tone": "정중하게",
    "explanation_style": "적당히 설명",
    "opinion_expression": "분명하게"
  },
  "opponent_profile": {
    "tone": "친근하게",
    "explanation_style": "자세히 설명",
    "opinion_expression": "부드럽게"
  }
}

{ "refined_text": "말씀 주신 조건은 조금 어려울 것 같아요. 혹시 다른 물건으로 조율해볼 수 있을까요?" }