hbyang
3253166622
콘솔에 발급된 설정이 설계와 어긋나 있었다. 클라이언트 시크릿이 켜져 있고 Redirect URI 가
프론트 경로(/auth/kakao/callback)인데, 코드는 "프론트가 액세스 토큰을 들고 온다" 는
전제였다 — 시크릿을 번들에 구울 수 없으므로 그 흐름으로는 토큰을 받을 수 없다.
- services/external/kakao_identity: access_token 검증 → **인가 코드 교환**으로 교체.
★ 우리 REST 키·시크릿으로 교환한 토큰이라 정의상 우리 앱 것이다 — 구글의 aud 대조에
해당하는 검사(KAKAO_LOGIN_APP_ID)가 구조적으로 필요 없어져 설정 칸째로 지웠다.
★ 로그인 앱과 챗봇 앱이 다르면 로그인은 되는데 채널 매칭만 조용히 안 된다 —
REST 키가 어긋나면 경고 로그를 남긴다.
★ 미인증 이메일은 신원으로 쓰지 않는다(is_email_valid·is_email_verified 둘 다). 이 값으로
auth_service 가 다른 수단 가입과의 충돌을 판정한다.
- config/config_models: KAKAO_LOGIN_APP_ID → REST_API_KEY · CLIENT_SECRET · REDIRECT_URI
- router/v1/auth: Req_KakaoLogin {access_token} → {code, redirect_uri}
- frontend: lib/kakaoIdentity(인가 URL · sessionStorage state) · KakaoSignInButton ·
pages/KakaoCallbackPage(코드는 1회용이라 ref 로 한 번만 보낸다) · routes
★ 로그인 폼에서 카카오를 구글 위에 둔다 — 이 수단으로 들어와야 6자리 코드 없이 채널이 이어진다
- compose · nginx/Dockerfile: REST 키·Redirect URI 만 프론트로 흘려보낸다. 시크릿은 안 나간다
- 어드민 키는 저장하지 않는다 — 탈퇴까지 되는 키인데 로그인에는 쓰이지 않는다
- api/generated: orval 재생성. 카카오 외에도 오래 밀려 있던 문구·agent 경로가 함께 따라왔다
테스트 8건 추가(tests/test_kakao_identity.py), 관련 85 passed
(test_auth::test_google_login_is_off_when_client_id_is_empty 는 기존 실패)
lint(react-router typegen + tsc + eslint) 통과
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
485 lines
17 KiB
Python
485 lines
17 KiB
Python
from enum import Enum, auto
|
|
|
|
from fastapi import HTTPException
|
|
|
|
|
|
class CodeEnum(Enum):
|
|
"""OpenAPI 스키마에 x-enum-varnames(멤버 이름)을 실어 orval 이 이름 있는 enum 을 생성하게 하는 베이스."""
|
|
|
|
@classmethod
|
|
def __get_pydantic_json_schema__(cls, core_schema, handler):
|
|
json_schema = handler(core_schema)
|
|
json_schema = handler.resolve_ref_schema(json_schema)
|
|
json_schema["x-enum-varnames"] = [m.name for m in cls]
|
|
return json_schema
|
|
|
|
|
|
class ErrorType(Enum):
|
|
"""서버 전역 결과 코드."""
|
|
|
|
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_FORBIDDEN = 403
|
|
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 = 1100
|
|
ACCOUNT_ALREADY_EXIST = auto()
|
|
ACCOUNT_BLOCKED_USER = auto()
|
|
ACCOUNT_NOT_FOUND = auto()
|
|
ACCOUNT_FORBIDDEN = auto() # 최고관리자 외 접근 / 다른 회사·최고관리자 대상 변경 시도
|
|
ACCOUNT_PROVIDER_CONFLICT = auto() # 이미 다른 로그인 수단으로 가입된 이메일 — 자동 연결하지 않는다(DECISIONS 1절)
|
|
OAUTH_NOT_CONFIGURED = auto() # 그 소셜 로그인의 키 미설정 — 그 수단만 꺼진다
|
|
OAUTH_INVALID_TOKEN = auto() # 구글 ID 토큰 서명·수신자·만료 검증 실패
|
|
ACCOUNT_SESSION_REVOKED = auto()
|
|
|
|
# 사업장(places) 관련 에러
|
|
PLACE_NOT_FOUND = 1200
|
|
PLACE_ALREADY_EXIST = auto() # 같은 회사 안에 같은 카카오 장소 ID — 중복 등록
|
|
PLACE_NOT_VERIFIED = auto() # 동일 업소 검증 전 — 수집·발행 진입 금지
|
|
PLACE_VERIFY_NO_CANDIDATE = auto() # 카카오 로컬에서 후보를 못 찾음
|
|
PLACE_VERIFY_AMBIGUOUS = auto() # 동명 업소 다수 — 사람이 골라야 함
|
|
PLACE_INVALID_CATEGORY = auto() # 지원하지 않는 업종 코드
|
|
UNIT_NOT_FOUND = auto()
|
|
LINK_NOT_FOUND = auto()
|
|
LINK_NOT_CONFIRMED = auto() # 확정 안 된 URL — 크롤링 대상 아님
|
|
MEDIA_NOT_FOUND = auto()
|
|
|
|
# fact 관련 에러
|
|
FACT_NOT_FOUND = 1300
|
|
FACT_INVALID_KEY = auto() # 업종 스키마에 없는 key
|
|
FACT_INVALID_TRANSITION = auto() # 허용되지 않은 검증 상태 전이
|
|
FACT_LOCKED = auto() # CORRECTED(사장님 수정본) — 자동 갱신이 덮어쓸 수 없다
|
|
FACT_SOURCE_REQUIRED = auto() # source_type 이 owner 가 아닌데 source_url 이 없음
|
|
FAQ_NOT_FOUND = auto()
|
|
FAQ_UNGROUNDED = auto() # 확보된 fact 로 뒷받침되지 않는 문장 — 반려
|
|
|
|
# 수집(collector) 관련 에러
|
|
COLLECT_ADAPTER_NOT_FOUND = 1400 # 해당 URL 을 처리할 어댑터 없음
|
|
COLLECT_ADAPTER_DISABLED = auto() # 법무 검토 전이라 미등록된 어댑터(HeadlessAdapter 등)
|
|
COLLECT_FETCH_FAILED = auto()
|
|
COLLECT_ALREADY_RUNNING = auto()
|
|
|
|
# 생성(generator) 관련 에러
|
|
GENERATOR_NOT_CONFIGURED = 1500 # 활성 LLM 공급자의 키 미설정(llm/provider.missing_key)
|
|
GENERATOR_CALL_FAILED = auto()
|
|
GENERATOR_INVALID_OUTPUT = auto() # 구조화 출력 파싱 실패
|
|
GENERATOR_LOW_CONFIDENCE = auto() # 신뢰도 낮음 — 자동 반영 금지, 사람 확인 큐로
|
|
|
|
# 지역 정보(local) 관련 에러
|
|
LOCAL_NOT_CONFIGURED = 1600 # KAKAO_REST_API_KEY / TOUR_API_KEY 미설정
|
|
LOCAL_REGION_UNKNOWN = auto() # 좌표 → 행정구역 코드 변환 실패
|
|
LOCAL_FETCH_FAILED = auto() # 실패해도 직전 값을 유지한다 — 빈 값을 내보내지 않는다
|
|
|
|
# 사이트(sites) 관련 에러
|
|
SITE_NOT_FOUND = 1700
|
|
SITE_VERSION_NOT_FOUND = auto()
|
|
SITE_BUILD_FAILED = auto()
|
|
PUBLISH_UNVERIFIED_FACT = auto() # 미검증 fact 포함 — 발행 거부
|
|
PUBLISH_NO_UNIQUE_CONTENT = auto() # 고유 콘텐츠 0건 — 발행 거부(스팸 판정 대상)
|
|
PUBLISH_JSONLD_MISMATCH = auto() # 구조화 데이터 값 != 화면 값 — 빌드 실패
|
|
PUBLISH_REQUIRED_FACT_MISSING = auto() # 업종 스키마의 required 필드 누락
|
|
SITE_SLUG_LOCKED = auto() # 이미 발행된 사이트의 주소 변경 — 색인된 페이지가 404 가 된다
|
|
|
|
# 리포트(reports) 관련 에러
|
|
REPORT_NOT_FOUND = 1800
|
|
|
|
# 작업 큐(job) 관련 에러
|
|
JOB_NOT_FOUND = 1900
|
|
JOB_ALREADY_QUEUED = auto() # 같은 dedupe_key 의 활성 잡이 이미 있다
|
|
JOB_NOT_DEAD = auto() # DEAD 가 아닌 잡을 재큐하려 함
|
|
|
|
# 카카오톡 채널 신원 연결 관련 에러
|
|
KAKAO_LINK_DISABLED = 2000 # KAKAO_CHANNEL_PUBLIC_ID 미설정 — 연결 화면 자체를 열지 않는다
|
|
KAKAO_LINK_ALREADY = auto() # 이미 연결된 사장님이 다시 코드를 받으려 함
|
|
KAKAO_LINK_CODE_INVALID = auto() # 코드가 없거나 만료 — ★ 없는 코드와 남의 코드를 구분해 답하지 않는다
|
|
KAKAO_LINK_NOT_FOUND = auto() # 해제할 연결이 없음
|
|
KAKAO_LINK_TAKEN = auto() # 그 카카오 계정이 이미 다른 사장님에 묶여 있다
|
|
|
|
|
|
# ErrorType 의 HTTP_* 값과 status_code 를 맞춰 router 단에서 raise 한다.
|
|
EXCEPTION_FORBIDDEN = HTTPException(status_code=ErrorType.HTTP_FORBIDDEN.value, detail=ErrorType.HTTP_FORBIDDEN.name)
|
|
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 구분."""
|
|
|
|
MAIN = 1
|
|
|
|
|
|
class DBWRType(Enum):
|
|
"""Read / Write 접속 구분."""
|
|
|
|
DB_READ = 1
|
|
DB_WRITE = 2
|
|
|
|
|
|
# 도메인 코드값
|
|
class UserStatus(CodeEnum):
|
|
"""users.status 코드값."""
|
|
|
|
ACTIVE = 1
|
|
INACTIVE = 2
|
|
|
|
|
|
class UserRole(CodeEnum):
|
|
"""users.role 코드값."""
|
|
|
|
USER = 1
|
|
OWNER = 2 # 최고관리자: 자기 회사 계정 관리 + 회사 설정
|
|
DEVELOPER = 3 # 개발자(내부 운영): 최고관리자 권한 전부 + 고객사에 보이지 않음
|
|
|
|
|
|
class AuthProvider(CodeEnum):
|
|
"""users.provider 코드값."""
|
|
|
|
LOCAL = 1 # id/pw
|
|
GOOGLE = 2 # 구글 ID 토큰
|
|
KAKAO = 3 # 카카오 인가 코드 — ★ 회원번호가 챗봇의 appUserId 와 같아 채널 매칭에 쓰인다
|
|
|
|
|
|
class CompanyStatus(CodeEnum):
|
|
"""companies.status 코드값."""
|
|
|
|
ACTIVE = 1
|
|
INACTIVE = 2
|
|
|
|
|
|
class PlaceCategory(CodeEnum):
|
|
"""places.category 코드값."""
|
|
|
|
LODGING = 1 # 숙박
|
|
CAFE = 2 # 카페
|
|
RESTAURANT = 3 # 음식점
|
|
CLINIC = 4 # 피부과·성형외과
|
|
|
|
|
|
class ExternalPlaceSource(CodeEnum):
|
|
"""places.external_source 코드값."""
|
|
|
|
KAKAO = 1 # dapi.kakao.com — 고유 place id O · 전화번호 O · 행정구역 코드 O
|
|
NAVER = 2 # openapi.naver.com 지역검색 — 고유 id X · 전화번호 X · 5건 제한
|
|
|
|
|
|
class PlaceStatus(CodeEnum):
|
|
"""places.status 코드값."""
|
|
|
|
DRAFT = 1 # 등록만 됨 — 동일 업소 검증 전
|
|
COLLECTING = 2 # 수집 진행 중
|
|
REVIEW = 3 # 검수 대기(사람 확인 큐)
|
|
PUBLISHED = 4 # 발행됨
|
|
SUSPENDED = 5 # 해지·중지 — 사이트 상태 전이로 처리
|
|
|
|
|
|
class SourceType(CodeEnum):
|
|
"""facts.source_type / media.source_type / place_aliases.source_type / place_faqs.generated_by 공용 코드값."""
|
|
|
|
OWNER = 1 # 사장님이 직접 입력·업로드
|
|
API = 2 # 공식 API (카카오 로컬 · TourAPI · Open-Meteo · Perplexity)
|
|
CRAWL = 3 # 크롤링
|
|
LLM = 4 # LLM 생성 — ★ 사실이 아니라 문장에만 쓴다
|
|
TEMPLATE = 5 # FAQ 목표 수를 채운 공통 질문 + 문의 안내(services/faq_fill) — ★ FAQ 전용.
|
|
|
|
|
|
class FactStatus(CodeEnum):
|
|
"""facts.status / faqs.status / routes.status 공용 검증 상태."""
|
|
|
|
UNVERIFIED = 1 # 수집됐으나 아무도 확인 안 함
|
|
PENDING_OWNER = 2 # 사장님 확인 대기
|
|
VERIFIED = 3 # 확인됨 — 노출 가능
|
|
CORRECTED = 4 # 사장님이 고침 — 노출 가능 + ★ 잠김(자동 갱신이 덮어쓸 수 없다)
|
|
REJECTED = 5 # 틀린 값으로 판정 — 노출 안 함
|
|
EXPIRED = 6 # 유효기간 지남 — 노출 안 함, 재수집 대상
|
|
|
|
|
|
# 절대규칙 1: 이 두 상태만 사이트에 노출한다.
|
|
PUBLISHABLE_FACT_STATUSES = {FactStatus.VERIFIED, FactStatus.CORRECTED}
|
|
|
|
# 후보 — 재수집이 올려놓은 확인 대기 항목.
|
|
CANDIDATE_FACT_STATUSES = {FactStatus.UNVERIFIED, FactStatus.PENDING_OWNER}
|
|
|
|
# 절대규칙 6: 자동 수집(api/crawl/llm)이 덮어쓸 수 없는 상태.
|
|
LOCKED_FACT_STATUSES = {FactStatus.CORRECTED}
|
|
|
|
|
|
class FactWriteOutcome(CodeEnum):
|
|
"""fact 기록 결과."""
|
|
|
|
PUBLISHED_CREATED = 1
|
|
PUBLISHED_REPLACED = 2
|
|
REFRESHED = 3 # 재수집했는데 값이 그대로 — 검증 유지, 확인 시각만 갱신
|
|
CANDIDATE_CREATED = 4
|
|
CANDIDATE_UPDATED = 5
|
|
|
|
# 검증 상태 전이 허용표.
|
|
FACT_STATUS_TRANSITIONS = {
|
|
FactStatus.UNVERIFIED: {FactStatus.PENDING_OWNER, FactStatus.VERIFIED, FactStatus.REJECTED, FactStatus.EXPIRED},
|
|
FactStatus.PENDING_OWNER: {FactStatus.VERIFIED, FactStatus.CORRECTED, FactStatus.REJECTED, FactStatus.EXPIRED},
|
|
FactStatus.VERIFIED: {FactStatus.CORRECTED, FactStatus.REJECTED, FactStatus.EXPIRED},
|
|
FactStatus.CORRECTED: {FactStatus.CORRECTED, FactStatus.REJECTED}, # 사장님만 다시 고칠 수 있다
|
|
FactStatus.REJECTED: {FactStatus.UNVERIFIED}, # 재수집으로만 되살아난다
|
|
FactStatus.EXPIRED: {FactStatus.UNVERIFIED},
|
|
}
|
|
|
|
|
|
class LinkChannel(CodeEnum):
|
|
"""place_channels.channel 코드값."""
|
|
|
|
YANOLJA = 1 # 야놀자
|
|
GOODCHOICE = 2 # 여기어때
|
|
NAVER_PLACE = 3 # 네이버 플레이스
|
|
INSTAGRAM = 4
|
|
OFFICIAL_SITE = 5 # 사장님 자체 홈페이지
|
|
BLOG = 6
|
|
# 플레이스와 가른 이유: 이건 **예약 화면 그 자체**다.
|
|
NAVER_BOOKING = 7 # 네이버 예약(m.booking.naver.com)
|
|
ETC = 99
|
|
|
|
|
|
class MediaStatus(CodeEnum):
|
|
"""media.status 코드값."""
|
|
|
|
PENDING_REVIEW = 1 # 사람 확인 큐 — Vision 분석 전이거나 신뢰도가 낮다
|
|
APPROVED = 2 # 사람이 확인함(또는 Vision 신뢰도가 충분히 높음)
|
|
REJECTED = 3
|
|
|
|
|
|
class SongStatus(CodeEnum):
|
|
"""place_songs.status 코드값."""
|
|
|
|
GENERATING = 1
|
|
READY = 2
|
|
FAILED = 3 # 생성 실패.
|
|
|
|
|
|
# Vision 결과를 자동 반영해도 되는 신뢰도 하한.
|
|
VISION_AUTO_APPROVE_CONFIDENCE = 0.7
|
|
|
|
|
|
class LocalContentType(CodeEnum):
|
|
"""local_contents.content_type 코드값."""
|
|
|
|
WEATHER = 1 # 날씨 (Open-Meteo) — local_contents(지역 캐시)
|
|
# ↓ 2~5 는 place_contents(업장 반경 캐시).
|
|
FESTIVAL = 2 # 축제/공연/행사 (15)
|
|
ATTRACTION = 3 # 관광지 (12)
|
|
RESTAURANT = 4 # 음식점 (39)
|
|
COURSE = 5 # 여행코스 (25) — 백엔드만.
|
|
# 지역 이야기(가요·일력·인물·연표·엽서·퀴즈).
|
|
STORY = 6
|
|
|
|
|
|
# 코드값 ↔ **타입명**.
|
|
AREA_KIND = {
|
|
LocalContentType.WEATHER.value: "weather",
|
|
LocalContentType.FESTIVAL.value: "festival",
|
|
LocalContentType.ATTRACTION.value: "attraction",
|
|
LocalContentType.RESTAURANT.value: "restaurant",
|
|
LocalContentType.COURSE.value: "course",
|
|
}
|
|
|
|
# 지역 이야기 일곱.
|
|
STORY_KINDS = ("songs", "daily", "people", "chronicle", "reading", "postcard", "quiz")
|
|
|
|
|
|
class LocalSource(CodeEnum):
|
|
"""local_contents.source 코드값."""
|
|
|
|
OPEN_METEO = 1 # 날씨.
|
|
TOUR_API = 2 # 한국관광공사.
|
|
KAKAO_LOCAL = 3
|
|
OFFICIAL_WEB = 4 # 지자체·행사 공식 홈페이지에서 운영자가 검수해 등록
|
|
# 지역 이야기 생성분.
|
|
LLM = 5
|
|
NAVER_CRAWL = 6 # 네이버 플레이스 크롤링(주변 맛집 보강).
|
|
|
|
|
|
class LocalContentStatus(CodeEnum):
|
|
"""운영 관리자가 검수하는 지역 콘텐츠 발행 상태."""
|
|
|
|
REVIEW = 1
|
|
PUBLISHED = 2
|
|
ENDED = 3
|
|
|
|
|
|
class TransportType(CodeEnum):
|
|
"""routes.transport 코드값."""
|
|
|
|
CAR = 1
|
|
PUBLIC = 2
|
|
WALK = 3
|
|
|
|
|
|
class SiteStatus(CodeEnum):
|
|
"""sites.status 코드값."""
|
|
|
|
DRAFT = 1
|
|
REVIEW = 2 # 검수 게이트 대기
|
|
PUBLISHED = 3
|
|
SUSPENDED = 4 # 해지 유예 — 페이지는 살아있음
|
|
UNPUBLISHED = 5 # 내림
|
|
|
|
|
|
class BuildStatus(CodeEnum):
|
|
"""site_versions.build_status 코드값."""
|
|
|
|
PENDING = 1
|
|
BUILDING = 2
|
|
BUILT = 3
|
|
FAILED = 4
|
|
|
|
|
|
class PublishAction(CodeEnum):
|
|
"""publish_logs.action 코드값."""
|
|
|
|
PUBLISH = 1
|
|
UNPUBLISH = 2
|
|
REBUILD = 3
|
|
SUSPEND = 4
|
|
RESUME = 5
|
|
ROLLBACK = 6
|
|
|
|
|
|
class PublishResult(CodeEnum):
|
|
"""publish_logs.result 코드값."""
|
|
|
|
SUCCESS = 1
|
|
REJECTED = 2 # 검수 게이트가 막음 — reject_reason 참고
|
|
FAILED = 3 # 빌드/배포 자체가 실패
|
|
|
|
|
|
class PublishRejectReason(CodeEnum):
|
|
"""publish_logs.reject_reason 코드값."""
|
|
|
|
UNVERIFIED_FACT = 1 # 미검증 fact 포함
|
|
NO_UNIQUE_CONTENT = 2 # 고유 콘텐츠 0건
|
|
JSONLD_MISMATCH = 3 # 구조화 데이터 값 != 화면 값
|
|
REQUIRED_FACT_MISSING = 4 # 업종 스키마 required 필드 누락
|
|
|
|
|
|
class AiEngine(CodeEnum):
|
|
"""ai_check_results.engine 코드값."""
|
|
|
|
CHATGPT = 1
|
|
PERPLEXITY = 2
|
|
GEMINI = 3
|
|
CLAUDE = 4
|
|
ETC = 99
|
|
|
|
|
|
# 작업 큐 (LPS 의 job 큐 구조를 이식 — PostgreSQL 을 큐로 쓴다)
|
|
class JobType(CodeEnum):
|
|
"""jobs.job_type 코드값."""
|
|
|
|
COLLECT = 1 # 수집 파이프라인: Perplexity 채널 발견 → 카카오 검증 → 크롤링
|
|
VISION = 2 # 사진 분류 + alt 생성 (Gemini Vision, 20~50장 배치)
|
|
COPY = 3 # 소개문·FAQ 작성 (Gemini 텍스트) — 확보된 fact 만 근거로
|
|
BUILD = 4 # 사이트 정적 빌드 — ★ 개별 재빌드 단위
|
|
LOCAL_SYNC = 5 # 지역 정보 갱신 — 행정구역 코드 단위(같은 지역 사이트 50개여도 1회)
|
|
AI_CHECK = 6 # AI 검색 노출 점검
|
|
SONG = 7 # 이 숙소의 노래 한 곡 (가사 Gemini → 작곡 Suno).
|
|
ROLLBACK = 8
|
|
SOCIAL_DRAFT = 9 # SNS 초안 작성(Gemini) — 확보된 fact 만 근거로
|
|
SOCIAL_POST = 10 # 승인된 SNS 초안을 실제 게시
|
|
|
|
|
|
class JobStatus(CodeEnum):
|
|
"""jobs.status 코드값."""
|
|
|
|
PENDING = 1 # 대기(claim 가능).
|
|
RUNNING = 2 # 워커가 점유 중(lease_until 까지 소유).
|
|
DONE = 3 # 완료
|
|
DEAD = 4 # dead-letter — max_attempts 소진(수동 개입/알림 대상)
|
|
|
|
|
|
# claim 대상이 되는 활성 상태.
|
|
ACTIVE_JOB_STATUSES = {JobStatus.PENDING, JobStatus.RUNNING}
|
|
|
|
|
|
class PostTopicKind(CodeEnum):
|
|
"""place_posts.topic_kind — 어떤 갈래로 쓴 글인가."""
|
|
|
|
WEATHER = 1 # local.weather
|
|
FESTIVAL = 2 # local.festivals
|
|
SEASON = 3 # 절기·달
|
|
NEARBY = 4 # local.attractions / restaurants
|
|
GUIDE = 5 # 이용 안내(검증된 fact 안에서)
|
|
|
|
|
|
class PostStatus(CodeEnum):
|
|
"""place_posts.status — 글 하나의 일생."""
|
|
|
|
DRAFT = 1
|
|
REVIEWED = 2 # 우리가 검수해 내보내도 된다고 판단
|
|
SENT = 3
|
|
APPROVED = 4
|
|
PUBLISHED = 5
|
|
SKIPPED = 6 # 반려(우리) 또는 넘김(사장님)
|
|
|
|
|
|
class ReviewStatus(CodeEnum):
|
|
"""place_reviews.status — 손님이 쓴 글의 일생."""
|
|
|
|
PENDING = 1
|
|
PUBLISHED = 2 # 검수 통과 — 다음 굽기에 실린다
|
|
REJECTED = 3 # 반려
|
|
|
|
|
|
class SocialProvider(CodeEnum):
|
|
X = 1
|
|
THREADS = 2
|
|
|
|
|
|
class KakaoLinkStatus(str, Enum):
|
|
"""owner_kakao_links.status."""
|
|
|
|
PENDING = "PENDING"
|
|
LINKED = "LINKED"
|
|
REVOKED = "REVOKED"
|
|
|
|
|
|
class SocialPostStatus(str, Enum):
|
|
DRAFTING = "DRAFTING"
|
|
DRAFT = "DRAFT"
|
|
PENDING_APPROVAL = "PENDING_APPROVAL"
|
|
APPROVED = "APPROVED"
|
|
POSTING = "POSTING"
|
|
POSTED = "POSTED"
|
|
DECLINED = "DECLINED"
|
|
EXPIRED = "EXPIRED"
|
|
FAILED = "FAILED"
|
|
UNKNOWN = "UNKNOWN" # 응답 유실·워커 중단: 자동 재시도는 중복 게시가 된다.
|
|
|
|
|
|
class AlertStatus(CodeEnum):
|
|
"""alert_outbox.status 코드값."""
|
|
|
|
PENDING = 1 # 아직 안 보냄(다음 process_outbox 스윕에서 시도)
|
|
SENT = 2 # 전송 성공
|
|
FAILED = 3 # 재시도 상한 소진 — 더 시도하지 않는다(사람이 outbox 를 봐야 한다)
|