Files
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

10 KiB
Raw Permalink Blame History

[라이브커머스] 라이브 커머스 모듈 — app/modules/live/, live_db(2026-11-04)

이 모듈만 고칠 때 읽는 요약. 별도 상세 문서 없음 — 코드가 기준. 정적 파일: app/static/live.js, live.css. 템플릿: templates/live/. 테스트: tests/test_live.py(LIVE_TEST_DB_URL 이 localhost 일 때 실제 DB). 다른 모듈과 연결: 이미지 검사 = 자산 모듈 app/modules/asset/media.py prepare_photo 재사용(바꾸면 양쪽 확인). 쇼핑몰 로고 = 말레이시아 배송 모듈 app/static/dispatch/courier/tiktok.png·shopee.png(지우거나 이름을 바꾸면 호스트 설정 로고도 깨짐).

  • 말레이시아 라이브 커머스 방송의 호스트 정보·방송 스케줄. 권한키 live, DB LIVE_DB_URL(없으면 "설정 필요" 안내).
  • 호스트 설정 /live/settings — 간단한 이름(필수, display_name, 마이그레이션 004 — 말레이 이름은 끝이 아버지 이름이라 자동으로 줄이지 않고 사람이 입력, 빈 예전 호스트는 화면에 Full Name)·Full Name (as per IC)(필수)·Phone Number·Email·Address·Bank Name·Bank Account Number. 계좌 등 개인정보라 ERP 관리자만(is_admin) — 화면·저장·지우기 모두. 스케줄 화면에는 db.host_choices(이름·사용 여부)만 넘긴다. 틱톡 계정은 호스트가 아니라 방송마다(2026-11-05, 마이그레이션 003 live_broadcasts.tiktok_handle) — 호스트가 여러 계정에서 방송하므로. 방송 창에서 입력(선택), @·주소를 붙여 넣어도 계정명만 저장, 쓴 적 있는 계정을 제안(db.account_choices). live_hosts.tiktok_handle 은 값만 남아 있고 안 씀. 달력에서 옮기거나 맞바꿔도 계정은 그 방송에 그대로. 달력 카드 머리·스케줄표·방송 창의 호스트 = 간단한 이름, 카드 머리 아래 작은 글자 = 계정. live_host_edit 칩(+ live, 관리자 페이지 토글) = 호스트 고치기(사용 여부 포함): 지우기 불가, 개인정보는 페이지에 싣지 않아 빈칸으로 열리고 비워 두면 그대로·입력하면 바뀜(이 칩으로는 지울 수 없음). live_host 칩(+ live 칩 필요) = 새 호스트 등록만: 설정 화면에 이름·상태만 보이고, 입력한 계좌 등은 저장 후 못 봄. 고치기·지우기 불가, 사용 여부 못 고름(항상 사용). 쇼핑몰(2026-11-06, 마이그레이션 005 live_hosts.platform, store.PLATFORMS = tiktok·shopee) — 창 맨 위 라디오 + 로고(같은 상자 88×26, 안 고르면 흑백·고르면 컬러), 저장 때 필수. 목록 첫 열 = 로고. 예전 호스트는 빈 값(고치기에서 고르면 저장). 목록의 사용 토글(POST /live/settings/hosts/{id}/active, db.set_host_active) = 고치기 권한(관리자·live_host_edit 칩)만, 바로 저장·실패하면 되돌림. 권한 없으면 글자(사용/사용 안 함). 사용 안 함 = 새 방송에서 못 고름(그 호스트로 이미 등록된 방송을 고칠 때만 보임). 방송 기록이 있는 호스트는 못 지움(FK RESTRICT).
  • 스케줄표 /live/?month=YYYY-MM(live 권한자 모두) — 호스트·날짜·시작/끝 시간·판매금액·시간 요금(Fee)·커미션·광고비·호스트 비용·결과 이미지. 호스트·날짜·시작·끝 시간 필수(판매금액은 방송 후 입력). 시간은 입력한 말레이시아 시간 그대로(시간대 변환 없음, DATE·TIME). 금액 단위 RM(NUMERIC(14,2), store.parse_money(값, 이름)). 끝 시간이 시작보다 이르면 자정을 넘긴 방송. 표 첫 열 = 호스트 쇼핑몰 아이콘(/static/live-icon-tiktok.png·live-icon-shopee.png = 말레이시아 배송 로고에서 심볼만 잘라 64px, 쇼핑몰 안 고른 호스트는 빈칸), 머리글 = 가운데·굵게·검정·공용 크기 112%(.lv-sched, 스케줄표만). 방송 장소는 2026-11-06 에 창·표에서 뺌(venue 열은 예전 값만 남고 저장 때 건드리지 않음, 달력 카드 말풍선에만 예전 값).
  • 방송 창 금액(2026-11-06, 마이그레이션 006) — Fee(시간 × RM 25 HOURLY_RATE)·커미션(판매금액 × 10% COMMISSION_PERCENT) = 자동, 저장 안 함(store.session_pay, 창에서는 live.js recalc 가 같은 계산 — 시간·판매금액을 바꾸거나 결과 이미지에서 매출을 읽으면 다시 계산). 요율이 코드 상수라 바꾸면 지난 방송 값도 바뀐다. 광고비(live_broadcasts.ad_spend)·호스트 비용(host_fee, 일단 수기 입력) = 입력·저장. 달력 카드 Fee·날짜/달 합계 호스트 비용 = host_fee 합(비우면 0).
  • 달력 보기 /live/calendar?month=(store.build_calendar, 사용자가 준 화면 참고, 글자도 영어 그대로) — 줄 = 1시간 칸(2026-11-06 store.SLOT_HOURS 2 → 1, 06:00~24:00 늘 보임, 그보다 이른 칸은 방송이 있을 때만, 칸은 시작 시간으로 정함), 열 = 날짜, 주말 노랑, 위 달 합계, 맨 아래 날짜별 TOTAL SALES·AD SPEND·HOST FEE·ROAS. 카드 머리 왼쪽 위 = 호스트 쇼핑몰 작은 아이콘(2026-11-06, 예전 ✥ 대신 — 머리 전체가 끌기 손잡이), 카드 머리 = Tiktok Handle(없으면 이름, 색 = 호스트 id 순 HOST_COLORS), SALES·COM·Fee. 카드 머리를 끌어 빈 칸으로 = 옮기기(move, 방송 길이 유지) · 다른 카드 위 = 맞바꾸기(swap_with, 날짜·시간 교환). 다시 그린 뒤 가로 위치 유지(sessionStorage). 빈 칸 + = 그 날짜·시간이 채워진 추가 창. AD SPEND = 그날 방송 광고비(ad_spend) 합(2026-11-06 — 예전 날짜별 입력 live_daily_ad_spend·✎ 버튼·/live/ad-spend 없앰, 표는 값만 남김), ROAS = 판매금액 ÷ 광고비(광고비 없으면 -).
  • 한 화면 맞춤(2026-11-05) — 달력 보기는 넓은 화면(1101px 이상)에서 페이지 세로 스크롤 없음: .lv-cal-wrap 이 남은 높이를 쓰고, 풀HD 브라우저(세로 880px 이상)면 방송이 없는 달은 18개 시간 칸·합계 줄이 표 안 스크롤 없이 들어간다(카드가 있는 줄은 카드 높이만큼 커져서 방송이 많으면 표 안에서 스크롤, 페이지는 안 움직임). 방송이 걸친 칸은 합친다(2026-11-06, store._covered_slots → rowspan, 가려진 칸 skip) — 2시간 방송 = 두 칸, 끝이 정각이 아니면 그 칸까지, 자정 넘김은 그날 마지막 칸까지. 합친 칸 안에서 시작하는 다른 방송은 같은 칸에 들어가고 칸이 더 늘어난다(겹친 방송). 끌어 놓기는 합친 칸의 첫 시간으로. 카드·표 글자·칸 크기를 늘리면 live_calendar.browser.test.js 로 다시 확인.
  • 오른쪽 달력(2026-11-05, 달력 보기만, 세로 2분할 .lv-split, 240px = 공용 달력의 80%, 예전 날짜로 이동 줄 대신, 공용 erp-datepop mountRange + locale 옵션으로 영문) — 날짜를 누르면 그 날이 표 맨 왼쪽(마지막 날까지 — endGap 이 표 끝에 여백), 다른 달이면 그 달 화면으로 가서 맨 왼쪽(sessionStorage lv_cal_jump). 표시만 하고 요금·일수에 안 씀. 글자 굵게, 방송 있는 날 = 숫자 오른쪽 위 초록 점(2026-11-06, db.broadcast_days 보는 달 ±1년 → #lv-live-days, 공용 mountRange 의 dayClass 옵션 → has-live). 테스트 tests/js/live_calendar.browser.test.js(render_live.py). 말레이시아 공휴일 표 = holidays.py(쿠알라룸푸르 기준, 2026·2027, 대체휴일 포함) — 이슬람 명절은 달 관측으로 바뀔 수 있고, 2028 은 공고되면 손으로 추가.
  • 결과 이미지 미리보기(2026-11-06, 달력 보기) — 카드 오른쪽 아래 이미지 링크(a[data-preview])에 마우스를 올리거나 탭으로 가면 오른쪽 달력 아래 빈 곳(#lv-preview, .lv-side 세로 줄)에 첫 장을 보여 주고 벗어나면 숨김. 좁은 화면(1100px 이하)은 미리보기 없음. 링크를 누르면 화면 가운데 보기 창(#lv-viewer <dialog>) — 원본 크기(크면 창 안 스크롤), 회전(보기만, 90°씩, 다운로드는 원본), 다운로드(올린 파일 이름), 여러 장이면 ◀▶. Ctrl·가운데 클릭은 새 탭.
  • 카드 높이 = 합친 칸 높이(2026-11-06) — .lv-cell { height:1px } + .lv-cards { height:100% } 로 칸 높이를 채운다(같은 칸 여러 카드는 나눠 가짐).
  • 결과 이미지 → 매출 자동 입력(2026-11-06, ocr.py, POST /live/broadcasts/read-sales) — 창에서 이미지를 고르면 서버의 Tesseract(Dockerfile 에서 설치, 외부 전송 없음)가 이미지 위 절반을 읽어 첫 RM 금액(틱톡 LIVE 결과 화면의 Attr. GMV)을 판매금액 칸에 채운다(저장 안 함 — 사람이 확인 후 저장, 여러 장이면 찾을 때까지 한 장씩). RM1.2K 처럼 줄인 값·못 찾음 = 칸 그대로 + 안내. tesseract 가 없으면(로컬 개발 PC) 안내만.
  • 결과 이미지 — 방송 저장과 한 트랜잭션, JPG·PNG·WebP, 한 장 8MB, 방송당 10장(store.MAX_IMAGES). prepare_photo 가 실제 이미지 확인·긴 변 2400px·EXIF(GPS 등) 제거. BYTEA 저장. GET /live/images/{id}(권한 필요, 하루 private 캐시), ?thumb=1 = 160px JPEG(그때그때 만듦). 올린 뒤 내용이 안 바뀐다는 전제 — 이미지를 고치는 기능을 넣으면 캐시도 바꿀 것.
  • 라이브 커머스 화면은 공용 최대 폭(1550px)을 풀어 화면 전체 너비를 쓴다(live.css 맨 위, 스케줄표·달력·호스트 설정).
  • 저장은 live.js 가 fetch → JSON {ok, message}(틀려도 창의 입력값 유지). 창 하나로 추가·고치기(data-edit JSON).
  • 한글·영문 전환(i18n.py) — 위 막대 [한글|EN], 쿠키 live_lang(브라우저마다, path=/live, 기본 한글). 한글 문구가 키, 템플릿 t('…'), 오류 LiveError(틀, 값)(라우터가 언어에 맞게), JS LV_T(JS_KEYS). 새 문구는 i18n.EN 에도 넣는다 — tests/test_live.py 가 빠진 문구와 영문 화면의 한글을 잡는다. 입력한 데이터(이름·장소 등)·ERP 공용 사이드바는 번역하지 않는다.
  • 메인 카드 제목 = main.py card_title(한글·영문), 사이드바는 title 그대로.