# [말레이시아 실적] — `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`).