o2o-site-AEO/solution/backend/router/v1/job/protocol.py
Mina Choi 11d30bb3d1 [chore] solution,admin,ontology: 코드 주석을 한 줄로 — 히스토리 주석 삭제
여러 줄 주석이 설명보다 경위(예전·실측·지적)를 적고 있어 읽는 사람이 결론을 찾기 어려웠다.

- 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>
2026-09-28 16:05:19 +09:00

58 lines
1.4 KiB
Python

import uuid
from datetime import datetime
from typing import Any, Optional
from typing import Literal
from common.enums import JobStatus, JobType
from common.models.gmodel import Res_WebPacketProtocol, WebPacketProtocol
class JobProtocol(WebPacketProtocol):
pass
class JobStep(WebPacketProtocol):
id: str
status: Literal["pending", "running", "done", "skipped", "failed"]
reason: Optional[str] = None
class JobProgress(WebPacketProtocol):
steps: list[JobStep]
attempt: int
class JobData(WebPacketProtocol):
job_id: uuid.UUID
place_id: Optional[uuid.UUID] = None
job_type: JobType
status: JobStatus
attempts: int = 0
max_attempts: int = 3
result: Optional[Any] = None
progress: Optional[JobProgress] = None
last_error: Optional[str] = None
run_after: Optional[datetime] = None
run_started_at: Optional[datetime] = None
created_at: Optional[datetime] = None
updated_at: Optional[datetime] = None
class Res_Job(Res_WebPacketProtocol):
"""잡 상태 폴링 응답."""
job: Optional[JobData] = None
class Res_JobOps(Res_WebPacketProtocol):
"""운영 스냅샷 — 큐 지연·DEAD·좀비 감시용."""
pending: int = 0
running: int = 0
done: int = 0
dead: int = 0
dead_1h: int = 0
stuck_running: int = 0
oldest_pending_sec: int = 0
deadline_1h: int = 0