Mina Choi
11d30bb3d1
여러 줄 주석이 설명보다 경위(예전·실측·지적)를 적고 있어 읽는 사람이 결론을 찾기 어려웠다. - ts·tsx·js·mjs·css·py 478개: 여러 줄 주석은 첫 문장 한 줄로, 과거형·날짜 문장은 삭제 - 주석 위치는 TypeScript 파서·파이썬 tokenize/ast 로 찾는다 — 문자열 안의 # · /* 는 건드리지 않는다 - eslint·ts·noqa·type: ignore 같은 지시 주석은 그대로 둔다 파이썬 275개 정리 전후 AST 동일, TS 298개 주석 뺀 토큰 동일(빈 JSX 주석 10곳만 차이). site·frontend·admin tsc, site vitest 105 passed Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
57 lines
1.4 KiB
Python
57 lines
1.4 KiB
Python
import uuid
|
|
from datetime import datetime
|
|
from typing import Optional
|
|
|
|
from pydantic import ConfigDict
|
|
|
|
from common.enums import FactStatus, SourceType
|
|
from common.models.gmodel import Res_WebPacketProtocol, WebPacketProtocol
|
|
|
|
|
|
class FaqProtocol(WebPacketProtocol):
|
|
pass
|
|
|
|
|
|
class Req_CreateFaq(FaqProtocol):
|
|
"""사장님이 직접 쓴 FAQ."""
|
|
|
|
question: str = ""
|
|
answer: str = ""
|
|
sort_order: Optional[int] = None # 미지정이면 기존 FAQ 뒤에 붙인다
|
|
|
|
|
|
class Req_TransitionFaq(FaqProtocol):
|
|
"""검증 상태 전이."""
|
|
|
|
status: FactStatus = FactStatus.VERIFIED
|
|
question: Optional[str] = None
|
|
answer: Optional[str] = None
|
|
|
|
|
|
class FaqData(WebPacketProtocol):
|
|
model_config = ConfigDict(from_attributes=True)
|
|
|
|
faq_id: uuid.UUID
|
|
place_id: uuid.UUID
|
|
question: str
|
|
answer: str
|
|
# 근거 목록.
|
|
source_fact_ids: Optional[list[str]] = None
|
|
generated_by: SourceType
|
|
status: FactStatus
|
|
sort_order: int = 0
|
|
created_at: Optional[datetime] = None
|
|
updated_at: Optional[datetime] = None
|
|
|
|
|
|
class Res_FaqList(Res_WebPacketProtocol):
|
|
faqs: list[FaqData] = []
|
|
# 사이트에 나갈 수 있는 건수(VERIFIED·CORRECTED).
|
|
publishable: int = 0
|
|
# 승인 대기 건수 — 관리 화면의 '검토할 것' 배지.
|
|
pending_review: int = 0
|
|
|
|
|
|
class Res_Faq(Res_WebPacketProtocol):
|
|
faq: Optional[FaqData] = None
|