From cd3577b299854395da6d2e1ed70a11cb49a4c60c Mon Sep 17 00:00:00 2001 From: king Date: Wed, 7 Oct 2026 11:24:41 +0900 Subject: [PATCH] feat(project): month-bounded meeting weeks, weekly sales targets, sticky header MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Weeks stay inside the month: week 1 starts on the 1st (through the next Sunday if the 1st is a weekend); a trailing Mon/Tue joins the last week. "Last week" is the previous period. - Prev-week review columns: 전주 업무 | 결과(text, new result_note) | 전주 목표 | 결과(amount). - Header now shows month target, cumulative weekly target, month-to-date sales and gap (amount + %), with decisions/notes beside it; the area stays fixed while scrolling. - Goals board: the monthly sales target is entered per week; the sum becomes the month target. - Migration 020: result_note, goal_week_targets, drop Monday-only check, move absorbed Monday meetings to the new week start. Co-Authored-By: Claude Opus 5.5 --- CLAUDE.md | 2 +- app/modules/project/db.py | 98 ++++++++++++- app/modules/project/router.py | 131 +++++++++-------- app/modules/project/store.py | 55 ++++++-- .../templates/project/goal_meeting.html | 116 ++++++--------- .../project/templates/project/goals.html | 13 +- .../project/templates/project/help.html | 56 ++++---- .../project/templates/project/inbox.html | 2 +- .../project/templates/project/mytasks.html | 2 +- .../project/templates/project/project.html | 2 +- .../project/templates/project/trash.html | 2 +- app/static/project.css | 60 ++++++-- app/static/project.js | 133 ++++++++++++++++-- docs/DEPLOYMENT.md | 13 ++ docs/PROJECT_MODULE.md | 40 +++++- .../sql/project_db_020_meeting_periods.sql | 89 ++++++++++++ tests/js/goals_meeting_ui.test.js | 54 +++++-- tests/js/help_ui.test.js | 2 +- tests/js/render_goals.py | 18 ++- tests/test_project_meeting_periods.py | 61 ++++++++ tests/test_project_module.py | 52 +++---- 21 files changed, 751 insertions(+), 250 deletions(-) create mode 100644 scripts/sql/project_db_020_meeting_periods.sql create mode 100644 tests/test_project_meeting_periods.py diff --git a/CLAUDE.md b/CLAUDE.md index ba8a6fe..4745165 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 — 지난주 = **정확히 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), 구역·항목 메뉴는 우클릭 + ⋮ 버튼(키보드·터치). ERP 메뉴 이름은 "Project"(`app/main.py` 모듈 목록 title). 댓글·답글 입력칸은 Enter 등록·Shift+Enter 줄바꿈(textarea), 설명란 이미지 더블클릭 = 별도 창 이미지 보기(확대·축소·끌어 이동). 작업 창은 **저장 버튼 없이 실시간 저장**(칸별 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/{월}`, 주차 탭 — **주차는 그 달 안**(`store.month_weeks`: 1일이 월~금이면 1일~일요일이 1주차, 토·일이면 1일~다음 주 일요일, 그 뒤 월~일, 말일이 월·화면 앞 주차에 붙음, 회의록 `week_start` = 주차 시작일, 마이그레이션 020), `goal_meetings`·`goal_meeting_items` 마이그레이션 015 — 지난주 = **바로 앞 주차**(`store.prev_week_period`) 회의록의 같은 연결키 줄(`line_key`, 마이그레이션 018 — 생성 순서·이름 변경과 무관, 이름 추정 연결 금지)로 리뷰(열: 주요 업무·정량 목표 ‖ 전주 업무·결과(글, `result_note` 020)·전주 목표·결과(금액)), 실적 조회 장애는 0원이 아니라 "미확인", 위에 목표 표 그 달 열 글을 영역별 "N월 계획" 카드로, 스크롤해도 고정되는 위쪽 영역 = 왼쪽 숫자 4칸(월 목표 매출·월 누적 목표 매출(목표 표 **주차별 매출 목표** `goal_week_targets` 1주차~이 주차 합 — 목표 표 매출 목표 월 칸을 누르면 주차 입력 창, 합계 = 월 목표)·월 누적 실적(1일~오늘)·누적 목표 대비 차액·%) | 오른쪽 결정 사항·메모, 실적 모듈 `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), 구역·항목 메뉴는 우클릭 + ⋮ 버튼(키보드·터치). ERP 메뉴 이름은 "Project"(`app/main.py` 모듈 목록 title). 댓글·답글 입력칸은 Enter 등록·Shift+Enter 줄바꿈(textarea), 설명란 이미지 더블클릭 = 별도 창 이미지 보기(확대·축소·끌어 이동). 작업 창은 **저장 버튼 없이 실시간 저장**(칸별 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 bfcdd73..e6be3eb 100644 --- a/app/modules/project/db.py +++ b/app/modules/project/db.py @@ -2535,7 +2535,21 @@ class ProjectStore: def _meeting_cols(self, conn: Any) -> str: return (self._MEETING_ITEM_COLS + (", line_key" if self._meeting_keys(conn) else "") - + (", content_row_span" if self._meeting_cells(conn) else "")) + + (", content_row_span" if self._meeting_cells(conn) else "") + + (", result_note" if self._meeting_v20(conn) else "")) + + def _meeting_v20(self, conn: Any) -> bool: + """마이그레이션 020 — 결과 글 칸(result_note)·월요일이 아닌 주차 시작일·주차별 목표(goal_week_targets).""" + if getattr(self, "_meeting_v20_ok", False): + return True + ok = self._column_exists(conn, "goal_meeting_items", "result_note") + if ok: + self._meeting_v20_ok = True + return ok + + def meetings_v20(self) -> bool: + with self._pool.connection() as conn: + return self._table_exists(conn, "goal_meetings") and self._meeting_v20(conn) def _meeting_cells(self, conn: Any) -> bool: if getattr(self, "_meeting_cells_ok", False): @@ -2591,7 +2605,7 @@ class ProjectStore: return out def meeting_weeks(self, *, start: date, end: date) -> list[str]: - """기간 안에 회의록이 있는 주(월요일) 목록.""" + """기간 안에 회의록이 있는 주차(시작일) 목록.""" with self._pool.connection() as conn: if not self._table_exists(conn, "goal_meetings"): return [] @@ -2604,7 +2618,7 @@ class ProjectStore: def get_meeting(self, *, week_start: date) -> dict[str, Any] | None: """한 주 회의록 — 머리(금주 목표·참석자·메모) + 줄(지난주 줄 prev 포함). 없으면 None. - "지난주"는 **정확히 7일 전 주(week_start − 7)** 만이다(몇 주 전 회의록을 지난주로 보이지 않게). + "지난주"는 **바로 앞 주차(store.prev_week_period)** 만이다(몇 주 전 회의록을 지난주로 보이지 않게). · prev_meeting = 그 주 회의록 머리(전주 목표), 그 주 회의록이 없으면 None. · 줄의 prev = 그 주 회의록에서 **같은 연결키(line_key, 마이그레이션 018)** 의 줄 — 생성 순서·이름 변경· 순서 이동과 무관하다. 018 미적용이면 예전 carry_from 을 쓰되 가리키는 줄이 정확히 7일 전 주일 때만. @@ -2614,13 +2628,14 @@ class ProjectStore: cols = self._meeting_cols(conn) keyed = self._meeting_keys(conn) cell_merges = self._meeting_cells(conn) + result_notes = self._meeting_v20(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) + prev_week = store.prev_week_period(week_start)[0] items = conn.execute( f"SELECT {cols} FROM goal_meeting_items WHERE week_start = %s " "ORDER BY sort_order, id", (week_start,), @@ -2653,6 +2668,7 @@ class ProjectStore: else None} if prev_head else None, "line_keys": keyed, "cell_merges": cell_merges, + "result_notes": result_notes, } def create_meeting(self, *, week_start: date, sections: list[tuple[str, str]], created_by: str = "") -> bool: @@ -2662,11 +2678,13 @@ class ProjectStore: ③ 둘 다 없으면 sections(목표 표 업무 영역 이름·색)마다 기본 양식 줄(store.MEETING_TEMPLATE). 이어받은 줄은 원본 줄의 연결키(line_key, 018)를 그대로 갖는다 → 생성 순서와 무관하게 7일 전 주의 같은 키 줄이 "지난주"가 된다. 새 줄(양식·줄 추가)은 새 키. carry_from 은 앞선 원본 줄일 때만 기록(이력, 화면 연결에는 안 씀).""" - ws = store.validate_week_start(week_start) + ws = store.validate_period_start(week_start) who = store.norm_str(created_by, lower=True) with self._pool.connection() as conn: with conn.transaction(): self._require_meetings(conn) + if ws.weekday() != 0 and not self._meeting_v20(conn): + raise store.MeetingMigration020Needed() # 월요일만 허용하던 CHECK 가 아직 있다 keyed = self._meeting_keys(conn) ins = conn.execute( "INSERT INTO goal_meetings (week_start, created_by, updated_by) VALUES (%s, %s, %s) " @@ -2817,8 +2835,8 @@ class ProjectStore: return new_id def update_meeting_item(self, *, item_id: int, fields: dict[str, Any], updated_by: str = "") -> dict[str, Any]: - """줄 칸 — label · content(이번주 할 일) · target_amount · result_amount(그 주 결과, 원) · status(평가) · - marketplace_code(실적 쇼핑몰 연결 — 결과 자동). 저장된 줄을 돌려준다.""" + """줄 칸 — label · content(주요 업무) · target_amount · result_amount(그 주 결과, 원) · result_note(그 주 결과 글, 020) · + status(평가, 화면에선 폐지) · marketplace_code(화면에선 폐지). 저장된 줄을 돌려준다.""" sets: list[str] = [] params: list[Any] = [] if "label" in fields: @@ -2837,6 +2855,9 @@ class ProjectStore: if "status" in fields: sets.append("status = %s") params.append(store.validate_meeting_status(fields["status"])) + if "result_note" in fields: + sets.append("result_note = %s") + params.append(store.validate_meeting_text(fields["result_note"], what="결과")) if "marketplace_code" in fields: code = store.norm_str(fields["marketplace_code"], lower=True) if len(code) > 30 or not re.fullmatch(r"[a-z0-9_]*", code): @@ -2846,6 +2867,8 @@ class ProjectStore: with self._pool.connection() as conn: with conn.transaction(): self._require_meetings(conn) + if "result_note" in fields and not self._meeting_v20(conn): + raise store.MeetingMigration020Needed() rows = self._locked_meeting_items(conn, item_id) if "content" in fields: self._require_meeting_cell_visible(rows, item_id) @@ -2976,6 +2999,67 @@ class ProjectStore: return {"sales_unit": head["sales_unit"] if head else "", "sales_target": vals.get(("sales", "target")), "sales_actual": vals.get(("sales", "actual")), "roas_target": vals.get(("roas", "target"))} + # ── 주차별 매출 목표(020) — 목표 표 매출 단위 그대로, 월 목표 = 그 달 주차 합계 ── + def week_targets_enabled(self) -> bool: + with self._pool.connection() as conn: + return self._table_exists(conn, "goal_week_targets") + + def goal_week_targets(self, *, start: date, end: date) -> dict[str, float]: + """기간 안 주차 시작일 → 목표(매출 단위). 020 미적용이면 빈 값.""" + with self._pool.connection() as conn: + if not self._table_exists(conn, "goal_week_targets"): + return {} + rows = conn.execute( + "SELECT week_start, value FROM goal_week_targets WHERE week_start BETWEEN %s AND %s ORDER BY week_start", + (start, end), + ).fetchall() + return {r["week_start"].isoformat(): float(r["value"]) for r in rows} + + def set_goal_week_targets( + self, *, year: int, month: int, values: dict[date, float | None], updated_by: str = "" + ) -> float | None: + """그 달 주차별 목표 저장(None = 지움) → 그 달 주차 합계를 매출 목표(goal_metrics sales/target)로. + 주차가 모두 비면 월 목표도 지운다(월 목표 = 주차 합계). 합계를 돌려준다(없으면 None).""" + m = store.validate_goal_month(month) + periods = {a for a, _ in store.month_weeks(year, m)} + if any(d not in periods for d in values): + raise ValueError("주차가 바뀌었습니다. 새로고침해 주세요.") + who = store.norm_str(updated_by, lower=True) + with self._pool.connection() as conn: + with conn.transaction(): + if not self._table_exists(conn, "goal_week_targets"): + raise store.MeetingMigration020Needed() + if not conn.execute("SELECT 1 FROM goal_years WHERE year = %s FOR UPDATE", (year,)).fetchone(): + raise KeyError(year) + for d, v in values.items(): + if v is None: + conn.execute("DELETE FROM goal_week_targets WHERE week_start = %s", (d,)) + else: + if v < 0: + raise ValueError("주차 목표는 0 이상이어야 합니다.") + conn.execute( + "INSERT INTO goal_week_targets (week_start, year, month, value, updated_by) " + "VALUES (%s,%s,%s,%s,%s) ON CONFLICT (week_start) DO UPDATE " + "SET value = EXCLUDED.value, updated_by = EXCLUDED.updated_by, updated_at = now()", + (d, year, m, v, who), + ) + row = conn.execute( + "SELECT count(*) AS n, sum(value) AS total FROM goal_week_targets WHERE year = %s AND month = %s", + (year, m), + ).fetchone() + total = float(row["total"]) if row["n"] else None + if total is None: + conn.execute("DELETE FROM goal_metrics WHERE year=%s AND metric='sales' AND kind='target' AND month=%s", + (year, m)) + else: + conn.execute( + "INSERT INTO goal_metrics (year, metric, kind, month, value, updated_by) " + "VALUES (%s,'sales','target',%s,%s,%s) ON CONFLICT (year, metric, kind, month) DO UPDATE " + "SET value = EXCLUDED.value, updated_by = EXCLUDED.updated_by, updated_at = now()", + (year, m, total, who), + ) + return total + def goal_area_sections(self, *, year: int) -> list[tuple[str, str]]: """그 해 목표 표의 업무 영역(이름, 색) — 첫 회의록 구역. 없으면 빈 목록(기본 양식 구역).""" with self._pool.connection() as conn: diff --git a/app/modules/project/router.py b/app/modules/project/router.py index 32eb151..b1289b2 100644 --- a/app/modules/project/router.py +++ b/app/modules/project/router.py @@ -2600,6 +2600,8 @@ def _goal_call(fn: Any, *args: Any, **kwargs: Any) -> Any: raise HTTPException(status_code=503, detail=_GOALS_017_MSG) except store.MeetingCellMigrationNeeded: raise HTTPException(status_code=503, detail="회의록 셀 병합은 project_db 마이그레이션 019 적용 후 사용할 수 있습니다.") + except store.MeetingMigration020Needed: + raise HTTPException(status_code=503, detail="새 주차·결과 글·주차별 목표는 project_db 마이그레이션 020 적용 후 사용할 수 있습니다.") except store.GoalCellConflict as exc: raise HTTPException(status_code=409, detail=str(exc)) except UndefinedTable: @@ -2644,6 +2646,13 @@ def goals_page(request: Request, year: int) -> HTMLResponse: for area in board["areas"]: _goal_area_layout(area["rows"], this_month) _goal_label_spans(area["rows"]) + # 주차별 매출 목표(020) — 월 매출 목표 칸을 누르면 그 달 주차별 입력 창(합계 = 월 목표) + week_targets = None + if board and st.week_targets_enabled(): + saved = st.goal_week_targets(start=date(year, 1, 1), end=date(year, 12, 31)) + week_targets = {mo: [{"start": a.isoformat(), "n": i + 1, "label": f"{a.month}/{a.day}~{b.month}/{b.day}", + "value": _goal_label("sales", saved.get(a.isoformat()))} + for i, (a, b) in enumerate(store.month_weeks(year, mo))] for mo in range(1, 13)} return render_template( request, "project/goals.html", @@ -2670,10 +2679,25 @@ def goals_page(request: Request, year: int) -> HTMLResponse: for q in (1, 2, 3, 4)], "this_month": this_month, "goal_area_colors": list(store.GOAL_AREA_COLORS), + "week_targets": week_targets, }, ) +@router.put("/api/goals/{year}/week-targets/{month}") +def api_set_goal_week_targets(request: Request, year: int, month: int, payload: dict[str, Any] = Body(...)) -> JSONResponse: + """그 달 주차별 매출 목표 {weeks: {주차 시작일: 값|""}} — 합계가 그 달 매출 목표가 된다(관리자).""" + user = _require_admin(request) + st = _db_or_503(request) + raw = payload.get("weeks") + if not isinstance(raw, dict) or len(raw) > 6: + raise HTTPException(status_code=400, detail="weeks 가 올바르지 않습니다.") + values = {_goal_call(store.validate_period_start, k): _goal_call(store.validate_goal_value, v) for k, v in raw.items()} + total = _goal_call(st.set_goal_week_targets, year=year, month=month, values=values, updated_by=user["email"]) + return JSONResponse({"ok": True, "value": total, "label": _goal_label("sales", total), + "weeks": {k.isoformat(): _goal_label("sales", v) for k, v in values.items()}}) + + @router.post("/api/goals/years") def api_create_goal_year(request: Request, payload: dict[str, Any] = Body(...)) -> JSONResponse: """연도 추가(관리자) — 가장 가까운 이전 연도의 영역·줄 구조를 글 없이 복사.""" @@ -2697,11 +2721,11 @@ def api_goal_meeting_nav(request: Request) -> JSONResponse: mon = store.validate_week_start(value) if mon.year not in years: continue - end = mon + timedelta(days=6) - # 달이 바뀌어도 월요일이 속한 월 아래에 한 번만 표시한다. - number = next(i + 1 for i, (w, _) in enumerate(store.month_weeks(mon.year, mon.month)) if w == mon) + # 주차는 달을 넘지 않는다(020) — 회의록 시작일이 든 주차 + a, end = store.week_period(mon) + number = store.week_number(mon) grouped.setdefault(mon.year, {}).setdefault(mon.month, []).append({ - "start": mon.isoformat(), "label": f"{number}주차 ({mon.month}/{mon.day}~{end.month}/{end.day})", + "start": mon.isoformat(), "label": f"{number}주차 ({a.month}/{a.day}~{end.month}/{end.day})", "href": f"/project/goals/{mon.year}/meetings/{mon.month}?week={mon.isoformat()}", }) return JSONResponse({"years": [ @@ -2876,9 +2900,9 @@ def api_unmerge_goal_cells(request: Request, row_id: int, start: int) -> JSONRes # ════════════════════════════════════════════════════════════ -# 주간 회의록 (마이그레이션 015) — 목표 표 월 머리 → /project/goals/{연도}/meetings/{월}?week=월요일 -# 주 = 월요일~일요일. 지난주 목표·결과 리뷰 → 월 목표 달성을 위한 이번주 목표·할 일. -# 쇼핑몰 연결(유통 줄) 결과·전주/금주 매출·월 누적은 실적 모듈(performance_db)에서 읽기만 한다. +# 주간 회의록 (마이그레이션 015·020) — 목표 표 월 머리 → /project/goals/{연도}/meetings/{월}?week=주차 시작일 +# 주차 = store.month_weeks(그 달 안, 1주차는 1일부터). 지난 주차 업무·결과 리뷰 → 이번 주차 주요 업무·목표. +# 월 누적 실적은 실적 모듈(performance_db)에서 읽기만, 월 누적 목표는 목표 표 주차별 목표(goal_week_targets) 합. # ════════════════════════════════════════════════════════════ def _perf_sales(request: Request) -> Any: """실적 모듈 저장소(읽기 전용). 없거나 오류면 None — 회의록은 직접 입력만으로도 동작한다.""" @@ -2975,21 +2999,21 @@ def _kst_short(iso: str) -> str: 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% 로 보이지 않게, 그 값에 기대는 달성률·필요 매출도 계산하지 않는다).""" + "지난주"는 바로 앞 주차(store.prev_week_period)만 — 줄의 지난주 칸이 그 주차 회의록의 같은 연결키 줄이다. + 월 누적 목표 = 1주차~이 주차의 주차별 목표 합(목표 표 매출 단위 → 원), 월 누적 실적 = 1일~오늘(지난 주차면 그 끝날). + 실적은 _MeetingPerf — 알 수 없는 값은 None + head.unknown 에 이름(0 원·0% 로 보이지 않게).""" today = today_kst() + week_end = store.week_period(week)[1] + prev_start, _prev_end = store.prev_week_period(week) 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 = _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) + last = store.month_last_day(year, month) unknown: list[str] = [] def total(key: str, a: date, b: date) -> int | None: @@ -2998,26 +3022,27 @@ def _meeting_view(request: Request, st: Any, *, year: int, month: int, week: dat 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("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 # 정확히 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 + try: + wt = st.goal_week_targets(start=first, end=last) + except Exception: # noqa: BLE001 — 주차 목표를 못 읽어도 회의록은 열린다 + logger.warning("goal week targets unavailable for meeting", exc_info=True) + wt = {} + cum_unit = sum(v for k, v in wt.items() if k <= week.isoformat()) if wt else None + cum_target_won = int(round(cum_unit * mult)) if cum_unit is not None and mult else None + mtd_end = min(last, today, week_end) + mtd = total("mtd", first, mtd_end) if mtd_end >= first else None # 아직 시작 전 달은 비움 + gap = mtd - cum_target_won if mtd is not None and cum_target_won is not None else None + rate = round(mtd / cum_target_won * 100, 1) if mtd is not None and cum_target_won else None + pm = meeting.get("prev_meeting") if meeting else None 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, + "month_target_won": month_target_won, + "week_targets_set": bool(wt), "cum_target": cum_unit, "cum_target_won": cum_target_won, + "mtd": mtd, "mtd_end": mtd_end.isoformat() if mtd_end >= first else "", "gap": gap, "rate": rate, "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·unknown "perf": perf.state != "off", "perf_state": perf.state, "unknown": unknown, @@ -3134,18 +3159,21 @@ def goal_meeting_page(request: Request, year: int, month: int, week: str | None sel = None if week: try: - sel = store.validate_week_start(week) + sel = store.week_period(store.validate_week_start(week))[0] # 예전 월요일 주소도 그 날짜가 든 주차로 except ValueError: sel = None if sel is not None and (sel.year, sel.month) != (year, month): - # 다른 달의 주(주는 월요일이 속한 달의 것) — 그 달 회의록 주소로 + # 다른 달의 주차 — 그 달 회의록 주소로 return RedirectResponse(url=f"/project/goals/{sel.year}/meetings/{sel.month}?week={sel.isoformat()}" + ("&content=1" if content else ""), status_code=303) - if sel is None or sel not in [w for w, _ in weeks]: + if sel is None: sel = next((w for w, e in weeks if w <= today <= e), weeks[0][0]) enabled = st.meetings_enabled() cal = store.calendar_weeks(year, month) - existing = set(st.meeting_weeks(start=cal[0][0], end=cal[-1][0])) if enabled else set() + existing = set(st.meeting_weeks(start=cal[0][0], end=cal[-1][1])) if enabled else set() + first = date(year, month, 1) + sel_end = store.week_period(sel)[1] + prev_start, prev_end = store.prev_week_period(sel) view = _meeting_view(request, st, year=year, month=month, week=sel) if enabled else {} members = _meet_members() admin = is_admin(user) @@ -3171,34 +3199,25 @@ def goal_meeting_page(request: Request, year: int, month: int, week: str | None "meeting_embedded": content, "meetings_enabled": enabled, "weeks": [{"start": w.isoformat(), "end": e.isoformat(), "n": i + 1, "label": f"{w.month}/{w.day}~{e.month}/{e.day}", - "has": w.isoformat() in existing, "now": w <= today <= e, - # 작은 달력(월요일 시작) 한 줄 — 날짜·그 달 여부·오늘·요일(5 토, 6 일)·공휴일 - "days": [{"d": (w + timedelta(days=k)).day, "iso": (w + timedelta(days=k)).isoformat(), - "in": (w + timedelta(days=k)).month == month, "today": w + timedelta(days=k) == today, - "wd": k, "hol": store.KR_HOLIDAYS.get((w + timedelta(days=k)).isoformat(), "")} - for k in range(7)]} + "has": w.isoformat() in existing, "now": w <= today <= e} for i, (w, e) in enumerate(weeks)], - # 작은 달력 — 그 달 날짜가 든 주 전부(앞뒤 달에 속한 주는 흐리게, 누르면 그 달 회의록) - "cal_weeks": [{"start": w.isoformat(), "own": (w.year, w.month) == (year, month), - "href": (f"?week={w.isoformat()}" if (w.year, w.month) == (year, month) - else f"/project/goals/{w.year}/meetings/{w.month}?week={w.isoformat()}"), - "title": (f"{next(i + 1 for i, (x, _) in enumerate(weeks) if x == w)}주차" - if (w.year, w.month) == (year, month) else f"{w.month}월 주") - + f" ({w.month}/{w.day}~{e.month}/{e.day})", - "has": w.isoformat() in existing, + # 작은 달력(월요일 시작 줄) — 줄을 누르면 그 줄의 이 달 날짜가 든 주차 회의록(주차는 줄과 꼭 같지 않다) + "cal_weeks": [{"start": p[0].isoformat(), "own": True, "href": f"?week={p[0].isoformat()}", + "title": f"{store.week_number(p[0])}주차 ({p[0].month}/{p[0].day}~{p[1].month}/{p[1].day})", + "has": p[0].isoformat() in existing, "days": [{"d": (w + timedelta(days=k)).day, "in": (w + timedelta(days=k)).month == month, "today": w + timedelta(days=k) == today, "wd": k, "hol": store.KR_HOLIDAYS.get((w + timedelta(days=k)).isoformat(), "")} for k in range(7)]} - for w, e in store.calendar_weeks(year, month)], + for w, e in cal for p in [store.week_period(max(w, first))]], "week": sel.isoformat(), - "week_n": next(i + 1 for i, (w, _) in enumerate(weeks) if w == sel), - "week_end": (sel + timedelta(days=6)).isoformat(), - "prev_week": (sel - timedelta(days=7)).isoformat(), - "prev_week_end": (sel - timedelta(days=1)).isoformat(), - # 주차를 열면 다시 받을 매출 기간(실적 모듈 매출 업데이트) — 지난주 월요일 ~ 이번 주 일요일(오늘까지) - "sync_from": (sel - timedelta(days=7)).isoformat() if sel - timedelta(days=7) <= today else "", - "sync_to": min(sel + timedelta(days=6), today).isoformat(), + "week_n": store.week_number(sel), + "week_end": sel_end.isoformat(), + "prev_week": prev_start.isoformat(), + "prev_week_end": prev_end.isoformat(), + # 주차를 열면 다시 받을 매출 기간(실적 모듈 매출 업데이트) — 지난 주차 시작 ~ 이 주차 끝(오늘까지) + "sync_from": prev_start.isoformat() if prev_start <= today else "", + "sync_to": min(sel_end, today).isoformat(), # 쇼핑몰 매출 갱신(실적 모듈 POST /performance/api/sync)은 실적 모듈 권한자만 — 없으면 화면이 부르지 않는다 "can_sync": has_module(user, "performance"), "meeting_status": store.MEETING_STATUS, @@ -3227,7 +3246,7 @@ def api_create_meeting(request: Request, week_start: str, payload: dict[str, Any """회의록 만들기(관리자) — 앞선 회의록 줄을 이어받거나, 처음이면 그 해 목표 표 업무 영역 + 기본 양식 줄.""" user = _require_admin(request) st = _db_or_503(request) - ws = _goal_call(store.validate_week_start, week_start) + ws = _goal_call(store.validate_period_start, week_start) year = _goal_call(store.validate_goal_year, payload.get("year") or ws.year) created = _goal_call(st.create_meeting, week_start=ws, sections=st.goal_area_sections(year=year), created_by=user["email"]) diff --git a/app/modules/project/store.py b/app/modules/project/store.py index 5561a28..a7f1383 100644 --- a/app/modules/project/store.py +++ b/app/modules/project/store.py @@ -405,6 +405,10 @@ class MeetingCellMigrationNeeded(RuntimeError): """회의록 셀 병합 메타데이터(019)가 아직 없다.""" +class MeetingMigration020Needed(RuntimeError): + """새 주차(월요일이 아닌 시작일)·결과 글 칸·주차별 목표는 마이그레이션 020 뒤에만 된다.""" + + GOAL_YEAR = 0 # 업무 영역 글 칸 — 연간 # 분기 글 칸(2026-10-01 상·하반기 → 1~4분기). 칸 번호는 예전 반기 칸을 그대로 이어 쓴다 — 데이터 옮기기 없이 # 예전 상반기 글(13)은 1분기, 하반기 글(14)은 3분기에 보인다. 2분기(15)·4분기(16)는 마이그레이션 017 뒤에 저장. @@ -663,20 +667,44 @@ def month_last_day(year: int, month: int) -> date: def month_weeks(year: int, month: int) -> list[tuple[date, date]]: - """그 달의 주(월요일~일요일) 목록 — **1주차 = 그 달 첫 월요일이 있는 주**, 주는 월요일이 속한 달의 것 - (2026-10-01 사용자 기준). 예: 2026년 10월 = 10/5·12·19·26 주, 9/28~10/4 주는 9월 마지막 주. - 월간 목표·누적은 이와 따로 늘 1일~말일.""" + """그 달의 주차(시작일, 끝일) — 2026-10-07 사용자 기준. 주차는 늘 그 달 안(달을 넘지 않는다). + · 1일이 월~금이면 1주차 = 1일 ~ 그 주 일요일(월요일 시작이 아니어도 1주차) + · 1일이 토·일이면 1주차 = 1일 ~ 다음 주 일요일(토·일 + 다음 월~일) + · 그 뒤는 월~일. 말일이 월·화이면 그 하루·이틀은 앞 주차에 붙는다(마지막 주차 = 월~다음 주 월·화). + 예: 2026년 10월(1일 목·31일 토) = 10/1~4 · 5~11 · 12~18 · 19~25 · 26~31. + 월간 목표·누적은 늘 1일~말일.""" first = date(year, month, 1) last = month_last_day(year, month) - out, mon = [], first + timedelta(days=(7 - first.weekday()) % 7) - while mon <= last: - out.append((mon, mon + timedelta(days=6))) - mon += timedelta(days=7) + wd = first.weekday() + end = first + timedelta(days=6 - wd + (7 if wd >= 5 else 0)) + out = [(first, end)] + s = end + timedelta(days=1) + while s <= last: + out.append((s, min(s + timedelta(days=6), last))) + s += timedelta(days=7) + if len(out) > 1 and last.weekday() <= 1: # 말일이 월·화 — 앞 주차에 붙인다 + out.pop() + out[-1] = (out[-1][0], last) return out +def week_period(d: date) -> tuple[date, date]: + """그 날짜가 든 주차(시작일, 끝일).""" + return next(p for p in month_weeks(d.year, d.month) if p[0] <= d <= p[1]) + + +def prev_week_period(start: date) -> tuple[date, date]: + """바로 앞 주차(앞 달 마지막 주차일 수 있다) — 회의록의 "지난주".""" + return week_period(start - timedelta(days=1)) + + +def week_number(start: date) -> int: + """주차 시작일 → 그 달 몇 주차(1부터). 주차 시작일이 아니면 그 날짜가 든 주차.""" + return next(i + 1 for i, (a, b) in enumerate(month_weeks(start.year, start.month)) if a <= start <= b) + + def calendar_weeks(year: int, month: int) -> list[tuple[date, date]]: - """작은 달력용 — 그 달 날짜가 하나라도 든 주(월요일 시작) 전부(1일이 든 주부터 말일이 든 주까지).""" + """작은 달력용 — 그 달 날짜가 하나라도 든 줄(월요일 시작) 전부(1일이 든 줄부터 말일이 든 줄까지).""" first, last = date(year, month, 1), month_last_day(year, month) out, mon = [], week_monday(first) while mon <= last: @@ -686,17 +714,24 @@ def calendar_weeks(year: int, month: int) -> list[tuple[date, date]]: def validate_week_start(v: Any) -> date: + """회의록 시작일(날짜) — 020 부터 월요일이 아닐 수 있다. 주차 시작일인지는 validate_period_start.""" try: d = date.fromisoformat(str(v).strip()[:10]) except ValueError: raise ValueError("주 시작일이 올바르지 않습니다.") - if d.weekday() != 0: - raise ValueError("주 시작일은 월요일이어야 합니다.") if not 2000 <= d.year <= 2100: raise ValueError("주 시작일이 올바르지 않습니다.") return d +def validate_period_start(v: Any) -> date: + """주차 시작일만(month_weeks 의 시작일) — 새 회의록·주차별 목표.""" + d = validate_week_start(v) + if week_period(d)[0] != d: + raise ValueError("주차 시작일이 아닙니다. 새로고침해 주세요.") + return d + + def _korean_amount(s: str) -> float: """"1억2천만"·"3천만"·"1.5억"·"120만"·"3천5백" → 숫자. 단위 없는 숫자는 그대로. 틀리면 ValueError.""" def small(t: str) -> float: # 만 아래 자리 — 천·백·십 diff --git a/app/modules/project/templates/project/goal_meeting.html b/app/modules/project/templates/project/goal_meeting.html index 23e65c7..47dbe81 100644 --- a/app/modules/project/templates/project/goal_meeting.html +++ b/app/modules/project/templates/project/goal_meeting.html @@ -1,7 +1,7 @@ {% extends "project/_meeting_content_base.html" if meeting_embedded else "erp_base.html" %} {% block head_extra %} - + {% endblock %} @@ -11,11 +11,11 @@ {%- macro num(v) -%}{% if v is not none %}{% if v == v | int %}{{ "{:,}".format(v | int) }}{% else %}{{ "{:,.2f}".format(v) }}{% endif %}{% endif %}{%- endmacro -%} {% block content %} -{# 주간 회의록 — 목표 표 월 머리를 누르면 열린다(/project/goals/{연도}/meetings/{월}?week=월요일). - 주(월~일)마다 회의록 하나: 머리(월 목표·지난주까지 누적·주당 필요 매출, 전주 목표·결과, 금주 목표·현재) - + 구역(목표 표 업무 영역)별 줄 — 주요 업무·정량 목표 | 지난주: 결과(지난주 할 일)·전주 목표·정량 목표(결과 금액). - 전주 칸은 지난 회의록의 같은 줄(carry_from). 전주/금주 매출·누적(머리 카드)은 실적 모듈에서 자동, 줄 결과는 직접 입력. - 입력은 관리자만(칸별 즉시 저장, project.js initGoalMeeting). DB: project_db 015 (goal_meetings·goal_meeting_items). #} +{# 주간 회의록 — 목표 표 월 머리를 누르면 열린다(/project/goals/{연도}/meetings/{월}?week=주차 시작일). + 주차(store.month_weeks — 그 달 안, 1주차는 1일부터)마다 회의록 하나: 위쪽 고정 영역(왼쪽 숫자 4칸 | 오른쪽 결정 사항·메모) + + 구역(목표 표 업무 영역)별 줄 — 주요 업무·정량 목표 | 지난주: 전주 업무·결과(글)·전주 목표·결과(금액). + 지난주 칸은 바로 앞 주차 회의록의 같은 줄(연결키). 월 누적 실적은 실적 모듈, 월 누적 목표는 목표 표 주차별 목표 합. + 입력은 관리자만(칸별 즉시 저장, project.js initGoalMeeting). DB: project_db 015·020. #}
{% if not meeting_embedded %}{% with current_pid = 0, side_active = "goals" %}{% include "project/_side.html" %}{% endwith %}{% endif %} @@ -39,12 +39,12 @@ {% else %}회의록은 관리자만 입력할 수 있습니다.{% endif %} {% endif %} - {# 주차 탭 — 주 = 월요일~일요일, 1주차 = 그 달 첫 월요일이 있는 주(주는 월요일이 속한 달). 점 = 회의록 있음 #} + {# 주차 탭 — 주차는 그 달 안(1일이 월~금이면 1일~일요일, 토·일이면 1일~다음 주 일요일, 말일이 월·화면 앞 주차에 붙음). 점 = 회의록 있음 #}
- {# 작은 달력 — 월요일 시작(주 = 월~일), 보고 있는 주는 영역 표시, 줄을 누르면 그 주 회의록. 점 = 회의록 있음. - 1주차 = 그 달 첫 월요일이 있는 주 — 1일 앞쪽 날짜가 든 주는 앞 달 주(흐리게, 누르면 앞 달 회의록). #} + {# 작은 달력 — 월요일 시작 줄, 줄을 누르면 그 줄의 이 달 날짜가 든 주차 회의록(보고 있는 주차의 줄은 영역 표시). 점 = 회의록 있음. #}
{{ goal_year }}년 {{ goal_month }}월
월화수목금토일
{% for w in cal_weeks %}
+ title="{{ w.title }}{% if w.has %} · 회의록 있음{% endif %}"> {% for d in w.days %}{{ d.d }}{% endfor %} {% if w.has %}{% endif %} @@ -97,7 +96,7 @@

{{ week_n }}주차({{ week }} ~ {{ week_end }}) 회의록이 아직 없습니다.

{% if is_admin %} -

만들면 앞선 회의록의 줄(구역·항목)을 이어받아, 지난주 할 일·목표·결과를 나란히 리뷰할 수 있습니다. +

만들면 앞선 회의록의 줄(구역·항목)을 이어받아, 지난주 업무·목표·결과를 나란히 리뷰할 수 있습니다. 처음이면 {{ goal_year }}년 목표 표의 업무 영역과 기본 양식 줄로 시작합니다.

{% endif %} @@ -107,63 +106,40 @@ {% set edit = is_admin %} {% set unk = h.unknown or [] %} {%- macro unknown_val() -%}미확인{%- endmacro -%} - {# ── 숫자 — 한 줄 막대(월 목표 대비 누적·남은 주 필요 매출 | 전주 리뷰 | 금주 목표) ── #} + {# ── 위쪽 고정 영역(스크롤해도 보임) — 왼쪽 절반: 숫자 4칸 / 오른쪽 절반: 결정 사항·메모. + 높이는 project.js initMeetTop 이 --pj-meet-top-h 로 알려 표 머리 줄이 그 아래에 붙는다 ── #} +
-
월 목표 매출 {% 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 %}
+
+ 월 누적 목표 매출 ({{ week_n }}주차까지) + {% if h.cum_target_won is not none %}{{ won(h.cum_target_won) }}원{% else %}—{% endif %} + {% if not h.week_targets_set %}목표 표에서 주차별 목표 입력{% endif %} +
- 월 누적 실적 (지난주까지) + 월 누적 실적 {% if h.mtd_end %}({{ h.mtd_end[5:] | replace('-', '/') }}까지){% 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) }}원{% elif 'mtd' in unk and h.month_target_won is not none %}{{ unknown_val() }}{% else %}—{% endif %} -
-
- 목표 ROAS - {% if h.roas_target is not none %}{{ num(h.roas_target) }}%{% else %}—{% endif %} -
-
-
-
- 전주 목표 - {% 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) }}원{% 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() }} +
+ 누적 목표 대비 달성 + {% if h.gap is not none %} + {{ '+' if h.gap > 0 else '' }}{{ won(h.gap) }}원 + {% if h.rate is not none %}{{ h.rate }}%{% endif %} + {% elif 'mtd' in unk and h.cum_target_won is not none %}{{ unknown_val() }} {% else %}—{% endif %}
-
- 금주 목표 - {% if edit %} - 원 - {% else %} - {% if meeting.week_target is not none %}{{ won(meeting.week_target) }}원{% else %}—{% endif %} - {% 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) }}원{% 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 edit %} + {% else %}
{{ meeting.notes or '—' }}
{% endif %}
- {# 매출 자료 갱신 — 주차를 열면 실적 모듈 매출 업데이트(지난주 월요일 ~ 이번 주 오늘)를 한 번 더 돌리고 숫자 칸만 다시 그린다 + {# 매출 자료 갱신 — 주차를 열면 실적 모듈 매출 업데이트(지난 주차 시작 ~ 이 주차 오늘)를 한 번 더 돌리고 숫자 칸만 다시 그린다 (project.js initMeetingSync, 같은 주는 10분에 한 번). 정상이면 아무것도 보이지 않는다(2026-10-01 요청 — 큰 상태 줄 없음). 실패·일부 실패면 이 작은 안내 + [다시 시도], 실적 권한이 없으면 부르지 않고 한 줄 설명. 마지막 갱신 성공 시각은 서버 기록(data-fresh). #} {% if h.perf and sync_from %} @@ -286,5 +262,5 @@ - + {% endblock %} diff --git a/app/modules/project/templates/project/goals.html b/app/modules/project/templates/project/goals.html index 545e521..9d2e6e8 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 %} @@ -56,14 +56,18 @@ {% set rm = board.metrics.roas %} {# 월 칸은 pj-goal-m + data-h(분기 1~4) — 분기 접기(initGoals)가 이걸로 숨긴다. 분기 칸 클래스는 예전 이름 pj-goal-half-col 그대로(연간 칸처럼 굵게·회색 합계) #} + {# 매출 목표 칸(020) — 누르면 그 달 주차별 목표 입력 창(project.js initGoalWeekTargets), 합계 = 월 목표 #} {% macro num_cell(metric, kind, labels, mo) -%} - + {%- set weekly = week_targets and metric == 'sales' and kind == 'target' -%} + {%- if is_admin -%} {%- else -%} - {{ labels.get(mo, '') }} + {{ labels.get(mo, '') }} {%- endif -%} {%- endmacro %} @@ -198,9 +202,10 @@
{% if goal_area_colors %}{% endif %} +{% if week_targets %}{% endif %} {% 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 9aedb95..3ccdb4e 100644 --- a/app/modules/project/templates/project/help.html +++ b/app/modules/project/templates/project/help.html @@ -518,7 +518,8 @@

매출·로아스 입력과 달성률 계산

- + + @@ -575,9 +576,15 @@
  1. 왼쪽 목표에서 연도를 선택하고 표 머리의 월 이름을 누릅니다.
  2. 이미 만든 회의록은 왼쪽 목표 연도 아래의 월 폴더에서도 열 수 있습니다. 폴더 아이콘과 월 이름을 눌러 접거나 펼치고, 주차·날짜 항목을 누르면 오른쪽 회의록만 바뀝니다. 왼쪽 메뉴와 스크롤 위치는 유지됩니다. 입력한 칸은 이동 전에 저장하며, 저장에 실패하면 현재 회의록을 유지합니다. 접기·펼치기는 이 브라우저에 기억됩니다.
  3. -
  4. 위쪽 주차 탭 또는 오른쪽 작은 달력의 주 한 줄을 눌러 주를 고릅니다. 점은 회의록이 있는 주, 이번 주는 현재 주입니다. 이전·다음 달 버튼으로 달을 바꿉니다.
  5. -
  6. 한 주는 월요일~일요일이고, 월요일이 속한 달의 회의록입니다. 1주차는 그 달 첫 월요일이 있는 주입니다. 예: 2026년 10월 1주차는 10/5~10/11이며, 9/28~10/4는 9월 회의록입니다.
  7. -
  8. 작은 달력의 흐린 앞 달 주를 누르면 그 달 회의록으로 갑니다. 해당 연도 목표 버튼은 연간 목표 표로 돌아갑니다.
  9. +
  10. 위쪽 주차 탭 또는 오른쪽 작은 달력의 한 줄을 눌러 주차를 고릅니다. 달력 줄을 누르면 그 줄의 이 달 날짜가 든 주차가 열립니다. 점은 회의록이 있는 주차, 이번 주는 현재 주차입니다. 이전·다음 달 버튼으로 달을 바꿉니다.
  11. +
  12. 주차는 그 달 안에서만 나눕니다. 기본은 월요일~일요일입니다. +
      +
    • 1일이 월~금요일이면 1일부터 그 주 일요일까지가 1주차입니다. 예: 2026년 10월 1주차는 10/1(목)~10/4.
    • +
    • 1일이 토·일요일이면 1일부터 다음 주 일요일까지가 1주차입니다. 예: 2026년 8월 1주차는 8/1(토)~8/9.
    • +
    • 말일이 월·화요일이면 그 하루·이틀은 앞 주차에 붙습니다. 예: 2026년 8월 마지막 주차는 8/24~8/31(월).
    • +
    +
  13. +
  14. 해당 연도 목표 버튼은 연간 목표 표로 돌아갑니다.

회의록 만들기와 이어받는 항목

@@ -585,31 +592,29 @@
  • 줄이 있는 가장 가까운 앞선 회의록에서 구역·항목 이름·색·순서를 이어받습니다. 앞선 회의록이 없으면 가장 가까운 다음 회의록의 구성을 가져옵니다.
  • 어느 쪽에도 회의록이 없으면 해당 연도 목표 표의 업무 영역과 기본 양식으로 시작합니다.
  • -
  • 주요 업무·금액·메모는 새로 적습니다. 구성을 이어받는 것과 지난주 리뷰는 다릅니다. 리뷰에는 정확히 7일 전 주의 같은 항목만 표시됩니다.
  • +
  • 주요 업무·금액·메모는 새로 적습니다. 구성을 이어받는 것과 지난주 리뷰는 다릅니다. 리뷰에는 바로 앞 주차의 같은 항목만 표시됩니다.

이 달 계획 확인

제목 아래 해당 월 계획은 연간 목표 표에 적은 월 계획을 업무 영역별로 보여 줍니다. 굵게·기울임·밑줄·글자 색상과 줄바꿈·들여쓰기를 유지하고, 글자 크기는 월 계획의 기본 크기로 표시합니다. 빈 계획은 생략하고, 병합 칸은 해당 월을 포함하는 계획을 한 번 표시합니다. 여기서는 읽기만 하므로 수정하려면 연간 목표 표로 돌아갑니다.

-

월 목표·누적·주당 필요 매출 읽기

+

위쪽 숫자(월 목표·누적 목표·누적 실적·달성)와 결정 사항

+

위쪽 영역은 화면을 스크롤해도 고정됩니다. 왼쪽 절반은 숫자 4칸, 오른쪽 절반은 결정 사항 · 메모입니다.

칸입력·계산 방법
매출 목표·실적관리자가 월별 숫자를 직접 입력합니다. 목표 표의 실적은 회의록의 자동 매출과 별도로 관리하므로 실적 모듈에서 자동으로 채워지지 않습니다.
매출 목표월 칸을 누르면 그 달 주차별 목표 입력 창이 열립니다. 주차마다 금액(매출 단위)을 넣고 저장하면 주차 합계가 그 달 매출 목표가 됩니다. 주차는 주간 회의록 주차와 같습니다. 주차를 모두 비우고 저장하면 월 목표도 지워집니다.
매출 실적관리자가 월별 숫자를 직접 입력합니다. 목표 표의 실적은 회의록의 자동 매출과 별도로 관리하므로 실적 모듈에서 자동으로 채워지지 않습니다.
매출 단위예를 들어 단위가 백만원이면 30은 30,000,000원입니다. 단위를 바꿔도 이미 적은 숫자는 자동 환산되지 않으므로 숫자와 단위를 함께 확인하세요.
연간·분기 매출해당 기간에 입력한 월 숫자의 합계입니다. 합계 칸에 따로 입력하지 않습니다.
달성실적 ÷ 목표 × 100입니다. 월별로 계산하며, 연간·분기는 기간 전체 목표 합계 대비 입력된 실적 합계로 계산합니다. 목표가 없거나 0이면 달성률을 표시하지 않습니다. 100% 이상은 초록으로 표시됩니다.
- - - - - - + + + +
지표뜻과 출처
월 목표 매출·목표 ROAS연간 목표 표의 해당 월 숫자입니다. 매출 단위가 원·천원·만원·십만원·백만원·천만원·억원이면 원으로 환산합니다. 모르는 단위는 원 환산을 못 하므로 주당 필요 매출도 계산하지 못합니다.
월 누적 실적(지난주까지)실적 모듈의 매출 집계 쇼핑몰 매출을 그 달 1일부터 선택한 주의 직전 일요일까지 합칩니다. 현재 날짜·월말을 넘기지 않습니다. 이번주 매출은 이 누적에 포함하지 않습니다.
주당 필요(월 목표 매출 − 월 누적 실적) ÷ 이번주를 포함한 그 달 남은 주 수입니다. 원 단위 정수로 계산하고, 이미 월 목표를 달성했다면 0원입니다.
전주 목표정확히 7일 전 회의록에 적은 금주 목표입니다. 그 주 회의록이 없으면 비어 있습니다.
전주 결과·달성률실적 모듈의 전주 월~일 매출과 그 값 ÷ 전주 목표 × 100입니다. 전주 결과는 매출 자료이므로 전주 회의록이 없어도 조회될 수 있습니다. 목표가 없거나 0이면 달성률은 없습니다.
금주 목표·현재 실적금주 목표는 관리자가 정하는 원 단위 금액입니다. 현재 실적은 선택한 주 월요일부터 일요일 또는 오늘 중 이른 날까지의 매출입니다. 아직 시작하지 않은 미래 주의 실적은 비어 있습니다.
월 목표 매출연간 목표 표의 해당 월 매출 목표(= 주차별 목표 합계)입니다. 매출 단위가 원·천원·만원·십만원·백만원·천만원·억원이면 원으로 환산해 함께 보여 줍니다.
월 누적 목표 매출연간 목표 표에서 입력한 주차별 목표의 1주차~선택한 주차 합계(원)입니다. 주차별 목표가 없으면 비어 있고, 목표 표로 가는 안내가 나옵니다.
월 누적 실적실적 모듈의 매출 집계 쇼핑몰 매출을 그 달 1일부터 오늘까지 합칩니다. 지난 주차를 보면 그 주차 마지막 날까지입니다.
누적 목표 대비 달성월 누적 실적 − 월 누적 목표 매출 금액(넘으면 +, 모자라면 −)과 월 누적 실적 ÷ 월 누적 목표 매출 %입니다. 100% 이상은 초록입니다.
-
lightbulb
월 목표가 1억원이고 지난주까지 누적이 4천만원, 남은 주가 이번주 포함 3주이면 주당 필요는 2천만원입니다. 이 숫자는 계획 참고값이며 금주 목표로 자동 저장되지는 않습니다.
-

월 목표·누적은 달의 1일~말일 기준이고, 주간 결과는 월요일~일요일 기준입니다. 달을 넘는 마지막 주의 주간 결과에는 다음 달 날짜가 포함될 수 있습니다.

+
lightbulb
주차별 목표가 1주차 2천만, 2주차 3천만이고 2주차까지의 실적이 4천5백만원이면 누적 목표 대비 달성은 −5,000,000원(90%)입니다.

주요 업무·정량 목표·참석자·메모 입력

    -
  1. 금주 목표에 전체 매출 목표를 적습니다. 줄별 정량 목표는 각 항목의 목표 금액이며, 현재는 원 단위입니다. 금주 목표와 줄별 목표 합계는 자동으로 맞춰지지 않습니다.
  2. +
  3. 줄별 정량 목표에 각 항목의 이번 주차 목표 금액을 원 단위로 적습니다. 전체 매출 목표는 연간 목표 표의 주차별 목표에서 정합니다.
  4. 각 항목의 주요 업무에 실행할 일과 일정을 적습니다.
  5. 참석자를 눌러 프로젝트 관리 권한이 있는 등록 직원 중 선택합니다. 찾기·전원 선택·모두 해제를 사용할 수 있으며, 칩의 ×로 참석자를 뺍니다.
  6. -
  7. 아래 결정 사항 · 메모에 회의 결론과 다음주까지 확인할 일을 적습니다.
  8. +
  9. 위쪽 오른쪽 결정 사항 · 메모에 회의 결론과 다음주까지 확인할 일을 적습니다.

금액은 1,200,000·120만·1.5억·3천만·1억2천만처럼 입력할 수 있습니다. Enter 또는 칸을 떠날 때 원 단위로 저장되고, 빈칸은 값을 지웁니다. 글·메모는 입력을 약 0.8초 멈추거나 칸을 떠날 때, 참석자는 바꾸는 즉시 저장됩니다.

@@ -625,21 +630,22 @@

지난주 리뷰·결과·정량 목표

-

지난주 리뷰의 결과(지난주 주요 업무)와 전주 목표는 정확히 7일 전 주의 같은 항목에서 가져옵니다. 이름 변경·순서 이동·회의록 생성 순서와 관계없이 이어진 같은 줄을 찾습니다. 그 주 회의록이 없으면 “회의록 없음”, 회의록은 있지만 항목이 없으면 “지난주 회의록에 없는 줄”로 표시합니다. 몇 주 전 기록을 지난주로 대신 보여 주지 않습니다.

+

지난주 리뷰는 바로 앞 주차의 같은 항목에서 가져옵니다(앞 주차가 앞 달 마지막 주차일 수 있습니다). 이름 변경·순서 이동·회의록 생성 순서와 관계없이 이어진 같은 줄을 찾습니다. 그 주차 회의록이 없으면 “회의록 없음”, 회의록은 있지만 항목이 없으면 “지난주 회의록에 없는 줄”로 표시합니다. 몇 주 전 기록을 지난주로 대신 보여 주지 않습니다.

    -
  • 결과 — 지난주에 적은 주요 업무를 그대로 보여 줍니다(읽기 전용).
  • -
  • 전주 목표 — 지난주 회의록에서 그 줄에 적은 정량 목표입니다.
  • -
  • 정량 목표 — 관리자가 지난주 결과 금액을 직접 입력합니다(실적 모듈에서 자동 입력되지 않습니다).
  • -
  • 저장 위치 — 이번 화면에서 입력한 지난주 정량 목표(결과 금액)는 지난주 회의록의 줄에 저장됩니다. 주요 업무·이번주 정량 목표는 이번주 회의록에 저장됩니다.
  • +
  • 전주 업무 — 지난 주차에 적은 주요 업무를 그대로 보여 줍니다(읽기 전용).
  • +
  • 결과(글) — 지난 주차 업무를 어떻게 했는지 관리자가 적습니다.
  • +
  • 전주 목표 — 지난 주차 회의록에서 그 줄에 적은 정량 목표입니다.
  • +
  • 결과(금액) — 관리자가 지난 주차 결과 금액을 직접 입력합니다(실적 모듈에서 자동 입력되지 않습니다).
  • +
  • 저장 위치 — 이번 화면에서 입력한 지난주 결과(글·금액)는 지난 주차 회의록의 줄에 저장됩니다. 주요 업무·정량 목표는 이번 주차 회의록에 저장됩니다.
  • 순서 바꾸기는 이번주와 지난주 리뷰의 좌우 배치만 바꿉니다. 선택은 로그인한 사람별로 내 브라우저에 기억됩니다.

매출 갱신·실적 표시

-

실적 모듈 매출은 위쪽 숫자 카드(월 누적·주당 필요 매출·전주 실적·금주 현재 실적)에만 쓰입니다. 줄(쿠팡·네이버 등)마다의 이번주 실적·지난주 결과는 자동으로 표시·입력되지 않으며, 지난주 결과는 직접 입력합니다.

+

실적 모듈 매출은 위쪽 숫자 칸(월 누적 실적·누적 목표 대비 달성)에만 쓰입니다. 줄(쿠팡·네이버 등)마다의 이번주 실적·지난주 결과는 자동으로 표시·입력되지 않으며, 지난주 결과는 직접 입력합니다.

실적 갱신 권한이 있으면 주차를 열 때 지난주부터 선택한 주의 오늘까지 매출을 자동 갱신합니다. 같은 주의 자동 갱신은 브라우저에서 10분 간격으로 제한하며, 성공 시에는 별도 큰 안내 없이 숫자가 바뀝니다. 실패·일부 쇼핑몰 실패 시 작은 안내와 다시 시도가 나옵니다. 마지막 갱신 성공 시각은 실적 모듈 기록이며 숫자에 마우스를 올려 확인할 수 있습니다.

- + @@ -653,7 +659,7 @@

저장 확인·인쇄·회의록 삭제

-

저장 실패 시 칸이 빨갛게 표시되며 입력값은 남습니다. 다시 입력하거나 칸을 떠나면 재시도합니다. 금주 목표를 저장하거나 자동 실적을 갱신해도 다른 칸의 작성 중인 글은 유지됩니다. 저장이 안 된 상태에서는 줄 추가·순서 이동 같은 작업에 앞서 저장을 다시 시도합니다. 실패하면 구조 변경을 멈춥니다. 초안 복원과 페이지 떠남 보호는 목표의 저장 안내와 같습니다.

+

저장 실패 시 칸이 빨갛게 표시되며 입력값은 남습니다. 다시 입력하거나 칸을 떠나면 재시도합니다. 자동 실적을 갱신해도 다른 칸의 작성 중인 글은 유지됩니다. 저장이 안 된 상태에서는 줄 추가·순서 이동 같은 작업에 앞서 저장을 다시 시도합니다. 실패하면 구조 변경을 멈춥니다. 초안 복원과 페이지 떠남 보호는 목표의 저장 안내와 같습니다.

인쇄는 브라우저 인쇄창을 엽니다. 인쇄용 화면에서는 사이드바·작은 달력·편집 도구를 숨깁니다. 브라우저의 PDF 저장도 사용할 수 있습니다.

관리자의 회의록 삭제는 선택한 한 주의 회의록과 줄을 삭제합니다. 다음주 화면의 지난주 리뷰도 비게 됩니다. 같은 주를 다시 만들면 항목 구성은 이어질 수 있지만 삭제한 글과 금액은 복구되지 않습니다.

@@ -679,7 +685,7 @@

Q. 하위 작업을 다른 프로젝트 작업으로 옮길 수 있나요?
하위 작업은 같은 프로젝트 안의 작업으로만 옮길 수 있습니다.

Q. 작업을 두 프로젝트에 같이 두고 싶어요.
작업 편집 창의 “프로젝트” 칸에서 다른 프로젝트에 추가를 쓰세요. (8장)

Q. 목표 표의 실적과 회의록 매출이 달라요.
목표 표의 월 실적은 직접 입력한 숫자이고, 회의록 매출은 실적 모듈 자료입니다. 매출 단위와 집계 기간도 확인하세요. (숫자 지표 · 회의록 지표)

-

Q. 지난주 회의록이 있는데 리뷰가 비어 있어요.
화면의 지난주 날짜와 항목을 확인하세요. 정확히 7일 전 회의록의 이어진 같은 항목만 표시합니다. 따로 추가한 줄은 이름이 같아도 다른 항목일 수 있습니다. (지난주 리뷰)

+

Q. 지난주 회의록이 있는데 리뷰가 비어 있어요.
화면의 지난주 날짜와 항목을 확인하세요. 바로 앞 주차 회의록의 이어진 같은 항목만 표시합니다. 따로 추가한 줄은 이름이 같아도 다른 항목일 수 있습니다. (지난주 리뷰)

Q. 도움말에서 필요한 설명을 빠르게 찾고 싶어요.
이 페이지 위쪽 검색창에 단어를 입력하고 결과를 누르세요. 제목·본문의 일치 단어가 강조되고 해당 소제목으로 이동합니다. Enter는 첫 결과로 이동, Esc나 지우기는 검색을 초기화합니다.

diff --git a/app/modules/project/templates/project/inbox.html b/app/modules/project/templates/project/inbox.html index 8e37efb..0014605 100644 --- a/app/modules/project/templates/project/inbox.html +++ b/app/modules/project/templates/project/inbox.html @@ -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 92f8468..55d7477 100644 --- a/app/modules/project/templates/project/mytasks.html +++ b/app/modules/project/templates/project/mytasks.html @@ -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 bbd00a3..72a8fc9 100644 --- a/app/modules/project/templates/project/project.html +++ b/app/modules/project/templates/project/project.html @@ -492,5 +492,5 @@ - + {% endblock %} diff --git a/app/modules/project/templates/project/trash.html b/app/modules/project/templates/project/trash.html index 51bb851..939ef47 100644 --- a/app/modules/project/templates/project/trash.html +++ b/app/modules/project/templates/project/trash.html @@ -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 6af2d39..1bb32e9 100644 --- a/app/static/project.css +++ b/app/static/project.css @@ -2501,17 +2501,28 @@ html.pj-goal-selecting, html.pj-goal-selecting * { user-select: none !important; .pj-meet-sync.is-warn { background: #fff4ec; color: #b45309; } @keyframes pj-meet-spin { to { transform: rotate(360deg); } } @media print { .pj-meet-sync { display: none !important; } } -/* 숫자 — 한 줄 막대(칸 9개, 좁으면 두 줄). 설명 문구는 말풍선(title) */ +/* 위쪽 고정 영역(2026-10-07) — 왼쪽 절반 숫자 4칸 | 오른쪽 절반 결정 사항·메모. 스크롤해도 위에 붙는다(.pj-meet-pane 기준). + 표 머리 줄은 이 높이(--pj-meet-top-h, project.js initMeetTop) 아래에 붙는다. 설명 문구는 말풍선(title) */ +.pj-meet-top { + position: sticky; top: 0; z-index: 6; display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1fr); gap: 10px; + align-items: stretch; padding: 0 0 10px; background: #fff; +} .pj-meet-kpibar { - display: grid; grid-template-columns: repeat(9, minmax(0, 1fr)); margin-bottom: 10px; + display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); align-content: stretch; border: 1px solid var(--pj-border); border-radius: 10px; background: #fff; overflow: hidden; } -.pj-meet-kpis { display: contents; } -.pj-meet-kpi { display: flex; flex-direction: column; gap: 1px; padding: 6px 10px; min-width: 0; border-right: 1px solid var(--pj-border); } -.pj-meet-kpis.is-week .pj-meet-kpi:last-child { border-right: none; } -.pj-meet-kpis:not(.is-week) .pj-meet-kpi:last-child { border-right: 2px solid #d5d9de; } /* 월 | 주 경계 */ +.pj-meet-kpi { display: flex; flex-direction: column; justify-content: center; gap: 2px; padding: 8px 12px; min-width: 0; border-right: 1px solid var(--pj-border); } +.pj-meet-kpi:last-child { border-right: none; } .pj-meet-kpi.is-accent { background: #faf9ff; } -.pj-meet-kpi.is-input { background: #fffaf4; } +.pj-meet-kpi-sub.is-good { color: #1f8a4c; font-weight: 700; } +.pj-meet-kpi-sub.is-low { color: #c2410c; font-weight: 700; } +.pj-meet-kpi-link { color: var(--pj-accent-dark); text-decoration: none; } +.pj-meet-kpi-link:hover { text-decoration: underline; } +.pj-meet-top .pj-meet-notes { margin: 0; display: flex; flex-direction: column; min-width: 0; } +.pj-meet-top .pj-meet-notes h3 { margin: 0 0 4px; font-size: 13px; } +.pj-meet-top .pj-meet-notes textarea, .pj-meet-top .pj-meet-notes .pj-meet-ro { + flex: 1 1 auto; min-height: 64px; max-height: 140px; overflow-y: auto; padding: 8px 10px; +} .pj-meet-kpi-label { font-size: 11px; color: var(--pj-ink-soft); font-weight: 600; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; } .pj-meet-kpi-label small { font-weight: 500; } .pj-meet-kpi-val { font-size: 15px; font-weight: 800; font-variant-numeric: tabular-nums; display: flex; align-items: baseline; gap: 2px; white-space: nowrap; } @@ -2523,7 +2534,7 @@ html.pj-goal-selecting, html.pj-goal-selecting * { user-select: none !important; font-size: 14px; font-weight: 800; height: 24px; width: 100%; text-align: left; border: 1px solid #f3d2b0; border-radius: 6px; background: #fff; padding: 0 6px; } -@media (max-width: 1300px) { .pj-meet-kpibar { grid-template-columns: repeat(5, minmax(0, 1fr)); } } +@media (max-width: 1300px) { .pj-meet-kpibar { grid-template-columns: repeat(2, minmax(0, 1fr)); } .pj-meet-kpi:nth-child(2) { border-right: none; } .pj-meet-kpi:nth-child(-n+2) { border-bottom: 1px solid var(--pj-border); } } /* 이 달 계획 — 연간 목표 표의 그 달 열(업무 영역별 작은 카드) */ .pj-meet-plan { margin: 0 0 10px; padding: 8px 10px; border: 1px solid var(--pj-border); border-radius: 10px; background: #fff; } @@ -2587,11 +2598,11 @@ html.pj-goal-selecting, html.pj-goal-selecting * { user-select: none !important; } .pj-meet-table tr > :last-child { border-right: none; } .pj-meet-table thead th { - position: sticky; top: 0; z-index: 3; background: #f7f8f9; height: 32px; padding: 0 8px; font-weight: 700; + position: sticky; top: var(--pj-meet-top-h, 0px); z-index: 3; background: #f7f8f9; height: 32px; padding: 0 8px; font-weight: 700; text-align: center; vertical-align: middle; white-space: nowrap; } -.pj-meet-table thead tr.pj-meet-group th { top: 0; height: 26px; font-size: 12px; } -.pj-meet-table thead tr:nth-child(2) th { top: 26px; } +.pj-meet-table thead tr.pj-meet-group th { top: var(--pj-meet-top-h, 0px); height: 26px; font-size: 12px; } +.pj-meet-table thead tr:nth-child(2) th { top: calc(var(--pj-meet-top-h, 0px) + 26px); } .pj-meet-table thead th.is-this { background: #fff7ed; color: #9a4b0b; } /* 이번주 ↔ 지난주 순서 바꾸기 버튼(표 왼쪽 위 빈 칸) */ .pj-meet-order-cell { vertical-align: middle; } @@ -2627,11 +2638,13 @@ th.pj-meet-c-label { position: relative; font-weight: 600; color: #3b4048; text- .pj-meet-more { position: absolute; top: 3px; right: 2px; width: 24px; height: 24px; opacity: 0; transition: opacity .12s; } .pj-meet-more .material-symbols-outlined { font-size: 18px; } th.pj-meet-c-label:hover .pj-meet-more, .pj-meet-more:focus { opacity: 1; } -textarea.pj-meet-text, .pj-meet-notes textarea { +textarea.pj-meet-text, textarea.pj-meet-rnote, .pj-meet-notes textarea { display: block; width: 100%; box-sizing: border-box; min-height: 38px; padding: 6px; border: none; background: transparent; font: inherit; line-height: var(--pj-text-leading); color: inherit; resize: none; overflow: hidden; } -textarea.pj-meet-text:focus { outline: none; } +textarea.pj-meet-text:focus, textarea.pj-meet-rnote:focus { outline: none; } +textarea.pj-meet-rnote { min-height: calc(var(--pj-text-leading) + 12px); padding: 6px; } +textarea.pj-meet-rnote::placeholder { color: rgba(0, 0, 0, .28); } /* 같은 행의 가장 긴 내용으로 높이를 정하고, 짧은 셀은 위에서 시작한다. */ textarea.pj-meet-text { min-height: calc(var(--pj-text-leading) + 12px); } .pj-meet-notes textarea:focus { outline: 2px solid var(--pj-accent); outline-offset: -2px; background: rgba(255, 255, 255, .8); } @@ -2670,10 +2683,31 @@ input.pj-meet-amount::placeholder { color: rgba(0, 0, 0, .28); } .erp-sidebar, .erp-topbar, .pj-side, .pj-goal-head-acts, .pj-meet-weeks, .pj-goal-foot, .pj-meet-more, .pj-meet-sec-add, .pj-meet-goalbtn, .pj-meet-title .pj-btn { display: none !important; } .pj-meet-pane { overflow: visible; } + .pj-meet-top { position: static; } .pj-meet-table thead th { position: static; } input.pj-meet-amount { border: none; appearance: none; } } +/* 목표 표 — 매출 목표 칸(주차별 입력, 020): 누르면 주차 입력 창 */ +.pj-goal-numtd.is-weekly .pj-goal-num { cursor: pointer; } +.pj-goal-numtd.is-weekly input.pj-goal-num:hover { background: var(--pj-accent-tint); } +.pj-goal-wkpop { + position: fixed; z-index: 1000; width: 260px; padding: 10px 12px; background: #fff; border: 1px solid var(--pj-border); + border-radius: 10px; box-shadow: 0 8px 24px rgba(16, 24, 40, .16); font-size: 13px; +} +.pj-goal-wkpop-head { font-weight: 700; margin-bottom: 8px; } +.pj-goal-wkpop-head small { font-weight: 500; color: var(--pj-ink-soft); } +.pj-goal-wkpop-row { display: flex; align-items: center; justify-content: space-between; gap: 8px; margin: 4px 0; } +.pj-goal-wkpop-row em { font-style: normal; color: var(--pj-ink-soft); font-size: 12px; } +.pj-goal-wkpop-row input { + width: 100px; height: 26px; padding: 0 6px; border: 1px solid var(--pj-border); border-radius: 6px; font: inherit; + text-align: right; font-variant-numeric: tabular-nums; +} +.pj-goal-wkpop-row input[readonly] { background: #f7f8f9; } +.pj-goal-wkpop-sum { display: flex; justify-content: space-between; margin-top: 8px; padding-top: 8px; border-top: 1px solid var(--pj-border); } +.pj-goal-wkpop-sum b { font-variant-numeric: tabular-nums; } +.pj-goal-wkpop-acts { display: flex; justify-content: flex-end; gap: 6px; margin-top: 10px; } + /* 영역 색 고르기 팝업(body 에 붙음) */ .pj-goal-colorpop { position: fixed; z-index: 1000; display: grid; grid-template-columns: repeat(8, 26px); gap: 6px; diff --git a/app/static/project.js b/app/static/project.js index 6964f32..15afa24 100644 --- a/app/static/project.js +++ b/app/static/project.js @@ -9023,16 +9023,103 @@ function fitAll() { table.querySelectorAll(".pj-goal-text").forEach(fit); } QUARTERS.forEach(function (q) { applyFold(q, false); }); - // 병합 선택(Shift+클릭) — 관리자 전용, 아래에서 채운다. 접기 버튼이 먼저 부르므로 여기 둔다. - let clearMergeSel = function () {}; - if (!isAdmin) return; - function flashSaved(node) { node.classList.remove("is-saved"); void node.offsetWidth; node.classList.add("is-saved"); } + // ── 주차별 매출 목표(020) — 매출 목표 칸을 누르면 그 달 주차 입력 창(body 에 붙음). 저장하면 주차 합계가 월 목표. + // 관리자는 입력·저장, 보기만 하는 사람은 주차별 값 보기. 주차는 서버(store.month_weeks)가 정한다. + const WEEKS = window.PJ_GOAL_WEEKS || null; + let weekPop = null; + function closeWeekPop() { + if (!weekPop) return; + weekPop.remove(); + weekPop = null; + document.removeEventListener("mousedown", onWeekDoc, true); + document.removeEventListener("keydown", onWeekKey, true); + } + function onWeekDoc(e) { if (weekPop && !weekPop.contains(e.target)) closeWeekPop(); } + function onWeekKey(e) { if (e.key === "Escape") closeWeekPop(); } + function openWeekPop(cell) { + closeWeekPop(); + const mo = cell.dataset.month, list = (WEEKS && WEEKS[mo]) || []; + const unit = window.PJ_GOAL_UNIT || ""; + const edit = isAdmin && cell.tagName === "INPUT"; + weekPop = document.createElement("div"); + weekPop.className = "pj-goal-wkpop"; + weekPop.innerHTML = '
' + mo + "월 주차별 매출 목표" + + (unit ? " (" + escapeHtml(unit) + ")" : "") + "
" + + list.map(function (w) { + return '"; + }).join("") + + '
합계 = 월 목표
' + + (edit ? '
' + + '
' : ""); + document.body.appendChild(weekPop); + const r = cell.getBoundingClientRect(), vw = document.documentElement.clientWidth, vh = document.documentElement.clientHeight; + weekPop.style.left = Math.max(8, Math.min(r.left, vw - weekPop.offsetWidth - 8)) + "px"; + weekPop.style.top = (r.bottom + 6 + weekPop.offsetHeight > vh ? Math.max(8, r.top - weekPop.offsetHeight - 6) : r.bottom + 6) + "px"; + const inputs = Array.from(weekPop.querySelectorAll("input")); + const sumEl = weekPop.querySelector(".pj-goal-wkpop-sum b"); + function paintSum() { + let t = null; + inputs.forEach(function (i) { const n = numOf(i); if (n != null) t = (t || 0) + n; }); + sumEl.textContent = t == null ? "—" : fmtNum(t); + } + inputs.forEach(function (i) { i.addEventListener("input", paintSum); }); + paintSum(); + async function save(btn) { + const weeks = {}; + inputs.forEach(function (i) { weeks[i.dataset.start] = i.value; }); + btn.disabled = true; + try { + const res = await api("PUT", "/project/api/goals/" + year + "/week-targets/" + mo, { weeks: weeks }); + list.forEach(function (w) { if (res.weeks && w.start in res.weeks) w.value = res.weeks[w.start]; }); + cell.value = res.label || ""; + recompute(); + flashSaved(cell.parentElement); + closeWeekPop(); + } catch (err) { + btn.disabled = false; + showToast("저장 실패: " + err.message, "error"); + } + } + weekPop.addEventListener("click", function (e) { + const b = e.target.closest("[data-act]"); + if (!b) return; + if (b.dataset.act === "save") save(b); else closeWeekPop(); + }); + weekPop.addEventListener("keydown", function (e) { + if (edit && e.key === "Enter" && !isImeEnter(e) && e.target.tagName === "INPUT") { + e.preventDefault(); + save(weekPop.querySelector('[data-act="save"]')); + } + }); + setTimeout(function () { + document.addEventListener("mousedown", onWeekDoc, true); + document.addEventListener("keydown", onWeekKey, true); + }, 0); + if (edit && inputs.length) { inputs[0].focus(); inputs[0].select(); } + } + if (WEEKS) { + table.addEventListener("click", function (e) { + const c = e.target.closest(".pj-goal-num[data-weekly]"); + if (c) openWeekPop(c); + }); + table.addEventListener("keydown", function (e) { + const c = e.target.closest(".pj-goal-num[data-weekly]"); + if (c && (e.key === "Enter" || e.key === " ") && !isImeEnter(e)) { e.preventDefault(); openWeekPop(c); } + }); + } + + // 병합 선택(Shift+클릭) — 관리자 전용, 아래에서 채운다. 접기 버튼이 먼저 부르므로 여기 둔다. + let clearMergeSel = function () {}; + if (!isAdmin) return; + // ── 숫자 칸 — Enter·칸 떠남에 저장(createFieldSaver: 같은 칸 요청 차례대로, 늦은 응답이 새 입력을 덮지 않음). // 서버 표기(쉼표)는 요청 뒤 입력이 그대로일 때만 칸에 넣는다. 실패해도 입력값은 그대로(빨간 테두리), Esc = 저장된 값으로. const numSaver = createFieldSaver({ @@ -9054,7 +9141,7 @@ }, onFail: function (inp, err) { markSaveFailed(inp.parentElement, err); }, }); - table.querySelectorAll("input.pj-goal-num").forEach(function (inp) { + table.querySelectorAll("input.pj-goal-num:not([data-weekly])").forEach(function (inp) { numSaver.track(inp, inp.value); inp.addEventListener("focus", function () { inp.select(); }); inp.addEventListener("input", recompute); @@ -9984,7 +10071,7 @@ // · 글(주요 업무·메모): 0.8초 멈춤·칸 떠남·페이지 떠남에 저장. 금액·참석자: 칸 떠남·Enter 에 저장. // · 지난주 결과 금액은 지난 회의록의 같은 줄(tr data-prev)에 저장한다. // · 줄 추가·순서·삭제·구역 추가는 저장 뒤 새로고침(스크롤 위치 되살림). 메뉴는 body 에 붙는다. - // ── 회의록 표 — 이번주(2칸) ↔ 지난주 리뷰(3칸) 순서 바꾸기. 줄마다 is-this / is-prev 칸 묶음을 통째로 옮긴다 + // ── 회의록 표 — 이번주(2칸) ↔ 지난주 리뷰(4칸) 순서 바꾸기. 줄마다 is-this / is-prev 칸 묶음을 통째로 옮긴다 // (colgroup·머리 두 줄·구역 줄 모두). 보는 사람마다 브라우저에 기억 — localStorage pj_meet_order:{로그인 이메일} = "prev"(지난주 먼저). // 다시 그리기(repaintMeeting)는 칸을 선택자로 찾으므로 순서와 무관. function initMeetOrder() { @@ -10026,10 +10113,22 @@ }); } + // ── 회의록 위쪽 고정 영역(숫자 4칸 | 결정 사항·메모) — 스크롤해도 위에 붙고, 표 머리 줄은 그 아래에 붙는다. + // 높이가 바뀌면(메모 줄 수·창 너비) --pj-meet-top-h 를 다시 잰다. 배율(.pj-ui-scale) 안이라 offsetHeight(배율 전 값)로. + function initMeetTop(pane) { + const top = el("pj-meet-top"); + if (!top) return; + const apply = function () { pane.style.setProperty("--pj-meet-top-h", top.offsetHeight + "px"); }; + apply(); + if (window.ResizeObserver) new ResizeObserver(apply).observe(top); + else window.addEventListener("resize", apply); + } + function initGoalMeeting() { const pane = el("pj-meet-pane"); if (!pane) return; initMeetOrder(); + initMeetTop(pane); const week = pane.dataset.week, year = pane.dataset.year; const isAdmin = pane.dataset.admin === "true"; const SCROLL_KEY = "pj_meet_scroll"; @@ -10076,7 +10175,7 @@ const meetingUrl = "/project/api/goals/meetings/" + week; function itemUrl(id) { return "/project/api/goals/meeting-items/" + id; } - // ── 금액 칸(금주 목표 · 줄 정량 목표 · 지난주 결과) — Enter·칸 떠남에 저장(createFieldSaver: 같은 칸 요청 차례대로). + // ── 금액 칸(줄 정량 목표 · 지난주 결과 금액) — Enter·칸 떠남에 저장(createFieldSaver: 같은 칸 요청 차례대로). // 서버 확정값(원 정수)을 쉼표 표기로 칸에 넣는 건 요청 뒤 입력이 그대로일 때만 — 그 사이 다시 입력한 초안은 덮지 않는다. // 실패해도 입력값은 그대로(빨간 테두리), Esc = 저장된 값으로. // 금주 목표 저장 뒤 머리 숫자는 페이지 새로고침 없이 숫자 칸만 다시 그린다(meetRepaint — 다른 칸의 저장 안 된 글 보존). @@ -10223,7 +10322,8 @@ }); } - // ── 글 칸(이번주 할 일·메모) — 0.8초 멈춤·칸 떠남에 저장(createFieldSaver). + // ── 글 칸(주요 업무 · 지난주 결과 글 · 메모) — 0.8초 멈춤·칸 떠남에 저장(createFieldSaver). + // 지난주 결과 글(.pj-meet-rnote, data-field=result_note)은 지난 주차 줄(tr data-prev)에 저장한다. // 보낸 값만 저장됨으로 기록하고, 같은 칸 요청은 차례대로(진행 중에 새로 쓴 글은 뒤이어 저장). 실패해도 글은 그대로 두고 // 다음 입력·칸 떠남·줄 작업 전에 다시 보낸다. 초안은 localStorage(pj_draft:meet:…)에도 — 페이지가 닫혀도 다음에 되살린다. const notes = el("pj-meet-notes"); @@ -10231,11 +10331,16 @@ 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); + if (ta === notes) return api("PUT", meetingUrl, { notes: v }, o); + const tr = ta.closest("tr"); + if (ta.dataset.field === "result_note") return api("PUT", itemUrl(tr.dataset.prev), { result_note: v }, o); + return api("PUT", itemUrl(tr.dataset.item), { content: v }, o); }, draftKey: function (ta) { - return ta === notes ? "meet:notes:" + week : "meet:item:" + ta.closest("tr").dataset.item + ":content"; + if (ta === notes) return "meet:notes:" + week; + const tr = ta.closest("tr"); + return ta.dataset.field === "result_note" ? "meet:item:" + tr.dataset.prev + ":result_note" + : "meet:item:" + 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); }, @@ -10259,7 +10364,7 @@ ta.addEventListener("blur", function () { textSaver.flush(ta).catch(function () {}); }); } if (notes) bindText(notes); - if (table) table.querySelectorAll(".pj-meet-text").forEach(bindText); + if (table) table.querySelectorAll(".pj-meet-text, .pj-meet-rnote").forEach(bindText); if (cellGrid) cellGrid.bindSaver({ flush: flushAll, save: function (ta) { return textSaver.flush(ta); }, replace: function (ta, value) { ta.value = value; textSaver.acceptSaved(ta, ta.value); }, rowMenu: rowMenu, addRow: function (section, ref, place) { run(function () { return addRow(section, ref, place); }); }, @@ -10267,7 +10372,7 @@ if (table && window.PJGoalText) window.PJGoalText.init(table, el("pj-goal-format")); if (restored) showToast("저장되지 않았던 글 " + restored + "칸을 되살려 다시 저장합니다."); else if (conflict) showToast("다른 곳에서 바뀐 칸 " + conflict + "개는 예전 초안을 되살리지 않았습니다."); - window.addEventListener("resize", function () { document.querySelectorAll(".pj-meet-text, #pj-meet-notes").forEach(fit); }); + window.addEventListener("resize", function () { document.querySelectorAll(".pj-meet-text, .pj-meet-rnote, #pj-meet-notes").forEach(fit); }); // 페이지 떠남 — 글은 keepalive 로 한 번 더 보내고(보장 아님, 초안 백업이 남음), 실패·진행 중·금액 미저장이면 이탈 경고 window.addEventListener("beforeunload", function (e) { textSaver.onBeforeUnload(e); @@ -10279,7 +10384,7 @@ table.addEventListener("click", function (e) { if (e.button !== 0 || e.defaultPrevented || e.target.closest("textarea, input, select, button, a, [contenteditable], [data-meet-edit], .pj-meet-colresize, .pj-goal-move-edge")) return; const td = e.target.closest("td"); - const f = td && td.querySelector(".pj-meet-text, input.pj-meet-amount"); + const f = td && td.querySelector(".pj-meet-text, .pj-meet-rnote, input.pj-meet-amount"); if (!f || f === document.activeElement) return; f.focus(); if (f.tagName === "TEXTAREA") { const n = f.value.length; f.setSelectionRange(n, n); } diff --git a/docs/DEPLOYMENT.md b/docs/DEPLOYMENT.md index b9bbfad..ac07339 100644 --- a/docs/DEPLOYMENT.md +++ b/docs/DEPLOYMENT.md @@ -97,6 +97,19 @@ docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db < s docker exec postgres-db psql -U postgres -d project_db -c "SELECT column_name FROM information_schema.columns WHERE table_name = 'goal_meeting_items' AND column_name = 'content_row_span';" ``` +## 주간 회의록 새 주차·결과 글·주차별 목표 마이그레이션 (020) + +020은 `goal_meeting_items.result_note` 열·`goal_week_targets` 표를 추가하고, `goal_meetings` 의 "월요일만" CHECK 를 없애며, +새 주차 규칙에 흡수된 월요일 회의록을 새 주차 시작일로 옮긴다(옮길 자리에 회의록이 있으면 NOTICE 만). 다시 실행할 수 있다. +코드는 020 전에도 열리지만 결과 글·주차별 목표·월요일이 아닌 주차 회의록 만들기는 020 뒤에 된다. + +```bash +cd /opt/www/main +docker exec postgres-db pg_dump -U postgres project_db > ~/project_db_before_020_$(date +%Y%m%d%H%M).sql +docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db < scripts/sql/project_db_020_meeting_periods.sql +docker exec postgres-db psql -U postgres -d project_db -c "SELECT to_regclass('goal_week_targets') AS t, (SELECT count(*) FROM information_schema.columns WHERE table_name='goal_meeting_items' AND column_name='result_note') AS note;" +``` + --- ## 컨테이너 관리 diff --git a/docs/PROJECT_MODULE.md b/docs/PROJECT_MODULE.md index dcfd1fc..5be9258 100644 --- a/docs/PROJECT_MODULE.md +++ b/docs/PROJECT_MODULE.md @@ -359,6 +359,9 @@ docker exec -i postgres-db psql -U postgres -d project_db \ # 019 = 주간 회의록 이번주 글 셀 세로 병합 — 적용 전 project_db 백업 docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db \ < scripts/sql/project_db_019_meeting_cell_editing.sql +# 020 = 새 주차(월요일 아닌 시작일)·지난주 결과 글·주차별 매출 목표 + 흡수된 월요일 회의록 이동 — 적용 전 project_db 백업(6-9-4) +docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db \ + < scripts/sql/project_db_020_meeting_periods.sql # 4) 재배포 (git pull 후 반드시 --build) cd /opt/www/main && docker compose up -d --build web @@ -740,12 +743,12 @@ description 을 항상 HTML로 취급하기 때문). 두 번 실행하면 이중 항목을 다음 회의로 이어받아 나란히 리뷰), **OKR 체크인 평가**(완료/일부/미달). - 화면 `/project/goals/{연도}/meetings/{월}?week={월요일}`(`goal_meeting.html`, `initGoalMeeting`) — 목표 표 월 머리를 누르면 열린다. - - **주차 탭**: 그 달의 주(월~일, `store.month_weeks`) — **1주차 = 그 달 첫 월요일이 있는 주**, 주는 월요일이 속한 달의 것 - (2026-10-01 사용자 기준. 예: 2026년 10월 = 10/5·12·19·26 주, 9/28~10/4 는 9월 마지막 주). 다른 달의 주를 `?week=` 로 열면 + - **주차 탭**: 그 달의 주차(`store.month_weeks`) — **2026-10-07 부터 6-9-4 규칙**(그 달 안, 1주차는 1일부터, 말일 월·화는 앞 주차에). + 아래 "1주차 = 첫 월요일" 설명은 예전 규칙. 다른 달의 날짜를 `?week=` 로 열면 그 달 회의록 주소로 303. 점 = 회의록 있음, "이번 주" 꼬리표. 기본 선택 = 이번 주(그 달 주면) 아니면 1주차. ‹ 이전 달 · 다음 달 › 링크, ← 목표 표. - - **월간 목표·누적은 늘 1일~말일**(주차와 따로): 월 누적 실적 = 1일 ~ 이 주 앞(지난주 일요일, 1주차면 첫 월요일 전날)까지, - 주당 필요 매출 = (월 목표 − 누적) ÷ 그 달 남은 주 수(이 주 포함). + - **월간 목표·누적은 늘 1일~말일**: 머리 숫자는 2026-10-07 부터 6-9-4(월 목표 · 월 누적 목표 · 월 누적 실적 · 누적 목표 대비 차액·%). + 아래 "머리 숫자" 9칸 설명(주당 필요·전주 결과·금주 목표 등)은 예전 화면. - 머리 배치: 왼쪽 = **[🚩 {연도}년 목표] 버튼**(연간 목표로, 큰 강조 버튼 `.pj-meet-goalbtn` — 예전 ← 화살표 대신)·제목·‹이전 달·다음 달›· 인쇄·회의록 삭제·**주차 탭(제목 줄 오른쪽 끝 = 달력 바로 왼쪽에 붙음, 한 줄짜리 작은 탭 — `1주차 10/5~11`, 같은 달이면 끝 월 생략, 전체 기간은 말풍선)**, 그 아래 **{월}월 계획**(달력 앞까지 너비), **오른쪽 위 = 작은 달력**(폭 174px, 날짜 10.5px·칸 높이 21px). 목표·회의록 제목은 32px 굵게(`h2.pj-goal-title`). @@ -832,6 +835,35 @@ description 을 항상 HTML로 취급하기 때문). 두 번 실행하면 이중 셀 편집 API: `POST /api/goals/meeting-cells/move {source_item, target_item, source_body, target_body}` · `POST /api/goals/meeting-cells/merge {item_from, item_to}` · `DELETE /api/goals/meeting-items/{id}/cell-merge`. +### 6-9-4. 새 주차 · 위쪽 고정 영역 · 지난주 결과 글 · 주차별 매출 목표 (마이그레이션 020, 2026-10-07) + +- **주차**(`store.month_weeks` — 6-9-2·6-9-3 의 "월요일~일요일 / 7일 전" 설명을 대신한다): 주차는 **그 달 안**에서만 나눈다. + 1일이 월~금이면 1주차 = 1일 ~ 그 주 일요일, 1일이 토·일이면 1주차 = 1일 ~ 다음 주 일요일, 그 뒤 월~일, + **말일이 월·화이면 그 하루·이틀은 앞 주차에 붙는다**. 예: 2026-10 = 10/1~4 · 5~11 · 12~18 · 19~25 · 26~31, + 2026-08 = 8/1(토)~9 · 10~16 · 17~23 · 24~31(월). 헬퍼: `week_period(날짜)` · `prev_week_period(시작일)`(= "지난주", + 앞 달 마지막 주차일 수 있음) · `week_number` · `validate_period_start`(새 회의록·주차 목표는 주차 시작일만). + 회의록 `week_start` = 주차 시작일(월요일이 아닐 수 있음). 화면 `?week=` 에 아무 날짜(예전 월요일 주소)를 주면 그 날짜가 든 주차로. + 작은 달력은 월요일 시작 줄 그대로, 줄을 누르면 그 줄의 이 달 날짜가 든 주차(한 주차가 두 줄일 수 있음). +- **지난주** = 바로 앞 주차(`db.get_meeting` 이 `store.prev_week_period` 로 찾음) 회의록의 같은 연결키 줄. +- **위쪽 고정 영역**(`#pj-meet-top`, `.pj-meet-pane` 안 sticky): 왼쪽 절반 숫자 4칸 — **월 목표 매출**(목표 표, = 주차 목표 합) · + **월 누적 목표 매출**(주차별 목표 1주차~이 주차 합, 원) · **월 누적 실적**(1일 ~ 오늘, 지난 주차면 그 주차 끝날 — 실적 모듈) · + **누적 목표 대비 달성**(실적 − 누적 목표 차액 + 실적 ÷ 누적 목표 %) / 오른쪽 절반 **결정 사항·메모**(예전엔 표 아래). + 표 머리 줄 sticky top = 이 영역 높이(`--pj-meet-top-h`, `initMeetTop` 의 ResizeObserver). 예전 9칸(주당 필요·목표 ROAS·전주 목표· + 전주 결과·전주 달성률·금주 목표 입력·금주 현재 실적)은 없앴다(`goal_meetings.week_target` 열·API 는 남음). `head` 키: + `month_target_won · week_targets_set · cum_target · cum_target_won · mtd · mtd_end · gap · rate · prev_exists · perf* · unknown · fresh*`. +- **표 열**: 구역 | 항목 | 주요 업무 | 정량 목표 ‖ 지난주 리뷰: **전주 업무**(지난 주차 `content`) | **결과**(글, 지난 주차 줄 + `result_note` — 020, `.pj-meet-rnote` textarea, 0.8초 멈춤·칸 떠남 저장, 초안 `pj_draft:meet:item:{지난 줄}:result_note`) | + **전주 목표**(지난 주차 `target_amount`) | **결과**(금액, 지난 주차 `result_amount`). 020 미적용이면 결과 글 칸은 보기만, API 503. +- **주차별 매출 목표**(`goal_week_targets(week_start PK, year FK goal_years CASCADE, month, value NUMERIC)` — 목표 표 매출 단위 그대로): + 연간 목표 표 매출 **목표** 월 칸(`data-weekly`, readonly)을 누르면 그 달 주차 입력 창(`.pj-goal-wkpop`, body 에 붙음, 보기만 하는 사람은 값만). + `PUT /project/api/goals/{연도}/week-targets/{월} {weeks: {주차 시작일: 값|""}}`(관리자) → 저장 후 그 달 주차 합계를 + `goal_metrics(sales, target)` 에 쓴다(모두 비면 월 목표도 지움). 020 미적용이면 예전처럼 월 칸 직접 입력. +- **020 마이그레이션**(`scripts/sql/project_db_020_meeting_periods.sql`, 멱등): ① `goal_meeting_items.result_note` ② `goal_meetings` + 월요일 CHECK 제거 ③ `goal_week_targets` ④ 새 주차에 흡수된 월요일 회의록(1일이 토·일인 달의 2·3일 월요일 → 1일, 말일이 월·화인 달의 + 마지막 월요일 → 7일 전 월요일)을 옮김 — 옮길 자리에 회의록이 있으면 옮기지 않고 NOTICE. 이미 쓰던 9/28(월) 회의록은 9월 마지막 주차 + (9/28~30)로 그대로 남고, 10월 1주차(10/1~4)는 새로 만든다(그래서 10/5 주차의 지난주 리뷰는 10/1~4 회의록이 생겨야 채워진다). +- 코드는 020 전에도 동작(결과 글 보기만, 주차 목표 없음, 월요일 아닌 주차 회의록 만들기만 503 안내). + ### 6-9-3. 저장 안전장치 · 지난주 연결 · 실적 미확인 (2026-10-01 점검 반영 — `docs/reviews/GOALS_MEETINGS_REVIEW_2026-10-01.md`, 마이그레이션 018) **칸별 자동 저장 `createFieldSaver`**(project.js 공용, 목표 표 글·숫자 + 회의록 글·메모·금액·금주 목표 — 버그 1·2·3) diff --git a/scripts/sql/project_db_020_meeting_periods.sql b/scripts/sql/project_db_020_meeting_periods.sql new file mode 100644 index 0000000..1ff51b6 --- /dev/null +++ b/scripts/sql/project_db_020_meeting_periods.sql @@ -0,0 +1,89 @@ +-- ===================================================================== +-- project_db 마이그레이션 020 — 주간 회의록 새 주차·결과 글 칸·주차별 매출 목표 +-- ===================================================================== +-- 멱등(idempotent). DROP TABLE/TRUNCATE 없음. 운영: /opt/www/main 에서 기존 project_db 에 적용(신규 DB 생성 없음). +-- +-- 왜(2026-10-07 사용자 요청): +-- · 주차 = 그 달 안의 기간. 1일이 월~금이면 1일~그 주 일요일이 1주차, 1일이 토·일이면 1일~다음 주 일요일이 1주차, +-- 그 뒤로 월~일. 말일이 월·화이면 그 하루·이틀은 앞 주차에 붙는다. → 회의록 시작일(week_start)이 월요일이 아닐 수 있다. +-- · 지난주 리뷰에 "결과" 글 칸(지난주 줄에 저장). +-- · 연간 목표 표에서 월 매출 목표를 주차별로 입력하고 그 합계를 월 목표로 쓴다. +-- +-- ① goal_meeting_items.result_note — 지난주 리뷰 "결과" 글(그 주 줄에 저장) +-- ② goal_meetings.week_start 의 "월요일만" CHECK 제거(주차 시작일은 1일일 수 있다) +-- ③ goal_week_targets — 주차별 매출 목표(목표 표 매출 단위 그대로, 월 목표 = 그 달 주차 합계) +-- ④ 새 주차에 흡수된 월요일 회의록을 새 주차 시작일로 옮김 +-- A) 1일이 토·일인 달의 첫 월요일(2일·3일) → 그 달 1일 +-- B) 말일이 월·화인 달의 마지막 월요일 → 7일 전 월요일(앞 주차) +-- 옮길 자리에 이미 회의록이 있으면 옮기지 않고 NOTICE 로 알린다(합치지 않음 — 사람이 확인). +-- +-- 적용 전 확인(조회만): +-- SELECT week_start, to_char(week_start, 'Dy') FROM goal_meetings +-- WHERE (EXTRACT(DAY FROM week_start) IN (2, 3) AND EXTRACT(ISODOW FROM week_start) = 1) +-- OR (EXTRACT(ISODOW FROM week_start) = 1 AND EXTRACT(DAY FROM week_start + 2) IN (1, 2)); +-- ===================================================================== +BEGIN; + +-- ① 결과 글 칸 +ALTER TABLE goal_meeting_items ADD COLUMN IF NOT EXISTS result_note TEXT NOT NULL DEFAULT ''; +COMMENT ON COLUMN goal_meeting_items.result_note IS '그 주 결과(글) — 다음 주차 회의록의 지난주 리뷰 "결과" 칸에서 입력'; + +-- ② 월요일 CHECK 제거(이름이 달라도 ISODOW 검사인 CHECK 만 찾아서) +DO $$ +DECLARE c record; +BEGIN + FOR c IN + SELECT conname FROM pg_constraint + WHERE conrelid = 'goal_meetings'::regclass AND contype = 'c' + AND pg_get_constraintdef(oid) ILIKE '%isodow%' + LOOP + EXECUTE format('ALTER TABLE goal_meetings DROP CONSTRAINT %I', c.conname); + END LOOP; +END $$; +COMMENT ON TABLE goal_meetings IS '연간 목표 — 주간 회의록(week_start = 주차 시작일, 020 부터 월요일이 아닐 수 있음)'; + +-- ③ 주차별 매출 목표 +CREATE TABLE IF NOT EXISTS goal_week_targets ( + week_start DATE PRIMARY KEY, -- 주차 시작일 + year INT NOT NULL REFERENCES goal_years(year) ON DELETE CASCADE, + month INT NOT NULL CHECK (month BETWEEN 1 AND 12), + value NUMERIC NOT NULL CHECK (value >= 0), -- 목표 표 매출 단위(예: 백만원) + updated_by TEXT NOT NULL DEFAULT '', + updated_at TIMESTAMPTZ NOT NULL DEFAULT now() +); +CREATE INDEX IF NOT EXISTS idx_goal_week_targets_month ON goal_week_targets (year, month); +COMMENT ON TABLE goal_week_targets IS '연간 목표 — 주차별 매출 목표(월 목표 = 그 달 주차 합계)'; +GRANT SELECT, INSERT, UPDATE, DELETE ON goal_week_targets TO project_app; + +-- ④ 흡수된 월요일 회의록 옮기기 +DO $$ +DECLARE r record; dst date; +BEGIN + FOR r IN + SELECT week_start FROM goal_meetings + WHERE EXTRACT(ISODOW FROM week_start) = 1 + AND (EXTRACT(DAY FROM week_start) IN (2, 3) -- A + OR EXTRACT(DAY FROM week_start + 1) = 1 -- B 말일 = 월 + OR EXTRACT(DAY FROM week_start + 2) = 1) -- B 말일 = 화 + ORDER BY week_start + LOOP + IF EXTRACT(DAY FROM r.week_start) IN (2, 3) THEN + dst := date_trunc('month', r.week_start)::date; + ELSE + dst := r.week_start - 7; + END IF; + IF EXISTS (SELECT 1 FROM goal_meetings WHERE week_start = dst) THEN + RAISE NOTICE '회의록 % 은(는) % 주차에 흡수되지만 그 자리에 회의록이 있어 옮기지 않았습니다(확인 필요).', r.week_start, dst; + CONTINUE; + END IF; + INSERT INTO goal_meetings (week_start, week_target, attendees, notes, created_by, created_at, updated_by, updated_at) + SELECT dst, week_target, attendees, notes, created_by, created_at, updated_by, now() + FROM goal_meetings WHERE week_start = r.week_start; + UPDATE goal_meeting_items SET week_start = dst WHERE week_start = r.week_start; + DELETE FROM goal_meetings WHERE week_start = r.week_start; -- 줄은 위에서 옮겼으므로 빈 머리만 지운다 + RAISE NOTICE '회의록 % → % 로 옮김', r.week_start, dst; + END LOOP; +END $$; + +COMMIT; +SELECT 'project_db 020 meeting periods ready' AS status; diff --git a/tests/js/goals_meeting_ui.test.js b/tests/js/goals_meeting_ui.test.js index bed9095..7dd50d4 100644 --- a/tests/js/goals_meeting_ui.test.js +++ b/tests/js/goals_meeting_ui.test.js @@ -15,7 +15,7 @@ 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) { +["goals_admin", "goals_ro", "goals_weekly_admin", "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"; @@ -403,20 +403,45 @@ function meetServer(env, st) { check("[2c] 최종 서버 정량 목표 300 · 지난주 결과(7일 전 주 줄 902) 75", st.items[1].target_amount === 300 && st.items[902].result_amount === 75, st.items); check("[2c] 달성률·평가 열 없음(2026-10-06)", !env.d.querySelector("[data-rate], select.pj-meet-eval")); }); - await section(async function () { // 금주 목표 저장 — 새로고침하지 않고 숫자 칸만 다시(다른 칸의 미저장 글 보존) + await section(async function () { // 지난주 결과 글(020) — 지난 주차 줄(data-prev)에 저장, 새로고침 없음 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" } }; } }); + const st = meetServer(env); await boot(env); - const gets0 = st.gets || 0; - const ta = env.d.querySelector('tr[data-item="1"] .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(); + const note = env.d.querySelector('tr[data-item="2"] .pj-meet-rnote'); + check("[2d] 결과 글 칸 = 지난 주차 값", !!note && note.value === "샘플 결과", note && note.value); + note.focus(); type(env, note, "결과 메모"); note.blur(); await settle(); await wait(10); await settle(); - check("[2d] 금주 목표 저장 = 서버 확정값", st.head.week_target === 2000 && tgt.value === "2,000", st.head); + check("[2d] 결과 글 → 지난 주차 줄(902)에 저장", st.items[902] && st.items[902].result_note === "결과 메모", st.items); check("[2d] 페이지 새로고침 없음", env.navigations === 0); - check("[2d] 숫자 칸만 다시 받음(GET 1회 더)", (st.gets || 0) === gets0 + 1, st.gets); - check("[2d] 다른 칸 미저장 글 유지", ta.value === "unsaved note"); + check("[2d] 금주 목표 입력칸 없음(위쪽 숫자 4칸)", !env.d.getElementById("pj-meet-target") && env.d.querySelectorAll(".pj-meet-top .pj-meet-kpi").length === 4); + }); + + // ════════════════════ [2e] 주차별 매출 목표(020) — 매출 목표 칸 → 주차 입력 창(body), 저장하면 합계가 월 목표 ════════════════════ + await section(async function () { + const env = makeEnv(PAGE.goals_weekly_admin, GOALS_URL); + const st = goalsServer(env); + let sent = null; + env.route("PUT", /\/project\/api\/goals\/2026\/week-targets\/1$/, function (u, body) { + sent = body; + const weeks = {}; + Object.keys(body.weeks).forEach(function (k) { weeks[k] = body.weeks[k]; }); + return { body: { ok: true, value: 600, label: "600", weeks: weeks } }; + }); + await boot(env); + const inp = env.d.querySelector('input.pj-goal-num[data-metric="sales"][data-kind="target"][data-month="1"]'); + check("[2e] 매출 목표 칸은 직접 입력 아님(readonly)", inp.readOnly && inp.dataset.weekly === "1"); + inp.click(); + const pop = env.d.body.querySelector(".pj-goal-wkpop"); + const ins = pop ? Array.from(pop.querySelectorAll("input")) : []; + check("[2e] 창은 body 에, 1월 주차 수만큼 입력칸", !!pop && pop.parentElement === env.d.body && ins.length === 5, ins.length); + check("[2e] 저장된 주차 값·합계", ins[0].value === "100" && ins[1].value === "200" && pop.querySelector(".pj-goal-wkpop-sum b").textContent === "300"); + type(env, ins[2], "300"); + check("[2e] 입력하면 합계 다시 계산", pop.querySelector(".pj-goal-wkpop-sum b").textContent === "600"); + pop.querySelector('[data-act="save"]').click(); + await settle(); await wait(10); await settle(); + check("[2e] 주차별 값 전송(주차 시작일 키)", sent && sent.weeks["2026-01-12"] === "300" && Object.keys(sent.weeks).length === 5, sent); + check("[2e] 월 목표 칸 = 합계, 창 닫힘", inp.value === "600" && !env.d.body.querySelector(".pj-goal-wkpop")); + check("[2e] 월 목표 직접 저장 요청 없음", !st.metric); }); // ════════════════════ [3] 목표 표 — 글 저장 실패면 구조 변경·표 교체 중단 ════════════════════ @@ -504,12 +529,11 @@ function meetServer(env, st) { 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); }))); + check("[6] 누적 목표 대비 달성 = 미확인(차액·% 계산하지 않음)", /미확인/.test(kpi.find(function (t) { return /누적 목표 대비/.test(t); }))); const row = env.d.querySelector('tr[data-item="1"]'); check("[6] 쇼핑몰 줄도 결과 = 직접 입력 칸(자동 결과 폐지)", !!row.querySelector(".pj-meet-c-result input") && !/미확인/.test(row.querySelector(".pj-meet-c-result").textContent)); check("[6] 줄별 이번주 실적 표시 없음 · 달성률 열 없음", !row.querySelector(".pj-meet-week-slot") && !row.querySelector("[data-rate]")); - check("[6] 회의록 입력은 그대로 가능", !!row.querySelector(".pj-meet-text") && !!env.d.getElementById("pj-meet-target")); + check("[6] 회의록 입력은 그대로 가능", !!row.querySelector(".pj-meet-text") && !!env.d.getElementById("pj-meet-notes")); check("[6] 조회 실패 안내 문구", /미확인/.test(env.d.querySelector(".pj-meet-perf-warn").textContent)); }); await section(async function () { // 지난주 리뷰 머리 = 지난주(9/21~) — 지난주 회의록에 없는 줄 안내 @@ -802,7 +826,7 @@ function meetServer(env, st) { 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(".pj-meet-text") && !env.d.getElementById("pj-meet-target")); + check("[9] 보기 전용: 입력칸 없음", !env.d.querySelector(".pj-meet-text, .pj-meet-rnote, #pj-meet-notes")); }); 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: ["네이버"] }) } }); diff --git a/tests/js/help_ui.test.js b/tests/js/help_ui.test.js index d84c84d..c752e10 100644 --- a/tests/js/help_ui.test.js +++ b/tests/js/help_ui.test.js @@ -40,7 +40,7 @@ assert.equal(w.lastScroll, "goals-merge"); assert.equal(d.querySelector('.pjh-toc [aria-current="location"]').hash, "#goals"); assert.equal(new URL(w.location.href).searchParams.get("q"), "셀 병합"); -search("7일 전"); +search("바로 앞 주차"); assert.ok(links().some(a => a.hash === "#meetings-review"), "제목에 없는 본문 단어도 검색"); search("매출 갱신"); assert.equal(links()[0].hash, "#meetings-markets"); diff --git a/tests/js/render_goals.py b/tests/js/render_goals.py index 7c88832..fe29761 100644 --- a/tests/js/render_goals.py +++ b/tests/js/render_goals.py @@ -55,13 +55,23 @@ def goals_ctx(admin: bool) -> dict: } +def week_targets() -> dict: + """2026년 달마다 주차(store.month_weeks) — 1월 1·2주차만 값(100·200).""" + out = {} + for mo in range(1, 13): + out[mo] = [{"start": a.isoformat(), "n": i + 1, "label": f"{a.month}/{a.day}~{b.month}/{b.day}", + "value": {(1, 0): "100", (1, 1): "200"}.get((mo, i), "")} + for i, (a, b) in enumerate(store.month_weeks(2026, mo))] + return out + + def meeting_view(err: bool) -> dict: """회의록 2026-09-28 주 — 유통 쿠팡(쇼핑몰 연결 — 화면엔 자동 실적 없음, 정량 목표 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, + prev_p1 = {"id": 902, "week_start": "2026-09-21", "content": "샘플", "result_note": "샘플 결과", "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", @@ -74,7 +84,7 @@ def meeting_view(err: bool) -> dict: 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": "메모 원본", "cell_merges": True, + meeting = {"week_start": "2026-09-28", "week_target": 1000, "attendees": "", "notes": "메모 원본", "cell_merges": True, "result_notes": True, "items": [it_p1, it_new, it_cou], "sections": [{"name": "상품", "color": "#fde2e4", "rows": [it_p1, it_new]}, {"name": "유통", "color": "", "rows": [it_cou]}]} @@ -82,6 +92,8 @@ def meeting_view(err: bool) -> dict: "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, + "week_targets_set": True, "cum_target": 4000.0, "cum_target_won": 4000, + "gap": None if err else -4000, "rate": None if err else 0.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", @@ -139,6 +151,8 @@ def main() -> None: pages = { "goals_admin.html": ("project/goals.html", goals_ctx(True)), "goals_ro.html": ("project/goals.html", goals_ctx(False)), + # 주차별 매출 목표(020) — 매출 목표 칸이 주차 입력 창을 연다 + "goals_weekly_admin.html": ("project/goals.html", goals_ctx(True) | {"week_targets": week_targets()}), "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)), diff --git a/tests/test_project_meeting_periods.py b/tests/test_project_meeting_periods.py new file mode 100644 index 0000000..0510ea0 --- /dev/null +++ b/tests/test_project_meeting_periods.py @@ -0,0 +1,61 @@ +"""주간 회의록 주차 규칙(2026-10-07) — store.month_weeks·week_period·prev_week_period·validate_period_start. DB 없이 실행.""" +import unittest +from datetime import date, timedelta + +from app.modules.project import store + + +def fmt(periods): + return [(a.isoformat(), b.isoformat()) for a, b in periods] + + +class MonthWeeksTest(unittest.TestCase): + def test_first_on_weekday_starts_week_one(self): + # 2026-10-01 목 → 1주차 10/1~10/4, 말일 10/31 토 → 마지막 주차 10/26~10/31 + self.assertEqual(fmt(store.month_weeks(2026, 10)), [ + ("2026-10-01", "2026-10-04"), ("2026-10-05", "2026-10-11"), ("2026-10-12", "2026-10-18"), + ("2026-10-19", "2026-10-25"), ("2026-10-26", "2026-10-31")]) + + def test_first_on_weekend_joins_next_week(self): + # 2026-08-01 토 → 1주차 8/1~8/9, 2026-11-01 일 → 1주차 11/1~11/8 + self.assertEqual(store.month_weeks(2026, 8)[0], (date(2026, 8, 1), date(2026, 8, 9))) + self.assertEqual(store.month_weeks(2026, 11)[0], (date(2026, 11, 1), date(2026, 11, 8))) + + def test_last_day_monday_or_tuesday_joins_previous_week(self): + # 2026-08-31 월 → 마지막 주차 8/24~8/31, 2026-03-31 화 → 3/23~3/31 + self.assertEqual(store.month_weeks(2026, 8)[-1], (date(2026, 8, 24), date(2026, 8, 31))) + self.assertEqual(store.month_weeks(2026, 3)[-1], (date(2026, 3, 23), date(2026, 3, 31))) + # 말일 수(2026-09-30) → 9/28~9/30 그대로 한 주차 + self.assertEqual(store.month_weeks(2026, 9)[-1], (date(2026, 9, 28), date(2026, 9, 30))) + + def test_periods_cover_month_without_gaps(self): + for y in (2025, 2026, 2027, 2028): + for m in range(1, 13): + ws = store.month_weeks(y, m) + self.assertEqual(ws[0][0], date(y, m, 1)) + self.assertEqual(ws[-1][1], store.month_last_day(y, m)) + for (a, b), (c, _) in zip(ws, ws[1:]): + self.assertEqual(c, b + timedelta(days=1)) + self.assertEqual(c.weekday(), 0) # 2주차부터는 월요일 시작 + self.assertEqual(b.weekday(), 6) + + def test_period_lookup_and_previous(self): + self.assertEqual(store.week_period(date(2026, 10, 3)), (date(2026, 10, 1), date(2026, 10, 4))) + # 10월 1주차의 지난주 = 9월 마지막 주차(9/28~9/30) + self.assertEqual(store.prev_week_period(date(2026, 10, 1)), (date(2026, 9, 28), date(2026, 9, 30))) + self.assertEqual(store.prev_week_period(date(2026, 10, 12)), (date(2026, 10, 5), date(2026, 10, 11))) + self.assertEqual(store.week_number(date(2026, 10, 12)), 3) + + def test_validate_period_start(self): + self.assertEqual(store.validate_period_start("2026-10-01"), date(2026, 10, 1)) + self.assertEqual(store.validate_period_start("2026-10-05"), date(2026, 10, 5)) + with self.assertRaises(ValueError): + store.validate_period_start("2026-10-06") + with self.assertRaises(ValueError): + store.validate_period_start("2026-08-03") # 8/1(토) 1주차에 흡수된 월요일 + # 날짜만 확인(기존 회의록 조회용) — 월요일이 아니어도 된다 + self.assertEqual(store.validate_week_start("2026-10-01"), date(2026, 10, 1)) + + +if __name__ == "__main__": + unittest.main() diff --git a/tests/test_project_module.py b/tests/test_project_module.py index 5bb1a82..6bee22f 100644 --- a/tests/test_project_module.py +++ b/tests/test_project_module.py @@ -736,6 +736,8 @@ def test_goal_meetings(): """주간 회의록: 만들기(처음 = 목표 표 영역 + 기본 양식 줄, 유통 줄 쇼핑몰 추측), 다음 주 = 지난 회의록 줄 이어받기 (carry_from → prev), 금액 표기(만·억), 평가 값 검사, 줄 추가/이동/삭제, 화면·권한.""" base = date(2001, 1, 1) + timedelta(days=7 * (int(RUN, 16) % 400)) # 월요일(앞선 회의록이 없을 먼 과거) + while not 8 <= base.day <= 14: # 달 가운데 월요일 — 두 주차 모두 월~일, 앞 주차 = 7일 전(020 주차 규칙) + base += timedelta(days=7) assert base.weekday() == 0 w1, w2 = base, base + timedelta(days=7) for w in (w2, w1): @@ -803,9 +805,12 @@ def test_goal_meetings(): def _meet_weeks(seed: int, n: int) -> list[date]: - """지난 주들(실적 기간이 "진행 전"이 아니게) — test_goal_meetings(2001~2008)와 겹치지 않는 2010~2018 의 월요일 n 개.""" + """지난 주들(실적 기간이 "진행 전"이 아니게) — test_goal_meetings(2001~2008)와 겹치지 않는 2010~2018 의 월요일 n 개(n ≤ 4). + 020 주차 규칙에서도 모두 주차 시작일이고 앞 주차 = 7일 전이 되게 같은 달 4~6일 월요일부터.""" base = date(2010, 1, 4) + timedelta(days=7 * ((int(RUN, 16) + seed * 60) % 400)) - assert base.weekday() == 0 + while not 4 <= base.day <= 6: + base += timedelta(days=7) + assert base.weekday() == 0 and n <= 4 return [base + timedelta(days=7 * i) for i in range(n)] @@ -884,7 +889,7 @@ def test_meeting_prev_week_links(): 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 v["head"]["prev_exists"] is False assert all("rate" not in it for it in v["meeting"]["items"]) # 달성률 열 폐지(2026-10-06) # w1 을 만들면 w2 의 지난주 = w1(그 주 줄, 비어 있음) — w0 의 50/100 이 아니다 _create_meeting(w1) @@ -926,7 +931,8 @@ class _FakePerf: def test_meeting_perf_unknown_vs_zero(): - """실적 모듈 장애는 미확인(None + head.unknown), 정상 무매출만 0. 의존하는 필요 매출·달성률도 미확인.""" + """실적 모듈 장애는 미확인(None + head.unknown), 정상 무매출만 0. 그 값에 기대는 누적 목표 대비 차액·%도 비움. + 월 누적 목표 = 주차별 목표(1주차~이 주차) 합, 월 누적 실적 = 1일 ~ 이 주차 끝(지난 주차).""" from app.modules.project import store (w,) = _meet_weeks(2, 1) @@ -937,6 +943,8 @@ def test_meeting_perf_unknown_vs_zero(): _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} + orig_week_targets = ST.goal_week_targets + ST.goal_week_targets = lambda **kw: {} try: _create_meeting(w - timedelta(days=7)) _create_meeting(w) @@ -960,40 +968,35 @@ def test_meeting_perf_unknown_vs_zero(): # 실적 모듈 미연결 — perf False, 값 없음(미확인 아님) v = view(None) assert v["head"]["perf"] is False and v["head"]["perf_state"] == "off" and v["head"]["unknown"] == [] - # 쇼핑몰 목록 장애 — 0 이 아니라 미확인, 필요 매출도 계산하지 않음, 회의록은 열림 + # 쇼핑몰 목록 장애 — 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 + assert h["mtd"] is None and h["gap"] is None and "mtd" in h["unknown"], h row = coupang_row(v) # 지난주 결과는 실적에서 자동으로 채우지 않는다(2026-10-06) — 직접 입력이 없으면 비어 있음 assert row["prev"]["result"] is None and "rate" not in row assert 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"]["result"] is None and "rate" not in coupang_row(v) - # 정상 조회 0 건 — 진짜 0원(미확인 아님), 필요 매출 = 목표 ÷ 남은 주 + assert h["perf_state"] == "ok" and h["mtd"] is None and "mtd" in h["unknown"] + # 정상 조회 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 "auto_result" not in row["prev"] and row["prev"]["result"] is None and "rate" not in row + assert h["mtd"] == 0 and h["unknown"] == [], h + assert h["week_targets_set"] is False and h["cum_target_won"] is None and h["gap"] is None 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})) + # 월 누적 실적 = 1일 ~ 이 주차 끝 / 월 누적 목표 = 1주차~이 주차 주차별 목표 합 → 차액·% + week_end = store.week_period(w)[1] + ST.goal_week_targets = lambda **kw: {a.isoformat(): 1000.0 for a, _ in weeks} + v = view(_FakePerf(amounts={(month_first, "coupang"): 30, (week_end, "coupang"): 40, + (week_end + timedelta(days=1), "coupang"): 999})) 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 - # 쇼핑몰 지난주 매출(70)이 있어도 줄 결과·달성률은 자동으로 채우지 않는다 - assert coupang_row(v)["prev"]["result"] is None and "rate" not in coupang_row(v) + assert h["mtd"] == 70 and h["mtd_end"] == week_end.isoformat(), h + assert h["cum_target_won"] == 3000 and h["gap"] == 70 - 3000 and h["rate"] == round(70 / 3000 * 100, 1), h + ST.goal_week_targets = lambda **kw: {} # 매출 집계 쇼핑몰 없음 — 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"] == [] @@ -1002,6 +1005,7 @@ def test_meeting_perf_unknown_vs_zero(): assert r.status_code == 200 and r.json()["week_target"] == 1_200_000 finally: ST.goal_month_targets = orig_targets + ST.goal_week_targets = orig_week_targets _drop_meetings([w, w - timedelta(days=7)])
표시·상태확인할 내용
미확인조회에 실패해 값을 알 수 없습니다. 0원과 다릅니다. 이에 의존하는 달성률·주당 필요 매출도 계산하지 않습니다. 안내의 다시 시도를 사용하거나 실적 연결 상태를 확인하세요.
미확인조회에 실패해 값을 알 수 없습니다. 0원과 다릅니다. 이에 의존하는 누적 목표 대비 달성도 계산하지 않습니다. 안내의 다시 시도를 사용하거나 실적 연결 상태를 확인하세요.
0원매출 조회는 성공했지만 해당 기간에 저장된 실적이 없거나 합계가 0원입니다. 필요하면 실적 화면에서 매출 자료를 갱신하세요.
실적 미연결·집계 대상 없음자동 실적·누적이 비어 있습니다. 회의록 계획·메모는 계속 입력할 수 있습니다.
실적 갱신 권한 없음새 매출을 요청하지 않고 저장된 실적을 보여 줍니다. 회의록 조회 권한과 매출 갱신 권한은 별개입니다.