diff --git a/app/modules/performance/ad_spend.py b/app/modules/performance/ad_spend.py index afbbad5..23f2ad4 100644 --- a/app/modules/performance/ad_spend.py +++ b/app/modules/performance/ad_spend.py @@ -6,7 +6,9 @@ 쿠팡(윙)·쿠팡(로켓) 업로드 양식(2026-10-13·14 사용자 제공 — 둘 다 같은 쿠팡 광고 보고서 CSV/엑셀): 1행 머리글, 1열 = 날짜("2026년 10월 01일"), 19열 = 청구금액(+부가가치세) → 그날 광고비. - 날짜 줄 아래 캠페인 줄(1열 빈 칸)과 맨 위 "전체" 합계 줄은 건너뛴다. + 규칙(2026-10-14 사용자 확인): **1열에 날짜가 있는 줄의 19열 값**을 가져온다 — 19열이 빈 줄은 건너뛰고(윙 보고서는 + 캠페인 줄에도 날짜가 있고 19열이 비어 있다), 같은 날짜에 값이 있는 줄이 여럿이면 더한다. + 1열이 빈 캠페인 줄·맨 위 "전체" 합계 줄은 건너뛴다. 날짜는 있는데 19열 값이 한 줄도 없는 날은 empty_days 로 알려 준다. 네이버 업로드 양식(2026-10-14 사용자 제공 — 네이버 광고 보고서 CSV/엑셀, 하루 한 줄): 1행 머리글, 3열 = 기간(날짜 "2026.09.30."), 4열 = 총비용 → 그날 광고비, 12열 = 구매완료 광고수익률(%) → 그날 ROAS. 나머지 열(노출수·클릭수·클릭률·전환수·구매완료 수·장바구니·총 전환매출액 …)은 머리글 이름 그대로 metrics 에 보관 — @@ -115,6 +117,7 @@ class ParseResult: roas: dict[date, Decimal] = field(default_factory=dict) metrics: dict[date, dict[str, Any]] = field(default_factory=dict) columns: list[str] = field(default_factory=list) # 상세 항목 머리글(파일 순서) + empty_days: list[date] = field(default_factory=list) # 날짜 줄은 있는데 금액이 한 줄도 없던 날(저장 안 함) # ════════════════════════════════════════════════════════════ @@ -151,10 +154,12 @@ def read_rows(content: bytes, filename: str = "") -> list[tuple[Any, ...]]: def parse_coupang_rocket(content: bytes, *, today: date, filename: str = "") -> ParseResult: - """쿠팡(로켓) 광고 보고서 → (날짜, 청구금액(+부가가치세)). 잘못된 줄이 있으면 errors 에 담는다(저장은 라우터가 막음).""" + """쿠팡(윙·로켓) 광고 보고서 → (날짜, 그날 19열 청구금액(+부가가치세) 합). 1열에 날짜가 있고 19열에 값이 있는 줄만, + 같은 날짜는 더한다. 잘못된 줄이 있으면 errors 에 담는다(저장은 라우터가 막음).""" rows = read_rows(content, filename) res = ParseResult() - seen: dict[date, int] = {} + sums: dict[date, int] = {} + dated: set[date] = set() for r, row in enumerate(rows, start=1): raw_day = row[ROCKET_DATE_COL] if len(row) > ROCKET_DATE_COL else None text = str(raw_day or "").strip() @@ -178,21 +183,21 @@ def parse_coupang_rocket(content: bytes, *, today: date, filename: str = "") -> except ValueError: res.errors.append(f"{r}행 19열: 금액이 숫자가 아닙니다({str(raw_amt)[:30]}).") continue + dated.add(day) if amt is None: - res.errors.append(f"{r}행 19열: {day.isoformat()} 청구금액이 비어 있습니다.") + res.skipped += 1 # 날짜는 있지만 19열이 빈 줄(캠페인 줄 등) — 건너뜀 elif abs(amt) > MAX_AMOUNT: res.errors.append(f"{r}행 19열: 금액이 너무 큽니다.") elif day > today: res.errors.append(f"{r}행: 앞으로의 날짜({day.isoformat()})는 입력할 수 없습니다.") - elif day in seen: - res.errors.append(f"{r}행: {day.isoformat()} 이 {seen[day]}행과 겹칩니다.") else: - seen[day] = r - res.entries.append((day, amt)) - if len(res.entries) > MAX_DATA_ROWS: + sums[day] = sums.get(day, 0) + amt # 같은 날짜에 값이 있는 줄이 여럿이면 더한다 + if len(sums) > MAX_DATA_ROWS: raise UploadError(f"한 번에 {MAX_DATA_ROWS:,}일까지 올릴 수 있습니다.") if len(res.errors) > MAX_ERRORS: break + res.entries = sorted(sums.items()) + res.empty_days = sorted(d for d in dated if d not in sums and d <= today) if not res.entries and not res.errors: raise UploadError("광고비 날짜 줄이 없습니다. 1열 날짜(예: 2026년 10월 01일), 19열 청구금액(+부가가치세) 양식인지 확인하세요.") return res @@ -304,8 +309,10 @@ def merge_results(parsed: list[tuple[str, float, ParseResult]]) -> tuple[ParseRe merged = ParseResult() owner: dict[date, tuple[float, int]] = {} overlap: set[date] = set() + empty: set[date] = set() for idx, (name, modified, res) in enumerate(parsed): merged.errors.extend(f"[{name}] {e}" for e in res.errors) + empty.update(res.empty_days) merged.skipped += res.skipped for c in res.columns: if c not in merged.columns: @@ -328,6 +335,7 @@ def merge_results(parsed: list[tuple[str, float, ParseResult]]) -> tuple[ParseRe merged.roas[day] = res.roas[day] if day in res.metrics: merged.metrics[day] = res.metrics[day] + merged.empty_days = sorted(d for d in empty if d not in picked) # 어느 파일에도 값이 없던 날 return merged, sorted(overlap) diff --git a/app/modules/performance/router.py b/app/modules/performance/router.py index b198ec8..6e48b78 100644 --- a/app/modules/performance/router.py +++ b/app/modules/performance/router.py @@ -506,7 +506,7 @@ def api_ad_spend_upload( days = sorted(d for d, _ in res.entries) return JSONResponse({"ok": True, "saved": saved, "channel": channel, "name": ad_spend.CHANNEL_NAMES[channel], "total": sum(a for _, a in res.entries), "skipped": res.skipped, "files": len(uploads), - "overlap_days": len(overlap), + "overlap_days": len(overlap), "empty_days": [d.isoformat() for d in res.empty_days[:62]], "from": days[0].isoformat() if days else None, "to": days[-1].isoformat() if days else None}) diff --git a/app/modules/performance/templates/performance/ads.html b/app/modules/performance/templates/performance/ads.html index 15701a5..d412c0a 100644 --- a/app/modules/performance/templates/performance/ads.html +++ b/app/modules/performance/templates/performance/ads.html @@ -214,4 +214,4 @@ } | tojson }} {% endblock %} -{% block scripts %}{% endblock %} +{% block scripts %}{% endblock %} diff --git a/app/modules/performance/templates/performance/index.html b/app/modules/performance/templates/performance/index.html index 6093138..80dedf2 100644 --- a/app/modules/performance/templates/performance/index.html +++ b/app/modules/performance/templates/performance/index.html @@ -255,4 +255,4 @@ } | tojson }} {% endblock %} -{% block scripts %}{% endblock %} +{% block scripts %}{% endblock %} diff --git a/app/modules/performance/templates/performance/settings.html b/app/modules/performance/templates/performance/settings.html index b1131f5..a5a6dd5 100644 --- a/app/modules/performance/templates/performance/settings.html +++ b/app/modules/performance/templates/performance/settings.html @@ -204,4 +204,4 @@ {% endblock %} -{% block scripts %}{% endblock %} +{% block scripts %}{% endblock %} diff --git a/app/modules/performance/tests/test_ad_spend.py b/app/modules/performance/tests/test_ad_spend.py index fdd0e3e..89e63f0 100644 --- a/app/modules/performance/tests/test_ad_spend.py +++ b/app/modules/performance/tests/test_ad_spend.py @@ -49,14 +49,36 @@ def test_rocket_report_reads_date_and_col19(content, name): def test_rocket_report_errors_block_everything(): - bad = ROCKET_CSV + "2026년 10월 06일,RETAIL,Taxable,,,,,,,,,,1,0,1,1,1,0,9\n" # 같은 날 두 번 - bad += "2026년 13월 40일,RETAIL,,,,,,,,,,,1,0,1,1,1,0,1\n" # 날짜 오류 - bad += "2026년 10월 07일,RETAIL,,,,,,,,,,,1,0,1,1,1,0,\n" # 금액 빈 칸 + bad = ROCKET_CSV + "2026년 13월 40일,RETAIL,,,,,,,,,,,1,0,1,1,1,0,1\n" # 날짜 오류 + bad += "2026년 10월 08일,RETAIL,,,,,,,,,,,1,0,1,1,1,0,abc\n" # 금액이 숫자 아님 bad += "2026년 10월 20일,RETAIL,,,,,,,,,,,1,0,1,1,1,0,5\n" # 앞으로의 날짜 res = ads.parse_coupang_rocket(bad.encode("utf-8"), today=TODAY) joined = " / ".join(res.errors) - assert len(res.errors) == 4, res.errors - assert "겹칩니다" in joined and "날짜를 읽을 수 없습니다" in joined and "비어 있습니다" in joined and "앞으로의 날짜" in joined + assert len(res.errors) == 3, res.errors + assert "날짜를 읽을 수 없습니다" in joined and "숫자가 아닙니다" in joined and "앞으로의 날짜" in joined + + +def test_coupang_report_date_rows_col19_summed_empty_skipped(): + """쿠팡(윙) 보고서처럼 캠페인 줄에도 1열 날짜가 있고 19열이 비어 있어도 — 날짜가 있는 줄의 19열 값만, 같은 날은 더한다 + (2026-10-14 사용자 확인: "쿠팡은 모두 1열에서 날짜가 있는 행의 19열 값"). 값이 한 줄도 없는 날은 empty_days.""" + head = ROCKET_CSV.splitlines()[0] + wing = "\n".join([ + head, + "2026-03-01,,,,VENDOR,PA,매출 성장,1,캠페인A,Adcost,DAILY_SOFT,1000,10,0,10,0,10,,", # 날짜 있고 19열 빈 줄 + "2026-03-01,,,,VENDOR,PA,매출 성장,2,캠페인B,Adcost,DAILY_SOFT,1000,20,0,20,0,20,,", + "2026-03-01,RETAIL,Taxable,,,,,,,,,,30,0,30,30,30,3,33", # 값 있는 줄 + "2026-03-01,RETAIL,Tax-free,,,,,,,,,,5,0,5,5,5,0,5", # 같은 날 값 한 줄 더 → 더함 + "2026-03-02,,,,VENDOR,PA,매출 성장,1,캠페인A,Adcost,DAILY_SOFT,1000,10,0,10,0,10,,", # 값 없는 날 + "2026-03-03,RETAIL,Taxable,,,,,,,,,,1,0,1,1,1,0,1,100", # 19열 = 1 (20열은 무시) + ]) + "\n" + for content, name in ((wing.encode("utf-8"), "w.csv"), (_xlsx(wing), "w.xlsx")): + res = ads.parse_coupang_rocket(content, today=TODAY, filename=name) + assert not res.errors, res.errors + assert res.entries == [(date(2026, 3, 1), 38), (date(2026, 3, 3), 1)] + assert res.empty_days == [date(2026, 3, 2)] + m, _ = ads.merge_results([("a.xlsx", 1.0, ads.parse_coupang_rocket(wing.encode("utf-8"), today=TODAY)), + ("b.csv", 2.0, ads.ParseResult(entries=[(date(2026, 3, 2), 7)]))]) + assert m.empty_days == [] and dict(m.entries)[date(2026, 3, 2)] == 7 # 다른 파일에 값이 있으면 빈 날 아님 def test_rocket_report_wrong_file(): @@ -170,7 +192,7 @@ def test_ad_spend_endpoints(monkeypatch): assert r.status_code == 200 and r.json()["name"] == "쿠팡(윙)" # 윙도 같은 양식 assert store.saved[0] == ("coupang_wing", date(2026, 10, 1), 220000, "upload") and len(store.saved) == 3 store.saved.clear() - bad = ROCKET_CSV + "2026년 10월 06일,RETAIL,,,,,,,,,,,1,0,1,1,1,0,9\n" + bad = ROCKET_CSV + "2026년 10월 06일,RETAIL,,,,,,,,,,,1,0,1,1,1,0,abc\n" r = client.post("/performance/api/ad-spend/upload?channel=coupang_rocket", files={"file": ("r.csv", bad.encode("utf-8"))}) assert r.status_code == 400 and r.json()["errors"] and store.saved == [] r = client.post("/performance/api/ad-spend/upload?channel=google", files={"file": ("r.csv", b"x")}) diff --git a/app/static/performance.js b/app/static/performance.js index d47a7cc..7a572a8 100644 --- a/app/static/performance.js +++ b/app/static/performance.js @@ -376,7 +376,16 @@ return; } saved = body.saved > 0; - if (saved) { m.close(); return; } // 업로드가 끝나면 창을 닫고 표·합계·그래프를 다시 그린다(onClose 새로고침) + const empty = body.empty_days || []; + // 업로드가 끝나면 창을 닫고 표·합계·그래프를 다시 그린다(onClose 새로고침). 금액이 없던 날짜가 있으면 알려 주고 창을 둔다. + if (saved && !empty.length) { m.close(); return; } + if (saved) { + out.innerHTML = '

' + esc(body.name) + " " + fmt(body.saved) + "일 반영 · 합계 " + fmt(body.total) + "원

" + + '

날짜 줄은 있지만 19열 금액이 없어 건너뛴 날짜 ' + empty.length + "일: " + + esc(empty.join(", ")) + "

" + '

창을 닫으면 표·합계·그래프가 다시 계산됩니다.

'; + fileInput.value = ""; + return; + } out.innerHTML = '

반영할 날짜가 없습니다.

'; fileInput.value = ""; }); diff --git a/docs/PERFORMANCE_MODULE.md b/docs/PERFORMANCE_MODULE.md index b4de4b9..3c3bdb1 100644 --- a/docs/PERFORMANCE_MODULE.md +++ b/docs/PERFORMANCE_MODULE.md @@ -355,7 +355,10 @@ `files` + 파일마다 `modified` = 브라우저 File.lastModified, 최대 30개) — 같은 날짜가 여러 파일에 있으면 **파일 날짜(수정 시각)가 최신인 파일** 값 (같으면 나중 파일, `ad_spend.merge_results`), 오류는 `[파일 이름]` 을 붙여 모두 보여 주고 하나라도 있으면 전부 저장 안 함. 업로드가 끝나면 창을 닫고 새로고침. 파일에 있는 날만 덮어쓰고(주황 숫자), 잘못된 줄이 하나라도 있으면 아무것도 저장하지 않는다. **쿠팡(윙)·쿠팡(로켓)**(같은 양식, 윙은 2026-10-14) = 쿠팡 광고 보고서 CSV(UTF-8/CP949)·엑셀: - 1열 날짜(`2026년 10월 01일`), 19열 청구금액(+부가가치세). "전체" 합계 줄·머리글·캠페인 줄(1열 빈 칸)은 건너뜀. + 1열 날짜(`2026년 10월 01일`), 19열 청구금액(+부가가치세). **1열에 날짜가 있는 줄의 19열 값**(2026-10-14 — 윙 보고서는 + 캠페인 줄에도 날짜가 있고 19열이 비어 있어 예전엔 "청구금액이 비어 있습니다" 로 막혔다): 19열이 빈 줄은 건너뛰고, + 같은 날짜에 값이 있는 줄이 여럿이면 더한다. "전체" 합계 줄·머리글·1열이 빈 캠페인 줄은 건너뜀. 날짜 줄은 있는데 + 값이 한 줄도 없던 날은 응답 `empty_days` — 업로드 창이 닫히지 않고 그 날짜를 알려 준다. - **네이버**(2026-10-14) = 네이버 광고 보고서 CSV·엑셀(하루 한 줄): 3열 기간(`2026.09.30.`), 4열 총비용 = 광고비, 12열 구매완료 광고수익률(%) = 그날 ROAS(`roas`), 나머지 항목(노출수·클릭수·클릭률·전환수·구매완료 수·장바구니·총 전환매출액 …)은 머리글 이름 그대로 `metrics`(JSONB). 광고 계정 이름·ID 는 넣지 않음. 직접 입력으로 광고비를 고쳐도 ROAS·상세는 그대로. diff --git a/tests/js/perf_manual.test.js b/tests/js/perf_manual.test.js index 3dc8cc4..c358883 100644 --- a/tests/js/perf_manual.test.js +++ b/tests/js/perf_manual.test.js @@ -30,7 +30,7 @@ async function env(file) { } if (/^\/performance\/api\/ad-spend\/upload/.test(url)) { return { ok: true, status: 200, json: async function () { - return { ok: true, saved: 12, name: "쿠팡(로켓)", total: 2636494, from: "2026-10-01", to: "2026-10-12" }; } }; + return { ok: true, saved: 12, name: "쿠팡(로켓)", total: 2636494, from: "2026-10-01", to: "2026-10-12", empty_days: e.uploadEmpty || [] }; } }; } const ad = /^\/performance\/api\/ad-spend\/([^/]+)\/([\d-]+)$/.exec(url); if (ad) { @@ -204,6 +204,14 @@ function gross(td) { return td.querySelector(".v-gross").textContent.trim(); } check("[업로드] 파일마다 files + 파일 날짜(modified)", post && post.form.getAll("files").length === 2 && JSON.stringify(post.form.getAll("modified")) === JSON.stringify(["1700000000000", "1800000000000"]), post && post.form.getAll("modified")); check("[업로드] 끝나면 창이 닫힘", !e.d.body.contains(modal) && !e.d.querySelector(".perf-modal")); + // 금액이 없던 날짜가 있으면 창을 두고 알려 준다 + e.uploadEmpty = ["2026-03-02"]; + e.d.getElementById("perf-ad-upload").click(); + const modal2 = e.d.querySelector(".perf-modal"); + Object.defineProperty(modal2.querySelector(".perf-upload-file"), "files", { value: [f] }); + Array.from(modal2.querySelectorAll("button")).filter(function (b) { return b.textContent === "업로드"; })[0].click(); + await settle(); + check("[업로드] 금액 없던 날짜 → 창 유지 + 날짜 안내", e.d.body.contains(modal2) && /건너뛴 날짜 1일: 2026-03-02/.test(modal2.textContent), modal2.textContent); } // ── 네이버 — 보고서 ROAS 표시 · 머리글 → 일자별 보고서 항목 ── {