Files
dbx-main/app/modules/live/router.py
T
king e6ebf2188b feat(라이브): 호스트 간단한 이름과 수정 권한 칩
호스트에 간단한 이름(display_name, 필수)을 추가하고 달력 카드·스케줄표·방송 창에 표시한다.
달력 카드 머리 아래에 그 방송의 틱톡 계정을 작게 보여 준다.
관리자 페이지 칩 live_host_edit 로 호스트 수정을 허용한다. 지우기는 관리자만이고,
개인정보는 페이지에 싣지 않아 빈칸으로 열리며 비워 두면 값이 유지된다.
마이그레이션 004: live_hosts.display_name 추가.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 18:15:30 +09:00

312 lines
15 KiB
Python

"""라이브 커머스(live) 라우터 — 말레이시아 라이브 방송의 호스트 정보·방송 스케줄(2026-11-04).
GET /live/ 스케줄표(?month=YYYY-MM) · GET /live/calendar 달력 보기(같은 달 값)
POST /live/broadcasts 방송 추가·고치기(id 칸이 있으면 고치기) + 결과 이미지 올리기
POST /live/broadcasts/{id}/delete 방송 지우기(이미지도 함께)
POST /live/broadcasts/{id}/move 달력에서 끌어 옮기기(broadcast_date·start_time) 또는 맞바꾸기(swap_with)
POST /live/ad-spend 날짜별 광고비(빈칸 = 지우기)
GET /live/images/{id} 결과 이미지(?thumb=1 = 작은 그림) · POST /live/images/{id}/delete
GET /live/settings 설정 — 호스트 정보(ERP 관리자만, 계좌 등 개인정보. `live_host` 칩은 이름·틱톡·상태만)
POST /live/settings/hosts 호스트 추가·고치기 · POST /live/settings/hosts/{id}/delete
권한: 모듈 권한키 `live`(스케줄), 설정은 ERP 관리자, `live` + `live_host` 칩 = 새 호스트 등록, `live` + `live_host_edit` 칩 = 고치기(둘 다 개인정보는 안 보임).
DB: LIVE_DB_URL(live_db) — 없으면 "설정 필요" 안내.
저장 요청은 live.js 가 fetch 로 보내고 JSON {ok, message} 를 받는다(틀려도 입력한 값이 창에 남게).
"""
from __future__ import annotations
from pathlib import PurePath
from typing import Any
from fastapi import APIRouter, File, Form, HTTPException, Request, UploadFile
from fastapi.responses import HTMLResponse, JSONResponse, Response
from app.modules.asset.media import MAX_PHOTO_BYTES, prepare_photo
from app.timezone import today_kst
from . import i18n, store
router = APIRouter(prefix="/live", tags=["live"])
def _store(request: Request) -> Any:
return getattr(request.app.state, "live_store", None)
def _lang(request: Request) -> str:
return i18n.norm_lang(request.cookies.get(i18n.LANG_COOKIE))
def _t(request: Request, text: str) -> str:
return i18n.t(text, _lang(request))
def _user(request: Request) -> dict[str, Any]:
from app.main import get_current_user_record # noqa: WPS433
from app.store import has_module # noqa: WPS433
user = get_current_user_record(request)
if user is None:
raise HTTPException(status_code=401, detail=_t(request, "로그인이 필요합니다."))
if not has_module(user, "live"):
raise HTTPException(status_code=403, detail=_t(request, "라이브 커머스 모듈 권한이 없습니다."))
return user
def _admin(request: Request) -> dict[str, Any]:
from app.store import is_admin # noqa: WPS433
user = _user(request)
if not is_admin(user):
raise HTTPException(status_code=403, detail=_t(request, "호스트 정보는 ERP 관리자만 볼 수 있습니다."))
return user
def _can_add_host(user: dict[str, Any]) -> bool:
from app.store import has_module, is_admin # noqa: WPS433
return is_admin(user) or has_module(user, "live_host")
def _can_edit_host(user: dict[str, Any]) -> bool:
from app.store import has_module, is_admin # noqa: WPS433
return is_admin(user) or has_module(user, "live_host_edit")
def _db(request: Request) -> Any:
st = _store(request)
if st is None:
raise HTTPException(status_code=503, detail=_t(request, "라이브 커머스 DB(LIVE_DB_URL)가 설정되지 않았습니다."))
return st
def _page(request: Request) -> Any:
"""화면 공통 — (st, user) 또는 응답(로그인·권한·설정 필요)."""
from app.main import build_erp_nav, get_current_user_record, render_template # noqa: WPS433
from app.store import has_module, is_admin, login_redirect # noqa: WPS433
user = get_current_user_record(request)
if user is None:
return login_redirect(request)
if not has_module(user, "live"):
return render_template(request, "denied.html", {"reason": _t(request, "라이브 커머스 모듈 접근 권한이 없습니다."),
"is_admin": is_admin(user)}, status_code=403)
st = _store(request)
if st is None:
return render_template(request, "denied.html", {
"reason": _t(request, "라이브 커머스 모듈이 아직 설정되지 않았습니다. scripts/sql/live_db_init.sql 로 live_db 를 만들고 "
".env 에 LIVE_DB_URL 을 넣은 뒤 컨테이너를 다시 시작하세요."),
"user": user, "is_admin": is_admin(user), "nav_items": build_erp_nav(user, active="live")}, status_code=503)
return st, user
def _render(request: Request, name: str, user: dict[str, Any], ctx: dict[str, Any]) -> HTMLResponse:
from app.main import build_erp_nav, render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433
lang = _lang(request)
return render_template(request, name, {"user": user, "is_admin": is_admin(user), "can_add_host": _can_add_host(user),
"can_edit_host": _can_edit_host(user), "lang": lang,
"t": lambda text: i18n.t(text, lang), "js_text": i18n.js_text(lang),
"nav_items": build_erp_nav(user, active="live"), **ctx})
def _ok(request: Request, message: str) -> JSONResponse:
return JSONResponse({"ok": True, "message": _t(request, message)})
def _fail(request: Request, exc: Exception) -> JSONResponse:
return JSONResponse({"ok": False, "message": i18n.error_text(exc, _lang(request))}, status_code=400)
def _opt_id(raw: str) -> int | None:
s = (raw or "").strip()
if not s:
return None
if not s.isdigit():
raise ValueError("잘못된 요청입니다.")
return int(s)
@router.get("/health")
def health(request: Request) -> JSONResponse:
return JSONResponse({"status": "ok" if _store(request) is not None else "not_configured"})
# ────────────────────────────────────────────────────────────
# 스케줄표
# ────────────────────────────────────────────────────────────
@router.get("/", response_class=HTMLResponse)
def index(request: Request, month: str = "") -> Any:
got = _page(request)
if not isinstance(got, tuple):
return got
st, user = got
lang = _lang(request)
span = store.month_range(month, today_kst(), lang)
rows = [store.broadcast_view(b, lang) for b in st.list_broadcasts(span["start"], span["end"])]
return _render(request, "live/index.html", user, {"view": "table", "span": span, "rows": rows, "hosts": st.host_choices(),
"accounts": st.account_choices(), "max_images": store.MAX_IMAGES})
@router.get("/calendar", response_class=HTMLResponse)
def calendar(request: Request, month: str = "") -> Any:
got = _page(request)
if not isinstance(got, tuple):
return got
st, user = got
today, lang = today_kst(), _lang(request)
span = store.month_range(month, today, lang)
cal = store.build_calendar(span, st.list_broadcasts(span["start"], span["end"]), st.ad_spends(span["start"], span["end"]), today, lang)
return _render(request, "live/calendar.html", user, {"view": "calendar", "span": span, "cal": cal, "hosts": st.host_choices(),
"accounts": st.account_choices(), "max_images": store.MAX_IMAGES})
@router.post("/broadcasts/{broadcast_id}/move")
def broadcast_move(request: Request, broadcast_id: int, broadcast_date: str = Form(""), start_time: str = Form(""),
swap_with: str = Form("")) -> JSONResponse:
user = _user(request)
st = _db(request)
try:
other = _opt_id(swap_with)
if other is not None:
st.swap_broadcasts(broadcast_id, other, by=user.get("email", ""))
else:
day, start = store.parse_move(broadcast_date, start_time)
st.move_broadcast(broadcast_id, day, start, by=user.get("email", ""))
except ValueError as exc:
return _fail(request, exc)
return _ok(request, "옮겼습니다.")
@router.post("/ad-spend")
def ad_spend_save(request: Request, day: str = Form(""), amount: str = Form("")) -> JSONResponse:
user = _user(request)
st = _db(request)
try:
when, _ = store.parse_move(day, "00:00")
st.save_ad_spend(when, store.parse_money(amount), by=user.get("email", ""))
except ValueError as exc:
return _fail(request, exc)
return _ok(request, "광고비를 저장했습니다.")
def _read_images(files: list[UploadFile]) -> list[dict[str, Any]]:
"""고른 파일을 실제 이미지로 확인·메타데이터 제거(GPS 등). 틀리면 ValueError — 아무것도 저장하지 않게 DB 전에."""
picked = [f for f in files if f.filename]
if len(picked) > store.MAX_IMAGES:
raise i18n.LiveError("방송 한 건에 이미지는 {max}장까지입니다.", max=store.MAX_IMAGES)
out = []
for f in picked:
name = PurePath(f.filename.replace("\\", "/")).name[:200]
try:
data, ctype, width, height = prepare_photo(f.file.read(MAX_PHOTO_BYTES + 1))
except ValueError as exc:
raise i18n.LiveError("{name}: {detail}", name=name, detail=str(exc)) from None
out.append({"filename": name, "content_type": ctype, "data": data, "width": width, "height": height})
return out
@router.post("/broadcasts")
def broadcast_save(request: Request, id: str = Form(""), host_id: str = Form(""), broadcast_date: str = Form(""),
start_time: str = Form(""), end_time: str = Form(""), venue: str = Form(""), tiktok_handle: str = Form(""),
sales_amount: str = Form(""), images: list[UploadFile] = File(default=[])) -> JSONResponse:
user = _user(request)
st = _db(request)
try:
broadcast_id = _opt_id(id)
values = store.clean_broadcast({"host_id": host_id, "broadcast_date": broadcast_date, "start_time": start_time,
"end_time": end_time, "venue": venue, "tiktok_handle": tiktok_handle, "sales_amount": sales_amount})
st.save_broadcast(broadcast_id, values, _read_images(images), by=user.get("email", ""))
except ValueError as exc:
return _fail(request, exc)
return _ok(request, "저장했습니다.")
@router.post("/broadcasts/{broadcast_id}/delete")
def broadcast_delete(request: Request, broadcast_id: int) -> JSONResponse:
_user(request)
try:
_db(request).delete_broadcast(broadcast_id)
except ValueError as exc:
return _fail(request, exc)
return _ok(request, "방송을 지웠습니다.")
@router.get("/images/{image_id}")
def image(request: Request, image_id: int, thumb: int = 0) -> Response:
_user(request)
row = _db(request).get_image(image_id)
if not row:
raise HTTPException(status_code=404, detail=_t(request, "이미지를 찾을 수 없습니다."))
data, ctype = (store.thumbnail(row["data"]), "image/jpeg") if thumb else (bytes(row["data"]), row["content_type"])
# 올린 뒤 내용이 바뀌지 않으므로 하루 캐시. 권한이 필요한 이미지라 private.
return Response(data, media_type=ctype, headers={"Cache-Control": "private, max-age=86400", "X-Content-Type-Options": "nosniff"})
@router.post("/images/{image_id}/delete")
def image_delete(request: Request, image_id: int) -> JSONResponse:
_user(request)
try:
_db(request).delete_image(image_id)
except ValueError as exc:
return _fail(request, exc)
return _ok(request, "이미지를 지웠습니다.")
# ────────────────────────────────────────────────────────────
# 설정 — 호스트 정보(ERP 관리자만: 계좌 등 개인정보). `live_host` 칩 = 새 호스트 등록만.
# ────────────────────────────────────────────────────────────
@router.get("/settings", response_class=HTMLResponse)
def settings(request: Request) -> Any:
from app.main import render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433
got = _page(request)
if not isinstance(got, tuple):
return got
st, user = got
if not (_can_add_host(user) or _can_edit_host(user)):
return render_template(request, "denied.html", {"reason": _t(request, "호스트 정보는 ERP 관리자만 볼 수 있습니다."), "is_admin": False},
status_code=403)
# host_choices = 이름·상태뿐 — 계좌 등 개인정보는 칩이 있어도 관리자에게만
return _render(request, "live/settings.html", user, {"hosts": st.list_hosts() if is_admin(user) else st.host_choices()})
@router.post("/settings/hosts")
def host_save(request: Request, id: str = Form(""), display_name: str = Form(""), full_name: str = Form(""), phone: str = Form(""), email: str = Form(""),
address: str = Form(""), bank_name: str = Form(""), bank_account: str = Form(""),
is_active: str = Form("")) -> JSONResponse:
from app.store import is_admin # noqa: WPS433
# `live_host` 칩 = 새 등록, `live_host_edit` 칩 = 고치기(개인정보는 안 보이고, 비워 두면 그대로)
user = _user(request)
if not (_can_edit_host(user) if id.strip() else _can_add_host(user)):
_admin(request)
st = _db(request)
try:
values = store.clean_host({"display_name": display_name, "full_name": full_name, "phone": phone, "email": email, "address": address, "bank_name": bank_name,
"bank_account": bank_account})
host_id = _opt_id(id)
if host_id is not None and not is_admin(user): # 개인정보를 못 보므로 빈칸 = 지우기가 아니라 그대로
old = st.get_host(host_id)
if not old:
raise i18n.LiveError("호스트를 찾을 수 없습니다.")
values.update({k: values[k] or old[k] for k in store.PRIVATE_HOST_FIELDS})
# 등록만 되는 칩 화면엔 사용 여부 칸이 없다 — 항상 사용(사용 안 함으로 만들면 본인이 되돌릴 수 없음)
st.save_host(host_id, values, is_active=bool(is_active) or not _can_edit_host(user), by=user.get("email", ""))
except ValueError as exc:
return _fail(request, exc)
return _ok(request, "호스트를 저장했습니다.")
@router.post("/settings/hosts/{host_id}/delete")
def host_delete(request: Request, host_id: int) -> JSONResponse:
_admin(request)
try:
_db(request).delete_host(host_id)
except ValueError as exc:
return _fail(request, exc)
return _ok(request, "호스트를 지웠습니다.")