라우터가 req.model_dump(exclude_unset=True)로 dict를 만들어 넘기던 것을 req(Req_*) 객체 그대로 전달하도록 변경. 서비스 시그니처를 전부 타입드로 통일. - create 5개(quotation/card/item/supplier/quotation_setting): ORM은 명시 kwargs 조립(item만 컬럼 16개라 model_dump 펼침). 경계 검증·타입 유지, **data 결합 제거. - update 4개: 서비스가 req 받아 내부에서 model_dump(exclude_unset=True) 생성 후 CRUD(dict)로 전달 — 공식 PATCH 메커니즘 유지. - 서비스 계층 data: dict 시그니처 0개. CRUD는 dict 유지(의도). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
95 lines
4.5 KiB
Python
95 lines
4.5 KiB
Python
from uuid import UUID
|
|
|
|
from fastapi import APIRouter, Depends, File, Query, UploadFile
|
|
|
|
from common.models.gmodel import PageParams, UserInfo
|
|
from router.v1.validator.dependencies import IsValidAccessToken, RemoveNoneResponse
|
|
from services.item_service import ItemService
|
|
from .protocol import (
|
|
Req_CheckCodes,
|
|
Req_CreateItem,
|
|
Req_UpdateItem,
|
|
Res_CheckCodes,
|
|
Res_DeleteItem,
|
|
Res_Item,
|
|
Res_ItemCategories,
|
|
Res_ItemImage,
|
|
Res_ItemList,
|
|
Res_LowestPriceResult,
|
|
Res_LowestPriceTrigger,
|
|
)
|
|
|
|
# 라우터(컨트롤러). 인증(Depends(IsValidAccessToken))으로 UserInfo 를 받아 company_id 로 스코프.
|
|
router = APIRouter(prefix="/v1/item", tags=["Item"], responses={404: {"description": "Not found"}})
|
|
|
|
|
|
@router.get(path="/list", response_model=Res_ItemList, summary="상품 목록")
|
|
async def list_items(
|
|
service: ItemService = Depends(),
|
|
user_info: UserInfo = Depends(IsValidAccessToken),
|
|
search: str | None = Query(None, description="상품명/상품코드 검색"),
|
|
category: str | None = Query(None, description="카테고리 필터"),
|
|
pg: PageParams = Depends(),
|
|
):
|
|
return RemoveNoneResponse(await service.list_items(user_info.company_id, search, category, pg))
|
|
|
|
|
|
@router.get(path="/categories", response_model=Res_ItemCategories, summary="상품 카테고리 목록(distinct)")
|
|
async def list_item_categories(service: ItemService = Depends(), user_info: UserInfo = Depends(IsValidAccessToken)):
|
|
return RemoveNoneResponse(await service.list_categories(user_info.company_id))
|
|
|
|
|
|
@router.post(path="/create", response_model=Res_Item, summary="상품 등록")
|
|
async def create_item(req: Req_CreateItem, service: ItemService = Depends(), user_info: UserInfo = Depends(IsValidAccessToken)):
|
|
return RemoveNoneResponse(
|
|
await service.create_item(user_info.company_id, user_info.user_id, req)
|
|
)
|
|
|
|
|
|
@router.post(path="/check-codes", response_model=Res_CheckCodes, summary="코드 중복 사전검사(업로드 즉시)")
|
|
async def check_item_codes(req: Req_CheckCodes, service: ItemService = Depends(), user_info: UserInfo = Depends(IsValidAccessToken)):
|
|
return RemoveNoneResponse(await service.check_codes(user_info.company_id, req.codes))
|
|
|
|
|
|
@router.post(path="/image", response_model=Res_ItemImage, summary="상품 이미지 업로드(Azure Blob)")
|
|
async def upload_item_image(
|
|
service: ItemService = Depends(),
|
|
user_info: UserInfo = Depends(IsValidAccessToken),
|
|
file: UploadFile = File(...),
|
|
):
|
|
return RemoveNoneResponse(await service.upload_image(user_info.company_id, file))
|
|
|
|
|
|
@router.get(path="/{item_id}", response_model=Res_Item, summary="상품 조회")
|
|
async def get_item(item_id: UUID, service: ItemService = Depends(), user_info: UserInfo = Depends(IsValidAccessToken)):
|
|
return RemoveNoneResponse(await service.get_item(user_info.company_id, str(item_id)))
|
|
|
|
|
|
@router.patch(path="/update/{item_id}", response_model=Res_Item, summary="상품 수정")
|
|
async def update_item(
|
|
item_id: UUID, req: Req_UpdateItem, service: ItemService = Depends(), user_info: UserInfo = Depends(IsValidAccessToken)
|
|
):
|
|
return RemoveNoneResponse(await service.update_item(user_info.company_id, str(item_id), req))
|
|
|
|
|
|
@router.delete(path="/delete/{item_id}", response_model=Res_DeleteItem, summary="상품 삭제")
|
|
async def delete_item(item_id: UUID, service: ItemService = Depends(), user_info: UserInfo = Depends(IsValidAccessToken)):
|
|
return RemoveNoneResponse(await service.delete_item(user_info.company_id, str(item_id)))
|
|
|
|
|
|
@router.post(path="/{item_id}/lowest-price", response_model=Res_LowestPriceTrigger, summary="최저가 수집 요청(스텁)")
|
|
async def trigger_lowest_price(item_id: UUID, service: ItemService = Depends(), user_info: UserInfo = Depends(IsValidAccessToken)):
|
|
# 존재/소유 확인만 (없으면 result 에 ITEM_NOT_FOUND)
|
|
got = await service.get_item(user_info.company_id, str(item_id))
|
|
if got.item is None:
|
|
return RemoveNoneResponse(got)
|
|
return RemoveNoneResponse(Res_LowestPriceTrigger(item_id=str(item_id), status="queued", message="최저가 수집 요청됨(스텁)"))
|
|
|
|
|
|
@router.get(path="/{item_id}/lowest-price", response_model=Res_LowestPriceResult, summary="최저가 수집 결과(스텁)")
|
|
async def get_lowest_price(item_id: UUID, service: ItemService = Depends(), user_info: UserInfo = Depends(IsValidAccessToken)):
|
|
got = await service.get_item(user_info.company_id, str(item_id))
|
|
if got.item is None:
|
|
return RemoveNoneResponse(got)
|
|
return RemoveNoneResponse(Res_LowestPriceResult(item_id=str(item_id), results=[], message="최저가 수집 결과 없음(스텁)"))
|