From e3bc9d518d5d5d7bc8e23e8b9bf4e21bbc02c241 Mon Sep 17 00:00:00 2001 From: king Date: Wed, 14 Oct 2026 17:32:01 +0900 Subject: [PATCH] =?UTF-8?q?feat(performance):=20=EA=B4=91=EA=B3=A0?= =?UTF-8?q?=EB=B9=84=20=ED=8C=8C=EC=9D=BC=20=EC=97=AC=EB=9F=AC=20=EA=B0=9C?= =?UTF-8?q?=20=EC=97=85=EB=A1=9C=EB=93=9C(=EA=B0=99=EC=9D=80=20=EB=82=A0?= =?UTF-8?q?=EC=A7=9C=EB=8A=94=20=EC=B5=9C=EC=8B=A0=20=ED=8C=8C=EC=9D=BC)?= =?UTF-8?q?=20+=20=EB=81=9D=EB=82=98=EB=A9=B4=20=EC=B0=BD=20=EB=8B=AB?= =?UTF-8?q?=EA=B8=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- app/modules/performance/ad_spend.py | 36 +++++++++++ app/modules/performance/router.py | 40 +++++++++---- .../templates/performance/ads.html | 2 +- .../templates/performance/index.html | 2 +- .../templates/performance/settings.html | 2 +- .../performance/tests/test_ad_spend.py | 60 +++++++++++++++++++ app/static/performance.js | 19 +++--- docs/PERFORMANCE_MODULE.md | 4 +- tests/js/perf_manual.test.js | 10 +++- 9 files changed, 150 insertions(+), 25 deletions(-) diff --git a/app/modules/performance/ad_spend.py b/app/modules/performance/ad_spend.py index 9e79e59..afbbad5 100644 --- a/app/modules/performance/ad_spend.py +++ b/app/modules/performance/ad_spend.py @@ -295,6 +295,42 @@ UPLOAD_HELP = { "naver": "네이버 광고 보고서(CSV 또는 엑셀) — 3열 기간(날짜), 4열 총비용 = 그날 광고비, 12열 구매완료 광고수익률 = ROAS. " "나머지 항목은 네이버 머리글을 누르면 일자별로 볼 수 있습니다.", "coupang_wing": _COUPANG_HELP, "coupang_rocket": _COUPANG_HELP} +MAX_UPLOAD_FILES = 30 + + +def merge_results(parsed: list[tuple[str, float, ParseResult]]) -> tuple[ParseResult, list[date]]: + """여러 파일(이름, 파일 수정 시각, 읽은 결과)을 하나로 — 같은 날짜가 여러 파일에 있으면 **파일 날짜(수정 시각)가 최신인 + 파일** 값(같으면 나중에 올린 파일). 돌려주는 값: (합친 결과, 여러 파일에 겹친 날짜). 오류는 파일 이름을 앞에 붙여 모은다.""" + merged = ParseResult() + owner: dict[date, tuple[float, int]] = {} + overlap: set[date] = set() + for idx, (name, modified, res) in enumerate(parsed): + merged.errors.extend(f"[{name}] {e}" for e in res.errors) + merged.skipped += res.skipped + for c in res.columns: + if c not in merged.columns: + merged.columns.append(c) + picked: dict[date, tuple[int, int]] = {} + for idx, (name, modified, res) in enumerate(parsed): + for day, amt in res.entries: + key = (float(modified or 0), idx) + if day in owner: + overlap.add(day) + if key < owner[day]: + continue + owner[day] = key + picked[day] = (idx, amt) + for day in sorted(picked): + idx, amt = picked[day] + res = parsed[idx][2] + merged.entries.append((day, amt)) + if day in res.roas: + merged.roas[day] = res.roas[day] + if day in res.metrics: + merged.metrics[day] = res.metrics[day] + return merged, sorted(overlap) + + # 머리글을 누르면 일자별 상세 표가 열리는 채널(보고서 항목을 보관하는 채널) DETAIL_CHANNELS = frozenset({"naver"}) diff --git a/app/modules/performance/router.py b/app/modules/performance/router.py index f1f928d..b198ec8 100644 --- a/app/modules/performance/router.py +++ b/app/modules/performance/router.py @@ -39,7 +39,7 @@ from decimal import Decimal, InvalidOperation from pathlib import Path from typing import Any -from fastapi import APIRouter, Body, File, HTTPException, Query, Request, UploadFile +from fastapi import APIRouter, Body, File, Form, HTTPException, Query, Request, UploadFile from fastapi.responses import FileResponse, HTMLResponse, JSONResponse from app.timezone import today_kst @@ -460,8 +460,15 @@ def api_ad_spend_details(request: Request, channel: str, from_: str = Query(..., @router.post("/api/ad-spend/upload") -def api_ad_spend_upload(request: Request, channel: str = Query(...), file: UploadFile = File(...)) -> JSONResponse: - """광고비 파일 업로드 — 파일에 있는 날만 덮어쓴다. 잘못된 줄이 있으면 아무것도 저장하지 않는다.""" +def api_ad_spend_upload( + request: Request, + channel: str = Query(...), + files: list[UploadFile] | None = File(None), + file: UploadFile | None = File(None), + modified: list[str] = Form(default=[]), +) -> JSONResponse: + """광고비 파일 업로드(여러 파일 가능, 2026-10-14) — 파일에 있는 날만 덮어쓴다. 같은 날짜가 여러 파일에 있으면 + 파일 날짜(브라우저가 보낸 수정 시각 modified, 파일 순서대로 ms)가 최신인 파일 값. 잘못된 줄이 하나라도 있으면 아무것도 저장하지 않는다.""" from . import ad_spend # noqa: WPS433 from .manual_upload import MAX_FILE_BYTES, UploadError # noqa: WPS433 @@ -470,15 +477,27 @@ def api_ad_spend_upload(request: Request, channel: str = Query(...), file: Uploa parser = ad_spend.PARSERS.get(channel) if parser is None: raise HTTPException(status_code=400, detail=f"{ad_spend.CHANNEL_NAMES[channel]} 업로드 양식은 아직 정해지지 않았습니다.") - content = file.file.read(MAX_FILE_BYTES + 1) - try: - res = parser(content, today=today_kst(), filename=file.filename or "") - except UploadError as exc: - raise HTTPException(status_code=400, detail=str(exc)) from None + uploads = list(files or []) + ([file] if file is not None else []) + if not uploads: + raise HTTPException(status_code=400, detail="파일을 고르세요.") + if len(uploads) > ad_spend.MAX_UPLOAD_FILES: + raise HTTPException(status_code=400, detail=f"한 번에 {ad_spend.MAX_UPLOAD_FILES}개 파일까지 올릴 수 있습니다.") + parsed = [] + for i, up in enumerate(uploads): + name = up.filename or f"파일{i + 1}" + try: + mtime = float(modified[i]) if i < len(modified) and str(modified[i]).strip() else 0.0 + except ValueError: + mtime = 0.0 + try: + parsed.append((name, mtime, parser(up.file.read(MAX_FILE_BYTES + 1), today=today_kst(), filename=name))) + except UploadError as exc: + raise HTTPException(status_code=400, detail=(f"[{name}] " if len(uploads) > 1 else "") + str(exc)) from None + res, overlap = ad_spend.merge_results(parsed) if res.errors: return JSONResponse(status_code=400, content={ "detail": f"잘못된 줄이 {len(res.errors)}개 있어 아무것도 저장하지 않았습니다. 고친 뒤 다시 올려 주세요.", - "errors": res.errors}) + "errors": res.errors[:60]}) report = {"roas": res.roas, "metrics": res.metrics} if (res.roas or res.metrics) else {} try: saved = store.set_ad_spend_bulk(channel, list(res.entries), source="upload", user=user.get("email", ""), **report) @@ -486,7 +505,8 @@ def api_ad_spend_upload(request: Request, channel: str = Query(...), file: Uploa raise HTTPException(status_code=503, detail=_ad_migration_help(exc)) from None 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, + "total": sum(a for _, a in res.entries), "skipped": res.skipped, "files": len(uploads), + "overlap_days": len(overlap), "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 28dedf6..15701a5 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 3c5cfd1..6093138 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 bf92ffe..b1131f5 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 8502444..fdd0e3e 100644 --- a/app/modules/performance/tests/test_ad_spend.py +++ b/app/modules/performance/tests/test_ad_spend.py @@ -303,3 +303,63 @@ def test_naver_upload_and_details_endpoints(monkeypatch): r = client.post("/performance/api/ad-spend/upload?channel=naver", files={"file": ("n.csv", NAVER_CSV.encode("utf-8"))}) assert r.status_code == 503 and "006" in r.json()["detail"] assert "006" in client.get("/performance/api/ad-spend/naver/details?from=2026-09-01&to=2026-09-30").json()["detail"] + + +def test_merge_results_newest_file_wins(): + """여러 파일 — 같은 날짜는 파일 날짜(수정 시각)가 최신인 파일 값, 같으면 나중 파일. ROAS·상세도 그 파일 것.""" + a = ads.ParseResult(entries=[(date(2026, 9, 1), 100), (date(2026, 9, 2), 200)], + roas={date(2026, 9, 2): Decimal("10")}, metrics={date(2026, 9, 2): {"노출수": 1}}, columns=["노출수"]) + b = ads.ParseResult(entries=[(date(2026, 9, 2), 999), (date(2026, 9, 3), 300)], + roas={date(2026, 9, 2): Decimal("99")}, metrics={date(2026, 9, 2): {"노출수": 9}}, columns=["노출수", "클릭수"]) + m, overlap = ads.merge_results([("new.csv", 2000.0, a), ("old.csv", 1000.0, b)]) # a 가 최신 + assert m.entries == [(date(2026, 9, 1), 100), (date(2026, 9, 2), 200), (date(2026, 9, 3), 300)] + assert m.roas[date(2026, 9, 2)] == Decimal("10") and m.metrics[date(2026, 9, 2)] == {"노출수": 1} + assert overlap == [date(2026, 9, 2)] and m.columns == ["노출수", "클릭수"] + m2, _ = ads.merge_results([("a.csv", 1000.0, a), ("b.csv", 1000.0, b)]) # 같은 시각 → 나중 파일 + assert dict(m2.entries)[date(2026, 9, 2)] == 999 + bad = ads.ParseResult(errors=["3행: 오류"]) + m3, _ = ads.merge_results([("a.csv", 1.0, a), ("bad.csv", 2.0, bad)]) + assert m3.errors == ["[bad.csv] 3행: 오류"] + + +def test_upload_multiple_files_endpoint(monkeypatch): + import importlib + + from fastapi import FastAPI + from fastapi.testclient import TestClient + + from app.modules.performance import common + + perf_router = importlib.import_module("app.modules.performance.router") + + class Store: + saved: list = [] + + def set_ad_spend_bulk(self, code, entries, *, source="manual", user="", roas=None, metrics=None): + self.saved = list(entries) + self.roas = roas + return len(entries) + + store = Store() + monkeypatch.setattr(common, "require_store", lambda request, admin=False: (store, {"email": "king@x"})) + monkeypatch.setattr(perf_router, "today_kst", lambda: TODAY) + app = FastAPI() + app.include_router(perf_router.router) + client = TestClient(app) + old = NAVER_CSV + new = NAVER_CSV.replace("2026.09.23.,300672", "2026.09.23.,111111").replace(",67.58", ",12.34") + files = [("files", ("new.csv", new.encode("utf-8"))), ("files", ("old.csv", old.encode("utf-8")))] + r = client.post("/performance/api/ad-spend/upload?channel=naver", files=files, data={"modified": ["2000", "1000"]}) + assert r.status_code == 200, r.text + body = r.json() + assert body["files"] == 2 and body["overlap_days"] == 5 and body["saved"] == 5 + assert dict(store.saved)[date(2026, 9, 23)] == 111111 and str(store.roas[date(2026, 9, 23)]) == "12.34" # 최신 파일 + r = client.post("/performance/api/ad-spend/upload?channel=naver", files=files, data={"modified": ["1000", "2000"]}) + assert dict(store.saved)[date(2026, 9, 23)] == 300672 # 이번엔 old 가 최신 + bad = NAVER_CSV + "0_미라네주방,38461,2026.09.20.,abc,0,0,0,0,0,0,0,1\n" + r = client.post("/performance/api/ad-spend/upload?channel=naver", + files=[("files", ("ok.csv", old.encode("utf-8"))), ("files", ("bad.csv", bad.encode("utf-8")))]) + assert r.status_code == 400 and r.json()["errors"][0].startswith("[bad.csv]") + r = client.post("/performance/api/ad-spend/upload?channel=naver", files={"file": ("one.csv", old.encode("utf-8"))}) + assert r.status_code == 200 and r.json()["files"] == 1 # 예전 file 한 개도 + assert client.post("/performance/api/ad-spend/upload?channel=naver").status_code in (400, 422) diff --git a/app/static/performance.js b/app/static/performance.js index 32426dc..d47a7cc 100644 --- a/app/static/performance.js +++ b/app/static/performance.js @@ -329,7 +329,8 @@ return '"; }).join("") + "" + '

' + - '' + + '' + + '

파일을 여러 개 고를 수 있습니다. 같은 날짜가 여러 파일에 있으면 파일 날짜(수정 시각)가 최신인 파일 값을 씁니다.

' + '
'; const sel = m.body.querySelector(".perf-ad-channel"); const help = m.body.querySelector(".perf-ad-help"); @@ -347,12 +348,15 @@ m.foot.appendChild(go); cancel.addEventListener("click", m.close); go.addEventListener("click", async function () { - const f = fileInput.files && fileInput.files[0]; - if (!f) { out.innerHTML = '

파일을 고르세요.

'; return; } + const picked = Array.prototype.slice.call(fileInput.files || []); + if (!picked.length) { out.innerHTML = '

파일을 고르세요.

'; return; } go.disabled = true; - out.innerHTML = '

올리는 중…

'; + out.innerHTML = '

올리는 중… (' + picked.length + "개 파일)

"; const fd = new FormData(); - fd.append("file", f); + picked.forEach(function (f) { + fd.append("files", f); + fd.append("modified", String(f.lastModified || 0)); // 같은 날짜는 파일 날짜가 최신인 파일 값 + }); let res, body = null; try { res = await fetch("/performance/api/ad-spend/upload?channel=" + encodeURIComponent(sel.value), @@ -372,9 +376,8 @@ return; } saved = body.saved > 0; - out.innerHTML = '

' + esc(body.name) + " " + fmt(body.saved) + "일 반영 (" + - esc(body.from === body.to ? body.from : body.from + " ~ " + body.to) + ") · 합계 " + fmt(body.total) + "원

" + - '

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

'; + if (saved) { m.close(); return; } // 업로드가 끝나면 창을 닫고 표·합계·그래프를 다시 그린다(onClose 새로고침) + out.innerHTML = '

반영할 날짜가 없습니다.

'; fileInput.value = ""; }); }); diff --git a/docs/PERFORMANCE_MODULE.md b/docs/PERFORMANCE_MODULE.md index eab520b..b4de4b9 100644 --- a/docs/PERFORMANCE_MODULE.md +++ b/docs/PERFORMANCE_MODULE.md @@ -351,7 +351,9 @@ KPI: 기간 광고비(전기간 대비), 매출 대비 광고비(같은 기간 광고비 ÷ 매출 실적 총매출), 월·연 누적. 저장 `perf_ad_spend`(마이그레이션 005 — 채널 × 날짜 하나에 금액, `source` manual/upload/api), 미적용이면 화면에 안내·API 503. - 날짜 칸을 눌러 직접 입력(`PUT /api/ad-spend/{channel}/{day}`, 비우면 지움, 오늘까지) — 파란 숫자. 매출 수동 입력과 같은 JS(`MANUAL_API`). - - [파일 업로드](`POST /api/ad-spend/upload?channel=`) — 양식이 정해진 채널만(`ad_spend.PARSERS`). 파일에 있는 날만 덮어쓰고(주황 숫자), + - [파일 업로드](`POST /api/ad-spend/upload?channel=`) — 양식이 정해진 채널만(`ad_spend.PARSERS`). **여러 파일**을 한 번에(2026-10-14, + `files` + 파일마다 `modified` = 브라우저 File.lastModified, 최대 30개) — 같은 날짜가 여러 파일에 있으면 **파일 날짜(수정 시각)가 최신인 파일** 값 + (같으면 나중 파일, `ad_spend.merge_results`), 오류는 `[파일 이름]` 을 붙여 모두 보여 주고 하나라도 있으면 전부 저장 안 함. 업로드가 끝나면 창을 닫고 새로고침. 파일에 있는 날만 덮어쓰고(주황 숫자), 잘못된 줄이 하나라도 있으면 아무것도 저장하지 않는다. **쿠팡(윙)·쿠팡(로켓)**(같은 양식, 윙은 2026-10-14) = 쿠팡 광고 보고서 CSV(UTF-8/CP949)·엑셀: 1열 날짜(`2026년 10월 01일`), 19열 청구금액(+부가가치세). "전체" 합계 줄·머리글·캠페인 줄(1열 빈 칸)은 건너뜀. - **네이버**(2026-10-14) = 네이버 광고 보고서 CSV·엑셀(하루 한 줄): 3열 기간(`2026.09.30.`), 4열 총비용 = 광고비, diff --git a/tests/js/perf_manual.test.js b/tests/js/perf_manual.test.js index 78af6b2..3dc8cc4 100644 --- a/tests/js/perf_manual.test.js +++ b/tests/js/perf_manual.test.js @@ -193,13 +193,17 @@ function gross(td) { return td.querySelector(".v-gross").textContent.trim(); } modal.querySelector(".perf-ad-channel").dispatchEvent(new e.w.Event("change")); check("[업로드] 양식 안내(19열 청구금액)", /19열/.test(modal.querySelector(".perf-ad-help").textContent)); const fileInput = modal.querySelector(".perf-upload-file"); - const f = new e.w.File(["날짜"], "rocket.csv", { type: "text/csv" }); - Object.defineProperty(fileInput, "files", { value: [f] }); + check("[업로드] 파일 여러 개 고르기", fileInput.multiple === true); + const f = new e.w.File(["날짜"], "rocket.csv", { type: "text/csv", lastModified: 1700000000000 }); + const f2 = new e.w.File(["날짜"], "rocket2.csv", { type: "text/csv", lastModified: 1800000000000 }); + Object.defineProperty(fileInput, "files", { value: [f, f2] }); Array.from(modal.querySelectorAll(".perf-modal-foot button, button")).filter(function (b) { return b.textContent === "업로드"; })[0].click(); await settle(); const post = e.calls.find(function (c) { return c.method === "POST"; }); check("[업로드] POST /api/ad-spend/upload?channel=coupang_rocket (파일)", post && post.url === "/performance/api/ad-spend/upload?channel=coupang_rocket" && !!post.form, e.calls); - check("[업로드] 결과 안내(12일 반영)", /12일 반영/.test(modal.querySelector(".perf-upload-result").textContent)); + 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")); } // ── 네이버 — 보고서 ROAS 표시 · 머리글 → 일자별 보고서 항목 ── {