f54f19fa45
말레이시아 라이브 방송의 호스트 정보와 방송 스케줄을 관리하는 새 모듈. 호스트 설정(이름·연락처·주소·계좌·틱톡)은 ERP 관리자만 다루고, 스케줄표에서 등록된 호스트를 골라 날짜·시간·장소·판매금액(RM)·결과 이미지를 저장한다. 권한키 live, DB live_db(LIVE_DB_URL), 미설정이면 설정 필요 안내만 표시한다. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
133 lines
6.0 KiB
Python
133 lines
6.0 KiB
Python
"""라이브 커머스 순수 함수 — 입력 검사·표시 형식(DB 없이 시험 가능)."""
|
|
|
|
from __future__ import annotations
|
|
|
|
import io
|
|
import re
|
|
from datetime import date, time
|
|
from decimal import ROUND_HALF_UP, Decimal, InvalidOperation
|
|
from typing import Any
|
|
|
|
from PIL import Image
|
|
|
|
MAX_IMAGES = 10 # 방송 한 건에
|
|
MAX_SALES = Decimal("999999999999.99")
|
|
THUMB_SIZE = 160
|
|
|
|
HOST_LIMITS = {"full_name": 200, "phone": 40, "email": 254, "address": 500, "bank_name": 100, "bank_account": 40, "tiktok_handle": 64}
|
|
_LABELS = {"full_name": "Full Name", "phone": "Phone Number", "email": "Email", "address": "Address", "bank_name": "Bank Name",
|
|
"bank_account": "Bank Account Number", "tiktok_handle": "Tiktok Handle"}
|
|
_EMAIL_RE = re.compile(r"^[A-Za-z0-9._%+\-']+@[A-Za-z0-9.\-]+\.[A-Za-z]{2,}$")
|
|
_PHONE_RE = re.compile(r"^\+?[0-9()\-\s]+$")
|
|
_ACCOUNT_RE = re.compile(r"^[0-9\-\s]+$")
|
|
_HANDLE_RE = re.compile(r"^[A-Za-z0-9._]+$")
|
|
_HANDLE_URL_RE = re.compile(r"^(?:https?://)?(?:www\.|m\.)?tiktok\.com/@?", re.I)
|
|
WEEKDAYS_KO = "월화수목금토일"
|
|
|
|
|
|
def clean_handle(raw: Any) -> str:
|
|
"""'@name'·'https://www.tiktok.com/@name?lang=en' → 'name'."""
|
|
s = _HANDLE_URL_RE.sub("", str(raw or "").strip())
|
|
return re.split(r"[/?#]", s, maxsplit=1)[0].lstrip("@")
|
|
|
|
|
|
def clean_host(values: dict[str, Any]) -> dict[str, str]:
|
|
"""호스트 입력 검사 — Full Name 만 필수, 나머지는 있으면 형식 확인. 틀리면 ValueError."""
|
|
out = {k: str(values.get(k) or "").strip() for k in HOST_LIMITS}
|
|
out["tiktok_handle"] = clean_handle(values.get("tiktok_handle"))
|
|
if not out["full_name"]:
|
|
raise ValueError("Full Name (as per IC) 을 입력하세요.")
|
|
for key, limit in HOST_LIMITS.items():
|
|
if len(out[key]) > limit:
|
|
raise ValueError(f"{_LABELS[key]} 이(가) 너무 깁니다({limit}자까지).")
|
|
if out["email"] and not _EMAIL_RE.match(out["email"]):
|
|
raise ValueError("Email 형식이 올바르지 않습니다.")
|
|
if out["phone"] and not _PHONE_RE.match(out["phone"]):
|
|
raise ValueError("Phone Number 는 숫자·+·-·괄호만 입력하세요.")
|
|
if out["bank_account"] and not _ACCOUNT_RE.match(out["bank_account"]):
|
|
raise ValueError("Bank Account Number 는 숫자·-만 입력하세요.")
|
|
if out["tiktok_handle"] and not _HANDLE_RE.match(out["tiktok_handle"]):
|
|
raise ValueError("Tiktok Handle 은 영문·숫자·밑줄·점만 입력하세요.")
|
|
return out
|
|
|
|
|
|
def parse_money(raw: Any) -> Decimal | None:
|
|
"""판매금액(RM) — 빈칸은 None(아직 입력 안 함), 0 이상, 소수 둘째 자리까지. 쉼표·RM 허용."""
|
|
s = re.sub(r"(?i)^rm|[,\s]", "", str(raw if raw is not None else "").strip())
|
|
if not s:
|
|
return None
|
|
try:
|
|
n = Decimal(s)
|
|
except InvalidOperation:
|
|
raise ValueError("판매금액은 숫자로 입력하세요.") from None
|
|
if not n.is_finite() or n < 0:
|
|
raise ValueError("판매금액은 0 이상 숫자로 입력하세요.")
|
|
if n > MAX_SALES:
|
|
raise ValueError("판매금액이 너무 큽니다.")
|
|
return n.quantize(Decimal("0.01"), rounding=ROUND_HALF_UP)
|
|
|
|
|
|
def _parse_time(raw: Any, *, label: str, required: bool) -> time | None:
|
|
s = str(raw or "").strip()
|
|
if not s:
|
|
if required:
|
|
raise ValueError(f"{label}을 입력하세요.")
|
|
return None
|
|
try:
|
|
return time.fromisoformat(s).replace(second=0, microsecond=0, tzinfo=None)
|
|
except ValueError:
|
|
raise ValueError(f"{label}이 올바르지 않습니다.") from None
|
|
|
|
|
|
def clean_broadcast(values: dict[str, Any]) -> dict[str, Any]:
|
|
"""방송 입력 검사 — 호스트·날짜·시작 시간 필수. 끝 시간이 시작보다 이르면 자정을 넘긴 방송으로 본다. 틀리면 ValueError."""
|
|
host = str(values.get("host_id") or "").strip()
|
|
if not host.isdigit():
|
|
raise ValueError("호스트를 고르세요.")
|
|
try:
|
|
day = date.fromisoformat(str(values.get("broadcast_date") or "").strip())
|
|
except ValueError:
|
|
raise ValueError("방송 날짜를 입력하세요.") from None
|
|
venue = str(values.get("venue") or "").strip()
|
|
if len(venue) > 200:
|
|
raise ValueError("방송 장소가 너무 깁니다(200자까지).")
|
|
return {"host_id": int(host), "broadcast_date": day,
|
|
"start_time": _parse_time(values.get("start_time"), label="시작 시간", required=True),
|
|
"end_time": _parse_time(values.get("end_time"), label="끝 시간", required=False),
|
|
"venue": venue, "sales_amount": parse_money(values.get("sales_amount"))}
|
|
|
|
|
|
def month_range(raw: Any, today: date) -> dict[str, Any]:
|
|
"""'YYYY-MM'(틀리거나 없으면 이번 달) → 그 달 첫날·다음 달 첫날·앞뒤 달 주소 값·제목."""
|
|
m = re.fullmatch(r"(\d{4})-(\d{2})", str(raw or "").strip())
|
|
year, month = (int(m[1]), int(m[2])) if m and 2000 <= int(m[1]) <= 2100 and 1 <= int(m[2]) <= 12 else (today.year, today.month)
|
|
start = date(year, month, 1)
|
|
end = date(year + (month == 12), month % 12 + 1, 1)
|
|
prev = date(year - (month == 1), (month - 2) % 12 + 1, 1)
|
|
return {"start": start, "end": end, "prev": prev.strftime("%Y-%m"), "next": end.strftime("%Y-%m"),
|
|
"label": f"{year}년 {month}월"}
|
|
|
|
|
|
def fmt_date(d: date) -> str:
|
|
return f"{d:%Y.%m.%d}({WEEKDAYS_KO[d.weekday()]})"
|
|
|
|
|
|
def fmt_times(start: time, end: time | None) -> str:
|
|
return f"{start:%H:%M}" + (f" ~ {end:%H:%M}" if end else "")
|
|
|
|
|
|
def fmt_money(n: Decimal | None) -> str:
|
|
return f"{n:,.2f}" if n is not None else ""
|
|
|
|
|
|
def thumbnail(data: bytes) -> bytes:
|
|
"""목록 작은 그림 — JPEG(투명은 흰 바탕). 저장할 때 이미 확인한 이미지만 들어온다."""
|
|
with Image.open(io.BytesIO(data)) as source:
|
|
source.thumbnail((THUMB_SIZE, THUMB_SIZE))
|
|
rgba = source.convert("RGBA")
|
|
canvas = Image.new("RGB", rgba.size, "white")
|
|
canvas.paste(rgba, mask=rgba.getchannel("A"))
|
|
out = io.BytesIO()
|
|
canvas.save(out, format="JPEG", quality=80)
|
|
return out.getvalue()
|