From e1006c63de3b56f698138cf3674f5fbdde726c48 Mon Sep 17 00:00:00 2001 From: king Date: Thu, 1 Oct 2026 21:14:10 +0900 Subject: [PATCH] =?UTF-8?q?fix(project):=20=EB=AA=A9=ED=91=9C=C2=B7?= =?UTF-8?q?=EC=A3=BC=EA=B0=84=20=ED=9A=8C=EC=9D=98=EB=A1=9D=20=EC=A0=80?= =?UTF-8?q?=EC=9E=A5=20=EC=86=90=EC=8B=A4=C2=B7=EC=A7=80=EB=82=9C=EC=A3=BC?= =?UTF-8?q?=20=EC=97=B0=EA=B2=B0=C2=B7=EC=8B=A4=EC=A0=81=20=EB=AF=B8?= =?UTF-8?q?=ED=99=95=EC=9D=B8=20=EC=88=98=EC=A0=95=20(=EC=A0=90=EA=B2=80?= =?UTF-8?q?=209=EA=B1=B4)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 칸별 자동 저장 createFieldSaver: 같은 칸 요청 직렬화, 보낸 값만 saved, 늦은 응답이 새 초안을 덮지 않음, 실패 시 초안·dirty 유지(빨간 테두리), localStorage 초안 백업·되살리기, 페이지 떠남 keepalive + 이탈 경고 - 목표 표: 저장 실패면 영역·줄·병합 작업과 표 교체 중단, 받는 사이 입력 보호 - 회의록: 금주 목표 저장 뒤 새로고침 대신 숫자 칸만 다시(차례 번호로 옛 응답 버림), 이번주 실적 %는 서버 확정 목표로 즉시 재계산 - 지난주 = 정확히 7일 전 주의 같은 연결키 줄(line_key, 마이그레이션 018), 역순 생성·이름 변경·삭제 후 재생성에도 연결, 이름 추정 연결 없음 - 실적 조회 장애를 0원 대신 미확인으로(목록·매출·부분 실패 구분) - 구역·항목 ⋮ 메뉴 버튼(키보드·터치), 메뉴 키보드 탐색·포커스 복귀 - 매출 갱신 실패·일부 실패 안내 + 재시도, 서버 기록 갱신 시각, 권한 없으면 호출 안 함 - 테스트: Python 통합(역순 생성·실적 장애), 018 백필, jsdom UI 106건 Co-Authored-By: Claude Opus 5.5 --- CLAUDE.md | 2 +- app/modules/project/db.py | 137 ++- app/modules/project/router.py | 190 +++- .../templates/project/goal_meeting.html | 52 +- .../project/templates/project/goals.html | 16 +- .../project/templates/project/help.html | 16 +- .../project/templates/project/inbox.html | 4 +- .../project/templates/project/mytasks.html | 4 +- .../project/templates/project/project.html | 4 +- .../project/templates/project/trash.html | 4 +- app/static/project.css | 46 +- app/static/project.js | 872 ++++++++++++------ docs/PROJECT_MODULE.md | 110 ++- .../sql/project_db_018_meeting_line_keys.sql | 87 ++ ...t_db_018b_meeting_line_link_candidates.sql | 45 + tests/js/README.md | 12 + tests/js/goals_meeting_ui.test.js | 664 +++++++++++++ tests/js/render_goals.py | 129 +++ tests/test_meeting_line_keys_migration.py | 132 +++ tests/test_project_module.py | 201 ++++ 20 files changed, 2334 insertions(+), 393 deletions(-) create mode 100644 scripts/sql/project_db_018_meeting_line_keys.sql create mode 100644 scripts/sql/project_db_018b_meeting_line_link_candidates.sql create mode 100644 tests/js/goals_meeting_ui.test.js create mode 100644 tests/js/render_goals.py create mode 100644 tests/test_meeting_line_keys_migration.py diff --git a/CLAUDE.md b/CLAUDE.md index 6438209..2601c23 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -36,7 +36,7 @@ Claude Code는 이 저장소에서 작업을 시작하기 전에 **반드시 아 - 말레이시아 창고 재고관리 (`app/modules/malaysia/`, `malaysia_stock_db`) — 낱개(MT/MX/MZ) 입출고·조정, 세트(MY) BOM, 일일 재고조사(세트→낱개 자동 분해), 현재고 현황. 뚜껑(MD-)은 재고 집계 제외 — 단, 창고 랙에는 위치 확인용으로 배치 가능(`store.LID_ITEMS`). 상품은 `itemcode_db` 읽기 전용. 권한키 `malaysia` - 말레이시아 배송 (`app/modules/dispatch/`, `dispatch_db`) — TikTok·Shopee 출고관리. 플랫폼별 데이터 엑셀 업로드(TikTok=03_TikTok_Order_Export.xlsx, Shopee=Packing List.Doorstep Delivery.xlsx) → 1상자=1카드 출고 작업 리스트·SKU 피킹 요약·Kagayaku 전달표 자동 생성. 1상자 묶음 기준 Package ID > Tracking ID > Order ID, 같은 상자 같은 SKU 합산. 작업 상태 토글(`dispatch_logs` 기록). 받는 사람 이름/전화/주소는 상자 단위로 저장(작업 카드 표시 + 출고 엑셀 생성용 — 개인정보). 배치 다운로드 zip 에 업로드 원본 + 취합 출고 엑셀(`YYYY.MM.DD(Ddd)_tictoc|shopee.xlsx`) 포함. 엑셀은 openpyxl 파싱/생성. 권한키 `dispatch`. 상세는 `docs/DISPATCH_MODULE.md` - 카페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색)·아이콘(`projects.icon`, Material Symbols 42종, 마이그레이션 011)·작업(`tasks`: 담당자·우선순위·시작/마감)·진행단계(`project_stages` 칸반, 생성시 기본 4단계 seed, 섹션 기본 담당자 `default_assignee_email` — 담당자 빈 작업을 그 섹션에 만들거나 옮기면 자동 배정, 마이그레이션 009)·멤버 배정(`project_members`)·활동이력(`project_activity`). 첫 화면(`/project/`)은 **내 작업 목록**(프로젝트 홈 카드 화면은 폐지). 프로젝트 화면은 캘린더(FullCalendar)/타임라인(vis-timeline)/보드/목록/대시보드 뷰 토글. 좌측 사이드바는 수신함·내 작업·휴지통·프로젝트 화면 공용(`templates/project/_side.html` + 프로젝트 목록 동작 `initSideTree`, 새 프로젝트/수정 모달 `_side_modals.html`) — 프로젝트 목록(순서 변경·✎·×)은 어느 화면에서나 같다. 보드는 아사나처럼 섹션이 가로로 계속 늘어나고(넘치면 가로 스크롤) 카드의 담당자·마감일을 클릭해 그 자리에서 바꾼다. 좌측 사이드바에 수신함·내 작업(접이식) 메뉴. 설명란은 주소 붙여넣기 시 자동 링크, 설명란·댓글에서 @로 멤버를 태그하면 (`task_mentions`, 마이그레이션 006) 수신함에 그 작업이 쌓인다. 진입 권한키 `project`(관리자 페이지 토글로 직원별 부여, admin 자동). 프로젝트 생성은 `project` 권한자 누구나(만든 사람이 owner), 삭제는 만든 사람만(슈퍼관리자 예외), 사용자 배정은 `is_admin` 만. 배정 멤버(또는 owner/admin)만 그 프로젝트를 조회(화면·API 모두, 비멤버 403)하고 서브프로젝트/작업/단계 CRUD — URL 의 섹션·부모 작업이 그 프로젝트 것인지 서버가 검증. 실시간 반영은 `project_live_version` 카운터(마이그레이션 007, 미적용 시 MAX 폴백). 사이드바 전체 검색(`/api/search`, 제목·설명·댓글, pg_trgm) + 프로젝트/내 작업 필터 바(찾기·상태·담당자·마감·우선순위·정렬, 클라이언트 필터). 협업자(`task_followers`, 자동 팔로우: 만든 사람·담당자·댓글·@태그) — 완료·댓글 알림은 담당자+협업자에게만. 작업 삭제는 휴지통(`project_trash`, 마이그레이션 010) — 삭제 직전 스냅샷 3개월 보관, 관리자만 보기·복구(`/project/trash`). 권한은 **지금 기준 공통 모듈 `access.py`**(목록·배지·알림·멘션·메일 수신자·삭제·댓글 수정까지 — 멤버에서 빠지면 기록이 있어도 안 보이고 알림도 없음), 소유자 변경은 관리자만, 연결(멀티호밍)된 작업은 연결된 프로젝트 멤버에게 읽기 전용(docs/PROJECT_MODULE.md 6-10). 연간 목표(마이그레이션 013, `goal_*` 테이블) — 사이드바 "목표" → 연도 펼침 → `/project/goals/{연도}` 에 매출(목표·실적·달성)·로아스 월별 숫자 + 업무 영역(상품·마케팅·컨텐츠·유통 등)별 연간·월별 글, 조회는 전원·입력은 `is_admin` 만. 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/{월}`, 주=월~일 탭, 1주차 = 그 달 첫 월요일이 있는 주(월간 목표·누적은 1일~말일), `goal_meetings`·`goal_meeting_items` 마이그레이션 015 — 지난 회의록 줄 이어받기(carry_from)로 지난주 할 일·목표·결과·평가 리뷰, 위에 목표 표 그 달 열 글을 영역별 "N월 계획" 카드로, 숫자는 한 줄 막대 — 월 목표 대비 누적·주당 필요 매출, 유통 줄 쇼핑몰 연결 시 결과를 실적 모듈 `performance_store` 에서 읽기 전용 자동). 모든 열 너비 끌어서 조절(localStorage `pj_goal_col_w`), 세로 스크롤 틀 고정은 머리 줄+매출·로아스 줄까지, 항목 칸 +·우클릭으로 줄 위/아래 추가·삭제. 마감 알림(`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` 비동기). 작업 창은 **저장 버튼 없이 실시간 저장**(칸별 PUT, `saveField`/`saveChain`, 새 작업은 제목이 생기는 순간 생성). 댓글 답글·이모티콘 반응(마이그레이션 012 `task_comments.parent_id`·`task_comment_reactions`, 미적용 시 버튼 숨김·API 503), 완료 이력 줄은 `project_activity` completed 를 댓글 사이에 표시(댓글 수 제외), 댓글 `@아이디` 는 아이콘+이름 칩. 수신함 "확인"은 페이지 이동 없이 오른쪽 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/project/`, `project_db`) — 아사나식. 프로젝트/서브프로젝트(self-FK `parent_id`, CASCADE)·프로젝트 색상(32색 — 아사나 16색 + 진한 16색)·아이콘(`projects.icon`, Material Symbols 42종, 마이그레이션 011)·작업(`tasks`: 담당자·우선순위·시작/마감)·진행단계(`project_stages` 칸반, 생성시 기본 4단계 seed, 섹션 기본 담당자 `default_assignee_email` — 담당자 빈 작업을 그 섹션에 만들거나 옮기면 자동 배정, 마이그레이션 009)·멤버 배정(`project_members`)·활동이력(`project_activity`). 첫 화면(`/project/`)은 **내 작업 목록**(프로젝트 홈 카드 화면은 폐지). 프로젝트 화면은 캘린더(FullCalendar)/타임라인(vis-timeline)/보드/목록/대시보드 뷰 토글. 좌측 사이드바는 수신함·내 작업·휴지통·프로젝트 화면 공용(`templates/project/_side.html` + 프로젝트 목록 동작 `initSideTree`, 새 프로젝트/수정 모달 `_side_modals.html`) — 프로젝트 목록(순서 변경·✎·×)은 어느 화면에서나 같다. 보드는 아사나처럼 섹션이 가로로 계속 늘어나고(넘치면 가로 스크롤) 카드의 담당자·마감일을 클릭해 그 자리에서 바꾼다. 좌측 사이드바에 수신함·내 작업(접이식) 메뉴. 설명란은 주소 붙여넣기 시 자동 링크, 설명란·댓글에서 @로 멤버를 태그하면 (`task_mentions`, 마이그레이션 006) 수신함에 그 작업이 쌓인다. 진입 권한키 `project`(관리자 페이지 토글로 직원별 부여, admin 자동). 프로젝트 생성은 `project` 권한자 누구나(만든 사람이 owner), 삭제는 만든 사람만(슈퍼관리자 예외), 사용자 배정은 `is_admin` 만. 배정 멤버(또는 owner/admin)만 그 프로젝트를 조회(화면·API 모두, 비멤버 403)하고 서브프로젝트/작업/단계 CRUD — URL 의 섹션·부모 작업이 그 프로젝트 것인지 서버가 검증. 실시간 반영은 `project_live_version` 카운터(마이그레이션 007, 미적용 시 MAX 폴백). 사이드바 전체 검색(`/api/search`, 제목·설명·댓글, pg_trgm) + 프로젝트/내 작업 필터 바(찾기·상태·담당자·마감·우선순위·정렬, 클라이언트 필터). 협업자(`task_followers`, 자동 팔로우: 만든 사람·담당자·댓글·@태그) — 완료·댓글 알림은 담당자+협업자에게만. 작업 삭제는 휴지통(`project_trash`, 마이그레이션 010) — 삭제 직전 스냅샷 3개월 보관, 관리자만 보기·복구(`/project/trash`). 권한은 **지금 기준 공통 모듈 `access.py`**(목록·배지·알림·멘션·메일 수신자·삭제·댓글 수정까지 — 멤버에서 빠지면 기록이 있어도 안 보이고 알림도 없음), 소유자 변경은 관리자만, 연결(멀티호밍)된 작업은 연결된 프로젝트 멤버에게 읽기 전용(docs/PROJECT_MODULE.md 6-10). 연간 목표(마이그레이션 013, `goal_*` 테이블) — 사이드바 "목표" → 연도 펼침 → `/project/goals/{연도}` 에 매출(목표·실적·달성)·로아스 월별 숫자 + 업무 영역(상품·마케팅·컨텐츠·유통 등)별 연간·월별 글, 조회는 전원·입력은 `is_admin` 만. 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/{월}`, 주=월~일 탭, 1주차 = 그 달 첫 월요일이 있는 주(월간 목표·누적은 1일~말일), `goal_meetings`·`goal_meeting_items` 마이그레이션 015 — 지난주 = **정확히 7일 전 주** 회의록의 같은 연결키 줄(`line_key`, 마이그레이션 018 — 생성 순서·이름 변경과 무관, 이름 추정 연결 금지)로 지난주 할 일·목표·결과·평가 리뷰, 실적 조회 장애는 0원이 아니라 "미확인", 위에 목표 표 그 달 열 글을 영역별 "N월 계획" 카드로, 숫자는 한 줄 막대 — 월 목표 대비 누적·주당 필요 매출, 유통 줄 쇼핑몰 연결 시 결과를 실적 모듈 `performance_store` 에서 읽기 전용 자동). 모든 열 너비 끌어서 조절(localStorage `pj_goal_col_w`), 세로 스크롤 틀 고정은 머리 줄+매출·로아스 줄까지, 항목 칸 +·우클릭으로 줄 위/아래 추가·삭제. 마감 알림(`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), 구역·항목 메뉴는 우클릭 + ⋮ 버튼(키보드·터치). 작업 창은 **저장 버튼 없이 실시간 저장**(칸별 PUT, `saveField`/`saveChain`, 새 작업은 제목이 생기는 순간 생성). 댓글 답글·이모티콘 반응(마이그레이션 012 `task_comments.parent_id`·`task_comment_reactions`, 미적용 시 버튼 숨김·API 503), 완료 이력 줄은 `project_activity` completed 를 댓글 사이에 표시(댓글 수 제외), 댓글 `@아이디` 는 아이콘+이름 칩. 수신함 "확인"은 페이지 이동 없이 오른쪽 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`)·구조까지, 실제 수집은 쇼핑몰별로 공식 문서 확인 후 순차 구현. 상세는 `docs/PERFORMANCE_MODULE.md` diff --git a/app/modules/project/db.py b/app/modules/project/db.py index adc565c..a44d159 100644 --- a/app/modules/project/db.py +++ b/app/modules/project/db.py @@ -15,7 +15,8 @@ from __future__ import annotations import logging import re import time -from datetime import date, datetime +import uuid +from datetime import date, datetime, timedelta from datetime import time as dtime from typing import Any @@ -2446,6 +2447,19 @@ class ProjectStore: if not self._table_exists(conn, "goal_meetings"): raise store.GoalMigration015Needed() + def _meeting_keys(self, conn: Any) -> bool: + """마이그레이션 018 — goal_meeting_items.line_key(주가 바뀌어도 같은 줄을 가리키는 연결키) 적용 여부. + 적용되면 한 번만 확인한다(되돌리는 마이그레이션은 없다).""" + if getattr(self, "_meeting_keys_ok", False): + return True + ok = self._column_exists(conn, "goal_meeting_items", "line_key") + if ok: + self._meeting_keys_ok = True + return ok + + def _meeting_cols(self, conn: Any) -> str: + return self._MEETING_ITEM_COLS + (", line_key" if self._meeting_keys(conn) else "") + @staticmethod def _meeting_item(r: dict[str, Any]) -> dict[str, Any]: out = dict(r) @@ -2453,6 +2467,8 @@ class ProjectStore: out["week_start"] = out["week_start"].isoformat() for k in ("target_amount", "result_amount", "carry_from"): out[k] = int(out[k]) if out.get(k) is not None else None + if out.get("line_key") is not None: + out["line_key"] = str(out["line_key"]) return out def meeting_weeks(self, *, start: date, end: date) -> list[str]: @@ -2467,32 +2483,44 @@ class ProjectStore: return [r["week_start"].isoformat() for r in rows] def get_meeting(self, *, week_start: date) -> dict[str, Any] | None: - """한 주 회의록 — 머리(금주 목표·참석자·메모) + 줄(전주 줄 prev 포함). 없으면 None. - prev_meeting = 이 회의록보다 앞선 가장 가까운 회의록의 머리(전주 목표).""" + """한 주 회의록 — 머리(금주 목표·참석자·메모) + 줄(지난주 줄 prev 포함). 없으면 None. + + "지난주"는 **정확히 7일 전 주(week_start − 7)** 만이다(몇 주 전 회의록을 지난주로 보이지 않게). + · prev_meeting = 그 주 회의록 머리(전주 목표), 그 주 회의록이 없으면 None. + · 줄의 prev = 그 주 회의록에서 **같은 연결키(line_key, 마이그레이션 018)** 의 줄 — 생성 순서·이름 변경· + 순서 이동과 무관하다. 018 미적용이면 예전 carry_from 을 쓰되 가리키는 줄이 정확히 7일 전 주일 때만. + """ with self._pool.connection() as conn: self._require_meetings(conn) + cols = self._meeting_cols(conn) + keyed = self._meeting_keys(conn) head = conn.execute( "SELECT week_start, week_target, attendees, notes, updated_by, updated_at " "FROM goal_meetings WHERE week_start = %s", (week_start,), ).fetchone() if head is None: return None + prev_week = week_start - timedelta(days=7) items = conn.execute( - f"SELECT {self._MEETING_ITEM_COLS} FROM goal_meeting_items WHERE week_start = %s " + f"SELECT {cols} FROM goal_meeting_items WHERE week_start = %s " "ORDER BY sort_order, id", (week_start,), ).fetchall() - prev_ids = [int(r["carry_from"]) for r in items if r["carry_from"] is not None] - prevs = {int(r["id"]): self._meeting_item(r) for r in conn.execute( - f"SELECT {self._MEETING_ITEM_COLS} FROM goal_meeting_items WHERE id = ANY(%s)", (prev_ids,), - ).fetchall()} if prev_ids else {} prev_head = conn.execute( - "SELECT week_start, week_target FROM goal_meetings WHERE week_start < %s " - "ORDER BY week_start DESC LIMIT 1", (week_start,), + "SELECT week_start, week_target FROM goal_meetings WHERE week_start = %s", (prev_week,), ).fetchone() + prev_rows = conn.execute( + f"SELECT {cols} FROM goal_meeting_items WHERE week_start = %s", (prev_week,), + ).fetchall() if prev_head else [] + by_key = {str(r["line_key"]): r for r in prev_rows if r.get("line_key") is not None} if keyed else {} + by_id = {int(r["id"]): r for r in prev_rows} out_items = [] for r in items: it = self._meeting_item(r) - it["prev"] = prevs.get(it["carry_from"]) if it["carry_from"] is not None else None + if keyed: + p = by_key.get(it.get("line_key") or "") + else: + p = by_id.get(it["carry_from"]) if it["carry_from"] is not None else None + it["prev"] = self._meeting_item(p) if p is not None else None out_items.append(it) return { "week_start": head["week_start"].isoformat(), @@ -2503,17 +2531,22 @@ class ProjectStore: "prev_meeting": {"week_start": prev_head["week_start"].isoformat(), "week_target": int(prev_head["week_target"]) if prev_head["week_target"] is not None else None} if prev_head else None, + "line_keys": keyed, } def create_meeting(self, *, week_start: date, sections: list[tuple[str, str]], created_by: str = "") -> bool: - """회의록 만들기 — 이미 있으면 False. 앞선 가장 가까운 회의록이 있으면 그 줄(구역·이름·쇼핑몰 연결·순서)을 - 글 없이 이어받고(carry_from = 그 줄 → 이번 회의에서 지난주 할 일·목표·결과를 나란히 리뷰), 없으면 sections - (목표 표 업무 영역 이름·색)마다 기본 양식 줄(store.MEETING_TEMPLATE)로 시작한다.""" + """회의록 만들기 — 이미 있으면 False. 줄(구역·이름·색·쇼핑몰 연결·순서)을 글 없이 이어받을 원본: + ① 앞선 가장 가까운 회의록(평소 순서), ② 앞선 회의록이 없으면 뒤에 있는 가장 가까운 회의록 + (다음 주를 먼저 만들고 앞 주를 나중에 만든 경우 — 다음 주 줄이 이 주 줄을 "지난주"로 찾게), + ③ 둘 다 없으면 sections(목표 표 업무 영역 이름·색)마다 기본 양식 줄(store.MEETING_TEMPLATE). + 이어받은 줄은 원본 줄의 연결키(line_key, 018)를 그대로 갖는다 → 생성 순서와 무관하게 7일 전 주의 같은 키 줄이 + "지난주"가 된다. 새 줄(양식·줄 추가)은 새 키. carry_from 은 앞선 원본 줄일 때만 기록(이력, 화면 연결에는 안 씀).""" ws = store.validate_week_start(week_start) who = store.norm_str(created_by, lower=True) with self._pool.connection() as conn: with conn.transaction(): self._require_meetings(conn) + keyed = self._meeting_keys(conn) ins = conn.execute( "INSERT INTO goal_meetings (week_start, created_by, updated_by) VALUES (%s, %s, %s) " "ON CONFLICT (week_start) DO NOTHING RETURNING week_start", @@ -2521,30 +2554,59 @@ class ProjectStore: ).fetchone() if ins is None: return False - prev = conn.execute( - "SELECT week_start FROM goal_meetings WHERE week_start < %s ORDER BY week_start DESC LIMIT 1", - (ws,), - ).fetchone() - prev_items = conn.execute( - "SELECT id, section, section_color, label, marketplace_code, sort_order FROM goal_meeting_items " - "WHERE week_start = %s ORDER BY sort_order, id", (prev["week_start"],), - ).fetchall() if prev else [] - if prev_items: - for n, r in enumerate(prev_items): - conn.execute( - "INSERT INTO goal_meeting_items (week_start, section, section_color, label, " - "marketplace_code, carry_from, sort_order, updated_by) VALUES (%s,%s,%s,%s,%s,%s,%s,%s)", - (ws, r["section"], r["section_color"], r["label"], r["marketplace_code"], r["id"], n, who), - ) + src_cols = "id, section, section_color, label, marketplace_code, sort_order" + (", line_key" if keyed else "") + src_items: list[dict[str, Any]] = [] + src_is_prev = True + for cmp_, order, is_prev in (("<", "DESC", True), (">", "ASC", False)): + # 줄이 하나라도 있는 가장 가까운 회의록(빈 회의록은 건너뜀) + src = conn.execute( + f"SELECT m.week_start FROM goal_meetings m WHERE m.week_start {cmp_} %s " + "AND EXISTS (SELECT 1 FROM goal_meeting_items i WHERE i.week_start = m.week_start) " + f"ORDER BY m.week_start {order} LIMIT 1", + (ws,), + ).fetchone() + if src: + src_items = conn.execute( + f"SELECT {src_cols} FROM goal_meeting_items WHERE week_start = %s ORDER BY sort_order, id", + (src["week_start"],), + ).fetchall() + src_is_prev = is_prev + break + if src_items: + for n, r in enumerate(src_items): + key = str(r["line_key"]) if keyed and r.get("line_key") is not None else str(uuid.uuid4()) + carry = r["id"] if src_is_prev else None + if keyed: + conn.execute( + "INSERT INTO goal_meeting_items (week_start, section, section_color, label, " + "marketplace_code, carry_from, sort_order, updated_by, line_key) " + "VALUES (%s,%s,%s,%s,%s,%s,%s,%s,%s)", + (ws, r["section"], r["section_color"], r["label"], r["marketplace_code"], carry, n, + who, key), + ) + else: + conn.execute( + "INSERT INTO goal_meeting_items (week_start, section, section_color, label, " + "marketplace_code, carry_from, sort_order, updated_by) VALUES (%s,%s,%s,%s,%s,%s,%s,%s)", + (ws, r["section"], r["section_color"], r["label"], r["marketplace_code"], carry, n, who), + ) else: n = 0 for name, color in sections or [(k, "") for k in store.MEETING_TEMPLATE]: for label in store.MEETING_TEMPLATE.get(name, ("",)): - conn.execute( - "INSERT INTO goal_meeting_items (week_start, section, section_color, label, " - "marketplace_code, sort_order, updated_by) VALUES (%s,%s,%s,%s,%s,%s,%s)", - (ws, name, color, label, store.guess_meeting_market(name, label), n, who), - ) + if keyed: + conn.execute( + "INSERT INTO goal_meeting_items (week_start, section, section_color, label, " + "marketplace_code, sort_order, updated_by, line_key) VALUES (%s,%s,%s,%s,%s,%s,%s,%s)", + (ws, name, color, label, store.guess_meeting_market(name, label), n, who, + str(uuid.uuid4())), + ) + else: + conn.execute( + "INSERT INTO goal_meeting_items (week_start, section, section_color, label, " + "marketplace_code, sort_order, updated_by) VALUES (%s,%s,%s,%s,%s,%s,%s)", + (ws, name, color, label, store.guess_meeting_market(name, label), n, who), + ) n += 1 return True @@ -2617,11 +2679,14 @@ class ProjectStore: else: same = [n for n, r in enumerate(rows) if r["section"] == sec] i = same[-1] + 1 if same else len(ids) + # 새 줄 = 새 연결키(018) — 이름이 같은 다른 줄과 섞이지 않는다 + keyed = self._meeting_keys(conn) new_id = int(conn.execute( "INSERT INTO goal_meeting_items (week_start, section, section_color, label, marketplace_code, " - "sort_order, updated_by) VALUES (%s,%s,%s,%s,%s,0,%s) RETURNING id", + "sort_order, updated_by" + (", line_key" if keyed else "") + ") VALUES (%s,%s,%s,%s,%s,0,%s" + + (",%s" if keyed else "") + ") RETURNING id", (week_start, sec, color, lb, store.guess_meeting_market(sec, lb), - store.norm_str(updated_by, lower=True)), + store.norm_str(updated_by, lower=True), *((str(uuid.uuid4()),) if keyed else ())), ).fetchone()["id"]) ids.insert(i, new_id) for n, x in enumerate(ids): diff --git a/app/modules/project/router.py b/app/modules/project/router.py index 9b037ce..76eb1e4 100644 --- a/app/modules/project/router.py +++ b/app/modules/project/router.py @@ -2838,78 +2838,157 @@ def _perf_sales(request: Request) -> Any: return getattr(request.app.state, "performance_store", None) -def _perf_markets(perf: Any) -> list[dict[str, Any]]: - if perf is None: - return [] - try: - return [m for m in perf.list_marketplaces() if m.get("enabled")] - except Exception: # noqa: BLE001 — 실적 DB 장애가 회의록을 막지 않게 - logger.warning("performance marketplaces unavailable for meeting", exc_info=True) - return [] +class _MeetingPerf: + """회의록이 읽는 실적(읽기 전용) — 값과 상태를 따로 둔다. 조회 장애를 0 원으로 바꾸지 않는다. + + state: ``off``(실적 모듈 미연결) · ``error``(쇼핑몰 목록 조회 실패) · ``empty``(매출 집계 쇼핑몰 없음) · ``ok``. + ``sum``/``total`` 은 알 수 없으면 None(목록 장애·매출 조회 실패), 정상 조회 결과 0 건이면 0. + 매출 조회가 실패할 때마다 ``failures`` 가 늘어난다(부분 실패 — 머리 숫자마다 따로 미확인).""" + + def __init__(self, perf: Any) -> None: + self.perf = perf + self.markets: list[dict[str, Any]] = [] + self.failures = 0 + if perf is None: + self.state = "off" + else: + try: + self.markets = [m for m in perf.list_marketplaces() if m.get("enabled")] + self.state = "ok" + except Exception: # noqa: BLE001 — 실적 DB 장애가 회의록을 막지 않게 + logger.warning("performance marketplaces unavailable for meeting", exc_info=True) + self.state = "error" + self.names = {m["code"]: m["name"] for m in self.markets} + self.sales_codes = [m["code"] for m in self.markets if m.get("include_in_sales")] + if self.state == "ok" and not self.sales_codes: + self.state = "empty" + + @property + def readable(self) -> bool: + """쇼핑몰 목록을 읽었는가(ok·empty) — 연결 쇼핑몰이 "사용 중이 아님"을 판단할 수 있는가.""" + return self.state in ("ok", "empty") + + def sum(self, start: date, end: date, codes: list[str]) -> dict[str, int] | None: + """기간 쇼핑몰별 매출 합(원, 취소·반품 차감 = 대시보드 총매출과 같은 값). 알 수 없으면 None.""" + if not self.readable: + return None + if not codes or end < start: + return {} + try: + out: dict[str, int] = {} + for (_, code), amount in self.perf.daily_amounts(start, end, codes).items(): + out[code] = out.get(code, 0) + int(amount) + return out + except Exception: # noqa: BLE001 + self.failures += 1 + logger.warning("performance sales unavailable for meeting", exc_info=True) + return None + + def total(self, start: date, end: date) -> int | None: + """매출 집계 쇼핑몰 합계. 매출 집계 쇼핑몰이 없으면(empty) None — 0 원으로 보이지 않게.""" + if self.state != "ok": + return None + r = self.sum(start, end, self.sales_codes) + return None if r is None else sum(r.values()) + + def freshness(self) -> dict[str, Any] | None: + """매출 집계 쇼핑몰별 마지막 갱신 성공 시각(실적 모듈 perf_connection_status — 서버가 기록한 값만). + oldest = 가장 오래된 쇼핑몰 기준(자료가 적어도 이 시각까지는 갱신됨), never = 한 번도 성공 못 한 쇼핑몰.""" + if self.state != "ok" or not hasattr(self.perf, "statuses"): + return None + try: + stats = self.perf.statuses() or {} + except Exception: # noqa: BLE001 + logger.warning("performance statuses unavailable for meeting", exc_info=True) + return None + shops, never = [], [] + for code in self.sales_codes: + t = (stats.get(code) or {}).get("last_success_sync_at") + if t: + shops.append({"name": self.names.get(code, code), "at": str(t)}) + else: + never.append(self.names.get(code, code)) + oldest = min((s["at"] for s in shops), default="") + return {"shops": shops, "never": never, "oldest": oldest} -def _perf_sum(perf: Any, start: date, end: date, codes: list[str]) -> dict[str, int] | None: - """기간 쇼핑몰별 매출 합(원, 취소·반품 차감 = 대시보드 총매출과 같은 값). 실적 모듈이 없으면 None.""" - if perf is None or not codes or end < start: - return {} if perf is not None else None +def _kst_short(iso: str) -> str: + """'2026-10-01T14:20:00+09:00' → '10/01 14:20'(서버가 준 시각을 한국시간으로).""" + if not iso: + return "" try: - out: dict[str, int] = {} - for (_, code), amount in perf.daily_amounts(start, end, codes).items(): - out[code] = out.get(code, 0) + int(amount) - return out - except Exception: # noqa: BLE001 - logger.warning("performance sales unavailable for meeting", exc_info=True) - return None + from datetime import datetime # noqa: WPS433 + + d = datetime.fromisoformat(str(iso)) + if d.tzinfo is not None: + d = d.astimezone(KST) + return d.strftime("%m/%d %H:%M") + except ValueError: + return str(iso)[:16] def _meeting_view(request: Request, st: Any, *, year: int, month: int, week: date) -> dict[str, Any]: - """회의록 화면 데이터 — 머리(월 목표·누적·남은 주 필요 매출·전주/금주 목표·결과) + 줄(전주 리뷰 포함).""" + """회의록 화면 데이터 — 머리(월 목표·누적·남은 주 필요 매출·전주/금주 목표·결과) + 줄(지난주 리뷰 포함). + + "지난주"는 정확히 7일 전 주(prev_week)만 — 머리 전주 목표·전주 결과·줄의 지난주 칸·결과·달성률이 같은 주다 + (db.get_meeting 이 7일 전 주 회의록에서 같은 연결키 줄만 prev 로 준다). 실적은 _MeetingPerf — 알 수 없는 값은 + None + head.unknown 에 이름(0 원·0% 로 보이지 않게, 그 값에 기대는 달성률·필요 매출도 계산하지 않는다).""" today = today_kst() meeting = st.get_meeting(week_start=week) targets = st.goal_month_targets(year=year, month=month) mult = store.sales_unit_multiplier(targets["sales_unit"]) - perf = _perf_sales(request) - markets = _perf_markets(perf) - names = {m["code"]: m["name"] for m in markets} - sales_codes = [m["code"] for m in markets if m.get("include_in_sales")] + perf = _MeetingPerf(_perf_sales(request)) + names = perf.names week_end = week + timedelta(days=6) prev_start, prev_end = week - timedelta(days=7), week - timedelta(days=1) first = date(year, month, 1) last = date(year + (month == 12), month % 12 + 1, 1) - timedelta(days=1) + unknown: list[str] = [] - def total(a: date, b: date) -> int | None: - r = _perf_sum(perf, a, min(b, today), sales_codes) - return None if r is None else sum(r.values()) + def total(key: str, a: date, b: date) -> int | None: + v = perf.total(a, min(b, today)) + if v is None and perf.state in ("error", "ok"): + unknown.append(key) # 목록 장애(error) 또는 이 기간 매출 조회 실패(ok 인데 None) + return v # 월 누적 = 이 주 앞까지(지난주 일요일까지) — 남은 목표를 이번 주 포함 남은 주로 나눠 "주당 필요 매출" mtd_end = min(last, today, prev_end) month_target_won = int(round(targets["sales_target"] * mult)) if targets["sales_target"] is not None and mult else None - mtd = total(first, mtd_end) if mtd_end >= first else 0 + mtd = total("mtd", first, mtd_end) if mtd_end >= first else 0 # 1주차 앞에는 지난 날이 없다(정말 0) weeks_left = sum(1 for mon, _ in store.month_weeks(year, month) if mon >= week) - pm = meeting.get("prev_meeting") if meeting else None # 바로 앞 주 회의록이어야 "전주 목표" + pm = meeting.get("prev_meeting") if meeting else None # 정확히 7일 전 주 회의록이어야 "전주 목표" need = None if month_target_won is not None and mtd is not None and weeks_left: need = max(0, month_target_won - mtd) // weeks_left + fresh = perf.freshness() head = { "sales_unit": targets["sales_unit"], "sales_target": targets["sales_target"], "roas_target": targets["roas_target"], "month_target_won": month_target_won, "mtd": mtd, "mtd_end": mtd_end.isoformat() if mtd_end >= first else "", "weeks_left": weeks_left, "need_per_week": need, "prev_target": pm["week_target"] if pm and pm["week_start"] == prev_start.isoformat() else None, - "prev_result": total(prev_start, prev_end) if prev_start <= today else None, - "week_result": total(week, week_end) if week <= today else None, - "perf": perf is not None, + "prev_exists": bool(pm and pm["week_start"] == prev_start.isoformat()), + "prev_result": total("prev_result", prev_start, prev_end) if prev_start <= today else None, + "week_result": total("week_result", week, week_end) if week <= today else None, + # perf = 실적 모듈 연결 여부(예전 뜻 그대로 — 갱신 상자·안내 문구 조건), 조회 성공 여부는 perf_state·unknown + "perf": perf.state != "off", + "perf_state": perf.state, + "unknown": unknown, + "fresh_oldest": _kst_short(fresh["oldest"]) if fresh else "", + "fresh_tip": ("매출 자료(실적 모듈) 쇼핑몰별 마지막 갱신 성공 — " + + " · ".join(f"{s['name']} {_kst_short(s['at'])}" for s in fresh["shops"]) + + (f" · 갱신 성공 기록 없음: {', '.join(fresh['never'])}" if fresh["never"] else "")) if fresh else "", } if meeting: - # 줄마다 전주 결과 — 쇼핑몰 연결이면 그 주 실적(자동), 아니면 직접 입력한 결과 - all_codes = [m["code"] for m in markets] + # 줄마다 지난주 결과 — 쇼핑몰 연결이면 그 주 실적(자동), 아니면 직접 입력한 결과(지난주 줄에 저장) + all_codes = [m["code"] for m in perf.markets] by_week: dict[str, dict[str, int] | None] = {} def week_sales(ws: str) -> dict[str, int] | None: - """그 주(월~일, 오늘까지) 쇼핑몰별 실적 — 아직 시작 안 한 주는 None.""" + """그 주(월~일, 오늘까지) 쇼핑몰별 실적 — 조회 실패면 None(시작 전 주는 부르지 않는다).""" if ws not in by_week: a = date.fromisoformat(ws) - by_week[ws] = _perf_sum(perf, a, min(a + timedelta(days=6), today), all_codes) if a <= today else None + by_week[ws] = perf.sum(a, min(a + timedelta(days=6), today), all_codes) return by_week[ws] for it in meeting["items"]: @@ -2921,21 +3000,32 @@ def _meeting_view(request: Request, st: Any, *, year: int, month: int, week: dat a = date.fromisoformat(prev["week_start"]) prev["period"] = f"{a.month}/{a.day}~{(a + timedelta(days=6)).month}/{(a + timedelta(days=6)).day}" prev["not_started"] = bool(code) and a > today + # 쇼핑몰 목록을 못 읽었으면 연결 쇼핑몰이 사용 중인지 알 수 없다 → 결과 미확인(직접 입력 칸·0 으로 바꾸지 않음) + prev["auto_error"] = bool(code) and not prev["not_started"] and perf.state == "error" # 실적 모듈에서 사용 중이 아닌 쇼핑몰(설정에서 사용 OFF·없는 코드)은 늘 0 이라 자동으로 보지 않고 직접 입력 - prev["market_off"] = bool(code) and code not in names - if code and perf is not None and not prev["not_started"] and not prev["market_off"]: + prev["market_off"] = bool(code) and perf.state != "error" and code not in names + if code and perf.readable and not prev["not_started"] and not prev["market_off"]: got = week_sales(prev["week_start"]) - auto = None if got is None else got.get(code, 0) + if got is None: + prev["auto_error"] = True + else: + auto = got.get(code, 0) prev["auto_result"] = auto - prev["result"] = auto if auto is not None else prev.get("result_amount") + prev["result"] = auto if auto is not None else (None if prev["auto_error"] else prev.get("result_amount")) prev["market_name"] = names.get(code, code) for it in meeting["items"]: code = it["marketplace_code"] it["market_name"] = names.get(code, code) if code else "" - it["market_off"] = bool(code) and code not in names - # 이번 주 진행 중 실적(쇼핑몰 연결 줄) — 목표 금액 칸 아래에 "이번주 실적" - got = week_sales(meeting["week_start"]) if code and perf is not None and not it["market_off"] else None - it["week_auto"] = None if got is None else got.get(code, 0) + it["market_off"] = bool(code) and perf.state != "error" and code not in names + it["market_unknown"] = bool(code) and perf.state == "error" + # 이번 주 진행 중 실적(쇼핑몰 연결 줄) — 정량 목표 칸 아래에 "이번주 실적" + it["week_auto"], it["week_error"] = None, False + if code and week <= today and not it["market_off"]: + got = week_sales(meeting["week_start"]) if perf.readable else None + if got is None: + it["week_error"] = perf.state != "off" + else: + it["week_auto"] = got.get(code, 0) p = it.get("prev") it["rate"] = (round(p["result"] / p["target_amount"] * 100, 1) if p and p.get("result") is not None and p.get("target_amount") else None) @@ -2948,7 +3038,8 @@ def _meeting_view(request: Request, st: Any, *, year: int, month: int, week: dat meeting["sections"] = sections prev_items = [it["prev"] for it in meeting["items"] if it.get("prev")] head["prev_items_target"] = sum(p["target_amount"] or 0 for p in prev_items) if prev_items else None - return {"meeting": meeting, "head": head, "markets": [{"code": m["code"], "name": m["name"]} for m in markets]} + return {"meeting": meeting, "head": head, + "markets": [{"code": m["code"], "name": m["name"]} for m in perf.markets]} def _month_plan(st: Any, year: int, month: int) -> list[dict[str, Any]] | None: @@ -3014,7 +3105,7 @@ def _parse_attendees(text: str, members: list[dict[str, str]]) -> list[dict[str, def goal_meeting_page(request: Request, year: int, month: int, week: str | None = None) -> HTMLResponse: """주간 회의록 — 그 달과 겹치는 주(월~일) 탭, 주마다 회의록 하나. 입력은 관리자만(목표 표와 같음).""" from app.main import build_erp_nav, render_template # noqa: WPS433 - from app.store import is_admin # noqa: WPS433 + from app.store import has_module, is_admin # noqa: WPS433 user = _require_user(request) st = _store(request) @@ -3091,6 +3182,8 @@ def goal_meeting_page(request: Request, year: int, month: int, week: str | None # 주차를 열면 다시 받을 매출 기간(실적 모듈 매출 업데이트) — 지난주 월요일 ~ 이번 주 일요일(오늘까지) "sync_from": (sel - timedelta(days=7)).isoformat() if sel - timedelta(days=7) <= today else "", "sync_to": min(sel + timedelta(days=6), today).isoformat(), + # 쇼핑몰 매출 갱신(실적 모듈 POST /performance/api/sync)은 실적 모듈 권한자만 — 없으면 화면이 부르지 않는다 + "can_sync": has_module(user, "performance"), "meeting_status": store.MEETING_STATUS, "meet_members": members, "month_plan": _month_plan(st, year, month), @@ -3131,7 +3224,10 @@ def api_update_meeting(request: Request, week_start: str, payload: dict[str, Any ws = _goal_call(store.validate_week_start, week_start) fields = {k: payload[k] for k in ("week_target", "attendees", "notes") if k in payload} _goal_call(st.update_meeting, week_start=ws, fields=fields, updated_by=user["email"]) - return JSONResponse({"ok": True}) + out: dict[str, Any] = {"ok": True} + if "week_target" in fields: # 화면이 서버 확정값(원 정수)으로 칸을 맞춘다 + out["week_target"] = store.validate_meeting_amount(fields["week_target"]) + return JSONResponse(out) @router.delete("/api/goals/meetings/{week_start}") diff --git a/app/modules/project/templates/project/goal_meeting.html b/app/modules/project/templates/project/goal_meeting.html index 426f81e..88770ef 100644 --- a/app/modules/project/templates/project/goal_meeting.html +++ b/app/modules/project/templates/project/goal_meeting.html @@ -1,7 +1,7 @@ {% extends "erp_base.html" %} {% block head_extra %} - + {% endblock %} @@ -104,9 +104,8 @@ {% else %} {% set h = head %} {% set edit = is_admin %} - {# 매출 자료 갱신 — 주차를 열면 표시 없이 실적 모듈 매출 업데이트(지난주 월요일 ~ 이번 주 오늘)를 한 번 더 돌리고 - 숫자 칸만 다시 그린다(project.js initMeetingSync, 같은 주는 10분에 한 번). 상태 줄은 2026-10-01 요청으로 뺐다. #} - {% if h.perf and sync_from %}{% endif %} + {% set unk = h.unknown or [] %} + {%- macro unknown_val() -%}미확인{%- endmacro -%} {# ── 숫자 — 한 줄 막대(월 목표 대비 누적·남은 주 필요 매출 | 전주 리뷰 | 금주 목표) ── #}
@@ -115,14 +114,14 @@ {% if h.sales_target is not none %}{{ num(h.sales_target) }}{{ h.sales_unit }}{% else %}목표 표에 없음{% endif %} {% if h.month_target_won is not none and h.sales_unit and h.sales_unit != '원' %}= {{ won(h.month_target_won) }}원{% endif %}
-
+
월 누적 실적 (지난주까지) - {% if h.mtd is not none %}{{ won(h.mtd) }}원{% else %}—{% endif %} + {% if h.mtd is not none %}{{ won(h.mtd) }}원{% elif 'mtd' in unk %}{{ unknown_val() }}{% else %}—{% endif %} {% if h.month_target_won and h.mtd is not none %}달성 {{ "%.1f" | format(h.mtd / h.month_target_won * 100) }}%{% endif %}
주당 필요 (남은 {{ h.weeks_left }}주) - {% if h.need_per_week is not none %}{{ won(h.need_per_week) }}원{% else %}—{% endif %} + {% if h.need_per_week is not none %}{{ won(h.need_per_week) }}원{% elif 'mtd' in unk and h.month_target_won is not none %}{{ unknown_val() }}{% else %}—{% endif %}
목표 ROAS @@ -134,14 +133,15 @@ 전주 목표 {% if h.prev_target is not none %}{{ won(h.prev_target) }}원{% else %}—{% endif %}
-
+
전주 결과 ({{ prev_week[5:] | replace('-', '/') }}~ 실적) - {% if h.prev_result is not none %}{{ won(h.prev_result) }}원{% else %}—{% endif %} + {% if h.prev_result is not none %}{{ won(h.prev_result) }}원{% elif 'prev_result' in unk %}{{ unknown_val() }}{% else %}—{% endif %}
전주 달성률 {% if h.prev_target and h.prev_result is not none %}{% set r = h.prev_result / h.prev_target * 100 %} {{ "%.1f" | format(r) }}% + {% elif h.prev_target and 'prev_result' in unk %}{{ unknown_val() }} {% else %}—{% endif %}
@@ -155,14 +155,25 @@ {% endif %} {% if h.need_per_week is not none %}필요 {{ won(h.need_per_week) }}원{% endif %}
-
+
금주 현재 실적 - {% if h.week_result is not none %}{{ won(h.week_result) }}원{% else %}—{% endif %} + {% if h.week_result is not none %}{{ won(h.week_result) }}원{% elif 'week_result' in unk %}{{ unknown_val() }}{% else %}—{% endif %} {% if meeting.week_target and h.week_result is not none %}목표의 {{ "%.1f" | format(h.week_result / meeting.week_target * 100) }}%{% endif %}
- {% if not h.perf %}

실적 모듈이 연결되지 않아 실적·누적·쇼핑몰 자동 결과는 비어 있습니다(결과는 직접 입력).

{% endif %} + {# 매출 자료 갱신 — 주차를 열면 실적 모듈 매출 업데이트(지난주 월요일 ~ 이번 주 오늘)를 한 번 더 돌리고 숫자 칸만 다시 그린다 + (project.js initMeetingSync, 같은 주는 10분에 한 번). 정상이면 아무것도 보이지 않는다(2026-10-01 요청 — 큰 상태 줄 없음). + 실패·일부 실패면 이 작은 안내 + [다시 시도], 실적 권한이 없으면 부르지 않고 한 줄 설명. 마지막 갱신 성공 시각은 서버 기록(data-fresh). #} + {% if h.perf and sync_from %}{% endif %} + {% if not h.perf %}

실적 모듈이 연결되지 않아 실적·누적·쇼핑몰 자동 결과는 비어 있습니다(결과는 직접 입력).

+ {% elif h.perf_state == 'error' %}

실적 모듈 쇼핑몰 목록을 읽지 못해 실적·누적·쇼핑몰 자동 결과를 미확인으로 표시합니다(0 원이 아님). 회의록 입력은 그대로 됩니다.

+ {% elif h.perf_state == 'empty' %}

실적 모듈에 매출 집계 쇼핑몰이 없어 실적·누적은 비어 있습니다.

+ {% elif unk %}

일부 실적을 읽지 못했습니다 — 미확인 칸은 0 원이 아니라 알 수 없는 값입니다.

{% endif %} {# 참석자 — 전체 멤버에서 고른다(칩, [참석자] = 고르기 창). 저장은 이메일을 쉼표로 이어서, 예전 자유 입력 글자도 칩으로 #}
@@ -187,7 +198,8 @@ 이번주 ({{ week[5:] | replace('-', '/') }} ~ {{ week_end[5:] | replace('-', '/') }}) - 지난주 리뷰 ({{ prev_week[5:] | replace('-', '/') }} ~ {{ prev_week_end[5:] | replace('-', '/') }}) + {# 지난주 = 정확히 7일 전 주 — 줄의 지난주 칸·결과·달성률도 이 주 회의록의 같은 줄(연결키)만 #} + 지난주 리뷰 ({{ prev_week[5:] | replace('-', '/') }} ~ {{ prev_week_end[5:] | replace('-', '/') }}){% if not h.prev_exists %} — 이 주 회의록 없음{% endif %} 구역 @@ -205,7 +217,7 @@ {% for it in sec.rows %} {% set p = it.prev %} - + {% if loop.first %} {{ sec.name }} {% if edit %}{% endif %} @@ -213,7 +225,8 @@ {% endif %} {{ it.label }} - {% if it.market_off %}{{ it.market_name }} · 실적 미사용 + {% if it.market_unknown %}{{ it.market_name }} · 미확인 + {% elif it.market_off %}{{ it.market_name }} · 실적 미사용 {% elif it.market_name %}{{ it.market_name }}{% endif %} {% if edit %}{% endif %} @@ -224,7 +237,8 @@ {% if edit %} {% else %}{{ won(it.target_amount) }}{% endif %} - {% if it.week_auto is not none %}이번주 실적 {{ won(it.week_auto) }}{% if it.target_amount %} · {{ "%.0f" | format(it.week_auto / it.target_amount * 100) }}%{% endif %}{% endif %} + {# 이번주 실적 — data-auto = 실적(서버), % 는 화면이 서버 확정 정량 목표(tr data-target-amount)로 다시 계산(project.js paintMeetWeek) #} + {% if it.week_auto is not none %}이번주 실적 {{ won(it.week_auto) }}{% if it.target_amount %} · {{ "%.0f" | format(it.week_auto / it.target_amount * 100) }}%{% endif %}{% elif it.week_error %}이번주 실적 미확인{% endif %} {% if p %}
{{ p.content }}
@@ -232,6 +246,8 @@ {% if p.not_started %} 진행 전 + {% elif p.auto_error %} + 미확인 {% elif p.auto_result is not none %} {{ won(p.auto_result) }} {% elif edit %} @@ -246,7 +262,7 @@ {% else %}{{ meeting_status[p.status] or '—' }}{% endif %} {% else %} - 지난 회의록에 없는 줄 + {% if h.prev_exists %}지난주 회의록에 없는 줄{% else %}지난주({{ prev_week[5:] | replace('-', '/') }}~) 회의록 없음{% endif %} {% endif %} {% endfor %} @@ -277,5 +293,5 @@ {% include "project/_side_modals.html" %} {% include "project/_member_tasks_modal.html" %} - + {% endblock %} diff --git a/app/modules/project/templates/project/goals.html b/app/modules/project/templates/project/goals.html index a35fc34..0fbb087 100644 --- a/app/modules/project/templates/project/goals.html +++ b/app/modules/project/templates/project/goals.html @@ -1,7 +1,7 @@ {% extends "erp_base.html" %} {% block head_extra %} - + {% endblock %} @@ -144,14 +144,18 @@ {% if loop.first %} - {# 구역 메뉴(색·위로·아래로·줄 추가·영역 삭제)는 우클릭 — project.js areaMenuItems #} - {{ area.name }} + {# 구역 메뉴(색·위로·아래로·줄 추가·영역 삭제) — 우클릭 또는 ⋮ 버튼(키보드 Tab → Enter/Space, 터치 탭). project.js areaMenuItems #} + {{ area.name }} + {% if is_admin %}{% endif %} {% endif %} {# 항목 칸(2열) — 같은 항목 칸으로 묶인 줄(016 label_cont)은 묶음 첫 줄이 rowspan 으로 덮는다 #} {% if not row.label_cont %} 1 %} rowspan="{{ row.label_span }}"{% endif %} data-label-span="{{ row.label_span or 1 }}"> - {{ row.label }} + {{ row.label }} + {% if is_admin %}{% endif %} {% endif %} {# 칸 배치는 router._goal_area_layout — 엑셀식 사각형 병합(colspan·rowspan), 가려진 칸은 없다 #} @@ -177,7 +181,7 @@ {% if is_admin %}
- 칸을 고치면 바로 저장됩니다. 숫자 칸을 비우면 지워집니다. 구역·항목 칸을 우클릭하면 색·순서·줄 추가·삭제 메뉴가 나옵니다. + 칸을 고치면 바로 저장됩니다. 숫자 칸을 비우면 지워집니다. 구역·항목 칸을 우클릭하거나 칸의 ⋮ 버튼(키보드 Tab·Enter, 터치)을 누르면 색·순서·줄 추가·삭제 메뉴가 나옵니다. {%- if board.halves %} 칸을 마우스로 끌어 여러 칸을 고른 뒤 우클릭 → 셀 병합, 병합된 칸은 우클릭 → 병합 해제(글은 왼쪽 위 칸에 남음).{% endif %} 월 이름을 누르면 그 달 주간 회의록이 열립니다.
@@ -192,5 +196,5 @@ {% include "project/_side_modals.html" %} {% include "project/_member_tasks_modal.html" %} - + {% endblock %} diff --git a/app/modules/project/templates/project/help.html b/app/modules/project/templates/project/help.html index b19f2e7..d7ce497 100644 --- a/app/modules/project/templates/project/help.html +++ b/app/modules/project/templates/project/help.html @@ -1,7 +1,7 @@ {% extends "erp_base.html" %} {% block head_extra %} - + {% endblock %} @@ -95,9 +95,19 @@ 접히고, 다시 누르면 펼쳐집니다(접힌 상태는 내 브라우저에 기억). 월 이름을 누르면 그 달 주간 회의록이 열립니다. 입력은 관리자만 할 수 있고(칸을 고치면 바로 저장), 다른 직원은 보기만 합니다. 관리자는 + 연도 추가로 새해 목표를 만들고(이전 연도의 업무 영역 구성을 그대로 가져옴), 영역·줄 이름은 눌러서 그 자리에서 고치고(Enter 저장, Esc 취소), - 구역·항목 칸을 우클릭해 색·순서·줄 추가·삭제를 합니다. 업무 영역 칸은 엑셀처럼 병합할 수 있습니다 — 칸을 마우스로 + 구역·항목 칸을 우클릭하거나 칸 오른쪽 위의 작은 ⋮ 버튼(마우스를 올리면 보임)을 눌러 색·순서·줄 추가·삭제를 합니다. + 키보드로는 Tab으로 이름 칸·⋮로 가서 Enter(이름 칸 = 이름 고치기, ⋮ = 메뉴), 메뉴 안에서 ↑↓·Enter, + Esc로 닫습니다. 터치 화면에서는 ⋮ 버튼이 늘 옅게 보여 손가락으로 누르면 됩니다. 업무 영역 칸은 엑셀처럼 병합할 수 있습니다 — 칸을 마우스로 끌어 여러 칸을 고른 뒤 우클릭 → "셀 병합", 병합된 칸은 우클릭 → "병합 해제"(글은 왼쪽 위 칸에 남음). - 가로 병합은 같은 분기의 월 칸끼리만(연간·분기 칸은 세로로만) 되고, 칸들의 글은 순서대로 첫 칸에 모입니다. + 가로 병합은 같은 분기의 월 칸끼리만(연간·분기 칸은 세로로만) 되고, 칸들의 글은 순서대로 첫 칸에 모입니다. +
저장이 안 되면(네트워크 끊김 등) 칸 테두리가 빨갛게 되고 쓴 글은 그대로 남습니다 — 다시 입력하거나 칸을 떠나면 다시 저장합니다. + 저장 안 된 칸이 있으면 줄·영역 추가·병합은 하지 않고 알려 주며, 그 상태로 페이지를 떠나려 하면 브라우저가 한 번 묻습니다. + 글은 내 브라우저에도 잠시 보관되어, 저장되지 못한 채 창이 닫혀도 다음에 열면 되살아납니다(그 사이 다른 사람이 같은 칸을 고쳤으면 되살리지 않음). +
  • 주간 회의록(목표 표의 월 이름) — 지난주 리뷰는 언제나 바로 앞 주(7일 전 월~일) 회의록만 보여 줍니다. 그 주 회의록이 없으면 + "회의록 없음"으로 비워 두고, 몇 주 전 결과를 지난주처럼 보이지 않습니다. 회의록을 만드는 순서(다음 주를 먼저 만들어도)와 줄 이름 변경·순서 이동과 + 관계없이 같은 줄끼리 이어집니다. 실적 모듈에서 매출을 읽지 못하면 그 칸은 0원이 아니라 ⚠ 미확인으로 보입니다(필요 매출·달성률도 미확인). + 매출 자동 갱신은 평소엔 조용히 돌고, 실패하거나 일부 쇼핑몰만 실패하면 숫자 아래에 작은 안내와 다시 시도가 나옵니다 + (안내의 "마지막 갱신 성공" 시각은 실적 모듈이 기록한 시각). 실적 권한이 없으면 갱신하지 않고 저장된 실적으로 보여 줍니다.
  • 프로젝트 — 내가 멤버인 프로젝트 목록입니다. 누르면 그 프로젝트 화면으로 갑니다. 완료한 프로젝트는 아래 완료 프로젝트에 흐리게 모입니다.
  • 전체 멤버 — 관리자에게만 보입니다. 사람 아이콘을 누르면 그 사람이 맡은 모든 작업을 한눈에 봅니다.
  • diff --git a/app/modules/project/templates/project/inbox.html b/app/modules/project/templates/project/inbox.html index 61570bd..91e7355 100644 --- a/app/modules/project/templates/project/inbox.html +++ b/app/modules/project/templates/project/inbox.html @@ -1,7 +1,7 @@ {% extends "erp_base.html" %} {% block head_extra %} - + {% endblock %} @@ -104,5 +104,5 @@ {% include "project/_side_modals.html" %} {% include "project/_member_tasks_modal.html" %} - + {% endblock %} diff --git a/app/modules/project/templates/project/mytasks.html b/app/modules/project/templates/project/mytasks.html index 2933f64..16efdcd 100644 --- a/app/modules/project/templates/project/mytasks.html +++ b/app/modules/project/templates/project/mytasks.html @@ -1,7 +1,7 @@ {% extends "erp_base.html" %} {% block head_extra %} - + {% endblock %} @@ -100,5 +100,5 @@ "today": {{ today | tojson }} } - + {% endblock %} diff --git a/app/modules/project/templates/project/project.html b/app/modules/project/templates/project/project.html index 270d80c..99a45b3 100644 --- a/app/modules/project/templates/project/project.html +++ b/app/modules/project/templates/project/project.html @@ -1,7 +1,7 @@ {% extends "erp_base.html" %} {% block head_extra %} - + @@ -496,5 +496,5 @@ - + {% endblock %} diff --git a/app/modules/project/templates/project/trash.html b/app/modules/project/templates/project/trash.html index 95713e7..4706e33 100644 --- a/app/modules/project/templates/project/trash.html +++ b/app/modules/project/templates/project/trash.html @@ -1,7 +1,7 @@ {% extends "erp_base.html" %} {% block head_extra %} - + {% endblock %} @@ -70,5 +70,5 @@ {% include "project/_side_modals.html" %} {% include "project/_member_tasks_modal.html" %} - + {% endblock %} diff --git a/app/static/project.css b/app/static/project.css index a6bdd79..3d93f3f 100644 --- a/app/static/project.css +++ b/app/static/project.css @@ -1351,7 +1351,9 @@ label.pj-desc-fmtbtn { border: none; background: transparent; padding: 8px 10px; border-radius: 7px; font-size: 13px; color: var(--pj-ink); cursor: pointer; } -.pj-ctxmenu-item:hover { background: var(--pj-accent-tint); } +.pj-ctxmenu-item:hover, .pj-ctxmenu-item:focus { background: var(--pj-accent-tint); outline: none; } +.pj-ctxmenu-item:focus-visible { box-shadow: inset 0 0 0 2px var(--pj-accent); } +.pj-ctxmenu:focus { outline: none; } .pj-ctxmenu-item.is-danger { color: #c22b10; } .pj-ctxmenu-item.is-danger:hover { background: #fbecea; } .pj-ctxmenu-sep { height: 1px; background: var(--pj-border); margin: 4px 2px; } @@ -2093,7 +2095,24 @@ input.pj-goal-num:focus { outline: 2px solid var(--pj-accent); outline-offset: - .pj-goal-area > tr:first-child > * { border-top: 1px solid rgba(0, 0, 0, .12); } .pj-goal-area-name { font-size: 13px; font-weight: 800 !important; } .pj-goal-area-text, .pj-goal-row-text { display: block; word-break: keep-all; overflow-wrap: anywhere; } -/* 구역·항목 칸 메뉴(색·순서·줄 추가·삭제)는 우클릭(project.js areaMenuItems·rowMenuItems) — 마우스 오버 도구 막대는 2026-10-01 요청으로 뺐다 */ +/* 구역·항목 칸 메뉴(색·순서·줄 추가·삭제)는 우클릭(project.js areaMenuItems·rowMenuItems) — 마우스 오버 도구 막대는 2026-10-01 요청으로 뺐다. + 대신 칸 오른쪽 위 작은 ⋮ 버튼(.pj-goal-menu-btn, 관리자만) — 자리를 차지하지 않게 absolute, 평소 투명·칸에 마우스/포커스가 오면 보임. + 키보드(Tab → Enter/Space)·터치(마우스 없는 화면은 늘 옅게 보임)로도 같은 메뉴. */ +.pj-goal-menu-btn { + position: absolute; top: 2px; right: 1px; z-index: 3; display: inline-flex; align-items: center; justify-content: center; + width: 18px; height: 22px; padding: 0; border: none; border-radius: 5px; background: transparent; color: var(--pj-ink-soft); + cursor: pointer; opacity: 0; transition: opacity .12s; +} +.pj-goal-menu-btn .material-symbols-outlined { font-size: 17px; } +.pj-goal-menu-btn:hover, .pj-goal-menu-btn[aria-expanded="true"] { background: rgba(255, 255, 255, .85); color: var(--pj-ink); box-shadow: 0 0 0 1px rgba(0, 0, 0, .12); } +th.pj-goal-area-name:hover .pj-goal-menu-btn, th.pj-goal-row-label:hover .pj-goal-menu-btn, +th.pj-goal-area-name:focus-within .pj-goal-menu-btn, th.pj-goal-row-label:focus-within .pj-goal-menu-btn, +.pj-goal-menu-btn:focus-visible, .pj-goal-menu-btn[aria-expanded="true"] { opacity: 1; } +.pj-goal-menu-btn:focus-visible { outline: 2px solid var(--pj-accent); outline-offset: 0; } +@media (hover: none) { .pj-goal-menu-btn { opacity: .7; } } +.pj-goal-area-text[tabindex]:focus-visible, .pj-goal-row-text[tabindex]:focus-visible { outline: 2px solid var(--pj-accent); outline-offset: 1px; border-radius: 4px; } +html.pj-goal-selecting .pj-goal-menu-btn { pointer-events: none; } +@media print { .pj-goal-menu-btn { display: none !important; } } textarea.pj-goal-text { display: block; width: 100%; box-sizing: border-box; min-height: 46px; padding: 6px; border: none; background: transparent; font: inherit; line-height: 1.5; color: inherit; resize: none; overflow: hidden; @@ -2123,6 +2142,9 @@ textarea.pj-goal-text::placeholder { color: rgba(0, 0, 0, .3); } .pj-goal-table td.pj-goal-year-col.is-merge-sel { box-shadow: inset 0 0 0 2px var(--pj-accent), 4px 0 6px -4px rgba(16, 24, 40, .18); } .pj-goal-numtd.is-saved, .pj-goal-texttd.is-saved { animation: pj-goal-saved 1s ease-out; } +/* 저장 실패한 칸 — 빨간 테두리(입력한 내용은 그대로, 다시 입력·칸 떠남·Enter 에 다시 저장) */ +.pj-goal-table td.is-save-failed, .pj-meet-table td.is-save-failed, .pj-meet-kpi.is-save-failed, +.pj-meet-notes textarea.is-save-failed { box-shadow: inset 0 0 0 2px #d93025 !important; } @keyframes pj-goal-saved { from { box-shadow: inset 0 0 0 2px #34a853; } to { box-shadow: inset 0 0 0 2px transparent; } } .pj-goal-table th.is-saved { animation: pj-goal-saved 1s ease-out; } @@ -2289,7 +2311,25 @@ html.pj-goal-selecting, html.pj-goal-selecting * { user-select: none !important; .pj-meet-week.is-on { border-color: var(--pj-accent); box-shadow: inset 0 0 0 1px var(--pj-accent); background: var(--pj-accent-tint); } .pj-meet-dot { position: absolute; top: 3px; left: 3px; width: 6px; height: 6px; border-radius: 50%; background: #34a853; } -/* 매출 자료 갱신 상태 줄 */ +/* 매출 자료 갱신 — 정상이면 숨김. 실패·일부 실패·권한 없음일 때만 작은 안내(initMeetingSync, #pj-meet-sync.pj-meet-syncnote) */ +.pj-meet-syncnote { + display: flex; align-items: center; gap: 6px; margin: -4px 0 8px; padding: 4px 8px; border-radius: 7px; + font-size: 12px; line-height: 1.4; background: #fff4ec; color: #9a4a07; +} +.pj-meet-syncnote[hidden] { display: none; } +.pj-meet-syncnote .material-symbols-outlined { font-size: 16px; flex: 0 0 auto; } +.pj-meet-syncnote .pj-btn { margin-left: auto; flex: 0 0 auto; } +.pj-meet-syncnote[data-state="noperm"] { background: #f6f7f9; color: var(--pj-ink-soft); } +.pj-meet-syncnote[data-state="noperm"] .material-symbols-outlined { display: none; } +.pj-meet-syncnote[data-state="running"] { background: #eef4ff; color: #1d4ed8; } +@media print { .pj-meet-syncnote { display: none !important; } } +/* 실적 미확인(조회 실패) — 0 원과 구분 */ +.pj-meet-unknown { color: #b45309; font-weight: 700; font-size: .92em; } +.pj-meet-unknown::before { content: "⚠ "; font-weight: 400; } +.pj-meet-perf-warn { color: #9a4a07; } +.pj-meet-noprev { font-weight: 500; color: rgba(0, 0, 0, .45); } +.pj-meet-market.is-unknown { background: #fff4ec; color: #b45309; } +.pj-meet-week-auto.is-unknown { color: #b45309; } .pj-meet-sync { display: flex; align-items: center; gap: 8px; margin: -4px 0 10px; padding: 6px 10px; border-radius: 8px; background: #f6f7f9; color: var(--pj-ink-soft); font-size: 12.5px; diff --git a/app/static/project.js b/app/static/project.js index 57565c2..57eef19 100644 --- a/app/static/project.js +++ b/app/static/project.js @@ -8,9 +8,11 @@ "use strict"; // ── 공용 fetch ───────────────────────────────────────────── - async function api(method, url, body) { + // extra.keepalive — 페이지를 떠나는 중에도 요청을 보내 달라고 브라우저에 부탁(보장은 아님, createFieldSaver 참고) + async function api(method, url, body, extra) { const opts = { method, headers: { "Content-Type": "application/json" } }; if (body !== undefined) opts.body = JSON.stringify(body); + if (extra && extra.keepalive) opts.keepalive = true; const res = await fetch(url, opts); if (!res.ok) { let msg = res.statusText, detail = null; @@ -116,29 +118,44 @@ // ── 우클릭 컨텍스트 메뉴 — 하나만 열리는 공용 컴포넌트. // openDayPopover(아래)의 위치잡기/외부클릭 닫기 방식을 그대로 따르되, 앵커 // 엘리먼트 대신 클릭 좌표(clientX/Y) 기준으로 뷰포트에 클램프한다. - let ctxMenuEl = null; - function closeContextMenu() { + let ctxMenuEl = null, ctxMenuOpts = null; + function closeContextMenu(opts) { if (!ctxMenuEl) return; - ctxMenuEl.remove(); + const menu = ctxMenuEl, o = ctxMenuOpts || {}; + // 메뉴 안에 포커스가 있었으면(키보드로 다루던 중) 연 버튼으로 포커스를 돌려준다 + const hadFocus = menu.contains(document.activeElement); + menu.remove(); ctxMenuEl = null; + ctxMenuOpts = null; document.removeEventListener("mousedown", onCtxDocDown, true); document.removeEventListener("keydown", onCtxKeyDown, true); - window.removeEventListener("scroll", closeContextMenu, true); - window.removeEventListener("resize", closeContextMenu, true); + window.removeEventListener("scroll", onCtxScroll, true); + window.removeEventListener("resize", onCtxScroll, true); + if (o.onClose) o.onClose(opts || {}); + if (o.returnFocus && (hadFocus || (opts && opts.focus)) && document.contains(o.returnFocus)) { + try { o.returnFocus.focus({ preventScroll: true }); } catch (_) { o.returnFocus.focus(); } + } } + function onCtxScroll() { closeContextMenu(); } function onCtxDocDown(e) { - if (ctxMenuEl && !ctxMenuEl.contains(e.target)) closeContextMenu(); + if (ctxMenuEl && !ctxMenuEl.contains(e.target)) closeContextMenu({ target: e.target }); } function onCtxKeyDown(e) { - if (e.key === "Escape") closeContextMenu(); + if (e.key === "Escape") { e.preventDefault(); e.stopPropagation(); closeContextMenu({ focus: true }); } } // items: [{label, danger?, onClick} | null(구분선)] + // opts(선택): returnFocus = 닫으면 포커스를 돌려줄 요소(메뉴 버튼), focusFirst = 열자마자 첫 항목에 포커스(키보드로 연 경우), + // onClose = 닫힐 때(메뉴 버튼 aria-expanded 되돌리기). 메뉴 안: ↑↓·Home·End 이동, Esc 닫기, Tab 닫기. // 우클릭 메뉴 왼쪽 아이콘(Material Symbols) — item.icon 에 넣는다 function menuIcon(name) { return '' + name + ""; } - function showContextMenu(x, y, items) { + function showContextMenu(x, y, items, opts) { closeContextMenu(); + opts = opts || {}; const menu = document.createElement("div"); menu.className = "pj-ctxmenu"; + menu.setAttribute("role", "menu"); + if (opts.label) menu.setAttribute("aria-label", opts.label); + menu.tabIndex = -1; items.forEach(function (item) { if (!item) { const sep = document.createElement("div"); @@ -158,26 +175,200 @@ } else { b.textContent = item.label; } - b.addEventListener("click", function () { closeContextMenu(); item.onClick(); }); + b.setAttribute("role", item.checked !== undefined ? "menuitemcheckbox" : "menuitem"); + if (item.checked !== undefined) b.setAttribute("aria-checked", item.checked ? "true" : "false"); + b.tabIndex = -1; + b.addEventListener("click", function () { closeContextMenu({ focus: true }); item.onClick(); }); menu.appendChild(b); }); + menu.addEventListener("keydown", function (e) { + const list = Array.from(menu.querySelectorAll(".pj-ctxmenu-item")); + const i = list.indexOf(document.activeElement); + let j = -1; + if (e.key === "ArrowDown") j = i < 0 ? 0 : (i + 1) % list.length; + else if (e.key === "ArrowUp") j = i <= 0 ? list.length - 1 : i - 1; + else if (e.key === "Home") j = 0; + else if (e.key === "End") j = list.length - 1; + else if (e.key === "Tab") { e.preventDefault(); closeContextMenu({ focus: true }); return; } + if (j < 0 || !list.length) return; + e.preventDefault(); + list[j].focus(); + }); document.body.appendChild(menu); ctxMenuEl = menu; + ctxMenuOpts = opts; let left = window.scrollX + x; let top = window.scrollY + y; left = Math.min(left, window.scrollX + document.documentElement.clientWidth - menu.offsetWidth - 8); top = Math.min(top, window.scrollY + document.documentElement.clientHeight - menu.offsetHeight - 8); menu.style.left = Math.max(8, left) + "px"; menu.style.top = Math.max(8, top) + "px"; + if (opts.returnFocus) { + // 메뉴 버튼으로 연 메뉴 — 첫 항목(키보드) 또는 메뉴 자체(마우스·터치)에 포커스를 줘 ↑↓·Esc 가 바로 먹게 + const first = menu.querySelector(".pj-ctxmenu-item"); + if (opts.focusFirst && first) first.focus(); else menu.focus(); + } setTimeout(function () { if (ctxMenuEl !== menu) return; // 그 사이 닫혔으면 문서 리스너를 남기지 않는다 document.addEventListener("mousedown", onCtxDocDown, true); document.addEventListener("keydown", onCtxKeyDown, true); - window.addEventListener("scroll", closeContextMenu, true); - window.addEventListener("resize", closeContextMenu, true); + window.addEventListener("scroll", onCtxScroll, true); + window.addEventListener("resize", onCtxScroll, true); }, 0); } + // ── 칸별 자동 저장(목표 표·주간 회의록 공용) ───────────────────────────── + // · 저장 완료 기준(saved)은 "성공한 요청에 실어 보낸 값"만이다 — 응답이 올 때 바뀌어 있는 화면 값을 저장됐다고 보지 않는다. + // · 같은 칸의 요청은 한 줄로 세운다(앞 요청이 끝나야 다음 요청을 보냄) — 서버에 닿는 순서 = 보낸 순서라, 늦게 끝난 옛 요청이 + // 최신 값을 덮지 않는다(응답만 무시하는 게 아니라 쓰기 자체를 차례대로). 다음 요청은 보낼 때의 최신 초안을 읽어서, + // 진행 중에 새로 입력한 글·숫자도 뒤이어 저장된다. + // · 실패하면 초안과 dirty 를 그대로 두고 칸에 실패 표시(cfg.onFail) — 다음 입력·칸 떠남·Enter·flushAll 이 다시 보낸다. + // · flushAll() 은 대기 타이머뿐 아니라 진행 중 요청까지 기다리고, 하나라도 실패하면 reject(구조 변경·표 교체를 멈추게). + // · 초안 백업(cfg.draftKey) — 입력할 때마다 localStorage 에 {base(서버에 저장된 값), draft}, 저장되면 지운다. 다음에 열 때 + // 서버 값이 base 그대로면 초안을 되살려 다시 저장하고, 서버 값이 바뀌었으면 되살리지 않는다(다른 곳의 수정을 덮지 않게). + // · 페이지 떠남(onBeforeUnload): 진행 중 요청이 없는 dirty 칸은 keepalive 로 한 번 더 보낸다 — 브라우저가 끝까지 보낸다는 + // 보장은 없어서 초안 백업이 함께 남는다. 실패했던 칸·진행 중 요청이 있는 칸·cfg.unload === "warn"(숫자 칸) 이 남아 있으면 + // 브라우저 이탈 경고를 띄운다. + const DRAFT_PREFIX = "pj_draft:"; + const DRAFT_TTL_MS = 14 * 24 * 3600 * 1000; + (function purgeOldDrafts() { + try { + const now = Date.now(), old = []; + for (let i = 0; i < localStorage.length; i++) { + const k = localStorage.key(i); + if (!k || k.indexOf(DRAFT_PREFIX) !== 0) continue; + let d = null; + try { d = JSON.parse(localStorage.getItem(k)); } catch (_) {} + if (!d || now - (d.at || 0) > DRAFT_TTL_MS) old.push(k); + } + old.forEach(function (k) { localStorage.removeItem(k); }); + } catch (_) {} + })(); + function createFieldSaver(cfg) { + const delay = cfg.delay == null ? 800 : cfg.delay; + const states = new Map(); // 칸 → {saved, chain, busy, timer, failed} + const alive = cfg.alive || function (f) { return document.contains(f); }; + function noop() {} + function writeDraft(f, s) { + const k = cfg.draftKey && cfg.draftKey(f); + if (!k) return; + try { + const v = cfg.read(f); + if (v === s.saved) localStorage.removeItem(DRAFT_PREFIX + k); + else localStorage.setItem(DRAFT_PREFIX + k, JSON.stringify({ base: s.saved, draft: v, at: Date.now() })); + } catch (_) {} + } + // 칸 등록 — initial = 서버가 그려 준 값. 남은 초안이 있으면 되살린다: "restored" | "conflict" | null + function track(f, initial) { + const s = { saved: initial, chain: Promise.resolve(), busy: 0, timer: null, failed: false }; + states.set(f, s); + const k = cfg.draftKey && cfg.draftKey(f); + if (!k) return null; + let d = null; + try { d = JSON.parse(localStorage.getItem(DRAFT_PREFIX + k) || "null"); } catch (_) {} + if (!d || typeof d.draft !== "string") return null; + if (d.draft === initial) { try { localStorage.removeItem(DRAFT_PREFIX + k); } catch (_) {} return null; } + if (d.base !== initial) { try { localStorage.removeItem(DRAFT_PREFIX + k); } catch (_) {} return "conflict"; } + if (cfg.write) cfg.write(f, d.draft); + queue(f); + return "restored"; + } + function queue(f) { + const s = states.get(f); + if (!s) return; + clearTimeout(s.timer); + s.timer = setTimeout(function () { s.timer = null; flush(f).catch(noop); }, delay); + writeDraft(f, s); + } + function flush(f, opts) { + const s = states.get(f); + if (!s) return Promise.resolve(true); + clearTimeout(s.timer); + s.timer = null; + const run = async function () { + const v = cfg.read(f); + if (v === s.saved) { + if (s.failed) { s.failed = false; if (cfg.onClear) cfg.onClear(f); } + writeDraft(f, s); + return true; + } + let res; + try { + res = await cfg.send(f, v, opts || {}); + } catch (err) { + s.failed = true; + writeDraft(f, s); + if (cfg.onFail) cfg.onFail(f, err); + throw err; + } + s.saved = v; // 이 요청에 실어 보낸 값만 저장됨으로 + s.failed = false; + if (cfg.onSaved) { + const ns = cfg.onSaved(f, v, res, cfg.read(f) === v); // 마지막 인자: 요청 뒤 초안이 그대로인가 + if (typeof ns === "string") s.saved = ns; // 서버 표기(쉼표 등)로 칸을 바꿨으면 그 값이 기준 + } + writeDraft(f, s); + return true; + }; + s.busy++; + // 앞 요청이 없으면 지금 바로(동기적으로 fetch 까지) — 페이지 떠날 때 keepalive 가 그 자리에서 나가게 + const p = s.busy === 1 ? run() : s.chain.then(run, run); + s.chain = p.then(noop, noop).then(function () { s.busy--; }); + return p; + } + function isDirty(f) { + const s = states.get(f); + return !!s && (s.busy > 0 || !!s.timer || cfg.read(f) !== s.saved); + } + function each(fn) { states.forEach(function (s, f) { if (alive(f)) fn(s, f); }); } + function anyDirty() { let d = false; each(function (s, f) { if (isDirty(f)) d = true; }); return d; } + function flushAll() { + const list = []; + each(function (s, f) { if (isDirty(f)) list.push(flush(f)); }); + return Promise.allSettled(list).then(function (rs) { + const bad = rs.filter(function (r) { return r.status === "rejected"; }); + if (!bad.length) return true; + const err = new Error("저장하지 못한 칸이 " + bad.length + "개 있어 멈췄습니다(입력한 내용은 그대로) — " + + ((bad[0].reason && bad[0].reason.message) || "저장 실패")); + err.cause = bad[0].reason; + throw err; + }); + } + function prune() { states.forEach(function (s, f) { if (!alive(f)) { clearTimeout(s.timer); states.delete(f); } }); } + function onBeforeUnload(e) { + let warn = false; + each(function (s, f) { + const dirty = cfg.read(f) !== s.saved; + if (!dirty && !s.busy) return; + writeDraft(f, s); + if (cfg.unload === "warn" || s.busy > 0 || s.failed) warn = true; + if (dirty && s.busy === 0 && cfg.unload !== "warn") flush(f, { keepalive: true }).catch(noop); + }); + if (warn && e) { e.preventDefault(); e.returnValue = ""; } + return warn; + } + return { + track: track, queue: queue, flush: flush, flushAll: flushAll, isDirty: isDirty, anyDirty: anyDirty, + prune: prune, onBeforeUnload: onBeforeUnload, + savedOf: function (f) { const s = states.get(f); return s ? s.saved : undefined; }, + failedOf: function (f) { const s = states.get(f); return !!(s && s.failed); }, + }; + } + // 저장 실패 표시 — 칸 빨간 테두리 + 안내(입력한 내용은 지우지 않는다) + function markSaveFailed(node, err) { + if (node) { + node.classList.remove("is-saved"); + node.classList.add("is-save-failed"); + node.dataset.tip = "저장 실패 — 입력한 내용은 그대로 있습니다. 다시 입력하거나 칸을 떠나면(Enter) 다시 저장합니다."; + } + showToast("저장 실패(입력한 내용은 그대로, 칸을 떠나면 다시 시도): " + (err && err.message || ""), "error"); + } + function clearSaveFailed(node) { + if (!node || !node.classList.contains("is-save-failed")) return; + node.classList.remove("is-save-failed"); + delete node.dataset.tip; + } + // ── 클립보드 복사 ── navigator.clipboard 는 https(보안 컨텍스트)에서만 // 동작한다 — 사내 IP로 http 접속하는 경우를 위해 임시 textarea 로 한 번 더 // 시도한다. 둘 다 실패하면 false 를 돌려 호출 쪽이 주소를 직접 보여준다. @@ -8212,65 +8403,81 @@ let clearMergeSel = function () {}; if (!isAdmin) return; - // ── 숫자 칸 ── - table.querySelectorAll("input.pj-goal-num").forEach(function (inp) { - inp.dataset.saved = inp.value; - inp.addEventListener("focus", function () { inp.select(); }); - inp.addEventListener("input", recompute); - inp.addEventListener("keydown", function (e) { - if (e.key === "Enter") { e.preventDefault(); inp.blur(); } - else if (e.key === "Escape") { inp.value = inp.dataset.saved; recompute(); inp.blur(); } - }); - inp.addEventListener("change", async function () { - const d = inp.dataset; - try { - const res = await api("PUT", "/project/api/goals/" + year + "/metrics", - { metric: d.metric, kind: d.kind, month: parseInt(d.month, 10), value: inp.value }); - inp.value = res.label; - d.saved = res.label; - flashSaved(inp.parentElement); - } catch (e) { - inp.value = d.saved; - showToast("저장 실패: " + e.message, "error"); - } - recompute(); - }); - }); - function flashSaved(node) { node.classList.remove("is-saved"); void node.offsetWidth; node.classList.add("is-saved"); } - // ── 글 칸 ── - const pending = new Map(); // textarea → 타이머 + // ── 숫자 칸 — Enter·칸 떠남에 저장(createFieldSaver: 같은 칸 요청 차례대로, 늦은 응답이 새 입력을 덮지 않음). + // 서버 표기(쉼표)는 요청 뒤 입력이 그대로일 때만 칸에 넣는다. 실패해도 입력값은 그대로(빨간 테두리), Esc = 저장된 값으로. + const numSaver = createFieldSaver({ + read: function (inp) { return inp.value; }, + write: function (inp, v) { inp.value = v; }, + unload: "warn", // Enter·칸 떠남 전의 숫자는 페이지를 떠날 때 보내지 않고 경고만 + send: function (inp, v, o) { + const d = inp.dataset; + return api("PUT", "/project/api/goals/" + year + "/metrics", + { metric: d.metric, kind: d.kind, month: parseInt(d.month, 10), value: v }, o); + }, + onSaved: function (inp, v, res, same) { + clearSaveFailed(inp.parentElement); + flashSaved(inp.parentElement); + if (!same) return undefined; // 요청 뒤 새로 입력 중 — 그 초안을 그대로 둔다 + inp.value = res.label; + recompute(); + return res.label; + }, + onFail: function (inp, err) { markSaveFailed(inp.parentElement, err); }, + }); + table.querySelectorAll("input.pj-goal-num").forEach(function (inp) { + numSaver.track(inp, inp.value); + inp.addEventListener("focus", function () { inp.select(); }); + inp.addEventListener("input", recompute); + inp.addEventListener("keydown", function (e) { + if (isImeEnter(e)) return; + if (e.key === "Enter") { e.preventDefault(); if (document.activeElement === inp) inp.blur(); else numSaver.flush(inp).catch(function () {}); } + else if (e.key === "Escape") { inp.value = numSaver.savedOf(inp); recompute(); inp.blur(); } + }); + inp.addEventListener("change", function () { numSaver.flush(inp).catch(function () {}); }); + inp.addEventListener("blur", function () { numSaver.flush(inp).catch(function () {}); }); + }); + + // ── 글 칸 — 0.8초 멈춤·칸 떠남에 저장(createFieldSaver). 실패해도 글은 그대로 두고 다음 입력·칸 떠남에 다시 보낸다. + // 초안은 localStorage 에도(pj_draft:goal:줄:칸) — 페이지가 닫혀도 다음에 열면 되살린다. function cellUrl(ta) { return "/project/api/goals/rows/" + ta.dataset.row + "/cells/" + ta.dataset.month; } - async function saveText(ta) { - clearTimeout(pending.get(ta)); - pending.delete(ta); - const body = ta.value; - if (body === ta.dataset.saved) return; - try { - await api("PUT", cellUrl(ta), { body: body }); - ta.dataset.saved = body; + let pendingRefresh = false; // 구조는 바뀌었는데 입력 중이라 표를 아직 다시 못 그림 — 저장이 끝나면 다시 그린다 + const textSaver = createFieldSaver({ + read: function (ta) { return ta.value; }, + write: function (ta, v) { ta.value = v; fit(ta); }, + send: function (ta, v, o) { return api("PUT", cellUrl(ta), { body: v }, o); }, + draftKey: function (ta) { return "goal:" + ta.dataset.row + ":" + ta.dataset.month; }, + onSaved: function (ta) { + clearSaveFailed(ta.parentElement); flashSaved(ta.parentElement); - } catch (e) { showToast("저장 실패: " + e.message, "error"); } - } - // 글 칸 연결 — 처음 한 번 + 표를 그 자리에서 다시 그린 뒤 새 칸에(refreshTable) + if (pendingRefresh) setTimeout(function () { + if (pendingRefresh && !textSaver.anyDirty()) refreshTable().catch(function (err) { showToast(err.message, "error"); }); + }, 0); + }, + onClear: function (ta) { clearSaveFailed(ta.parentElement); }, + onFail: function (ta, err) { markSaveFailed(ta.parentElement, err); }, + }); + function saveText(ta) { return textSaver.flush(ta); } + // 글 칸 연결 — 처음 한 번 + 표를 그 자리에서 다시 그린 뒤 새 칸에(refreshTable). 되살린 초안 수를 돌려준다. function bindTexts(root) { + let restored = 0, conflict = 0; root.querySelectorAll("textarea.pj-goal-text").forEach(function (ta) { if (ta.dataset.bound) return; ta.dataset.bound = "1"; - ta.dataset.saved = ta.value; + const r = textSaver.track(ta, ta.value); + if (r === "restored") restored++; + else if (r === "conflict") conflict++; fit(ta); - ta.addEventListener("input", function () { - fit(ta); - clearTimeout(pending.get(ta)); - pending.set(ta, setTimeout(function () { saveText(ta); }, 800)); - }); - ta.addEventListener("blur", function () { saveText(ta); }); + ta.addEventListener("input", function () { fit(ta); textSaver.queue(ta); }); + ta.addEventListener("blur", function () { textSaver.flush(ta).catch(function () {}); }); }); + if (restored) showToast("저장되지 않았던 글 " + restored + "칸을 되살려 다시 저장합니다."); + else if (conflict) showToast("다른 곳에서 바뀐 칸 " + conflict + "개는 예전 초안을 되살리지 않았습니다."); } bindTexts(table); // 칸이 세로로 길어도(옆 칸 글이 길거나 세로 병합) 칸 아무 곳이나 누르면 그 칸 입력 — 커서는 글 끝(엑셀처럼). @@ -8287,17 +8494,10 @@ }); // 한 줄 안 칸들 높이는 표가 맞춘다 — 창 폭이 바뀌면 글 줄바꿈이 달라지니 다시 잰다. window.addEventListener("resize", fitAll); - window.addEventListener("beforeunload", function () { - pending.forEach(function (timer, ta) { - clearTimeout(timer); - if (ta.value === ta.dataset.saved) return; - try { - fetch(cellUrl(ta), { - method: "PUT", keepalive: true, headers: { "Content-Type": "application/json" }, - body: JSON.stringify({ body: ta.value }), - }); - } catch (_) {} - }); + // 페이지 떠남 — 글은 keepalive 로 한 번 더 보내고(보장 아님, 초안 백업이 남음), 실패·진행 중·숫자 미저장이면 이탈 경고 + window.addEventListener("beforeunload", function (e) { + textSaver.onBeforeUnload(e); + numSaver.onBeforeUnload(e); }); // ── 머리 — 매출 단위 · 연도 삭제 ── @@ -8332,11 +8532,14 @@ const name = await prompt("새 업무 영역 이름", ""); if (name == null || !String(name).trim()) return; const n = table.querySelectorAll(".pj-goal-area").length; - try { - await api("POST", "/project/api/goals/" + year + "/areas", - { name: String(name).trim(), color: colors.length ? colors[n % colors.length] : "" }); - await refreshTable(); - } catch (e) { showToast("추가 실패: " + e.message, "error"); } + await withStruct(async function () { + try { + await flushTexts(); // 저장 못 한 글이 있으면 영역을 만들지 않는다(글은 그대로) + await api("POST", "/project/api/goals/" + year + "/areas", + { name: String(name).trim(), color: colors.length ? colors[n % colors.length] : "" }); + await refreshTable(); + } catch (e) { showToast("추가 실패: " + e.message, "error"); } + }); }); // ── 영역 색 고르기 — 팝업은 body 에(화면 배율 밖) ── @@ -8382,39 +8585,66 @@ const t = node && node.querySelector(sel); return t ? t.textContent.trim() : ""; } - // 저장 안 된 글이 있으면 먼저 저장(구조 변경·병합 전에 — 병합은 서버가 DB 의 글을 모은다) - function flushTexts() { return Promise.all(Array.from(pending.keys()).map(saveText)); } + // 저장 안 된 글(대기·진행 중·실패했던 칸)을 먼저 저장 — 구조 변경·병합 전에(병합은 서버가 DB 의 글을 모은다). + // 하나라도 실패하면 reject → 부른 쪽은 구조 요청·표 교체를 하지 않는다(글은 그대로). + function flushTexts() { return textSaver.flushAll(); } + // 구조 작업(영역·줄 추가/삭제/이동, 병합/해제)은 한 번에 하나씩 — 앞 작업의 다시 그리기가 끝난 뒤 다음 작업 + let structChain = Promise.resolve(); + function withStruct(fn) { + const p = structChain.then(fn, fn); + structChain = p.then(function () {}, function () {}); + return p; + } + function editingNames() { return !!table.querySelector("[data-goal-edit].is-editing"); } // ── 구조가 바뀐 뒤(줄·영역 추가/삭제/이동, 병합/해제) 페이지를 새로고침하지 않고 업무 영역 부분만 서버에서 다시 받아 // 그 자리에서 바꿔 끼운다 — 새로고침 때 저장된 열 너비가 늦게 적용돼 표가 줄었다 늘어나거나 깜박이던 것을 없앤다. // 애니메이션: 지운 줄은 흐려지며 사라지고(opts.removed), 남은 줄은 예전 자리에서 새 자리로 미끄러지고(FLIP), // 새 줄은 위에서 내려오며 잠깐 강조, 병합한 칸은 테두리 강조(opts.flash = {row, month}). 동작 줄이기 설정이면 애니메이션 없이. - // 받아 오기에 실패하면 예전처럼 새로고침. + // 받아 오기에 실패하면 예전처럼 새로고침(저장 안 된 글이 없을 때만). + // 글 보호: ① 시작 전에 저장 안 된 글을 저장 — 실패하면 throw(표는 그대로, 글 유지) + // ② 받아 오는 사이에 새로 입력한 글이 있으면 저장 후 다시 받는다(바꿔 끼우기 직전 검사는 동기 — 그 사이 입력 불가) + // ③ 계속 입력 중이면 바꿔 끼우지 않고 pendingRefresh — 저장이 끝나면 다시 그린다. const GOAL_ANIM_MS = 280; async function refreshTable(opts) { opts = opts || {}; await flushTexts(); const reduce = !Element.prototype.animate || (window.matchMedia && window.matchMedia("(prefers-reduced-motion: reduce)").matches); - if (opts.removed && opts.removed.length && !reduce) { - await Promise.all(opts.removed.map(function (tr) { - return tr.animate([{ opacity: 1 }, { opacity: 0 }], { duration: 180, easing: "ease-in", fill: "forwards" }) - .finished.catch(function () {}); - })); + let fresh = null, anims = []; + const busy = function () { return textSaver.anyDirty() || editingNames(); }; + for (let tries = 0; ; tries++) { + fresh = null; + try { + const res = await fetch(location.href, { credentials: "same-origin", cache: "no-store" }); + if (res.ok) fresh = new DOMParser().parseFromString(await res.text(), "text/html").getElementById("pj-goal-table"); + } catch (_) { fresh = null; } + if (!busy() && opts.removed && opts.removed.length && !reduce && !anims.length) { + anims = opts.removed.map(function (tr) { + return tr.animate([{ opacity: 1 }, { opacity: 0 }], { duration: 180, easing: "ease-in", fill: "forwards" }); + }); + await Promise.all(anims.map(function (a) { return a.finished.catch(function () {}); })); + } + if (!busy()) break; + anims.forEach(function (a) { try { a.cancel(); } catch (_) {} }); + anims = []; + if (tries >= 2) { + pendingRefresh = true; + showToast("입력 중인 칸이 있어 표를 아직 다시 그리지 않았습니다 — 저장되면 다시 그립니다."); + return; + } + await flushTexts(); // 받는 동안 새로 입력한 글 — 저장 실패면 throw(표는 그대로) } + if (!fresh) { reloadKeepScroll(); return; } + pendingRefresh = false; const before = new Map(); table.querySelectorAll("tbody.pj-goal-area > tr[data-row-id]").forEach(function (tr) { before.set(tr.dataset.rowId, tr.getBoundingClientRect().top); }); - let fresh = null; - try { - const res = await fetch(location.href, { credentials: "same-origin", cache: "no-store" }); - if (res.ok) fresh = new DOMParser().parseFromString(await res.text(), "text/html").getElementById("pj-goal-table"); - } catch (_) { fresh = null; } - if (!fresh) { reloadKeepScroll(); return; } clearMergeSel(); table.querySelectorAll("tbody.pj-goal-area").forEach(function (t) { t.remove(); }); fresh.querySelectorAll("tbody.pj-goal-area").forEach(function (t) { table.appendChild(document.importNode(t, true)); }); + textSaver.prune(); applyColW(); QUARTERS.forEach(function (q) { applyFold(q, false); }); bindTexts(table); @@ -8446,11 +8676,16 @@ } async function goalAct(act, tbody, pt) { const areaId = tbody.dataset.areaId; + if (act === "area-color") { + openColorPop(pt, areaId, tbody.dataset.color || "", tbody); + return; + } + return withStruct(function () { return goalStructAct(act, tbody, areaId); }); + } + async function goalStructAct(act, tbody, areaId) { try { - if (act === "area-color") { - openColorPop(pt, areaId, tbody.dataset.color || "", tbody); - return; - } else if (act === "area-up" || act === "area-down") { + await flushTexts(); // 저장 못 한 글이 있으면 구조를 바꾸지 않는다(throw → 아래 catch, 글 유지) + if (act === "area-up" || act === "area-down") { await api("POST", "/project/api/goals/areas/" + areaId + "/move", { direction: act === "area-up" ? -1 : 1 }); } else if (act === "area-del") { const name = textOf(tbody, ".pj-goal-area-text"); @@ -8480,12 +8715,15 @@ items.push(null, { label: "영역 삭제", danger: true, icon: menuIcon("delete"), onClick: go("area-del") }); return items; } + function openAreaMenu(th, x, y, opts) { + showContextMenu(x, y, areaMenuItems(th.closest("tbody"), { x: x, y: y }), + Object.assign({ label: textOf(th, ".pj-goal-area-text") + " 구역 메뉴" }, opts || {})); + } table.addEventListener("contextmenu", function (e) { const th = e.target.closest("th.pj-goal-area-name"); if (!th || !table.contains(th) || e.target.closest(".is-editing")) return; e.preventDefault(); - const pt = { x: e.clientX, y: e.clientY }; - showContextMenu(e.clientX, e.clientY, areaMenuItems(th.closest("tbody"), pt)); + openAreaMenu(th, e.clientX, e.clientY); }); // ── 줄(항목 칸) 추가·삭제 — 항목 칸·연간 칸 우클릭 메뉴가 쓴다. 한 일이 있으면 true. @@ -8521,11 +8759,14 @@ function rowMenuItems(top, bottom, canDelete, opts) { opts = opts || {}; const run = function (fn) { - return async function () { - try { - const r = await fn(); - if (r) await refreshTable(r === true ? {} : r); - } catch (err) { showToast("처리 실패: " + err.message, "error"); } + return function () { + return withStruct(async function () { + try { + await flushTexts(); // 저장 못 한 글이 있으면 줄 작업을 하지 않는다(글 유지) + const r = await fn(); + if (r) await refreshTable(r === true ? {} : r); + } catch (err) { showToast("처리 실패: " + err.message, "error"); } + }); }; }; const items = [ @@ -8557,15 +8798,42 @@ } return items; } + function openRowLabelMenu(th, x, y, opts) { + const tr = th.closest("tr"); + // 2열 = 항목 칸 밖에 따로 추가(묶음의 맨 위·맨 아래 기준), 묶인 칸이면 "항목 칸 나누기"도 + const grouped = (th.rowSpan || 1) > 1; + showContextMenu(x, y, rowMenuItems(tr, labelGroupBottom(tr), true, + { splitRow: grouped ? tr : null, move: grouped ? null : tr }), + Object.assign({ label: (textOf(th, ".pj-goal-row-text") || "이름 없는") + " 줄 메뉴" }, opts || {})); + } table.addEventListener("contextmenu", function (e) { const th = e.target.closest("th.pj-goal-row-label"); if (!th || !table.contains(th) || e.target.closest(".is-editing")) return; e.preventDefault(); - const tr = th.closest("tr"); - // 2열 = 항목 칸 밖에 따로 추가(묶음의 맨 위·맨 아래 기준), 묶인 칸이면 "항목 칸 나누기"도 - const grouped = (th.rowSpan || 1) > 1; - showContextMenu(e.clientX, e.clientY, rowMenuItems(tr, labelGroupBottom(tr), true, - { splitRow: grouped ? tr : null, move: grouped ? null : tr })); + openRowLabelMenu(th, e.clientX, e.clientY); + }); + // ⋮ 메뉴 버튼(구역·항목 칸) — 우클릭과 같은 메뉴를 마우스·키보드(Tab → Enter/Space)·터치로. 닫으면 버튼으로 포커스 복귀. + // 표를 다시 그려도(refreshTable) 위임이라 새 버튼에 그대로 먹는다. + table.addEventListener("click", function (e) { + const btn = e.target.closest(".pj-goal-menu-btn"); + if (!btn || !table.contains(btn)) return; + e.preventDefault(); + e.stopPropagation(); + // 열린 메뉴를 같은 버튼으로 다시 누르면 닫기(마우스는 mousedown 에서 이미 닫혔으니 방금 닫힌 것으로 판단) + if (btn.getAttribute("aria-expanded") === "true") { closeContextMenu({ focus: true }); return; } + if (Date.now() - (btn._pjMenuClosedAt || 0) < 300) return; + const th = btn.closest("th"); + const r = btn.getBoundingClientRect(); + const opts = { + returnFocus: btn, focusFirst: e.detail === 0, // detail 0 = 키보드(Enter/Space)로 누름 + onClose: function (how) { + btn.setAttribute("aria-expanded", "false"); + if (how.target && btn.contains(how.target)) btn._pjMenuClosedAt = Date.now(); // 이 버튼을 눌러 닫음 + }, + }; + btn.setAttribute("aria-expanded", "true"); + if (btn.dataset.goalMenu === "area") openAreaMenu(th, r.left, r.bottom + 4, opts); + else openRowLabelMenu(th, r.left, r.bottom + 4, opts); }); // 3열(연간 칸) 우클릭에도 줄 추가·삭제 — 추가한 줄은 같은 항목 칸(2열) 안에 들어간다(sameLabel, 016). // 병합 메뉴가 있으면(014) 그 메뉴에 붙이고, 없으면 여기서 @@ -8638,6 +8906,12 @@ const span = e.target.closest("[data-goal-edit]"); if (span) startNameEdit(span); }); + // 키보드 — 이름 칸에 Tab 으로 와서 Enter·F2 = 이름 수정(수정 중 Enter 는 startNameEdit 이 먼저 받아 preventDefault) + table.addEventListener("keydown", function (e) { + const span = e.target.closest && e.target.closest("[data-goal-edit]"); + if (!span || span.isContentEditable || e.defaultPrevented || isImeEnter(e)) return; + if (e.key === "Enter" || e.key === "F2") { e.preventDefault(); startNameEdit(span); } + }); table.addEventListener("paste", function (e) { const span = e.target.closest && e.target.closest("[data-goal-edit].is-editing"); if (!span) return; @@ -8714,25 +8988,24 @@ return; } const rows = s.tbody.rows; - try { - await flushTexts(); - const res = await api("POST", "/project/api/goals/areas/" + s.tbody.dataset.areaId + "/merge", { - row_from: rows[s.r0].dataset.rowId, row_to: rows[s.r1].dataset.rowId, col_from: cols[0], col_to: cols[cols.length - 1], - }); - await refreshTable({ flash: { row: res.row_id, month: res.start } }); - } catch (err) { showToast("병합 실패: " + err.message, "error"); } + const req = { row_from: rows[s.r0].dataset.rowId, row_to: rows[s.r1].dataset.rowId, col_from: cols[0], col_to: cols[cols.length - 1] }; + return withStruct(async function () { + try { + await flushTexts(); // 서버가 DB 글을 모으므로 먼저 저장 — 실패면 병합하지 않는다(글 유지) + const res = await api("POST", "/project/api/goals/areas/" + s.tbody.dataset.areaId + "/merge", req); + await refreshTable({ flash: { row: res.row_id, month: res.start } }); + } catch (err) { showToast("병합 실패: " + err.message, "error"); } + }); }; const unmerge = async function (cellsToSplit) { - try { - await flushTexts(); - let first = null; - for (const c of cellsToSplit) { - const row = c.td.closest("tr").dataset.rowId, month = c.td.dataset.month; - await api("DELETE", "/project/api/goals/rows/" + row + "/merge/" + month); - first = first || { row: row, month: month }; - } - await refreshTable({ flash: first }); - } catch (err) { showToast("병합 해제 실패: " + err.message, "error"); } + const targets = cellsToSplit.map(function (c) { return { row: c.td.closest("tr").dataset.rowId, month: c.td.dataset.month }; }); + return withStruct(async function () { + try { + await flushTexts(); + for (const t of targets) await api("DELETE", "/project/api/goals/rows/" + t.row + "/merge/" + t.month); + await refreshTable({ flash: targets[0] || null }); + } catch (err) { showToast("병합 해제 실패: " + err.message, "error"); } + }); }; // 고른 칸 내용 지우기(엑셀 Del) — 칸마다 바로 저장. 바로 직전 지우기는 Ctrl+Z 로 되돌린다(입력 중이 아닐 때). @@ -8744,16 +9017,16 @@ if (!tas.length) return; lastCleared = tas.map(function (ta) { return [ta, ta.value]; }); tas.forEach(function (ta) { ta.value = ""; fit(ta); }); - await Promise.all(tas.map(saveText)); - showToast(tas.length + "칸 내용을 지웠습니다 — Ctrl+Z 로 되돌리기"); + const rs = await Promise.allSettled(tas.map(saveText)); + if (rs.every(function (r) { return r.status === "fulfilled"; })) showToast(tas.length + "칸 내용을 지웠습니다 — Ctrl+Z 로 되돌리기"); }; const undoClear = async function () { const list = (lastCleared || []).filter(function (x) { return document.contains(x[0]); }); lastCleared = null; if (!list.length) return; list.forEach(function (x) { x[0].value = x[1]; fit(x[0]); }); - await Promise.all(list.map(function (x) { return saveText(x[0]); })); - showToast(list.length + "칸 내용을 되돌렸습니다"); + const rs = await Promise.allSettled(list.map(function (x) { return saveText(x[0]); })); + if (rs.every(function (r) { return r.status === "fulfilled"; })) showToast(list.length + "칸 내용을 되돌렸습니다"); }; const typing = function () { const a = document.activeElement; @@ -8844,90 +9117,156 @@ } } + // ── 회의록 숫자 칸 다시 그리기 — 서버가 새로 그린 화면에서 숫자 칸만 옮겨 온다(입력 중인 칸·저장 안 된 글·직접 입력 칸은 그대로). + // 매출 갱신 완료·금주 목표 저장 두 곳에서 부르므로 차례 번호로 늦게 도착한 옛 응답은 버린다(옛 비율이 다시 들어오지 않게). + // 이번주 실적 % 는 서버 문구를 그대로 쓰지 않고 실적(data-auto)만 받아 이 화면의 서버 확정 정량 목표(tr data-target-amount)로 + // 다시 계산한다(paintMeetWeek) — 목표 저장과 다시 그리기가 엇갈려도 지금 목표 기준. + let meetRepaintSeq = 0; + async function meetRepaint() { + const seq = ++meetRepaintSeq; + const res = await fetch(location.href, { credentials: "same-origin", cache: "no-store" }); + if (!res.ok) throw new Error("화면을 다시 읽지 못했습니다(" + res.status + ")"); + const doc = new DOMParser().parseFromString(await res.text(), "text/html"); + if (seq !== meetRepaintSeq) return false; // 더 나중에 시작한 다시 그리기가 있다 + const now = document.querySelectorAll(".pj-meet-kpi"), fresh = doc.querySelectorAll(".pj-meet-kpi"); + if (now.length === fresh.length) { + now.forEach(function (n, i) { + if (n.querySelector("input, textarea, select")) { + const a = n.querySelector(".pj-meet-sub-slot"), b = fresh[i].querySelector(".pj-meet-sub-slot"); + if (a && b) a.innerHTML = b.innerHTML; + return; + } + n.innerHTML = fresh[i].innerHTML; + const t = fresh[i].getAttribute("title"); + if (t) { n.dataset.tip = t; n.removeAttribute("title"); } + }); + } + document.querySelectorAll("#pj-meet-table tr[data-item]").forEach(function (tr) { + const ftr = doc.querySelector('#pj-meet-table tr[data-item="' + tr.dataset.item + '"]'); + if (!ftr) return; + const manual = !!tr.querySelector(".pj-meet-c-result input"); // 직접 입력 결과 — 달성률도 이 화면이 계산 + [".pj-meet-c-result", "[data-rate]"].forEach(function (sel) { + const a = tr.querySelector(sel), b = ftr.querySelector(sel); + if (!a || !b) return; + if (manual) return; + a.innerHTML = b.innerHTML; + }); + // 이번주 실적 — 실적 값만 옮기고 % 는 다시 계산. 정량 목표는 입력칸이 없을 때(보기 전용)만 서버 값으로. + const a = tr.querySelector(".pj-meet-week-slot"), b = ftr.querySelector(".pj-meet-week-slot"); + if (a && b) { + a.dataset.auto = b.dataset.auto || ""; + if (b.dataset.err) a.dataset.err = "1"; else delete a.dataset.err; + if (!tr.querySelector('input[data-field="target_amount"]')) tr.dataset.targetAmount = ftr.dataset.targetAmount || ""; + paintMeetWeek(tr); + } + }); + const box = el("pj-meet-sync"), fbox = doc.getElementById("pj-meet-sync"); + if (box && fbox) box.dataset.fresh = fbox.dataset.fresh || ""; // 서버가 기록한 마지막 갱신 성공 시각 + return true; + } + // 이번주 실적(쇼핑몰 연결 줄) — 실적(slot data-auto, 서버) ÷ 서버 확정 정량 목표(tr data-target). 목표 0·빈칸이면 % 없음, + // 실적 조회 실패(data-err)면 "미확인". + function paintMeetWeek(tr) { + const slot = tr && tr.querySelector(".pj-meet-week-slot"); + if (!slot) return; + if (slot.dataset.err) { + slot.innerHTML = '이번주 실적 미확인'; + return; + } + if (slot.dataset.auto == null || slot.dataset.auto === "") { slot.innerHTML = ""; return; } + const auto = Number(slot.dataset.auto); + const target = tr.dataset.targetAmount ? Number(tr.dataset.targetAmount) : 0; + const pane = el("pj-meet-pane"); + const wk = pane ? pane.dataset.week.slice(5).replace("-", "/") : ""; + const span = document.createElement("span"); + span.className = "pj-meet-week-auto"; + span.dataset.tip = "실적 모듈 " + (slot.dataset.name || "") + " 이번 주(" + wk + "~ 오늘까지) 매출" + + (target ? " · 정량 목표 " + target.toLocaleString("ko-KR") + "원 대비" : ""); + span.textContent = "이번주 실적 " + auto.toLocaleString("ko-KR") + (target ? " · " + Math.round(auto / target * 100) + "%" : ""); + slot.innerHTML = ""; + slot.appendChild(span); + } + // ── 회의록 매출 자료 갱신 — 주차를 열면 실적 모듈 [매출 업데이트](지난주 월요일 ~ 이번 주 오늘, 백그라운드)를 한 번 더 - // 돌리고, 끝나면 이 화면을 서버에서 다시 그려 숫자 칸만 바꿔 끼운다(입력 중인 칸·저장 안 된 글은 건드리지 않는다). - // 같은 주는 10분에 한 번만 자동(새로고침마다 쇼핑몰 API 를 부르지 않게). 다른 업데이트가 돌면 그게 끝나길 기다려 다시 그림. - // 상태 줄·[매출 갱신] 버튼은 2026-10-01 요청으로 뺐다(#pj-meet-sync 는 기간만 가진 숨은 요소) — 있으면 쓰고 없으면 조용히. + // 돌리고, 끝나면 숫자 칸만 다시 그린다(meetRepaint). 같은 주는 10분에 한 번만 자동(새로고침마다 쇼핑몰 API 를 부르지 않게). + // 이미 다른 매출 업데이트가 돌면 그 작업에 합류해 끝나길 기다리고, 그 작업이 이 주 기간을 다 덮지 못했으면 한 번 더 부른다. + // 화면: 정상이면 아무것도 보이지 않는다(2026-10-01 요청 — 큰 상태 줄 없음). 실패·일부 쇼핑몰 실패·권한 없음일 때만 작은 + // 안내(#pj-meet-sync) — 실패한 쇼핑몰 이름, 서버가 기록한 마지막 갱신 성공 시각(data-fresh, 가장 오래된 쇼핑몰 기준), [다시 시도]. + // 권한 없음(data-can="0")은 서버가 미리 알려 주므로 API 를 부르지 않는다. 브라우저 시각은 10분 제한 계산에만 쓰고 보여 주지 않는다. function initMeetingSync(pane) { const box = el("pj-meet-sync"); if (!box) return; - const text = box.querySelector(".pj-meet-sync-text"); // 상태 줄(없을 수 있음) + const text = box.querySelector(".pj-meet-sync-text"); const btn = el("pj-meet-sync-btn"); const KEY = "pj_meet_sync:" + pane.dataset.week; const THROTTLE_MS = 10 * 60 * 1000; let running = false; - function say(msg, cls) { - if (!text) return; - text.textContent = msg; - box.classList.remove("is-running", "is-done", "is-warn"); - if (cls) box.classList.add(cls); + function show(kind, msg, retry) { + box.hidden = false; + box.dataset.state = kind; + if (text) text.textContent = msg; + if (btn) btn.hidden = !retry; } - function hhmm(d) { return String(d.getHours()).padStart(2, "0") + ":" + String(d.getMinutes()).padStart(2, "0"); } - // 서버가 새로 그린 화면에서 숫자 칸만 옮겨 온다(입력칸이 있는 카드·칸은 안내 문구만) - async function repaint() { - const res = await fetch(location.href, { credentials: "same-origin" }); - if (!res.ok) throw new Error("화면을 다시 읽지 못했습니다(" + res.status + ")"); - const doc = new DOMParser().parseFromString(await res.text(), "text/html"); - const swap = function (sel) { - const now = document.querySelectorAll(sel), fresh = doc.querySelectorAll(sel); - if (now.length !== fresh.length) return false; - now.forEach(function (n, i) { - if (n.querySelector("input, textarea, select")) { - const a = n.querySelector(".pj-meet-sub-slot"), b = fresh[i].querySelector(".pj-meet-sub-slot"); - if (a && b) a.innerHTML = b.innerHTML; - return; - } - n.innerHTML = fresh[i].innerHTML; - }); - return true; - }; - swap(".pj-meet-kpi"); - document.querySelectorAll("#pj-meet-table tr[data-item]").forEach(function (tr) { - const ftr = doc.querySelector('#pj-meet-table tr[data-item="' + tr.dataset.item + '"]'); - if (!ftr) return; - [".pj-meet-c-result", "[data-rate]", ".pj-meet-week-slot"].forEach(function (sel) { - const a = tr.querySelector(sel), b = ftr.querySelector(sel); - if (!a || !b) return; - if (a.querySelector("input:focus")) return; // 결과를 입력하는 중 - if (a.querySelector("input") && b.querySelector("input")) return; // 직접 입력 칸은 그대로 - a.innerHTML = b.innerHTML; - }); - }); + function hide() { box.hidden = true; delete box.dataset.state; } + function freshText() { + const f = box.dataset.fresh; + return f ? " · 저장된 실적의 마지막 갱신 성공 " + f + "(가장 오래된 쇼핑몰 기준)" : " · 저장된 실적의 갱신 성공 기록 없음"; + } + function report(rec) { + if (!rec || rec.state === "ok") { hide(); return; } + if (rec.state === "partial") show("partial", "일부 쇼핑몰 매출을 새로 받지 못했습니다: " + rec.bad.join(", ") + freshText(), true); + else if (rec.state === "noperm") show("noperm", "실적 모듈 권한이 없어 쇼핑몰 매출을 새로 받지 않고 저장된 실적으로 보여 줍니다" + freshText(), false); + else show("error", "쇼핑몰 매출 갱신 실패 — " + (rec.msg || "알 수 없는 오류") + freshText(), true); + } + function remember(rec) { try { sessionStorage.setItem(KEY, JSON.stringify(rec)); } catch (_) {} } + function recall() { + try { + const raw = sessionStorage.getItem(KEY); + if (!raw) return null; + if (/^\d+$/.test(raw)) return { at: Number(raw), state: "ok" }; // 예전 기록(시각만) + return JSON.parse(raw); + } catch (_) { return null; } + } + if (box.dataset.can !== "1") { report({ state: "noperm" }); return; } + async function waitJob(job) { + while (!job.finished) { + await new Promise(function (ok) { setTimeout(ok, 1000); }); + job = (await api("GET", "/performance/api/sync/jobs/" + encodeURIComponent(job.id))).job; + } + return job; } async function run(force) { if (running) return; if (!force) { - try { - const last = Number(sessionStorage.getItem(KEY) || 0); - if (Date.now() - last < THROTTLE_MS) { say("매출 자료 갱신됨 " + hhmm(new Date(last)) + " (10분 안에는 다시 받지 않음)", "is-done"); return; } - } catch (_) {} + const last = recall(); + if (last && (last.state === "noperm" || Date.now() - (last.at || 0) < THROTTLE_MS)) { report(last); return; } } running = true; if (btn) btn.disabled = true; - say("쇼핑몰에서 매출 자료를 다시 받는 중…", "is-running"); + if (force) show("running", "쇼핑몰 매출을 다시 받는 중…", false); // 직접 누른 재시도만 진행 표시 + let rec; try { - let r = await api("POST", "/performance/api/sync", { from: box.dataset.from, to: box.dataset.to, background: true }); - const joined = r.joined; - let job = r.job; - while (!job.finished) { - const o = job.overall || {}; - say((joined ? "다른 매출 업데이트 진행 중 — " : "매출 자료 다시 받는 중 — ") + (o.finished || 0) + "/" + (o.shops || 0) + - " 쇼핑몰" + (o.items ? " · 받은 자료 " + Number(o.items).toLocaleString("ko-KR") + "건" : ""), "is-running"); - await new Promise(function (ok) { setTimeout(ok, 1000); }); - job = (await api("GET", "/performance/api/sync/jobs/" + encodeURIComponent(job.id))).job; + const want = { from: box.dataset.from, to: box.dataset.to }; + let r = await api("POST", "/performance/api/sync", { from: want.from, to: want.to, background: true }); + let job = await waitJob(r.job); + // 다른 사람이 돌리던 업데이트에 합류했는데 그 기간이 이 주를 다 덮지 못하면 이 주 기간으로 한 번 더 + if (r.joined && !(job.from && job.to && job.from <= want.from && job.to >= want.to)) { + r = await api("POST", "/performance/api/sync", { from: want.from, to: want.to, background: true }); + job = await waitJob(r.job); } - await repaint(); - try { sessionStorage.setItem(KEY, String(Date.now())); } catch (_) {} - const bad = (job.shops || []).filter(function (s) { return s.state === "error"; }) + await meetRepaint(); + const bad = (job.shops || []).filter(function (s) { return s.active !== false && (s.state === "error" || s.state === "cancelled"); }) .map(function (s) { return s.name + (s.label ? "(" + s.label + ")" : ""); }); - say("매출 자료 갱신 " + hhmm(new Date()) + " · " + Number((job.overall || {}).upserted || 0).toLocaleString("ko-KR") + "건 반영" + - (bad.length ? " · 실패: " + bad.join(", ") : ""), bad.length ? "is-warn" : "is-done"); + rec = job.error ? { state: "error", msg: job.error } : bad.length ? { state: "partial", bad: bad } : { state: "ok" }; } catch (e) { - say(e.status === 403 ? "실적 권한이 없어 저장된 실적으로 보여 줍니다" : "매출 갱신 실패: " + e.message, "is-warn"); + rec = e.status === 403 ? { state: "noperm" } : { state: "error", msg: e.message }; } finally { running = false; if (btn) btn.disabled = false; } + rec.at = Date.now(); + remember(rec); + report(rec); } if (btn) btn.addEventListener("click", function () { run(true); }); run(false); @@ -8981,18 +9320,56 @@ const meetingUrl = "/project/api/goals/meetings/" + week; function itemUrl(id) { return "/project/api/goals/meeting-items/" + id; } - // ── 머리 — 금주 목표·참석자·메모 ── + // ── 금액 칸(금주 목표 · 줄 정량 목표 · 지난주 결과) — Enter·칸 떠남에 저장(createFieldSaver: 같은 칸 요청 차례대로). + // 서버 확정값(원 정수)을 쉼표 표기로 칸에 넣는 건 요청 뒤 입력이 그대로일 때만 — 그 사이 다시 입력한 초안은 덮지 않는다. + // 실패해도 입력값은 그대로(빨간 테두리), Esc = 저장된 값으로. 비율(달성률·이번주 실적 %)은 서버 확정값으로 바로 다시 계산. + // 금주 목표 저장 뒤 머리 숫자는 페이지 새로고침 없이 숫자 칸만 다시 그린다(meetRepaint — 다른 칸의 저장 안 된 글 보존). const tgt = el("pj-meet-target"); - if (tgt) { - tgt.dataset.saved = tgt.value; - tgt.addEventListener("keydown", function (e) { if (e.key === "Enter") { e.preventDefault(); tgt.blur(); } }); - tgt.addEventListener("change", async function () { - try { - await api("PUT", meetingUrl, { week_target: tgt.value }); - reloadKeepScroll(); // 달성률·필요 매출 문구를 서버 계산으로 다시 - } catch (e) { tgt.value = tgt.dataset.saved; showToast("저장 실패: " + e.message, "error"); } + const amtSaver = createFieldSaver({ + read: function (inp) { return inp.value; }, + write: function (inp, v) { inp.value = v; }, + unload: "warn", + send: function (inp, v, o) { + if (inp === tgt) return api("PUT", meetingUrl, { week_target: v }, o); + const tr = inp.closest("tr"), body = {}; + body[inp.dataset.field] = v; + return api("PUT", itemUrl(inp.dataset.target === "prev" ? tr.dataset.prev : tr.dataset.item), body, o); + }, + onSaved: function (inp, v, res, same) { + const cell = inp.closest("td") || inp.closest(".pj-meet-kpi"); + clearSaveFailed(cell); + flashSaved(cell); + let confirmed; + if (inp === tgt) { + confirmed = res && Object.prototype.hasOwnProperty.call(res, "week_target") ? res.week_target : undefined; + meetRepaint().catch(function () {}); // 금주 현재 실적의 "목표의 %"·필요 매출 — 서버 계산으로 + } else { + const tr = inp.closest("tr"); + confirmed = res.item[inp.dataset.field]; + if (inp.dataset.field === "result_amount") paintRate(tr, res.item.result_amount); + if (inp.dataset.field === "target_amount") { + tr.dataset.targetAmount = confirmed == null ? "" : String(confirmed); + paintMeetWeek(tr); + } + } + if (!same || confirmed === undefined) return undefined; // 요청 뒤 새로 입력 중 — 그 초안을 그대로 + inp.value = won(confirmed); + return inp.value; + }, + onFail: function (inp, err) { markSaveFailed(inp.closest("td") || inp.closest(".pj-meet-kpi"), err); }, + }); + function bindAmount(inp) { + amtSaver.track(inp, inp.value); + inp.addEventListener("focus", function () { inp.select(); }); + inp.addEventListener("keydown", function (e) { + if (isImeEnter(e)) return; + if (e.key === "Enter") { e.preventDefault(); if (document.activeElement === inp) inp.blur(); else amtSaver.flush(inp).catch(function () {}); } + else if (e.key === "Escape") { inp.value = amtSaver.savedOf(inp); inp.blur(); } }); + inp.addEventListener("change", function () { amtSaver.flush(inp).catch(function () {}); }); + inp.addEventListener("blur", function () { amtSaver.flush(inp).catch(function () {}); }); } + if (tgt) bindAmount(tgt); // ── 참석자 — 전체 멤버에서 고르기(칩 + 고르기 창, 창은 body 에). 바뀔 때마다 이메일(예전 글자는 그대로)을 쉼표로 이어 저장 ── const attBox = el("pj-meet-attend"); if (attBox && attBox.dataset.edit) { @@ -9094,52 +9471,49 @@ }); } - // ── 글 칸(이번주 할 일·메모) — 멈추면 저장 ── - const pending = new Map(); // textarea → {timer, save} - function queue(ta, save) { - const p = pending.get(ta); - if (p) clearTimeout(p.timer); - pending.set(ta, { timer: setTimeout(function () { flush(ta); }, 800), save: save }); - } - async function flush(ta) { - const p = pending.get(ta); - if (!p) return; - clearTimeout(p.timer); - pending.delete(ta); - if (ta.value === ta.dataset.saved) return; - try { await p.save(ta.value); ta.dataset.saved = ta.value; flashSaved(ta.closest("td") || ta); } - catch (e) { showToast("저장 실패: " + e.message, "error"); } - } - function flushAll() { return Promise.all(Array.from(pending.keys()).map(flush)); } + // ── 글 칸(이번주 할 일·메모) — 0.8초 멈춤·칸 떠남에 저장(createFieldSaver). + // 보낸 값만 저장됨으로 기록하고, 같은 칸 요청은 차례대로(진행 중에 새로 쓴 글은 뒤이어 저장). 실패해도 글은 그대로 두고 + // 다음 입력·칸 떠남·줄 작업 전에 다시 보낸다. 초안은 localStorage(pj_draft:meet:…)에도 — 페이지가 닫혀도 다음에 되살린다. const notes = el("pj-meet-notes"); - if (notes) { - notes.dataset.saved = notes.value; - const save = function (v) { return api("PUT", meetingUrl, { notes: v }); }; - notes.addEventListener("input", function () { fit(notes); queue(notes, save); }); - notes.addEventListener("blur", function () { flush(notes); }); - fit(notes); - } - if (table) table.querySelectorAll("textarea.pj-meet-text").forEach(function (ta) { - ta.dataset.saved = ta.value; - const id = ta.closest("tr").dataset.item; - const save = function (v) { return api("PUT", itemUrl(id), { content: v }); }; - fit(ta); - ta.addEventListener("input", function () { fit(ta); queue(ta, save); }); - ta.addEventListener("blur", function () { flush(ta); }); + const textSaver = createFieldSaver({ + read: function (ta) { return ta.value; }, + write: function (ta, v) { ta.value = v; fit(ta); }, + send: function (ta, v, o) { + return ta === notes ? api("PUT", meetingUrl, { notes: v }, o) + : api("PUT", itemUrl(ta.closest("tr").dataset.item), { content: v }, o); + }, + draftKey: function (ta) { + return ta === notes ? "meet:notes:" + week : "meet:item:" + ta.closest("tr").dataset.item + ":content"; + }, + onSaved: function (ta) { const n = ta.closest("td") || ta; clearSaveFailed(n); flashSaved(n); }, + onClear: function (ta) { clearSaveFailed(ta.closest("td") || ta); }, + onFail: function (ta, err) { markSaveFailed(ta.closest("td") || ta, err); }, }); - window.addEventListener("resize", function () { document.querySelectorAll("textarea.pj-meet-text, #pj-meet-notes").forEach(fit); }); - window.addEventListener("beforeunload", function () { - pending.forEach(function (p, ta) { - clearTimeout(p.timer); - if (ta.value === ta.dataset.saved) return; - const isNotes = ta.id === "pj-meet-notes"; - try { - fetch(isNotes ? meetingUrl : itemUrl(ta.closest("tr").dataset.item), { - method: "PUT", keepalive: true, headers: { "Content-Type": "application/json" }, - body: JSON.stringify(isNotes ? { notes: ta.value } : { content: ta.value }), - }); - } catch (_) {} + function flushAll() { + return Promise.allSettled([textSaver.flushAll(), amtSaver.flushAll()]).then(function (rs) { + const bad = rs.find(function (r) { return r.status === "rejected"; }); + if (bad) throw bad.reason; + return true; }); + } + let restored = 0, conflict = 0; + function bindText(ta) { + const r = textSaver.track(ta, ta.value); + if (r === "restored") restored++; + else if (r === "conflict") conflict++; + fit(ta); + ta.addEventListener("input", function () { fit(ta); textSaver.queue(ta); }); + ta.addEventListener("blur", function () { textSaver.flush(ta).catch(function () {}); }); + } + if (notes) bindText(notes); + if (table) table.querySelectorAll("textarea.pj-meet-text").forEach(bindText); + if (restored) showToast("저장되지 않았던 글 " + restored + "칸을 되살려 다시 저장합니다."); + else if (conflict) showToast("다른 곳에서 바뀐 칸 " + conflict + "개는 예전 초안을 되살리지 않았습니다."); + window.addEventListener("resize", function () { document.querySelectorAll("textarea.pj-meet-text, #pj-meet-notes").forEach(fit); }); + // 페이지 떠남 — 글은 keepalive 로 한 번 더 보내고(보장 아님, 초안 백업이 남음), 실패·진행 중·금액 미저장이면 이탈 경고 + window.addEventListener("beforeunload", function (e) { + textSaver.onBeforeUnload(e); + amtSaver.onBeforeUnload(e); }); if (!table) return; @@ -9161,28 +9535,8 @@ const r = Math.round(result / target * 1000) / 10; td.innerHTML = '' + r.toLocaleString("ko-KR") + "%"; } - // ── 금액 칸 — 이번주 목표 금액(이 줄) · 지난주 결과(지난 회의록 줄) ── - table.querySelectorAll("input.pj-meet-amount").forEach(function (inp) { - inp.dataset.saved = inp.value; - inp.addEventListener("focus", function () { inp.select(); }); - inp.addEventListener("keydown", function (e) { - if (e.key === "Enter") { e.preventDefault(); inp.blur(); } - else if (e.key === "Escape") { inp.value = inp.dataset.saved; inp.blur(); } - }); - inp.addEventListener("change", async function () { - const tr = inp.closest("tr"); - const toPrev = inp.dataset.target === "prev"; - const body = {}; - body[inp.dataset.field] = inp.value; - try { - const res = await api("PUT", itemUrl(toPrev ? tr.dataset.prev : tr.dataset.item), body); - inp.value = won(res.item[inp.dataset.field]); - inp.dataset.saved = inp.value; - if (toPrev) paintRate(tr, res.item.result_amount); - flashSaved(inp.closest("td")); - } catch (e) { inp.value = inp.dataset.saved; showToast("저장 실패: " + e.message, "error"); } - }); - }); + // ── 금액 칸 — 이번주 정량 목표(이 줄) · 지난주 결과(7일 전 주 회의록의 같은 줄) — amtSaver(위) ── + table.querySelectorAll("input.pj-meet-amount").forEach(bindAmount); // ── 평가(지난주 줄) ── table.querySelectorAll("select.pj-meet-eval").forEach(function (selEl) { selEl.addEventListener("change", async function () { @@ -9234,8 +9588,10 @@ }); // ── 줄 메뉴(⋯ · 항목 우클릭) — 위/아래 줄 추가 · 순서 · 쇼핑몰 연결 · 삭제 ── + // 줄 작업 뒤엔 새로고침 — 그 전에 저장 안 된 칸(대기·진행 중·실패)을 저장하고, 실패하면 작업 자체를 하지 않는다(초안 유지) async function run(fn) { try { + await flushAll(); if (!(await fn())) return; await flushAll(); reloadKeepScroll(); diff --git a/docs/PROJECT_MODULE.md b/docs/PROJECT_MODULE.md index 9c06d7a..74df709 100644 --- a/docs/PROJECT_MODULE.md +++ b/docs/PROJECT_MODULE.md @@ -301,6 +301,11 @@ docker exec -i postgres-db psql -U postgres -d project_db \ < scripts/sql/project_db_015_goal_rect_merges_meetings.sql docker exec -i postgres-db psql -U postgres -d project_db \ < scripts/sql/project_db_016_goal_row_label_groups.sql +docker exec -i postgres-db psql -U postgres -d project_db \ + < scripts/sql/project_db_017_goal_quarters.sql +# 018 = 주간 회의록 줄 연결키(line_key) — 적용 전 백업, 적용·확인 방법은 6-9-3 +docker exec -i postgres-db psql -U postgres -d project_db \ + < scripts/sql/project_db_018_meeting_line_keys.sql # 4) 재배포 (git pull 후 반드시 --build) cd /opt/www/main && docker compose up -d --build web @@ -516,9 +521,11 @@ description 을 항상 HTML로 취급하기 때문). 두 번 실행하면 이중 `PUT|DELETE /api/goals/areas/{id}` · `POST /api/goals/areas/{id}/move` `{direction:-1|1}` · `POST /api/goals/areas/{id}/rows` `{label, ref_row_id?, place?: above|below}`(기준 줄 위/아래, 없으면 맨 끝) · `PUT|DELETE /api/goals/rows/{id}` · `POST /api/goals/rows/{id}/move` · `PUT /api/goals/rows/{id}/cells/{month}` `{body}`. 013 미적용 503, 없는 대상 404, 입력 오류 400(`_goal_call`). -- 화면 동작(`initGoals`): 숫자 칸은 Enter/칸 떠남에 저장(Esc 취소), 글 칸은 0.8초 멈춤·칸 떠남·페이지 떠남(keepalive)에 저장, - 저장되면 칸 테두리가 잠깐 초록. 영역/줄 추가·이름·순서·삭제는 저장 뒤 새로고침(스크롤 위치 sessionStorage 로 되살림), - 영역 색은 팝업(body 에 붙임)에서 바로 바뀜. 목표 테이블은 live-version 트리거에 넣지 않았다(입력 중 새로고침 방지). +- 화면 동작(`initGoals`): 숫자 칸은 Enter/칸 떠남에 저장(Esc = 저장된 값으로), 글 칸은 0.8초 멈춤·칸 떠남에 저장, + 저장되면 칸 테두리가 잠깐 초록, 실패하면 빨간 테두리(입력값 유지). 저장은 공용 `createFieldSaver`(6-9-3 — 같은 칸 요청 직렬화, + 보낸 값만 저장됨으로, 실패 시 초안 유지·localStorage 초안 백업, 페이지 떠남 보호). 영역/줄 추가·순서·삭제·병합은 먼저 저장 안 된 + 글을 저장하고(실패하면 작업 중단) 그 자리에서 다시 그림(`refreshTable`), 영역 색은 팝업(body 에 붙임)에서 바로 바뀜. + 목표 테이블은 live-version 트리거에 넣지 않았다(입력 중 새로고침 방지). - 추후: 매출 실적을 실적 모듈(`performance_db`)에서 월별로 자동으로 채우기. ### 6-9-0. 1~4분기 칸 (마이그레이션 017, 2026-10-01 — 상·하반기 대신) @@ -563,7 +570,12 @@ description 을 항상 HTML로 취급하기 때문). 두 번 실행하면 이중 - **영역·줄 이름 바로 수정**(관리자) — 이름(`[data-goal-edit="area|row"]`)을 누르면 contenteditable(`startNameEdit`) — Enter·칸 떠남 = 저장, Esc = 취소, 붙여넣기는 글자만. 영역 이름 빈 값은 되돌림(서버도 400), 줄 이름은 빈 값 허용(빈 줄 이름은 마우스를 올리면 "줄 이름" 자리 표시). 예전 ✎(prompt) 버튼은 없앴다. 색·순서·줄 추가·삭제는 우클릭 메뉴(아래). -- **구역·항목 칸 메뉴 = 우클릭**(2026-10-01) — 마우스 오버 도구 막대(색·↑·↓·+·×)는 뺐다(옆 칸으로 갈 때 걸리거나 고정되는 문제). +- **구역·항목 칸 메뉴 = 우클릭 + ⋮ 버튼**(2026-10-01) — 마우스 오버 도구 막대(색·↑·↓·+·×)는 뺐다(옆 칸으로 갈 때 걸리거나 고정되는 문제). + 대신(점검 UX 8) 칸 오른쪽 위 작은 ⋮ 버튼(`.pj-goal-menu-btn`, 관리자만, `data-goal-menu="area|row"`) — absolute 라 자리를 차지하지 않고 + 평소 투명, 칸에 마우스·포커스가 오면 보임, 터치 화면(`hover: none`)은 늘 옅게(0.7). 우클릭과 **같은 메뉴**(`openAreaMenu`·`openRowLabelMenu`). + 접근성: 버튼 `aria-label="{이름} 구역 메뉴|줄 메뉴"`·`aria-haspopup="menu"`·`aria-expanded`, Tab → Enter/Space 로 열면 첫 항목 포커스, + 메뉴(`showContextMenu` 공용, `role=menu`/`menuitem`) 안 ↑↓·Home·End·Enter, Esc·Tab = 닫고 버튼으로 포커스 복귀, 같은 버튼 다시 누르면 닫힘. + 이름 칸(`[data-goal-edit]`)도 `tabindex=0` — Enter·F2 = 이름 수정(한글 조합 중 Enter 무시). 1열(구역 칸) 우클릭(`areaMenuItems` → `goalAct`): 색 바꾸기(색 창은 우클릭한 자리, 현재 색은 `tbody[data-color]`) · 위로 · 아래로 (맨 위·맨 아래면 없음) · 줄 추가(구역 맨 아래) · 영역 삭제. 2열(항목 칸) 우클릭(`rowMenuItems`): 위/아래에 줄 추가 · **위로 · 아래로** (묶이지 않은 칸만) · 항목 칸 나누기(묶인 칸) · 줄 삭제. 이름은 눌러서 바로 수정(그대로). @@ -646,19 +658,34 @@ description 을 항상 HTML로 취급하기 때문). 두 번 실행하면 이중 금주 현재 실적. 실적·누적·결과는 **실적 모듈 `performance_store.daily_amounts`(대시보드 총매출과 같은 값, 매출 집계 쇼핑몰)** 에서 읽기만 한다 — 실적 모듈이 없거나 오류면 빈칸("직접 입력" 안내), 회의록은 그대로 동작. 숫자는 **한 줄 막대**(`.pj-meet-kpibar`, 칸 9개·값 15px, 좁은 화면 1300px 이하 두 줄) — 긴 설명은 말풍선(`title`). - - 표 머리 "지난주 리뷰 (MM/DD ~ MM/DD)" = 지난주 월~일(`prev_week`·`prev_week_end`). + **실적을 알 수 없으면 0 원이 아니라 "⚠ 미확인"**(6-9-3 — `head.perf_state`·`head.unknown`), 그 값에 기대는 달성 %·주당 필요 매출도 미확인. + 실적 칸 말풍선 = 쇼핑몰별 마지막 갱신 성공 시각(실적 모듈 `perf_connection_status.last_success_sync_at`, `head.fresh_tip`). + - 표 머리 "지난주 리뷰 (MM/DD ~ MM/DD)" = 지난주 월~일(`prev_week`·`prev_week_end`) — **줄의 지난주 칸·결과·달성률·머리 전주 목표도 정확히 이 + 주(7일 전) 회의록만**(그 주 회의록이 없으면 머리에 "— 이 주 회의록 없음", 줄은 "지난주(MM/DD~) 회의록 없음", 회의록은 있는데 그 줄이 없으면 + "지난주 회의록에 없는 줄"). 예전엔 몇 주 전 회의록 줄이 지난주 날짜 아래 보였다(점검 버그 5). - 첫 회의록 기본 줄 마케팅 "메타"(예전 "메타(숫자)" — 017 이 그 이름 줄만 "메타"로 바꿈). - **{월}월 계획**(`router._month_plan`, `.pj-meet-plan`, 머리 왼쪽 `.pj-meet-headleft` 안 — 제목 줄 아래·달력 왼쪽): 연간 목표 표의 그 달 열 글을 업무 영역별 작은 카드로 (영역 색, `항목: 글`, 빈 칸·글 없는 영역은 뺌). 가로 병합 칸(예: 9~10월)에 적은 글도 그 달 계획으로 보이고 범위를 오른쪽에 작게, 세로 병합은 한 번만, 묶인 줄(016 `label_cont`)은 묶음 항목 이름. 목표 표가 없으면(013 미적용) 칸 자체를 숨김, 읽기만. - **줄**(구역 = 목표 표 업무 영역, 표의 구역 칸 rowspan): 항목 | **이번주 할 일·행사** | **정량 목표**(원, 예전 이름 "목표 금액") ‖ 지난주 리뷰: 지난주 할 일 | - 지난주 목표 | **결과** | 달성률 | **평가**(— · 완료 · 일부 · 미달). 지난주 칸 = 이 줄의 `carry_from`(지난 회의록 같은 줄). + 지난주 목표 | **결과** | 달성률 | **평가**(— · 완료 · 일부 · 미달). 지난주 칸 = **7일 전 주 회의록에서 같은 연결키(`line_key`, 018)의 줄** + (예전 `carry_from` 은 이력으로만 — 6-9-3). 결과는 그 줄이 **쇼핑몰 연결**(`marketplace_code`)이면 실적 모듈의 그 주(지난 회의록 주 월~일) 그 쇼핑몰 매출 **자동**("자동" 표시), 아니면 직접 입력 — **지난 회의록 줄의 `result_amount`·`status` 에 저장**(그 주 결과는 그 주 줄에 남는다). 달성률은 저장 즉시 화면 계산. 지난 회의록 주가 아직 시작 전이면 "진행 전"(0 으로 보이지 않게), 연결한 쇼핑몰이 실적 모듈에서 사용 중이 아니면(사용 OFF·없는 코드) "실적 미사용" 표시 + 직접 입력. 자동 결과 말풍선 = 쇼핑몰·기간, 0 이면 "그 기간 실적 없음 — [매출 업데이트]" 안내. - 쇼핑몰 연결 줄은 정량 목표 아래에 **이번주 실적**(이 주 월요일~오늘, 목표 대비 %)도 보인다. - - **매출 자료 갱신**(`initMeetingSync`, **화면 표시 없음** — 2026-10-01 상태 줄·[매출 갱신] 버튼은 요청으로 뺐고 `#pj-meet-sync` 는 기간만 가진 숨은 요소): 주차를 열면 실적 모듈 `POST /performance/api/sync {from: 지난주 월요일, to: 이번 주 일요일·오늘 중 이른 날, background: true}` 로 쇼핑몰에서 매출을 한 번 더 받고(진행 n/m 쇼핑몰·받은 자료), 끝나면 이 화면을 서버에서 다시 받아 **숫자 칸만** 바꿔 끼운다(머리 카드·자동 결과·달성률·이번주 실적 — 입력 중인 칸·직접 입력 결과 칸·저장 안 된 글은 그대로). 같은 주는 브라우저별 10분에 한 번만 자동(sessionStorage `pj_meet_sync:{월요일}` — 줄 추가 등으로 새로고침해도 다시 부르지 않음), [매출 갱신] 버튼은 언제나. 이미 다른 매출 업데이트가 돌면 그 작업이 끝나길 기다린다. 실적 권한이 없으면 저장된 실적으로 보여 준다는 안내, 실패한 쇼핑몰은 이름·상태. 지난주가 아직 오지 않은 주(미래)는 갱신 줄이 없다. + 쇼핑몰 연결 줄은 정량 목표 아래에 **이번주 실적**(이 주 월요일~오늘, 목표 대비 %)도 보인다 — % 는 화면이 실적(`slot data-auto`)과 + **서버 확정 정량 목표**(`tr data-target-amount`)로 계산(`paintMeetWeek`): 목표 저장 즉시 다시 계산(100→200 이면 100%→50%), 목표 0·빈칸이면 + % 없음, 실적 조회 실패면 "이번주 실적 미확인", 저장 실패면 확정값 그대로. 다시 그리기(`meetRepaint`)는 실적 값만 옮겨 와 같은 방식으로 계산하고 + 차례 번호(`meetRepaintSeq`)로 늦게 온 옛 화면을 버린다 — 목표 저장과 엇갈려도 옛 비율이 들어오지 않는다(점검 버그 7). + - **매출 자료 갱신**(`initMeetingSync`, **정상이면 화면 표시 없음** — 2026-10-01 상태 줄·[매출 갱신] 버튼은 요청으로 뺐다. 점검 UX 9 로 + 실패·일부 실패·권한 없음일 때만 숫자 막대 아래 한 줄 안내 `#pj-meet-sync.pj-meet-syncnote`(`data-state=error|partial|noperm|running`) + + [다시 시도] — 실패한 쇼핑몰 이름(상태), **서버가 기록한** 마지막 갱신 성공 시각(`data-fresh` = 매출 집계 쇼핑몰 중 가장 오래된 성공 시각, + 다시 그릴 때 서버 값으로 바뀜. 브라우저 시각은 10분 제한 계산에만 쓰고 보여 주지 않음). 기록 `sessionStorage pj_meet_sync:{월요일}` = + `{at, state: ok|partial|error|noperm, bad}` — 일부 실패를 성공으로 기록하지 않고, 10분 안 다시 열면 부르지 않되 그 상태 안내는 유지. + 실적 모듈 권한은 서버가 미리 알려 줘(`can_sync` → `data-can`) 권한이 없으면 API 를 부르지 않고 "권한이 없어 저장된 실적" 설명, 그래도 403 이면 + noperm 으로 기억해 그 세션엔 다시 부르지 않음. 다른 업데이트에 합류(`joined`)했는데 그 작업 기간이 이 주 기간을 다 덮지 못하면 이 주 기간으로 + 한 번 더. 아래는 예전 설명(동작은 같음): 주차를 열면 실적 모듈 `POST /performance/api/sync {from: 지난주 월요일, to: 이번 주 일요일·오늘 중 이른 날, background: true}` 로 쇼핑몰에서 매출을 한 번 더 받고(진행 n/m 쇼핑몰·받은 자료), 끝나면 이 화면을 서버에서 다시 받아 **숫자 칸만** 바꿔 끼운다(머리 카드·자동 결과·달성률·이번주 실적 — 입력 중인 칸·직접 입력 결과 칸·저장 안 된 글은 그대로). 같은 주는 브라우저별 10분에 한 번만 자동(sessionStorage `pj_meet_sync:{월요일}` — 줄 추가 등으로 새로고침해도 다시 부르지 않음), [매출 갱신] 버튼은 언제나. 이미 다른 매출 업데이트가 돌면 그 작업이 끝나길 기다린다. 실적 권한이 없으면 저장된 실적으로 보여 준다는 안내, 실패한 쇼핑몰은 이름·상태. 지난주가 아직 오지 않은 주(미래)는 갱신 줄이 없다. - **참석자 = 전체 멤버에서 고르기**(2026-10-01): 칩(사진·이름, × = 빼기) + [참석자] 고르기 창(찾기·전원 선택·모두 해제·체크) — 후보는 `project` 모듈 권한 보유 등록 사용자(`router._meet_members`, 좌측 전체 멤버와 같음). 저장은 이메일을 쉼표로 이어 그대로 `goal_meetings.attendees`(최대 3000자), 예전 자유 입력 글자는 칩으로 남는다(`_parse_attendees`). 바뀔 때마다 바로 저장. @@ -666,20 +693,77 @@ description 을 항상 HTML로 취급하기 때문). 두 번 실행하면 이중 - 데이터: `goal_meetings(week_start 월요일 PK, week_target 원, attendees, notes)` · `goal_meeting_items(week_start FK CASCADE, section, section_color, label, content, target_amount, result_amount, status '', done, partial, miss, marketplace_code, carry_from FK SET NULL, sort_order)`. 금액은 **원 정수** — 입력은 `1,200,000`·`120만`·`1.5억`·`3천만`·`1억2천만` 다 된다(`store.validate_meeting_amount`). -- **만들기**(관리자, `POST /api/goals/meetings/{월요일} {year}`, GET 에서 자동 생성 안 함): 앞선 가장 가까운 회의록이 있으면 그 줄(구역·이름· - 색·쇼핑몰 연결·순서)을 글 없이 이어받고 `carry_from` 연결, 없으면 그 해 목표 표 업무 영역마다 **기본 양식 줄**(`store.MEETING_TEMPLATE` — +- **만들기**(관리자, `POST /api/goals/meetings/{월요일} {year}`, GET 에서 자동 생성 안 함): 줄이 있는 앞선 가장 가까운 회의록, 없으면 **뒤에 있는 + 가장 가까운 회의록**(다음 주를 먼저 만든 경우)의 줄(구역·이름·색·쇼핑몰 연결·순서)을 글 없이 이어받고 **원본 줄의 연결키(`line_key`)를 그대로** + (앞선 원본이면 `carry_from` 도 이력으로 기록), 둘 다 없으면 그 해 목표 표 업무 영역마다 **기본 양식 줄**(`store.MEETING_TEMPLATE` — 상품1~5 / 메타·구글·네이버·기타.신규 / 내용1~5 / 신규 인플루언서·콜라보·쿠팡·네이버·gs·토스·애터미·해외·오프라인·기타, 없는 구역은 빈 줄 하나). **유통** 구역 줄 이름으로 쇼핑몰 연결 추측(`store.guess_meeting_market`: 쿠팡·네이버/스마트스토어·gs·토스·11번가·카페24/자사몰· 롯데·지마켓·카카오·오늘의집 — 마케팅의 "네이버"는 광고라 연결 안 함). 줄 추가 때도 같은 추측. -- 편집(관리자, 칸별 즉시 저장 — 목표 표와 같은 권한): 글 0.8초 멈춤·칸 떠남·페이지 떠남(keepalive), 금액 Enter·칸 떠남(서버 표기로 바꿈), - 금주 목표 저장 뒤엔 머리 숫자를 서버 계산으로 다시(새로고침). **항목 우클릭·⋯ 메뉴**: 위/아래에 줄 추가 · 위로/아래로(같은 구역 안) · +- 편집(관리자, 칸별 즉시 저장 — 목표 표와 같은 권한, 공용 `createFieldSaver` 6-9-3): 글 0.8초 멈춤·칸 떠남, 금액 Enter·칸 떠남(서버 확정값을 + 쉼표 표기로 — 요청 뒤 다시 입력 중이면 그 초안 유지), 금주 목표 저장(`PUT` 응답에 확정 `week_target`) 뒤엔 **새로고침 없이** 머리 숫자만 서버 + 계산으로 다시(`meetRepaint` — 다른 칸의 저장 안 된 글 보존). 줄 작업(추가·순서·쇼핑몰 연결·삭제)은 먼저 저장 안 된 칸을 저장하고, 실패하면 + 작업하지 않는다(초안 유지). **항목 우클릭·⋯ 메뉴**: 위/아래에 줄 추가 · 위로/아래로(같은 구역 안) · 쇼핑몰 연결(결과 자동)…(연결 안 함 + 실적 모듈 사용 중 쇼핑몰, 현재 값 체크) · 줄 삭제. 구역 칸 + = 그 구역 끝에 줄, [+ 구역 추가]. - 줄 이름은 눌러서 그 자리에서 수정. 회의록 삭제 = 그 주 줄 전부 삭제, 다음 주 회의록의 지난주 칸은 빈다(carry_from NULL). + 줄 이름은 눌러서 그 자리에서 수정. 회의록 삭제 = 그 주 줄 전부 삭제, 다음 주 회의록의 지난주 칸은 빈다 — 그 주를 다시 만들면 같은 연결키로 + 다시 이어진다(새 회의록이라 글은 비어 있음, 018). - API(관리자, 조회는 `project` 권한자): `GET /api/goals/meetings/{월요일}?year=&month=`(화면과 같은 계산) · `POST|PUT|DELETE /api/goals/meetings/{월요일}`(PUT `{week_target, attendees, notes}`) · `POST /api/goals/meetings/{월요일}/items {section, label?, ref_item_id?, place?}` · `PUT|DELETE /api/goals/meeting-items/{id}`(PUT `{label, content, target_amount, result_amount, status, marketplace_code}`) · `POST /api/goals/meeting-items/{id}/move {direction}`. 015 미적용 503, 월요일 아님·금액 형식 400. +### 6-9-3. 저장 안전장치 · 지난주 연결 · 실적 미확인 (2026-10-01 점검 반영 — `docs/reviews/GOALS_MEETINGS_REVIEW_2026-10-01.md`, 마이그레이션 018) + +**칸별 자동 저장 `createFieldSaver`**(project.js 공용, 목표 표 글·숫자 + 회의록 글·메모·금액·금주 목표 — 버그 1·2·3) +- 칸마다 `{saved, chain, busy, timer, failed}`. **saved = 성공한 요청에 실어 보낸 값**만(응답 때 바뀌어 있는 화면 값을 저장됨으로 보지 않음). +- **같은 칸 요청은 직렬화** — 앞 요청이 끝나야 다음 요청을 보내므로 서버에 닿는 쓰기 순서 = 보낸 순서(늦은 옛 요청이 최신 값을 덮지 못함, 응답만 + 버리는 방식이 아님). 다음 요청은 보낼 때의 최신 초안을 읽어 진행 중에 새로 쓴 값도 뒤이어 저장. 앞 요청이 없으면 그 자리에서(동기) 보낸다. +- 응답 반영: 서버 표기(쉼표·원 정수)는 **요청 뒤 초안이 그대로일 때만** 칸에 넣는다(`onSaved(..., same)`). 실패하면 초안·dirty 유지 + + 빨간 테두리(`is-save-failed`, 말풍선) + 토스트 — 다음 입력·칸 떠남·Enter·`flushAll` 이 다시 보낸다. 숫자 Esc = 저장된 값. +- `flushAll()` = 대기 타이머 + 진행 중 요청 + 실패했던 칸까지 기다리고 하나라도 실패하면 reject. 목표 표 구조 작업(영역·줄 추가/이동/삭제, + 병합/해제)과 회의록 줄 작업은 **먼저 flushAll — 실패하면 구조 요청·표 교체를 하지 않는다**. 목표 표 구조 작업은 한 번에 하나(`withStruct`). +- 목표 표 `refreshTable`: 시작 전 flush(실패 = throw), 표를 받는 사이 새로 입력한 글이 있으면 저장 후 다시 받기(최대 3번, 바꿔 끼우기 직전 검사는 + 동기라 그 사이 입력 불가), 계속 입력 중이면 바꿔 끼우지 않고 `pendingRefresh` — 저장이 끝나면 다시 그린다. 이름 고치는 중이어도 기다림. +- **초안 백업** — 글 칸은 입력할 때마다 `localStorage pj_draft:goal:{줄}:{칸}` · `pj_draft:meet:item:{id}:content` · `pj_draft:meet:notes:{월요일}` = + `{base(서버에 저장된 값), draft, at}`, 저장되면 지움(14일 지난 것은 열 때 정리). 다시 열 때 **서버 값 = base 면 되살려 다시 저장**, 서버 값이 바뀌었으면 + (다른 사람·다른 창) 되살리지 않고 안내. +- **페이지 떠남**(`beforeunload`): 진행 중 요청이 없는 dirty 글 칸은 `keepalive` PUT 으로 한 번 더 보낸다 — **브라우저가 끝까지 보낸다는 보장은 없어서** + 초안 백업이 함께 남는다(keepalive 도 같은 칸 줄에 들어가 순서가 섞이지 않음). 실패했던 칸·진행 중 요청이 있는 칸·Enter 전 숫자 칸이 있으면 브라우저 + 이탈 경고. 저장이 다 끝났으면 경고 없음. + +**지난주 연결 — 연결키 `goal_meeting_items.line_key`(마이그레이션 018, 버그 4·5)** +- 왜 키인가: 이름(label) 비교는 같은 이름 줄(기타·빈 이름)·다른 구역 같은 이름(마케팅/유통 "네이버")·이름 변경에서 다른 줄 결과가 섞인다. + `carry_from`(앞선 회의록 줄 id)은 만들 때 한 방향으로만 생겨 역순 생성·앞 주 삭제/재생성(ON DELETE SET NULL)에서 끊긴다. + 키는 **회의록을 만들 때 원본 줄 키를 그대로 이어받고 새 줄은 새 키** → "지난주" = `week_start − 7` 회의록의 같은 키 줄(UNIQUE `(week_start, line_key)`), + 생성 순서·이름 변경·순서 이동과 무관, 한 줄이 두 줄에 붙지 않는다. +- 만들기 원본: 앞선 가장 가까운(줄 있는) 회의록 → 없으면 뒤의 가장 가까운 회의록 → 둘 다 없으면 양식(새 키). +- **018 적용 전**에도 코드는 동작 — `_meeting_keys` 가 칸 유무를 보고, 없으면 `carry_from` 을 쓰되 **가리키는 줄이 정확히 7일 전 주일 때만** 지난주로 + (버그 5 는 적용 전에도 고침, 역순 생성 연결(버그 4)은 018 필요). 018 은 `line_key` 기본값(랜덤 키)을 두어 **코드 배포 전에 적용해도** 예전 코드의 + 줄 추가가 실패하지 않는다(그 줄은 연결 없이 새 키). +- **018 의 기존 데이터 채우기(자동 복구 범위)**: `carry_from` 사슬을 따라 같은 키(뿌리 = 사슬 맨 앞 줄, `md5('goal_meeting_item:'||id)::uuid` 라 다시 돌려도 + 같은 키). → 같은 원본(예: 9/14)에서 이어받은 9/28(먼저 만듦)·9/21(나중에 만듦) 줄은 자동으로 다시 이어진다. 이름 바꾼 줄도 사슬이면 이어진다. + **자동으로 잇지 않는 것**: `carry_from` 이 없는 줄(첫 회의록 양식 줄·줄 추가·앞 주 삭제로 끊긴 줄) — 이름이 같아도 붙이지 않는다. + 예: 9/21·9/28 을 둘 다 앞선 회의록 없이 양식으로 만들었다면 연결 안 됨. 이런 쌍은 `scripts/sql/project_db_018b_meeting_line_link_candidates.sql` + (**조회만**)로 "정확히 7일 차이 + 같은 구역·같은 이름이 양쪽 주에 각각 한 줄씩만 + 아직 연결 안 됨" 후보를 보고, 사람이 확인한 쌍만 그 파일 안 + 주석의 UPDATE 로 따로 잇는다(운영 적용은 별도 승인·백업 후). 한 주 안 같은 키(정상 데이터엔 없음)는 순서가 뒤인 줄에 새 키. +- 적용(운영은 백업·승인 후, 여러 번 돌려도 안전): + ```bash + docker exec -i postgres-db psql -U postgres -d project_db < scripts/sql/project_db_018_meeting_line_keys.sql + docker exec -i postgres-db psql -U postgres -d project_db -c \ + "SELECT count(*) AS total, count(line_key) AS keyed FROM goal_meeting_items;" # total = keyed + docker exec -i postgres-db psql -U postgres -d project_db < scripts/sql/project_db_018b_meeting_line_link_candidates.sql # 후보 조회만 + ``` + 적용 전 확인(조회만): `SELECT week_start, count(*) FILTER (WHERE carry_from IS NULL) AS no_link, count(*) FROM goal_meeting_items GROUP BY 1 ORDER BY 1;` + +**실적 미확인(버그 6)** — `router._MeetingPerf`: `state` = `off`(실적 모듈 미연결) · `error`(쇼핑몰 목록 조회 실패) · `empty`(매출 집계 쇼핑몰 없음) · `ok`. +조회 실패한 값은 None + `head.unknown`(`mtd`·`prev_result`·`week_result`, 기간마다 따로 → 부분 실패), 화면 "⚠ 미확인", 그 값에 기대는 달성 %·주당 필요 +매출도 계산하지 않음. 정상 조회 0건만 0원. 목록 장애면 쇼핑몰 연결 줄 결과 = 미확인(직접 입력 칸으로 바꾸지 않음, "실적 미사용"으로 오인하지 않음), +연결 배지 "· 미확인". `head.perf` 는 예전 뜻(실적 모듈 연결 여부) 그대로 — 갱신 상자·"연결되지 않아" 문구 조건. 회의록 열기·직접 입력은 그대로. + +**테스트** — `tests/test_project_module.py`(`test_meeting_prev_week_links`: 역순 생성·같은 이름·다른 구역 같은 이름·이름 변경·이동·새 줄·삭제/재생성· +건너뛴 주, 018 적용/미적용 둘 다 · `test_meeting_perf_unknown_vs_zero`: 미연결·목록 장애·매출 장애·부분 실패·정상 0·집계 쇼핑몰 없음), +`tests/test_meeting_line_keys_migration.py`(018 백필·멱등·UNIQUE — 임시 스키마, 끝에 ROLLBACK), `tests/js/goals_meeting_ui.test.js` +(`python tests/js/render_goals.py` 후 — 버그 1·2·3·5·6·7, UX 8·9, 분기 접기·열 너비·스크롤·참석자 회귀). + ## 6-10. 권한·저장 안전장치 (2026-09-30 점검 반영, 새 마이그레이션·환경변수 없음) **권한 공통 기준 — `access.py`** (라우터·마감 알림이 같은 규칙) diff --git a/scripts/sql/project_db_018_meeting_line_keys.sql b/scripts/sql/project_db_018_meeting_line_keys.sql new file mode 100644 index 0000000..b6e4baf --- /dev/null +++ b/scripts/sql/project_db_018_meeting_line_keys.sql @@ -0,0 +1,87 @@ +-- ===================================================================== +-- project_db 마이그레이션 018 — 주간 회의록 줄 연결키(line_key) +-- ===================================================================== +-- 멱등(idempotent). DROP TABLE/TRUNCATE/DELETE 없음 — 새 칸을 더하고 비어 있는 칸만 채운다. +-- +-- 왜: 예전엔 "지난주" 줄을 carry_from(만들 때 앞선 회의록 줄 id)으로만 찾았다. +-- · 다음 주(9/28)를 먼저 만들고 앞 주(9/21)를 나중에 만들면 9/28 의 carry_from 이 비어 지난주 리뷰가 빠졌다. +-- · 한 주를 건너뛰면 몇 주 전 줄이 "지난주"로 보였다. +-- · 앞 주를 지웠다 다시 만들면 ON DELETE SET NULL 로 끊긴 연결이 돌아오지 않았다. +-- 이제: 줄마다 연결키(line_key) — 회의록을 만들 때 원본 줄의 키를 그대로 이어받고, 새 줄은 새 키. +-- "지난주" = 정확히 7일 전 주 회의록에서 같은 키의 줄(생성 순서·이름 변경·순서 이동과 무관). +-- +-- ① line_key UUID 칸 추가 +-- ② 기존 줄 채우기 — carry_from 사슬을 따라 같은 키를 준다(사슬의 맨 앞 줄 = 키의 뿌리). +-- carry_from 이 없는 줄(첫 회의록·줄 추가·앞 주 삭제로 끊긴 줄)은 자기만의 새 키 → 다른 줄에 붙지 않는다. +-- 이름(label)으로 추정해 붙이지 않는다(같은 이름 줄·이름 변경 때 다른 줄 결과가 섞일 수 있어서). +-- → 9/14 를 원본으로 9/28 을 먼저, 9/21 을 나중에 만든 경우 두 주 줄이 모두 9/14 키를 받아 9/28 ↔ 9/21 이 다시 연결된다. +-- → 둘 다 양식(앞선 회의록 없음)으로 만든 주끼리는 사슬이 없어 연결되지 않는다(자동 복구 범위 밖, +-- project_db_018b_meeting_line_link_candidates.sql 로 후보를 조회해 사람이 확인 후 따로 연결). +-- ③ 한 주 안에서 키가 겹치면(정상 데이터에선 없음) 순서가 뒤인 줄에 새 키 — 한 줄이 두 줄에 붙지 않게 +-- ④ 기본값(예전 코드 호환) + NOT NULL + (week_start, line_key) UNIQUE +-- +-- 미적용이어도 회의록은 동작한다 — "지난주"는 carry_from 이 정확히 7일 전 주 줄을 가리킬 때만 보인다(역순 생성 연결은 안 됨). +-- +-- 적용 (1회, 여러 번 돌려도 안전, 적용 전 project_db 백업): +-- docker exec -i postgres-db psql -U postgres -d project_db \ +-- < scripts/sql/project_db_018_meeting_line_keys.sql +-- 확인: +-- docker exec -i postgres-db psql -U postgres -d project_db -c \ +-- "SELECT count(*) AS total, count(line_key) AS keyed FROM goal_meeting_items;" +-- ===================================================================== + +\set ON_ERROR_STOP on +\connect project_db + +BEGIN; + +-- ① 칸 ───────────────────────────────────────────────────────────── +ALTER TABLE goal_meeting_items ADD COLUMN IF NOT EXISTS line_key UUID; + +-- ② 기존 줄 — carry_from 사슬로 키 채우기(비어 있는 줄만). id 는 만든 순서라 자식 id > 부모 id(순환 방지). +-- 뿌리 키 = md5('goal_meeting_item:' || 뿌리 id) — 같은 데이터면 몇 번 돌려도 같은 키. +WITH RECURSIVE chain AS ( + SELECT i.id, COALESCE(i.line_key, md5('goal_meeting_item:' || i.id)::uuid) AS k + FROM goal_meeting_items i + WHERE i.line_key IS NOT NULL + OR i.carry_from IS NULL + OR NOT EXISTS (SELECT 1 FROM goal_meeting_items p WHERE p.id = i.carry_from) + UNION ALL + SELECT c.id, chain.k + FROM goal_meeting_items c + JOIN chain ON c.carry_from = chain.id + WHERE c.line_key IS NULL AND c.id > chain.id +) +UPDATE goal_meeting_items g + SET line_key = chain.k + FROM chain + WHERE g.id = chain.id AND g.line_key IS NULL; + +-- 사슬에 닿지 않은 줄(있을 수 없지만 안전하게) — 자기만의 키 +UPDATE goal_meeting_items SET line_key = md5('goal_meeting_item:' || id)::uuid WHERE line_key IS NULL; + +-- ③ 한 주 안 같은 키 — 순서가 뒤인 줄만 새 키(줄 내용·carry_from 은 그대로) +UPDATE goal_meeting_items g + SET line_key = md5('goal_meeting_item:dup:' || g.id)::uuid + FROM (SELECT id, row_number() OVER (PARTITION BY week_start, line_key ORDER BY sort_order, id) AS rn + FROM goal_meeting_items) d + WHERE g.id = d.id AND d.rn > 1; + +-- ④ 제약 ─────────────────────────────────────────────────────────── +-- 기본값 — 018 을 먼저 적용하고 코드를 나중에 배포해도(예전 코드는 line_key 를 넣지 않음) 줄 추가가 실패하지 않게 새 키. +-- 새 코드는 늘 키를 직접 넣는다(이어받기 = 원본 키, 새 줄 = 새 키). pgcrypto 없이 되는 식(md5 → uuid). +ALTER TABLE goal_meeting_items ALTER COLUMN line_key SET DEFAULT md5(random()::text || clock_timestamp()::text)::uuid; +ALTER TABLE goal_meeting_items ALTER COLUMN line_key SET NOT NULL; +CREATE UNIQUE INDEX IF NOT EXISTS uq_goal_meeting_items_week_key ON goal_meeting_items (week_start, line_key); +CREATE INDEX IF NOT EXISTS idx_goal_meeting_items_key ON goal_meeting_items (line_key); + +COMMENT ON COLUMN goal_meeting_items.line_key IS + '주가 바뀌어도 같은 줄을 가리키는 연결키 — 회의록을 만들 때 원본 줄 키를 이어받음. 지난주 = 7일 전 주의 같은 키 줄'; +COMMENT ON COLUMN goal_meeting_items.carry_from IS + '만들 때 이어받은 앞선 회의록 줄(이력). 화면의 지난주 연결은 line_key(018) 로 찾는다'; + +COMMIT; + +SELECT 'project_db 018 meeting line keys ready' AS status, + (SELECT count(*) FROM goal_meeting_items) AS items, + (SELECT count(*) FROM goal_meeting_items WHERE line_key IS NULL) AS missing_keys; diff --git a/scripts/sql/project_db_018b_meeting_line_link_candidates.sql b/scripts/sql/project_db_018b_meeting_line_link_candidates.sql new file mode 100644 index 0000000..57dd09f --- /dev/null +++ b/scripts/sql/project_db_018b_meeting_line_link_candidates.sql @@ -0,0 +1,45 @@ +-- ===================================================================== +-- project_db 018b — 주간 회의록 "지난주" 연결 후보 조회 (읽기 전용, 자동 적용 없음) +-- ===================================================================== +-- 018 은 carry_from 사슬이 있는 줄만 자동으로 이어 준다. 앞선 회의록 없이 양식으로 만든 주끼리 +-- (예: 9/28 을 먼저 양식으로 만들고 9/21 도 양식으로 만든 경우)는 사슬이 없어 연결되지 않는다. +-- 이 조회는 그런 주 쌍(정확히 7일 차이)에서 **구역+줄 이름이 양쪽 주에 각각 한 줄씩만 있는** 줄만 후보로 보여 준다. +-- 같은 구역에 같은 이름이 두 줄 이상이거나 이름이 빈 줄, 이미 연결된 줄은 후보에서 뺀다(추정 연결 금지). +-- +-- 실행(조회만): +-- docker exec -i postgres-db psql -U postgres -d project_db \ +-- < scripts/sql/project_db_018b_meeting_line_link_candidates.sql +-- +-- 후보를 사람이 확인한 뒤에만, 한 쌍씩 아래처럼 연결한다(다음 주 줄이 앞 주 줄의 키를 받음). 운영 적용은 별도 승인·백업 후. +-- BEGIN; +-- UPDATE goal_meeting_items SET line_key = (SELECT line_key FROM goal_meeting_items WHERE id = <앞 주 줄 id>) +-- WHERE id = <다음 주 줄 id> +-- AND NOT EXISTS (SELECT 1 FROM goal_meeting_items x +-- WHERE x.week_start = goal_meeting_items.week_start +-- AND x.line_key = (SELECT line_key FROM goal_meeting_items WHERE id = <앞 주 줄 id>)); +-- -- 다음 주 다음(+14일) 회의록이 그 줄을 예전 키로 이어받았다면 그 줄도 같은 키로 맞춰야 사슬이 이어진다 — 결과 확인 후 COMMIT +-- COMMIT; +-- ===================================================================== + +\set ON_ERROR_STOP on +\connect project_db + +WITH items AS ( + SELECT i.*, count(*) OVER (PARTITION BY i.week_start, i.section, i.label) AS same_name + FROM goal_meeting_items i + WHERE btrim(i.label) <> '' +), +pairs AS ( + SELECT p.week_start AS prev_week, n.week_start AS week, + n.section, n.label, p.id AS prev_item_id, n.id AS item_id + FROM items n + JOIN items p ON p.week_start = n.week_start - 7 AND p.section = n.section AND p.label = n.label + WHERE n.same_name = 1 AND p.same_name = 1 + AND n.line_key <> p.line_key + -- 이미 이 앞 주에 같은 키 줄이 있는 다음 주 줄(연결됨)은 빼고, 앞 주 줄이 다른 줄과 이미 이어진 것도 뺀다 + AND NOT EXISTS (SELECT 1 FROM goal_meeting_items x WHERE x.week_start = p.week_start AND x.line_key = n.line_key) + AND NOT EXISTS (SELECT 1 FROM goal_meeting_items y WHERE y.week_start = n.week_start AND y.line_key = p.line_key) +) +SELECT prev_week, week, section, label, prev_item_id, item_id + FROM pairs + ORDER BY week, section, label; diff --git a/tests/js/README.md b/tests/js/README.md index 8cf25bd..065e08b 100644 --- a/tests/js/README.md +++ b/tests/js/README.md @@ -13,3 +13,15 @@ node tests/js/box_calc_ui.test.js ``` 성공하면 마지막 줄에 `ALL PASS`, 실패하면 실패한 항목명이 출력되고 종료코드 1. + +# 연간 목표·주간 회의록 UI 테스트 (jsdom) + +`goals.html`·`goal_meeting.html` + `static/project.js` — 칸 저장 직렬화·늦은 응답·503·초안 보호·구조 변경 중단·이번주 실적 %· +실적 미확인 표시·⋮ 메뉴(키보드·터치 클릭)·매출 갱신 안내를 가짜 서버(지연·실패를 직접 만듦)로 검증한다. + +```bash +python tests/js/render_goals.py # → tests/js/.out/goals_*.html · meeting_*.html +node tests/js/goals_meeting_ui.test.js # jsdom 필요(npm install jsdom 또는 NODE_PATH) +``` + +실제 브라우저 레이아웃·입력기·터치 기기는 아니다(그건 헤드리스 크롬으로 따로 확인). diff --git a/tests/js/goals_meeting_ui.test.js b/tests/js/goals_meeting_ui.test.js new file mode 100644 index 0000000..7349091 --- /dev/null +++ b/tests/js/goals_meeting_ui.test.js @@ -0,0 +1,664 @@ +// 연간 목표(goals.html)·주간 회의록(goal_meeting.html) + static/project.js UI 회귀 테스트 — jsdom. +// 서버는 가짜(fetch 대체)로 두고 지연(deferred)·순서 역전·503·연속 입력을 직접 만든다. 실제 브라우저 레이아웃·입력기·터치 기기는 아니다. +// +// python tests/js/render_goals.py # 템플릿 렌더 → tests/js/.out/goals_*.html · meeting_*.html +// npm install jsdom # (최초 1회, 또는 NODE_PATH 로 jsdom 이 있는 node_modules 지정) +// node tests/js/goals_meeting_ui.test.js +// +// 성공하면 마지막 줄 ALL PASS, 실패하면 항목명과 종료코드 1. +const fs = require("fs"); +const path = require("path"); +const { JSDOM, VirtualConsole } = require("jsdom"); +const WATCHDOG = setTimeout(function () { console.log("TIMEOUT — 어딘가에서 멈춤"); process.exit(2); }, 180000); + +const ROOT = path.join(__dirname, "..", ".."); +const OUT = path.join(__dirname, ".out"); +const JS = fs.readFileSync(path.join(ROOT, "app", "static", "project.js"), "utf8"); +const PAGE = {}; +["goals_admin", "goals_ro", "meeting_admin", "meeting_err", "meeting_ro"].forEach(function (n) { + PAGE[n] = fs.readFileSync(path.join(OUT, n + ".html"), "utf8"); +}); +const GOALS_URL = "http://localhost/project/goals/2026"; +const MEET_URL = "http://localhost/project/goals/2026/meetings/9?week=2026-09-28"; + +const fails = []; +function check(name, cond, extra) { + if (cond) console.log("PASS " + name); + else { console.log("FAIL " + name + (extra !== undefined ? " → " + JSON.stringify(extra) : "")); fails.push(name); } +} +function deferred() { + let resolve, reject; + const p = new Promise(function (a, b) { resolve = a; reject = b; }); + return { promise: p, resolve: resolve, reject: reject }; +} +function settle(n) { + return new Promise(function (r) { let i = 0; (function spin() { if (i++ >= (n || 40)) return r(); setImmediate(spin); })(); }); +} +function wait(ms) { return new Promise(function (r) { setTimeout(r, ms); }); } +const unhandled = []; +process.on("unhandledRejection", function (e) { unhandled.push(String(e && e.message || e)); }); + +// env.route(method, re, fn(url, body, call)) — fn 이 {status, body, text} 또는 "NETWORK" 를 돌려준다(Promise 가능) +function makeEnv(html, url, opts) { + opts = opts || {}; + const vc = new VirtualConsole(); + const env = { calls: [], routes: [], navigations: 0, toasts: [], prompts: [], inflight: {}, maxInflight: {} }; + vc.on("jsdomError", function (e) { if (/navigation/i.test(String(e && e.message))) env.navigations++; }); + const dom = new JSDOM(html, { runScripts: "dangerously", pretendToBeVisual: true, url: url, virtualConsole: vc }); + const w = dom.window, d = w.document; + env.w = w; env.d = d; + w.__PJ_TEST__ = true; + w.console.error = function () {}; + w.scrollTo = function () {}; + w.HTMLCanvasElement.prototype.getContext = function () { return null; }; + w.erpConfirm = function () { return Promise.resolve(true); }; + w.erpPrompt = function (msg, def) { env.prompts.push(msg); return Promise.resolve(opts.promptAnswer != null ? opts.promptAnswer : "새 이름"); }; + w.erpAlert = function () {}; + if (opts.storage) Object.keys(opts.storage).forEach(function (k) { w.localStorage.setItem(k, opts.storage[k]); }); + if (opts.session) Object.keys(opts.session).forEach(function (k) { w.sessionStorage.setItem(k, opts.session[k]); }); + env.route = function (method, re, fn) { env.routes.unshift({ method: method, re: re, fn: fn }); }; + w.fetch = async function (u, o) { + const method = (o && o.method) || "GET"; + let body = o && o.body; + if (typeof body === "string") { try { body = JSON.parse(body); } catch (_) {} } + const call = { method: method, url: String(u), body: body, keepalive: !!(o && o.keepalive), done: false }; + env.calls.push(call); + const key = method + " " + String(u).replace(/^https?:\/\/[^/]+/, ""); + env.inflight[key] = (env.inflight[key] || 0) + 1; + env.maxInflight[key] = Math.max(env.maxInflight[key] || 0, env.inflight[key]); + try { + for (const r of env.routes) { + if (r.method === method && r.re.test(String(u))) { + const out = await r.fn(String(u), body, call); + if (out === "NETWORK") throw new TypeError("Failed to fetch"); + const status = out.status || 200; + return { ok: status < 400, status: status, statusText: "x", + json: async function () { return out.body || {}; }, text: async function () { return out.text || ""; } }; + } + } + return { ok: true, status: 200, statusText: "OK", json: async function () { return {}; }, text: async function () { return ""; } }; + } finally { + env.inflight[key]--; + call.done = true; + } + }; + env.puts = function (re) { return env.calls.filter(function (c) { return c.method === "PUT" && re.test(c.url); }); }; + env.toastText = function () { const t = d.querySelector(".erp-toast"); return t ? t.textContent : ""; }; + return env; +} +async function boot(env) { + if (env.d.readyState === "loading") await new Promise(function (r) { env.d.addEventListener("DOMContentLoaded", r); }); + env.w.eval(JS); + env.d.dispatchEvent(new env.w.Event("DOMContentLoaded")); + await settle(); + return env; +} +function type(env, node, value) { + node.value = value; + node.dispatchEvent(new env.w.Event("input", { bubbles: true })); +} +function fire(env, node, name) { node.dispatchEvent(new env.w.Event(name, { bubbles: name !== "blur" && name !== "focus" })); } +function key(env, node, k, extra) { + const e = new env.w.KeyboardEvent("keydown", Object.assign({ key: k, bubbles: true, cancelable: true }, extra || {})); + node.dispatchEvent(e); + return e; +} +// 블록 하나가 예외로 멈춰도 나머지 블록은 계속(예외는 FAIL 로) +async function section(fn) { + try { await fn(); } catch (e) { check("블록 예외 없음: " + String(e && e.message || e).slice(0, 120), false); } +} +function itemLabel(b) { return (b.querySelector(".pj-ctxmenu-label") || b).textContent.trim(); } +function unload(env) { + const e = new env.w.Event("beforeunload", { cancelable: true }); + env.w.dispatchEvent(e); + return e; +} + +// ── 가짜 서버 — 목표 표(글 칸 상태를 기억해 화면 GET 에 반영) ─────────────── +function goalsServer(env, st) { + st = Object.assign({ cells: {}, areaAdded: false, cellHook: null, metricHook: null, getHook: null }, st || {}); + env.route("GET", /\/project\/api\//, function () { return { body: {} }; }); + env.route("PUT", /\/project\/api\/goals\/rows\/\d+\/cells\/\d+$/, async function (u, body, call) { + const m = u.match(/rows\/(\d+)\/cells\/(\d+)/); + if (st.cellHook) { const r = await st.cellHook(u, body, call); if (r) return r; } + st.cells[m[1] + ":" + m[2]] = body.body; + return { body: { ok: true } }; + }); + env.route("PUT", /\/project\/api\/goals\/2026\/metrics$/, async function (u, body, call) { + if (st.metricHook) { const r = await st.metricHook(u, body, call); if (r) return r; } + const n = Number(String(body.value).replace(/[,\s]/g, "")); + st.metric = String(body.value); + return { body: { ok: true, label: body.value === "" ? "" : n.toLocaleString("en-US") } }; + }); + env.route("POST", /\/project\/api\/goals\/2026\/areas$/, function () { st.areaAdded = true; return { body: { ok: true } }; }); + env.route("POST", /\/project\/api\/goals\/areas\/\d+\/rows$/, function () { return { status: 201, body: { ok: true } }; }); + env.route("POST", /\/project\/api\/goals\/areas\/\d+\/move$/, function () { return { body: { ok: true } }; }); + env.route("POST", /\/project\/api\/goals\/areas\/\d+\/merge$/, function () { st.merged = true; return { body: { ok: true, row_id: 10, start: 1 } }; }); + env.route("GET", /\/project\/goals\/2026$/, async function () { + if (st.getHook) await st.getHook(); + st.gets = (st.gets || 0) + 1; + let html = PAGE.goals_admin.replace(/(' + + "$2"); + } + return { text: html }; + }); + return st; +} + +// ── 가짜 서버 — 회의록 ──────────────────────────────────────────────── +function meetServer(env, st) { + st = Object.assign({ items: {}, head: {}, itemHook: null, headHook: null, getHook: null, syncHook: null, page: PAGE.meeting_admin }, st || {}); + env.route("GET", /\/project\/api\//, function () { return { body: {} }; }); + const amount = function (v) { if (v === "" || v == null) return null; return Number(String(v).replace(/[,\s원]/g, "")); }; + env.route("PUT", /\/project\/api\/goals\/meeting-items\/\d+$/, async function (u, body, call) { + const id = Number(u.match(/meeting-items\/(\d+)/)[1]); + if (st.itemHook) { const r = await st.itemHook(id, body, call); if (r) return r; } + const it = st.items[id] = Object.assign(st.items[id] || { id: id }, {}); + Object.keys(body).forEach(function (k) { it[k] = /amount$/.test(k) ? amount(body[k]) : body[k]; }); + return { body: { ok: true, item: Object.assign({ target_amount: null, result_amount: null }, it) } }; + }); + env.route("PUT", /\/project\/api\/goals\/meetings\/2026-09-28$/, async function (u, body, call) { + if (st.headHook) { const r = await st.headHook(body, call); if (r) return r; } + Object.assign(st.head, body); + const out = { ok: true }; + if ("week_target" in body) { out.week_target = amount(body.week_target); st.head.week_target = out.week_target; } + return { body: out }; + }); + env.route("POST", /\/project\/api\/goals\/meetings\/2026-09-28\/items$/, function () { return { status: 201, body: { ok: true, id: 9 } }; }); + env.route("POST", /\/project\/api\/goals\/meeting-items\/\d+\/move$/, function () { return { body: { ok: true } }; }); + env.route("GET", /\/project\/goals\/2026\/meetings\/9/, async function () { + st.gets = (st.gets || 0) + 1; + const page = st.page; + if (st.getHook) { const r = await st.getHook(); if (r) return r; } + return { text: page }; + }); + env.route("POST", /\/performance\/api\/sync$/, async function (u, body) { + st.syncCalls = (st.syncCalls || 0) + 1; + if (st.syncHook) return st.syncHook(body); + return { body: { joined: false, job: { id: "j1", finished: true, from: body.from, to: body.to, shops: [{ name: "쿠팡", state: "done", active: true }], overall: {} } } }; + }); + return st; +} + +(async function () { + // ════════════════════ [1] 회의록 글 — A→B 연속 입력과 늦은 A 응답 ════════════════════ + await section(async function () { + const env = makeEnv(PAGE.meeting_admin, MEET_URL); + const gate = deferred(); + const st = meetServer(env, { itemHook: async function (id, body, call) { if (body.content === "draft A") await gate.promise; } }); + await boot(env); + const ta = env.d.querySelector('tr[data-item="1"] textarea.pj-meet-text'); + ta.focus(); type(env, ta, "draft A"); ta.blur(); + await settle(); + ta.focus(); type(env, ta, "draft B"); + await settle(); + check("[1] A 진행 중엔 같은 칸 두 번째 요청을 보내지 않음(직렬화)", env.puts(/meeting-items\/1$/).length === 1); + gate.resolve(); + await wait(900); await settle(); + const puts = env.puts(/meeting-items\/1$/).map(function (c) { return c.body.content; }); + check("[1] A 응답 뒤 B 가 뒤이어 저장됨(PUT A→B)", JSON.stringify(puts) === JSON.stringify(["draft A", "draft B"]), puts); + check("[1] 최종 서버 값 = B", st.items[1].content === "draft B", st.items[1]); + check("[1] 화면 = B", ta.value === "draft B"); + check("[1] 같은 칸 동시 요청 최대 1", env.maxInflight["PUT /project/api/goals/meeting-items/1"] === 1, env.maxInflight); + const e = unload(env); + check("[1] 저장 끝난 뒤 페이지 떠남 = 경고 없음", !e.defaultPrevented); + }); + // 지연·중복 blur·빠른 연속 입력 — 응답 순서와 무관하게 최신 값이 남는다 + await section(async function () { + const env = makeEnv(PAGE.meeting_admin, MEET_URL); + const gates = []; + const st = meetServer(env, { itemHook: async function () { const g = deferred(); gates.push(g); await g.promise; } }); + await boot(env); + const ta = env.d.querySelector('tr[data-item="1"] textarea.pj-meet-text'); + ta.focus(); type(env, ta, "x1"); ta.blur(); fire(env, ta, "blur"); fire(env, ta, "blur"); + ta.focus(); type(env, ta, "x12"); type(env, ta, "x123"); ta.blur(); + await settle(); + check("[1b] 중복 blur·연속 입력에도 진행 중 요청 1개", env.puts(/meeting-items\/1$/).length === 1); + gates[0].resolve(); await settle(); + check("[1b] 첫 응답 뒤 최신 값으로 한 번 더", env.puts(/meeting-items\/1$/).length === 2 && env.puts(/meeting-items\/1$/)[1].body.content === "x123", + env.puts(/meeting-items\/1$/).map(function (c) { return c.body.content; })); + gates[1].resolve(); await settle(); + await wait(50); await settle(); + check("[1b] 최종 서버 값 = 마지막 입력", st.items[1].content === "x123" && env.puts(/meeting-items\/1$/).length === 2, st.items[1]); + }); + // 저장 실패 → dirty·초안 유지, 페이지 떠남 = keepalive 재전송 + 이탈 경고 + 초안 백업, 다음에 열면 되살림 + await section(async function () { + const env = makeEnv(PAGE.meeting_admin, MEET_URL); + let fail = true; + const st = meetServer(env, { itemHook: function () { if (fail) return { status: 503, body: { detail: "temporary" } }; } }); + await boot(env); + const ta = env.d.querySelector('tr[data-item="1"] textarea.pj-meet-text'); + ta.focus(); type(env, ta, "important"); ta.blur(); + await settle(); + check("[1c] 실패해도 글 그대로", ta.value === "important"); + check("[1c] 실패 표시(빨간 테두리)", ta.closest("td").classList.contains("is-save-failed")); + check("[1c] 실패 안내 토스트", /저장 실패/.test(env.toastText()), env.toastText()); + const draft = JSON.parse(env.w.localStorage.getItem("pj_draft:meet:item:1:content") || "null"); + check("[1c] 초안 백업(localStorage)", draft && draft.draft === "important" && draft.base === "original", draft); + const before = env.puts(/meeting-items\/1$/).length; + const e = unload(env); + await settle(); + const after = env.puts(/meeting-items\/1$/); + check("[1c] 페이지 떠남 — 실패한 칸을 keepalive 로 다시 보냄", after.length === before + 1 && after[after.length - 1].keepalive && after[after.length - 1].body.content === "important", + after.map(function (c) { return [c.body.content, c.keepalive]; })); + check("[1c] 페이지 떠남 — 실패 칸이 있으면 이탈 경고", e.defaultPrevented === true); + // 다음에 열기 — 서버엔 아직 original(keepalive 도 실패) → 초안을 되살려 다시 저장 + const env2 = makeEnv(PAGE.meeting_admin, MEET_URL, { storage: { "pj_draft:meet:item:1:content": JSON.stringify(draft) } }); + const st2 = meetServer(env2); + await boot(env2); + const ta2 = env2.d.querySelector('tr[data-item="1"] textarea.pj-meet-text'); + check("[1c] 다시 열면 초안 되살림", ta2.value === "important"); + await wait(900); await settle(); + check("[1c] 되살린 초안 자동 저장", st2.items[1] && st2.items[1].content === "important", st2.items[1]); + check("[1c] 저장 뒤 초안 백업 지움", env2.w.localStorage.getItem("pj_draft:meet:item:1:content") === null); + // 다른 곳에서 바뀐 칸(base ≠ 서버 값) — 되살리지 않는다 + const stale = JSON.stringify({ base: "someone else", draft: "old draft", at: Date.now() }); + const env3 = makeEnv(PAGE.meeting_admin, MEET_URL, { storage: { "pj_draft:meet:item:1:content": stale } }); + meetServer(env3); + await boot(env3); + check("[1c] 서버 값이 바뀐 칸은 초안을 덮어쓰지 않음", env3.d.querySelector('tr[data-item="1"] textarea.pj-meet-text').value === "original"); + fail = false; void st; + }); + // 진행 중 저장이 있으면 줄 작업(위로)은 그 저장이 끝난 뒤에, 저장 실패면 줄 작업을 하지 않는다 + await section(async function () { + const env = makeEnv(PAGE.meeting_admin, MEET_URL); + const gate = deferred(); + let fail = false; + meetServer(env, { itemHook: async function (id, body) { if ("content" in body) { await gate.promise; if (fail) return { status: 503, body: { detail: "x" } }; } } }); + await boot(env); + const ta = env.d.querySelector('tr[data-item="1"] textarea.pj-meet-text'); + ta.focus(); type(env, ta, "pending text"); ta.blur(); + await settle(); + fail = true; + env.d.querySelector('tr[data-item="1"] th.pj-meet-c-label').dispatchEvent(new env.w.MouseEvent("contextmenu", { bubbles: true, cancelable: true, clientX: 5, clientY: 5 })); + const up = Array.from(env.d.querySelectorAll(".pj-ctxmenu-item")).find(function (b) { return itemLabel(b) === "위로"; }); + up.click(); + await settle(); + check("[1d] 저장 진행 중엔 줄 이동 요청을 보내지 않음", !env.calls.some(function (c) { return /\/move$/.test(c.url); })); + gate.resolve(); + await settle(); await wait(20); await settle(); + check("[1d] 저장 실패 → 줄 이동 취소(글 유지, 새로고침 없음)", !env.calls.some(function (c) { return /\/move$/.test(c.url); }) && ta.value === "pending text" && env.navigations === 0, + { nav: env.navigations }); + }); + + // ════════════════════ [2] 숫자 — 늦은 응답이 최신 입력을 덮지 않음 ════════════════════ + await section(async function () { + const env = makeEnv(PAGE.goals_admin, GOALS_URL); + const gates = []; + const st = goalsServer(env, { metricHook: async function (u, body) { if (body.value === "200") { const g = deferred(); gates.push(g); await g.promise; } } }); + await boot(env); + const inp = env.d.querySelector('input.pj-goal-num[data-metric="sales"][data-kind="target"][data-month="1"]'); + inp.focus(); inp.value = "200"; fire(env, inp, "change"); inp.blur(); + await settle(); + inp.focus(); type(env, inp, "300"); + gates[0].resolve(); + await settle(); + check("[2] 늦은 200 응답 뒤에도 입력 중인 300 유지", inp.value === "300", inp.value); + inp.blur(); + await settle(); await wait(10); await settle(); + const vals = env.puts(/metrics$/).map(function (c) { return c.body.value; }); + check("[2] 300 확정 → 최종 서버 값 300(요청 순서 200→300)", st.metric === "300" && JSON.stringify(vals) === '["200","300"]', vals); + check("[2] 같은 칸 동시 요청 최대 1(순서 역전 불가)", env.maxInflight["PUT /project/api/goals/2026/metrics"] === 1); + check("[2] 확정 뒤 서버 표기", inp.value === "300"); + }); + await section(async function () { // 실패 응답 — 요청 뒤 새로 입력한 값을 예전 값으로 되돌리지 않는다 / 그대로면 입력 유지 + 실패 표시, Esc = 저장된 값 + const env = makeEnv(PAGE.goals_admin, GOALS_URL); + const gate = deferred(); + goalsServer(env, { metricHook: async function (u, body) { if (body.value === "200") { await gate.promise; return { status: 503, body: { detail: "down" } }; } } }); + await boot(env); + const inp = env.d.querySelector('input.pj-goal-num[data-metric="sales"][data-kind="target"][data-month="1"]'); + inp.focus(); inp.value = "200"; inp.blur(); + await settle(); + inp.focus(); type(env, inp, "300"); + gate.resolve(); await settle(); + check("[2b] 200 실패 응답이 새 입력 300 을 되돌리지 않음", inp.value === "300", inp.value); + type(env, inp, "200"); inp.blur(); await settle(); await wait(10); await settle(); + check("[2b] 실패한 값 그대로면 입력 유지 + 실패 표시", inp.value === "200" && inp.parentElement.classList.contains("is-save-failed")); + const e = unload(env); + check("[2b] 미저장 숫자 칸이 있으면 이탈 경고", e.defaultPrevented === true); + inp.focus(); key(env, inp, "Escape"); + check("[2b] Esc = 저장된 값(100)으로", inp.value === "100", inp.value); + }); + await section(async function () { // 회의록 정량 목표·지난주 결과 — 늦은 응답이 새 초안을 덮지 않음 + const env = makeEnv(PAGE.meeting_admin, MEET_URL); + const gate = deferred(); + const st = meetServer(env, { itemHook: async function (id, body) { if (body.target_amount === "200" || body.result_amount === "70") await gate.promise; } }); + await boot(env); + const tin = env.d.querySelector('tr[data-item="1"] input[data-field="target_amount"]'); + tin.focus(); tin.value = "200"; tin.blur(); await settle(); + tin.focus(); type(env, tin, "300"); + const rin = env.d.querySelector('tr[data-item="2"] input[data-field="result_amount"]'); + rin.focus(); rin.value = "70"; rin.blur(); await settle(); + rin.focus(); type(env, rin, "75"); + gate.resolve(); await settle(); + check("[2c] 정량 목표 늦은 응답이 300 초안 유지", tin.value === "300", tin.value); + check("[2c] 지난주 결과 늦은 응답이 75 초안 유지", rin.value === "75", rin.value); + tin.blur(); rin.blur(); await settle(); await wait(10); await settle(); + check("[2c] 최종 서버 정량 목표 300 · 지난주 결과(7일 전 주 줄 902) 75", st.items[1].target_amount === 300 && st.items[902].result_amount === 75, st.items); + check("[2c] 지난주 달성률 = 75/200", env.d.querySelector('tr[data-item="2"] [data-rate]').textContent.trim() === "37.5%", + env.d.querySelector('tr[data-item="2"] [data-rate]').textContent); + }); + await section(async function () { // 금주 목표 저장 — 새로고침하지 않고 숫자 칸만 다시(다른 칸의 미저장 글 보존) + const env = makeEnv(PAGE.meeting_admin, MEET_URL); + const st = meetServer(env, { itemHook: function (id, body) { if ("content" in body) return { status: 503, body: { detail: "x" } }; } }); + await boot(env); + const gets0 = st.gets || 0; + const ta = env.d.querySelector('tr[data-item="1"] textarea.pj-meet-text'); + ta.focus(); type(env, ta, "unsaved note"); + const tgt = env.d.getElementById("pj-meet-target"); + tgt.focus(); tgt.value = "2,000"; tgt.blur(); + await settle(); await wait(10); await settle(); + check("[2d] 금주 목표 저장 = 서버 확정값", st.head.week_target === 2000 && tgt.value === "2,000", st.head); + check("[2d] 페이지 새로고침 없음", env.navigations === 0); + check("[2d] 숫자 칸만 다시 받음(GET 1회 더)", (st.gets || 0) === gets0 + 1, st.gets); + check("[2d] 다른 칸 미저장 글 유지", ta.value === "unsaved note"); + }); + + // ════════════════════ [3] 목표 표 — 글 저장 실패면 구조 변경·표 교체 중단 ════════════════════ + await section(async function () { + const env = makeEnv(PAGE.goals_admin, GOALS_URL, { promptAnswer: "새 영역" }); + const st = goalsServer(env, { cellHook: function () { return { status: 503, body: { detail: "temporary save failure" } }; } }); + await boot(env); + const ta = env.d.querySelector('textarea.pj-goal-text[data-row="10"][data-month="1"]'); + ta.focus(); type(env, ta, "unsaved important plan"); + env.d.getElementById("pj-goal-area-add").click(); + await settle(); await wait(20); await settle(); + check("[3] 글 저장 실패 → 영역 추가 요청 안 보냄", !env.calls.some(function (c) { return c.method === "POST" && /\/areas$/.test(c.url); }), + env.calls.map(function (c) { return c.method + " " + c.url; })); + check("[3] 표를 다시 받지 않음", !st.gets); + check("[3] 미저장 계획 그대로", env.d.querySelector('textarea.pj-goal-text[data-row="10"][data-month="1"]').value === "unsaved important plan"); + check("[3] 실패 안내", /저장/.test(env.toastText()), env.toastText()); + }); + await section(async function () { // 진행 중 저장 → 그 저장이 끝난 뒤에 영역 추가, 성공하면 표 교체(새 영역 보임, 저장된 글 유지) + const env = makeEnv(PAGE.goals_admin, GOALS_URL, { promptAnswer: "새 영역" }); + const gate = deferred(); + const st = goalsServer(env, { cellHook: async function () { await gate.promise; } }); + await boot(env); + const ta = env.d.querySelector('textarea.pj-goal-text[data-row="10"][data-month="1"]'); + ta.focus(); type(env, ta, "plan v2"); ta.blur(); + await settle(); + env.d.getElementById("pj-goal-area-add").click(); + await settle(); + check("[3b] 진행 중 저장이 끝나기 전엔 영역 추가 안 보냄", !env.calls.some(function (c) { return c.method === "POST"; })); + gate.resolve(); + await settle(); await wait(20); await settle(); + const order = env.calls.filter(function (c) { return c.method !== "GET" || /goals\/2026$/.test(c.url); }).map(function (c) { return c.method + " " + c.url.replace(/^https?:\/\/[^/]+/, ""); }); + check("[3b] 순서: 글 PUT → 영역 POST → 표 GET", order.join(" | ") === "PUT /project/api/goals/rows/10/cells/1 | POST /project/api/goals/2026/areas | GET /project/goals/2026", order); + check("[3b] 새 영역이 그 자리에 보임(새로고침 없음)", !!env.d.querySelector('tbody.pj-goal-area[data-area-id="3"]') && env.navigations === 0); + check("[3b] 저장된 글 유지", env.d.querySelector('textarea.pj-goal-text[data-row="10"][data-month="1"]').value === "plan v2"); + }); + await section(async function () { // 표를 받는 사이에 새로 입력 → 저장 후 다시 받아 교체(입력 유실 없음) + const env = makeEnv(PAGE.goals_admin, GOALS_URL, { promptAnswer: "새 영역" }); + const gate = deferred(); + let first = true; + const st = goalsServer(env, { getHook: async function () { if (first) { first = false; await gate.promise; } } }); + await boot(env); + env.d.getElementById("pj-goal-area-add").click(); + await settle(); + const ta = env.d.querySelector('textarea.pj-goal-text[data-row="11"][data-month="1"]'); + ta.focus(); type(env, ta, "typed during refresh"); + gate.resolve(); + await settle(); await wait(30); await settle(); + check("[3c] 받는 사이 입력한 글 저장됨", st.cells["11:1"] === "typed during refresh", st.cells); + check("[3c] 교체된 표에도 그 글", env.d.querySelector('textarea.pj-goal-text[data-row="11"][data-month="1"]').value === "typed during refresh"); + check("[3c] 표를 다시 받음(2회)", st.gets === 2, st.gets); + }); + await section(async function () { // 병합 — 저장 실패면 병합 요청 안 보냄 + const env = makeEnv(PAGE.goals_admin, GOALS_URL); + const st = goalsServer(env, { cellHook: function () { return { status: 503, body: { detail: "x" } }; } }); + await boot(env); + const ta = env.d.querySelector('textarea.pj-goal-text[data-row="10"][data-month="1"]'); + ta.focus(); type(env, ta, "draft before merge"); + const a = env.d.querySelector('td.pj-goal-texttd[data-month="1"]'), b = env.d.querySelector('tr[data-row-id="10"] td.pj-goal-texttd[data-month="2"]'); + a.dispatchEvent(new env.w.MouseEvent("mousedown", { bubbles: true, button: 0 })); + b.dispatchEvent(new env.w.MouseEvent("mouseover", { bubbles: true })); + env.d.dispatchEvent(new env.w.MouseEvent("mouseup", { bubbles: true })); + b.dispatchEvent(new env.w.MouseEvent("contextmenu", { bubbles: true, cancelable: true, clientX: 5, clientY: 5 })); + const merge = Array.from(env.d.querySelectorAll(".pj-ctxmenu-item")).find(function (x) { return /셀 병합/.test(itemLabel(x)); }); + check("[3d] 끌어 고른 뒤 우클릭 → 셀 병합 메뉴(기존 동작)", !!merge); + if (merge) merge.click(); + await settle(); await wait(20); await settle(); + check("[3d] 저장 실패 → 병합 요청 안 보냄, 글 유지", !st.merged && ta.value === "draft before merge"); + }); + + // ════════════════════ [7] 정량 목표 저장 → 이번주 실적 % 즉시 갱신, 다시 그리기와 엇갈려도 ════════════════════ + await section(async function () { + const env = makeEnv(PAGE.meeting_admin, MEET_URL, { session: { "pj_meet_sync:2026-09-28": JSON.stringify({ at: Date.now(), state: "ok" }) } }); + const st = meetServer(env); + await boot(env); + const slot = function () { return env.d.querySelector('tr[data-item="1"] .pj-meet-week-slot').textContent.trim(); }; + check("[7] 처음 = 실적 100 · 목표 100 → 100%", /100%/.test(slot()), slot()); + const tin = env.d.querySelector('tr[data-item="1"] input[data-field="target_amount"]'); + tin.focus(); tin.value = "200"; tin.blur(); await settle(); await wait(10); await settle(); + check("[7] 목표 200 저장 → 50%", /· 50%$/.test(slot()), slot()); + tin.focus(); tin.value = "0"; tin.blur(); await settle(); await wait(10); await settle(); + check("[7] 목표 0 → % 없음", slot() === "이번주 실적 100", slot()); + tin.focus(); tin.value = ""; tin.blur(); await settle(); await wait(10); await settle(); + check("[7] 목표 삭제 → % 없음", slot() === "이번주 실적 100", slot()); + // 다시 그리기(옛 화면: 목표 100·100%)가 목표 저장 뒤에 도착해도 옛 비율이 들어오지 않는다 + const gate = deferred(); + st.getHook = async function () { await gate.promise; }; + const p = env.w.eval("null"); void p; + tin.focus(); tin.value = "400"; tin.blur(); await settle(); await wait(10); await settle(); + check("[7] 목표 400 → 25%", /· 25%$/.test(slot()), slot()); + gate.resolve(); await settle(); await wait(10); await settle(); + check("[7] 늦게 온 옛 화면(100%)이 덮지 않음 — 지금 목표 기준 25%", /· 25%$/.test(slot()), slot()); + // 저장 실패 — 확정 목표(400)는 그대로라 25% 유지, 입력값은 남김 + st.itemHook = function () { return { status: 503, body: { detail: "x" } }; }; + tin.focus(); tin.value = "800"; tin.blur(); await settle(); await wait(10); await settle(); + check("[7] 저장 실패 → 비율은 확정값(25%), 입력 800 유지", /· 25%$/.test(slot()) && tin.value === "800", [slot(), tin.value]); + }); + await section(async function () { // 실적 조회 실패 화면 — 미확인(0원·0% 아님) + const env = makeEnv(PAGE.meeting_err, MEET_URL, { session: { "pj_meet_sync:2026-09-28": JSON.stringify({ at: Date.now(), state: "ok" }) } }); + meetServer(env, { page: PAGE.meeting_err }); + await boot(env); + const kpi = Array.from(env.d.querySelectorAll(".pj-meet-kpi")).map(function (k) { return k.textContent.replace(/\s+/g, " ").trim(); }); + const mtd = kpi.find(function (t) { return /월 누적 실적/.test(t); }); + check("[6] 월 누적 = 미확인(0원 아님)", /미확인/.test(mtd) && !/0원|0 원/.test(mtd), mtd); + check("[6] 주당 필요 = 미확인(목표로 계산하지 않음)", /미확인/.test(kpi.find(function (t) { return /주당 필요/.test(t); }))); + check("[6] 전주 결과·금주 실적 = 미확인", /미확인/.test(kpi.find(function (t) { return /전주 결과/.test(t); })) && /미확인/.test(kpi.find(function (t) { return /금주 현재 실적/.test(t); }))); + const row = env.d.querySelector('tr[data-item="1"]'); + check("[6] 쇼핑몰 연결 줄 결과 = 미확인, 직접 입력 칸으로 바뀌지 않음", /미확인/.test(row.querySelector(".pj-meet-c-result").textContent) && !row.querySelector(".pj-meet-c-result input")); + check("[6] 이번주 실적 미확인 · 달성률 비움", /미확인/.test(row.querySelector(".pj-meet-week-slot").textContent) && row.querySelector("[data-rate]").textContent.trim() === ""); + check("[6] 회의록 입력은 그대로 가능", !!row.querySelector("textarea.pj-meet-text") && !!env.d.getElementById("pj-meet-target")); + check("[6] 조회 실패 안내 문구", /미확인/.test(env.d.querySelector(".pj-meet-perf-warn").textContent)); + }); + await section(async function () { // 지난주 리뷰 머리 = 지난주(9/21~) — 지난주 회의록에 없는 줄 안내 + const env = makeEnv(PAGE.meeting_admin, MEET_URL, { session: { "pj_meet_sync:2026-09-28": JSON.stringify({ at: Date.now(), state: "ok" }) } }); + meetServer(env); + await boot(env); + check("[5] 지난주 리뷰 머리 = 09/21 ~ 09/27", /09\/21 ~ 09\/27/.test(env.d.querySelector("th.is-prev").textContent)); + check("[5] 새 줄 = 지난주 회의록에 없는 줄", /지난주 회의록에 없는 줄/.test(env.d.querySelector('tr[data-item="3"]').textContent)); + }); + + // ════════════════════ [8] 구역·항목 메뉴 — ⋮ 버튼(키보드·터치) + 우클릭 ════════════════════ + await section(async function () { + const env = makeEnv(PAGE.goals_admin, GOALS_URL, { promptAnswer: "줄 이름" }); + goalsServer(env); + await boot(env); + const btns = env.d.querySelectorAll(".pj-goal-menu-btn"); + check("[8] 관리자: 구역 2 + 항목 4 메뉴 버튼", btns.length === 6, btns.length); + const areaBtn = env.d.querySelector('tbody[data-area-id="1"] .pj-goal-menu-btn[data-goal-menu="area"]'); + check("[8] 접근성 이름", areaBtn.getAttribute("aria-label") === "상품 구역 메뉴" && areaBtn.getAttribute("aria-haspopup") === "menu"); + check("[8] Tab 으로 갈 수 있는 버튼", areaBtn.tagName === "BUTTON" && areaBtn.tabIndex === 0); + areaBtn.focus(); + areaBtn.dispatchEvent(new env.w.MouseEvent("click", { bubbles: true, cancelable: true, detail: 0 })); // Enter/Space → click(detail 0) + let menu = env.d.querySelector(".pj-ctxmenu"); + check("[8] 키보드로 열기 → role=menu, 첫 항목 포커스", menu && menu.getAttribute("role") === "menu" && env.d.activeElement === menu.querySelector(".pj-ctxmenu-item")); + check("[8] aria-expanded=true", areaBtn.getAttribute("aria-expanded") === "true"); + key(env, env.d.activeElement, "ArrowDown"); + check("[8] ↓ 로 다음 항목", env.d.activeElement === menu.querySelectorAll(".pj-ctxmenu-item")[1]); + await settle(); + key(env, env.d.activeElement, "Escape"); + check("[8] Esc 닫기 → 버튼으로 포커스 복귀", !env.d.querySelector(".pj-ctxmenu") && env.d.activeElement === areaBtn && areaBtn.getAttribute("aria-expanded") === "false"); + // 키보드로 항목 실행 — "줄 추가(구역 맨 아래)" + areaBtn.dispatchEvent(new env.w.MouseEvent("click", { bubbles: true, cancelable: true, detail: 0 })); + menu = env.d.querySelector(".pj-ctxmenu"); + const add = Array.from(menu.querySelectorAll(".pj-ctxmenu-item")).find(function (b) { return /줄 추가/.test(itemLabel(b)); }); + add.focus(); add.click(); + await settle(); await wait(20); await settle(); + check("[8] 메뉴 항목 실행 → 줄 추가 API", env.calls.some(function (c) { return c.method === "POST" && /areas\/1\/rows$/.test(c.url); })); + // 터치(탭) — 포인터 터치 뒤 click(detail 1) + const rowBtn = env.d.querySelector('tr[data-row-id="20"] .pj-goal-menu-btn[data-goal-menu="row"]'); + rowBtn.dispatchEvent(new env.w.Event("pointerdown", { bubbles: true })); + rowBtn.dispatchEvent(new env.w.MouseEvent("click", { bubbles: true, cancelable: true, detail: 1 })); + menu = env.d.querySelector(".pj-ctxmenu"); + const labels = menu ? Array.from(menu.querySelectorAll(".pj-ctxmenu-item")).map(itemLabel) : []; + check("[8] 탭(click) → 줄 메뉴(우클릭과 같은 항목)", labels.indexOf("위에 줄 추가") >= 0 && labels.indexOf("아래에 줄 추가") >= 0 && labels.indexOf("줄 삭제") >= 0, labels); + check("[8] 터치로 연 메뉴도 ↑↓·Esc 가능(메뉴에 포커스)", env.d.activeElement === menu); + // 다시 누르면 닫힘(토글) — 마우스는 mousedown 이 먼저 닫는다 + env.d.dispatchEvent(new env.w.MouseEvent("mousedown", { bubbles: true })); + rowBtn.dispatchEvent(new env.w.MouseEvent("mousedown", { bubbles: true })); + await settle(); + rowBtn.dispatchEvent(new env.w.MouseEvent("click", { bubbles: true, cancelable: true, detail: 1 })); + check("[8] 열린 메뉴 버튼 다시 누름 = 닫힘", !env.d.querySelector(".pj-ctxmenu")); + // 우클릭은 그대로 + env.d.querySelector('tbody[data-area-id="2"] th.pj-goal-area-name').dispatchEvent(new env.w.MouseEvent("contextmenu", { bubbles: true, cancelable: true, clientX: 3, clientY: 3 })); + const ctx = Array.from(env.d.querySelectorAll(".pj-ctxmenu-item")).map(itemLabel); + check("[8] 우클릭 메뉴 그대로(색·위로·줄 추가·삭제)", ctx.indexOf("색 바꾸기") >= 0 && ctx.indexOf("위로") >= 0 && ctx.indexOf("영역 삭제") >= 0, ctx); + key(env, env.d.body, "Escape"); + // 이름 칸 — Tab 으로 와서 Enter = 이름 수정, 한글 조합 중 Enter 는 무시 + const name = env.d.querySelector('tr[data-row-id="10"] .pj-goal-row-text'); + check("[8] 이름 칸 Tab 접근(tabindex=0)", name.getAttribute("tabindex") === "0"); + name.focus(); + key(env, name, "Enter", { isComposing: true }); + check("[8] 한글 조합 중 Enter 는 편집 시작 안 함", name.isContentEditable !== true && name.contentEditable !== "true"); + key(env, name, "Enter"); + check("[8] Enter → 이름 수정", name.contentEditable === "true"); + key(env, name, "Escape"); + }); + await section(async function () { + const env = makeEnv(PAGE.goals_ro, GOALS_URL); + goalsServer(env); + await boot(env); + check("[8] 보기 전용: 메뉴 버튼·이름 편집 없음", !env.d.querySelector(".pj-goal-menu-btn") && !env.d.querySelector("[data-goal-edit]")); + const th = env.d.querySelector("th.pj-goal-area-name"); + th.dispatchEvent(new env.w.MouseEvent("contextmenu", { bubbles: true, cancelable: true })); + check("[8] 보기 전용: 우클릭 편집 메뉴 없음", !env.d.querySelector(".pj-ctxmenu")); + // 분기 접기는 보기 전용도 + const qth = env.d.querySelector('th.pj-goal-fold-th[data-h="1"]'); + qth.dispatchEvent(new env.w.MouseEvent("click", { bubbles: true })); + check("[회귀] 분기 머리 클릭 → 접힘(보기 전용도)", qth.classList.contains("is-folded") && env.d.querySelector('td.pj-goal-m[data-h="1"]').classList.contains("is-shrunk")); + check("[회귀] 접기 상태 기억", /"1":true/.test(env.w.localStorage.getItem("pj_goal_fold_q") || "")); + }); + await section(async function () { // 회귀 — 열 너비 끌기·고정 열 변수·스크롤 위치 되살리기 + const env = makeEnv(PAGE.goals_admin, GOALS_URL, { session: { pj_goal_scroll: JSON.stringify(["/project/goals/2026", 120, 45]) } }); + goalsServer(env); + await boot(env); + const pane = env.d.getElementById("pj-goal-pane"); + check("[회귀] 스크롤 위치 되살림", pane.scrollLeft === 120 && pane.scrollTop === 45, [pane.scrollLeft, pane.scrollTop]); + const h = env.d.querySelector('.pj-goal-colresize[data-col="c1"]'); + h.dispatchEvent(new env.w.MouseEvent("mousedown", { bubbles: true, button: 0, clientX: 100 })); + env.d.dispatchEvent(new env.w.MouseEvent("mousemove", { bubbles: true, clientX: 140 })); + env.d.dispatchEvent(new env.w.MouseEvent("mouseup", { bubbles: true })); + const table = env.d.getElementById("pj-goal-table"); + check("[회귀] 1열 너비 끌기 → --goal-c1-w 112px·기억", table.style.getPropertyValue("--goal-c1-w") === "112px" && /"c1":112/.test(env.w.localStorage.getItem("pj_goal_col_w") || ""), + table.style.getPropertyValue("--goal-c1-w")); + }); + + // ════════════════════ [9] 매출 자동 갱신 — 정상 조용히 · 실패/일부 실패 안내 + 재시도 · 권한 없음 ════════════════════ + await section(async function () { + const env = makeEnv(PAGE.meeting_admin, MEET_URL); + const st = meetServer(env); + await boot(env); + await wait(20); await settle(); + const box = env.d.getElementById("pj-meet-sync"); + check("[9] 정상 갱신 → 안내 숨김(조용)", st.syncCalls === 1 && box.hidden === true); + check("[9] 갱신 뒤 숫자 칸 다시 그림(GET)", (st.gets || 0) >= 1); + }); + await section(async function () { + const env = makeEnv(PAGE.meeting_admin, MEET_URL); + const st = meetServer(env, { syncHook: function (body) { + return { body: { joined: false, job: { id: "j1", finished: true, from: body.from, to: body.to, + shops: [{ name: "쿠팡", state: "done", active: true }, { name: "네이버", state: "error", label: "인증 오류", active: true }], overall: {} } } }; + } }); + await boot(env); + const ta = env.d.querySelector('tr[data-item="1"] textarea.pj-meet-text'); + ta.focus(); type(env, ta, "editing while sync"); + await wait(20); await settle(); + const box = env.d.getElementById("pj-meet-sync"), btn = env.d.getElementById("pj-meet-sync-btn"); + check("[9] 일부 실패 → 안내 보임 + 실패 쇼핑몰 이름", !box.hidden && box.dataset.state === "partial" && /네이버\(인증 오류\)/.test(box.textContent), box.textContent); + check("[9] 일부 실패를 전체 성공처럼 쓰지 않음 + 서버 기록 시각", !/갱신 성공 10\/01 14:20.*전체/.test(box.textContent) && /마지막 갱신 성공 10\/01 14:20/.test(box.textContent), box.textContent); + check("[9] 재시도 버튼", !btn.hidden); + check("[9] 갱신·다시 그리기 중에도 편집 글 유지", ta.value === "editing while sync"); + const rec = JSON.parse(env.w.sessionStorage.getItem("pj_meet_sync:2026-09-28")); + check("[9] 기록 = partial(성공으로 기록하지 않음)", rec.state === "partial"); + btn.click(); await wait(20); await settle(); + check("[9] 재시도 → 다시 부름", st.syncCalls === 2); + }); + await section(async function () { + const env = makeEnv(PAGE.meeting_admin, MEET_URL); + const st = meetServer(env, { syncHook: function () { return { status: 500, body: { detail: "서버 오류" } }; } }); + await boot(env); + await wait(20); await settle(); + const box = env.d.getElementById("pj-meet-sync"); + check("[9] 실패 → 식별 가능한 안내 + 재시도", !box.hidden && box.dataset.state === "error" && /실패/.test(box.textContent) && !env.d.getElementById("pj-meet-sync-btn").hidden, box.textContent); + st.syncHook = null; + env.d.getElementById("pj-meet-sync-btn").click(); await wait(20); await settle(); + check("[9] 재시도 성공 → 안내 사라짐", box.hidden === true); + }); + await section(async function () { + const env = makeEnv(PAGE.meeting_admin, MEET_URL); + const st = meetServer(env, { syncHook: function () { return { status: 403, body: { detail: "권한 없음" } }; } }); + await boot(env); + await wait(20); await settle(); + const box = env.d.getElementById("pj-meet-sync"); + check("[9] 403 → 권한 없음 설명, 재시도 버튼 없음", box.dataset.state === "noperm" && env.d.getElementById("pj-meet-sync-btn").hidden); + check("[9] 403 기억 → 같은 세션 자동 재호출 안 함", JSON.parse(env.w.sessionStorage.getItem("pj_meet_sync:2026-09-28")).state === "noperm"); + void st; + }); + await section(async function () { // 권한 없음(서버가 can_sync=0) — API 를 아예 부르지 않는다 + const env = makeEnv(PAGE.meeting_ro, MEET_URL); + const st = meetServer(env, { page: PAGE.meeting_ro }); + await boot(env); + await wait(20); await settle(); + check("[9] 실적 권한 없음 → sync API 호출 0", !st.syncCalls && !env.calls.some(function (c) { return /performance/.test(c.url); })); + check("[9] 권한 없음 설명(저장된 실적·마지막 갱신 시각)", /권한이 없어/.test(env.d.getElementById("pj-meet-sync").textContent) && /10\/01 14:20/.test(env.d.getElementById("pj-meet-sync").textContent)); + check("[9] 보기 전용: 입력칸 없음", !env.d.querySelector("textarea.pj-meet-text") && !env.d.getElementById("pj-meet-target")); + }); + await section(async function () { // 10분 제한 — 최근 기록이 있으면 다시 부르지 않고 그 상태만(일부 실패면 안내 유지) + const env = makeEnv(PAGE.meeting_admin, MEET_URL, { session: { "pj_meet_sync:2026-09-28": JSON.stringify({ at: Date.now(), state: "partial", bad: ["네이버"] }) } }); + const st = meetServer(env); + await boot(env); + await wait(20); await settle(); + check("[9] 10분 안 = 다시 부르지 않음, 일부 실패 안내 유지", !st.syncCalls && env.d.getElementById("pj-meet-sync").dataset.state === "partial"); + }); + await section(async function () { // 다른 사람 업데이트에 합류했는데 기간이 이 주를 다 덮지 못하면 한 번 더 + const env = makeEnv(PAGE.meeting_admin, MEET_URL); + let n = 0; + const st = meetServer(env, { syncHook: function (body) { + n++; + if (n === 1) return { body: { joined: true, job: { id: "other", finished: true, from: "2026-09-29", to: "2026-10-01", shops: [], overall: {} } } }; + return { body: { joined: false, job: { id: "mine", finished: true, from: body.from, to: body.to, shops: [], overall: {} } } }; + } }); + await boot(env); + await wait(20); await settle(); + check("[9] 합류한 작업이 기간을 못 덮으면 이 주 기간으로 한 번 더", st.syncCalls === 2 && env.d.getElementById("pj-meet-sync").hidden); + }); + await section(async function () { // 회귀 — 참석자 고르기(칩·저장) + const html = PAGE.meeting_admin.replace("window.PJ_MEET_MEMBERS = []", 'window.PJ_MEET_MEMBERS = [{"email":"a@test.local","name":"에이","avatar":""}]'); + const env = makeEnv(html, MEET_URL, { session: { "pj_meet_sync:2026-09-28": JSON.stringify({ at: Date.now(), state: "ok" }) } }); + const st = meetServer(env); + await boot(env); + env.d.getElementById("pj-meet-attend-add").click(); + const cb = env.d.querySelector('.pj-meet-pick input[type=checkbox][data-email="a@test.local"]'); + cb.checked = true; cb.dispatchEvent(new env.w.Event("change", { bubbles: true })); + await settle(); + check("[회귀] 참석자 고르기 → 칩 + 저장", !!env.d.querySelector('.pj-meet-chip[data-key="a@test.local"]') && st.head.attendees === "a@test.local", st.head); + }); + + clearTimeout(WATCHDOG); + const realUnhandled = unhandled.filter(function (m) { return !/Not implemented/.test(m); }); + check("처리 안 된 Promise 거부 없음", realUnhandled.length === 0, realUnhandled); + console.log(fails.length ? fails.length + " FAIL" : "ALL PASS"); + process.exit(fails.length ? 1 : 0); +})().catch(function (e) { console.error(e); process.exit(1); }); diff --git a/tests/js/render_goals.py b/tests/js/render_goals.py new file mode 100644 index 0000000..c3b581d --- /dev/null +++ b/tests/js/render_goals.py @@ -0,0 +1,129 @@ +"""연간 목표(goals.html)·주간 회의록(goal_meeting.html)을 테스트용 HTML 로 렌더한다(erp_base.html 은 최소 스텁, 가상의 데이터). + + python tests/js/render_goals.py # → tests/js/.out/goals_admin.html · goals_ro.html · meeting_admin.html · meeting_err.html · meeting_ro.html + +칸 배치는 실제 라우터 도우미(_goal_area_layout·_goal_label_spans)로 만든다. DB·실적 모듈은 쓰지 않는다. +""" + +from __future__ import annotations + +import copy +import io +import os +import sys + +import jinja2 + +ROOT = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) +sys.path.insert(0, ROOT) +OUT_DIR = os.path.join(ROOT, "tests", "js", ".out") + +from app.modules.project import store # noqa: E402 +from app.modules.project.router import _goal_area_layout, _goal_label_spans # noqa: E402 + +BASE_STUB = ("{% block head_extra %}{% endblock %}{% block topbar_actions %}{% endblock %}" + "
    {% block content %}{% endblock %}
    ") +ME = "me@test.local" + + +def board() -> dict: + rows_a = [{"id": 10, "label": "신제품", "cells": {0: "연간 계획", 1: "original"}, "merges": {}}, + {"id": 11, "label": "리뉴얼", "cells": {}, "merges": {}}] + rows_b = [{"id": 20, "label": "쿠팡", "cells": {2: "행사"}, "merges": {}}, + {"id": 21, "label": "", "cells": {}, "merges": {}}] + areas = [{"id": 1, "name": "상품", "color": "#fde2e4", "rows": rows_a}, + {"id": 2, "name": "유통", "color": "", "rows": rows_b}] + for a in areas: + _goal_area_layout(a["rows"], 10) + _goal_label_spans(a["rows"]) + return { + "year": 2026, "sales_unit": "만원", "halves": True, "quarters": True, + "metrics": {"sales": {"target_label": {1: "100", 2: "100"}, "actual_label": {1: "50"}}, + "roas": {"target_label": {}, "actual_label": {}}}, + "areas": areas, + } + + +def goals_ctx(admin: bool) -> dict: + return { + "user": {"email": ME, "is_super_admin": False}, "is_admin": admin, "nav_projects": [], "goal_years": [2026], + "goal_year_active": 2026, "my_open_total": 0, "mention_unread": 0, "color_palette": ["#4573d2"], + "project_icons": ["folder"], "goals_enabled": True, "goal_year": 2026, "board": board(), + "months": list(range(1, 13)), + "quarters": [(q, list(range(q * 3 - 2, q * 3 + 1)), store.GOAL_QUARTER_COL[q], f"{q}분기") for q in (1, 2, 3, 4)], + "this_month": 10, "goal_area_colors": list(store.GOAL_AREA_COLORS), + } + + +def meeting_view(err: bool) -> dict: + """회의록 2026-09-28 주 — 유통 쿠팡(쇼핑몰 연결, 이번주 실적 100, 정량 목표 100), 상품1(직접 입력 결과).""" + prev_cou = {"id": 901, "week_start": "2026-09-21", "content": "지난주 행사", "target_amount": 100, "result_amount": None, + "status": "", "marketplace_code": "coupang", "period": "9/21~9/27", "not_started": False, + "market_off": False, "auto_error": err, "auto_result": None if err else 80, + "result": None if err else 80, "market_name": "쿠팡"} + prev_p1 = {"id": 902, "week_start": "2026-09-21", "content": "샘플", "target_amount": 200, "result_amount": 100, + "status": "partial", "marketplace_code": "", "period": "9/21~9/27", "not_started": False, + "market_off": False, "auto_error": False, "auto_result": None, "result": 100, "market_name": ""} + it_cou = {"id": 1, "section": "유통", "section_color": "", "label": "쿠팡", "content": "original", + "target_amount": 100, "marketplace_code": "coupang", "market_name": "쿠팡", "market_off": False, + "market_unknown": err, "week_auto": None if err else 100, "week_error": err, + "prev": prev_cou, "rate": None if err else 80.0} + it_p1 = {"id": 2, "section": "상품", "section_color": "#fde2e4", "label": "상품1", "content": "", + "target_amount": None, "marketplace_code": "", "market_name": "", "market_off": False, + "market_unknown": False, "week_auto": None, "week_error": False, "prev": prev_p1, "rate": 50.0} + it_new = {"id": 3, "section": "상품", "section_color": "#fde2e4", "label": "새 줄", "content": "", + "target_amount": None, "marketplace_code": "", "market_name": "", "market_off": False, + "market_unknown": False, "week_auto": None, "week_error": False, "prev": None, "rate": None} + meeting = {"week_start": "2026-09-28", "week_target": 1000, "attendees": "", "notes": "메모 원본", + "items": [it_p1, it_new, it_cou], + "sections": [{"name": "상품", "color": "#fde2e4", "rows": [it_p1, it_new]}, + {"name": "유통", "color": "", "rows": [it_cou]}]} + head = {"sales_unit": "원", "sales_target": 10000.0, "roas_target": None, "month_target_won": 10000, + "mtd": None if err else 0, "mtd_end": "2026-09-27", "weeks_left": 1, + "need_per_week": None if err else 10000, "prev_target": 500, "prev_exists": True, + "prev_result": None if err else 0, "week_result": None if err else 0, + "perf": True, "perf_state": "error" if err else "ok", + "unknown": ["mtd", "prev_result", "week_result"] if err else [], + "fresh_oldest": "" if err else "10/01 14:20", + "fresh_tip": "" if err else "매출 자료(실적 모듈) 쇼핑몰별 마지막 갱신 성공 — 쿠팡 10/01 14:20"} + return {"meeting": meeting, "head": head, "markets": [] if err else [{"code": "coupang", "name": "쿠팡"}]} + + +def meeting_ctx(admin: bool, err: bool, can_sync: bool = True) -> dict: + view = meeting_view(err) + return { + "user": {"email": ME, "is_super_admin": False}, "is_admin": admin, "nav_projects": [], "goal_years": [2026], + "goal_year_active": 2026, "my_open_total": 0, "mention_unread": 0, "color_palette": ["#4573d2"], + "project_icons": ["folder"], "goal_year": 2026, "goal_month": 9, "meetings_enabled": True, + "weeks": [{"start": "2026-09-28", "end": "2026-10-04", "n": 4, "label": "9/28~10/4", "has": True, "now": False, + "days": []}], + "cal_weeks": [], "week": "2026-09-28", "week_n": 4, "week_end": "2026-10-04", + "prev_week": "2026-09-21", "prev_week_end": "2026-09-27", "sync_from": "2026-09-21", "sync_to": "2026-10-01", + "can_sync": can_sync, "meeting_status": store.MEETING_STATUS, "meet_members": [], "month_plan": None, + "attendee_list": [], **copy.deepcopy(view), + } + + +def main() -> None: + env = jinja2.Environment(loader=jinja2.ChoiceLoader([ + jinja2.DictLoader({"erp_base.html": BASE_STUB}), + jinja2.FileSystemLoader(os.path.join(ROOT, "app", "modules", "project", "templates")), + ])) + env.globals["pj_kr_holidays"] = {} + os.makedirs(OUT_DIR, exist_ok=True) + pages = { + "goals_admin.html": ("project/goals.html", goals_ctx(True)), + "goals_ro.html": ("project/goals.html", goals_ctx(False)), + "meeting_admin.html": ("project/goal_meeting.html", meeting_ctx(True, False)), + "meeting_err.html": ("project/goal_meeting.html", meeting_ctx(True, True)), + "meeting_ro.html": ("project/goal_meeting.html", meeting_ctx(False, False, can_sync=False)), + } + for name, (tpl, ctx) in pages.items(): + html = env.get_template(tpl).render(**ctx) + path = os.path.join(OUT_DIR, name) + io.open(path, "w", encoding="utf-8", newline="\n").write(html) + print("rendered:", path) + + +if __name__ == "__main__": + main() diff --git a/tests/test_meeting_line_keys_migration.py b/tests/test_meeting_line_keys_migration.py new file mode 100644 index 0000000..ab016b0 --- /dev/null +++ b/tests/test_meeting_line_keys_migration.py @@ -0,0 +1,132 @@ +"""마이그레이션 018(주간 회의록 줄 연결키 line_key) 백필 검증 — 로컬 테스트용 PostgreSQL 에서만. + +예전 코드가 만든 데이터 모양(carry_from 사슬·역순 생성·끊긴 연결·같은 이름 줄)을 임시 스키마에 만들고 +scripts/sql/project_db_018_meeting_line_keys.sql 을 두 번 돌려(멱등) 결과를 확인한다. +전부 한 트랜잭션 안에서 하고 마지막에 ROLLBACK — 테스트 DB 에 아무것도 남기지 않는다(DROP 없음). + + PROJECT_TEST_DB_URL=postgresql://postgres@127.0.0.1:55432/project_db \ + python tests/test_meeting_line_keys_migration.py +""" + +from __future__ import annotations + +import os +import sys +import uuid +from datetime import date, timedelta +from urllib.parse import urlparse + +ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) +DSN = os.getenv("PROJECT_TEST_DB_URL", "") +ENABLED = bool(DSN) and urlparse(DSN).hostname in ("localhost", "127.0.0.1") + +DDL = """ +CREATE TABLE goal_meetings ( + week_start DATE PRIMARY KEY CHECK (EXTRACT(ISODOW FROM week_start) = 1), + week_target BIGINT NULL, attendees TEXT NOT NULL DEFAULT '', notes TEXT NOT NULL DEFAULT '', + created_by TEXT NOT NULL DEFAULT '', created_at TIMESTAMPTZ NOT NULL DEFAULT now(), + updated_by TEXT NOT NULL DEFAULT '', updated_at TIMESTAMPTZ NOT NULL DEFAULT now() +); +CREATE TABLE goal_meeting_items ( + id BIGSERIAL PRIMARY KEY, + week_start DATE NOT NULL REFERENCES goal_meetings(week_start) ON DELETE CASCADE, + section TEXT NOT NULL DEFAULT '', section_color TEXT NOT NULL DEFAULT '', label TEXT NOT NULL DEFAULT '', + content TEXT NOT NULL DEFAULT '', target_amount BIGINT NULL, result_amount BIGINT NULL, + status TEXT NOT NULL DEFAULT '', marketplace_code TEXT NOT NULL DEFAULT '', + carry_from BIGINT NULL REFERENCES goal_meeting_items(id) ON DELETE SET NULL, + sort_order INT NOT NULL DEFAULT 0, updated_by TEXT NOT NULL DEFAULT '', updated_at TIMESTAMPTZ NOT NULL DEFAULT now() +); +""" + + +def migration_sql() -> str: + """018 파일에서 psql 메타 명령(\\set·\\connect)과 BEGIN/COMMIT 을 뺀 본문 — 바깥 트랜잭션(ROLLBACK) 안에서 돌린다.""" + path = os.path.join(ROOT, "scripts", "sql", "project_db_018_meeting_line_keys.sql") + with open(path, encoding="utf-8") as fh: + lines = [ln for ln in fh.read().splitlines() + if not ln.startswith("\\") and ln.strip() not in ("BEGIN;", "COMMIT;")] + return "\n".join(lines) + + +def main() -> int: + if not ENABLED: + print("SKIP: PROJECT_TEST_DB_URL(localhost) not set") + return 0 + import psycopg + from psycopg.rows import dict_row + + schema = "mig018_" + uuid.uuid4().hex[:8] + W = [date(2026, 9, 7) + timedelta(days=7 * i) for i in range(5)] # 9/7 9/14 9/21 9/28 10/5 (월요일) + with psycopg.connect(DSN, row_factory=dict_row) as conn: # autocommit 아님 — 끝에 rollback + conn.execute(f"CREATE SCHEMA {schema}") + conn.execute(f"SET LOCAL search_path TO {schema}") + conn.execute(DDL) + for w in W: + conn.execute("INSERT INTO goal_meetings (week_start) VALUES (%s)", (w,)) + + def add(week, section, label, carry=None, order=0): + return conn.execute( + "INSERT INTO goal_meeting_items (week_start, section, label, carry_from, sort_order) " + "VALUES (%s,%s,%s,%s,%s) RETURNING id", (week, section, label, carry, order), + ).fetchone()["id"] + + # 9/14 = 양식으로 처음(사슬 뿌리) — 같은 구역에 같은 이름 "기타" 두 줄 + a_cou = add(W[1], "유통", "쿠팡", order=0) + a_et1 = add(W[1], "유통", "기타", order=1) + a_et2 = add(W[1], "유통", "기타", order=2) + a_meta = add(W[1], "마케팅", "메타", order=3) + # 9/28 을 먼저 만듦(예전 코드: 앞선 가장 가까운 9/14 를 원본으로) → 9/21 을 나중에(역시 9/14 원본) + b_cou = add(W[3], "유통", "쿠팡", a_cou, 0) + b_et1 = add(W[3], "유통", "기타", a_et1, 1) + b_et2 = add(W[3], "유통", "기타", a_et2, 2) + b_meta = add(W[3], "마케팅", "메타 광고", a_meta, 3) # 이름 바꾼 줄 + b_new = add(W[3], "유통", "쿠팡", None, 4) # 9/28 에 새로 추가한 같은 이름 줄 + c_cou = add(W[2], "유통", "쿠팡", a_cou, 0) + c_et1 = add(W[2], "유통", "기타", a_et1, 1) + c_et2 = add(W[2], "유통", "기타", a_et2, 2) + c_meta = add(W[2], "마케팅", "메타", a_meta, 3) + # 10/5 = 9/28 원본 — 9/28 의 새 줄도 이어받음 + d_cou = add(W[4], "유통", "쿠팡", b_cou, 0) + d_new = add(W[4], "유통", "쿠팡", b_new, 1) + # 9/7 = 앞 주를 지웠다 다시 만든 흔적 — 연결 끊김(carry_from NULL), 같은 이름이지만 붙이면 안 됨 + e_cou = add(W[0], "유통", "쿠팡", None, 0) + + sql = migration_sql() + conn.execute(sql) + key = lambda i: conn.execute("SELECT line_key FROM goal_meeting_items WHERE id = %s", (i,)).fetchone()["line_key"] # noqa: E731 + first = {i: key(i) for i in (a_cou, b_cou, c_cou, d_cou, a_et1, a_et2, b_et1, b_et2, c_et1, c_et2, + a_meta, b_meta, c_meta, b_new, d_new, e_cou)} + conn.execute(sql) # 두 번째 — 멱등(키가 바뀌지 않아야) + second = {i: key(i) for i in first} + + checks = [ + ("모든 줄에 키", conn.execute("SELECT count(*) AS n FROM goal_meeting_items WHERE line_key IS NULL").fetchone()["n"] == 0), + ("역순 생성: 9/28 쿠팡 ↔ 9/21 쿠팡 같은 키", first[b_cou] == first[c_cou] == first[a_cou] == first[d_cou]), + ("같은 이름 '기타' 두 줄은 서로 다른 키", first[a_et1] != first[a_et2]), + ("'기타' 각 줄이 자기 사슬로만", first[b_et1] == first[c_et1] == first[a_et1] and first[b_et2] == first[c_et2] == first[a_et2]), + ("이름 바꾼 줄도 같은 키", first[b_meta] == first[c_meta] == first[a_meta]), + ("새로 추가한 같은 이름 줄은 다른 키", first[b_new] != first[b_cou] and first[d_new] == first[b_new]), + ("끊긴 연결(carry_from NULL)은 이름이 같아도 붙이지 않음", first[e_cou] != first[a_cou]), + ("두 번 돌려도 같은 키(멱등)", first == second), + ("NOT NULL 제약", conn.execute( + "SELECT is_nullable FROM information_schema.columns WHERE table_schema = %s " + "AND table_name = 'goal_meeting_items' AND column_name = 'line_key'", (schema,)).fetchone()["is_nullable"] == "NO"), + ] + # UNIQUE(week_start, line_key) — 같은 주 같은 키는 막힌다 + try: + with conn.transaction(): + conn.execute("UPDATE goal_meeting_items SET line_key = %s WHERE id = %s", (first[b_cou], b_new)) + checks.append(("한 주 안 같은 키 금지(UNIQUE)", False)) + except psycopg.errors.UniqueViolation: + checks.append(("한 주 안 같은 키 금지(UNIQUE)", True)) + conn.rollback() # 아무것도 남기지 않는다 + + bad = [n for n, ok in checks if not ok] + for n, ok in checks: + print(("PASS " if ok else "FAIL ") + n) + print("ALL PASS" if not bad else f"{len(bad)} FAIL") + return 1 if bad else 0 + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/tests/test_project_module.py b/tests/test_project_module.py index 0b718eb..c5bf054 100644 --- a/tests/test_project_module.py +++ b/tests/test_project_module.py @@ -753,6 +753,207 @@ def test_goal_meetings(): pass +def _meet_weeks(seed: int, n: int) -> list[date]: + """지난 주들(실적 기간이 "진행 전"이 아니게) — test_goal_meetings(2001~2008)와 겹치지 않는 2010~2018 의 월요일 n 개.""" + base = date(2010, 1, 4) + timedelta(days=7 * ((int(RUN, 16) + seed * 60) % 400)) + assert base.weekday() == 0 + return [base + timedelta(days=7 * i) for i in range(n)] + + +def _drop_meetings(weeks: list[date]) -> None: + for w in weeks: + try: + ST.delete_meeting(week_start=w) + except KeyError: + pass + + +def _create_meeting(w: date) -> None: + r = req("POST", f"/project/api/goals/meetings/{w}", ADMIN, json={"year": w.year}) + assert r.status_code == 201, r.text + + +# ════════════════════════════════════════════════════════════ +# [G4·G5] 회의록 "지난주" — 정확히 7일 전 주, 생성 순서·이름 변경·같은 이름·삭제/재생성과 무관(018 line_key) +# ════════════════════════════════════════════════════════════ +def test_meeting_prev_week_links(): + """지난주 = 정확히 7일 전 주 회의록의 같은 연결키 줄. 018 미적용이면 carry_from 이 7일 전 주일 때만.""" + w0, w1, w2, w3 = _meet_weeks(1, 4) + _drop_meetings([w0, w1, w2, w3]) + with ST._pool.connection() as conn: # noqa: SLF001 + keyed = ST._meeting_keys(conn) # noqa: SLF001 + print(" meeting line_key(018):", "applied" if keyed else "not applied — carry_from fallback") + try: + # ① 역순 생성 — 다음 주(w3)를 먼저(양식), 앞 주(w2)를 나중에 + _create_meeting(w3) + _create_meeting(w2) + m3 = ST.get_meeting(week_start=w3) + assert m3["prev_meeting"] is not None and m3["prev_meeting"]["week_start"] == w2.isoformat() + if keyed: + assert all(it["prev"] is not None for it in m3["items"]), "역순 생성인데 지난주 줄이 빠짐" + for it in m3["items"]: + assert it["prev"]["week_start"] == w2.isoformat() + assert (it["prev"]["section"], it["prev"]["label"]) == (it["section"], it["label"]) + # 다른 구역의 같은 이름(마케팅 "네이버" ↔ 유통 "네이버")이 섞이지 않는다 + navers = [it for it in m3["items"] if it["label"] == "네이버"] + assert len(navers) == 2 and len({it["prev"]["id"] for it in navers}) == 2 + assert all(it["prev"]["section"] == it["section"] for it in navers) + else: + assert all(it["prev"] is None for it in m3["items"]), "018 미적용 — 역순 생성 연결은 안 됨(문서화된 제한)" + # ② 지난주(w2) 결과를 w2 줄에 저장 → w3 화면에서 보인다(그 주 데이터만) + m2 = ST.get_meeting(week_start=w2) + cou2 = next(it for it in m2["items"] if it["section"] == "유통" and it["label"] == "쿠팡") + assert req("PUT", f"/project/api/goals/meeting-items/{cou2['id']}", ADMIN, + json={"content": "w2 쿠팡 행사", "target_amount": "100", "result_amount": "50"}).status_code == 200 + cou3 = next(it for it in ST.get_meeting(week_start=w3)["items"] if it["section"] == "유통" and it["label"] == "쿠팡") + if keyed: + assert cou3["prev"]["id"] == cou2["id"] and cou3["prev"]["content"] == "w2 쿠팡 행사" + # ③ 이름 변경·순서 이동에도 연결 유지 + assert req("PUT", f"/project/api/goals/meeting-items/{cou3['id']}", ADMIN, json={"label": "쿠팡 로켓"}).status_code == 200 + assert req("POST", f"/project/api/goals/meeting-items/{cou3['id']}/move", ADMIN, json={"direction": -1}).status_code == 200 + again = next(it for it in ST.get_meeting(week_start=w3)["items"] if it["id"] == cou3["id"]) + assert again["prev"]["id"] == cou2["id"] + # ④ 같은 이름의 새 줄은 지난주와 연결되지 않고, 기존 줄 연결도 그대로 + r = req("POST", f"/project/api/goals/meetings/{w3}/items", ADMIN, + json={"section": "유통", "label": "쿠팡", "ref_item_id": cou3["id"], "place": "below"}) + new_id = r.json()["id"] + items3 = {it["id"]: it for it in ST.get_meeting(week_start=w3)["items"]} + assert items3[new_id]["prev"] is None and items3[cou3["id"]]["prev"]["id"] == cou2["id"] + # ⑤ 앞 주 삭제 → 지난주 칸 빔, 다시 만들면(앞선 회의록 없음 → 다음 주 w3 양식·키) 다시 연결 + ST.delete_meeting(week_start=w2) + assert all(it["prev"] is None for it in ST.get_meeting(week_start=w3)["items"]) + _create_meeting(w2) + items3 = {it["id"]: it for it in ST.get_meeting(week_start=w3)["items"]} + assert items3[cou3["id"]]["prev"] is not None and items3[cou3["id"]]["prev"]["week_start"] == w2.isoformat() + assert items3[cou3["id"]]["prev"]["content"] == "" # 새 회의록 — 예전 글이 섞이지 않는다 + # ⑥ 한 주 건너뜀 — w0 를 만들고 w1 없이 w2 를 보면 지난주(w1) 자료 없음(w0 결과를 지난주로 보이지 않음) + _drop_meetings([w2, w3]) + _create_meeting(w0) + cou0 = next(it for it in ST.get_meeting(week_start=w0)["items"] if it["section"] == "유통" and it["label"] == "쿠팡") + req("PUT", f"/project/api/goals/meeting-items/{cou0['id']}", ADMIN, json={"target_amount": "100", "result_amount": "50"}) + _create_meeting(w2) + m2 = ST.get_meeting(week_start=w2) + assert m2["prev_meeting"] is None and all(it["prev"] is None for it in m2["items"]) + v = req("GET", f"/project/api/goals/meetings/{w2}?year={w2.year}&month={w2.month}", ADMIN).json() + assert v["head"]["prev_exists"] is False and v["head"]["prev_target"] is None + assert all(it["rate"] is None for it in v["meeting"]["items"]) + # w1 을 만들면 w2 의 지난주 = w1(그 주 줄, 비어 있음) — w0 의 50/100 이 아니다 + _create_meeting(w1) + v = req("GET", f"/project/api/goals/meetings/{w2}?year={w2.year}&month={w2.month}", ADMIN).json() + assert v["head"]["prev_exists"] is True + prevs = [it["prev"] for it in v["meeting"]["items"] if it["prev"]] + if keyed: + assert prevs and all(p["week_start"] == w1.isoformat() for p in prevs) + assert all(p["week_start"] == w1.isoformat() for p in prevs) + assert all(it["rate"] is None for it in v["meeting"]["items"]) + finally: + _drop_meetings([w0, w1, w2, w3]) + + +# ════════════════════════════════════════════════════════════ +# [G6] 실적 조회 장애 ≠ 0원 — 목록 장애·매출 조회 장애·부분 실패·정상 0건·미연결·집계 쇼핑몰 없음 +# ════════════════════════════════════════════════════════════ +class _FakePerf: + def __init__(self, *, list_error=False, sales_error=None, markets=None, amounts=None): + self.list_error, self.sales_error = list_error, sales_error or (lambda a, b: False) + self.markets = markets if markets is not None else [ + {"code": "coupang", "name": "쿠팡", "enabled": True, "include_in_sales": True}] + self.amounts = amounts or {} + self.calls = [] + + def list_marketplaces(self): + if self.list_error: + raise RuntimeError("perf db down") + return self.markets + + def daily_amounts(self, start, end, codes): + self.calls.append((start, end)) + if self.sales_error(start, end): + raise RuntimeError("sales query failed") + return {(d, c): v for (d, c), v in self.amounts.items() if start <= d <= end and c in codes} + + def statuses(self): + return {"coupang": {"last_success_sync_at": "2026-10-01T14:20:00+09:00"}} + + +def test_meeting_perf_unknown_vs_zero(): + """실적 모듈 장애는 미확인(None + head.unknown), 정상 무매출만 0. 의존하는 필요 매출·달성률도 미확인.""" + from app.modules.project import store + + (w,) = _meet_weeks(2, 1) + # 그 달 셋째 주 — 월 누적(1일~지난주 일요일)과 전주 결과(지난주 월~일) 조회 기간이 서로 다르게 + weeks = store.month_weeks(w.year, w.month) + w = weeks[2][0] + month_first = date(w.year, w.month, 1) + _drop_meetings([w, w - timedelta(days=7)]) + orig_targets = ST.goal_month_targets + ST.goal_month_targets = lambda **kw: {"sales_unit": "원", "sales_target": 1000.0, "sales_actual": None, "roas_target": None} + try: + _create_meeting(w - timedelta(days=7)) + _create_meeting(w) + prev = ST.get_meeting(week_start=w - timedelta(days=7)) + cou_prev = next(it for it in prev["items"] if it["label"] == "쿠팡") + req("PUT", f"/project/api/goals/meeting-items/{cou_prev['id']}", ADMIN, json={"target_amount": "100"}) + url = f"/project/api/goals/meetings/{w}?year={w.year}&month={w.month}" + + def view(perf): + APP.state.performance_store = perf + try: + r = req("GET", url, ADMIN) + assert r.status_code == 200, r.text + return r.json() + finally: + APP.state.performance_store = None + + def coupang_row(v): + return next(it for it in v["meeting"]["items"] if it["label"] == "쿠팡" and it["section"] == "유통") + + # 실적 모듈 미연결 — perf False, 값 없음(미확인 아님) + v = view(None) + assert v["head"]["perf"] is False and v["head"]["perf_state"] == "off" and v["head"]["unknown"] == [] + # 쇼핑몰 목록 장애 — 0 이 아니라 미확인, 필요 매출도 계산하지 않음, 회의록은 열림 + v = view(_FakePerf(list_error=True)) + h = v["head"] + assert h["perf"] is True and h["perf_state"] == "error" + assert h["mtd"] is None and h["prev_result"] is None and h["need_per_week"] is None + assert {"mtd", "prev_result"} <= set(h["unknown"]), h + row = coupang_row(v) + assert row["prev"]["auto_error"] is True and row["prev"]["result"] is None and row["rate"] is None + assert row["market_unknown"] is True and row["market_off"] is False + assert v["markets"] == [] + # 매출 조회 장애(목록은 정상) — 전부 미확인 + v = view(_FakePerf(sales_error=lambda a, b: True)) + h = v["head"] + assert h["perf_state"] == "ok" and h["mtd"] is None and h["need_per_week"] is None + assert {"mtd", "prev_result"} <= set(h["unknown"]) + assert coupang_row(v)["prev"]["auto_error"] is True and coupang_row(v)["rate"] is None + # 정상 조회 0 건 — 진짜 0원(미확인 아님), 필요 매출 = 목표 ÷ 남은 주 + v = view(_FakePerf()) + h = v["head"] + assert h["mtd"] == 0 and h["prev_result"] == 0 and h["unknown"] == [], h + assert h["need_per_week"] == 1000 // h["weeks_left"] + row = coupang_row(v) + assert row["prev"]["auto_result"] == 0 and row["prev"]["auto_error"] is False and row["rate"] == 0.0 + assert h["fresh_oldest"] == "10/01 14:20" and "쿠팡 10/01 14:20" in h["fresh_tip"] + # 부분 실패 — 월 누적(1일부터) 조회만 실패: 누적·필요 매출만 미확인, 전주 결과·줄 결과는 정상 + prev_start = w - timedelta(days=7) + v = view(_FakePerf(sales_error=lambda a, b: a == month_first and a != prev_start, + amounts={(prev_start, "coupang"): 70})) + h = v["head"] + assert "mtd" in h["unknown"] and "prev_result" not in h["unknown"], h + assert h["mtd"] is None and h["need_per_week"] is None and h["prev_result"] == 70 + assert coupang_row(v)["prev"]["auto_result"] == 70 and coupang_row(v)["rate"] == 70.0 + # 매출 집계 쇼핑몰 없음 — 0 원으로 보이지 않게(empty, 미확인도 아님) + v = view(_FakePerf(markets=[{"code": "coupang", "name": "쿠팡", "enabled": True, "include_in_sales": False}])) + assert v["head"]["perf_state"] == "empty" and v["head"]["mtd"] is None and v["head"]["unknown"] == [] + # 금주 목표 저장 응답 = 서버 확정값(원 정수) + r = req("PUT", f"/project/api/goals/meetings/{w}", ADMIN, json={"week_target": "120만"}) + assert r.status_code == 200 and r.json()["week_target"] == 1_200_000 + finally: + ST.goal_month_targets = orig_targets + _drop_meetings([w, w - timedelta(days=7)]) + + if __name__ == "__main__": if not ENABLED: print("SKIP: PROJECT_TEST_DB_URL(localhost) not set")