b576dd1a38
Apply asset_db_002_photos_monitors.sql before rebuilding web. Restrict soft deletion to the super admin; retain reports and audit.
107 lines
4.4 KiB
Python
107 lines
4.4 KiB
Python
"""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("현재 상태에서 처리할 수 없습니다. 배정된 자산은 먼저 반납하세요.")
|