"""FAQ 조회 + 승인(검증 상태 전이).""" import uuid from fastapi import Depends from common.database.db_session_manager import DB_SESSION_MNG from common.database.model.models import place_faqs, places from common.enums import ( CANDIDATE_FACT_STATUSES, FACT_STATUS_TRANSITIONS, PUBLISHABLE_FACT_STATUSES, DBWRType, ErrorType, FactStatus, SourceType, ) from common.logger import LOG from common.models.gmodel import UserInfo from common.utils.gtime import GTime from crud.faq_crud import FaqCRUD, IFaqCRUD from crud.place_crud import PlaceCRUD from router.v1.faq.protocol import FaqData, Req_CreateFaq, Req_TransitionFaq, Res_Faq, Res_FaqList class FaqService: def __init__(self, crud: IFaqCRUD = Depends(FaqCRUD), place_crud: PlaceCRUD = Depends(PlaceCRUD)): self.crud = crud self.place_crud = place_crud # 사업장 로드(사장님 스코프) async def _load_place(self, user_info: UserInfo, place_id: str): """owner_user_id 를 WHERE 에 걸어 조회한다 — 남의 place_id 를 넣으면 PLACE_NOT_FOUND.""" err_type, place = await DB_SESSION_MNG.execute_lambda( places.DBType(), DBWRType.DB_READ.value, lambda s: self.place_crud.get_place(s, uuid.UUID(user_info.user_id), uuid.UUID(place_id)), ) if err_type != ErrorType.SUCCESS: return ErrorType.PLACE_NOT_FOUND, None return ErrorType.SUCCESS, place async def _mark_content_updated(self, place_id: str, ts): err = await DB_SESSION_MNG.execute_lambda_run([places.DBType()], [lambda s: self._touch(s, place_id, ts)]) if err != ErrorType.SUCCESS: LOG.e_no_callstack(f"[faq] content_updated_at 갱신 실패 place={place_id}") async def _touch(self, s, place_id: str, ts): from sqlalchemy import update query = update(places).where(places.place_id == uuid.UUID(place_id)).values(content_updated_at=ts, updated_at=ts) return await DB_SESSION_MNG.add(s, query) async def _reload(self, res: Res_Faq, pid, faq_id) -> Res_Faq: _e, row = await DB_SESSION_MNG.execute_lambda( place_faqs.DBType(), DBWRType.DB_READ.value, lambda s: self.crud.get_faq(s, pid, faq_id), ) res.faq = FaqData.model_validate(row) if row is not None else None return res # 조회 async def list_faqs(self, user_info: UserInfo, place_id: str, publishable_only: bool = False) -> Res_FaqList: """publishable_only=True → ★ 사이트에 나갈 수 있는 것만(빌드가 보는 것과 같은 집합).""" res = Res_FaqList() err_type, _place = await self._load_place(user_info, place_id) if err_type != ErrorType.SUCCESS: res.result.SetResult(err_type) return res pid = uuid.UUID(place_id) list_err, rows = await DB_SESSION_MNG.execute_lambda( place_faqs.DBType(), DBWRType.DB_READ.value, lambda s: self.crud.list_faqs(s, pid, publishable_only), ) if list_err != ErrorType.SUCCESS: res.result.SetResult(list_err) return res res.faqs = [FaqData.model_validate(r) for r in rows] res.publishable = sum(1 for r in rows if FactStatus(r.status) in PUBLISHABLE_FACT_STATUSES) res.pending_review = sum(1 for r in rows if FactStatus(r.status) in CANDIDATE_FACT_STATUSES) return res # 직접 추가 async def create_faq(self, user_info: UserInfo, place_id: str, req: Req_CreateFaq) -> Res_Faq: """사장님이 직접 쓴 FAQ 를 넣는다 — fact 의 owner 입력과 같은 철학으로 바로 노출값(VERIFIED)이 된다.""" res = Res_Faq() err_type, _place = await self._load_place(user_info, place_id) if err_type != ErrorType.SUCCESS: res.result.SetResult(err_type) return res question = (req.question or "").strip() answer = (req.answer or "").strip() if not question or not answer: # 빈 문답은 사이트에 렌더도 안 되고 고유 콘텐츠로도 안 세진다 — 애초에 받지 않는다. res.result.SetResult(ErrorType.INVALID_REQUEST_DATA) return res pid = uuid.UUID(place_id) sort_order = req.sort_order if sort_order is None: # 순서를 안 주면 맨 뒤에 붙인다 — 기존 FAQ 사이에 끼어들어 순서를 흔들지 않게. _e, rows = await DB_SESSION_MNG.execute_lambda( place_faqs.DBType(), DBWRType.DB_READ.value, lambda s: self.crud.list_faqs(s, pid, False), ) sort_order = max((r.sort_order for r in rows), default=-1) + 1 row = place_faqs( place_id=pid, question=question, answer=answer, generated_by=SourceType.OWNER.value, status=FactStatus.VERIFIED.value, sort_order=sort_order, ) run_err = await DB_SESSION_MNG.execute_lambda_run([place_faqs.DBType()], [lambda s: self.crud.add_faq(s, row)]) if run_err != ErrorType.SUCCESS: res.result.SetResult(run_err) return res await self._mark_content_updated(place_id, GTime.UTC()) return await self._reload(res, pid, row.faq_id) # 검증 상태 전이(승인 · 정정 · 반려) async def transition(self, user_info: UserInfo, place_id: str, faq_id: str, req: Req_TransitionFaq) -> Res_Faq: """생성된 FAQ 를 승인하거나, 문구를 고쳐 승인하거나, 반려한다.""" res = Res_Faq() err_type, _place = await self._load_place(user_info, place_id) if err_type != ErrorType.SUCCESS: res.result.SetResult(err_type) return res pid = uuid.UUID(place_id) fid = uuid.UUID(faq_id) get_err, faq = await DB_SESSION_MNG.execute_lambda( place_faqs.DBType(), DBWRType.DB_READ.value, lambda s: self.crud.get_faq(s, pid, fid), ) if get_err != ErrorType.SUCCESS: res.result.SetResult(ErrorType.FAQ_NOT_FOUND) return res current = FactStatus(faq.status) target = req.status if target not in FACT_STATUS_TRANSITIONS.get(current, set()): res.result.SetResult(ErrorType.FACT_INVALID_TRANSITION) return res data: dict = {} if target == FactStatus.CORRECTED: question = (req.question or "").strip() answer = (req.answer or "").strip() if not question and not answer: # '정정'인데 고친 문구가 없으면 그냥 승인(VERIFIED)이어야 한다 — 잠금만 얻는 길을 막는다. res.result.SetResult(ErrorType.INVALID_REQUEST_DATA) return res if question: data["question"] = question if answer: data["answer"] = answer data["generated_by"] = SourceType.OWNER.value now = GTime.UTC() run_err = await DB_SESSION_MNG.execute_lambda_run( [place_faqs.DBType()], [lambda s: self._transition_ok(s, fid, current, target, data)], ) if run_err != ErrorType.SUCCESS: res.result.SetResult(ErrorType.FACT_INVALID_TRANSITION if run_err == ErrorType.DB_EMPTY_DATA else run_err) return res # 노출 집합이 바뀌는 전이(승격 / 정정 / 노출값 내림)면 재빌드 대상으로 표시한다. if target in PUBLISHABLE_FACT_STATUSES or current in PUBLISHABLE_FACT_STATUSES: await self._mark_content_updated(place_id, now) return await self._reload(res, pid, fid) async def _transition_ok(self, s, fid, current: FactStatus, target: FactStatus, data: dict): """출발 상태를 WHERE 에 걸어 조건부로만 바꾼다(동시 처리 가드).""" err_type, rowcount = await self.crud.transition(s, fid, (current.value,), target.value, data) if err_type != ErrorType.SUCCESS: return err_type return ErrorType.SUCCESS if rowcount else ErrorType.DB_EMPTY_DATA