15dcabc538
스케줄표·달력·호스트 설정 위에 한글/EN 버튼을 두고 화면·창·오류·확인 문구를 모두 전환한다(쿠키 live_lang, 브라우저마다 기억). 메인 카드 제목은 "라이브 커머스 · Live Commerce"로 표기한다. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
4.0 KiB
4.0 KiB
[라이브커머스] 라이브 커머스 모듈 — 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재사용(바꾸면 양쪽 확인).
- 말레이시아 라이브 커머스 방송의 호스트 정보·방송 스케줄. 권한키
live, DBLIVE_DB_URL(없으면 "설정 필요" 안내). - 호스트 설정
/live/settings— Full Name (as per IC)(필수)·Phone Number·Email·Address·Bank Name·Bank Account Number·Tiktok Handle(@·주소를 붙여 넣어도 계정명만 저장). 계좌 등 개인정보라 ERP 관리자만(is_admin) — 화면·저장·지우기 모두. 스케줄 화면에는db.host_choices(이름·틱톡·사용 여부)만 넘긴다. 사용 안 함 = 새 방송에서 못 고름(그 호스트로 이미 등록된 방송을 고칠 때만 보임). 방송 기록이 있는 호스트는 못 지움(FK RESTRICT). - 스케줄표
/live/?month=YYYY-MM(live권한자 모두) — 호스트·날짜·시작/끝 시간·방송 장소·판매금액·커미션·호스트 비용·결과 이미지. 호스트·날짜·시작·끝 시간 필수(판매금액은 방송 후 입력). 시간은 입력한 말레이시아 시간 그대로(시간대 변환 없음, DATE·TIME). 판매금액 단위 RM(NUMERIC(14,2),store.parse_money). 끝 시간이 시작보다 이르면 자정을 넘긴 방송. - 호스트 비용(
store.session_pay, 저장 안 함 — 화면마다 계산) = 시간 × RM 25(HOURLY_RATE) + 판매금액 × 10%(COMMISSION_PERCENT). 요율이 코드 상수라 바꾸면 지난 방송 금액도 바뀐다. - 달력 보기
/live/calendar?month=(store.build_calendar, 사용자가 준 화면 참고, 글자도 영어 그대로) — 줄 = 2시간 칸(06:00~24:00 늘 보임, 그보다 이른 칸은 방송이 있을 때만, 칸은 시작 시간으로 정함), 열 = 날짜, 주말 노랑, Jump to Date, 위 달 합계, 맨 아래 날짜별 TOTAL SALES·AD SPEND·HOST FEE·ROAS. 카드 머리 = Tiktok Handle(없으면 이름, 색 = 호스트 id 순HOST_COLORS), SALES·COM·Fee. 카드 머리를 끌어 빈 칸으로 = 옮기기(move, 방송 길이 유지) · 다른 카드 위 = 맞바꾸기(swap_with, 날짜·시간 교환). 다시 그린 뒤 가로 위치 유지(sessionStorage). 빈 칸 + = 그 날짜·시간이 채워진 추가 창. AD SPEND = 날짜별 광고비live_daily_ad_spend(마이그레이션 002,POST /live/ad-spend, 빈칸 = 지우기), ROAS = 판매금액 ÷ 광고비(광고비 없으면-). 002 미적용이면 0 으로 보이고 저장만 안내. - 결과 이미지 — 방송 저장과 한 트랜잭션, JPG·PNG·WebP, 한 장 8MB, 방송당 10장(
store.MAX_IMAGES).prepare_photo가 실제 이미지 확인·긴 변 2400px·EXIF(GPS 등) 제거. BYTEA 저장.GET /live/images/{id}(권한 필요, 하루 private 캐시),?thumb=1= 160px JPEG(그때그때 만듦). 올린 뒤 내용이 안 바뀐다는 전제 — 이미지를 고치는 기능을 넣으면 캐시도 바꿀 것. - 저장은
live.js가 fetch → JSON{ok, message}(틀려도 창의 입력값 유지). 창 하나로 추가·고치기(data-editJSON). - 한글·영문 전환(
i18n.py) — 위 막대 [한글|EN], 쿠키live_lang(브라우저마다, path=/live, 기본 한글). 한글 문구가 키, 템플릿t('…'), 오류LiveError(틀, 값)(라우터가 언어에 맞게), JSLV_T(JS_KEYS). 새 문구는i18n.EN에도 넣는다 —tests/test_live.py가 빠진 문구와 영문 화면의 한글을 잡는다. 입력한 데이터(이름·장소 등)·ERP 공용 사이드바는 번역하지 않는다. - 메인 카드 제목 =
main.pycard_title(한글·영문), 사이드바는title그대로.