Files
dbx-main/app/modules/live/store.py
T
king fc95c8bd25 feat(라이브): 스케줄표 머리글 굵게·가운데·쇼핑몰 열, 달력 카드에 쇼핑몰 아이콘
- 스케줄표 머리글: 가운데 정렬, 굵게, 검정, 글자 12% 크게
- 스케줄표 첫 열 = 호스트 쇼핑몰(틱톡·쇼피) 아이콘
- 달력 카드 머리 왼쪽 위 사방 화살표 대신 쇼핑몰 작은 아이콘
- 아이콘 = 말레이시아 배송 로고에서 심볼만 잘라 만든 live-icon-tiktok.png, live-icon-shopee.png

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-06 15:27:14 +09:00

270 lines
15 KiB
Python

"""라이브 커머스 순수 함수 — 입력 검사·표시 형식(DB 없이 시험 가능)."""
from __future__ import annotations
import io
import re
from datetime import date, datetime, time, timedelta
from decimal import ROUND_HALF_UP, Decimal, InvalidOperation
from typing import Any
from PIL import Image
from .i18n import LiveError, month_label
MAX_IMAGES = 10 # 방송 한 건에
MAX_SALES = Decimal("999999999999.99")
THUMB_SIZE = 160
# shortcut: 요율이 코드 상수라 바꾸면 지난 방송 금액도 다시 계산된다 — 요율이 바뀌는 일이 생기면 방송마다 저장하도록 바꿀 것
HOURLY_RATE = Decimal("25") # 호스트 시간당 요금(RM)
COMMISSION_PERCENT = Decimal("10") # 판매금액의 %
SLOT_HOURS = 1 # 달력 한 칸(2026-11-06, 2시간 → 1시간)
FIRST_SLOT_HOUR = 6 # 달력에 늘 보이는 첫 칸(이보다 이른 칸은 방송이 있을 때만)
HOST_COLORS = ("#66d4e6", "#6ee05a", "#d4f06a", "#e9cf7a", "#ec9d88", "#cdb9ea", "#f4a9c8", "#a9c4f5")
_CENT = Decimal("0.01")
_WEEKDAYS = ("MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY")
_MONTHS = ("JAN", "FEB", "MAR", "APR", "MAY", "JUN", "JUL", "AUG", "SEP", "OCT", "NOV", "DEC")
HOST_LIMITS = {"display_name": 50, "full_name": 200, "phone": 40, "email": 254, "address": 500, "bank_name": 100, "bank_account": 40}
HANDLE_LIMIT = 64
PLATFORMS = ("tiktok", "shopee") # 호스트 쇼핑몰(005) — 로고 = /static/dispatch/courier/<값>.png(말레이시아 배송 모듈 이미지)
PRIVATE_HOST_FIELDS = ("phone", "email", "address", "bank_name", "bank_account") # 화면에 보이는 사람 = ERP 관리자만
_LABELS = {"display_name": "간단한 이름", "full_name": "이름 (IC 기준)", "phone": "전화번호", "email": "이메일", "address": "주소", "bank_name": "은행명",
"bank_account": "계좌번호"}
_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 = "월화수목금토일"
_WEEKDAYS_EN_SHORT = ("Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun")
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]:
"""호스트 입력 검사 — 쇼핑몰·간단한 이름·이름만 필수, 나머지는 있으면 형식 확인. 틀리면 ValueError."""
out = {k: str(values.get(k) or "").strip() for k in HOST_LIMITS}
out["platform"] = str(values.get("platform") or "").strip().lower()
if out["platform"] not in PLATFORMS:
raise LiveError("쇼핑몰(틱톡·쇼피)을 고르세요.")
if not out["display_name"]:
raise LiveError("간단한 이름을 입력하세요.")
if not out["full_name"]:
raise LiveError("이름 (IC 기준)을 입력하세요.")
for key, limit in HOST_LIMITS.items():
if len(out[key]) > limit:
raise LiveError("{label} 이(가) 너무 깁니다({limit}자까지).", label=_LABELS[key], limit=limit)
if out["email"] and not _EMAIL_RE.match(out["email"]):
raise LiveError("이메일 형식이 올바르지 않습니다.")
if out["phone"] and not _PHONE_RE.match(out["phone"]):
raise LiveError("전화번호는 숫자·+·-·괄호만 입력하세요.")
if out["bank_account"] and not _ACCOUNT_RE.match(out["bank_account"]):
raise LiveError("계좌번호는 숫자·-만 입력하세요.")
return out
def parse_money(raw: Any, label: str = "판매금액") -> 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 LiveError("{label}은(는) 숫자로 입력하세요.", label=label) from None
if not n.is_finite() or n < 0:
raise LiveError("{label}은(는) 0 이상 숫자로 입력하세요.", label=label)
if n > MAX_SALES:
raise LiveError("{label}이(가) 너무 큽니다.", label=label)
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 LiveError("{label}을 입력하세요.", label=label)
return None
try:
return time.fromisoformat(s).replace(second=0, microsecond=0, tzinfo=None)
except ValueError:
raise LiveError("{label}이 올바르지 않습니다.", label=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 LiveError("호스트를 고르세요.")
try:
day = date.fromisoformat(str(values.get("broadcast_date") or "").strip())
except ValueError:
raise LiveError("방송 날짜를 입력하세요.") from None
start = _parse_time(values.get("start_time"), label="시작 시간", required=True)
end = _parse_time(values.get("end_time"), label="끝 시간", required=True)
if start == end:
raise LiveError("끝 시간이 시작 시간과 같습니다.")
handle = clean_handle(values.get("tiktok_handle"))
if len(handle) > HANDLE_LIMIT:
raise LiveError("{label} 이(가) 너무 깁니다({limit}자까지).", label="틱톡 핸들", limit=HANDLE_LIMIT)
if handle and not _HANDLE_RE.match(handle):
raise LiveError("틱톡 핸들은 영문·숫자·밑줄·점만 입력하세요.")
return {"host_id": int(host), "broadcast_date": day, "start_time": start, "end_time": end, "tiktok_handle": handle,
"sales_amount": parse_money(values.get("sales_amount")), "ad_spend": parse_money(values.get("ad_spend"), "광고비"),
"host_fee": parse_money(values.get("host_fee"), "호스트 비용")}
def parse_move(day: Any, start: Any) -> tuple[date, time]:
"""달력 칸 — 날짜·시작 시간. 틀리면 ValueError."""
try:
when = date.fromisoformat(str(day or "").strip())
except ValueError:
raise LiveError("날짜가 올바르지 않습니다.") from None
return when, _parse_time(start, label="시간", required=True)
def moved_end(old_start: time, old_end: time | None, new_start: time) -> time | None:
"""칸을 옮겨도 방송 길이는 그대로."""
if old_end is None:
return None
return (datetime.combine(date.min, new_start) + _duration(old_start, old_end)).time()
def _duration(start: time, end: time) -> timedelta:
minutes = (end.hour * 60 + end.minute - start.hour * 60 - start.minute) % 1440 # 끝이 더 이르면 자정을 넘긴 방송
return timedelta(minutes=minutes)
def session_pay(start: time, end: time | None, sales: Decimal | None) -> dict[str, Decimal]:
"""참고 금액(저장 안 함) — Fee = 시간 × 시간당 요금, 커미션 = 판매금액 × %. 같은 계산이 방송 창에도(live.js recalc).
호스트 비용은 2026-11-06 부터 수기 입력(live_broadcasts.host_fee)."""
hours = Decimal(_duration(start, end).seconds) / 3600 if end else Decimal(0)
base = (hours * HOURLY_RATE).quantize(_CENT, rounding=ROUND_HALF_UP)
commission = ((sales or Decimal(0)) * COMMISSION_PERCENT / 100).quantize(_CENT, rounding=ROUND_HALF_UP)
return {"hours": hours, "base": base, "commission": commission}
def fmt_short(n: Decimal) -> str:
"""카드·합계용 — 소수점 아래가 0 이면 뺀다(48, 4.80, 1,234.50)."""
return f"{n:,.2f}".removesuffix(".00")
def broadcast_view(b: dict[str, Any], lang: str = "ko") -> dict[str, Any]:
"""방송 한 건 화면 값 — 표·달력 공통. b = db.list_broadcasts 한 줄."""
pay = session_pay(b["start_time"], b["end_time"], b["sales_amount"])
return {
"date": fmt_date(b["broadcast_date"], lang), "times": fmt_times(b["start_time"], b["end_time"]),
"host_name": b["host_name"], "tiktok_handle": b["tiktok_handle"], "venue": b["venue"],
"platform": b["host_platform"], # 호스트 쇼핑몰(tiktok·shopee, '' = 아직 안 고름) — 아이콘 /static/live-icon-<값>.png
"sales": fmt_money(b["sales_amount"]), "base": fmt_money(pay["base"]), "commission": fmt_money(pay["commission"]),
"ad_spend": fmt_money(b["ad_spend"]), "host_fee": fmt_money(b["host_fee"]),
"images": b["images"], "id": b["id"],
"label": b["host_name"], "color": HOST_COLORS[b["host_id"] % len(HOST_COLORS)],
"card_sales": fmt_short(b["sales_amount"] or Decimal(0)), "card_commission": fmt_short(pay["commission"]),
"card_fee": fmt_short(b["host_fee"] or Decimal(0)),
"edit": {"id": b["id"], "host_id": b["host_id"], "broadcast_date": b["broadcast_date"].isoformat(),
"start_time": f"{b['start_time']:%H:%M}", "end_time": f"{b['end_time']:%H:%M}" if b["end_time"] else "",
"tiktok_handle": b["tiktok_handle"],
**{k: f"{b[k]:.2f}" if b[k] is not None else "" for k in ("sales_amount", "ad_spend", "host_fee")},
"images": [{"id": i["id"], "filename": i["filename"]} for i in b["images"]]},
}
def _roas(sales: Decimal, ad_spend: Decimal) -> str:
return f"{sales / ad_spend:.2f}" if ad_spend else "-"
def _slot_of(hour: int) -> int:
return hour // SLOT_HOURS * SLOT_HOURS
def _covered_slots(b: dict[str, Any]) -> list[int]:
"""방송이 걸친 칸(시작 칸 ~ 끝 시각 올림 직전 칸). 자정을 넘기거나 00:00 에 끝나면 그날 마지막 칸까지."""
s, e = b["start_time"], b["end_time"]
end = 24 if e <= s else e.hour + (1 if (e.minute or e.second) else 0)
return sorted({_slot_of(h) for h in range(s.hour, max(end, s.hour + 1))})
def build_calendar(span: dict[str, Any], broadcasts: list[dict[str, Any]], today: date, lang: str = "ko") -> dict[str, Any]:
"""달력 보기 값 — 날짜(열)·SLOT_HOURS 칸(줄)·날짜별 합계(판매금액·광고비·호스트 비용 = 그날 방송 값 합, 2026-11-06)·달 합계.
카드는 시작 칸에, 그 칸은 방송이 걸친 칸만큼 아래로 합친다
(rowspan, 2026-11-06). 합친 칸 안에서 시작하는 다른 방송도 같은 칸에 들어가고 더 길면 칸이 더 늘어난다. 가려진 칸 = {"skip": True}."""
views = [(b, broadcast_view(b, lang)) for b in broadcasts]
used = {h for b, _ in views for h in _covered_slots(b)}
days = []
day = span["start"]
while day < span["end"]:
mine = [(b, v) for b, v in views if b["broadcast_date"] == day]
sales, fee, spend = (sum((b[k] or Decimal(0) for b, _ in mine), Decimal(0)) for k in ("sales_amount", "host_fee", "ad_spend"))
days.append({"iso": day.isoformat(), "date": day, "day": day.day, "weekday": _WEEKDAYS[day.weekday()] if lang == "en" else WEEKDAYS_KO[day.weekday()] + "요일",
"label": f"{day.day} {_MONTHS[day.month - 1]}" if lang == "en" else f"{day.month}월 {day.day}일", "is_weekend": day.weekday() >= 5, "is_today": day == today,
"count": len(mine), "sales": sales, "fee": fee, "spend": spend,
"sales_text": fmt_short(sales), "fee_text": fmt_short(fee), "spend_text": fmt_short(spend), "roas": _roas(sales, spend)})
day += timedelta(days=1)
hours = sorted(set(range(FIRST_SLOT_HOUR, 24, SLOT_HOURS)) | used) # 방송이 걸친 칸은 늘 있음 → 합칠 칸이 이어져 있다
columns = []
for d in days:
mine = [(b, v) for b, v in views if b["broadcast_date"] == d["date"]]
col, i = [], 0
while i < len(hours):
group = [(b, v) for b, v in mine if _slot_of(b["start_time"].hour) == hours[i]]
last, j = max((_covered_slots(b)[-1] for b, _ in group), default=hours[i]), i + 1
while j < len(hours) and hours[j] <= last:
more = [(b, v) for b, v in mine if _slot_of(b["start_time"].hour) == hours[j]]
group += more
last = max([last] + [_covered_slots(b)[-1] for b, _ in more])
j += 1
col.append({"iso": d["iso"], "is_weekend": d["is_weekend"], "cards": [v for _, v in group], "rowspan": j - i})
col += [{"skip": True}] * (j - i - 1)
i = j
columns.append(col)
slots = []
for k, hour in enumerate(hours):
end_hour = (hour + SLOT_HOURS) % 24
slots.append({"start": f"{hour:02d}:00", "end": f"{end_hour:02d}:00", "label": f"{hour:02d}:00 - {end_hour:02d}:00",
"cells": [col[k] for col in columns]})
sales, fee, spend = (sum((d[k] for d in days), Decimal(0)) for k in ("sales", "fee", "spend"))
return {"days": days, "slots": slots, "slot_note": f"{SLOT_HOURS} Hour{'s' if SLOT_HOURS > 1 else ''} (RM{fmt_short(HOURLY_RATE * SLOT_HOURS)} Base)" if lang == "en" else f"{SLOT_HOURS}시간 (기본 RM{fmt_short(HOURLY_RATE * SLOT_HOURS)})",
"commission_percent": fmt_short(COMMISSION_PERCENT).split(".")[0],
"totals": {"sales": fmt_short(sales), "fee": fmt_short(fee), "spend": fmt_short(spend), "roas": _roas(sales, spend)}}
def month_range(raw: Any, today: date, lang: str = "ko") -> 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": month_label(year, month, lang)}
def fmt_date(d: date, lang: str = "ko") -> str:
return f"{d:%Y.%m.%d} ({_WEEKDAYS_EN_SHORT[d.weekday()]})" if lang == "en" else 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()