"""Asset validation and lifecycle rules, shared by API and storage.""" from datetime import date from decimal import Decimal from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator CATEGORIES = {"computer": "컴퓨터", "monitor": "모니터", "mouse": "마우스", "keyboard": "키보드", "camera": "카메라", "hub": "허브 · 네트워크", "lighting": "조명", "desk": "책상", "chair": "의자", "furniture": "기타 사무집기", "equipment": "기타 전산장비"} STATUSES = {"available": "사용 가능", "in_use": "사용 중", "maintenance": "수리 중", "lost": "분실", "retired": "폐기"} class AssetInput(BaseModel): model_config = ConfigDict(extra="forbid", str_strip_whitespace=True) tag: str = Field(default="", max_length=64) name: str = Field(min_length=1, max_length=200) category: str manufacturer: str = Field(default="", max_length=150) model: str = Field(default="", max_length=200) serial: str = Field(default="", max_length=200) location: str = Field(default="", max_length=150) department: str = Field(default="", max_length=100) purchased_on: date | None = None purchase_cost: Decimal | None = Field(default=None, ge=0, le=10**12, decimal_places=2) vendor: str = Field(default="", max_length=200) warranty_until: date | None = None notes: str = Field(default="", max_length=10000) @field_validator("category") @classmethod def valid_category(cls, value): if value not in CATEGORIES: raise ValueError("자산 분류가 올바르지 않습니다.") return value @model_validator(mode="after") def valid_dates(self): if self.purchased_on and self.warranty_until and self.warranty_until < self.purchased_on: raise ValueError("보증 종료일은 구매일 이후여야 합니다.") return self class AssetUpdate(AssetInput): version: int = Field(ge=1) class DeleteInput(BaseModel): model_config = ConfigDict(extra="forbid", str_strip_whitespace=True) version: int = Field(ge=1) note: str = Field(min_length=1, max_length=2000) class MonitorInput(BaseModel): model_config = ConfigDict(extra="forbid", str_strip_whitespace=True) version: int = Field(ge=1) report_id: str = Field(min_length=1, max_length=64) asset: AssetInput | None = None asset_id: str = Field(default="", max_length=64) @model_validator(mode="after") def require_target(self): if bool(self.asset) == bool(self.asset_id): raise ValueError("등록할 정보 또는 연결할 모니터 자산 중 하나를 지정하세요.") if self.asset and self.asset.category != "monitor": raise ValueError("모니터 분류로 등록하세요.") return self class ActionInput(BaseModel): model_config = ConfigDict(extra="forbid", str_strip_whitespace=True) version: int = Field(ge=1) action: str assignee_email: str = Field(default="", max_length=254) location: str = Field(default="", max_length=150) note: str = Field(default="", max_length=2000) @model_validator(mode="after") def require_reason(self): if self.action in {"lost", "retired"} and not self.note: raise ValueError("분실·폐기 사유를 입력하세요.") return self class AssetConflict(ValueError): pass def transition(asset, payload: ActionInput): state = asset["status"] if payload.action == "checkout": if state != "available" or not payload.assignee_email: raise ValueError("사용 가능한 자산을 선택하고 배정할 사용자를 지정하세요.") return "in_use", payload.assignee_email.lower() if payload.action == "checkin": if state != "in_use": raise ValueError("사용 중인 자산만 반납할 수 있습니다.") return "available", "" if payload.action == "maintenance" and state == "available": return "maintenance", "" if payload.action == "available" and state in {"maintenance", "lost", "retired"}: return "available", "" if payload.action == "lost" and state in {"available", "in_use", "maintenance"}: return "lost", asset.get("assignee_email", "") if payload.action == "retired" and state in {"available", "maintenance", "lost"}: return "retired", "" raise ValueError("현재 상태에서 처리할 수 없습니다. 배정된 자산은 먼저 반납하세요.")