diff --git a/CLAUDE.md b/CLAUDE.md
index 074296f..6f31a89 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)만 그 프로젝트를 조회 — **관리자도 멤버가 아니면 안 보임, 예외는 슈퍼관리자뿐**(2026-10-07, `access.sees_all_projects`; 사이드바 목록·검색·휴지통·알림도 같은 기준, 화면·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)·전주 목표·결과 — 정량 목표·결과는 숫자면 원 정수 칸, 아니면 글 칸 `target_text`·`result_text`(예: 20개, 021)), 실적 조회 장애는 0원이 아니라 "미확인", 위에 목표 표 그 달 열 글을 영역별 "N월 계획" 카드로, 참석자 옆 [회의록 보드] = 그 주차의 빈 Google 슬라이드를 독립 창으로(공유 드라이브 `MEETING_BOARD_FOLDER_ID`, 없으면 만듦, `app/integrations/google_slides.py`, Drive appProperties 로 주차 연결 — Drive·Slides 권한 토큰 필요), 표를 스크롤해도 보이는 머리 영역 3칸 = ① 월 계획 + 머리 줄에 숫자 4개 작게 1행(월 목표 매출·월 누적 목표 매출(목표 표 **주차별 매출 목표** `goal_week_targets` 1주차~이 주차 합 — 목표 표 매출 목표 월 칸을 누르면 주차 입력 창, 합계 = 월 목표)·월 누적 실적(1일~오늘)·누적 목표 대비 차액·%) | ② 결정 사항·메모 | ③ 작업 등록 표(제목·담당자·프로젝트·섹션 → [적용] = 그 프로젝트에 작업 생성, `initMeetQuickTasks`), 실적 모듈 `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, 섹션 머리는 모두 `#f3f3f3` — 섹션별 색 지정 없음, 섹션 기본 담당자 `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)만 그 프로젝트를 조회 — **관리자도 멤버가 아니면 안 보임, 예외는 슈퍼관리자뿐**(2026-10-07, `access.sees_all_projects`; 사이드바 목록·검색·휴지통·알림도 같은 기준, 화면·API 모두 비멤버 403)하고 서브프로젝트/작업/단계 CRUD — URL 의 섹션·부모 작업이 그 프로젝트 것인지 서버가 검증. 실시간 반영은 `project_live_version` 카운터(마이그레이션 007, 미적용 시 MAX 폴백). 사이드바 전체 검색(`/api/search`, 제목·설명·댓글, pg_trgm) + 프로젝트/내 작업 필터 바(찾기·상태·담당자·마감·우선순위·정렬, 클라이언트 필터). 협업자(`task_followers`, 자동 팔로우: 만든 사람·담당자·댓글·@태그) — 완료·댓글 알림은 담당자+협업자에게만. 나를 태그하거나 작업이 배정되면 프로젝트 화면 가운데 아래에 깜박이는 큰 팝업(닫기 전까지, `initTaskAlerts` + `GET /api/notifications/alerts`). 작업 삭제는 휴지통(`project_trash`, 마이그레이션 010) — 삭제 직전 스냅샷 3개월 보관, 관리자만 보기·복구(`/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/{월}`, 프로젝트 권한자 **누구나 수정** — 관리자 [회의 완료](`completed_at`, 마이그레이션 022)면 잠금(지난주 결과는 다음 주 회의록이 열려 있는 동안 허용), 삭제·완료·완료 해제는 관리자, 주차 탭 — **주차는 그 달 안**(`store.month_weeks`: 1일이 월~금이면 1일~일요일이 1주차, 토·일이면 1일~다음 주 일요일, 그 뒤 월~일, 말일이 월·화면 앞 주차에 붙음, 회의록 `week_start` = 주차 시작일, 마이그레이션 020), `goal_meetings`·`goal_meeting_items` 마이그레이션 015 — 지난주 = **바로 앞 주차**(`store.prev_week_period`) 회의록의 같은 연결키 줄(`line_key`, 마이그레이션 018 — 생성 순서·이름 변경과 무관, 이름 추정 연결 금지)로 리뷰(열: 주요 업무·정량 목표 ‖ 전주 업무·결과(글, `result_note` 020)·전주 목표·결과 — 정량 목표·결과는 숫자면 원 정수 칸, 아니면 글 칸 `target_text`·`result_text`(예: 20개, 021)), 실적 조회 장애는 0원이 아니라 "미확인", 위에 목표 표 그 달 열 글을 영역별 "N월 계획" 카드로, 참석자 옆 [회의록 보드] = 그 주차의 빈 Google 슬라이드를 독립 창으로(공유 드라이브 `MEETING_BOARD_FOLDER_ID`, 없으면 만듦, `app/integrations/google_slides.py`, Drive appProperties 로 주차 연결 — Drive·Slides 권한 토큰 필요), 표를 스크롤해도 보이는 머리 영역 3칸 = ① 월 계획 + 머리 줄에 숫자 4개 작게 1행(월 목표 매출·월 누적 목표 매출(목표 표 **주차별 매출 목표** `goal_week_targets` 1주차~이 주차 합 — 목표 표 매출 목표 월 칸을 누르면 주차 입력 창, 합계 = 월 목표)·월 누적 실적(1일~오늘)·누적 목표 대비 차액·%) | ② 결정 사항·메모 | ③ 작업 등록 표(제목·담당자·프로젝트·섹션 → [적용] = 그 프로젝트에 작업 생성, `initMeetQuickTasks`), 실적 모듈 `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 b844f97..e470f23 100644
--- a/app/modules/project/db.py
+++ b/app/modules/project/db.py
@@ -2573,6 +2573,41 @@ class ProjectStore:
self._meeting_v20_ok = True
return ok
+ def _meeting_v22(self, conn: Any) -> bool:
+ """마이그레이션 022 — 회의 완료(goal_meetings.completed_at, 수정 잠금)."""
+ if getattr(self, "_meeting_v22_ok", False):
+ return True
+ ok = self._column_exists(conn, "goal_meetings", "completed_at")
+ if ok:
+ self._meeting_v22_ok = True
+ return ok
+
+ def _check_meeting_open(self, conn: Any, week_start: Any) -> None:
+ """그 주차 회의록이 완료(잠금)됐으면 MeetingLocked. 022 전이면 잠금 없음."""
+ if not self._meeting_v22(conn):
+ return
+ row = conn.execute("SELECT completed_at FROM goal_meetings WHERE week_start = %s", (week_start,)).fetchone()
+ if row and row["completed_at"] is not None:
+ raise store.MeetingLocked()
+
+ def set_meeting_completed(self, *, week_start: date, done: bool, by: str = "") -> dict[str, Any]:
+ """회의 완료(잠금)·완료 해제 — 관리자만(라우터). 바뀐 상태를 돌려준다."""
+ with self._pool.connection() as conn:
+ self._require_meetings(conn)
+ if not self._meeting_v22(conn):
+ raise store.MeetingMigration022Needed()
+ row = conn.execute(
+ "UPDATE goal_meetings SET completed_at = CASE WHEN %s THEN COALESCE(completed_at, now()) ELSE NULL END, "
+ "completed_by = CASE WHEN %s THEN %s ELSE '' END, updated_at = now() "
+ "WHERE week_start = %s RETURNING completed_at, completed_by",
+ (done, done, store.norm_str(by, lower=True), week_start),
+ ).fetchone()
+ if row is None:
+ raise KeyError(str(week_start))
+ return {"completed": row["completed_at"] is not None,
+ "completed_at": row["completed_at"].astimezone(KST).isoformat(timespec="minutes") if row["completed_at"] else "",
+ "completed_by": row["completed_by"] or ""}
+
def meetings_v20(self) -> bool:
with self._pool.connection() as conn:
return self._table_exists(conn, "goal_meetings") and self._meeting_v20(conn)
@@ -2585,14 +2620,16 @@ class ProjectStore:
self._meeting_cells_ok = True
return ok
- def _locked_meeting_items(self, conn: Any, item_id: int) -> list[dict[str, Any]]:
- """글 저장·이동·병합·줄 변경이 같은 주 잠금을 공유한다."""
+ def _locked_meeting_items(self, conn: Any, item_id: int, *, check_open: bool = True) -> list[dict[str, Any]]:
+ """글 저장·이동·병합·줄 변경이 같은 주 잠금을 공유한다. check_open — 회의 완료(022)된 주면 MeetingLocked."""
me = conn.execute("SELECT week_start FROM goal_meeting_items WHERE id = %s", (item_id,)).fetchone()
if me is None:
raise KeyError(item_id)
if not conn.execute("SELECT week_start FROM goal_meetings WHERE week_start = %s FOR UPDATE",
(me["week_start"],)).fetchone():
raise KeyError(item_id)
+ if check_open:
+ self._check_meeting_open(conn, me["week_start"])
rows = conn.execute(f"SELECT {self._meeting_cols(conn)} FROM goal_meeting_items "
"WHERE week_start = %s ORDER BY sort_order, id FOR UPDATE", (me["week_start"],)).fetchall()
if not any(int(r["id"]) == item_id for r in rows):
@@ -2655,6 +2692,9 @@ class ProjectStore:
keyed = self._meeting_keys(conn)
cell_merges = self._meeting_cells(conn)
result_notes = self._meeting_v20(conn)
+ v22 = self._meeting_v22(conn)
+ done_row = conn.execute("SELECT completed_at, completed_by FROM goal_meetings WHERE week_start = %s",
+ (week_start,)).fetchone() if v22 else None
head = conn.execute(
"SELECT week_start, week_target, attendees, notes, updated_by, updated_at "
"FROM goal_meetings WHERE week_start = %s", (week_start,),
@@ -2695,6 +2735,11 @@ class ProjectStore:
"line_keys": keyed,
"cell_merges": cell_merges,
"result_notes": result_notes,
+ "can_complete": v22,
+ "completed": bool(done_row and done_row["completed_at"] is not None),
+ "completed_at": done_row["completed_at"].astimezone(KST).strftime("%Y-%m-%d %H:%M")
+ if done_row and done_row["completed_at"] else "",
+ "completed_by": (done_row["completed_by"] or "") if done_row else "",
}
def create_meeting(self, *, week_start: date, sections: list[tuple[str, str]], created_by: str = "") -> bool:
@@ -2804,6 +2849,7 @@ class ProjectStore:
return
with self._pool.connection() as conn:
self._require_meetings(conn)
+ self._check_meeting_open(conn, week_start)
row = conn.execute(
f"UPDATE goal_meetings SET {', '.join(sets)}, updated_by = %s, updated_at = now() "
"WHERE week_start = %s RETURNING week_start",
@@ -2830,6 +2876,7 @@ class ProjectStore:
"SELECT 1 FROM goal_meetings WHERE week_start = %s FOR UPDATE", (week_start,)
).fetchone():
raise KeyError(str(week_start))
+ self._check_meeting_open(conn, week_start)
rows = conn.execute(
f"SELECT {self._meeting_cols(conn)} FROM goal_meeting_items WHERE week_start = %s "
"ORDER BY sort_order, id", (week_start,),
@@ -2902,13 +2949,18 @@ class ProjectStore:
self._require_meetings(conn)
if "result_note" in fields and not self._meeting_v20(conn):
raise store.MeetingMigration020Needed()
+ result_only = bool(fields) and set(fields) <= {"result_note", "result_amount", "status"}
if self._meeting_v21(conn):
for col, text, _err in texts:
sets.append(f"{col} = %s")
params.append(text)
elif any(text for _c, text, _e in texts):
raise ValueError(next(e for _c, t, e in texts if t)) # 021 전 — 예전처럼 숫자만
- rows = self._locked_meeting_items(conn, item_id)
+ rows = self._locked_meeting_items(conn, item_id, check_open=not result_only)
+ if result_only:
+ # 지난주 결과는 다음 주 회의에서 적는다 — 그 회의록(바로 다음 주차)이 완료됐으면 잠금
+ own = next(r for r in rows if int(r["id"]) == item_id)["week_start"]
+ self._check_meeting_open(conn, store.week_period(own)[1] + timedelta(days=1))
if "content" in fields:
self._require_meeting_cell_visible(rows, item_id)
if sets:
diff --git a/app/modules/project/router.py b/app/modules/project/router.py
index ba7264c..62e345a 100644
--- a/app/modules/project/router.py
+++ b/app/modules/project/router.py
@@ -2647,6 +2647,10 @@ 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.MeetingLocked:
+ raise HTTPException(status_code=409, detail="회의가 완료되어 수정할 수 없습니다. 관리자가 [완료 해제]하면 다시 고칠 수 있습니다.")
+ except store.MeetingMigration022Needed:
+ raise HTTPException(status_code=503, detail="회의 완료 기능은 project_db 마이그레이션 022 적용 후 사용할 수 있습니다.")
except store.MeetingMigration020Needed:
raise HTTPException(status_code=503, detail="새 주차·결과 글·주차별 목표는 project_db 마이그레이션 020 적용 후 사용할 수 있습니다.")
except store.GoalCellConflict as exc:
@@ -3293,7 +3297,7 @@ def api_get_meeting(request: Request, week_start: str, year: int, month: int) ->
@router.post("/api/goals/meetings/{week_start}")
def api_create_meeting(request: Request, week_start: str, payload: dict[str, Any] = Body(default={})) -> JSONResponse:
"""회의록 만들기(관리자) — 앞선 회의록 줄을 이어받거나, 처음이면 그 해 목표 표 업무 영역 + 기본 양식 줄."""
- user = _require_admin(request)
+ user = _require_user(request)
st = _db_or_503(request)
ws = _goal_call(store.validate_period_start, week_start)
year = _goal_call(store.validate_goal_year, payload.get("year") or ws.year)
@@ -3304,7 +3308,7 @@ def api_create_meeting(request: Request, week_start: str, payload: dict[str, Any
@router.put("/api/goals/meetings/{week_start}")
def api_update_meeting(request: Request, week_start: str, payload: dict[str, Any] = Body(...)) -> JSONResponse:
- user = _require_admin(request)
+ user = _require_user(request)
st = _db_or_503(request)
ws = _goal_call(store.validate_week_start, week_start)
fields = {k: payload[k] for k in ("week_target", "attendees", "notes") if k in payload}
@@ -3338,6 +3342,17 @@ def api_open_meeting_board(request: Request, week_start: str) -> JSONResponse:
return JSONResponse({"ok": True, "url": board["url"], "created": board["created"], "title": title})
+@router.post("/api/goals/meetings/{week_start}/complete")
+def api_complete_meeting(request: Request, week_start: str, payload: dict[str, Any] = Body(default={})) -> JSONResponse:
+ """회의 완료(수정 잠금) {done: true} · 완료 해제 {done: false} — 관리자만(2026-10-07, 마이그레이션 022)."""
+ user = _require_admin(request)
+ st = _db_or_503(request)
+ ws = _goal_call(store.validate_week_start, week_start)
+ done = payload.get("done", True) is not False
+ out = _goal_call(st.set_meeting_completed, week_start=ws, done=done, by=user["email"])
+ return JSONResponse({"ok": True, **out})
+
+
@router.delete("/api/goals/meetings/{week_start}")
def api_delete_meeting(request: Request, week_start: str) -> JSONResponse:
_require_admin(request)
@@ -3350,7 +3365,7 @@ def api_delete_meeting(request: Request, week_start: str) -> JSONResponse:
@router.post("/api/goals/meetings/{week_start}/items")
def api_add_meeting_item(request: Request, week_start: str, payload: dict[str, Any] = Body(...)) -> JSONResponse:
"""줄 추가 {section, label?, ref_item_id?, place?: above|below} — 기준 줄 위/아래, 없으면 구역 끝(새 구역이면 맨 끝)."""
- user = _require_admin(request)
+ user = _require_user(request)
st = _db_or_503(request)
ws = _goal_call(store.validate_week_start, week_start)
ref = payload.get("ref_item_id")
@@ -3369,7 +3384,7 @@ def api_add_meeting_item(request: Request, week_start: str, payload: dict[str, A
def api_update_meeting_item(request: Request, item_id: int, payload: dict[str, Any] = Body(...)) -> JSONResponse:
"""줄 칸 하나 — label·content·target_amount·result_amount(숫자 아니면 글 — 021)·result_note(020)·status·marketplace_code.
지난주 결과(글·금액)는 이번 회의 화면에서 지난 주차 줄(prev)에 저장한다."""
- user = _require_admin(request)
+ user = _require_user(request)
st = _db_or_503(request)
keys = ("label", "content", "target_amount", "result_amount", "result_note", "status", "marketplace_code")
item = _goal_call(st.update_meeting_item, item_id=item_id,
@@ -3379,7 +3394,7 @@ def api_update_meeting_item(request: Request, item_id: int, payload: dict[str, A
@router.delete("/api/goals/meeting-items/{item_id}")
def api_delete_meeting_item(request: Request, item_id: int) -> JSONResponse:
- _require_admin(request)
+ _require_user(request)
st = _db_or_503(request)
_goal_call(st.delete_meeting_item, item_id=item_id)
return JSONResponse({"ok": True})
@@ -3387,7 +3402,7 @@ def api_delete_meeting_item(request: Request, item_id: int) -> JSONResponse:
@router.post("/api/goals/meeting-cells/move")
def api_move_meeting_cell(request: Request, payload: dict[str, Any] = Body(...)) -> JSONResponse:
- user = _require_admin(request)
+ user = _require_user(request)
st = _db_or_503(request)
if not all(k in payload for k in ("source_item", "target_item", "source_body", "target_body")):
raise HTTPException(status_code=400, detail="원본·대상 셀과 예상 내용을 함께 보내 주세요.")
@@ -3398,7 +3413,7 @@ def api_move_meeting_cell(request: Request, payload: dict[str, Any] = Body(...))
@router.post("/api/goals/meeting-cells/merge")
def api_merge_meeting_cells(request: Request, payload: dict[str, Any] = Body(...)) -> JSONResponse:
- user = _require_admin(request)
+ user = _require_user(request)
result = _goal_call(_db_or_503(request).merge_meeting_cells, item_from=payload.get("item_from"),
item_to=payload.get("item_to"), updated_by=user["email"])
return JSONResponse({"ok": True, **result})
@@ -3406,14 +3421,14 @@ def api_merge_meeting_cells(request: Request, payload: dict[str, Any] = Body(...
@router.delete("/api/goals/meeting-items/{item_id}/cell-merge")
def api_unmerge_meeting_cell(request: Request, item_id: int) -> JSONResponse:
- user = _require_admin(request)
+ user = _require_user(request)
_goal_call(_db_or_503(request).unmerge_meeting_cell, item_id=item_id, updated_by=user["email"])
return JSONResponse({"ok": True})
@router.post("/api/goals/meeting-items/{item_id}/move")
def api_move_meeting_item(request: Request, item_id: int, payload: dict[str, Any] = Body(...)) -> JSONResponse:
- _require_admin(request)
+ _require_user(request)
st = _db_or_503(request)
_goal_call(st.move_meeting_item, item_id=item_id, direction=int(payload.get("direction") or 0))
return JSONResponse({"ok": True})
diff --git a/app/modules/project/store.py b/app/modules/project/store.py
index 7a07f5b..853fa62 100644
--- a/app/modules/project/store.py
+++ b/app/modules/project/store.py
@@ -405,6 +405,14 @@ class MeetingCellMigrationNeeded(RuntimeError):
"""회의록 셀 병합 메타데이터(019)가 아직 없다."""
+class MeetingLocked(RuntimeError):
+ """회의 완료(022)된 회의록은 고칠 수 없다(관리자가 완료 해제하면 다시)."""
+
+
+class MeetingMigration022Needed(RuntimeError):
+ """회의 완료(잠금)는 마이그레이션 022 뒤에만 된다."""
+
+
class MeetingMigration020Needed(RuntimeError):
"""새 주차(월요일이 아닌 시작일)·결과 글 칸·주차별 목표는 마이그레이션 020 뒤에만 된다."""
diff --git a/app/modules/project/templates/project/goal_meeting.html b/app/modules/project/templates/project/goal_meeting.html
index 5d4d80e..faf2d5d 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 %}
@@ -38,10 +38,16 @@
‹ {{ pm }}월
{{ nm }}월 ›
{% if meeting %}
+ {# 회의록은 프로젝트 권한이 있는 누구나 고친다. [회의 완료](관리자) = 수정 잠금, 완료 뒤 [완료 해제](관리자) — 마이그레이션 022 #}
- {% if is_admin %}
- {% else %}회의록은 관리자만 입력할 수 있습니다.{% endif %}
+ {% if is_admin %}{% endif %}
+ {% if meeting.can_complete %}
+ {% if meeting.completed %}
+ lock회의 완료
+ {% if is_admin %}{% endif %}
+ {% elif is_admin %}{% endif %}
+ {% endif %}
{% endif %}
{# 주차 탭 — 주차는 그 달 안(1일이 월~금이면 1일~일요일, 토·일이면 1일~다음 주 일요일, 말일이 월·화면 앞 주차에 붙음). 점 = 회의록 있음 #}
@@ -106,7 +112,7 @@
이 주차 회의록을 만들면 적을 수 있습니다.결정사항 : 진행상황 수시 공유 및 완료 되어야 함
{% if meeting %}
- {% if is_admin %}
+ {% if not meeting.completed %}
{% else %}
{{ week_n }}주차({{ week }} ~ {{ week_end }}) 회의록이 아직 없습니다.
- {% if is_admin %} + {% if true %}만들면 앞선 회의록의 줄(구역·항목)을 이어받아, 지난주 업무·목표·결과를 나란히 리뷰할 수 있습니다. 처음이면 {{ goal_year }}년 목표 표의 업무 영역과 기본 양식 줄로 시작합니다.
{% endif %}월 목표를 기준으로 지난주 결과를 리뷰하고 이번주 주요 업무와 금액 목표를 정하는 화면입니다. 연간 목표의 월 계획, 실적 모듈의 매출, 주별 결정 사항을 함께 확인합니다. 직원은 조회할 수 있고, 생성·입력·삭제는 관리자만 할 수 있습니다.
+월 목표를 기준으로 지난주 결과를 리뷰하고 이번주 주요 업무와 금액 목표를 정하는 화면입니다. 연간 목표의 월 계획, 실적 모듈의 매출, 주별 결정 사항을 함께 확인합니다. 프로젝트 관리 권한이 있는 직원은 누구나 회의록을 만들고 고칠 수 있습니다. 관리자가 회의 완료를 누르면 그 회의록은 아무도 고칠 수 없게 잠기고(🔒 회의 완료 표시), 관리자는 완료 해제로 다시 열 수 있습니다. 회의록 삭제도 관리자만 합니다.
+왼쪽 연도 앞 화살표를 누르면 해당 연도의 하위 월 전체를 접거나 펼칠 수 있습니다. 연도 글자를 누르면 연간 목표를 엽니다. 연도와 월의 접기·펼치기 선택은 이 브라우저에 기억됩니다.
diff --git a/app/modules/project/templates/project/inbox.html b/app/modules/project/templates/project/inbox.html index e0ce1a0..9cbfb78 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 5912ce1..2d90c6c 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 7c690d9..2944d27 100644 --- a/app/modules/project/templates/project/project.html +++ b/app/modules/project/templates/project/project.html @@ -484,5 +484,5 @@ - + {% endblock %} diff --git a/app/modules/project/templates/project/trash.html b/app/modules/project/templates/project/trash.html index ddff4fc..a0322d0 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 679d006..d1c5ec0 100644 --- a/app/static/project.css +++ b/app/static/project.css @@ -2680,6 +2680,14 @@ html.pj-goal-selecting, html.pj-goal-selecting * { user-select: none !important; /* 참석자 — 멤버 칩 + [참석자] 고르기 창(body 에 붙음) */ .pj-meet-attend { display: flex; align-items: flex-start; gap: 8px; margin: 0 0 10px; font-size: 12.5px; } .pj-meet-attend-label { font-weight: 600; color: var(--pj-ink-soft); line-height: 30px; flex: none; } +/* 회의 완료(잠금) — 관리자 버튼 · 완료 표시 */ +.pj-meet-complete-btn { gap: 4px; background: #e7f6ec; border-color: #b9e3c8; color: #1f7a44; } +.pj-meet-complete-btn:hover { background: #d6f0df; } +.pj-meet-complete-btn .material-symbols-outlined, .pj-meet-done-badge .material-symbols-outlined { font-size: 16px; } +.pj-meet-done-badge { + display: inline-flex; align-items: center; gap: 4px; height: 28px; padding: 0 10px; border-radius: 999px; + background: #eef0f3; color: #4b5563; font-size: 12.5px; font-weight: 700; +} /* 회의록 보드 — 파워포인트 색(#D24726)의 파스텔톤 */ .pj-meet-board-btn { flex: none; align-self: center; gap: 4px; diff --git a/app/static/project.js b/app/static/project.js index 7ab64e2..d37dbba 100644 --- a/app/static/project.js +++ b/app/static/project.js @@ -10449,6 +10449,8 @@ initMeetQuickTasks(); const week = pane.dataset.week, year = pane.dataset.year; const isAdmin = pane.dataset.admin === "true"; + // 회의록은 누구나 고친다(2026-10-07) — 회의 완료(잠금)면 아무도 못 고친다(data-edit). 관리자만 삭제·완료·완료 해제. + const canEdit = pane.dataset.edit === "true"; const SCROLL_KEY = "pj_meet_scroll"; function reloadKeepScroll() { try { sessionStorage.setItem(SCROLL_KEY, JSON.stringify([location.pathname + location.search, window.scrollY, pane.scrollTop])); } catch (_) {} @@ -10473,10 +10475,34 @@ initMeetingSync(pane); // 보기만 하는 사람도(실적 권한이 있으면) 매출 자료 갱신 const table = el("pj-meet-table"); const cellGrid = table && window.PJMeetingCells ? window.PJMeetingCells.init({ - table: table, pane: pane, admin: isAdmin, api: api, confirm: confirm, toast: showToast, + table: table, pane: pane, admin: canEdit, api: api, confirm: confirm, toast: showToast, menu: showContextMenu, icon: menuIcon, zoom: uiZoom, }) : null; - if (!isAdmin) return; + // 회의록 삭제·회의 완료·완료 해제 — 관리자(잠긴 회의록에서도 쓸 수 있게 편집 도구보다 먼저 연결) + const del = el("pj-meet-del"); + if (del) del.addEventListener("click", async function () { + const ok = await confirm("이 주 회의록을 삭제할까요? 줄·금액·메모가 모두 삭제되고, 다음 주 회의록의 '지난주' 칸도 비게 됩니다.", + { okText: "삭제", cancelText: "취소" }); + if (!ok) return; + try { await api("DELETE", "/project/api/goals/meetings/" + week); location.reload(); } + catch (e) { showToast("삭제 실패: " + e.message, "error"); } + }); + [["pj-meet-complete", true], ["pj-meet-reopen", false]].forEach(function (pair) { + const btn = el(pair[0]); + if (!btn) return; + btn.addEventListener("click", async function () { + const done = pair[1]; + if (!(await confirm(done ? "회의를 완료할까요? 완료하면 이 회의록은 아무도 고칠 수 없습니다(관리자가 완료 해제 가능)." + : "완료를 해제할까요? 다시 누구나 고칠 수 있습니다.", { okText: done ? "회의 완료" : "완료 해제", cancelText: "취소" }))) return; + btn.disabled = true; + try { + if (done && canEdit) await flushAll(); // 쓰던 글을 먼저 저장(함수 선언 — 아래쪽 정의) + await api("POST", "/project/api/goals/meetings/" + week + "/complete", { done: done }); + reloadKeepScroll(); + } catch (e) { btn.disabled = false; showToast((done ? "회의 완료" : "완료 해제") + " 실패: " + e.message, "error"); } + }); + }); + if (!canEdit) return; function flashSaved(node) { if (!node) return; @@ -10816,14 +10842,6 @@ return true; }); }); - const del = el("pj-meet-del"); - if (del) del.addEventListener("click", async function () { - const ok = await confirm("이 주 회의록을 삭제할까요? 줄·금액·메모가 모두 삭제되고, 다음 주 회의록의 '지난주' 칸도 비게 됩니다.", - { okText: "삭제", cancelText: "취소" }); - if (!ok) return; - try { await api("DELETE", meetingUrl); location.reload(); } - catch (e) { showToast("삭제 실패: " + e.message, "error"); } - }); } // ── 휴지통(관리자 전용 화면) — [복구] 누르면 원래 id 그대로 되살리고 줄을 지운다. diff --git a/docs/DEPLOYMENT.md b/docs/DEPLOYMENT.md index 6080e0a..d1d97df 100644 --- a/docs/DEPLOYMENT.md +++ b/docs/DEPLOYMENT.md @@ -125,6 +125,17 @@ docker exec postgres-db psql -U postgres -d project_db -c "SELECT to_regclass('g 설정이 없거나 권한이 모자라면 버튼을 눌렀을 때 사유가 안내되고(503), 회의록 다른 기능은 그대로 동작한다. +## 주간 회의록 회의 완료 마이그레이션 (022) + +022는 `goal_meetings` 에 `completed_at`·`completed_by` 열만 추가한다(기존 값 그대로, 다시 실행 가능). 미적용이면 [회의 완료] 버튼이 나오지 않고 +회의록은 누구나 계속 고칠 수 있다. + +```bash +cd /opt/www/main +docker exec postgres-db pg_dump -U postgres project_db > ~/project_db_before_022_$(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_022_meeting_complete.sql +``` + ## 주간 회의록 정량 목표·결과 글 마이그레이션 (021) 021은 `goal_meeting_items` 에 `target_text`·`result_text` 열만 추가한다(기존 값 그대로, 다시 실행 가능). 미적용이면 정량 목표·결과는 예전처럼 숫자만 받는다. diff --git a/docs/PROJECT_MODULE.md b/docs/PROJECT_MODULE.md index 7759371..bb3fe43 100644 --- a/docs/PROJECT_MODULE.md +++ b/docs/PROJECT_MODULE.md @@ -372,6 +372,9 @@ docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db \ # 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 +# 022 = 회의 완료(goal_meetings.completed_at·completed_by) — 열 추가만(6-9-4) +docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db \ + < scripts/sql/project_db_022_meeting_complete.sql # 021 = 회의록 정량 목표·결과에 글(target_text·result_text, 예: 20개) — 열 추가만(6-9-4) docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db \ < scripts/sql/project_db_021_meeting_amount_text.sql @@ -895,6 +898,18 @@ description 을 항상 HTML로 취급하기 때문). 두 번 실행하면 이중 이름 `{월}월 {n}주차 ({기간})`(`router.meeting_board_title`), 첫 장의 제목·부제목 틀(TITLE 레이아웃)을 지우고 틀 없는 BLANK 한 장만. 파일 이름을 바꿔도 같은 보드, 휴지통에 버리면 다음에 새로 만든다. 인증은 Google 시트 설정 재사용 + Drive·Slides 범위 (`GOOGLE_SLIDES_OAUTH_REFRESH_TOKEN` 없으면 시트 토큰 — Drive·Slides 권한으로 재발급 필요, docs/DEPLOYMENT.md). DB 변경 없음. +- **회의록 누구나 수정 · 회의 완료 잠금**(마이그레이션 022, 2026-10-07): 회의록 만들기·머리 칸·줄 추가/삭제/이동·셀 이동/병합·줄 칸 API 가 + `_require_admin` → `_require_user`(프로젝트 권한자 누구나). 회의록 삭제와 `POST /api/goals/meetings/{주차}/complete {done}`(회의 완료·완료 해제)만 + 관리자. `goal_meetings.completed_at`·`completed_by` 가 있으면 잠금 — `db._check_meeting_open`(머리 칸·줄 추가·`_locked_meeting_items`)이 + `store.MeetingLocked` → 409. 예외: 줄 칸 변경이 결과(`result_note`·`result_amount`·`status`)뿐이면 그 줄의 회의록이 아니라 **바로 다음 주차 + 회의록**(그 결과를 적는 회의)의 잠금을 본다. 화면은 `data-edit`(완료 전이면 누구나) 로 편집 도구를 켜고, 관리자에게 [회의 완료]/[완료 해제], + 완료면 "🔒 회의 완료" 표시. 022 전이면 완료 버튼 없음(`meeting.can_complete`). +- **알림 팝업**(2026-10-07): 나를 태그(mention)하거나 작업을 배정(assigned)받으면 프로젝트 화면 가운데 아래에 깜박이는 큰 팝업(`initTaskAlerts`, + `.pj-alert-pop`, body 에 붙음) — [닫기] 전까지 남는다. 20초마다(창을 다시 볼 때 바로) `GET /api/notifications/alerts?after=본 것`(읽지 않은 + mention·assigned 중 after 보다 새 것, 지금 볼 수 있는 작업만, 오래된 것부터 10). 본 것 = localStorage `pj_alert_seen:{이메일}`, 처음 쓰는 브라우저는 + latest_id 를 기준으로 삼아 옛 알림을 한꺼번에 띄우지 않는다. 다른 탭에서 닫으면 storage 이벤트로 함께 닫힌다. 수신함 iframe 안에선 돌지 않는다. +- **섹션 색 없앰**(2026-10-07): 보드 섹션 머리는 모두 `#f3f3f3`(`STAGE_HEAD_BG`), 섹션 편집 창의 색 고르기 삭제(저장 때 color 를 보내지 않는다), + 타임라인 줄 색은 프로젝트 색. DB 의 `project_stages.color` 값은 남아 있지만 화면에서 쓰지 않는다. - **정량 목표·결과(금액)에 글**(마이그레이션 021, 2026-10-07): 입력이 숫자로 읽히면(`store.validate_meeting_amount` — 1,200,000 · 120만 · 1.5억) 지금처럼 `target_amount`/`result_amount`(원 정수), 아니면(예: "20개", 100자까지) `target_text`/`result_text` 에 — 둘 중 하나만 채운다(숫자로 바꾸면 글은 비움). 화면·전주 목표는 글이 있으면 글, 없으면 쉼표 숫자. 021 전이면 글은 예전처럼 400(숫자 오류). diff --git a/scripts/sql/project_db_022_meeting_complete.sql b/scripts/sql/project_db_022_meeting_complete.sql new file mode 100644 index 0000000..1d1394b --- /dev/null +++ b/scripts/sql/project_db_022_meeting_complete.sql @@ -0,0 +1,18 @@ +-- ===================================================================== +-- project_db 마이그레이션 022 — 주간 회의록 "회의 완료"(수정 잠금) +-- ===================================================================== +-- 멱등(idempotent). 열만 추가한다(기존 값 변경·삭제 없음). 운영: /opt/www/main 에서 기존 project_db 에 적용. +-- +-- 왜(2026-10-07 사용자 요청): 주간 회의록은 프로젝트 권한이 있는 누구나 고칠 수 있고, 관리자가 [회의 완료]를 누르면 +-- 그 회의록은 더 고칠 수 없다(관리자는 [완료 해제]로 다시 열 수 있다). +-- completed_at 이 있으면 완료. 지난주 결과(글·금액)는 다음 주 회의록이 열려 있는 동안만 고칠 수 있다. +-- ===================================================================== +BEGIN; + +ALTER TABLE goal_meetings ADD COLUMN IF NOT EXISTS completed_at TIMESTAMPTZ NULL; +ALTER TABLE goal_meetings ADD COLUMN IF NOT EXISTS completed_by TEXT NOT NULL DEFAULT ''; +COMMENT ON COLUMN goal_meetings.completed_at IS '회의 완료 시각 — 있으면 이 회의록은 수정 잠금(관리자만 완료·해제)'; +COMMENT ON COLUMN goal_meetings.completed_by IS '회의 완료를 누른 관리자 이메일'; + +COMMIT; +SELECT 'project_db 022 meeting complete ready' AS status; diff --git a/tests/js/goals_meeting_ui.test.js b/tests/js/goals_meeting_ui.test.js index 267a1df..57db2ad 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", "goals_weekly_admin", "meeting_admin", "meeting_err", "meeting_ro"].forEach(function (n) { +["goals_admin", "goals_ro", "goals_weekly_admin", "meeting_admin", "meeting_err", "meeting_ro", "meeting_member"].forEach(function (n) { PAGE[n] = fs.readFileSync(path.join(OUT, n + ".html"), "utf8"); }); const GOALS_URL = "http://localhost/project/goals/2026"; @@ -532,6 +532,31 @@ function meetServer(env, st) { check("[2g] 적용 전 줄 × → 줄만 지움", d.querySelectorAll("#pj-meet-quick tbody tr").length === n - 1 && env.calls.length === calls); }, { notifyOnFail: true }); + // ════════════════════ [2h] 회의록은 누구나 수정 · [회의 완료](관리자)면 잠금 ════════════════════ + await section(async function () { + const env = makeEnv(PAGE.meeting_member, MEET_URL); + const st = meetServer(env); + await boot(env); + const d = env.d; + check("[2h] 직원도 회의록 입력칸·메모 편집", !!d.querySelector(".pj-meet-text") && !!d.getElementById("pj-meet-notes")); + check("[2h] 직원에겐 삭제·회의 완료 버튼 없음", !d.getElementById("pj-meet-del") && !d.getElementById("pj-meet-complete")); + const ta = d.querySelector('tr[data-item="1"] .pj-meet-text'); + ta.focus(); type(env, ta, "직원이 적은 업무"); ta.blur(); await settle(); await wait(10); await settle(); + check("[2h] 직원 입력 저장", st.items[1] && st.items[1].content === "직원이 적은 업무", st.items[1]); + }); + await section(async function () { + const env = makeEnv(PAGE.meeting_admin, MEET_URL); + meetServer(env); + let posted = null; + env.route("POST", /\/project\/api\/goals\/meetings\/2026-09-28\/complete$/, function (u, body) { posted = body; return { body: { ok: true, completed: true } }; }); + env.w.erpConfirm = function () { return Promise.resolve(true); }; + await boot(env); + env.d.getElementById("pj-meet-complete").click(); await settle(); await wait(10); await settle(); + check("[2h] 관리자 [회의 완료] → 완료 요청·새로고침", posted && posted.done === true && env.navigations === 1, [posted, env.navigations]); + const ro = makeEnv(PAGE.meeting_ro, MEET_URL); meetServer(ro); await boot(ro); + check("[2h] 완료된 회의록 — 입력칸 없음·완료 표시", !ro.d.querySelector(".pj-meet-text, #pj-meet-notes") && /회의 완료/.test(ro.d.querySelector(".pj-meet-done-badge").textContent)); + }); + // ════════════════════ [3] 목표 표 — 글 저장 실패면 구조 변경·표 교체 중단 ════════════════════ await section(async function () { const env = makeEnv(PAGE.goals_admin, GOALS_URL, { promptAnswer: "새 영역" }); diff --git a/tests/js/render_goals.py b/tests/js/render_goals.py index 420f8ac..888f7cb 100644 --- a/tests/js/render_goals.py +++ b/tests/js/render_goals.py @@ -103,7 +103,7 @@ def meeting_view(err: bool) -> dict: def meeting_ctx(admin: bool, err: bool, can_sync: bool = True) -> dict: view = meeting_view(err) - return { + ctx = { "user": {"email": ME, "is_super_admin": False}, "is_admin": admin, "nav_projects": [], "goal_years": [2026], "goal_year_active": 2026, "my_open_total": 0, "mention_unread": 0, "color_palette": ["#4573d2"], "project_icons": ["folder"], "goal_year": 2026, "goal_month": 9, "meetings_enabled": True, @@ -114,6 +114,16 @@ def meeting_ctx(admin: bool, err: bool, can_sync: bool = True) -> dict: "can_sync": can_sync, "meeting_status": store.MEETING_STATUS, "meet_members": [], "month_plan": None, "attendee_list": [], **copy.deepcopy(view), } + # 회의록은 누구나 고친다(2026-10-07) — 보기 전용은 "회의 완료"된 회의록뿐. 관리자 아닌 화면 = 완료된 회의록으로 시험 + ctx["meeting"].update(can_complete=True, completed=not admin, completed_at="2026-10-02 18:00" if not admin else "", + completed_by="admin@test.local" if not admin else "") + return ctx + + +def member_ctx() -> dict: + ctx = meeting_ctx(False, False, can_sync=False) + ctx["meeting"].update(completed=False, completed_at="", completed_by="") + return ctx def meeting_layout_ctx(admin: bool) -> dict: @@ -156,6 +166,8 @@ def main() -> None: "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)), + # 관리자 아닌 직원 + 아직 완료 전 회의록 — 누구나 고친다(2026-10-07) + "meeting_member.html": ("project/goal_meeting.html", member_ctx()), "meeting_layout_admin.html": ("project/goal_meeting.html", meeting_layout_ctx(True)), "meeting_layout_ro.html": ("project/goal_meeting.html", meeting_layout_ctx(False)), "meeting_merged.html": ("project/goal_meeting.html", meeting_merged_ctx()), diff --git a/tests/test_project_meeting_cells.py b/tests/test_project_meeting_cells.py index 9d25df8..2085b80 100644 --- a/tests/test_project_meeting_cells.py +++ b/tests/test_project_meeting_cells.py @@ -196,9 +196,6 @@ class MeetingCellTests(unittest.TestCase): endpoints = [("POST", "/meeting-cells/move", self.payload), ("POST", "/meeting-cells/merge", dict(item_from=1, item_to=2)), ("DELETE", "/meeting-items/1/cell-merge", None)] - with patch.object(api, "_require_user", return_value=dict(role="user", email="user@test.local")): - for method, endpoint, body in endpoints: - self.assertEqual(client.request(method, "/project/api/goals" + endpoint, json=body).status_code, 403) with patch.object(api, "_require_user", return_value=dict(role="admin", email="admin@test.local")): url = "/project/api/goals/meeting-cells/move" self.assertEqual(client.post(url, json={}).status_code, 400) @@ -207,6 +204,10 @@ class MeetingCellTests(unittest.TestCase): self.st._meeting_cells = lambda conn: False self.assertEqual(client.post("/project/api/goals/meeting-cells/merge", json=dict(item_from=1, item_to=2)).status_code, 503) self.assertEqual(client.post(url, json=self.payload).status_code, 200, "Move/formatting work without 019") + # 회의록은 누구나 고친다(2026-10-07) — 관리자가 아니어도 셀 이동·병합·해제를 막지 않는다(잠금은 회의 완료로) + with patch.object(api, "_require_user", return_value=dict(role="user", email="user@test.local")): + for method, endpoint, body in endpoints: + self.assertNotEqual(client.request(method, "/project/api/goals" + endpoint, json=body).status_code, 403) def test_amount_cells_accept_text_after_021_and_result_note_reaches_store(self): """정량 목표·결과 — 숫자면 원 정수 칸, 글(예: 20개)이면 글 칸(021). 지난주 결과 글(result_note, 020)은 API 를 거쳐 저장된다.""" diff --git a/tests/test_project_meeting_lock.py b/tests/test_project_meeting_lock.py new file mode 100644 index 0000000..663703a --- /dev/null +++ b/tests/test_project_meeting_lock.py @@ -0,0 +1,79 @@ +"""주간 회의록 — 누구나 수정, 회의 완료(022)면 잠금. 지난주 결과는 다음 주 회의록이 열려 있는 동안만. DB 없이.""" +import importlib +import unittest +from contextlib import contextmanager +from datetime import date +from types import SimpleNamespace +from unittest.mock import patch + +from fastapi import FastAPI +from fastapi.testclient import TestClient + +from app.modules.project import store +from app.modules.project.db import ProjectStore +from tests.test_project_meeting_cells import Connection + +api = importlib.import_module("app.modules.project.router") + + +class LockConnection(Connection): + def __init__(self): + super().__init__() + self.completed = set() # 완료된 주차 시작일 + + def execute(self, sql, params=()): + if sql.startswith("SELECT completed_at FROM goal_meetings WHERE week_start = %s"): + from tests.test_project_meeting_cells import Result + return Result([{"completed_at": "done" if params[0] in self.completed else None}]) + return super().execute(sql, params) + + +class MeetingLockTests(unittest.TestCase): + def setUp(self): + self.conn = LockConnection() + + @contextmanager + def connection(): + yield self.conn + + self.st = ProjectStore.__new__(ProjectStore) + self.st._pool = SimpleNamespace(connection=connection) + self.st._table_exists = lambda conn, name: True + self.st._column_exists = lambda conn, table, col: col in {"content_row_span", "completed_at", "result_note"} + for r in self.conn.rows.values(): + r["result_note"] = "" + + def test_completed_meeting_rejects_edits(self): + self.conn.completed.add(date(2026, 9, 28)) + with self.assertRaises(store.MeetingLocked): + self.st.update_meeting_item(item_id=1, fields={"content": "x"}) + with self.assertRaises(store.MeetingLocked): + self.st.move_meeting_item(item_id=2, direction=1) + + def test_last_week_result_follows_next_meeting(self): + # 9/28 주차(9/28~9/30)가 완료돼도 다음 주차(10/1) 회의록이 열려 있으면 결과는 적을 수 있다 + self.conn.completed.add(date(2026, 9, 28)) + out = self.st.update_meeting_item(item_id=1, fields={"result_note": "잘 됨", "result_amount": "100"}) + self.assertEqual((out["result_note"], out["result_amount"]), ("잘 됨", 100)) + self.conn.completed.add(date(2026, 10, 1)) + with self.assertRaises(store.MeetingLocked): + self.st.update_meeting_item(item_id=1, fields={"result_note": "늦게"}) + + def test_anyone_edits_but_only_admin_completes(self): + app = FastAPI() + app.include_router(api.router) + app.state.project_store = self.st + client = TestClient(app) + member = dict(role="user", email="member@test.local") + with patch.object(api, "_require_user", return_value=member): + r = client.put("/project/api/goals/meeting-items/1", json={"content": "누구나"}) + self.assertEqual(r.status_code, 200, r.text) + self.assertEqual(client.post("/project/api/goals/meetings/2026-09-28/complete", json={"done": True}).status_code, 403) + self.conn.completed.add(date(2026, 9, 28)) + r = client.put("/project/api/goals/meeting-items/1", json={"content": "잠김"}) + self.assertEqual(r.status_code, 409, r.text) + self.assertIn("회의가 완료", r.json()["detail"]) + + +if __name__ == "__main__": + unittest.main() diff --git a/tests/test_project_module.py b/tests/test_project_module.py index a14fe34..9590f0f 100644 --- a/tests/test_project_module.py +++ b/tests/test_project_module.py @@ -747,7 +747,8 @@ def test_goal_meetings(): except KeyError: pass try: - assert req("POST", f"/project/api/goals/meetings/{w1}", BOB, json={"year": w1.year}).status_code == 403 + # 회의 완료(잠금)는 관리자만 — 회의록 만들기·고치기는 누구나(2026-10-07) + assert req("POST", f"/project/api/goals/meetings/{w1}/complete", BOB, json={"done": True}).status_code == 403 assert req("POST", f"/project/api/goals/meetings/{w1 + timedelta(days=1)}", ADMIN, json={}).status_code == 400 r = req("POST", f"/project/api/goals/meetings/{w1}", ADMIN, json={"year": w1.year}) assert r.status_code == 201 and r.json()["created"] is True, r.text @@ -771,7 +772,7 @@ def test_goal_meetings(): assert r.status_code == 400 assert put(coupang["id"], {"target_amount": "1,200만"}).json()["item"]["target_amount"] == 12_000_000 assert put(coupang["id"], {"status": "bogus"}).status_code == 400 - assert put(coupang["id"], {"content": "x"}, BOB).status_code == 403 + assert put(coupang["id"], {"content": "추석 타임딜"}, BOB).status_code == 200 # 누구나 수정 assert req("PUT", f"/project/api/goals/meetings/{w1}", ADMIN, json={"week_target": "3천만", "attendees": "대표", "notes": "메모"}).status_code == 200 # 다음 주 — 줄을 이어받고 전주 칸(prev)에 지난주 할 일·목표 @@ -781,6 +782,14 @@ def test_goal_meetings(): c2 = next(it for it in m2["items"] if it["carry_from"] == coupang["id"]) assert c2["prev"]["content"] == "추석 타임딜" and c2["prev"]["target_amount"] == 12_000_000 assert m2["prev_meeting"] == {"week_start": w1.isoformat(), "week_target": 30_000_000} + # 회의 완료(022) — w1 을 잠그면 w1 의 주요 업무는 못 고치지만, 지난주 결과는 다음 주(w2)가 열려 있으니 적을 수 있다 + r = req("POST", f"/project/api/goals/meetings/{w1}/complete", ADMIN, json={"done": True}) + if r.status_code == 200: + assert put(coupang["id"], {"content": "잠김"}, BOB).status_code == 409 + assert put(coupang["id"], {"result_amount": "100"}, BOB).status_code == 200 + assert req("POST", f"/project/api/goals/meetings/{w1}/complete", ADMIN, json={"done": False}).json()["completed"] is False + else: + assert r.status_code == 503, r.text # 022 미적용 # 지난주 결과·평가는 지난 회의록 줄에 저장 assert put(coupang["id"], {"result_amount": "1.5억", "status": "done"}).json()["item"]["result_amount"] == 150_000_000 # 줄 추가(기준 줄 아래)·이동(같은 구역 안)·삭제, 새 구역