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 }}년 목표 표의 업무 영역과 기본 양식 줄로 시작합니다.
{% 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 %}
{# is-this / is-prev — 순서 바꾸기(project.js initMeetOrder)가 이 묶음으로 열을 옮긴다 #}
+ {% if edit and meeting.result_notes %}
+ {% else %}
{{ p.result_note or '' }}
{% endif %}
+
{{ won(p.target_amount) }}
- {% if edit %}
+ {% if edit %}
{% else %}{{ won(p.result_amount) }}{% endif %}
{% else %}
-
{% if h.prev_exists %}지난주 회의록에 없는 줄{% else %}지난주({{ prev_week[5:] | replace('-', '/') }}~) 회의록 없음{% endif %}
+
{% if h.prev_exists %}지난주 회의록에 없는 줄{% else %}지난주({{ prev_week[5:] | replace('-', '/') }}~) 회의록 없음{% endif %}
{% endif %}
{% endfor %}
@@ -265,15 +247,9 @@
칸을 고치면 바로 저장됩니다. 금액은 원 단위(120만·1.5억도 됨). 항목을 우클릭하거나 ⋯ 를 누르면
- 줄 추가·순서·삭제. 지난주 정량 목표(결과 금액)는 지난 회의록 줄에 저장됩니다.
+ 줄 추가·순서·삭제. 지난주 결과(글·금액)는 지난 주차 회의록 줄에 저장됩니다.
{% endif %}
-
-
-
결정 사항 · 메모
- {% if edit %}
- {% else %}
{{ meeting.notes or '—' }}
{% endif %}
-
{% endif %}
@@ -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 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 @@
매출·로아스 입력과 달성률 계산
칸
입력·계산 방법
-
매출 목표·실적
관리자가 월별 숫자를 직접 입력합니다. 목표 표의 실적은 회의록의 자동 매출과 별도로 관리하므로 실적 모듈에서 자동으로 채워지지 않습니다.
+
매출 목표
월 칸을 누르면 그 달 주차별 목표 입력 창이 열립니다. 주차마다 금액(매출 단위)을 넣고 저장하면 주차 합계가 그 달 매출 목표가 됩니다. 주차는 주간 회의록 주차와 같습니다. 주차를 모두 비우고 저장하면 월 목표도 지워집니다.
+
매출 실적
관리자가 월별 숫자를 직접 입력합니다. 목표 표의 실적은 회의록의 자동 매출과 별도로 관리하므로 실적 모듈에서 자동으로 채워지지 않습니다.
매출 단위
예를 들어 단위가 백만원이면 30은 30,000,000원입니다. 단위를 바꿔도 이미 적은 숫자는 자동 환산되지 않으므로 숫자와 단위를 함께 확인하세요.
연간·분기 매출
해당 기간에 입력한 월 숫자의 합계입니다. 합계 칸에 따로 입력하지 않습니다.
달성
실적 ÷ 목표 × 100입니다. 월별로 계산하며, 연간·분기는 기간 전체 목표 합계 대비 입력된 실적 합계로 계산합니다. 목표가 없거나 0이면 달성률을 표시하지 않습니다. 100% 이상은 초록으로 표시됩니다.
@@ -575,9 +576,15 @@
왼쪽 목표에서 연도를 선택하고 표 머리의 월 이름을 누릅니다.
이미 만든 회의록은 왼쪽 목표 연도 아래의 월 폴더에서도 열 수 있습니다. 폴더 아이콘과 월 이름을 눌러 접거나 펼치고, 주차·날짜 항목을 누르면 오른쪽 회의록만 바뀝니다. 왼쪽 메뉴와 스크롤 위치는 유지됩니다. 입력한 칸은 이동 전에 저장하며, 저장에 실패하면 현재 회의록을 유지합니다. 접기·펼치기는 이 브라우저에 기억됩니다.
-
위쪽 주차 탭 또는 오른쪽 작은 달력의 주 한 줄을 눌러 주를 고릅니다. 점은 회의록이 있는 주, 이번 주는 현재 주입니다. 이전·다음 달 버튼으로 달을 바꿉니다.
-
한 주는 월요일~일요일이고, 월요일이 속한 달의 회의록입니다. 1주차는 그 달 첫 월요일이 있는 주입니다. 예: 2026년 10월 1주차는 10/5~10/11이며, 9/28~10/4는 9월 회의록입니다.
-
작은 달력의 흐린 앞 달 주를 누르면 그 달 회의록으로 갑니다. 해당 연도 목표 버튼은 연간 목표 표로 돌아갑니다.
+
위쪽 주차 탭 또는 오른쪽 작은 달력의 한 줄을 눌러 주차를 고릅니다. 달력 줄을 누르면 그 줄의 이 달 날짜가 든 주차가 열립니다. 점은 회의록이 있는 주차, 이번 주는 현재 주차입니다. 이전·다음 달 버튼으로 달을 바꿉니다.
+
주차는 그 달 안에서만 나눕니다. 기본은 월요일~일요일입니다.
+
+
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(월).
+
+
+
해당 연도 목표 버튼은 연간 목표 표로 돌아갑니다.
회의록 만들기와 이어받는 항목
@@ -585,31 +592,29 @@
줄이 있는 가장 가까운 앞선 회의록에서 구역·항목 이름·색·순서를 이어받습니다. 앞선 회의록이 없으면 가장 가까운 다음 회의록의 구성을 가져옵니다.
어느 쪽에도 회의록이 없으면 해당 연도 목표 표의 업무 영역과 기본 양식으로 시작합니다.
-
주요 업무·금액·메모는 새로 적습니다. 구성을 이어받는 것과 지난주 리뷰는 다릅니다. 리뷰에는 정확히 7일 전 주의 같은 항목만 표시됩니다.
+
주요 업무·금액·메모는 새로 적습니다. 구성을 이어받는 것과 지난주 리뷰는 다릅니다. 리뷰에는 바로 앞 주차의 같은 항목만 표시됩니다.
이 달 계획 확인
제목 아래 해당 월 계획은 연간 목표 표에 적은 월 계획을 업무 영역별로 보여 줍니다. 굵게·기울임·밑줄·글자 색상과 줄바꿈·들여쓰기를 유지하고, 글자 크기는 월 계획의 기본 크기로 표시합니다. 빈 계획은 생략하고, 병합 칸은 해당 월을 포함하는 계획을 한 번 표시합니다. 여기서는 읽기만 하므로 수정하려면 연간 목표 표로 돌아갑니다.
-
월 목표·누적·주당 필요 매출 읽기
+
위쪽 숫자(월 목표·누적 목표·누적 실적·달성)와 결정 사항
+
위쪽 영역은 화면을 스크롤해도 고정됩니다. 왼쪽 절반은 숫자 4칸, 오른쪽 절반은 결정 사항 · 메모입니다.
지표
뜻과 출처
-
월 목표 매출·목표 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,200,000·120만·1.5억·3천만·1억2천만처럼 입력할 수 있습니다. Enter 또는 칸을 떠날 때 원 단위로 저장되고, 빈칸은 값을 지웁니다. 글·메모는 입력을 약 0.8초 멈추거나 칸을 떠날 때, 참석자는 바꾸는 즉시 저장됩니다.
@@ -625,21 +630,22 @@
지난주 리뷰·결과·정량 목표
-
지난주 리뷰의 결과(지난주 주요 업무)와 전주 목표는 정확히 7일 전 주의 같은 항목에서 가져옵니다. 이름 변경·순서 이동·회의록 생성 순서와 관계없이 이어진 같은 줄을 찾습니다. 그 주 회의록이 없으면 “회의록 없음”, 회의록은 있지만 항목이 없으면 “지난주 회의록에 없는 줄”로 표시합니다. 몇 주 전 기록을 지난주로 대신 보여 주지 않습니다.
+
지난주 리뷰는 바로 앞 주차의 같은 항목에서 가져옵니다(앞 주차가 앞 달 마지막 주차일 수 있습니다). 이름 변경·순서 이동·회의록 생성 순서와 관계없이 이어진 같은 줄을 찾습니다. 그 주차 회의록이 없으면 “회의록 없음”, 회의록은 있지만 항목이 없으면 “지난주 회의록에 없는 줄”로 표시합니다. 몇 주 전 기록을 지난주로 대신 보여 주지 않습니다.
-
결과 — 지난주에 적은 주요 업무를 그대로 보여 줍니다(읽기 전용).
-
전주 목표 — 지난주 회의록에서 그 줄에 적은 정량 목표입니다.
-
정량 목표 — 관리자가 지난주 결과 금액을 직접 입력합니다(실적 모듈에서 자동 입력되지 않습니다).
-
저장 위치 — 이번 화면에서 입력한 지난주 정량 목표(결과 금액)는 지난주 회의록의 줄에 저장됩니다. 주요 업무·이번주 정량 목표는 이번주 회의록에 저장됩니다.
+
전주 업무 — 지난 주차에 적은 주요 업무를 그대로 보여 줍니다(읽기 전용).
+
결과(글) — 지난 주차 업무를 어떻게 했는지 관리자가 적습니다.
+
전주 목표 — 지난 주차 회의록에서 그 줄에 적은 정량 목표입니다.
+
결과(금액) — 관리자가 지난 주차 결과 금액을 직접 입력합니다(실적 모듈에서 자동 입력되지 않습니다).
+
저장 위치 — 이번 화면에서 입력한 지난주 결과(글·금액)는 지난 주차 회의록의 줄에 저장됩니다. 주요 업무·정량 목표는 이번 주차 회의록에 저장됩니다.
순서 바꾸기는 이번주와 지난주 리뷰의 좌우 배치만 바꿉니다. 선택은 로그인한 사람별로 내 브라우저에 기억됩니다.
매출 갱신·실적 표시
-
실적 모듈 매출은 위쪽 숫자 카드(월 누적·주당 필요 매출·전주 실적·금주 현재 실적)에만 쓰입니다. 줄(쿠팡·네이버 등)마다의 이번주 실적·지난주 결과는 자동으로 표시·입력되지 않으며, 지난주 결과는 직접 입력합니다.
+
실적 모듈 매출은 위쪽 숫자 칸(월 누적 실적·누적 목표 대비 달성)에만 쓰입니다. 줄(쿠팡·네이버 등)마다의 이번주 실적·지난주 결과는 자동으로 표시·입력되지 않으며, 지난주 결과는 직접 입력합니다.
실적 갱신 권한이 있으면 주차를 열 때 지난주부터 선택한 주의 오늘까지 매출을 자동 갱신합니다. 같은 주의 자동 갱신은 브라우저에서 10분 간격으로 제한하며, 성공 시에는 별도 큰 안내 없이 숫자가 바뀝니다. 실패·일부 쇼핑몰 실패 시 작은 안내와 다시 시도가 나옵니다. 마지막 갱신 성공 시각은 실적 모듈 기록이며 숫자에 마우스를 올려 확인할 수 있습니다.
표시·상태
확인할 내용
-
미확인
조회에 실패해 값을 알 수 없습니다. 0원과 다릅니다. 이에 의존하는 달성률·주당 필요 매출도 계산하지 않습니다. 안내의 다시 시도를 사용하거나 실적 연결 상태를 확인하세요.
+
미확인
조회에 실패해 값을 알 수 없습니다. 0원과 다릅니다. 이에 의존하는 누적 목표 대비 달성도 계산하지 않습니다. 안내의 다시 시도를 사용하거나 실적 연결 상태를 확인하세요.
0원
매출 조회는 성공했지만 해당 기간에 저장된 실적이 없거나 합계가 0원입니다. 필요하면 실적 화면에서 매출 자료를 갱신하세요.
실적 미연결·집계 대상 없음
자동 실적·누적이 비어 있습니다. 회의록 계획·메모는 계속 입력할 수 있습니다.
실적 갱신 권한 없음
새 매출을 요청하지 않고 저장된 실적을 보여 줍니다. 회의록 조회 권한과 매출 갱신 권한은 별개입니다.
@@ -653,7 +659,7 @@
저장 확인·인쇄·회의록 삭제
-
저장 실패 시 칸이 빨갛게 표시되며 입력값은 남습니다. 다시 입력하거나 칸을 떠나면 재시도합니다. 금주 목표를 저장하거나 자동 실적을 갱신해도 다른 칸의 작성 중인 글은 유지됩니다. 저장이 안 된 상태에서는 줄 추가·순서 이동 같은 작업에 앞서 저장을 다시 시도합니다. 실패하면 구조 변경을 멈춥니다. 초안 복원과 페이지 떠남 보호는 목표의 저장 안내와 같습니다.
+
저장 실패 시 칸이 빨갛게 표시되며 입력값은 남습니다. 다시 입력하거나 칸을 떠나면 재시도합니다. 자동 실적을 갱신해도 다른 칸의 작성 중인 글은 유지됩니다. 저장이 안 된 상태에서는 줄 추가·순서 이동 같은 작업에 앞서 저장을 다시 시도합니다. 실패하면 구조 변경을 멈춥니다. 초안 복원과 페이지 떠남 보호는 목표의 저장 안내와 같습니다.
인쇄는 브라우저 인쇄창을 엽니다. 인쇄용 화면에서는 사이드바·작은 달력·편집 도구를 숨깁니다. 브라우저의 PDF 저장도 사용할 수 있습니다.
관리자의 회의록 삭제는 선택한 한 주의 회의록과 줄을 삭제합니다. 다음주 화면의 지난주 리뷰도 비게 됩니다. 같은 주를 다시 만들면 항목 구성은 이어질 수 있지만 삭제한 글과 금액은 복구되지 않습니다.
@@ -679,7 +685,7 @@
Q. 하위 작업을 다른 프로젝트 작업으로 옮길 수 있나요? 하위 작업은 같은 프로젝트 안의 작업으로만 옮길 수 있습니다.
Q. 작업을 두 프로젝트에 같이 두고 싶어요. 작업 편집 창의 “프로젝트” 칸에서 다른 프로젝트에 추가를 쓰세요. (8장)
Q. 목표 표의 실적과 회의록 매출이 달라요. 목표 표의 월 실적은 직접 입력한 숫자이고, 회의록 매출은 실적 모듈 자료입니다. 매출 단위와 집계 기간도 확인하세요. (숫자 지표 · 회의록 지표)
-
Q. 지난주 회의록이 있는데 리뷰가 비어 있어요. 화면의 지난주 날짜와 항목을 확인하세요. 정확히 7일 전 회의록의 이어진 같은 항목만 표시합니다. 따로 추가한 줄은 이름이 같아도 다른 항목일 수 있습니다. (지난주 리뷰)
+
Q. 지난주 회의록이 있는데 리뷰가 비어 있어요. 화면의 지난주 날짜와 항목을 확인하세요. 바로 앞 주차 회의록의 이어진 같은 항목만 표시합니다. 따로 추가한 줄은 이름이 같아도 다른 항목일 수 있습니다. (지난주 리뷰)
Q. 도움말에서 필요한 설명을 빠르게 찾고 싶어요. 이 페이지 위쪽 검색창에 단어를 입력하고 결과를 누르세요. 제목·본문의 일치 단어가 강조되고 해당 소제목으로 이동합니다. Enter는 첫 결과로 이동, Esc나 지우기는 검색을 초기화합니다.