From 1d3573a44aae6272e1f70c38aef98aae410c459b Mon Sep 17 00:00:00 2001 From: king Date: Tue, 13 Oct 2026 04:58:00 +0900 Subject: [PATCH] feat(performance): upload manual-input sales from an Excel file MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - [엑셀 업로드] button on the daily x marketplace table opens a popup with a sample download (module upload_sample.xlsx) and a file picker - Format: column 1 = date, columns 2+ = marketplace names as headers (setting name / short name / code, spaces and case ignored) - Only filled cells of marketplaces with manual input ON are saved (overwrite same day, blank cells keep existing values); other columns are skipped and reported - Any bad cell (not a number, unreadable/future date, duplicate day) rejects the whole file with cell references; saving is one transaction - Ignore Excel lock files (~$*) Co-Authored-By: Claude Opus 5.5 --- .gitignore | 3 + CLAUDE.md | 2 +- app/modules/performance/dashboard.py | 2 + app/modules/performance/db.py | 18 ++ app/modules/performance/manual_upload.py | 203 ++++++++++++++++++ app/modules/performance/router.py | 55 ++++- .../templates/performance/index.html | 11 +- .../templates/performance/settings.html | 4 +- .../performance/tests/test_manual_upload.py | 143 ++++++++++++ app/modules/performance/upload_sample.xlsx | Bin 0 -> 9272 bytes app/static/performance.css | 6 + app/static/performance.js | 58 +++++ docs/PERFORMANCE_MODULE.md | 6 + 13 files changed, 503 insertions(+), 8 deletions(-) create mode 100644 app/modules/performance/manual_upload.py create mode 100644 app/modules/performance/tests/test_manual_upload.py create mode 100644 app/modules/performance/upload_sample.xlsx diff --git a/.gitignore b/.gitignore index edbfd35..56d90a8 100644 --- a/.gitignore +++ b/.gitignore @@ -27,3 +27,6 @@ tests/js/.out/ # HWiNFO 실물 보고서: 시리얼/MAC/사용자 정보가 포함되어 소스에 보관하지 않음 KING-DESKTOP.XML + +# Excel 가 파일을 열 때 만드는 잠금 파일 +~$* diff --git a/CLAUDE.md b/CLAUDE.md index da7fdd5..397998b 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -38,7 +38,7 @@ Claude Code는 이 저장소에서 작업을 시작하기 전에 **반드시 아 - 카페24 상품관리 (`app/modules/cafe24/`, `cafe24_db`) — 카페24 관리자에 들어가지 않고 상품 상세페이지(description HTML) 조회·편집·즉시적용·예약적용·버전 이력. 3분할 화면(목록 | HTML 편집기 | 상품 정보 패널). 정보 패널(`routes_product_info.py`, `_side.html`)에서 상품명·판매가·공급가·소비자가, 대표이미지(`POST /admin/products/{no}/images` 에 base64 data URI + `image_upload_type=A` — NNEditor 업로드 경로를 PUT `detail_image` 에 넣는 방식은 적용 안 됨), 옵션(생성/이름·썸네일·표시방식 수정/삭제)·품목(자체코드·추가금액·진열·판매)을 수정. 카페24 OAuth/API 클라이언트는 향후 주문관리와 공유하기 위해 **공통 계층 `app/integrations/cafe24/`** 에 둔다 — 라우터에서 `httpx`/`requests` 직접 호출 금지. 토큰은 Fernet 암호화 저장(`CAFE24_TOKEN_SECRET`), 로그/화면에 토큰·시크릿 절대 미출력. 쓰기 직전 항상 카페24 현재 HTML 을 다시 읽어 `BACKUP` revision 생성(로컬 값을 현재값으로 가정 금지). **카페24 관리자 API 는 PUT 뒤 한동안 GET 에서 예전 값을 돌려준다(읽기 지연)** — 우리 캐시 문제가 아니다. 그래서 "마지막 쓰기가 권위": 상세설명은 카페24 값이 최근 revision 중 하나와 같으면 지연으로 보고 마지막 MANUAL/SCHEDULED 를 표시·지문 기준으로 쓰고(`store.resolve_description`), 스칼라(상품명·가격·이미지·진열/판매)는 PUT 응답 스냅샷(`cafe24_products.last_write_snapshot`, 마이그레이션 004)과 GET 의 `updated_date` 를 비교해 덮어씌운다(`store.overlay_recent_write`). 유예시간 `CAFE24_READ_LAG_GRACE_MIN`(기본 360분). 쓰기 후 화면은 PUT 응답으로 그리고 다시 GET 하지 않는다. 예약은 DB 저장 + 별도 worker(`app/modules/cafe24/worker.py`, compose 서비스 `dbx-cafe24-worker`)가 처리 — 웹 프로세스에서 대기하지 않는다. 권한키 `cafe24`(연결/해제는 admin 전용). 상세는 `docs/CAFE24_MODULE.md` - 프로젝트 관리 (`app/modules/project/`, `project_db`) — 아사나식. 프로젝트/서브프로젝트(self-FK `parent_id`, CASCADE)·프로젝트 색상(32색 — 아사나 16색 + 진한 16색, 수정 창 12열)·아이콘(`projects.icon`, Material Symbols 42종, 마이그레이션 011 + [아사나 아이콘] 탭 33종 `"asana:"+이름`, 채워진 모양 전용 부분 글꼴 `material-symbols-asana.woff2`)·작업(`tasks`: 담당자·우선순위·시작/마감)·진행단계(`project_stages` 칸반, 새 프로젝트는 섹션 없이 시작 — `create_project(seed_stages=True)` 일 때만 기본 4단계, 섹션 머리는 모두 `#f3f3f3` — 섹션별 색 지정 없음, 섹션 이름 굵게, 섹션 기본 담당자 `default_assignee_email` — 담당자 빈 작업을 그 섹션에 만들거나 옮기면 자동 배정, 마이그레이션 009)·멤버 배정(`project_members`)·활동이력(`project_activity`). 첫 화면(`/project/`)은 **내 작업 목록**(프로젝트 홈 카드 화면은 폐지). 프로젝트 화면은 캘린더(FullCalendar)/타임라인(vis-timeline)/보드/목록/대시보드 뷰 토글. 좌측 사이드바는 수신함·내 작업·휴지통·프로젝트 화면 공용(`templates/project/_side.html` + 프로젝트 목록 동작 `initSideTree`, 새 프로젝트/수정 모달 `_side_modals.html`) — 프로젝트 목록(순서 변경·✎·×)은 어느 화면에서나 같다. 보드는 아사나처럼 섹션이 가로로 계속 늘어나고(넘치면 가로 스크롤) 카드의 담당자·마감일을 클릭해 그 자리에서 바꾼다. 좌측 사이드바에 수신함·전체 보기(Pro user 이상 — 예전 오른쪽 위 "전체 프로젝트" 토글, `?scope=all`)·내 작업(접이식) 메뉴. 설명란 서식 도구에 글자 색·크기(서버는 span style 의 color·font-size 만 허용, `desc_inline_style`). 설명란은 주소 붙여넣기 시 자동 링크, 설명란·댓글에서 @로 멤버를 태그하면 (`task_mentions`, 마이그레이션 006) 수신함에 그 작업이 쌓인다. 진입 권한키 `project`(관리자 페이지 토글로 직원별 부여, admin 자동). **관리자 등급 4단계(2026-10-12) — 수퍼관리자(`SUPER_ADMIN_EMAIL` 한 명 고정, 추가 불가) > Admin(`role=admin`) > Pro user(`role=pro`) > User** — 판단은 `access.is_pro`(Pro user 이상)·`access.is_project_admin`(Admin 이상), 라우터 `_require_pro`, 화면 `pj_pro`·`pj_admin`(`_role_ctx`, `is_admin` 은 ERP 상단 관리자 메뉴용 그대로). pro 는 프로젝트 모듈 밖에서는 user 와 같다. 새 프로젝트·프로젝트 이름/색/아이콘/소유자 수정·멤버 배정(자기가 멤버인 프로젝트)·사이드바 순서·남의 댓글 수정/삭제·휴지통·전체 보기·담당자별 합계·전체 멤버 = Pro user 이상, 프로젝트·섹션 삭제 = Admin 이상 또는 만든 사람, 작업 삭제·서브프로젝트 = 멤버 누구나(표는 docs/PROJECT_MODULE.md 6-14). 배정 멤버(또는 owner)만 그 프로젝트를 조회 — **관리자도 멤버가 아니면 안 보임, 예외는 슈퍼관리자뿐**(2026-10-07, `access.sees_all_projects`; 사이드바 목록·검색·휴지통·알림도 같은 기준, 화면·API 모두 비멤버 403)하고 서브프로젝트/작업/단계 CRUD — URL 의 섹션·부모 작업이 그 프로젝트 것인지 서버가 검증. 실시간 반영은 `project_live_version` 카운터(마이그레이션 007, 미적용 시 MAX 폴백). 사이드바 전체 검색(`/api/search`, 제목·설명·댓글, pg_trgm) + 프로젝트/내 작업 필터 바(찾기·상태·담당자·마감·우선순위·정렬, 클라이언트 필터). 협업자(`task_followers`, 자동 팔로우: 만든 사람·담당자·댓글·@태그) — 완료·댓글 알림은 담당자+협업자에게만. 나를 태그하거나 작업이 배정되면 프로젝트 화면 가운데 아래에 깜박이는 큰 팝업(닫기 전까지, `initTaskAlerts` + `GET /api/notifications/alerts`). 작업 삭제는 휴지통(`project_trash`, 마이그레이션 010) — 삭제 직전 스냅샷 3개월 보관, Pro user 이상만 보기·복구(`/project/trash`). 권한은 **지금 기준 공통 모듈 `access.py`**(목록·배지·알림·멘션·메일 수신자·삭제·댓글 수정까지 — 멤버에서 빠지면 기록이 있어도 안 보이고 알림도 없음), 소유자 변경은 Pro user 이상, 연결(멀티호밍)된 작업은 연결된 프로젝트 멤버에게 읽기 전용(docs/PROJECT_MODULE.md 6-10). 연간 목표(마이그레이션 013, `goal_*` 테이블) — 사이드바 "목표" → 연도 펼침 → `/project/goals/{연도}` 에 매출(목표·실적·달성)·로아스 월별 숫자 + 업무 영역(상품·마케팅·컨텐츠·유통 등)별 연간·월별 글, 조회는 전원·입력(주차별 목표·연도 추가/삭제 포함)은 Pro user 이상. 3·6·9·12월 오른쪽 1~4분기 칸(글 칸 13=1분기·15=2분기·14=3분기·16=4분기 — 예전 반기 칸 번호 재사용, 15·16 은 마이그레이션 017) + 분기 월 칸 접기 애니메이션(localStorage `pj_goal_fold_q`, 표는 `width:1px`+`table-layout:fixed`), 영역·줄 이름 클릭 바로 수정, **엑셀식 칸 병합**(마우스로 끌어 사각형 선택 → 우클릭 셀 병합/병합 해제, 같은 영역 안 세로 `row_span` + 같은 분기 월 칸 가로, 글은 왼쪽 위 칸 — `goal_cell_merges`, 마이그레이션 014·015·017), 3열 줄 추가는 같은 항목 칸(2열) 안에(`goal_rows.label_cont`, 마이그레이션 016), 구조 변경은 새로고침 없이 제자리 다시 그리기(`refreshTable`)+애니메이션, 로아스는 % 표기. 월 머리 → **주간 회의록**(`/project/goals/{연도}/meetings/{월}`, 프로젝트 권한자 **누구나 수정** — Pro user 이상 [회의 완료](`completed_at`, 마이그레이션 022)면 잠금(지난주 결과는 다음 주 회의록이 열려 있는 동안 허용), 삭제·완료·완료 해제는 Pro user 이상, 표 첫 열 머리 글자 "구분", 주차 탭 — **주차는 그 달 안**(`store.month_weeks`: 1일이 월~금이면 1일~일요일이 1주차, 토·일이면 1일~다음 주 일요일, 그 뒤 월~일, 말일이 월·화면 앞 주차에 붙음, 회의록 `week_start` = 주차 시작일, 마이그레이션 020), `goal_meetings`·`goal_meeting_items` 마이그레이션 015 — 지난주 = **바로 앞 주차**(`store.prev_week_period`) 회의록의 같은 연결키 줄(`line_key`, 마이그레이션 018 — 생성 순서·이름 변경과 무관, 이름 추정 연결 금지)로 리뷰(열: 주요 업무·정량 목표 ‖ 전주 업무·결과(글, `result_note` 020)·전주 목표·결과 — 정량 목표·결과는 숫자면 원 정수 칸, 아니면 글 칸 `target_text`·`result_text`(예: 20개, 021)), 실적 조회 장애는 0원이 아니라 "미확인", 위에 목표 표 그 달 열 글을 영역별 "N월 계획" 카드로, 참석자 옆 [회의록 보드] = 그 주차의 빈 Google 슬라이드를 독립 창으로(오른쪽 🔗 아이콘 = 그 보드 링크 복사)(공유 드라이브 `MEETING_BOARD_FOLDER_ID`, 없으면 만듦, `app/integrations/google_slides.py`, Drive appProperties 로 주차 연결 — Drive·Slides 권한 토큰 필요), 표를 스크롤해도 보이는 머리 영역 3칸 = ① 월 계획 + 머리 줄에 숫자 4개 작게 1행(월 목표 매출·월 누적 목표 매출(목표 표 **주차별 매출 목표** `goal_week_targets` 1주차~이 주차 합 — 목표 표 매출 목표 월 칸을 누르면 입력 창 — 월 전체 목표는 직접 입력(주차 합계와 별개), 맨 아래 차이 = 월 목표 − 주차 합계)·월 누적 실적(1일~오늘)·누적 목표 대비 차액·%) | ② 결정 사항·메모 | ③ "N주차 작업 등록" 표(제목·담당자·프로젝트·섹션 → [적용] = 서버가 그 프로젝트에 작업 생성, `initMeetQuickTasks` — 주차별 서버 표 `goal_meeting_tasks`(마이그레이션 025)라 모두가 같이 보고, 남의 프로젝트 이름은 가림, 완료 프로젝트·섹션은 목록에서 뺌, 작업 칸(마이그레이션 026 `parent_task_id`) = 이미 있는 작업을 고르면 그 작업의 세부 작업으로 등록, 등록된 줄 제목 = 오른쪽 작업 창(편집, 저장 대기), [크게 열기] = 같은 표를 넓은 창으로), 실적 모듈 `performance_store` 매출은 머리 카드에만 읽기 전용 — 줄(쇼핑몰)별 자동 결과·이번주 실적·연결 배지·쇼핑몰 연결 메뉴는 폐지, 지난주 결과는 늘 직접 입력). 모든 열 너비 끌어서 조절(localStorage `pj_goal_col_w`), 세로 스크롤 틀 고정은 머리 줄+매출·로아스 줄까지, 항목 칸 +·우클릭으로 줄 위/아래 추가·삭제, 회의록 "주요 업무" 칸 우클릭 위/아래 줄 추가 = 항목 칸은 그대로 그 항목 안에(마이그레이션 027 `label_cont`, 항목 칸 나누기), 회의록 줄 작업은 새로고침 없이 제자리 다시 그리기(`refreshMeeting`)+애니메이션, 구분(구역) 칸 우클릭·⋯ = 구역 통째로 위/아래(`move-section`). 마감 알림(`reminders.py` 데몬 스레드, 영업일 09시, D-1/당일/지연, `task_reminders` 로 중복 방지, `PROJECT_REMINDER_*` env) — 마이그레이션 008. 라우터 핸들러는 동기 DB 라 `def` 로 둔다(`async def` 금지). 말풍선은 전부 아사나식 공용 말풍선(`.pj-hovertip`) — 새 기능도 `title=`/`data-tip=` 만 달고 별도 툴팁 구현 금지. 멤버 배정 후보는 `project` 권한 보유 등록 사용자에서 자동 목록(`GET /project/api/assignable-users`). 작업 배정·완료 시 관리자에게 메일(`app/mail.py` stdlib smtplib, `SMTP_*`+`PROJECT_NOTIFY_EMAIL` env, 미설정 시 조용히 skip, `BackgroundTasks` 비동기). 목표 표·회의록 칸 저장은 공용 `createFieldSaver`(같은 칸 요청 직렬화·보낸 값만 저장됨·실패 시 초안 유지·localStorage 초안 백업, 저장 실패면 구조 변경 중단 — docs/PROJECT_MODULE.md 6-9-3), 구역·항목 메뉴는 우클릭 + ⋮ 버튼(키보드·터치). ERP 메뉴 이름은 "Project"(`app/main.py` 모듈 목록 title). **PC 알림 프로그램**(`desktop/notifier/`, C# .NET Framework 4.8 WinForms exe 하나·트레이 상주, 마이그레이션 023 `notifier_links`·`notifier_tokens`) — 브라우저가 뒤에 있어도 태그·배정 알림을 웹 팝업과 같은 모양으로 화면 위에. 브라우저 `/project/notifier?code=` 승인으로 PC별 토큰(서버는 SHA-256 만, PC 는 DPAPI), `GET /project/api/notifier/alerts`(Bearer)는 웹 알림과 같은 `_alerts_payload`, 토큰마다 지금 사용자·권한 재확인. 프로그램이 돌고 있으면(최근 3분 확인, `notifier_active`) 웹 큰 팝업은 쉰다(`desktop: true`). 압축·난독화 금지(백신 오탐), 빌드 `desktop/notifier/build.ps1`, 상세 docs/PROJECT_MODULE.md 6-11. 댓글·답글 입력칸은 Enter 등록·Shift+Enter 줄바꿈(textarea), 설명란 이미지 더블클릭 = 별도 창 이미지 보기(확대·축소·끌어 이동). 작업 창은 **저장 버튼 없이 실시간 저장**(칸별 PUT, `saveField`/`saveChain`, 새 작업은 제목이 생기는 순간 생성). 댓글 답글·이모티콘 반응(마이그레이션 012 `task_comments.parent_id`·`task_comment_reactions`, 미적용 시 버튼 숨김·API 503), 완료 이력 줄은 `project_activity` completed 를 댓글 사이에 표시(댓글 수 제외), 댓글 `@아이디` 는 아이콘+이름 칩. 수신함은 확인 안 한 태그·읽지 않은 알림만(2026-10-08) — [확인] 버튼 없이 줄을 누르면 읽음·확인 처리(같은 작업 줄 함께) + 페이지 이동 없이 오른쪽 iframe 패널, 다른 줄을 고르거나 패널을 닫으면 그 줄은 목록에서 빠짐. 용어는 "세부 작업"(예전 하위 작업)·"메인 작업 추가". 패널(`/project/p/{pid}?task=&embed=1`, `html.pj-embed`). 상단 바 화면 배율 토글(`html.pj-ui-scale` → `.erp-app` zoom .75, 2880×1620·200%용) — **팝업은 반드시 `document.body` 에 붙인다**(배율 안의 fixed 좌표는 어긋남). 상세는 `docs/PROJECT_MODULE.md` -- 실적 (`app/modules/performance/`, `performance_db`) — 쇼핑몰 통합 매출. 네 영역 분리: ① 수집 `adapters/`(쇼핑몰 하나 = 어댑터 파일 하나 + `registry.py` 한 줄 + SQL seed 한 줄) + `sync.py`(공통 동기화, 같은 쇼핑몰 동시 실행 차단, 쇼핑몰별 실패 격리) ② 보안 `security/`(AES-256-GCM, 키 버전, 비밀값 가리기) + `credentials.py` ③ 계산 `calc.py`(주=월~일, 수수료 반올림은 `commission()` 한 곳, 요율 이력) + `db.py` ④ 화면 `dashboard.py`/`router.py`/템플릿. 쇼핑몰 API 인증정보는 `.env` 가 아니라 **설정 화면에서 입력 → 마스터 키 `APP_ENCRYPTION_KEY` 로 암호화해 DB 저장**, secret 원문은 화면으로 다시 보내지 않는다. 쇼핑몰 API 는 백엔드에서만 호출, 오류·로그·raw 는 `redact` 후 저장. 매출 기준일: 결제=결제일, 취소·반품=발생일(`sync.sales_date_for`). 금액은 원 단위 정수. 권한키 `performance`, 설정 화면은 모듈 권한자 누구나(일반 사용자는 수수료율만), 수수료 외 설정 API 는 `is_admin`. 매출 업데이트 진행 창에서 쇼핑몰별 [중지](그 쇼핑몰만 멈추고 다음 쇼핑몰로). 카페24 어댑터는 기존 `app/integrations/cafe24` 토큰 재사용. 1단계는 모의 데이터(`is_sample`)·구조까지, 실제 수집은 쇼핑몰별로 공식 문서 확인 후 순차 구현. 쿠팡은 판매자배송 발주서 + 로켓그로스 주문을 결제일로 합산(WING 판매분석 대조는 원본 데이터 확인으로). 설정의 쇼핑몰별 **수동 입력** 토글(마이그레이션 002 `manual_input`·`perf_manual_sales`) — 켜면 일자별 표 날짜 칸에 총매출 직접 입력, 넣은 날은 API 값 대신(`daily_amounts` 한 곳). 열 순서 카페24·네이버·쿠팡(윙)·쿠팡(로켓)·오늘의집·G마켓·카카오·GS샵·11번가·롯데ON·토스·애터미아자몰(마이그레이션 003). 쿠팡(로켓)·애터미아자몰은 **수동 입력 전용**(`adapters/manual.py`, `manual_only` — 매출 업데이트에서 빠지고 인증 설정·연결 테스트 없음, 수동 입력 늘 켜짐). 상세는 `docs/PERFORMANCE_MODULE.md` +- 실적 (`app/modules/performance/`, `performance_db`) — 쇼핑몰 통합 매출. 네 영역 분리: ① 수집 `adapters/`(쇼핑몰 하나 = 어댑터 파일 하나 + `registry.py` 한 줄 + SQL seed 한 줄) + `sync.py`(공통 동기화, 같은 쇼핑몰 동시 실행 차단, 쇼핑몰별 실패 격리) ② 보안 `security/`(AES-256-GCM, 키 버전, 비밀값 가리기) + `credentials.py` ③ 계산 `calc.py`(주=월~일, 수수료 반올림은 `commission()` 한 곳, 요율 이력) + `db.py` ④ 화면 `dashboard.py`/`router.py`/템플릿. 쇼핑몰 API 인증정보는 `.env` 가 아니라 **설정 화면에서 입력 → 마스터 키 `APP_ENCRYPTION_KEY` 로 암호화해 DB 저장**, secret 원문은 화면으로 다시 보내지 않는다. 쇼핑몰 API 는 백엔드에서만 호출, 오류·로그·raw 는 `redact` 후 저장. 매출 기준일: 결제=결제일, 취소·반품=발생일(`sync.sales_date_for`). 금액은 원 단위 정수. 권한키 `performance`, 설정 화면은 모듈 권한자 누구나(일반 사용자는 수수료율만), 수수료 외 설정 API 는 `is_admin`. 매출 업데이트 진행 창에서 쇼핑몰별 [중지](그 쇼핑몰만 멈추고 다음 쇼핑몰로). 카페24 어댑터는 기존 `app/integrations/cafe24` 토큰 재사용. 1단계는 모의 데이터(`is_sample`)·구조까지, 실제 수집은 쇼핑몰별로 공식 문서 확인 후 순차 구현. 쿠팡은 판매자배송 발주서 + 로켓그로스 주문을 결제일로 합산(WING 판매분석 대조는 원본 데이터 확인으로). 설정의 쇼핑몰별 **수동 입력** 토글(마이그레이션 002 `manual_input`·`perf_manual_sales`) — 켜면 일자별 표 날짜 칸에 총매출 직접 입력, 넣은 날은 API 값 대신(`daily_amounts` 한 곳). 일자별 표 [엑셀 업로드] 팝업(`manual_upload.py`, `POST /performance/api/manual-sales/upload`) — 1열 날짜·2열부터 쇼핑몰 이름 머리글, 수동 입력 켜진 쇼핑몰 열의 값 있는 칸만 반영(덮어씀, 빈 칸 그대로), 잘못된 칸이 하나라도 있으면 전부 저장 안 함, 샘플 = 모듈 폴더 `upload_sample.xlsx`. 열 순서 카페24·네이버·쿠팡(윙)·쿠팡(로켓)·오늘의집·G마켓·카카오·GS샵·11번가·롯데ON·토스·애터미아자몰(마이그레이션 003). 쿠팡(로켓)·애터미아자몰은 **수동 입력 전용**(`adapters/manual.py`, `manual_only` — 매출 업데이트에서 빠지고 인증 설정·연결 테스트 없음, 수동 입력 늘 켜짐). 상세는 `docs/PERFORMANCE_MODULE.md` - 긴급 공지 (`app/modules/notice/`, `project_db` 마이그레이션 024 `urgent_notice*`) — 수퍼관리자만 작성(`/notice/`, ERP 왼쪽 아래·Project ⚙ 옵션). 제목·내용(이미지 bytea)·띄울 시각·전체/고른 사람 → ERP 모든 화면(`erp_base.html`·`main.html`·`admin.html` 의 `static/erp-notice.js`) 가로·세로 정가운데에 [확인] 누를 때까지(Esc·바깥 클릭 무시), 확인 기록. 연결 풀은 `ProjectStore.pool` 공유, 새 환경변수 없음. PC 알림 프로그램은 아직 미지원. 상세는 `docs/NOTICE_MODULE.md` diff --git a/app/modules/performance/dashboard.py b/app/modules/performance/dashboard.py index 43102ef..7abbed6 100644 --- a/app/modules/performance/dashboard.py +++ b/app/modules/performance/dashboard.py @@ -152,6 +152,8 @@ def build_dashboard(store: Any, *, kind: str, anchor: date, today: date, "problems": problems, "manual_codes": manual_codes, "manual_cells": manual_cells, + # 엑셀 업로드 대상 — 수동 입력이 켜진 쇼핑몰 전부(쇼핑몰 선택 필터와 무관, 설정 순서) + "manual_upload_names": [m["name"] for m in markets if m.get("manual_input")], "last_update_at": store.last_update_at(), "running": store.running_codes(), "no_marketplaces": not all_codes, diff --git a/app/modules/performance/db.py b/app/modules/performance/db.py index 7aa942a..88eb0aa 100644 --- a/app/modules/performance/db.py +++ b/app/modules/performance/db.py @@ -355,6 +355,24 @@ class PerformanceDBStore: except pg_errors.UndefinedTable: raise ManualMigrationNeeded() from None + def set_manual_sales_bulk(self, entries: list[tuple[str, date, int]], *, user: str = "") -> int: + """엑셀 업로드 — (쇼핑몰, 날짜, 금액) 여러 개를 한 트랜잭션으로 저장(덮어씀). 하나라도 실패하면 모두 취소.""" + if not entries: + return 0 + try: + with self._pool.connection() as conn: + with conn.transaction(): + with conn.cursor() as cur: + cur.executemany( + "INSERT INTO perf_manual_sales (marketplace_code, sales_date, amount, updated_by) " + "VALUES (%s, %s, %s, %s) ON CONFLICT (marketplace_code, sales_date) DO UPDATE " + "SET amount = EXCLUDED.amount, updated_by = EXCLUDED.updated_by", + [(code, day, int(amount), user) for code, day, amount in entries], + ) + except pg_errors.UndefinedTable: + raise ManualMigrationNeeded() from None + return len(entries) + def daily_breakdown(self, code: str, start: date, end: date, *, id_prefix: str = "") -> list[dict[str, Any]]: """쇼핑몰 화면(일별 매출내역) 대조용 — 날짜별 결제(SALE 합·건수)·환불(그 밖, 양수)·마지막 수집 시각. id_prefix 가 있으면 이 어댑터가 다른 쇼핑몰 열로 보낸 사건까지 합친다(카페24 화면 합계와 같은 범위).""" diff --git a/app/modules/performance/manual_upload.py b/app/modules/performance/manual_upload.py new file mode 100644 index 0000000..18ee5c4 --- /dev/null +++ b/app/modules/performance/manual_upload.py @@ -0,0 +1,203 @@ +"""수동 입력 매출 엑셀 업로드 — 1열 날짜, 2열부터 쇼핑몰 이름 머리글(샘플: upload_sample.xlsx). + +규칙 + - 머리글(1행) 2열부터 = 쇼핑몰 이름. 설정의 이름·짧은 이름(네이버/토스)·코드 어느 것이든 되고 띄어쓰기·대소문자는 무시. + - 수동 입력이 켜진 쇼핑몰 열만 반영. 꺼진 쇼핑몰·모르는 이름 열은 건너뛰고 알려 준다. + - 값이 있는 칸만 반영(빈 칸은 그날 기존 값 그대로 — 지우지 않음). 0 은 값(0원)으로 저장. + - 날짜: 엑셀 날짜, 2026-10-12 · 2026.10.12 · 2026/10/12 · 20261012(뒤 요일 표기 무시). 앞으로의 날짜는 안 됨. + - 금액: 원 단위 정수(쉼표·"원" 허용, 소수는 반올림). + - 잘못된 칸이 하나라도 있으면 아무것도 저장하지 않고 오류 목록을 돌려준다(일부만 들어가 헷갈리지 않게). + +HTTP·DB 와 무관한 순수 함수 — 라우터가 파일 바이트와 쇼핑몰 목록을 넘긴다. +""" + +from __future__ import annotations + +import io +import re +from dataclasses import dataclass, field +from datetime import date, datetime, timedelta +from decimal import ROUND_HALF_UP, Decimal, InvalidOperation +from typing import Any, Iterable, Mapping + +MAX_FILE_BYTES = 5 * 1024 * 1024 +MAX_DATA_ROWS = 2000 +MAX_ERRORS = 30 +MAX_AMOUNT = 10 ** 12 # 라우터 MAX_MANUAL_AMOUNT 와 같은 상한(원) + +_EXCEL_EPOCH = date(1899, 12, 30) +_DATE_RE = re.compile(r"^(\d{4})\s*[-./년]\s*(\d{1,2})\s*[-./월]\s*(\d{1,2})") +_COMPACT_RE = re.compile(r"^(\d{4})(\d{2})(\d{2})(?!\d)") + + +class UploadError(ValueError): + """파일 자체를 읽을 수 없음(형식·크기·머리글).""" + + +@dataclass +class ParseResult: + entries: list[tuple[str, date, int]] = field(default_factory=list) # (쇼핑몰 코드, 날짜, 금액) + errors: list[str] = field(default_factory=list) + ignored: list[str] = field(default_factory=list) # 건너뛴 열(머리글 + 이유) + columns: list[str] = field(default_factory=list) # 반영 대상 쇼핑몰 코드(열 순서) + + +def _norm(text: Any) -> str: + return re.sub(r"\s+", "", str(text or "")).lower() + + +def _cell_ref(row: int, col: int) -> str: + letters = "" + n = col + while n: + n, r = divmod(n - 1, 26) + letters = chr(65 + r) + letters + return f"{letters}{row}" + + +def parse_date(value: Any) -> date | None: + """날짜 칸 → date. 읽을 수 없으면 ValueError, 빈 칸이면 None.""" + if value is None or (isinstance(value, str) and not value.strip()): + return None + if isinstance(value, datetime): + return value.date() + if isinstance(value, date): + return value + if isinstance(value, (int, float)) and not isinstance(value, bool): + n = int(value) + if 19000101 <= n <= 29991231: # 20261012 + return parse_date(str(n)) + if 20000 <= n <= 80000: # 엑셀 날짜 일련번호(서식 없는 날짜) + return _EXCEL_EPOCH + timedelta(days=n) + raise ValueError + text = str(value).strip() + m = _DATE_RE.match(text) or _COMPACT_RE.match(text) + if not m: + raise ValueError + return date(int(m.group(1)), int(m.group(2)), int(m.group(3))) + + +def parse_amount(value: Any) -> int | None: + """금액 칸 → 원 단위 정수. 빈 칸이면 None, 숫자가 아니면 ValueError.""" + if value is None or isinstance(value, bool): + if value is None: + return None + raise ValueError + if isinstance(value, (int, float, Decimal)): + num = Decimal(str(value)) + else: + text = re.sub(r"[,\s원₩]", "", str(value)) + if text == "": + return None + try: + num = Decimal(text) + except InvalidOperation: + raise ValueError from None + if not num.is_finite(): + raise ValueError + return int(num.quantize(Decimal("1"), rounding=ROUND_HALF_UP)) + + +def header_aliases(markets: Iterable[Mapping[str, Any]], extra_names: Mapping[str, Iterable[str]] | None = None) -> dict[str, str]: + """머리글로 쓸 수 있는 이름 → 쇼핑몰 코드. markets: code·name, extra_names: 코드별 다른 이름(어댑터 이름·짧은 이름).""" + out: dict[str, str] = {} + for m in markets: + code = str(m["code"]) + for alias in (code, m.get("name"), *((extra_names or {}).get(code) or ())): + key = _norm(alias) + if key: + out.setdefault(key, code) + return out + + +def parse_workbook(content: bytes, *, markets: list[Mapping[str, Any]], today: date, + extra_names: Mapping[str, Iterable[str]] | None = None) -> ParseResult: + """첫 시트를 읽어 (코드, 날짜, 금액) 목록을 만든다. markets: code·name·manual_input(설정 순서).""" + if not content: + raise UploadError("빈 파일입니다.") + if len(content) > MAX_FILE_BYTES: + raise UploadError("파일이 너무 큽니다(5MB 이하).") + try: + import openpyxl # noqa: WPS433 + + wb = openpyxl.load_workbook(io.BytesIO(content), read_only=True, data_only=True) + except Exception: # noqa: BLE001 — 형식이 다르면 어떤 오류든 같은 안내 + raise UploadError("엑셀(.xlsx) 파일을 읽을 수 없습니다. 샘플 파일 양식으로 저장해 올려 주세요.") from None + try: + ws = wb.worksheets[0] + rows = ws.iter_rows(values_only=True) + header = next(rows, None) + if not header or len(header) < 2: + raise UploadError("1행에 날짜와 쇼핑몰 이름 머리글이 없습니다.") + + aliases = header_aliases(markets, extra_names) + by_code = {str(m["code"]): m for m in markets} + res = ParseResult() + col_code: dict[int, str] = {} # 열 번호(0부터) → 반영할 쇼핑몰 코드 + for idx, title in enumerate(header[1:], start=1): + if title is None or not str(title).strip(): + continue + label = str(title).strip() + code = aliases.get(_norm(label)) + if code is None: + res.ignored.append(f"{label}(알 수 없는 쇼핑몰)") + elif not by_code[code].get("manual_input"): + res.ignored.append(f"{label}(수동 입력 꺼짐)") + elif code in col_code.values(): + res.errors.append(f"{_cell_ref(1, idx + 1)} {label}: 같은 쇼핑몰 열이 두 번 있습니다.") + else: + col_code[idx] = code + res.columns.append(code) + if not col_code and not res.errors: + raise UploadError("반영할 쇼핑몰 열이 없습니다. 머리글을 수동 입력이 켜진 쇼핑몰 이름으로 적어 주세요." + + (f" (건너뛴 열: {', '.join(res.ignored)})" if res.ignored else "")) + + seen: dict[tuple[str, date], str] = {} + data_rows = 0 + for r, row in enumerate(rows, start=2): + row = tuple(row or ()) + cells = {i: (row[i] if i < len(row) else None) for i in col_code} + amounts: dict[int, int] = {} + for i, raw in cells.items(): + try: + amt = parse_amount(raw) + except ValueError: + res.errors.append(f"{_cell_ref(r, i + 1)}: 금액이 숫자가 아닙니다({raw}).") + continue + if amt is None: + continue + if abs(amt) > MAX_AMOUNT: + res.errors.append(f"{_cell_ref(r, i + 1)}: 금액이 너무 큽니다.") + continue + amounts[i] = amt + raw_day = row[0] if row else None + try: + day = parse_date(raw_day) + except ValueError: + res.errors.append(f"{_cell_ref(r, 1)}: 날짜를 읽을 수 없습니다({raw_day}).") + continue + if day is None: + if amounts: + res.errors.append(f"{r}행: 날짜가 비어 있습니다.") + continue + if not amounts: + continue + data_rows += 1 + if data_rows > MAX_DATA_ROWS: + raise UploadError(f"한 번에 {MAX_DATA_ROWS:,}일까지 올릴 수 있습니다.") + if day > today: + res.errors.append(f"{_cell_ref(r, 1)}: 앞으로의 날짜({day.isoformat()})는 입력할 수 없습니다.") + continue + for i, amt in amounts.items(): + code = col_code[i] + where = _cell_ref(r, i + 1) + if (code, day) in seen: + res.errors.append(f"{where}: {by_code[code]['name']} {day.isoformat()} 이 {seen[(code, day)]} 와 겹칩니다.") + continue + seen[(code, day)] = where + res.entries.append((code, day, amt)) + if len(res.errors) > MAX_ERRORS: + break + return res + finally: + wb.close() diff --git a/app/modules/performance/router.py b/app/modules/performance/router.py index 854a09e..6d566da 100644 --- a/app/modules/performance/router.py +++ b/app/modules/performance/router.py @@ -11,6 +11,8 @@ JSON API — 모듈 권한 POST /performance/api/sync/jobs/{id}/cancel 업데이트 취소(시작한 사람 또는 관리자) GET /performance/api/events 금액 클릭 상세(쇼핑몰+기간) PUT /performance/api/manual-sales/{code}/{day} 수동 입력 매출 저장/지움(그 쇼핑몰 수동 입력이 켜져 있을 때, 오늘까지) + GET /performance/api/manual-sales/sample.xlsx 수동 입력 엑셀 업로드 샘플(모듈 폴더 upload_sample.xlsx) + POST /performance/api/manual-sales/upload 수동 입력 엑셀 업로드(1열 날짜, 2열부터 쇼핑몰 이름 머리글) JSON API — 관리자 PUT /performance/api/marketplaces/{code} 사용/매출 집계/수동 입력 여부 POST /performance/api/marketplaces/{code}/rates 수수료율(적용 시작일) @@ -29,10 +31,11 @@ from __future__ import annotations from datetime import date from decimal import Decimal, InvalidOperation +from pathlib import Path from typing import Any -from fastapi import APIRouter, Body, HTTPException, Query, Request -from fastapi.responses import HTMLResponse, JSONResponse +from fastapi import APIRouter, Body, File, HTTPException, Query, Request, UploadFile +from fastapi.responses import FileResponse, HTMLResponse, JSONResponse from app.timezone import today_kst @@ -46,6 +49,7 @@ MAX_CHECK_DAYS = 62 # 쇼핑몰 화면 일별 비교(카페24 일별 매출내 MAX_BACKFILL_DAYS = 366 MAX_USER_SYNC_DAYS = 92 # 관리자가 아니어도 가져올 수 있는 기간(이번달·직접선택 짧은 기간) MAX_MANUAL_AMOUNT = 10 ** 12 # 수동 입력 한 칸 상한(원) +MANUAL_SAMPLE_PATH = Path(__file__).resolve().parent / "upload_sample.xlsx" MANUAL_MIGRATION_HELP = ("수동 입력을 쓰려면 performance_db 마이그레이션 002(scripts/sql/performance_db_002_manual_sales.sql)를 " "먼저 적용해야 합니다.") @@ -307,6 +311,53 @@ def api_manual_sale(request: Request, code: str, day: str, payload: dict[str, An "amount": api_amount if amount is None else amount, "api_amount": api_amount}) +@router.get("/api/manual-sales/sample.xlsx") +def api_manual_sample(request: Request) -> Any: + common.require_store(request) + if not MANUAL_SAMPLE_PATH.is_file(): + raise HTTPException(status_code=404, detail="샘플 파일이 없습니다.") + return FileResponse(MANUAL_SAMPLE_PATH, filename="upload_sample.xlsx", + media_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet") + + +@router.post("/api/manual-sales/upload") +def api_manual_upload(request: Request, file: UploadFile = File(...)) -> JSONResponse: + """수동 입력 엑셀 업로드 — 값이 있는 칸만 반영(덮어씀). 잘못된 칸이 있으면 아무것도 저장하지 않는다.""" + from . import manual_upload # noqa: WPS433 + from .dashboard import _short_name # noqa: WPS433 + from .db import ManualMigrationNeeded # noqa: WPS433 + + store, user = common.require_store(request) # 날짜 칸 수동 입력과 같은 권한(모듈 권한자 누구나) + content = file.file.read(manual_upload.MAX_FILE_BYTES + 1) + known = {a.code: a for a in all_adapters()} + markets = [m for m in store.list_marketplaces() if m["code"] in known and m["enabled"]] + extra = {m["code"]: (known[m["code"]].name, _short_name(m["name"])) for m in markets} + try: + res = manual_upload.parse_workbook(content, markets=markets, today=today_kst(), extra_names=extra) + except manual_upload.UploadError as exc: + raise HTTPException(status_code=400, detail=str(exc)) from None + names = {m["code"]: m["name"] for m in markets} + if res.errors: + return JSONResponse(status_code=400, content={ + "detail": f"잘못된 칸이 {len(res.errors)}개{'+' if len(res.errors) > manual_upload.MAX_ERRORS else ''} 있어 " + "아무것도 저장하지 않았습니다. 고친 뒤 다시 올려 주세요.", + "errors": res.errors[:manual_upload.MAX_ERRORS], "ignored": res.ignored}) + try: + saved = store.set_manual_sales_bulk(res.entries, user=user.get("email", "")) + except ManualMigrationNeeded: + raise HTTPException(status_code=503, detail=MANUAL_MIGRATION_HELP) from None + counts: dict[str, int] = {} + for code, _, _ in res.entries: + counts[code] = counts.get(code, 0) + 1 + days = sorted({d for _, d, _ in res.entries}) + return JSONResponse({ + "ok": True, "saved": saved, + "by_shop": [{"code": c, "name": names.get(c, c), "count": counts[c]} for c in res.columns if counts.get(c)], + "from": days[0].isoformat() if days else None, "to": days[-1].isoformat() if days else None, + "ignored": res.ignored, + }) + + # ════════════════════════════════════════════════════════════ # JSON API — 설정(수수료율은 모듈 권한자 누구나, 나머지는 관리자) # ════════════════════════════════════════════════════════════ diff --git a/app/modules/performance/templates/performance/index.html b/app/modules/performance/templates/performance/index.html index 996044e..bf49be2 100644 --- a/app/modules/performance/templates/performance/index.html +++ b/app/modules/performance/templates/performance/index.html @@ -1,6 +1,6 @@ {% extends "erp_base.html" %} -{% block head_extra %}{% endblock %} +{% block head_extra %}{% endblock %} {%- macro won(v) -%} {%- if v is none -%} @@ -107,6 +107,10 @@

{% if period_kind == 'year' %}월별 × 쇼핑몰{% else %}일자별 × 쇼핑몰{% endif %}

+ {% if manual_upload_names %} + + {% endif %}
@@ -246,8 +250,9 @@ "period_kind": period_kind, "period_start": period.start.isoformat(), "period_end": period.end.isoformat(), - "today": today + "today": today, + "manual_upload_names": manual_upload_names } | 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 6cdf222..a69254b 100644 --- a/app/modules/performance/templates/performance/settings.html +++ b/app/modules/performance/templates/performance/settings.html @@ -1,6 +1,6 @@ {% extends "erp_base.html" %} -{% block head_extra %}{% endblock %} +{% block head_extra %}{% endblock %} {%- macro when(v) -%}{{ (v or '')[:16] | replace('T', ' ') or '—' }}{%- endmacro -%} @@ -204,4 +204,4 @@ {% endblock %} -{% block scripts %}{% endblock %} +{% block scripts %}{% endblock %} diff --git a/app/modules/performance/tests/test_manual_upload.py b/app/modules/performance/tests/test_manual_upload.py new file mode 100644 index 0000000..192745a --- /dev/null +++ b/app/modules/performance/tests/test_manual_upload.py @@ -0,0 +1,143 @@ +"""수동 입력 엑셀 업로드 — 머리글 매칭·값 있는 칸만·오류 시 전부 거절.""" + +from __future__ import annotations + +import io +from datetime import date, datetime +from pathlib import Path + +import openpyxl +import pytest + +from app.modules.performance import manual_upload as mu + +TODAY = date(2026, 10, 13) +MARKETS = [ + {"code": "naver", "name": "네이버", "manual_input": False}, + {"code": "coupang_rocket", "name": "쿠팡(로켓)", "manual_input": True}, + {"code": "ohouse", "name": "오늘의집", "manual_input": True}, + {"code": "toss", "name": "토스쇼핑", "manual_input": True}, + {"code": "atomy", "name": "애터미아자몰", "manual_input": True}, +] +EXTRA = {"toss": ("토스쇼핑", "토스")} + + +def _xlsx(rows): + wb = openpyxl.Workbook() + ws = wb.active + for r in rows: + ws.append(list(r)) + buf = io.BytesIO() + wb.save(buf) + return buf.getvalue() + + +def _parse(rows): + return mu.parse_workbook(_xlsx(rows), markets=MARKETS, today=TODAY, extra_names=EXTRA) + + +def test_only_filled_cells_of_manual_shops(): + res = _parse([ + ("날짜", "쿠팡(로켓)", " 오늘의 집 ", "네이버", "모르는몰", "토스", "애터미아자몰"), + (datetime(2026, 10, 12), 1_000, None, 999, 5, "12,300원", ""), + ("2026.10.13(화)", None, 0, None, None, None, 4500.4), + (None, None, None, None, None, None, None), # 빈 줄 + ]) + assert not res.errors + assert res.columns == ["coupang_rocket", "ohouse", "toss", "atomy"] + assert sorted(res.entries) == sorted([ + ("coupang_rocket", date(2026, 10, 12), 1000), ("toss", date(2026, 10, 12), 12300), + ("ohouse", date(2026, 10, 13), 0), ("atomy", date(2026, 10, 13), 4500)]) + assert res.ignored == ["네이버(수동 입력 꺼짐)", "모르는몰(알 수 없는 쇼핑몰)"] + + +@pytest.mark.parametrize("raw, expect", [ + ("2026-10-01", date(2026, 10, 1)), ("2026/10/1", date(2026, 10, 1)), ("20261001", date(2026, 10, 1)), + (20261001, date(2026, 10, 1)), (46296, date(2026, 10, 1)), ("2026년 10월 1일", date(2026, 10, 1)), (None, None), +]) +def test_parse_date(raw, expect): + assert mu.parse_date(raw) == expect + + +def test_errors_reject_everything_with_cell_refs(): + res = _parse([ + ("날짜", "쿠팡(로켓)", "오늘의집"), + ("2026-10-10", "abc", 100), + ("엉터리", 1, None), + ("2026-10-14", 1, None), # 앞으로의 날짜 + (None, 5, None), # 날짜 없음 + ("2026-10-11", 7, None), + ("2026-10-11", 8, None), # 같은 날 두 번 + ]) + joined = "\n".join(res.errors) + assert "B2" in joined and "A3" in joined and "A4" in joined and "5행" in joined and "B7" in joined + assert len(res.errors) == 5 + + +def test_header_problems(): + with pytest.raises(mu.UploadError): + _parse([("날짜", "네이버", "모르는몰"), ("2026-10-10", 1, 2)]) # 반영할 열 없음 + with pytest.raises(mu.UploadError): + mu.parse_workbook(b"not an xlsx", markets=MARKETS, today=TODAY) + res = _parse([("날짜", "쿠팡(로켓)", "coupang_rocket"), ("2026-10-10", 1, 2)]) + assert any("두 번" in e for e in res.errors) + + +def test_sample_file_headers_match_marketplaces(): + """모듈 폴더 샘플 파일 머리글 = 수동 입력 쇼핑몰 이름(시드 기준) — 업로드하면 전부 반영 대상이어야 한다.""" + sample = Path(mu.__file__).resolve().parent / "upload_sample.xlsx" + seed = [{"code": c, "name": n, "manual_input": True} for c, n in ( + ("coupang_rocket", "쿠팡(로켓)"), ("ohouse", "오늘의집"), ("gmarket", "G마켓"), ("kakao", "카카오"), + ("gsshop", "GS샵"), ("lotteon", "롯데ON"), ("atomy", "애터미아자몰"))] + wb = openpyxl.load_workbook(sample) + ws = wb.active + ws.append([date(2026, 10, 1)] + [1] * 7) + buf = io.BytesIO() + wb.save(buf) + res = mu.parse_workbook(buf.getvalue(), markets=seed, today=TODAY) + assert not res.errors and not res.ignored and len(res.entries) == 7 + + +def test_upload_endpoint_saves_or_rejects(monkeypatch): + """라우터: 정상 파일은 한 번에 저장, 잘못된 칸이 있으면 400 + 칸 목록, 아무것도 저장 안 함. 샘플 받기.""" + from fastapi import FastAPI + from fastapi.testclient import TestClient + + import importlib + + from app.modules.performance import common + + perf_router = importlib.import_module("app.modules.performance.router") # 패키지 속성 router 는 APIRouter + + class Store: + saved: list = [] + + def list_marketplaces(self): + return [{**m, "enabled": True} for m in MARKETS] + + def set_manual_sales_bulk(self, entries, *, user=""): + self.saved.extend(entries) + 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) + + ok = _xlsx([("날짜", "쿠팡(로켓)", "토스"), ("2026-10-12", 1000, None), ("2026-10-13", None, 2000)]) + r = client.post("/performance/api/manual-sales/upload", files={"file": ("a.xlsx", ok)}) + assert r.status_code == 200, r.text + body = r.json() + assert body["saved"] == 2 and body["from"] == "2026-10-12" and body["to"] == "2026-10-13" + assert [s["code"] for s in body["by_shop"]] == ["coupang_rocket", "toss"] + assert sorted(store.saved) == [("coupang_rocket", date(2026, 10, 12), 1000), ("toss", date(2026, 10, 13), 2000)] + + store.saved.clear() + bad = _xlsx([("날짜", "쿠팡(로켓)"), ("2026-10-12", 1000), ("2026-10-13", "x")]) + r = client.post("/performance/api/manual-sales/upload", files={"file": ("b.xlsx", bad)}) + assert r.status_code == 400 and r.json()["errors"] and store.saved == [] + + r = client.get("/performance/api/manual-sales/sample.xlsx") + assert r.status_code == 200 and r.content[:2] == b"PK" diff --git a/app/modules/performance/upload_sample.xlsx b/app/modules/performance/upload_sample.xlsx new file mode 100644 index 0000000000000000000000000000000000000000..159851aa8f0d37a6b1c396efd99a05ed3af4356a GIT binary patch literal 9272 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 N1tQ2im;SeZ{|8#HIp_cY literal 0 HcmV?d00001 diff --git a/app/static/performance.css b/app/static/performance.css index 14bc78f..0585b98 100644 --- a/app/static/performance.css +++ b/app/static/performance.css @@ -75,6 +75,12 @@ a.perf-seg.is-active, a.perf-seg.is-active:link, a.perf-seg.is-active:visited { .perf-notice[hidden] { display: none; } .perf-notice.is-warn { background: #fff7f5; border-color: #f3d2ca; } .perf-notice.is-ok { background: #f3fbf5; border-color: #cdeccf; } +/* 수동 입력 엑셀 업로드 — 버튼은 표시 기준 버튼 바로 왼쪽, 창 안 파일 칸·오류 목록 */ +.perf-manual-upload-btn { margin-left: auto; } +.perf-upload-file { width: 100%; box-sizing: border-box; } +.perf-upload-result { margin-top: 10px; } +.perf-upload-result .perf-notice { margin: 0; display: block; line-height: 1.6; } +.perf-upload-errors { margin: 6px 0 0; padding-left: 18px; max-height: 220px; overflow-y: auto; font-size: 12px; line-height: 1.6; color: #b42318; } .perf-problem { padding: 1px 8px; border-radius: 999px; background: #fbe9e6; color: var(--perf-down); font-weight: 500; } /* KPI */ diff --git a/app/static/performance.js b/app/static/performance.js index 5da5bde..7b70a73 100644 --- a/app/static/performance.js +++ b/app/static/performance.js @@ -253,6 +253,64 @@ b.addEventListener("click", function () { setMetric(b.dataset.metric); }); }); + // 수동 입력 엑셀 업로드 — 1열 날짜, 2열부터 쇼핑몰 이름 머리글. 값이 있는 칸만 반영(빈 칸은 기존 값 그대로). + // 잘못된 칸이 있으면 서버가 아무것도 저장하지 않고 칸 위치 목록을 돌려준다. + const uploadBtn = document.getElementById("perf-manual-upload"); + if (uploadBtn) uploadBtn.addEventListener("click", function () { + let saved = false; + const m = openModal("수동 입력 엑셀 업로드", { narrow: true, onClose: function () { if (saved) location.reload(); } }); + const shops = (data.manual_upload_names || []).map(esc).join(", "); + m.body.innerHTML = + '

1열에 날짜, 2열부터 쇼핑몰 이름을 머리글로 적고 그날 총매출을 넣습니다. ' + + "값이 있는 칸만 반영되고(같은 날 값은 덮어씀) 빈 칸은 기존 값 그대로입니다.

" + + '

입력 가능한 쇼핑몰: ' + (shops || "없음") + "

" + + '

' + + "샘플 파일 받기

" + + '' + + '
'; + const fileInput = m.body.querySelector(".perf-upload-file"); + const out = m.body.querySelector(".perf-upload-result"); + const go = el("button", { type: "button", class: "erp-btn erp-btn-primary" }, "업로드"); + const cancel = el("button", { type: "button", class: "erp-btn erp-btn-ghost" }, "닫기"); + m.foot.appendChild(cancel); + 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; } + go.disabled = true; + out.innerHTML = '

올리는 중…

'; + const fd = new FormData(); + fd.append("file", f); + let res, body = null; + try { + res = await fetch("/performance/api/manual-sales/upload", { method: "POST", credentials: "same-origin", body: fd }); + try { body = await res.json(); } catch (_) { body = null; } + } catch (err) { + out.innerHTML = '

업로드 실패: ' + esc(err.message) + "

"; + go.disabled = false; + return; + } + go.disabled = false; + const ignored = body && body.ignored && body.ignored.length + ? '

건너뛴 열: ' + esc(body.ignored.join(", ")) + "

" : ""; + if (!res.ok) { + const detail = body && typeof body.detail === "string" ? body.detail : "업로드 실패 (" + res.status + ")"; + const errs = body && body.errors && body.errors.length + ? '
    ' + body.errors.map(function (e) { return "
  • " + esc(e) + "
  • "; }).join("") + "
" : ""; + out.innerHTML = '

' + esc(detail) + "

" + errs + ignored; + return; + } + saved = body.saved > 0; + out.innerHTML = '

' + (saved + ? fmt(body.saved) + "칸 반영 (" + esc(body.from === body.to ? body.from : body.from + " ~ " + body.to) + ")
" + + esc(body.by_shop.map(function (s) { return s.name + " " + fmt(s.count) + "일"; }).join(" · ")) + : "반영할 값이 없습니다(값이 있는 칸이 없음).") + "

" + ignored + + (saved ? '

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

' : ""); + fileInput.value = ""; + }); + }); + // 직접선택 / 쇼핑몰 필터 const customBtn = document.getElementById("perf-custom-btn"); const customForm = document.getElementById("perf-custom"); diff --git a/docs/PERFORMANCE_MODULE.md b/docs/PERFORMANCE_MODULE.md index 73f5602..6ad23e6 100644 --- a/docs/PERFORMANCE_MODULE.md +++ b/docs/PERFORMANCE_MODULE.md @@ -215,6 +215,12 @@ - **수동 입력 전용 쇼핑몰**(003, `adapters/manual.py` — `manual_only = True`): `쿠팡(로켓)`(`coupang_rocket`)·`애터미아자몰`(`atomy`). API 가 없어 매출 업데이트(`sync_all`)에서 빠지고, 설정 화면에 인증 설정·연결 테스트 버튼이 없으며 연결 상태는 "수동 입력". 수동 입력 토글은 늘 켜짐(화면 disabled, API 로 끄면 400). 매출은 일자별 표 날짜 칸에 직접 입력. +- **수동 입력 엑셀 업로드**(`manual_upload.py`, 일자별 표 머리 [엑셀 업로드] → 팝업): 샘플 `GET /api/manual-sales/sample.xlsx` + (모듈 폴더 `upload_sample.xlsx`), 업로드 `POST /api/manual-sales/upload`(모듈 권한자 누구나 — 날짜 칸 입력과 같은 권한). + 양식: 첫 시트 1행 머리글, 1열 날짜(엑셀 날짜·2026-10-12·2026.10.12·20261012), 2열부터 쇼핑몰 이름(설정 이름·짧은 이름·코드, + 띄어쓰기·대소문자 무시). 수동 입력이 켜진 쇼핑몰 열만, **값이 있는 칸만** 반영(같은 날 값 덮어씀, 빈 칸은 기존 값 그대로, 0 은 0원). + 꺼진 쇼핑몰·모르는 이름 열은 건너뛰고 알려 줌. 숫자 아님·날짜 못 읽음·앞으로의 날짜·같은 쇼핑몰+날짜 두 번이면 + **아무것도 저장하지 않고** 칸 위치(B3 등) 목록을 돌려준다. 저장은 한 트랜잭션(`set_manual_sales_bulk`). 5MB·2,000일 상한. - 표 열 제목은 가운데·굵게·검정(`.perf-table thead th`). ### 연동 단계 체크리스트(쇼핑몰마다)