Files
dbx-main/app/modules/malaysia_performance/CLAUDE.md
T
king 62cc5e2778 feat(실적): 틱톡 탭 삭제 + [말레이시아 실적] 모듈 추가
- 실적 틱톡 탭·tiktok_ads 광고 API·테스트 삭제, 틱톡 데이터 삭제 SQL(performance_db 012)
- 말레이시아 실적: 실적 라우터·화면을 /malaysia/performance 에 한 번 더 마운트,
  차이는 performance/variant.py(KR·MY) 한 곳 — 저장소·권한키·주소·광고 채널·통화
- 틱톡·쇼피·라자다 그룹(쇼핑몰 + 라이브커머스 하위, 그룹 열 = 합계), 광고비 채널 3개
- 금액 RM 소수 2자리 = 센 정수 저장(입력·엑셀 scale, 화면 num/money, JS money)
- malaysia_performance_db = performance_db 구조 복사 + seed

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-20 16:03:18 +09:00

3.2 KiB

[말레이시아 실적] — app/modules/malaysia_performance/, malaysia_performance_db (2026-11-20)

이 폴더는 얇은 마운트(__init__.py 하나)다. 코드·템플릿·performance.js/css 는 전부 실적 모듈(app/modules/performance/) 것을 그대로 쓴다. 실적과 다른 점은 app/modules/performance/variant.py 의 MY 한 곳. 실적 화면·기능을 고치면 이 화면에도 그대로 들어간다 — 둘 다 확인.

구성

  • 주소 /malaysia/performance/(매출 실적) · /ads(광고비) · /settings(톱니). 권한키 malaysia_performance. 메뉴 "말레이시아 실적"(관리).
  • main.py: app.state.malaysia_performance_store = MALAYSIA_PERFORMANCE_DB_URL(없으면 "설정 필요"), include_router 는 실적 다음(라우트 이름은 실적이 먼저).
  • 요청 → 마운트 의존성 variant.use_malaysia(async) → ContextVar MY → common.get_store·권한·base_ctx·ad_spend.channel_names/roas_sales·dashboard.sales_ad_channels/load_unit·금액 파싱이 이 값을 본다.

매출 실적

  • 쇼핑몰 = 틱톡·쇼피·라자다 그룹(합계 열), 각 그룹 하위 쇼핑몰·라이브커머스 두 칸(직접 추가 쇼핑몰 = 수동 입력 전용). 그룹 열 = 두 칸 합계, 일 합계 = 6칸 합계. 코드 group_<쇼핑몰>·custom_<쇼핑몰>_shop·custom_<쇼핑몰>_live — scripts/sql/malaysia_performance_db_seed.sql 과 variant.MY 가 같아야 한다(이름은 설정에서 바꿔도 됨).
  • 금액 = RM 소수 2자리. 저장은 센(0.01 RM) 정수(variant.MY.scale = 100) — 계산·수수료·ROAS 코드는 실적 그대로. 입력 formula.parse_amount(raw, scale)·엑셀 manual_upload.parse_amount(v, scale)(RM 글자 허용), 화면 dashboard.amount_text(v, "rm")·variant.num_text/money_text/input_text, JS money()(.perf data-cents).
  • 매출 업데이트 버튼·다음 업데이트·화면 자동 새로 고침 없음(API 수집 없음 — jobs 는 한국 실적 것). 엑셀 업로드 샘플은 지금 쇼핑몰 이름으로 만든다(router._manual_sample_from).
  • 그룹 칸 아래 주황 줄 = 그 쇼핑몰 광고비(ROAS%), ROAS = 쇼핑몰 + 라이브커머스 매출 ÷ 광고비(variant.MY.ad_lines·ad_roas_sales).

광고비

  • 채널 = 틱톡·쇼피·라자다(tiktok·shopee·lazada), 날짜 칸 직접 입력만(업로드·광고 API 없음). 금액 RM(센 저장).

설정

  • 쇼핑몰 표(사용·매출 집계·수동 입력·수수료율·이름·그룹·순서·추가/삭제) + 보기 설정 + 공통 보기 설정(열 숨기기). API 인증·광고 API·자동 업데이트·암호화 키·과거 매출·테스트 데이터 카드 없음, 매출 단위 = RM 고정.

DB

  • malaysia_performance_db = performance_db 구조만 복사(pg_dump --schema-only) + seed. 역할 performance_app 공유. 만드는 순서는 seed 파일 머리말.
  • performance_db 에 새 마이그레이션을 만들면 이 DB 에도 적용한다.

테스트

  • app/modules/performance/tests/test_malaysia_variant.py(센 파싱·그룹 합계·광고비 줄·화면 주소·API 저장 단위·샘플), tests/js/perf_malaysia.browser.test.js(렌더 perf_my_*.html).