diff --git a/CLAUDE.md b/CLAUDE.md
index 6438209..2601c23 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -36,7 +36,7 @@ Claude Code는 이 저장소에서 작업을 시작하기 전에 **반드시 아
- 말레이시아 창고 재고관리 (`app/modules/malaysia/`, `malaysia_stock_db`) — 낱개(MT/MX/MZ) 입출고·조정, 세트(MY) BOM, 일일 재고조사(세트→낱개 자동 분해), 현재고 현황. 뚜껑(MD-)은 재고 집계 제외 — 단, 창고 랙에는 위치 확인용으로 배치 가능(`store.LID_ITEMS`). 상품은 `itemcode_db` 읽기 전용. 권한키 `malaysia`
- 말레이시아 배송 (`app/modules/dispatch/`, `dispatch_db`) — TikTok·Shopee 출고관리. 플랫폼별 데이터 엑셀 업로드(TikTok=03_TikTok_Order_Export.xlsx, Shopee=Packing List.Doorstep Delivery.xlsx) → 1상자=1카드 출고 작업 리스트·SKU 피킹 요약·Kagayaku 전달표 자동 생성. 1상자 묶음 기준 Package ID > Tracking ID > Order ID, 같은 상자 같은 SKU 합산. 작업 상태 토글(`dispatch_logs` 기록). 받는 사람 이름/전화/주소는 상자 단위로 저장(작업 카드 표시 + 출고 엑셀 생성용 — 개인정보). 배치 다운로드 zip 에 업로드 원본 + 취합 출고 엑셀(`YYYY.MM.DD(Ddd)_tictoc|shopee.xlsx`) 포함. 엑셀은 openpyxl 파싱/생성. 권한키 `dispatch`. 상세는 `docs/DISPATCH_MODULE.md`
- 카페24 상품관리 (`app/modules/cafe24/`, `cafe24_db`) — 카페24 관리자에 들어가지 않고 상품 상세페이지(description HTML) 조회·편집·즉시적용·예약적용·버전 이력. 3분할 화면(목록 | HTML 편집기 | 상품 정보 패널). 정보 패널(`routes_product_info.py`, `_side.html`)에서 상품명·판매가·공급가·소비자가, 대표이미지(`POST /admin/products/{no}/images` 에 base64 data URI + `image_upload_type=A` — NNEditor 업로드 경로를 PUT `detail_image` 에 넣는 방식은 적용 안 됨), 옵션(생성/이름·썸네일·표시방식 수정/삭제)·품목(자체코드·추가금액·진열·판매)을 수정. 카페24 OAuth/API 클라이언트는 향후 주문관리와 공유하기 위해 **공통 계층 `app/integrations/cafe24/`** 에 둔다 — 라우터에서 `httpx`/`requests` 직접 호출 금지. 토큰은 Fernet 암호화 저장(`CAFE24_TOKEN_SECRET`), 로그/화면에 토큰·시크릿 절대 미출력. 쓰기 직전 항상 카페24 현재 HTML 을 다시 읽어 `BACKUP` revision 생성(로컬 값을 현재값으로 가정 금지). **카페24 관리자 API 는 PUT 뒤 한동안 GET 에서 예전 값을 돌려준다(읽기 지연)** — 우리 캐시 문제가 아니다. 그래서 "마지막 쓰기가 권위": 상세설명은 카페24 값이 최근 revision 중 하나와 같으면 지연으로 보고 마지막 MANUAL/SCHEDULED 를 표시·지문 기준으로 쓰고(`store.resolve_description`), 스칼라(상품명·가격·이미지·진열/판매)는 PUT 응답 스냅샷(`cafe24_products.last_write_snapshot`, 마이그레이션 004)과 GET 의 `updated_date` 를 비교해 덮어씌운다(`store.overlay_recent_write`). 유예시간 `CAFE24_READ_LAG_GRACE_MIN`(기본 360분). 쓰기 후 화면은 PUT 응답으로 그리고 다시 GET 하지 않는다. 예약은 DB 저장 + 별도 worker(`app/modules/cafe24/worker.py`, compose 서비스 `dbx-cafe24-worker`)가 처리 — 웹 프로세스에서 대기하지 않는다. 권한키 `cafe24`(연결/해제는 admin 전용). 상세는 `docs/CAFE24_MODULE.md`
-- 프로젝트 관리 (`app/modules/project/`, `project_db`) — 아사나식. 프로젝트/서브프로젝트(self-FK `parent_id`, CASCADE)·프로젝트 색상(32색 — 아사나 16색 + 진한 16색)·아이콘(`projects.icon`, Material Symbols 42종, 마이그레이션 011)·작업(`tasks`: 담당자·우선순위·시작/마감)·진행단계(`project_stages` 칸반, 생성시 기본 4단계 seed, 섹션 기본 담당자 `default_assignee_email` — 담당자 빈 작업을 그 섹션에 만들거나 옮기면 자동 배정, 마이그레이션 009)·멤버 배정(`project_members`)·활동이력(`project_activity`). 첫 화면(`/project/`)은 **내 작업 목록**(프로젝트 홈 카드 화면은 폐지). 프로젝트 화면은 캘린더(FullCalendar)/타임라인(vis-timeline)/보드/목록/대시보드 뷰 토글. 좌측 사이드바는 수신함·내 작업·휴지통·프로젝트 화면 공용(`templates/project/_side.html` + 프로젝트 목록 동작 `initSideTree`, 새 프로젝트/수정 모달 `_side_modals.html`) — 프로젝트 목록(순서 변경·✎·×)은 어느 화면에서나 같다. 보드는 아사나처럼 섹션이 가로로 계속 늘어나고(넘치면 가로 스크롤) 카드의 담당자·마감일을 클릭해 그 자리에서 바꾼다. 좌측 사이드바에 수신함·내 작업(접이식) 메뉴. 설명란은 주소 붙여넣기 시 자동 링크, 설명란·댓글에서 @로 멤버를 태그하면 (`task_mentions`, 마이그레이션 006) 수신함에 그 작업이 쌓인다. 진입 권한키 `project`(관리자 페이지 토글로 직원별 부여, admin 자동). 프로젝트 생성은 `project` 권한자 누구나(만든 사람이 owner), 삭제는 만든 사람만(슈퍼관리자 예외), 사용자 배정은 `is_admin` 만. 배정 멤버(또는 owner/admin)만 그 프로젝트를 조회(화면·API 모두, 비멤버 403)하고 서브프로젝트/작업/단계 CRUD — URL 의 섹션·부모 작업이 그 프로젝트 것인지 서버가 검증. 실시간 반영은 `project_live_version` 카운터(마이그레이션 007, 미적용 시 MAX 폴백). 사이드바 전체 검색(`/api/search`, 제목·설명·댓글, pg_trgm) + 프로젝트/내 작업 필터 바(찾기·상태·담당자·마감·우선순위·정렬, 클라이언트 필터). 협업자(`task_followers`, 자동 팔로우: 만든 사람·담당자·댓글·@태그) — 완료·댓글 알림은 담당자+협업자에게만. 작업 삭제는 휴지통(`project_trash`, 마이그레이션 010) — 삭제 직전 스냅샷 3개월 보관, 관리자만 보기·복구(`/project/trash`). 권한은 **지금 기준 공통 모듈 `access.py`**(목록·배지·알림·멘션·메일 수신자·삭제·댓글 수정까지 — 멤버에서 빠지면 기록이 있어도 안 보이고 알림도 없음), 소유자 변경은 관리자만, 연결(멀티호밍)된 작업은 연결된 프로젝트 멤버에게 읽기 전용(docs/PROJECT_MODULE.md 6-10). 연간 목표(마이그레이션 013, `goal_*` 테이블) — 사이드바 "목표" → 연도 펼침 → `/project/goals/{연도}` 에 매출(목표·실적·달성)·로아스 월별 숫자 + 업무 영역(상품·마케팅·컨텐츠·유통 등)별 연간·월별 글, 조회는 전원·입력은 `is_admin` 만. 3·6·9·12월 오른쪽 1~4분기 칸(글 칸 13=1분기·15=2분기·14=3분기·16=4분기 — 예전 반기 칸 번호 재사용, 15·16 은 마이그레이션 017) + 분기 월 칸 접기 애니메이션(localStorage `pj_goal_fold_q`, 표는 `width:1px`+`table-layout:fixed`), 영역·줄 이름 클릭 바로 수정, **엑셀식 칸 병합**(마우스로 끌어 사각형 선택 → 우클릭 셀 병합/병합 해제, 같은 영역 안 세로 `row_span` + 같은 분기 월 칸 가로, 글은 왼쪽 위 칸 — `goal_cell_merges`, 마이그레이션 014·015·017), 3열 줄 추가는 같은 항목 칸(2열) 안에(`goal_rows.label_cont`, 마이그레이션 016), 구조 변경은 새로고침 없이 제자리 다시 그리기(`refreshTable`)+애니메이션, 로아스는 % 표기. 월 머리 → **주간 회의록**(`/project/goals/{연도}/meetings/{월}`, 주=월~일 탭, 1주차 = 그 달 첫 월요일이 있는 주(월간 목표·누적은 1일~말일), `goal_meetings`·`goal_meeting_items` 마이그레이션 015 — 지난 회의록 줄 이어받기(carry_from)로 지난주 할 일·목표·결과·평가 리뷰, 위에 목표 표 그 달 열 글을 영역별 "N월 계획" 카드로, 숫자는 한 줄 막대 — 월 목표 대비 누적·주당 필요 매출, 유통 줄 쇼핑몰 연결 시 결과를 실적 모듈 `performance_store` 에서 읽기 전용 자동). 모든 열 너비 끌어서 조절(localStorage `pj_goal_col_w`), 세로 스크롤 틀 고정은 머리 줄+매출·로아스 줄까지, 항목 칸 +·우클릭으로 줄 위/아래 추가·삭제. 마감 알림(`reminders.py` 데몬 스레드, 영업일 09시, D-1/당일/지연, `task_reminders` 로 중복 방지, `PROJECT_REMINDER_*` env) — 마이그레이션 008. 라우터 핸들러는 동기 DB 라 `def` 로 둔다(`async def` 금지). 말풍선은 전부 아사나식 공용 말풍선(`.pj-hovertip`) — 새 기능도 `title=`/`data-tip=` 만 달고 별도 툴팁 구현 금지. 멤버 배정 후보는 `project` 권한 보유 등록 사용자에서 자동 목록(`GET /project/api/assignable-users`). 작업 배정·완료 시 관리자에게 메일(`app/mail.py` stdlib smtplib, `SMTP_*`+`PROJECT_NOTIFY_EMAIL` env, 미설정 시 조용히 skip, `BackgroundTasks` 비동기). 작업 창은 **저장 버튼 없이 실시간 저장**(칸별 PUT, `saveField`/`saveChain`, 새 작업은 제목이 생기는 순간 생성). 댓글 답글·이모티콘 반응(마이그레이션 012 `task_comments.parent_id`·`task_comment_reactions`, 미적용 시 버튼 숨김·API 503), 완료 이력 줄은 `project_activity` completed 를 댓글 사이에 표시(댓글 수 제외), 댓글 `@아이디` 는 아이콘+이름 칩. 수신함 "확인"은 페이지 이동 없이 오른쪽 iframe 패널(`/project/p/{pid}?task=&embed=1`, `html.pj-embed`). 상단 바 화면 배율 토글(`html.pj-ui-scale` → `.erp-app` zoom .75, 2880×1620·200%용) — **팝업은 반드시 `document.body` 에 붙인다**(배율 안의 fixed 좌표는 어긋남). 상세는 `docs/PROJECT_MODULE.md`
+- 프로젝트 관리 (`app/modules/project/`, `project_db`) — 아사나식. 프로젝트/서브프로젝트(self-FK `parent_id`, CASCADE)·프로젝트 색상(32색 — 아사나 16색 + 진한 16색)·아이콘(`projects.icon`, Material Symbols 42종, 마이그레이션 011)·작업(`tasks`: 담당자·우선순위·시작/마감)·진행단계(`project_stages` 칸반, 생성시 기본 4단계 seed, 섹션 기본 담당자 `default_assignee_email` — 담당자 빈 작업을 그 섹션에 만들거나 옮기면 자동 배정, 마이그레이션 009)·멤버 배정(`project_members`)·활동이력(`project_activity`). 첫 화면(`/project/`)은 **내 작업 목록**(프로젝트 홈 카드 화면은 폐지). 프로젝트 화면은 캘린더(FullCalendar)/타임라인(vis-timeline)/보드/목록/대시보드 뷰 토글. 좌측 사이드바는 수신함·내 작업·휴지통·프로젝트 화면 공용(`templates/project/_side.html` + 프로젝트 목록 동작 `initSideTree`, 새 프로젝트/수정 모달 `_side_modals.html`) — 프로젝트 목록(순서 변경·✎·×)은 어느 화면에서나 같다. 보드는 아사나처럼 섹션이 가로로 계속 늘어나고(넘치면 가로 스크롤) 카드의 담당자·마감일을 클릭해 그 자리에서 바꾼다. 좌측 사이드바에 수신함·내 작업(접이식) 메뉴. 설명란은 주소 붙여넣기 시 자동 링크, 설명란·댓글에서 @로 멤버를 태그하면 (`task_mentions`, 마이그레이션 006) 수신함에 그 작업이 쌓인다. 진입 권한키 `project`(관리자 페이지 토글로 직원별 부여, admin 자동). 프로젝트 생성은 `project` 권한자 누구나(만든 사람이 owner), 삭제는 만든 사람만(슈퍼관리자 예외), 사용자 배정은 `is_admin` 만. 배정 멤버(또는 owner/admin)만 그 프로젝트를 조회(화면·API 모두, 비멤버 403)하고 서브프로젝트/작업/단계 CRUD — URL 의 섹션·부모 작업이 그 프로젝트 것인지 서버가 검증. 실시간 반영은 `project_live_version` 카운터(마이그레이션 007, 미적용 시 MAX 폴백). 사이드바 전체 검색(`/api/search`, 제목·설명·댓글, pg_trgm) + 프로젝트/내 작업 필터 바(찾기·상태·담당자·마감·우선순위·정렬, 클라이언트 필터). 협업자(`task_followers`, 자동 팔로우: 만든 사람·담당자·댓글·@태그) — 완료·댓글 알림은 담당자+협업자에게만. 작업 삭제는 휴지통(`project_trash`, 마이그레이션 010) — 삭제 직전 스냅샷 3개월 보관, 관리자만 보기·복구(`/project/trash`). 권한은 **지금 기준 공통 모듈 `access.py`**(목록·배지·알림·멘션·메일 수신자·삭제·댓글 수정까지 — 멤버에서 빠지면 기록이 있어도 안 보이고 알림도 없음), 소유자 변경은 관리자만, 연결(멀티호밍)된 작업은 연결된 프로젝트 멤버에게 읽기 전용(docs/PROJECT_MODULE.md 6-10). 연간 목표(마이그레이션 013, `goal_*` 테이블) — 사이드바 "목표" → 연도 펼침 → `/project/goals/{연도}` 에 매출(목표·실적·달성)·로아스 월별 숫자 + 업무 영역(상품·마케팅·컨텐츠·유통 등)별 연간·월별 글, 조회는 전원·입력은 `is_admin` 만. 3·6·9·12월 오른쪽 1~4분기 칸(글 칸 13=1분기·15=2분기·14=3분기·16=4분기 — 예전 반기 칸 번호 재사용, 15·16 은 마이그레이션 017) + 분기 월 칸 접기 애니메이션(localStorage `pj_goal_fold_q`, 표는 `width:1px`+`table-layout:fixed`), 영역·줄 이름 클릭 바로 수정, **엑셀식 칸 병합**(마우스로 끌어 사각형 선택 → 우클릭 셀 병합/병합 해제, 같은 영역 안 세로 `row_span` + 같은 분기 월 칸 가로, 글은 왼쪽 위 칸 — `goal_cell_merges`, 마이그레이션 014·015·017), 3열 줄 추가는 같은 항목 칸(2열) 안에(`goal_rows.label_cont`, 마이그레이션 016), 구조 변경은 새로고침 없이 제자리 다시 그리기(`refreshTable`)+애니메이션, 로아스는 % 표기. 월 머리 → **주간 회의록**(`/project/goals/{연도}/meetings/{월}`, 주=월~일 탭, 1주차 = 그 달 첫 월요일이 있는 주(월간 목표·누적은 1일~말일), `goal_meetings`·`goal_meeting_items` 마이그레이션 015 — 지난주 = **정확히 7일 전 주** 회의록의 같은 연결키 줄(`line_key`, 마이그레이션 018 — 생성 순서·이름 변경과 무관, 이름 추정 연결 금지)로 지난주 할 일·목표·결과·평가 리뷰, 실적 조회 장애는 0원이 아니라 "미확인", 위에 목표 표 그 달 열 글을 영역별 "N월 계획" 카드로, 숫자는 한 줄 막대 — 월 목표 대비 누적·주당 필요 매출, 유통 줄 쇼핑몰 연결 시 결과를 실적 모듈 `performance_store` 에서 읽기 전용 자동). 모든 열 너비 끌어서 조절(localStorage `pj_goal_col_w`), 세로 스크롤 틀 고정은 머리 줄+매출·로아스 줄까지, 항목 칸 +·우클릭으로 줄 위/아래 추가·삭제. 마감 알림(`reminders.py` 데몬 스레드, 영업일 09시, D-1/당일/지연, `task_reminders` 로 중복 방지, `PROJECT_REMINDER_*` env) — 마이그레이션 008. 라우터 핸들러는 동기 DB 라 `def` 로 둔다(`async def` 금지). 말풍선은 전부 아사나식 공용 말풍선(`.pj-hovertip`) — 새 기능도 `title=`/`data-tip=` 만 달고 별도 툴팁 구현 금지. 멤버 배정 후보는 `project` 권한 보유 등록 사용자에서 자동 목록(`GET /project/api/assignable-users`). 작업 배정·완료 시 관리자에게 메일(`app/mail.py` stdlib smtplib, `SMTP_*`+`PROJECT_NOTIFY_EMAIL` env, 미설정 시 조용히 skip, `BackgroundTasks` 비동기). 목표 표·회의록 칸 저장은 공용 `createFieldSaver`(같은 칸 요청 직렬화·보낸 값만 저장됨·실패 시 초안 유지·localStorage 초안 백업, 저장 실패면 구조 변경 중단 — docs/PROJECT_MODULE.md 6-9-3), 구역·항목 메뉴는 우클릭 + ⋮ 버튼(키보드·터치). 작업 창은 **저장 버튼 없이 실시간 저장**(칸별 PUT, `saveField`/`saveChain`, 새 작업은 제목이 생기는 순간 생성). 댓글 답글·이모티콘 반응(마이그레이션 012 `task_comments.parent_id`·`task_comment_reactions`, 미적용 시 버튼 숨김·API 503), 완료 이력 줄은 `project_activity` completed 를 댓글 사이에 표시(댓글 수 제외), 댓글 `@아이디` 는 아이콘+이름 칩. 수신함 "확인"은 페이지 이동 없이 오른쪽 iframe 패널(`/project/p/{pid}?task=&embed=1`, `html.pj-embed`). 상단 바 화면 배율 토글(`html.pj-ui-scale` → `.erp-app` zoom .75, 2880×1620·200%용) — **팝업은 반드시 `document.body` 에 붙인다**(배율 안의 fixed 좌표는 어긋남). 상세는 `docs/PROJECT_MODULE.md`
- 실적 (`app/modules/performance/`, `performance_db`) — 쇼핑몰 통합 매출. 네 영역 분리: ① 수집 `adapters/`(쇼핑몰 하나 = 어댑터 파일 하나 + `registry.py` 한 줄 + SQL seed 한 줄) + `sync.py`(공통 동기화, 같은 쇼핑몰 동시 실행 차단, 쇼핑몰별 실패 격리) ② 보안 `security/`(AES-256-GCM, 키 버전, 비밀값 가리기) + `credentials.py` ③ 계산 `calc.py`(주=월~일, 수수료 반올림은 `commission()` 한 곳, 요율 이력) + `db.py` ④ 화면 `dashboard.py`/`router.py`/템플릿. 쇼핑몰 API 인증정보는 `.env` 가 아니라 **설정 화면에서 입력 → 마스터 키 `APP_ENCRYPTION_KEY` 로 암호화해 DB 저장**, secret 원문은 화면으로 다시 보내지 않는다. 쇼핑몰 API 는 백엔드에서만 호출, 오류·로그·raw 는 `redact` 후 저장. 매출 기준일: 결제=결제일, 취소·반품=발생일(`sync.sales_date_for`). 금액은 원 단위 정수. 권한키 `performance`, 설정 화면은 모듈 권한자 누구나(일반 사용자는 수수료율만), 수수료 외 설정 API 는 `is_admin`. 매출 업데이트 진행 창에서 쇼핑몰별 [중지](그 쇼핑몰만 멈추고 다음 쇼핑몰로). 카페24 어댑터는 기존 `app/integrations/cafe24` 토큰 재사용. 1단계는 모의 데이터(`is_sample`)·구조까지, 실제 수집은 쇼핑몰별로 공식 문서 확인 후 순차 구현. 상세는 `docs/PERFORMANCE_MODULE.md`
diff --git a/app/modules/project/db.py b/app/modules/project/db.py
index adc565c..a44d159 100644
--- a/app/modules/project/db.py
+++ b/app/modules/project/db.py
@@ -15,7 +15,8 @@ from __future__ import annotations
import logging
import re
import time
-from datetime import date, datetime
+import uuid
+from datetime import date, datetime, timedelta
from datetime import time as dtime
from typing import Any
@@ -2446,6 +2447,19 @@ class ProjectStore:
if not self._table_exists(conn, "goal_meetings"):
raise store.GoalMigration015Needed()
+ def _meeting_keys(self, conn: Any) -> bool:
+ """마이그레이션 018 — goal_meeting_items.line_key(주가 바뀌어도 같은 줄을 가리키는 연결키) 적용 여부.
+ 적용되면 한 번만 확인한다(되돌리는 마이그레이션은 없다)."""
+ if getattr(self, "_meeting_keys_ok", False):
+ return True
+ ok = self._column_exists(conn, "goal_meeting_items", "line_key")
+ if ok:
+ self._meeting_keys_ok = True
+ return ok
+
+ def _meeting_cols(self, conn: Any) -> str:
+ return self._MEETING_ITEM_COLS + (", line_key" if self._meeting_keys(conn) else "")
+
@staticmethod
def _meeting_item(r: dict[str, Any]) -> dict[str, Any]:
out = dict(r)
@@ -2453,6 +2467,8 @@ class ProjectStore:
out["week_start"] = out["week_start"].isoformat()
for k in ("target_amount", "result_amount", "carry_from"):
out[k] = int(out[k]) if out.get(k) is not None else None
+ if out.get("line_key") is not None:
+ out["line_key"] = str(out["line_key"])
return out
def meeting_weeks(self, *, start: date, end: date) -> list[str]:
@@ -2467,32 +2483,44 @@ class ProjectStore:
return [r["week_start"].isoformat() for r in rows]
def get_meeting(self, *, week_start: date) -> dict[str, Any] | None:
- """한 주 회의록 — 머리(금주 목표·참석자·메모) + 줄(전주 줄 prev 포함). 없으면 None.
- prev_meeting = 이 회의록보다 앞선 가장 가까운 회의록의 머리(전주 목표)."""
+ """한 주 회의록 — 머리(금주 목표·참석자·메모) + 줄(지난주 줄 prev 포함). 없으면 None.
+
+ "지난주"는 **정확히 7일 전 주(week_start − 7)** 만이다(몇 주 전 회의록을 지난주로 보이지 않게).
+ · prev_meeting = 그 주 회의록 머리(전주 목표), 그 주 회의록이 없으면 None.
+ · 줄의 prev = 그 주 회의록에서 **같은 연결키(line_key, 마이그레이션 018)** 의 줄 — 생성 순서·이름 변경·
+ 순서 이동과 무관하다. 018 미적용이면 예전 carry_from 을 쓰되 가리키는 줄이 정확히 7일 전 주일 때만.
+ """
with self._pool.connection() as conn:
self._require_meetings(conn)
+ cols = self._meeting_cols(conn)
+ keyed = self._meeting_keys(conn)
head = conn.execute(
"SELECT week_start, week_target, attendees, notes, updated_by, updated_at "
"FROM goal_meetings WHERE week_start = %s", (week_start,),
).fetchone()
if head is None:
return None
+ prev_week = week_start - timedelta(days=7)
items = conn.execute(
- f"SELECT {self._MEETING_ITEM_COLS} FROM goal_meeting_items WHERE week_start = %s "
+ f"SELECT {cols} FROM goal_meeting_items WHERE week_start = %s "
"ORDER BY sort_order, id", (week_start,),
).fetchall()
- prev_ids = [int(r["carry_from"]) for r in items if r["carry_from"] is not None]
- prevs = {int(r["id"]): self._meeting_item(r) for r in conn.execute(
- f"SELECT {self._MEETING_ITEM_COLS} FROM goal_meeting_items WHERE id = ANY(%s)", (prev_ids,),
- ).fetchall()} if prev_ids else {}
prev_head = conn.execute(
- "SELECT week_start, week_target FROM goal_meetings WHERE week_start < %s "
- "ORDER BY week_start DESC LIMIT 1", (week_start,),
+ "SELECT week_start, week_target FROM goal_meetings WHERE week_start = %s", (prev_week,),
).fetchone()
+ prev_rows = conn.execute(
+ f"SELECT {cols} FROM goal_meeting_items WHERE week_start = %s", (prev_week,),
+ ).fetchall() if prev_head else []
+ by_key = {str(r["line_key"]): r for r in prev_rows if r.get("line_key") is not None} if keyed else {}
+ by_id = {int(r["id"]): r for r in prev_rows}
out_items = []
for r in items:
it = self._meeting_item(r)
- it["prev"] = prevs.get(it["carry_from"]) if it["carry_from"] is not None else None
+ if keyed:
+ p = by_key.get(it.get("line_key") or "")
+ else:
+ p = by_id.get(it["carry_from"]) if it["carry_from"] is not None else None
+ it["prev"] = self._meeting_item(p) if p is not None else None
out_items.append(it)
return {
"week_start": head["week_start"].isoformat(),
@@ -2503,17 +2531,22 @@ class ProjectStore:
"prev_meeting": {"week_start": prev_head["week_start"].isoformat(),
"week_target": int(prev_head["week_target"]) if prev_head["week_target"] is not None
else None} if prev_head else None,
+ "line_keys": keyed,
}
def create_meeting(self, *, week_start: date, sections: list[tuple[str, str]], created_by: str = "") -> bool:
- """회의록 만들기 — 이미 있으면 False. 앞선 가장 가까운 회의록이 있으면 그 줄(구역·이름·쇼핑몰 연결·순서)을
- 글 없이 이어받고(carry_from = 그 줄 → 이번 회의에서 지난주 할 일·목표·결과를 나란히 리뷰), 없으면 sections
- (목표 표 업무 영역 이름·색)마다 기본 양식 줄(store.MEETING_TEMPLATE)로 시작한다."""
+ """회의록 만들기 — 이미 있으면 False. 줄(구역·이름·색·쇼핑몰 연결·순서)을 글 없이 이어받을 원본:
+ ① 앞선 가장 가까운 회의록(평소 순서), ② 앞선 회의록이 없으면 뒤에 있는 가장 가까운 회의록
+ (다음 주를 먼저 만들고 앞 주를 나중에 만든 경우 — 다음 주 줄이 이 주 줄을 "지난주"로 찾게),
+ ③ 둘 다 없으면 sections(목표 표 업무 영역 이름·색)마다 기본 양식 줄(store.MEETING_TEMPLATE).
+ 이어받은 줄은 원본 줄의 연결키(line_key, 018)를 그대로 갖는다 → 생성 순서와 무관하게 7일 전 주의 같은 키 줄이
+ "지난주"가 된다. 새 줄(양식·줄 추가)은 새 키. carry_from 은 앞선 원본 줄일 때만 기록(이력, 화면 연결에는 안 씀)."""
ws = store.validate_week_start(week_start)
who = store.norm_str(created_by, lower=True)
with self._pool.connection() as conn:
with conn.transaction():
self._require_meetings(conn)
+ keyed = self._meeting_keys(conn)
ins = conn.execute(
"INSERT INTO goal_meetings (week_start, created_by, updated_by) VALUES (%s, %s, %s) "
"ON CONFLICT (week_start) DO NOTHING RETURNING week_start",
@@ -2521,30 +2554,59 @@ class ProjectStore:
).fetchone()
if ins is None:
return False
- prev = conn.execute(
- "SELECT week_start FROM goal_meetings WHERE week_start < %s ORDER BY week_start DESC LIMIT 1",
- (ws,),
- ).fetchone()
- prev_items = conn.execute(
- "SELECT id, section, section_color, label, marketplace_code, sort_order FROM goal_meeting_items "
- "WHERE week_start = %s ORDER BY sort_order, id", (prev["week_start"],),
- ).fetchall() if prev else []
- if prev_items:
- for n, r in enumerate(prev_items):
- conn.execute(
- "INSERT INTO goal_meeting_items (week_start, section, section_color, label, "
- "marketplace_code, carry_from, sort_order, updated_by) VALUES (%s,%s,%s,%s,%s,%s,%s,%s)",
- (ws, r["section"], r["section_color"], r["label"], r["marketplace_code"], r["id"], n, who),
- )
+ src_cols = "id, section, section_color, label, marketplace_code, sort_order" + (", line_key" if keyed else "")
+ src_items: list[dict[str, Any]] = []
+ src_is_prev = True
+ for cmp_, order, is_prev in (("<", "DESC", True), (">", "ASC", False)):
+ # 줄이 하나라도 있는 가장 가까운 회의록(빈 회의록은 건너뜀)
+ src = conn.execute(
+ f"SELECT m.week_start FROM goal_meetings m WHERE m.week_start {cmp_} %s "
+ "AND EXISTS (SELECT 1 FROM goal_meeting_items i WHERE i.week_start = m.week_start) "
+ f"ORDER BY m.week_start {order} LIMIT 1",
+ (ws,),
+ ).fetchone()
+ if src:
+ src_items = conn.execute(
+ f"SELECT {src_cols} FROM goal_meeting_items WHERE week_start = %s ORDER BY sort_order, id",
+ (src["week_start"],),
+ ).fetchall()
+ src_is_prev = is_prev
+ break
+ if src_items:
+ for n, r in enumerate(src_items):
+ key = str(r["line_key"]) if keyed and r.get("line_key") is not None else str(uuid.uuid4())
+ carry = r["id"] if src_is_prev else None
+ if keyed:
+ conn.execute(
+ "INSERT INTO goal_meeting_items (week_start, section, section_color, label, "
+ "marketplace_code, carry_from, sort_order, updated_by, line_key) "
+ "VALUES (%s,%s,%s,%s,%s,%s,%s,%s,%s)",
+ (ws, r["section"], r["section_color"], r["label"], r["marketplace_code"], carry, n,
+ who, key),
+ )
+ else:
+ conn.execute(
+ "INSERT INTO goal_meeting_items (week_start, section, section_color, label, "
+ "marketplace_code, carry_from, sort_order, updated_by) VALUES (%s,%s,%s,%s,%s,%s,%s,%s)",
+ (ws, r["section"], r["section_color"], r["label"], r["marketplace_code"], carry, n, who),
+ )
else:
n = 0
for name, color in sections or [(k, "") for k in store.MEETING_TEMPLATE]:
for label in store.MEETING_TEMPLATE.get(name, ("",)):
- conn.execute(
- "INSERT INTO goal_meeting_items (week_start, section, section_color, label, "
- "marketplace_code, sort_order, updated_by) VALUES (%s,%s,%s,%s,%s,%s,%s)",
- (ws, name, color, label, store.guess_meeting_market(name, label), n, who),
- )
+ if keyed:
+ conn.execute(
+ "INSERT INTO goal_meeting_items (week_start, section, section_color, label, "
+ "marketplace_code, sort_order, updated_by, line_key) VALUES (%s,%s,%s,%s,%s,%s,%s,%s)",
+ (ws, name, color, label, store.guess_meeting_market(name, label), n, who,
+ str(uuid.uuid4())),
+ )
+ else:
+ conn.execute(
+ "INSERT INTO goal_meeting_items (week_start, section, section_color, label, "
+ "marketplace_code, sort_order, updated_by) VALUES (%s,%s,%s,%s,%s,%s,%s)",
+ (ws, name, color, label, store.guess_meeting_market(name, label), n, who),
+ )
n += 1
return True
@@ -2617,11 +2679,14 @@ class ProjectStore:
else:
same = [n for n, r in enumerate(rows) if r["section"] == sec]
i = same[-1] + 1 if same else len(ids)
+ # 새 줄 = 새 연결키(018) — 이름이 같은 다른 줄과 섞이지 않는다
+ keyed = self._meeting_keys(conn)
new_id = int(conn.execute(
"INSERT INTO goal_meeting_items (week_start, section, section_color, label, marketplace_code, "
- "sort_order, updated_by) VALUES (%s,%s,%s,%s,%s,0,%s) RETURNING id",
+ "sort_order, updated_by" + (", line_key" if keyed else "") + ") VALUES (%s,%s,%s,%s,%s,0,%s"
+ + (",%s" if keyed else "") + ") RETURNING id",
(week_start, sec, color, lb, store.guess_meeting_market(sec, lb),
- store.norm_str(updated_by, lower=True)),
+ store.norm_str(updated_by, lower=True), *((str(uuid.uuid4()),) if keyed else ())),
).fetchone()["id"])
ids.insert(i, new_id)
for n, x in enumerate(ids):
diff --git a/app/modules/project/router.py b/app/modules/project/router.py
index 9b037ce..76eb1e4 100644
--- a/app/modules/project/router.py
+++ b/app/modules/project/router.py
@@ -2838,78 +2838,157 @@ def _perf_sales(request: Request) -> Any:
return getattr(request.app.state, "performance_store", None)
-def _perf_markets(perf: Any) -> list[dict[str, Any]]:
- if perf is None:
- return []
- try:
- return [m for m in perf.list_marketplaces() if m.get("enabled")]
- except Exception: # noqa: BLE001 — 실적 DB 장애가 회의록을 막지 않게
- logger.warning("performance marketplaces unavailable for meeting", exc_info=True)
- return []
+class _MeetingPerf:
+ """회의록이 읽는 실적(읽기 전용) — 값과 상태를 따로 둔다. 조회 장애를 0 원으로 바꾸지 않는다.
+
+ state: ``off``(실적 모듈 미연결) · ``error``(쇼핑몰 목록 조회 실패) · ``empty``(매출 집계 쇼핑몰 없음) · ``ok``.
+ ``sum``/``total`` 은 알 수 없으면 None(목록 장애·매출 조회 실패), 정상 조회 결과 0 건이면 0.
+ 매출 조회가 실패할 때마다 ``failures`` 가 늘어난다(부분 실패 — 머리 숫자마다 따로 미확인)."""
+
+ def __init__(self, perf: Any) -> None:
+ self.perf = perf
+ self.markets: list[dict[str, Any]] = []
+ self.failures = 0
+ if perf is None:
+ self.state = "off"
+ else:
+ try:
+ self.markets = [m for m in perf.list_marketplaces() if m.get("enabled")]
+ self.state = "ok"
+ except Exception: # noqa: BLE001 — 실적 DB 장애가 회의록을 막지 않게
+ logger.warning("performance marketplaces unavailable for meeting", exc_info=True)
+ self.state = "error"
+ self.names = {m["code"]: m["name"] for m in self.markets}
+ self.sales_codes = [m["code"] for m in self.markets if m.get("include_in_sales")]
+ if self.state == "ok" and not self.sales_codes:
+ self.state = "empty"
+
+ @property
+ def readable(self) -> bool:
+ """쇼핑몰 목록을 읽었는가(ok·empty) — 연결 쇼핑몰이 "사용 중이 아님"을 판단할 수 있는가."""
+ return self.state in ("ok", "empty")
+
+ def sum(self, start: date, end: date, codes: list[str]) -> dict[str, int] | None:
+ """기간 쇼핑몰별 매출 합(원, 취소·반품 차감 = 대시보드 총매출과 같은 값). 알 수 없으면 None."""
+ if not self.readable:
+ return None
+ if not codes or end < start:
+ return {}
+ try:
+ out: dict[str, int] = {}
+ for (_, code), amount in self.perf.daily_amounts(start, end, codes).items():
+ out[code] = out.get(code, 0) + int(amount)
+ return out
+ except Exception: # noqa: BLE001
+ self.failures += 1
+ logger.warning("performance sales unavailable for meeting", exc_info=True)
+ return None
+
+ def total(self, start: date, end: date) -> int | None:
+ """매출 집계 쇼핑몰 합계. 매출 집계 쇼핑몰이 없으면(empty) None — 0 원으로 보이지 않게."""
+ if self.state != "ok":
+ return None
+ r = self.sum(start, end, self.sales_codes)
+ return None if r is None else sum(r.values())
+
+ def freshness(self) -> dict[str, Any] | None:
+ """매출 집계 쇼핑몰별 마지막 갱신 성공 시각(실적 모듈 perf_connection_status — 서버가 기록한 값만).
+ oldest = 가장 오래된 쇼핑몰 기준(자료가 적어도 이 시각까지는 갱신됨), never = 한 번도 성공 못 한 쇼핑몰."""
+ if self.state != "ok" or not hasattr(self.perf, "statuses"):
+ return None
+ try:
+ stats = self.perf.statuses() or {}
+ except Exception: # noqa: BLE001
+ logger.warning("performance statuses unavailable for meeting", exc_info=True)
+ return None
+ shops, never = [], []
+ for code in self.sales_codes:
+ t = (stats.get(code) or {}).get("last_success_sync_at")
+ if t:
+ shops.append({"name": self.names.get(code, code), "at": str(t)})
+ else:
+ never.append(self.names.get(code, code))
+ oldest = min((s["at"] for s in shops), default="")
+ return {"shops": shops, "never": never, "oldest": oldest}
-def _perf_sum(perf: Any, start: date, end: date, codes: list[str]) -> dict[str, int] | None:
- """기간 쇼핑몰별 매출 합(원, 취소·반품 차감 = 대시보드 총매출과 같은 값). 실적 모듈이 없으면 None."""
- if perf is None or not codes or end < start:
- return {} if perf is not None else None
+def _kst_short(iso: str) -> str:
+ """'2026-10-01T14:20:00+09:00' → '10/01 14:20'(서버가 준 시각을 한국시간으로)."""
+ if not iso:
+ return ""
try:
- out: dict[str, int] = {}
- for (_, code), amount in perf.daily_amounts(start, end, codes).items():
- out[code] = out.get(code, 0) + int(amount)
- return out
- except Exception: # noqa: BLE001
- logger.warning("performance sales unavailable for meeting", exc_info=True)
- return None
+ from datetime import datetime # noqa: WPS433
+
+ d = datetime.fromisoformat(str(iso))
+ if d.tzinfo is not None:
+ d = d.astimezone(KST)
+ return d.strftime("%m/%d %H:%M")
+ except ValueError:
+ return str(iso)[:16]
def _meeting_view(request: Request, st: Any, *, year: int, month: int, week: date) -> dict[str, Any]:
- """회의록 화면 데이터 — 머리(월 목표·누적·남은 주 필요 매출·전주/금주 목표·결과) + 줄(전주 리뷰 포함)."""
+ """회의록 화면 데이터 — 머리(월 목표·누적·남은 주 필요 매출·전주/금주 목표·결과) + 줄(지난주 리뷰 포함).
+
+ "지난주"는 정확히 7일 전 주(prev_week)만 — 머리 전주 목표·전주 결과·줄의 지난주 칸·결과·달성률이 같은 주다
+ (db.get_meeting 이 7일 전 주 회의록에서 같은 연결키 줄만 prev 로 준다). 실적은 _MeetingPerf — 알 수 없는 값은
+ None + head.unknown 에 이름(0 원·0% 로 보이지 않게, 그 값에 기대는 달성률·필요 매출도 계산하지 않는다)."""
today = today_kst()
meeting = st.get_meeting(week_start=week)
targets = st.goal_month_targets(year=year, month=month)
mult = store.sales_unit_multiplier(targets["sales_unit"])
- perf = _perf_sales(request)
- markets = _perf_markets(perf)
- names = {m["code"]: m["name"] for m in markets}
- sales_codes = [m["code"] for m in markets if m.get("include_in_sales")]
+ perf = _MeetingPerf(_perf_sales(request))
+ names = perf.names
week_end = week + timedelta(days=6)
prev_start, prev_end = week - timedelta(days=7), week - timedelta(days=1)
first = date(year, month, 1)
last = date(year + (month == 12), month % 12 + 1, 1) - timedelta(days=1)
+ unknown: list[str] = []
- def total(a: date, b: date) -> int | None:
- r = _perf_sum(perf, a, min(b, today), sales_codes)
- return None if r is None else sum(r.values())
+ def total(key: str, a: date, b: date) -> int | None:
+ v = perf.total(a, min(b, today))
+ if v is None and perf.state in ("error", "ok"):
+ unknown.append(key) # 목록 장애(error) 또는 이 기간 매출 조회 실패(ok 인데 None)
+ return v
# 월 누적 = 이 주 앞까지(지난주 일요일까지) — 남은 목표를 이번 주 포함 남은 주로 나눠 "주당 필요 매출"
mtd_end = min(last, today, prev_end)
month_target_won = int(round(targets["sales_target"] * mult)) if targets["sales_target"] is not None and mult else None
- mtd = total(first, mtd_end) if mtd_end >= first else 0
+ mtd = total("mtd", first, mtd_end) if mtd_end >= first else 0 # 1주차 앞에는 지난 날이 없다(정말 0)
weeks_left = sum(1 for mon, _ in store.month_weeks(year, month) if mon >= week)
- pm = meeting.get("prev_meeting") if meeting else None # 바로 앞 주 회의록이어야 "전주 목표"
+ pm = meeting.get("prev_meeting") if meeting else None # 정확히 7일 전 주 회의록이어야 "전주 목표"
need = None
if month_target_won is not None and mtd is not None and weeks_left:
need = max(0, month_target_won - mtd) // weeks_left
+ fresh = perf.freshness()
head = {
"sales_unit": targets["sales_unit"], "sales_target": targets["sales_target"],
"roas_target": targets["roas_target"], "month_target_won": month_target_won,
"mtd": mtd, "mtd_end": mtd_end.isoformat() if mtd_end >= first else "", "weeks_left": weeks_left,
"need_per_week": need,
"prev_target": pm["week_target"] if pm and pm["week_start"] == prev_start.isoformat() else None,
- "prev_result": total(prev_start, prev_end) if prev_start <= today else None,
- "week_result": total(week, week_end) if week <= today else None,
- "perf": perf is not None,
+ "prev_exists": bool(pm and pm["week_start"] == prev_start.isoformat()),
+ "prev_result": total("prev_result", prev_start, prev_end) if prev_start <= today else None,
+ "week_result": total("week_result", week, week_end) if week <= today else None,
+ # perf = 실적 모듈 연결 여부(예전 뜻 그대로 — 갱신 상자·안내 문구 조건), 조회 성공 여부는 perf_state·unknown
+ "perf": perf.state != "off",
+ "perf_state": perf.state,
+ "unknown": unknown,
+ "fresh_oldest": _kst_short(fresh["oldest"]) if fresh else "",
+ "fresh_tip": ("매출 자료(실적 모듈) 쇼핑몰별 마지막 갱신 성공 — " +
+ " · ".join(f"{s['name']} {_kst_short(s['at'])}" for s in fresh["shops"]) +
+ (f" · 갱신 성공 기록 없음: {', '.join(fresh['never'])}" if fresh["never"] else "")) if fresh else "",
}
if meeting:
- # 줄마다 전주 결과 — 쇼핑몰 연결이면 그 주 실적(자동), 아니면 직접 입력한 결과
- all_codes = [m["code"] for m in markets]
+ # 줄마다 지난주 결과 — 쇼핑몰 연결이면 그 주 실적(자동), 아니면 직접 입력한 결과(지난주 줄에 저장)
+ all_codes = [m["code"] for m in perf.markets]
by_week: dict[str, dict[str, int] | None] = {}
def week_sales(ws: str) -> dict[str, int] | None:
- """그 주(월~일, 오늘까지) 쇼핑몰별 실적 — 아직 시작 안 한 주는 None."""
+ """그 주(월~일, 오늘까지) 쇼핑몰별 실적 — 조회 실패면 None(시작 전 주는 부르지 않는다)."""
if ws not in by_week:
a = date.fromisoformat(ws)
- by_week[ws] = _perf_sum(perf, a, min(a + timedelta(days=6), today), all_codes) if a <= today else None
+ by_week[ws] = perf.sum(a, min(a + timedelta(days=6), today), all_codes)
return by_week[ws]
for it in meeting["items"]:
@@ -2921,21 +3000,32 @@ def _meeting_view(request: Request, st: Any, *, year: int, month: int, week: dat
a = date.fromisoformat(prev["week_start"])
prev["period"] = f"{a.month}/{a.day}~{(a + timedelta(days=6)).month}/{(a + timedelta(days=6)).day}"
prev["not_started"] = bool(code) and a > today
+ # 쇼핑몰 목록을 못 읽었으면 연결 쇼핑몰이 사용 중인지 알 수 없다 → 결과 미확인(직접 입력 칸·0 으로 바꾸지 않음)
+ prev["auto_error"] = bool(code) and not prev["not_started"] and perf.state == "error"
# 실적 모듈에서 사용 중이 아닌 쇼핑몰(설정에서 사용 OFF·없는 코드)은 늘 0 이라 자동으로 보지 않고 직접 입력
- prev["market_off"] = bool(code) and code not in names
- if code and perf is not None and not prev["not_started"] and not prev["market_off"]:
+ prev["market_off"] = bool(code) and perf.state != "error" and code not in names
+ if code and perf.readable and not prev["not_started"] and not prev["market_off"]:
got = week_sales(prev["week_start"])
- auto = None if got is None else got.get(code, 0)
+ if got is None:
+ prev["auto_error"] = True
+ else:
+ auto = got.get(code, 0)
prev["auto_result"] = auto
- prev["result"] = auto if auto is not None else prev.get("result_amount")
+ prev["result"] = auto if auto is not None else (None if prev["auto_error"] else prev.get("result_amount"))
prev["market_name"] = names.get(code, code)
for it in meeting["items"]:
code = it["marketplace_code"]
it["market_name"] = names.get(code, code) if code else ""
- it["market_off"] = bool(code) and code not in names
- # 이번 주 진행 중 실적(쇼핑몰 연결 줄) — 목표 금액 칸 아래에 "이번주 실적"
- got = week_sales(meeting["week_start"]) if code and perf is not None and not it["market_off"] else None
- it["week_auto"] = None if got is None else got.get(code, 0)
+ it["market_off"] = bool(code) and perf.state != "error" and code not in names
+ it["market_unknown"] = bool(code) and perf.state == "error"
+ # 이번 주 진행 중 실적(쇼핑몰 연결 줄) — 정량 목표 칸 아래에 "이번주 실적"
+ it["week_auto"], it["week_error"] = None, False
+ if code and week <= today and not it["market_off"]:
+ got = week_sales(meeting["week_start"]) if perf.readable else None
+ if got is None:
+ it["week_error"] = perf.state != "off"
+ else:
+ it["week_auto"] = got.get(code, 0)
p = it.get("prev")
it["rate"] = (round(p["result"] / p["target_amount"] * 100, 1)
if p and p.get("result") is not None and p.get("target_amount") else None)
@@ -2948,7 +3038,8 @@ def _meeting_view(request: Request, st: Any, *, year: int, month: int, week: dat
meeting["sections"] = sections
prev_items = [it["prev"] for it in meeting["items"] if it.get("prev")]
head["prev_items_target"] = sum(p["target_amount"] or 0 for p in prev_items) if prev_items else None
- return {"meeting": meeting, "head": head, "markets": [{"code": m["code"], "name": m["name"]} for m in markets]}
+ return {"meeting": meeting, "head": head,
+ "markets": [{"code": m["code"], "name": m["name"]} for m in perf.markets]}
def _month_plan(st: Any, year: int, month: int) -> list[dict[str, Any]] | None:
@@ -3014,7 +3105,7 @@ def _parse_attendees(text: str, members: list[dict[str, str]]) -> list[dict[str,
def goal_meeting_page(request: Request, year: int, month: int, week: str | None = None) -> HTMLResponse:
"""주간 회의록 — 그 달과 겹치는 주(월~일) 탭, 주마다 회의록 하나. 입력은 관리자만(목표 표와 같음)."""
from app.main import build_erp_nav, render_template # noqa: WPS433
- from app.store import is_admin # noqa: WPS433
+ from app.store import has_module, is_admin # noqa: WPS433
user = _require_user(request)
st = _store(request)
@@ -3091,6 +3182,8 @@ def goal_meeting_page(request: Request, year: int, month: int, week: str | None
# 주차를 열면 다시 받을 매출 기간(실적 모듈 매출 업데이트) — 지난주 월요일 ~ 이번 주 일요일(오늘까지)
"sync_from": (sel - timedelta(days=7)).isoformat() if sel - timedelta(days=7) <= today else "",
"sync_to": min(sel + timedelta(days=6), today).isoformat(),
+ # 쇼핑몰 매출 갱신(실적 모듈 POST /performance/api/sync)은 실적 모듈 권한자만 — 없으면 화면이 부르지 않는다
+ "can_sync": has_module(user, "performance"),
"meeting_status": store.MEETING_STATUS,
"meet_members": members,
"month_plan": _month_plan(st, year, month),
@@ -3131,7 +3224,10 @@ def api_update_meeting(request: Request, week_start: str, payload: dict[str, Any
ws = _goal_call(store.validate_week_start, week_start)
fields = {k: payload[k] for k in ("week_target", "attendees", "notes") if k in payload}
_goal_call(st.update_meeting, week_start=ws, fields=fields, updated_by=user["email"])
- return JSONResponse({"ok": True})
+ out: dict[str, Any] = {"ok": True}
+ if "week_target" in fields: # 화면이 서버 확정값(원 정수)으로 칸을 맞춘다
+ out["week_target"] = store.validate_meeting_amount(fields["week_target"])
+ return JSONResponse(out)
@router.delete("/api/goals/meetings/{week_start}")
diff --git a/app/modules/project/templates/project/goal_meeting.html b/app/modules/project/templates/project/goal_meeting.html
index 426f81e..88770ef 100644
--- a/app/modules/project/templates/project/goal_meeting.html
+++ b/app/modules/project/templates/project/goal_meeting.html
@@ -1,7 +1,7 @@
{% extends "erp_base.html" %}
{% block head_extra %}
-
+
{% endblock %}
@@ -104,9 +104,8 @@
{% else %}
{% set h = head %}
{% set edit = is_admin %}
- {# 매출 자료 갱신 — 주차를 열면 표시 없이 실적 모듈 매출 업데이트(지난주 월요일 ~ 이번 주 오늘)를 한 번 더 돌리고
- 숫자 칸만 다시 그린다(project.js initMeetingSync, 같은 주는 10분에 한 번). 상태 줄은 2026-10-01 요청으로 뺐다. #}
- {% if h.perf and sync_from %}
{% endif %}
+ {% set unk = h.unknown or [] %}
+ {%- macro unknown_val() -%}미확인{%- endmacro -%}
{# ── 숫자 — 한 줄 막대(월 목표 대비 누적·남은 주 필요 매출 | 전주 리뷰 | 금주 목표) ── #}
@@ -115,14 +114,14 @@
{% if h.sales_target is not none %}{{ num(h.sales_target) }}{{ h.sales_unit }}{% else %}목표 표에 없음{% endif %}
{% if h.month_target_won is not none and h.sales_unit and h.sales_unit != '원' %}= {{ won(h.month_target_won) }}원{% endif %}
-
+
월 누적 실적 (지난주까지)
- {% if h.mtd is not none %}{{ won(h.mtd) }}원{% else %}—{% endif %}
+ {% if h.mtd is not none %}{{ won(h.mtd) }}원{% elif 'mtd' in unk %}{{ unknown_val() }}{% else %}—{% endif %}
{% if h.month_target_won and h.mtd is not none %}달성 {{ "%.1f" | format(h.mtd / h.month_target_won * 100) }}%{% endif %}
주당 필요 (남은 {{ h.weeks_left }}주)
- {% if h.need_per_week is not none %}{{ won(h.need_per_week) }}원{% else %}—{% endif %}
+ {% if h.need_per_week is not none %}{{ won(h.need_per_week) }}원{% elif 'mtd' in unk and h.month_target_won is not none %}{{ unknown_val() }}{% else %}—{% endif %}
목표 ROAS
@@ -134,14 +133,15 @@
전주 목표{% if h.prev_target is not none %}{{ won(h.prev_target) }}원{% else %}—{% endif %}
-
+
전주 결과 ({{ prev_week[5:] | replace('-', '/') }}~ 실적)
- {% if h.prev_result is not none %}{{ won(h.prev_result) }}원{% else %}—{% endif %}
+ {% if h.prev_result is not none %}{{ won(h.prev_result) }}원{% elif 'prev_result' in unk %}{{ unknown_val() }}{% else %}—{% endif %}
전주 달성률
{% if h.prev_target and h.prev_result is not none %}{% set r = h.prev_result / h.prev_target * 100 %}
{{ "%.1f" | format(r) }}%
+ {% elif h.prev_target and 'prev_result' in unk %}{{ unknown_val() }}
{% else %}—{% endif %}
@@ -155,14 +155,25 @@
{% endif %}
{% if h.need_per_week is not none %}필요 {{ won(h.need_per_week) }}원{% endif %}
-
+
금주 현재 실적
- {% if h.week_result is not none %}{{ won(h.week_result) }}원{% else %}—{% endif %}
+ {% if h.week_result is not none %}{{ won(h.week_result) }}원{% elif 'week_result' in unk %}{{ unknown_val() }}{% else %}—{% endif %}
{% if meeting.week_target and h.week_result is not none %}목표의 {{ "%.1f" | format(h.week_result / meeting.week_target * 100) }}%{% endif %}
- {% if not h.perf %}
실적 모듈이 연결되지 않아 실적·누적·쇼핑몰 자동 결과는 비어 있습니다(결과는 직접 입력).
{% endif %}
+ {# 매출 자료 갱신 — 주차를 열면 실적 모듈 매출 업데이트(지난주 월요일 ~ 이번 주 오늘)를 한 번 더 돌리고 숫자 칸만 다시 그린다
+ (project.js initMeetingSync, 같은 주는 10분에 한 번). 정상이면 아무것도 보이지 않는다(2026-10-01 요청 — 큰 상태 줄 없음).
+ 실패·일부 실패면 이 작은 안내 + [다시 시도], 실적 권한이 없으면 부르지 않고 한 줄 설명. 마지막 갱신 성공 시각은 서버 기록(data-fresh). #}
+ {% if h.perf and sync_from %}
+ sync_problem
+
+
{% endif %}
+ {% if not h.perf %}
실적 모듈이 연결되지 않아 실적·누적·쇼핑몰 자동 결과는 비어 있습니다(결과는 직접 입력).
+ {% elif h.perf_state == 'error' %}
실적 모듈 쇼핑몰 목록을 읽지 못해 실적·누적·쇼핑몰 자동 결과를 미확인으로 표시합니다(0 원이 아님). 회의록 입력은 그대로 됩니다.
+ {% elif h.perf_state == 'empty' %}
실적 모듈에 매출 집계 쇼핑몰이 없어 실적·누적은 비어 있습니다.
+ {% elif unk %}
일부 실적을 읽지 못했습니다 — 미확인 칸은 0 원이 아니라 알 수 없는 값입니다.
{% endif %}
{# 참석자 — 전체 멤버에서 고른다(칩, [참석자] = 고르기 창). 저장은 이메일을 쉼표로 이어서, 예전 자유 입력 글자도 칩으로 #}
{% endif %}
{# 칸 배치는 router._goal_area_layout — 엑셀식 사각형 병합(colspan·rowspan), 가려진 칸은 없다 #}
@@ -177,7 +181,7 @@
{% if is_admin %}
- 칸을 고치면 바로 저장됩니다. 숫자 칸을 비우면 지워집니다. 구역·항목 칸을 우클릭하면 색·순서·줄 추가·삭제 메뉴가 나옵니다.
+ 칸을 고치면 바로 저장됩니다. 숫자 칸을 비우면 지워집니다. 구역·항목 칸을 우클릭하거나 칸의 ⋮ 버튼(키보드 Tab·Enter, 터치)을 누르면 색·순서·줄 추가·삭제 메뉴가 나옵니다.
{%- if board.halves %} 칸을 마우스로 끌어 여러 칸을 고른 뒤 우클릭 → 셀 병합, 병합된 칸은 우클릭 → 병합 해제(글은 왼쪽 위 칸에 남음).{% endif %}
월 이름을 누르면 그 달 주간 회의록이 열립니다.
@@ -192,5 +196,5 @@
{% include "project/_side_modals.html" %}
{% include "project/_member_tasks_modal.html" %}
-
+
{% endblock %}
diff --git a/app/modules/project/templates/project/help.html b/app/modules/project/templates/project/help.html
index b19f2e7..d7ce497 100644
--- a/app/modules/project/templates/project/help.html
+++ b/app/modules/project/templates/project/help.html
@@ -1,7 +1,7 @@
{% extends "erp_base.html" %}
{% block head_extra %}
-
+
{% endblock %}
@@ -95,9 +95,19 @@
접히고, 다시 누르면 펼쳐집니다(접힌 상태는 내 브라우저에 기억). 월 이름을 누르면 그 달 주간 회의록이 열립니다.
입력은 관리자만 할 수 있고(칸을 고치면 바로 저장), 다른 직원은 보기만 합니다. 관리자는 + 연도 추가로 새해 목표를
만들고(이전 연도의 업무 영역 구성을 그대로 가져옴), 영역·줄 이름은 눌러서 그 자리에서 고치고(Enter 저장, Esc 취소),
- 구역·항목 칸을 우클릭해 색·순서·줄 추가·삭제를 합니다. 업무 영역 칸은 엑셀처럼 병합할 수 있습니다 — 칸을 마우스로
+ 구역·항목 칸을 우클릭하거나 칸 오른쪽 위의 작은 ⋮ 버튼(마우스를 올리면 보임)을 눌러 색·순서·줄 추가·삭제를 합니다.
+ 키보드로는 Tab으로 이름 칸·⋮로 가서 Enter(이름 칸 = 이름 고치기, ⋮ = 메뉴), 메뉴 안에서 ↑↓·Enter,
+ Esc로 닫습니다. 터치 화면에서는 ⋮ 버튼이 늘 옅게 보여 손가락으로 누르면 됩니다. 업무 영역 칸은 엑셀처럼 병합할 수 있습니다 — 칸을 마우스로
끌어 여러 칸을 고른 뒤 우클릭 → "셀 병합", 병합된 칸은 우클릭 → "병합 해제"(글은 왼쪽 위 칸에 남음).
- 가로 병합은 같은 분기의 월 칸끼리만(연간·분기 칸은 세로로만) 되고, 칸들의 글은 순서대로 첫 칸에 모입니다.
+ 가로 병합은 같은 분기의 월 칸끼리만(연간·분기 칸은 세로로만) 되고, 칸들의 글은 순서대로 첫 칸에 모입니다.
+ 저장이 안 되면(네트워크 끊김 등) 칸 테두리가 빨갛게 되고 쓴 글은 그대로 남습니다 — 다시 입력하거나 칸을 떠나면 다시 저장합니다.
+ 저장 안 된 칸이 있으면 줄·영역 추가·병합은 하지 않고 알려 주며, 그 상태로 페이지를 떠나려 하면 브라우저가 한 번 묻습니다.
+ 글은 내 브라우저에도 잠시 보관되어, 저장되지 못한 채 창이 닫혀도 다음에 열면 되살아납니다(그 사이 다른 사람이 같은 칸을 고쳤으면 되살리지 않음).
+
주간 회의록(목표 표의 월 이름) — 지난주 리뷰는 언제나 바로 앞 주(7일 전 월~일) 회의록만 보여 줍니다. 그 주 회의록이 없으면
+ "회의록 없음"으로 비워 두고, 몇 주 전 결과를 지난주처럼 보이지 않습니다. 회의록을 만드는 순서(다음 주를 먼저 만들어도)와 줄 이름 변경·순서 이동과
+ 관계없이 같은 줄끼리 이어집니다. 실적 모듈에서 매출을 읽지 못하면 그 칸은 0원이 아니라 ⚠ 미확인으로 보입니다(필요 매출·달성률도 미확인).
+ 매출 자동 갱신은 평소엔 조용히 돌고, 실패하거나 일부 쇼핑몰만 실패하면 숫자 아래에 작은 안내와 다시 시도가 나옵니다
+ (안내의 "마지막 갱신 성공" 시각은 실적 모듈이 기록한 시각). 실적 권한이 없으면 갱신하지 않고 저장된 실적으로 보여 줍니다.
프로젝트 — 내가 멤버인 프로젝트 목록입니다. 누르면 그 프로젝트 화면으로 갑니다. 완료한 프로젝트는 아래 완료 프로젝트에 흐리게 모입니다.
전체 멤버 — 관리자에게만 보입니다. 사람 아이콘을 누르면 그 사람이 맡은 모든 작업을 한눈에 봅니다.
diff --git a/app/modules/project/templates/project/inbox.html b/app/modules/project/templates/project/inbox.html
index 61570bd..91e7355 100644
--- a/app/modules/project/templates/project/inbox.html
+++ b/app/modules/project/templates/project/inbox.html
@@ -1,7 +1,7 @@
{% extends "erp_base.html" %}
{% block head_extra %}
-
+
{% endblock %}
@@ -104,5 +104,5 @@
{% include "project/_side_modals.html" %}
{% include "project/_member_tasks_modal.html" %}
-
+
{% endblock %}
diff --git a/app/modules/project/templates/project/mytasks.html b/app/modules/project/templates/project/mytasks.html
index 2933f64..16efdcd 100644
--- a/app/modules/project/templates/project/mytasks.html
+++ b/app/modules/project/templates/project/mytasks.html
@@ -1,7 +1,7 @@
{% extends "erp_base.html" %}
{% block head_extra %}
-
+
{% endblock %}
@@ -100,5 +100,5 @@
"today": {{ today | tojson }}
}
-
+
{% endblock %}
diff --git a/app/modules/project/templates/project/project.html b/app/modules/project/templates/project/project.html
index 270d80c..99a45b3 100644
--- a/app/modules/project/templates/project/project.html
+++ b/app/modules/project/templates/project/project.html
@@ -1,7 +1,7 @@
{% extends "erp_base.html" %}
{% block head_extra %}
-
+
@@ -496,5 +496,5 @@
-
+
{% endblock %}
diff --git a/app/modules/project/templates/project/trash.html b/app/modules/project/templates/project/trash.html
index 95713e7..4706e33 100644
--- a/app/modules/project/templates/project/trash.html
+++ b/app/modules/project/templates/project/trash.html
@@ -1,7 +1,7 @@
{% extends "erp_base.html" %}
{% block head_extra %}
-
+
{% endblock %}
@@ -70,5 +70,5 @@
{% include "project/_side_modals.html" %}
{% include "project/_member_tasks_modal.html" %}
-
+
{% endblock %}
diff --git a/app/static/project.css b/app/static/project.css
index a6bdd79..3d93f3f 100644
--- a/app/static/project.css
+++ b/app/static/project.css
@@ -1351,7 +1351,9 @@ label.pj-desc-fmtbtn {
border: none; background: transparent; padding: 8px 10px; border-radius: 7px;
font-size: 13px; color: var(--pj-ink); cursor: pointer;
}
-.pj-ctxmenu-item:hover { background: var(--pj-accent-tint); }
+.pj-ctxmenu-item:hover, .pj-ctxmenu-item:focus { background: var(--pj-accent-tint); outline: none; }
+.pj-ctxmenu-item:focus-visible { box-shadow: inset 0 0 0 2px var(--pj-accent); }
+.pj-ctxmenu:focus { outline: none; }
.pj-ctxmenu-item.is-danger { color: #c22b10; }
.pj-ctxmenu-item.is-danger:hover { background: #fbecea; }
.pj-ctxmenu-sep { height: 1px; background: var(--pj-border); margin: 4px 2px; }
@@ -2093,7 +2095,24 @@ input.pj-goal-num:focus { outline: 2px solid var(--pj-accent); outline-offset: -
.pj-goal-area > tr:first-child > * { border-top: 1px solid rgba(0, 0, 0, .12); }
.pj-goal-area-name { font-size: 13px; font-weight: 800 !important; }
.pj-goal-area-text, .pj-goal-row-text { display: block; word-break: keep-all; overflow-wrap: anywhere; }
-/* 구역·항목 칸 메뉴(색·순서·줄 추가·삭제)는 우클릭(project.js areaMenuItems·rowMenuItems) — 마우스 오버 도구 막대는 2026-10-01 요청으로 뺐다 */
+/* 구역·항목 칸 메뉴(색·순서·줄 추가·삭제)는 우클릭(project.js areaMenuItems·rowMenuItems) — 마우스 오버 도구 막대는 2026-10-01 요청으로 뺐다.
+ 대신 칸 오른쪽 위 작은 ⋮ 버튼(.pj-goal-menu-btn, 관리자만) — 자리를 차지하지 않게 absolute, 평소 투명·칸에 마우스/포커스가 오면 보임.
+ 키보드(Tab → Enter/Space)·터치(마우스 없는 화면은 늘 옅게 보임)로도 같은 메뉴. */
+.pj-goal-menu-btn {
+ position: absolute; top: 2px; right: 1px; z-index: 3; display: inline-flex; align-items: center; justify-content: center;
+ width: 18px; height: 22px; padding: 0; border: none; border-radius: 5px; background: transparent; color: var(--pj-ink-soft);
+ cursor: pointer; opacity: 0; transition: opacity .12s;
+}
+.pj-goal-menu-btn .material-symbols-outlined { font-size: 17px; }
+.pj-goal-menu-btn:hover, .pj-goal-menu-btn[aria-expanded="true"] { background: rgba(255, 255, 255, .85); color: var(--pj-ink); box-shadow: 0 0 0 1px rgba(0, 0, 0, .12); }
+th.pj-goal-area-name:hover .pj-goal-menu-btn, th.pj-goal-row-label:hover .pj-goal-menu-btn,
+th.pj-goal-area-name:focus-within .pj-goal-menu-btn, th.pj-goal-row-label:focus-within .pj-goal-menu-btn,
+.pj-goal-menu-btn:focus-visible, .pj-goal-menu-btn[aria-expanded="true"] { opacity: 1; }
+.pj-goal-menu-btn:focus-visible { outline: 2px solid var(--pj-accent); outline-offset: 0; }
+@media (hover: none) { .pj-goal-menu-btn { opacity: .7; } }
+.pj-goal-area-text[tabindex]:focus-visible, .pj-goal-row-text[tabindex]:focus-visible { outline: 2px solid var(--pj-accent); outline-offset: 1px; border-radius: 4px; }
+html.pj-goal-selecting .pj-goal-menu-btn { pointer-events: none; }
+@media print { .pj-goal-menu-btn { display: none !important; } }
textarea.pj-goal-text {
display: block; width: 100%; box-sizing: border-box; min-height: 46px; padding: 6px; border: none;
background: transparent; font: inherit; line-height: 1.5; color: inherit; resize: none; overflow: hidden;
@@ -2123,6 +2142,9 @@ textarea.pj-goal-text::placeholder { color: rgba(0, 0, 0, .3); }
.pj-goal-table td.pj-goal-year-col.is-merge-sel { box-shadow: inset 0 0 0 2px var(--pj-accent), 4px 0 6px -4px rgba(16, 24, 40, .18); }
.pj-goal-numtd.is-saved, .pj-goal-texttd.is-saved { animation: pj-goal-saved 1s ease-out; }
+/* 저장 실패한 칸 — 빨간 테두리(입력한 내용은 그대로, 다시 입력·칸 떠남·Enter 에 다시 저장) */
+.pj-goal-table td.is-save-failed, .pj-meet-table td.is-save-failed, .pj-meet-kpi.is-save-failed,
+.pj-meet-notes textarea.is-save-failed { box-shadow: inset 0 0 0 2px #d93025 !important; }
@keyframes pj-goal-saved { from { box-shadow: inset 0 0 0 2px #34a853; } to { box-shadow: inset 0 0 0 2px transparent; } }
.pj-goal-table th.is-saved { animation: pj-goal-saved 1s ease-out; }
@@ -2289,7 +2311,25 @@ html.pj-goal-selecting, html.pj-goal-selecting * { user-select: none !important;
.pj-meet-week.is-on { border-color: var(--pj-accent); box-shadow: inset 0 0 0 1px var(--pj-accent); background: var(--pj-accent-tint); }
.pj-meet-dot { position: absolute; top: 3px; left: 3px; width: 6px; height: 6px; border-radius: 50%; background: #34a853; }
-/* 매출 자료 갱신 상태 줄 */
+/* 매출 자료 갱신 — 정상이면 숨김. 실패·일부 실패·권한 없음일 때만 작은 안내(initMeetingSync, #pj-meet-sync.pj-meet-syncnote) */
+.pj-meet-syncnote {
+ display: flex; align-items: center; gap: 6px; margin: -4px 0 8px; padding: 4px 8px; border-radius: 7px;
+ font-size: 12px; line-height: 1.4; background: #fff4ec; color: #9a4a07;
+}
+.pj-meet-syncnote[hidden] { display: none; }
+.pj-meet-syncnote .material-symbols-outlined { font-size: 16px; flex: 0 0 auto; }
+.pj-meet-syncnote .pj-btn { margin-left: auto; flex: 0 0 auto; }
+.pj-meet-syncnote[data-state="noperm"] { background: #f6f7f9; color: var(--pj-ink-soft); }
+.pj-meet-syncnote[data-state="noperm"] .material-symbols-outlined { display: none; }
+.pj-meet-syncnote[data-state="running"] { background: #eef4ff; color: #1d4ed8; }
+@media print { .pj-meet-syncnote { display: none !important; } }
+/* 실적 미확인(조회 실패) — 0 원과 구분 */
+.pj-meet-unknown { color: #b45309; font-weight: 700; font-size: .92em; }
+.pj-meet-unknown::before { content: "⚠ "; font-weight: 400; }
+.pj-meet-perf-warn { color: #9a4a07; }
+.pj-meet-noprev { font-weight: 500; color: rgba(0, 0, 0, .45); }
+.pj-meet-market.is-unknown { background: #fff4ec; color: #b45309; }
+.pj-meet-week-auto.is-unknown { color: #b45309; }
.pj-meet-sync {
display: flex; align-items: center; gap: 8px; margin: -4px 0 10px; padding: 6px 10px; border-radius: 8px;
background: #f6f7f9; color: var(--pj-ink-soft); font-size: 12.5px;
diff --git a/app/static/project.js b/app/static/project.js
index 57565c2..57eef19 100644
--- a/app/static/project.js
+++ b/app/static/project.js
@@ -8,9 +8,11 @@
"use strict";
// ── 공용 fetch ─────────────────────────────────────────────
- async function api(method, url, body) {
+ // extra.keepalive — 페이지를 떠나는 중에도 요청을 보내 달라고 브라우저에 부탁(보장은 아님, createFieldSaver 참고)
+ async function api(method, url, body, extra) {
const opts = { method, headers: { "Content-Type": "application/json" } };
if (body !== undefined) opts.body = JSON.stringify(body);
+ if (extra && extra.keepalive) opts.keepalive = true;
const res = await fetch(url, opts);
if (!res.ok) {
let msg = res.statusText, detail = null;
@@ -116,29 +118,44 @@
// ── 우클릭 컨텍스트 메뉴 — 하나만 열리는 공용 컴포넌트.
// openDayPopover(아래)의 위치잡기/외부클릭 닫기 방식을 그대로 따르되, 앵커
// 엘리먼트 대신 클릭 좌표(clientX/Y) 기준으로 뷰포트에 클램프한다.
- let ctxMenuEl = null;
- function closeContextMenu() {
+ let ctxMenuEl = null, ctxMenuOpts = null;
+ function closeContextMenu(opts) {
if (!ctxMenuEl) return;
- ctxMenuEl.remove();
+ const menu = ctxMenuEl, o = ctxMenuOpts || {};
+ // 메뉴 안에 포커스가 있었으면(키보드로 다루던 중) 연 버튼으로 포커스를 돌려준다
+ const hadFocus = menu.contains(document.activeElement);
+ menu.remove();
ctxMenuEl = null;
+ ctxMenuOpts = null;
document.removeEventListener("mousedown", onCtxDocDown, true);
document.removeEventListener("keydown", onCtxKeyDown, true);
- window.removeEventListener("scroll", closeContextMenu, true);
- window.removeEventListener("resize", closeContextMenu, true);
+ window.removeEventListener("scroll", onCtxScroll, true);
+ window.removeEventListener("resize", onCtxScroll, true);
+ if (o.onClose) o.onClose(opts || {});
+ if (o.returnFocus && (hadFocus || (opts && opts.focus)) && document.contains(o.returnFocus)) {
+ try { o.returnFocus.focus({ preventScroll: true }); } catch (_) { o.returnFocus.focus(); }
+ }
}
+ function onCtxScroll() { closeContextMenu(); }
function onCtxDocDown(e) {
- if (ctxMenuEl && !ctxMenuEl.contains(e.target)) closeContextMenu();
+ if (ctxMenuEl && !ctxMenuEl.contains(e.target)) closeContextMenu({ target: e.target });
}
function onCtxKeyDown(e) {
- if (e.key === "Escape") closeContextMenu();
+ if (e.key === "Escape") { e.preventDefault(); e.stopPropagation(); closeContextMenu({ focus: true }); }
}
// items: [{label, danger?, onClick} | null(구분선)]
+ // opts(선택): returnFocus = 닫으면 포커스를 돌려줄 요소(메뉴 버튼), focusFirst = 열자마자 첫 항목에 포커스(키보드로 연 경우),
+ // onClose = 닫힐 때(메뉴 버튼 aria-expanded 되돌리기). 메뉴 안: ↑↓·Home·End 이동, Esc 닫기, Tab 닫기.
// 우클릭 메뉴 왼쪽 아이콘(Material Symbols) — item.icon 에 넣는다
function menuIcon(name) { return '' + name + ""; }
- function showContextMenu(x, y, items) {
+ function showContextMenu(x, y, items, opts) {
closeContextMenu();
+ opts = opts || {};
const menu = document.createElement("div");
menu.className = "pj-ctxmenu";
+ menu.setAttribute("role", "menu");
+ if (opts.label) menu.setAttribute("aria-label", opts.label);
+ menu.tabIndex = -1;
items.forEach(function (item) {
if (!item) {
const sep = document.createElement("div");
@@ -158,26 +175,200 @@
} else {
b.textContent = item.label;
}
- b.addEventListener("click", function () { closeContextMenu(); item.onClick(); });
+ b.setAttribute("role", item.checked !== undefined ? "menuitemcheckbox" : "menuitem");
+ if (item.checked !== undefined) b.setAttribute("aria-checked", item.checked ? "true" : "false");
+ b.tabIndex = -1;
+ b.addEventListener("click", function () { closeContextMenu({ focus: true }); item.onClick(); });
menu.appendChild(b);
});
+ menu.addEventListener("keydown", function (e) {
+ const list = Array.from(menu.querySelectorAll(".pj-ctxmenu-item"));
+ const i = list.indexOf(document.activeElement);
+ let j = -1;
+ if (e.key === "ArrowDown") j = i < 0 ? 0 : (i + 1) % list.length;
+ else if (e.key === "ArrowUp") j = i <= 0 ? list.length - 1 : i - 1;
+ else if (e.key === "Home") j = 0;
+ else if (e.key === "End") j = list.length - 1;
+ else if (e.key === "Tab") { e.preventDefault(); closeContextMenu({ focus: true }); return; }
+ if (j < 0 || !list.length) return;
+ e.preventDefault();
+ list[j].focus();
+ });
document.body.appendChild(menu);
ctxMenuEl = menu;
+ ctxMenuOpts = opts;
let left = window.scrollX + x;
let top = window.scrollY + y;
left = Math.min(left, window.scrollX + document.documentElement.clientWidth - menu.offsetWidth - 8);
top = Math.min(top, window.scrollY + document.documentElement.clientHeight - menu.offsetHeight - 8);
menu.style.left = Math.max(8, left) + "px";
menu.style.top = Math.max(8, top) + "px";
+ if (opts.returnFocus) {
+ // 메뉴 버튼으로 연 메뉴 — 첫 항목(키보드) 또는 메뉴 자체(마우스·터치)에 포커스를 줘 ↑↓·Esc 가 바로 먹게
+ const first = menu.querySelector(".pj-ctxmenu-item");
+ if (opts.focusFirst && first) first.focus(); else menu.focus();
+ }
setTimeout(function () {
if (ctxMenuEl !== menu) return; // 그 사이 닫혔으면 문서 리스너를 남기지 않는다
document.addEventListener("mousedown", onCtxDocDown, true);
document.addEventListener("keydown", onCtxKeyDown, true);
- window.addEventListener("scroll", closeContextMenu, true);
- window.addEventListener("resize", closeContextMenu, true);
+ window.addEventListener("scroll", onCtxScroll, true);
+ window.addEventListener("resize", onCtxScroll, true);
}, 0);
}
+ // ── 칸별 자동 저장(목표 표·주간 회의록 공용) ─────────────────────────────
+ // · 저장 완료 기준(saved)은 "성공한 요청에 실어 보낸 값"만이다 — 응답이 올 때 바뀌어 있는 화면 값을 저장됐다고 보지 않는다.
+ // · 같은 칸의 요청은 한 줄로 세운다(앞 요청이 끝나야 다음 요청을 보냄) — 서버에 닿는 순서 = 보낸 순서라, 늦게 끝난 옛 요청이
+ // 최신 값을 덮지 않는다(응답만 무시하는 게 아니라 쓰기 자체를 차례대로). 다음 요청은 보낼 때의 최신 초안을 읽어서,
+ // 진행 중에 새로 입력한 글·숫자도 뒤이어 저장된다.
+ // · 실패하면 초안과 dirty 를 그대로 두고 칸에 실패 표시(cfg.onFail) — 다음 입력·칸 떠남·Enter·flushAll 이 다시 보낸다.
+ // · flushAll() 은 대기 타이머뿐 아니라 진행 중 요청까지 기다리고, 하나라도 실패하면 reject(구조 변경·표 교체를 멈추게).
+ // · 초안 백업(cfg.draftKey) — 입력할 때마다 localStorage 에 {base(서버에 저장된 값), draft}, 저장되면 지운다. 다음에 열 때
+ // 서버 값이 base 그대로면 초안을 되살려 다시 저장하고, 서버 값이 바뀌었으면 되살리지 않는다(다른 곳의 수정을 덮지 않게).
+ // · 페이지 떠남(onBeforeUnload): 진행 중 요청이 없는 dirty 칸은 keepalive 로 한 번 더 보낸다 — 브라우저가 끝까지 보낸다는
+ // 보장은 없어서 초안 백업이 함께 남는다. 실패했던 칸·진행 중 요청이 있는 칸·cfg.unload === "warn"(숫자 칸) 이 남아 있으면
+ // 브라우저 이탈 경고를 띄운다.
+ const DRAFT_PREFIX = "pj_draft:";
+ const DRAFT_TTL_MS = 14 * 24 * 3600 * 1000;
+ (function purgeOldDrafts() {
+ try {
+ const now = Date.now(), old = [];
+ for (let i = 0; i < localStorage.length; i++) {
+ const k = localStorage.key(i);
+ if (!k || k.indexOf(DRAFT_PREFIX) !== 0) continue;
+ let d = null;
+ try { d = JSON.parse(localStorage.getItem(k)); } catch (_) {}
+ if (!d || now - (d.at || 0) > DRAFT_TTL_MS) old.push(k);
+ }
+ old.forEach(function (k) { localStorage.removeItem(k); });
+ } catch (_) {}
+ })();
+ function createFieldSaver(cfg) {
+ const delay = cfg.delay == null ? 800 : cfg.delay;
+ const states = new Map(); // 칸 → {saved, chain, busy, timer, failed}
+ const alive = cfg.alive || function (f) { return document.contains(f); };
+ function noop() {}
+ function writeDraft(f, s) {
+ const k = cfg.draftKey && cfg.draftKey(f);
+ if (!k) return;
+ try {
+ const v = cfg.read(f);
+ if (v === s.saved) localStorage.removeItem(DRAFT_PREFIX + k);
+ else localStorage.setItem(DRAFT_PREFIX + k, JSON.stringify({ base: s.saved, draft: v, at: Date.now() }));
+ } catch (_) {}
+ }
+ // 칸 등록 — initial = 서버가 그려 준 값. 남은 초안이 있으면 되살린다: "restored" | "conflict" | null
+ function track(f, initial) {
+ const s = { saved: initial, chain: Promise.resolve(), busy: 0, timer: null, failed: false };
+ states.set(f, s);
+ const k = cfg.draftKey && cfg.draftKey(f);
+ if (!k) return null;
+ let d = null;
+ try { d = JSON.parse(localStorage.getItem(DRAFT_PREFIX + k) || "null"); } catch (_) {}
+ if (!d || typeof d.draft !== "string") return null;
+ if (d.draft === initial) { try { localStorage.removeItem(DRAFT_PREFIX + k); } catch (_) {} return null; }
+ if (d.base !== initial) { try { localStorage.removeItem(DRAFT_PREFIX + k); } catch (_) {} return "conflict"; }
+ if (cfg.write) cfg.write(f, d.draft);
+ queue(f);
+ return "restored";
+ }
+ function queue(f) {
+ const s = states.get(f);
+ if (!s) return;
+ clearTimeout(s.timer);
+ s.timer = setTimeout(function () { s.timer = null; flush(f).catch(noop); }, delay);
+ writeDraft(f, s);
+ }
+ function flush(f, opts) {
+ const s = states.get(f);
+ if (!s) return Promise.resolve(true);
+ clearTimeout(s.timer);
+ s.timer = null;
+ const run = async function () {
+ const v = cfg.read(f);
+ if (v === s.saved) {
+ if (s.failed) { s.failed = false; if (cfg.onClear) cfg.onClear(f); }
+ writeDraft(f, s);
+ return true;
+ }
+ let res;
+ try {
+ res = await cfg.send(f, v, opts || {});
+ } catch (err) {
+ s.failed = true;
+ writeDraft(f, s);
+ if (cfg.onFail) cfg.onFail(f, err);
+ throw err;
+ }
+ s.saved = v; // 이 요청에 실어 보낸 값만 저장됨으로
+ s.failed = false;
+ if (cfg.onSaved) {
+ const ns = cfg.onSaved(f, v, res, cfg.read(f) === v); // 마지막 인자: 요청 뒤 초안이 그대로인가
+ if (typeof ns === "string") s.saved = ns; // 서버 표기(쉼표 등)로 칸을 바꿨으면 그 값이 기준
+ }
+ writeDraft(f, s);
+ return true;
+ };
+ s.busy++;
+ // 앞 요청이 없으면 지금 바로(동기적으로 fetch 까지) — 페이지 떠날 때 keepalive 가 그 자리에서 나가게
+ const p = s.busy === 1 ? run() : s.chain.then(run, run);
+ s.chain = p.then(noop, noop).then(function () { s.busy--; });
+ return p;
+ }
+ function isDirty(f) {
+ const s = states.get(f);
+ return !!s && (s.busy > 0 || !!s.timer || cfg.read(f) !== s.saved);
+ }
+ function each(fn) { states.forEach(function (s, f) { if (alive(f)) fn(s, f); }); }
+ function anyDirty() { let d = false; each(function (s, f) { if (isDirty(f)) d = true; }); return d; }
+ function flushAll() {
+ const list = [];
+ each(function (s, f) { if (isDirty(f)) list.push(flush(f)); });
+ return Promise.allSettled(list).then(function (rs) {
+ const bad = rs.filter(function (r) { return r.status === "rejected"; });
+ if (!bad.length) return true;
+ const err = new Error("저장하지 못한 칸이 " + bad.length + "개 있어 멈췄습니다(입력한 내용은 그대로) — " +
+ ((bad[0].reason && bad[0].reason.message) || "저장 실패"));
+ err.cause = bad[0].reason;
+ throw err;
+ });
+ }
+ function prune() { states.forEach(function (s, f) { if (!alive(f)) { clearTimeout(s.timer); states.delete(f); } }); }
+ function onBeforeUnload(e) {
+ let warn = false;
+ each(function (s, f) {
+ const dirty = cfg.read(f) !== s.saved;
+ if (!dirty && !s.busy) return;
+ writeDraft(f, s);
+ if (cfg.unload === "warn" || s.busy > 0 || s.failed) warn = true;
+ if (dirty && s.busy === 0 && cfg.unload !== "warn") flush(f, { keepalive: true }).catch(noop);
+ });
+ if (warn && e) { e.preventDefault(); e.returnValue = ""; }
+ return warn;
+ }
+ return {
+ track: track, queue: queue, flush: flush, flushAll: flushAll, isDirty: isDirty, anyDirty: anyDirty,
+ prune: prune, onBeforeUnload: onBeforeUnload,
+ savedOf: function (f) { const s = states.get(f); return s ? s.saved : undefined; },
+ failedOf: function (f) { const s = states.get(f); return !!(s && s.failed); },
+ };
+ }
+ // 저장 실패 표시 — 칸 빨간 테두리 + 안내(입력한 내용은 지우지 않는다)
+ function markSaveFailed(node, err) {
+ if (node) {
+ node.classList.remove("is-saved");
+ node.classList.add("is-save-failed");
+ node.dataset.tip = "저장 실패 — 입력한 내용은 그대로 있습니다. 다시 입력하거나 칸을 떠나면(Enter) 다시 저장합니다.";
+ }
+ showToast("저장 실패(입력한 내용은 그대로, 칸을 떠나면 다시 시도): " + (err && err.message || ""), "error");
+ }
+ function clearSaveFailed(node) {
+ if (!node || !node.classList.contains("is-save-failed")) return;
+ node.classList.remove("is-save-failed");
+ delete node.dataset.tip;
+ }
+
// ── 클립보드 복사 ── navigator.clipboard 는 https(보안 컨텍스트)에서만
// 동작한다 — 사내 IP로 http 접속하는 경우를 위해 임시 textarea 로 한 번 더
// 시도한다. 둘 다 실패하면 false 를 돌려 호출 쪽이 주소를 직접 보여준다.
@@ -8212,65 +8403,81 @@
let clearMergeSel = function () {};
if (!isAdmin) return;
- // ── 숫자 칸 ──
- table.querySelectorAll("input.pj-goal-num").forEach(function (inp) {
- inp.dataset.saved = inp.value;
- inp.addEventListener("focus", function () { inp.select(); });
- inp.addEventListener("input", recompute);
- inp.addEventListener("keydown", function (e) {
- if (e.key === "Enter") { e.preventDefault(); inp.blur(); }
- else if (e.key === "Escape") { inp.value = inp.dataset.saved; recompute(); inp.blur(); }
- });
- inp.addEventListener("change", async function () {
- const d = inp.dataset;
- try {
- const res = await api("PUT", "/project/api/goals/" + year + "/metrics",
- { metric: d.metric, kind: d.kind, month: parseInt(d.month, 10), value: inp.value });
- inp.value = res.label;
- d.saved = res.label;
- flashSaved(inp.parentElement);
- } catch (e) {
- inp.value = d.saved;
- showToast("저장 실패: " + e.message, "error");
- }
- recompute();
- });
- });
-
function flashSaved(node) {
node.classList.remove("is-saved");
void node.offsetWidth;
node.classList.add("is-saved");
}
- // ── 글 칸 ──
- const pending = new Map(); // textarea → 타이머
+ // ── 숫자 칸 — Enter·칸 떠남에 저장(createFieldSaver: 같은 칸 요청 차례대로, 늦은 응답이 새 입력을 덮지 않음).
+ // 서버 표기(쉼표)는 요청 뒤 입력이 그대로일 때만 칸에 넣는다. 실패해도 입력값은 그대로(빨간 테두리), Esc = 저장된 값으로.
+ const numSaver = createFieldSaver({
+ read: function (inp) { return inp.value; },
+ write: function (inp, v) { inp.value = v; },
+ unload: "warn", // Enter·칸 떠남 전의 숫자는 페이지를 떠날 때 보내지 않고 경고만
+ send: function (inp, v, o) {
+ const d = inp.dataset;
+ return api("PUT", "/project/api/goals/" + year + "/metrics",
+ { metric: d.metric, kind: d.kind, month: parseInt(d.month, 10), value: v }, o);
+ },
+ onSaved: function (inp, v, res, same) {
+ clearSaveFailed(inp.parentElement);
+ flashSaved(inp.parentElement);
+ if (!same) return undefined; // 요청 뒤 새로 입력 중 — 그 초안을 그대로 둔다
+ inp.value = res.label;
+ recompute();
+ return res.label;
+ },
+ onFail: function (inp, err) { markSaveFailed(inp.parentElement, err); },
+ });
+ table.querySelectorAll("input.pj-goal-num").forEach(function (inp) {
+ numSaver.track(inp, inp.value);
+ inp.addEventListener("focus", function () { inp.select(); });
+ inp.addEventListener("input", recompute);
+ inp.addEventListener("keydown", function (e) {
+ if (isImeEnter(e)) return;
+ if (e.key === "Enter") { e.preventDefault(); if (document.activeElement === inp) inp.blur(); else numSaver.flush(inp).catch(function () {}); }
+ else if (e.key === "Escape") { inp.value = numSaver.savedOf(inp); recompute(); inp.blur(); }
+ });
+ inp.addEventListener("change", function () { numSaver.flush(inp).catch(function () {}); });
+ inp.addEventListener("blur", function () { numSaver.flush(inp).catch(function () {}); });
+ });
+
+ // ── 글 칸 — 0.8초 멈춤·칸 떠남에 저장(createFieldSaver). 실패해도 글은 그대로 두고 다음 입력·칸 떠남에 다시 보낸다.
+ // 초안은 localStorage 에도(pj_draft:goal:줄:칸) — 페이지가 닫혀도 다음에 열면 되살린다.
function cellUrl(ta) { return "/project/api/goals/rows/" + ta.dataset.row + "/cells/" + ta.dataset.month; }
- async function saveText(ta) {
- clearTimeout(pending.get(ta));
- pending.delete(ta);
- const body = ta.value;
- if (body === ta.dataset.saved) return;
- try {
- await api("PUT", cellUrl(ta), { body: body });
- ta.dataset.saved = body;
+ let pendingRefresh = false; // 구조는 바뀌었는데 입력 중이라 표를 아직 다시 못 그림 — 저장이 끝나면 다시 그린다
+ const textSaver = createFieldSaver({
+ read: function (ta) { return ta.value; },
+ write: function (ta, v) { ta.value = v; fit(ta); },
+ send: function (ta, v, o) { return api("PUT", cellUrl(ta), { body: v }, o); },
+ draftKey: function (ta) { return "goal:" + ta.dataset.row + ":" + ta.dataset.month; },
+ onSaved: function (ta) {
+ clearSaveFailed(ta.parentElement);
flashSaved(ta.parentElement);
- } catch (e) { showToast("저장 실패: " + e.message, "error"); }
- }
- // 글 칸 연결 — 처음 한 번 + 표를 그 자리에서 다시 그린 뒤 새 칸에(refreshTable)
+ if (pendingRefresh) setTimeout(function () {
+ if (pendingRefresh && !textSaver.anyDirty()) refreshTable().catch(function (err) { showToast(err.message, "error"); });
+ }, 0);
+ },
+ onClear: function (ta) { clearSaveFailed(ta.parentElement); },
+ onFail: function (ta, err) { markSaveFailed(ta.parentElement, err); },
+ });
+ function saveText(ta) { return textSaver.flush(ta); }
+ // 글 칸 연결 — 처음 한 번 + 표를 그 자리에서 다시 그린 뒤 새 칸에(refreshTable). 되살린 초안 수를 돌려준다.
function bindTexts(root) {
+ let restored = 0, conflict = 0;
root.querySelectorAll("textarea.pj-goal-text").forEach(function (ta) {
if (ta.dataset.bound) return;
ta.dataset.bound = "1";
- ta.dataset.saved = ta.value;
+ const r = textSaver.track(ta, ta.value);
+ if (r === "restored") restored++;
+ else if (r === "conflict") conflict++;
fit(ta);
- ta.addEventListener("input", function () {
- fit(ta);
- clearTimeout(pending.get(ta));
- pending.set(ta, setTimeout(function () { saveText(ta); }, 800));
- });
- ta.addEventListener("blur", function () { saveText(ta); });
+ ta.addEventListener("input", function () { fit(ta); textSaver.queue(ta); });
+ ta.addEventListener("blur", function () { textSaver.flush(ta).catch(function () {}); });
});
+ if (restored) showToast("저장되지 않았던 글 " + restored + "칸을 되살려 다시 저장합니다.");
+ else if (conflict) showToast("다른 곳에서 바뀐 칸 " + conflict + "개는 예전 초안을 되살리지 않았습니다.");
}
bindTexts(table);
// 칸이 세로로 길어도(옆 칸 글이 길거나 세로 병합) 칸 아무 곳이나 누르면 그 칸 입력 — 커서는 글 끝(엑셀처럼).
@@ -8287,17 +8494,10 @@
});
// 한 줄 안 칸들 높이는 표가 맞춘다 — 창 폭이 바뀌면 글 줄바꿈이 달라지니 다시 잰다.
window.addEventListener("resize", fitAll);
- window.addEventListener("beforeunload", function () {
- pending.forEach(function (timer, ta) {
- clearTimeout(timer);
- if (ta.value === ta.dataset.saved) return;
- try {
- fetch(cellUrl(ta), {
- method: "PUT", keepalive: true, headers: { "Content-Type": "application/json" },
- body: JSON.stringify({ body: ta.value }),
- });
- } catch (_) {}
- });
+ // 페이지 떠남 — 글은 keepalive 로 한 번 더 보내고(보장 아님, 초안 백업이 남음), 실패·진행 중·숫자 미저장이면 이탈 경고
+ window.addEventListener("beforeunload", function (e) {
+ textSaver.onBeforeUnload(e);
+ numSaver.onBeforeUnload(e);
});
// ── 머리 — 매출 단위 · 연도 삭제 ──
@@ -8332,11 +8532,14 @@
const name = await prompt("새 업무 영역 이름", "");
if (name == null || !String(name).trim()) return;
const n = table.querySelectorAll(".pj-goal-area").length;
- try {
- await api("POST", "/project/api/goals/" + year + "/areas",
- { name: String(name).trim(), color: colors.length ? colors[n % colors.length] : "" });
- await refreshTable();
- } catch (e) { showToast("추가 실패: " + e.message, "error"); }
+ await withStruct(async function () {
+ try {
+ await flushTexts(); // 저장 못 한 글이 있으면 영역을 만들지 않는다(글은 그대로)
+ await api("POST", "/project/api/goals/" + year + "/areas",
+ { name: String(name).trim(), color: colors.length ? colors[n % colors.length] : "" });
+ await refreshTable();
+ } catch (e) { showToast("추가 실패: " + e.message, "error"); }
+ });
});
// ── 영역 색 고르기 — 팝업은 body 에(화면 배율 밖) ──
@@ -8382,39 +8585,66 @@
const t = node && node.querySelector(sel);
return t ? t.textContent.trim() : "";
}
- // 저장 안 된 글이 있으면 먼저 저장(구조 변경·병합 전에 — 병합은 서버가 DB 의 글을 모은다)
- function flushTexts() { return Promise.all(Array.from(pending.keys()).map(saveText)); }
+ // 저장 안 된 글(대기·진행 중·실패했던 칸)을 먼저 저장 — 구조 변경·병합 전에(병합은 서버가 DB 의 글을 모은다).
+ // 하나라도 실패하면 reject → 부른 쪽은 구조 요청·표 교체를 하지 않는다(글은 그대로).
+ function flushTexts() { return textSaver.flushAll(); }
+ // 구조 작업(영역·줄 추가/삭제/이동, 병합/해제)은 한 번에 하나씩 — 앞 작업의 다시 그리기가 끝난 뒤 다음 작업
+ let structChain = Promise.resolve();
+ function withStruct(fn) {
+ const p = structChain.then(fn, fn);
+ structChain = p.then(function () {}, function () {});
+ return p;
+ }
+ function editingNames() { return !!table.querySelector("[data-goal-edit].is-editing"); }
// ── 구조가 바뀐 뒤(줄·영역 추가/삭제/이동, 병합/해제) 페이지를 새로고침하지 않고 업무 영역 부분만 서버에서 다시 받아
// 그 자리에서 바꿔 끼운다 — 새로고침 때 저장된 열 너비가 늦게 적용돼 표가 줄었다 늘어나거나 깜박이던 것을 없앤다.
// 애니메이션: 지운 줄은 흐려지며 사라지고(opts.removed), 남은 줄은 예전 자리에서 새 자리로 미끄러지고(FLIP),
// 새 줄은 위에서 내려오며 잠깐 강조, 병합한 칸은 테두리 강조(opts.flash = {row, month}). 동작 줄이기 설정이면 애니메이션 없이.
- // 받아 오기에 실패하면 예전처럼 새로고침.
+ // 받아 오기에 실패하면 예전처럼 새로고침(저장 안 된 글이 없을 때만).
+ // 글 보호: ① 시작 전에 저장 안 된 글을 저장 — 실패하면 throw(표는 그대로, 글 유지)
+ // ② 받아 오는 사이에 새로 입력한 글이 있으면 저장 후 다시 받는다(바꿔 끼우기 직전 검사는 동기 — 그 사이 입력 불가)
+ // ③ 계속 입력 중이면 바꿔 끼우지 않고 pendingRefresh — 저장이 끝나면 다시 그린다.
const GOAL_ANIM_MS = 280;
async function refreshTable(opts) {
opts = opts || {};
await flushTexts();
const reduce = !Element.prototype.animate ||
(window.matchMedia && window.matchMedia("(prefers-reduced-motion: reduce)").matches);
- if (opts.removed && opts.removed.length && !reduce) {
- await Promise.all(opts.removed.map(function (tr) {
- return tr.animate([{ opacity: 1 }, { opacity: 0 }], { duration: 180, easing: "ease-in", fill: "forwards" })
- .finished.catch(function () {});
- }));
+ let fresh = null, anims = [];
+ const busy = function () { return textSaver.anyDirty() || editingNames(); };
+ for (let tries = 0; ; tries++) {
+ fresh = null;
+ try {
+ const res = await fetch(location.href, { credentials: "same-origin", cache: "no-store" });
+ if (res.ok) fresh = new DOMParser().parseFromString(await res.text(), "text/html").getElementById("pj-goal-table");
+ } catch (_) { fresh = null; }
+ if (!busy() && opts.removed && opts.removed.length && !reduce && !anims.length) {
+ anims = opts.removed.map(function (tr) {
+ return tr.animate([{ opacity: 1 }, { opacity: 0 }], { duration: 180, easing: "ease-in", fill: "forwards" });
+ });
+ await Promise.all(anims.map(function (a) { return a.finished.catch(function () {}); }));
+ }
+ if (!busy()) break;
+ anims.forEach(function (a) { try { a.cancel(); } catch (_) {} });
+ anims = [];
+ if (tries >= 2) {
+ pendingRefresh = true;
+ showToast("입력 중인 칸이 있어 표를 아직 다시 그리지 않았습니다 — 저장되면 다시 그립니다.");
+ return;
+ }
+ await flushTexts(); // 받는 동안 새로 입력한 글 — 저장 실패면 throw(표는 그대로)
}
+ if (!fresh) { reloadKeepScroll(); return; }
+ pendingRefresh = false;
const before = new Map();
table.querySelectorAll("tbody.pj-goal-area > tr[data-row-id]").forEach(function (tr) {
before.set(tr.dataset.rowId, tr.getBoundingClientRect().top);
});
- let fresh = null;
- try {
- const res = await fetch(location.href, { credentials: "same-origin", cache: "no-store" });
- if (res.ok) fresh = new DOMParser().parseFromString(await res.text(), "text/html").getElementById("pj-goal-table");
- } catch (_) { fresh = null; }
- if (!fresh) { reloadKeepScroll(); return; }
clearMergeSel();
table.querySelectorAll("tbody.pj-goal-area").forEach(function (t) { t.remove(); });
fresh.querySelectorAll("tbody.pj-goal-area").forEach(function (t) { table.appendChild(document.importNode(t, true)); });
+ textSaver.prune();
applyColW();
QUARTERS.forEach(function (q) { applyFold(q, false); });
bindTexts(table);
@@ -8446,11 +8676,16 @@
}
async function goalAct(act, tbody, pt) {
const areaId = tbody.dataset.areaId;
+ if (act === "area-color") {
+ openColorPop(pt, areaId, tbody.dataset.color || "", tbody);
+ return;
+ }
+ return withStruct(function () { return goalStructAct(act, tbody, areaId); });
+ }
+ async function goalStructAct(act, tbody, areaId) {
try {
- if (act === "area-color") {
- openColorPop(pt, areaId, tbody.dataset.color || "", tbody);
- return;
- } else if (act === "area-up" || act === "area-down") {
+ await flushTexts(); // 저장 못 한 글이 있으면 구조를 바꾸지 않는다(throw → 아래 catch, 글 유지)
+ if (act === "area-up" || act === "area-down") {
await api("POST", "/project/api/goals/areas/" + areaId + "/move", { direction: act === "area-up" ? -1 : 1 });
} else if (act === "area-del") {
const name = textOf(tbody, ".pj-goal-area-text");
@@ -8480,12 +8715,15 @@
items.push(null, { label: "영역 삭제", danger: true, icon: menuIcon("delete"), onClick: go("area-del") });
return items;
}
+ function openAreaMenu(th, x, y, opts) {
+ showContextMenu(x, y, areaMenuItems(th.closest("tbody"), { x: x, y: y }),
+ Object.assign({ label: textOf(th, ".pj-goal-area-text") + " 구역 메뉴" }, opts || {}));
+ }
table.addEventListener("contextmenu", function (e) {
const th = e.target.closest("th.pj-goal-area-name");
if (!th || !table.contains(th) || e.target.closest(".is-editing")) return;
e.preventDefault();
- const pt = { x: e.clientX, y: e.clientY };
- showContextMenu(e.clientX, e.clientY, areaMenuItems(th.closest("tbody"), pt));
+ openAreaMenu(th, e.clientX, e.clientY);
});
// ── 줄(항목 칸) 추가·삭제 — 항목 칸·연간 칸 우클릭 메뉴가 쓴다. 한 일이 있으면 true.
@@ -8521,11 +8759,14 @@
function rowMenuItems(top, bottom, canDelete, opts) {
opts = opts || {};
const run = function (fn) {
- return async function () {
- try {
- const r = await fn();
- if (r) await refreshTable(r === true ? {} : r);
- } catch (err) { showToast("처리 실패: " + err.message, "error"); }
+ return function () {
+ return withStruct(async function () {
+ try {
+ await flushTexts(); // 저장 못 한 글이 있으면 줄 작업을 하지 않는다(글 유지)
+ const r = await fn();
+ if (r) await refreshTable(r === true ? {} : r);
+ } catch (err) { showToast("처리 실패: " + err.message, "error"); }
+ });
};
};
const items = [
@@ -8557,15 +8798,42 @@
}
return items;
}
+ function openRowLabelMenu(th, x, y, opts) {
+ const tr = th.closest("tr");
+ // 2열 = 항목 칸 밖에 따로 추가(묶음의 맨 위·맨 아래 기준), 묶인 칸이면 "항목 칸 나누기"도
+ const grouped = (th.rowSpan || 1) > 1;
+ showContextMenu(x, y, rowMenuItems(tr, labelGroupBottom(tr), true,
+ { splitRow: grouped ? tr : null, move: grouped ? null : tr }),
+ Object.assign({ label: (textOf(th, ".pj-goal-row-text") || "이름 없는") + " 줄 메뉴" }, opts || {}));
+ }
table.addEventListener("contextmenu", function (e) {
const th = e.target.closest("th.pj-goal-row-label");
if (!th || !table.contains(th) || e.target.closest(".is-editing")) return;
e.preventDefault();
- const tr = th.closest("tr");
- // 2열 = 항목 칸 밖에 따로 추가(묶음의 맨 위·맨 아래 기준), 묶인 칸이면 "항목 칸 나누기"도
- const grouped = (th.rowSpan || 1) > 1;
- showContextMenu(e.clientX, e.clientY, rowMenuItems(tr, labelGroupBottom(tr), true,
- { splitRow: grouped ? tr : null, move: grouped ? null : tr }));
+ openRowLabelMenu(th, e.clientX, e.clientY);
+ });
+ // ⋮ 메뉴 버튼(구역·항목 칸) — 우클릭과 같은 메뉴를 마우스·키보드(Tab → Enter/Space)·터치로. 닫으면 버튼으로 포커스 복귀.
+ // 표를 다시 그려도(refreshTable) 위임이라 새 버튼에 그대로 먹는다.
+ table.addEventListener("click", function (e) {
+ const btn = e.target.closest(".pj-goal-menu-btn");
+ if (!btn || !table.contains(btn)) return;
+ e.preventDefault();
+ e.stopPropagation();
+ // 열린 메뉴를 같은 버튼으로 다시 누르면 닫기(마우스는 mousedown 에서 이미 닫혔으니 방금 닫힌 것으로 판단)
+ if (btn.getAttribute("aria-expanded") === "true") { closeContextMenu({ focus: true }); return; }
+ if (Date.now() - (btn._pjMenuClosedAt || 0) < 300) return;
+ const th = btn.closest("th");
+ const r = btn.getBoundingClientRect();
+ const opts = {
+ returnFocus: btn, focusFirst: e.detail === 0, // detail 0 = 키보드(Enter/Space)로 누름
+ onClose: function (how) {
+ btn.setAttribute("aria-expanded", "false");
+ if (how.target && btn.contains(how.target)) btn._pjMenuClosedAt = Date.now(); // 이 버튼을 눌러 닫음
+ },
+ };
+ btn.setAttribute("aria-expanded", "true");
+ if (btn.dataset.goalMenu === "area") openAreaMenu(th, r.left, r.bottom + 4, opts);
+ else openRowLabelMenu(th, r.left, r.bottom + 4, opts);
});
// 3열(연간 칸) 우클릭에도 줄 추가·삭제 — 추가한 줄은 같은 항목 칸(2열) 안에 들어간다(sameLabel, 016).
// 병합 메뉴가 있으면(014) 그 메뉴에 붙이고, 없으면 여기서
@@ -8638,6 +8906,12 @@
const span = e.target.closest("[data-goal-edit]");
if (span) startNameEdit(span);
});
+ // 키보드 — 이름 칸에 Tab 으로 와서 Enter·F2 = 이름 수정(수정 중 Enter 는 startNameEdit 이 먼저 받아 preventDefault)
+ table.addEventListener("keydown", function (e) {
+ const span = e.target.closest && e.target.closest("[data-goal-edit]");
+ if (!span || span.isContentEditable || e.defaultPrevented || isImeEnter(e)) return;
+ if (e.key === "Enter" || e.key === "F2") { e.preventDefault(); startNameEdit(span); }
+ });
table.addEventListener("paste", function (e) {
const span = e.target.closest && e.target.closest("[data-goal-edit].is-editing");
if (!span) return;
@@ -8714,25 +8988,24 @@
return;
}
const rows = s.tbody.rows;
- try {
- await flushTexts();
- const res = await api("POST", "/project/api/goals/areas/" + s.tbody.dataset.areaId + "/merge", {
- row_from: rows[s.r0].dataset.rowId, row_to: rows[s.r1].dataset.rowId, col_from: cols[0], col_to: cols[cols.length - 1],
- });
- await refreshTable({ flash: { row: res.row_id, month: res.start } });
- } catch (err) { showToast("병합 실패: " + err.message, "error"); }
+ const req = { row_from: rows[s.r0].dataset.rowId, row_to: rows[s.r1].dataset.rowId, col_from: cols[0], col_to: cols[cols.length - 1] };
+ return withStruct(async function () {
+ try {
+ await flushTexts(); // 서버가 DB 글을 모으므로 먼저 저장 — 실패면 병합하지 않는다(글 유지)
+ const res = await api("POST", "/project/api/goals/areas/" + s.tbody.dataset.areaId + "/merge", req);
+ await refreshTable({ flash: { row: res.row_id, month: res.start } });
+ } catch (err) { showToast("병합 실패: " + err.message, "error"); }
+ });
};
const unmerge = async function (cellsToSplit) {
- try {
- await flushTexts();
- let first = null;
- for (const c of cellsToSplit) {
- const row = c.td.closest("tr").dataset.rowId, month = c.td.dataset.month;
- await api("DELETE", "/project/api/goals/rows/" + row + "/merge/" + month);
- first = first || { row: row, month: month };
- }
- await refreshTable({ flash: first });
- } catch (err) { showToast("병합 해제 실패: " + err.message, "error"); }
+ const targets = cellsToSplit.map(function (c) { return { row: c.td.closest("tr").dataset.rowId, month: c.td.dataset.month }; });
+ return withStruct(async function () {
+ try {
+ await flushTexts();
+ for (const t of targets) await api("DELETE", "/project/api/goals/rows/" + t.row + "/merge/" + t.month);
+ await refreshTable({ flash: targets[0] || null });
+ } catch (err) { showToast("병합 해제 실패: " + err.message, "error"); }
+ });
};
// 고른 칸 내용 지우기(엑셀 Del) — 칸마다 바로 저장. 바로 직전 지우기는 Ctrl+Z 로 되돌린다(입력 중이 아닐 때).
@@ -8744,16 +9017,16 @@
if (!tas.length) return;
lastCleared = tas.map(function (ta) { return [ta, ta.value]; });
tas.forEach(function (ta) { ta.value = ""; fit(ta); });
- await Promise.all(tas.map(saveText));
- showToast(tas.length + "칸 내용을 지웠습니다 — Ctrl+Z 로 되돌리기");
+ const rs = await Promise.allSettled(tas.map(saveText));
+ if (rs.every(function (r) { return r.status === "fulfilled"; })) showToast(tas.length + "칸 내용을 지웠습니다 — Ctrl+Z 로 되돌리기");
};
const undoClear = async function () {
const list = (lastCleared || []).filter(function (x) { return document.contains(x[0]); });
lastCleared = null;
if (!list.length) return;
list.forEach(function (x) { x[0].value = x[1]; fit(x[0]); });
- await Promise.all(list.map(function (x) { return saveText(x[0]); }));
- showToast(list.length + "칸 내용을 되돌렸습니다");
+ const rs = await Promise.allSettled(list.map(function (x) { return saveText(x[0]); }));
+ if (rs.every(function (r) { return r.status === "fulfilled"; })) showToast(list.length + "칸 내용을 되돌렸습니다");
};
const typing = function () {
const a = document.activeElement;
@@ -8844,90 +9117,156 @@
}
}
+ // ── 회의록 숫자 칸 다시 그리기 — 서버가 새로 그린 화면에서 숫자 칸만 옮겨 온다(입력 중인 칸·저장 안 된 글·직접 입력 칸은 그대로).
+ // 매출 갱신 완료·금주 목표 저장 두 곳에서 부르므로 차례 번호로 늦게 도착한 옛 응답은 버린다(옛 비율이 다시 들어오지 않게).
+ // 이번주 실적 % 는 서버 문구를 그대로 쓰지 않고 실적(data-auto)만 받아 이 화면의 서버 확정 정량 목표(tr data-target-amount)로
+ // 다시 계산한다(paintMeetWeek) — 목표 저장과 다시 그리기가 엇갈려도 지금 목표 기준.
+ let meetRepaintSeq = 0;
+ async function meetRepaint() {
+ const seq = ++meetRepaintSeq;
+ const res = await fetch(location.href, { credentials: "same-origin", cache: "no-store" });
+ if (!res.ok) throw new Error("화면을 다시 읽지 못했습니다(" + res.status + ")");
+ const doc = new DOMParser().parseFromString(await res.text(), "text/html");
+ if (seq !== meetRepaintSeq) return false; // 더 나중에 시작한 다시 그리기가 있다
+ const now = document.querySelectorAll(".pj-meet-kpi"), fresh = doc.querySelectorAll(".pj-meet-kpi");
+ if (now.length === fresh.length) {
+ now.forEach(function (n, i) {
+ if (n.querySelector("input, textarea, select")) {
+ const a = n.querySelector(".pj-meet-sub-slot"), b = fresh[i].querySelector(".pj-meet-sub-slot");
+ if (a && b) a.innerHTML = b.innerHTML;
+ return;
+ }
+ n.innerHTML = fresh[i].innerHTML;
+ const t = fresh[i].getAttribute("title");
+ if (t) { n.dataset.tip = t; n.removeAttribute("title"); }
+ });
+ }
+ document.querySelectorAll("#pj-meet-table tr[data-item]").forEach(function (tr) {
+ const ftr = doc.querySelector('#pj-meet-table tr[data-item="' + tr.dataset.item + '"]');
+ if (!ftr) return;
+ const manual = !!tr.querySelector(".pj-meet-c-result input"); // 직접 입력 결과 — 달성률도 이 화면이 계산
+ [".pj-meet-c-result", "[data-rate]"].forEach(function (sel) {
+ const a = tr.querySelector(sel), b = ftr.querySelector(sel);
+ if (!a || !b) return;
+ if (manual) return;
+ a.innerHTML = b.innerHTML;
+ });
+ // 이번주 실적 — 실적 값만 옮기고 % 는 다시 계산. 정량 목표는 입력칸이 없을 때(보기 전용)만 서버 값으로.
+ const a = tr.querySelector(".pj-meet-week-slot"), b = ftr.querySelector(".pj-meet-week-slot");
+ if (a && b) {
+ a.dataset.auto = b.dataset.auto || "";
+ if (b.dataset.err) a.dataset.err = "1"; else delete a.dataset.err;
+ if (!tr.querySelector('input[data-field="target_amount"]')) tr.dataset.targetAmount = ftr.dataset.targetAmount || "";
+ paintMeetWeek(tr);
+ }
+ });
+ const box = el("pj-meet-sync"), fbox = doc.getElementById("pj-meet-sync");
+ if (box && fbox) box.dataset.fresh = fbox.dataset.fresh || ""; // 서버가 기록한 마지막 갱신 성공 시각
+ return true;
+ }
+ // 이번주 실적(쇼핑몰 연결 줄) — 실적(slot data-auto, 서버) ÷ 서버 확정 정량 목표(tr data-target). 목표 0·빈칸이면 % 없음,
+ // 실적 조회 실패(data-err)면 "미확인".
+ function paintMeetWeek(tr) {
+ const slot = tr && tr.querySelector(".pj-meet-week-slot");
+ if (!slot) return;
+ if (slot.dataset.err) {
+ slot.innerHTML = '이번주 실적 미확인';
+ return;
+ }
+ if (slot.dataset.auto == null || slot.dataset.auto === "") { slot.innerHTML = ""; return; }
+ const auto = Number(slot.dataset.auto);
+ const target = tr.dataset.targetAmount ? Number(tr.dataset.targetAmount) : 0;
+ const pane = el("pj-meet-pane");
+ const wk = pane ? pane.dataset.week.slice(5).replace("-", "/") : "";
+ const span = document.createElement("span");
+ span.className = "pj-meet-week-auto";
+ span.dataset.tip = "실적 모듈 " + (slot.dataset.name || "") + " 이번 주(" + wk + "~ 오늘까지) 매출" +
+ (target ? " · 정량 목표 " + target.toLocaleString("ko-KR") + "원 대비" : "");
+ span.textContent = "이번주 실적 " + auto.toLocaleString("ko-KR") + (target ? " · " + Math.round(auto / target * 100) + "%" : "");
+ slot.innerHTML = "";
+ slot.appendChild(span);
+ }
+
// ── 회의록 매출 자료 갱신 — 주차를 열면 실적 모듈 [매출 업데이트](지난주 월요일 ~ 이번 주 오늘, 백그라운드)를 한 번 더
- // 돌리고, 끝나면 이 화면을 서버에서 다시 그려 숫자 칸만 바꿔 끼운다(입력 중인 칸·저장 안 된 글은 건드리지 않는다).
- // 같은 주는 10분에 한 번만 자동(새로고침마다 쇼핑몰 API 를 부르지 않게). 다른 업데이트가 돌면 그게 끝나길 기다려 다시 그림.
- // 상태 줄·[매출 갱신] 버튼은 2026-10-01 요청으로 뺐다(#pj-meet-sync 는 기간만 가진 숨은 요소) — 있으면 쓰고 없으면 조용히.
+ // 돌리고, 끝나면 숫자 칸만 다시 그린다(meetRepaint). 같은 주는 10분에 한 번만 자동(새로고침마다 쇼핑몰 API 를 부르지 않게).
+ // 이미 다른 매출 업데이트가 돌면 그 작업에 합류해 끝나길 기다리고, 그 작업이 이 주 기간을 다 덮지 못했으면 한 번 더 부른다.
+ // 화면: 정상이면 아무것도 보이지 않는다(2026-10-01 요청 — 큰 상태 줄 없음). 실패·일부 쇼핑몰 실패·권한 없음일 때만 작은
+ // 안내(#pj-meet-sync) — 실패한 쇼핑몰 이름, 서버가 기록한 마지막 갱신 성공 시각(data-fresh, 가장 오래된 쇼핑몰 기준), [다시 시도].
+ // 권한 없음(data-can="0")은 서버가 미리 알려 주므로 API 를 부르지 않는다. 브라우저 시각은 10분 제한 계산에만 쓰고 보여 주지 않는다.
function initMeetingSync(pane) {
const box = el("pj-meet-sync");
if (!box) return;
- const text = box.querySelector(".pj-meet-sync-text"); // 상태 줄(없을 수 있음)
+ const text = box.querySelector(".pj-meet-sync-text");
const btn = el("pj-meet-sync-btn");
const KEY = "pj_meet_sync:" + pane.dataset.week;
const THROTTLE_MS = 10 * 60 * 1000;
let running = false;
- function say(msg, cls) {
- if (!text) return;
- text.textContent = msg;
- box.classList.remove("is-running", "is-done", "is-warn");
- if (cls) box.classList.add(cls);
+ function show(kind, msg, retry) {
+ box.hidden = false;
+ box.dataset.state = kind;
+ if (text) text.textContent = msg;
+ if (btn) btn.hidden = !retry;
}
- function hhmm(d) { return String(d.getHours()).padStart(2, "0") + ":" + String(d.getMinutes()).padStart(2, "0"); }
- // 서버가 새로 그린 화면에서 숫자 칸만 옮겨 온다(입력칸이 있는 카드·칸은 안내 문구만)
- async function repaint() {
- const res = await fetch(location.href, { credentials: "same-origin" });
- if (!res.ok) throw new Error("화면을 다시 읽지 못했습니다(" + res.status + ")");
- const doc = new DOMParser().parseFromString(await res.text(), "text/html");
- const swap = function (sel) {
- const now = document.querySelectorAll(sel), fresh = doc.querySelectorAll(sel);
- if (now.length !== fresh.length) return false;
- now.forEach(function (n, i) {
- if (n.querySelector("input, textarea, select")) {
- const a = n.querySelector(".pj-meet-sub-slot"), b = fresh[i].querySelector(".pj-meet-sub-slot");
- if (a && b) a.innerHTML = b.innerHTML;
- return;
- }
- n.innerHTML = fresh[i].innerHTML;
- });
- return true;
- };
- swap(".pj-meet-kpi");
- document.querySelectorAll("#pj-meet-table tr[data-item]").forEach(function (tr) {
- const ftr = doc.querySelector('#pj-meet-table tr[data-item="' + tr.dataset.item + '"]');
- if (!ftr) return;
- [".pj-meet-c-result", "[data-rate]", ".pj-meet-week-slot"].forEach(function (sel) {
- const a = tr.querySelector(sel), b = ftr.querySelector(sel);
- if (!a || !b) return;
- if (a.querySelector("input:focus")) return; // 결과를 입력하는 중
- if (a.querySelector("input") && b.querySelector("input")) return; // 직접 입력 칸은 그대로
- a.innerHTML = b.innerHTML;
- });
- });
+ function hide() { box.hidden = true; delete box.dataset.state; }
+ function freshText() {
+ const f = box.dataset.fresh;
+ return f ? " · 저장된 실적의 마지막 갱신 성공 " + f + "(가장 오래된 쇼핑몰 기준)" : " · 저장된 실적의 갱신 성공 기록 없음";
+ }
+ function report(rec) {
+ if (!rec || rec.state === "ok") { hide(); return; }
+ if (rec.state === "partial") show("partial", "일부 쇼핑몰 매출을 새로 받지 못했습니다: " + rec.bad.join(", ") + freshText(), true);
+ else if (rec.state === "noperm") show("noperm", "실적 모듈 권한이 없어 쇼핑몰 매출을 새로 받지 않고 저장된 실적으로 보여 줍니다" + freshText(), false);
+ else show("error", "쇼핑몰 매출 갱신 실패 — " + (rec.msg || "알 수 없는 오류") + freshText(), true);
+ }
+ function remember(rec) { try { sessionStorage.setItem(KEY, JSON.stringify(rec)); } catch (_) {} }
+ function recall() {
+ try {
+ const raw = sessionStorage.getItem(KEY);
+ if (!raw) return null;
+ if (/^\d+$/.test(raw)) return { at: Number(raw), state: "ok" }; // 예전 기록(시각만)
+ return JSON.parse(raw);
+ } catch (_) { return null; }
+ }
+ if (box.dataset.can !== "1") { report({ state: "noperm" }); return; }
+ async function waitJob(job) {
+ while (!job.finished) {
+ await new Promise(function (ok) { setTimeout(ok, 1000); });
+ job = (await api("GET", "/performance/api/sync/jobs/" + encodeURIComponent(job.id))).job;
+ }
+ return job;
}
async function run(force) {
if (running) return;
if (!force) {
- try {
- const last = Number(sessionStorage.getItem(KEY) || 0);
- if (Date.now() - last < THROTTLE_MS) { say("매출 자료 갱신됨 " + hhmm(new Date(last)) + " (10분 안에는 다시 받지 않음)", "is-done"); return; }
- } catch (_) {}
+ const last = recall();
+ if (last && (last.state === "noperm" || Date.now() - (last.at || 0) < THROTTLE_MS)) { report(last); return; }
}
running = true;
if (btn) btn.disabled = true;
- say("쇼핑몰에서 매출 자료를 다시 받는 중…", "is-running");
+ if (force) show("running", "쇼핑몰 매출을 다시 받는 중…", false); // 직접 누른 재시도만 진행 표시
+ let rec;
try {
- let r = await api("POST", "/performance/api/sync", { from: box.dataset.from, to: box.dataset.to, background: true });
- const joined = r.joined;
- let job = r.job;
- while (!job.finished) {
- const o = job.overall || {};
- say((joined ? "다른 매출 업데이트 진행 중 — " : "매출 자료 다시 받는 중 — ") + (o.finished || 0) + "/" + (o.shops || 0) +
- " 쇼핑몰" + (o.items ? " · 받은 자료 " + Number(o.items).toLocaleString("ko-KR") + "건" : ""), "is-running");
- await new Promise(function (ok) { setTimeout(ok, 1000); });
- job = (await api("GET", "/performance/api/sync/jobs/" + encodeURIComponent(job.id))).job;
+ const want = { from: box.dataset.from, to: box.dataset.to };
+ let r = await api("POST", "/performance/api/sync", { from: want.from, to: want.to, background: true });
+ let job = await waitJob(r.job);
+ // 다른 사람이 돌리던 업데이트에 합류했는데 그 기간이 이 주를 다 덮지 못하면 이 주 기간으로 한 번 더
+ if (r.joined && !(job.from && job.to && job.from <= want.from && job.to >= want.to)) {
+ r = await api("POST", "/performance/api/sync", { from: want.from, to: want.to, background: true });
+ job = await waitJob(r.job);
}
- await repaint();
- try { sessionStorage.setItem(KEY, String(Date.now())); } catch (_) {}
- const bad = (job.shops || []).filter(function (s) { return s.state === "error"; })
+ await meetRepaint();
+ const bad = (job.shops || []).filter(function (s) { return s.active !== false && (s.state === "error" || s.state === "cancelled"); })
.map(function (s) { return s.name + (s.label ? "(" + s.label + ")" : ""); });
- say("매출 자료 갱신 " + hhmm(new Date()) + " · " + Number((job.overall || {}).upserted || 0).toLocaleString("ko-KR") + "건 반영" +
- (bad.length ? " · 실패: " + bad.join(", ") : ""), bad.length ? "is-warn" : "is-done");
+ rec = job.error ? { state: "error", msg: job.error } : bad.length ? { state: "partial", bad: bad } : { state: "ok" };
} catch (e) {
- say(e.status === 403 ? "실적 권한이 없어 저장된 실적으로 보여 줍니다" : "매출 갱신 실패: " + e.message, "is-warn");
+ rec = e.status === 403 ? { state: "noperm" } : { state: "error", msg: e.message };
} finally {
running = false;
if (btn) btn.disabled = false;
}
+ rec.at = Date.now();
+ remember(rec);
+ report(rec);
}
if (btn) btn.addEventListener("click", function () { run(true); });
run(false);
@@ -8981,18 +9320,56 @@
const meetingUrl = "/project/api/goals/meetings/" + week;
function itemUrl(id) { return "/project/api/goals/meeting-items/" + id; }
- // ── 머리 — 금주 목표·참석자·메모 ──
+ // ── 금액 칸(금주 목표 · 줄 정량 목표 · 지난주 결과) — Enter·칸 떠남에 저장(createFieldSaver: 같은 칸 요청 차례대로).
+ // 서버 확정값(원 정수)을 쉼표 표기로 칸에 넣는 건 요청 뒤 입력이 그대로일 때만 — 그 사이 다시 입력한 초안은 덮지 않는다.
+ // 실패해도 입력값은 그대로(빨간 테두리), Esc = 저장된 값으로. 비율(달성률·이번주 실적 %)은 서버 확정값으로 바로 다시 계산.
+ // 금주 목표 저장 뒤 머리 숫자는 페이지 새로고침 없이 숫자 칸만 다시 그린다(meetRepaint — 다른 칸의 저장 안 된 글 보존).
const tgt = el("pj-meet-target");
- if (tgt) {
- tgt.dataset.saved = tgt.value;
- tgt.addEventListener("keydown", function (e) { if (e.key === "Enter") { e.preventDefault(); tgt.blur(); } });
- tgt.addEventListener("change", async function () {
- try {
- await api("PUT", meetingUrl, { week_target: tgt.value });
- reloadKeepScroll(); // 달성률·필요 매출 문구를 서버 계산으로 다시
- } catch (e) { tgt.value = tgt.dataset.saved; showToast("저장 실패: " + e.message, "error"); }
+ const amtSaver = createFieldSaver({
+ read: function (inp) { return inp.value; },
+ write: function (inp, v) { inp.value = v; },
+ unload: "warn",
+ send: function (inp, v, o) {
+ if (inp === tgt) return api("PUT", meetingUrl, { week_target: v }, o);
+ const tr = inp.closest("tr"), body = {};
+ body[inp.dataset.field] = v;
+ return api("PUT", itemUrl(inp.dataset.target === "prev" ? tr.dataset.prev : tr.dataset.item), body, o);
+ },
+ onSaved: function (inp, v, res, same) {
+ const cell = inp.closest("td") || inp.closest(".pj-meet-kpi");
+ clearSaveFailed(cell);
+ flashSaved(cell);
+ let confirmed;
+ if (inp === tgt) {
+ confirmed = res && Object.prototype.hasOwnProperty.call(res, "week_target") ? res.week_target : undefined;
+ meetRepaint().catch(function () {}); // 금주 현재 실적의 "목표의 %"·필요 매출 — 서버 계산으로
+ } else {
+ const tr = inp.closest("tr");
+ confirmed = res.item[inp.dataset.field];
+ if (inp.dataset.field === "result_amount") paintRate(tr, res.item.result_amount);
+ if (inp.dataset.field === "target_amount") {
+ tr.dataset.targetAmount = confirmed == null ? "" : String(confirmed);
+ paintMeetWeek(tr);
+ }
+ }
+ if (!same || confirmed === undefined) return undefined; // 요청 뒤 새로 입력 중 — 그 초안을 그대로
+ inp.value = won(confirmed);
+ return inp.value;
+ },
+ onFail: function (inp, err) { markSaveFailed(inp.closest("td") || inp.closest(".pj-meet-kpi"), err); },
+ });
+ function bindAmount(inp) {
+ amtSaver.track(inp, inp.value);
+ inp.addEventListener("focus", function () { inp.select(); });
+ inp.addEventListener("keydown", function (e) {
+ if (isImeEnter(e)) return;
+ if (e.key === "Enter") { e.preventDefault(); if (document.activeElement === inp) inp.blur(); else amtSaver.flush(inp).catch(function () {}); }
+ else if (e.key === "Escape") { inp.value = amtSaver.savedOf(inp); inp.blur(); }
});
+ inp.addEventListener("change", function () { amtSaver.flush(inp).catch(function () {}); });
+ inp.addEventListener("blur", function () { amtSaver.flush(inp).catch(function () {}); });
}
+ if (tgt) bindAmount(tgt);
// ── 참석자 — 전체 멤버에서 고르기(칩 + 고르기 창, 창은 body 에). 바뀔 때마다 이메일(예전 글자는 그대로)을 쉼표로 이어 저장 ──
const attBox = el("pj-meet-attend");
if (attBox && attBox.dataset.edit) {
@@ -9094,52 +9471,49 @@
});
}
- // ── 글 칸(이번주 할 일·메모) — 멈추면 저장 ──
- const pending = new Map(); // textarea → {timer, save}
- function queue(ta, save) {
- const p = pending.get(ta);
- if (p) clearTimeout(p.timer);
- pending.set(ta, { timer: setTimeout(function () { flush(ta); }, 800), save: save });
- }
- async function flush(ta) {
- const p = pending.get(ta);
- if (!p) return;
- clearTimeout(p.timer);
- pending.delete(ta);
- if (ta.value === ta.dataset.saved) return;
- try { await p.save(ta.value); ta.dataset.saved = ta.value; flashSaved(ta.closest("td") || ta); }
- catch (e) { showToast("저장 실패: " + e.message, "error"); }
- }
- function flushAll() { return Promise.all(Array.from(pending.keys()).map(flush)); }
+ // ── 글 칸(이번주 할 일·메모) — 0.8초 멈춤·칸 떠남에 저장(createFieldSaver).
+ // 보낸 값만 저장됨으로 기록하고, 같은 칸 요청은 차례대로(진행 중에 새로 쓴 글은 뒤이어 저장). 실패해도 글은 그대로 두고
+ // 다음 입력·칸 떠남·줄 작업 전에 다시 보낸다. 초안은 localStorage(pj_draft:meet:…)에도 — 페이지가 닫혀도 다음에 되살린다.
const notes = el("pj-meet-notes");
- if (notes) {
- notes.dataset.saved = notes.value;
- const save = function (v) { return api("PUT", meetingUrl, { notes: v }); };
- notes.addEventListener("input", function () { fit(notes); queue(notes, save); });
- notes.addEventListener("blur", function () { flush(notes); });
- fit(notes);
- }
- if (table) table.querySelectorAll("textarea.pj-meet-text").forEach(function (ta) {
- ta.dataset.saved = ta.value;
- const id = ta.closest("tr").dataset.item;
- const save = function (v) { return api("PUT", itemUrl(id), { content: v }); };
- fit(ta);
- ta.addEventListener("input", function () { fit(ta); queue(ta, save); });
- ta.addEventListener("blur", function () { flush(ta); });
+ const textSaver = createFieldSaver({
+ read: function (ta) { return ta.value; },
+ write: function (ta, v) { ta.value = v; fit(ta); },
+ send: function (ta, v, o) {
+ return ta === notes ? api("PUT", meetingUrl, { notes: v }, o)
+ : api("PUT", itemUrl(ta.closest("tr").dataset.item), { content: v }, o);
+ },
+ draftKey: function (ta) {
+ return ta === notes ? "meet:notes:" + week : "meet:item:" + ta.closest("tr").dataset.item + ":content";
+ },
+ onSaved: function (ta) { const n = ta.closest("td") || ta; clearSaveFailed(n); flashSaved(n); },
+ onClear: function (ta) { clearSaveFailed(ta.closest("td") || ta); },
+ onFail: function (ta, err) { markSaveFailed(ta.closest("td") || ta, err); },
});
- window.addEventListener("resize", function () { document.querySelectorAll("textarea.pj-meet-text, #pj-meet-notes").forEach(fit); });
- window.addEventListener("beforeunload", function () {
- pending.forEach(function (p, ta) {
- clearTimeout(p.timer);
- if (ta.value === ta.dataset.saved) return;
- const isNotes = ta.id === "pj-meet-notes";
- try {
- fetch(isNotes ? meetingUrl : itemUrl(ta.closest("tr").dataset.item), {
- method: "PUT", keepalive: true, headers: { "Content-Type": "application/json" },
- body: JSON.stringify(isNotes ? { notes: ta.value } : { content: ta.value }),
- });
- } catch (_) {}
+ function flushAll() {
+ return Promise.allSettled([textSaver.flushAll(), amtSaver.flushAll()]).then(function (rs) {
+ const bad = rs.find(function (r) { return r.status === "rejected"; });
+ if (bad) throw bad.reason;
+ return true;
});
+ }
+ let restored = 0, conflict = 0;
+ function bindText(ta) {
+ const r = textSaver.track(ta, ta.value);
+ if (r === "restored") restored++;
+ else if (r === "conflict") conflict++;
+ fit(ta);
+ ta.addEventListener("input", function () { fit(ta); textSaver.queue(ta); });
+ ta.addEventListener("blur", function () { textSaver.flush(ta).catch(function () {}); });
+ }
+ if (notes) bindText(notes);
+ if (table) table.querySelectorAll("textarea.pj-meet-text").forEach(bindText);
+ if (restored) showToast("저장되지 않았던 글 " + restored + "칸을 되살려 다시 저장합니다.");
+ else if (conflict) showToast("다른 곳에서 바뀐 칸 " + conflict + "개는 예전 초안을 되살리지 않았습니다.");
+ window.addEventListener("resize", function () { document.querySelectorAll("textarea.pj-meet-text, #pj-meet-notes").forEach(fit); });
+ // 페이지 떠남 — 글은 keepalive 로 한 번 더 보내고(보장 아님, 초안 백업이 남음), 실패·진행 중·금액 미저장이면 이탈 경고
+ window.addEventListener("beforeunload", function (e) {
+ textSaver.onBeforeUnload(e);
+ amtSaver.onBeforeUnload(e);
});
if (!table) return;
@@ -9161,28 +9535,8 @@
const r = Math.round(result / target * 1000) / 10;
td.innerHTML = '' + r.toLocaleString("ko-KR") + "%";
}
- // ── 금액 칸 — 이번주 목표 금액(이 줄) · 지난주 결과(지난 회의록 줄) ──
- table.querySelectorAll("input.pj-meet-amount").forEach(function (inp) {
- inp.dataset.saved = inp.value;
- inp.addEventListener("focus", function () { inp.select(); });
- inp.addEventListener("keydown", function (e) {
- if (e.key === "Enter") { e.preventDefault(); inp.blur(); }
- else if (e.key === "Escape") { inp.value = inp.dataset.saved; inp.blur(); }
- });
- inp.addEventListener("change", async function () {
- const tr = inp.closest("tr");
- const toPrev = inp.dataset.target === "prev";
- const body = {};
- body[inp.dataset.field] = inp.value;
- try {
- const res = await api("PUT", itemUrl(toPrev ? tr.dataset.prev : tr.dataset.item), body);
- inp.value = won(res.item[inp.dataset.field]);
- inp.dataset.saved = inp.value;
- if (toPrev) paintRate(tr, res.item.result_amount);
- flashSaved(inp.closest("td"));
- } catch (e) { inp.value = inp.dataset.saved; showToast("저장 실패: " + e.message, "error"); }
- });
- });
+ // ── 금액 칸 — 이번주 정량 목표(이 줄) · 지난주 결과(7일 전 주 회의록의 같은 줄) — amtSaver(위) ──
+ table.querySelectorAll("input.pj-meet-amount").forEach(bindAmount);
// ── 평가(지난주 줄) ──
table.querySelectorAll("select.pj-meet-eval").forEach(function (selEl) {
selEl.addEventListener("change", async function () {
@@ -9234,8 +9588,10 @@
});
// ── 줄 메뉴(⋯ · 항목 우클릭) — 위/아래 줄 추가 · 순서 · 쇼핑몰 연결 · 삭제 ──
+ // 줄 작업 뒤엔 새로고침 — 그 전에 저장 안 된 칸(대기·진행 중·실패)을 저장하고, 실패하면 작업 자체를 하지 않는다(초안 유지)
async function run(fn) {
try {
+ await flushAll();
if (!(await fn())) return;
await flushAll();
reloadKeepScroll();
diff --git a/docs/PROJECT_MODULE.md b/docs/PROJECT_MODULE.md
index 9c06d7a..74df709 100644
--- a/docs/PROJECT_MODULE.md
+++ b/docs/PROJECT_MODULE.md
@@ -301,6 +301,11 @@ docker exec -i postgres-db psql -U postgres -d project_db \
< scripts/sql/project_db_015_goal_rect_merges_meetings.sql
docker exec -i postgres-db psql -U postgres -d project_db \
< scripts/sql/project_db_016_goal_row_label_groups.sql
+docker exec -i postgres-db psql -U postgres -d project_db \
+ < scripts/sql/project_db_017_goal_quarters.sql
+# 018 = 주간 회의록 줄 연결키(line_key) — 적용 전 백업, 적용·확인 방법은 6-9-3
+docker exec -i postgres-db psql -U postgres -d project_db \
+ < scripts/sql/project_db_018_meeting_line_keys.sql
# 4) 재배포 (git pull 후 반드시 --build)
cd /opt/www/main && docker compose up -d --build web
@@ -516,9 +521,11 @@ description 을 항상 HTML로 취급하기 때문). 두 번 실행하면 이중
`PUT|DELETE /api/goals/areas/{id}` · `POST /api/goals/areas/{id}/move` `{direction:-1|1}` · `POST /api/goals/areas/{id}/rows` `{label, ref_row_id?, place?: above|below}`(기준 줄 위/아래, 없으면 맨 끝) ·
`PUT|DELETE /api/goals/rows/{id}` · `POST /api/goals/rows/{id}/move` · `PUT /api/goals/rows/{id}/cells/{month}` `{body}`.
013 미적용 503, 없는 대상 404, 입력 오류 400(`_goal_call`).
-- 화면 동작(`initGoals`): 숫자 칸은 Enter/칸 떠남에 저장(Esc 취소), 글 칸은 0.8초 멈춤·칸 떠남·페이지 떠남(keepalive)에 저장,
- 저장되면 칸 테두리가 잠깐 초록. 영역/줄 추가·이름·순서·삭제는 저장 뒤 새로고침(스크롤 위치 sessionStorage 로 되살림),
- 영역 색은 팝업(body 에 붙임)에서 바로 바뀜. 목표 테이블은 live-version 트리거에 넣지 않았다(입력 중 새로고침 방지).
+- 화면 동작(`initGoals`): 숫자 칸은 Enter/칸 떠남에 저장(Esc = 저장된 값으로), 글 칸은 0.8초 멈춤·칸 떠남에 저장,
+ 저장되면 칸 테두리가 잠깐 초록, 실패하면 빨간 테두리(입력값 유지). 저장은 공용 `createFieldSaver`(6-9-3 — 같은 칸 요청 직렬화,
+ 보낸 값만 저장됨으로, 실패 시 초안 유지·localStorage 초안 백업, 페이지 떠남 보호). 영역/줄 추가·순서·삭제·병합은 먼저 저장 안 된
+ 글을 저장하고(실패하면 작업 중단) 그 자리에서 다시 그림(`refreshTable`), 영역 색은 팝업(body 에 붙임)에서 바로 바뀜.
+ 목표 테이블은 live-version 트리거에 넣지 않았다(입력 중 새로고침 방지).
- 추후: 매출 실적을 실적 모듈(`performance_db`)에서 월별로 자동으로 채우기.
### 6-9-0. 1~4분기 칸 (마이그레이션 017, 2026-10-01 — 상·하반기 대신)
@@ -563,7 +570,12 @@ description 을 항상 HTML로 취급하기 때문). 두 번 실행하면 이중
- **영역·줄 이름 바로 수정**(관리자) — 이름(`[data-goal-edit="area|row"]`)을 누르면 contenteditable(`startNameEdit`) —
Enter·칸 떠남 = 저장, Esc = 취소, 붙여넣기는 글자만. 영역 이름 빈 값은 되돌림(서버도 400), 줄 이름은 빈 값 허용(빈 줄 이름은
마우스를 올리면 "줄 이름" 자리 표시). 예전 ✎(prompt) 버튼은 없앴다. 색·순서·줄 추가·삭제는 우클릭 메뉴(아래).
-- **구역·항목 칸 메뉴 = 우클릭**(2026-10-01) — 마우스 오버 도구 막대(색·↑·↓·+·×)는 뺐다(옆 칸으로 갈 때 걸리거나 고정되는 문제).
+- **구역·항목 칸 메뉴 = 우클릭 + ⋮ 버튼**(2026-10-01) — 마우스 오버 도구 막대(색·↑·↓·+·×)는 뺐다(옆 칸으로 갈 때 걸리거나 고정되는 문제).
+ 대신(점검 UX 8) 칸 오른쪽 위 작은 ⋮ 버튼(`.pj-goal-menu-btn`, 관리자만, `data-goal-menu="area|row"`) — absolute 라 자리를 차지하지 않고
+ 평소 투명, 칸에 마우스·포커스가 오면 보임, 터치 화면(`hover: none`)은 늘 옅게(0.7). 우클릭과 **같은 메뉴**(`openAreaMenu`·`openRowLabelMenu`).
+ 접근성: 버튼 `aria-label="{이름} 구역 메뉴|줄 메뉴"`·`aria-haspopup="menu"`·`aria-expanded`, Tab → Enter/Space 로 열면 첫 항목 포커스,
+ 메뉴(`showContextMenu` 공용, `role=menu`/`menuitem`) 안 ↑↓·Home·End·Enter, Esc·Tab = 닫고 버튼으로 포커스 복귀, 같은 버튼 다시 누르면 닫힘.
+ 이름 칸(`[data-goal-edit]`)도 `tabindex=0` — Enter·F2 = 이름 수정(한글 조합 중 Enter 무시).
1열(구역 칸) 우클릭(`areaMenuItems` → `goalAct`): 색 바꾸기(색 창은 우클릭한 자리, 현재 색은 `tbody[data-color]`) · 위로 · 아래로
(맨 위·맨 아래면 없음) · 줄 추가(구역 맨 아래) · 영역 삭제. 2열(항목 칸) 우클릭(`rowMenuItems`): 위/아래에 줄 추가 · **위로 · 아래로**
(묶이지 않은 칸만) · 항목 칸 나누기(묶인 칸) · 줄 삭제. 이름은 눌러서 바로 수정(그대로).
@@ -646,19 +658,34 @@ description 을 항상 HTML로 취급하기 때문). 두 번 실행하면 이중
금주 현재 실적. 실적·누적·결과는 **실적 모듈 `performance_store.daily_amounts`(대시보드 총매출과 같은 값, 매출 집계 쇼핑몰)** 에서
읽기만 한다 — 실적 모듈이 없거나 오류면 빈칸("직접 입력" 안내), 회의록은 그대로 동작.
숫자는 **한 줄 막대**(`.pj-meet-kpibar`, 칸 9개·값 15px, 좁은 화면 1300px 이하 두 줄) — 긴 설명은 말풍선(`title`).
- - 표 머리 "지난주 리뷰 (MM/DD ~ MM/DD)" = 지난주 월~일(`prev_week`·`prev_week_end`).
+ **실적을 알 수 없으면 0 원이 아니라 "⚠ 미확인"**(6-9-3 — `head.perf_state`·`head.unknown`), 그 값에 기대는 달성 %·주당 필요 매출도 미확인.
+ 실적 칸 말풍선 = 쇼핑몰별 마지막 갱신 성공 시각(실적 모듈 `perf_connection_status.last_success_sync_at`, `head.fresh_tip`).
+ - 표 머리 "지난주 리뷰 (MM/DD ~ MM/DD)" = 지난주 월~일(`prev_week`·`prev_week_end`) — **줄의 지난주 칸·결과·달성률·머리 전주 목표도 정확히 이
+ 주(7일 전) 회의록만**(그 주 회의록이 없으면 머리에 "— 이 주 회의록 없음", 줄은 "지난주(MM/DD~) 회의록 없음", 회의록은 있는데 그 줄이 없으면
+ "지난주 회의록에 없는 줄"). 예전엔 몇 주 전 회의록 줄이 지난주 날짜 아래 보였다(점검 버그 5).
- 첫 회의록 기본 줄 마케팅 "메타"(예전 "메타(숫자)" — 017 이 그 이름 줄만 "메타"로 바꿈).
- **{월}월 계획**(`router._month_plan`, `.pj-meet-plan`, 머리 왼쪽 `.pj-meet-headleft` 안 — 제목 줄 아래·달력 왼쪽): 연간 목표 표의 그 달 열 글을 업무 영역별 작은 카드로
(영역 색, `항목: 글`, 빈 칸·글 없는 영역은 뺌). 가로 병합 칸(예: 9~10월)에 적은 글도 그 달 계획으로 보이고 범위를 오른쪽에 작게,
세로 병합은 한 번만, 묶인 줄(016 `label_cont`)은 묶음 항목 이름. 목표 표가 없으면(013 미적용) 칸 자체를 숨김, 읽기만.
- **줄**(구역 = 목표 표 업무 영역, 표의 구역 칸 rowspan): 항목 | **이번주 할 일·행사** | **정량 목표**(원, 예전 이름 "목표 금액") ‖ 지난주 리뷰: 지난주 할 일 |
- 지난주 목표 | **결과** | 달성률 | **평가**(— · 완료 · 일부 · 미달). 지난주 칸 = 이 줄의 `carry_from`(지난 회의록 같은 줄).
+ 지난주 목표 | **결과** | 달성률 | **평가**(— · 완료 · 일부 · 미달). 지난주 칸 = **7일 전 주 회의록에서 같은 연결키(`line_key`, 018)의 줄**
+ (예전 `carry_from` 은 이력으로만 — 6-9-3).
결과는 그 줄이 **쇼핑몰 연결**(`marketplace_code`)이면 실적 모듈의 그 주(지난 회의록 주 월~일) 그 쇼핑몰 매출 **자동**("자동" 표시),
아니면 직접 입력 — **지난 회의록 줄의 `result_amount`·`status` 에 저장**(그 주 결과는 그 주 줄에 남는다). 달성률은 저장 즉시 화면 계산.
지난 회의록 주가 아직 시작 전이면 "진행 전"(0 으로 보이지 않게), 연결한 쇼핑몰이 실적 모듈에서 사용 중이 아니면(사용 OFF·없는 코드)
"실적 미사용" 표시 + 직접 입력. 자동 결과 말풍선 = 쇼핑몰·기간, 0 이면 "그 기간 실적 없음 — [매출 업데이트]" 안내.
- 쇼핑몰 연결 줄은 정량 목표 아래에 **이번주 실적**(이 주 월요일~오늘, 목표 대비 %)도 보인다.
- - **매출 자료 갱신**(`initMeetingSync`, **화면 표시 없음** — 2026-10-01 상태 줄·[매출 갱신] 버튼은 요청으로 뺐고 `#pj-meet-sync` 는 기간만 가진 숨은 요소): 주차를 열면 실적 모듈 `POST /performance/api/sync {from: 지난주 월요일, to: 이번 주 일요일·오늘 중 이른 날, background: true}` 로 쇼핑몰에서 매출을 한 번 더 받고(진행 n/m 쇼핑몰·받은 자료), 끝나면 이 화면을 서버에서 다시 받아 **숫자 칸만** 바꿔 끼운다(머리 카드·자동 결과·달성률·이번주 실적 — 입력 중인 칸·직접 입력 결과 칸·저장 안 된 글은 그대로). 같은 주는 브라우저별 10분에 한 번만 자동(sessionStorage `pj_meet_sync:{월요일}` — 줄 추가 등으로 새로고침해도 다시 부르지 않음), [매출 갱신] 버튼은 언제나. 이미 다른 매출 업데이트가 돌면 그 작업이 끝나길 기다린다. 실적 권한이 없으면 저장된 실적으로 보여 준다는 안내, 실패한 쇼핑몰은 이름·상태. 지난주가 아직 오지 않은 주(미래)는 갱신 줄이 없다.
+ 쇼핑몰 연결 줄은 정량 목표 아래에 **이번주 실적**(이 주 월요일~오늘, 목표 대비 %)도 보인다 — % 는 화면이 실적(`slot data-auto`)과
+ **서버 확정 정량 목표**(`tr data-target-amount`)로 계산(`paintMeetWeek`): 목표 저장 즉시 다시 계산(100→200 이면 100%→50%), 목표 0·빈칸이면
+ % 없음, 실적 조회 실패면 "이번주 실적 미확인", 저장 실패면 확정값 그대로. 다시 그리기(`meetRepaint`)는 실적 값만 옮겨 와 같은 방식으로 계산하고
+ 차례 번호(`meetRepaintSeq`)로 늦게 온 옛 화면을 버린다 — 목표 저장과 엇갈려도 옛 비율이 들어오지 않는다(점검 버그 7).
+ - **매출 자료 갱신**(`initMeetingSync`, **정상이면 화면 표시 없음** — 2026-10-01 상태 줄·[매출 갱신] 버튼은 요청으로 뺐다. 점검 UX 9 로
+ 실패·일부 실패·권한 없음일 때만 숫자 막대 아래 한 줄 안내 `#pj-meet-sync.pj-meet-syncnote`(`data-state=error|partial|noperm|running`) +
+ [다시 시도] — 실패한 쇼핑몰 이름(상태), **서버가 기록한** 마지막 갱신 성공 시각(`data-fresh` = 매출 집계 쇼핑몰 중 가장 오래된 성공 시각,
+ 다시 그릴 때 서버 값으로 바뀜. 브라우저 시각은 10분 제한 계산에만 쓰고 보여 주지 않음). 기록 `sessionStorage pj_meet_sync:{월요일}` =
+ `{at, state: ok|partial|error|noperm, bad}` — 일부 실패를 성공으로 기록하지 않고, 10분 안 다시 열면 부르지 않되 그 상태 안내는 유지.
+ 실적 모듈 권한은 서버가 미리 알려 줘(`can_sync` → `data-can`) 권한이 없으면 API 를 부르지 않고 "권한이 없어 저장된 실적" 설명, 그래도 403 이면
+ noperm 으로 기억해 그 세션엔 다시 부르지 않음. 다른 업데이트에 합류(`joined`)했는데 그 작업 기간이 이 주 기간을 다 덮지 못하면 이 주 기간으로
+ 한 번 더. 아래는 예전 설명(동작은 같음): 주차를 열면 실적 모듈 `POST /performance/api/sync {from: 지난주 월요일, to: 이번 주 일요일·오늘 중 이른 날, background: true}` 로 쇼핑몰에서 매출을 한 번 더 받고(진행 n/m 쇼핑몰·받은 자료), 끝나면 이 화면을 서버에서 다시 받아 **숫자 칸만** 바꿔 끼운다(머리 카드·자동 결과·달성률·이번주 실적 — 입력 중인 칸·직접 입력 결과 칸·저장 안 된 글은 그대로). 같은 주는 브라우저별 10분에 한 번만 자동(sessionStorage `pj_meet_sync:{월요일}` — 줄 추가 등으로 새로고침해도 다시 부르지 않음), [매출 갱신] 버튼은 언제나. 이미 다른 매출 업데이트가 돌면 그 작업이 끝나길 기다린다. 실적 권한이 없으면 저장된 실적으로 보여 준다는 안내, 실패한 쇼핑몰은 이름·상태. 지난주가 아직 오지 않은 주(미래)는 갱신 줄이 없다.
- **참석자 = 전체 멤버에서 고르기**(2026-10-01): 칩(사진·이름, × = 빼기) + [참석자] 고르기 창(찾기·전원 선택·모두 해제·체크) —
후보는 `project` 모듈 권한 보유 등록 사용자(`router._meet_members`, 좌측 전체 멤버와 같음). 저장은 이메일을 쉼표로 이어 그대로
`goal_meetings.attendees`(최대 3000자), 예전 자유 입력 글자는 칩으로 남는다(`_parse_attendees`). 바뀔 때마다 바로 저장.
@@ -666,20 +693,77 @@ description 을 항상 HTML로 취급하기 때문). 두 번 실행하면 이중
- 데이터: `goal_meetings(week_start 월요일 PK, week_target 원, attendees, notes)` · `goal_meeting_items(week_start FK CASCADE, section,
section_color, label, content, target_amount, result_amount, status '', done, partial, miss, marketplace_code, carry_from FK SET NULL,
sort_order)`. 금액은 **원 정수** — 입력은 `1,200,000`·`120만`·`1.5억`·`3천만`·`1억2천만` 다 된다(`store.validate_meeting_amount`).
-- **만들기**(관리자, `POST /api/goals/meetings/{월요일} {year}`, GET 에서 자동 생성 안 함): 앞선 가장 가까운 회의록이 있으면 그 줄(구역·이름·
- 색·쇼핑몰 연결·순서)을 글 없이 이어받고 `carry_from` 연결, 없으면 그 해 목표 표 업무 영역마다 **기본 양식 줄**(`store.MEETING_TEMPLATE` —
+- **만들기**(관리자, `POST /api/goals/meetings/{월요일} {year}`, GET 에서 자동 생성 안 함): 줄이 있는 앞선 가장 가까운 회의록, 없으면 **뒤에 있는
+ 가장 가까운 회의록**(다음 주를 먼저 만든 경우)의 줄(구역·이름·색·쇼핑몰 연결·순서)을 글 없이 이어받고 **원본 줄의 연결키(`line_key`)를 그대로**
+ (앞선 원본이면 `carry_from` 도 이력으로 기록), 둘 다 없으면 그 해 목표 표 업무 영역마다 **기본 양식 줄**(`store.MEETING_TEMPLATE` —
상품1~5 / 메타·구글·네이버·기타.신규 / 내용1~5 / 신규 인플루언서·콜라보·쿠팡·네이버·gs·토스·애터미·해외·오프라인·기타, 없는 구역은
빈 줄 하나). **유통** 구역 줄 이름으로 쇼핑몰 연결 추측(`store.guess_meeting_market`: 쿠팡·네이버/스마트스토어·gs·토스·11번가·카페24/자사몰·
롯데·지마켓·카카오·오늘의집 — 마케팅의 "네이버"는 광고라 연결 안 함). 줄 추가 때도 같은 추측.
-- 편집(관리자, 칸별 즉시 저장 — 목표 표와 같은 권한): 글 0.8초 멈춤·칸 떠남·페이지 떠남(keepalive), 금액 Enter·칸 떠남(서버 표기로 바꿈),
- 금주 목표 저장 뒤엔 머리 숫자를 서버 계산으로 다시(새로고침). **항목 우클릭·⋯ 메뉴**: 위/아래에 줄 추가 · 위로/아래로(같은 구역 안) ·
+- 편집(관리자, 칸별 즉시 저장 — 목표 표와 같은 권한, 공용 `createFieldSaver` 6-9-3): 글 0.8초 멈춤·칸 떠남, 금액 Enter·칸 떠남(서버 확정값을
+ 쉼표 표기로 — 요청 뒤 다시 입력 중이면 그 초안 유지), 금주 목표 저장(`PUT` 응답에 확정 `week_target`) 뒤엔 **새로고침 없이** 머리 숫자만 서버
+ 계산으로 다시(`meetRepaint` — 다른 칸의 저장 안 된 글 보존). 줄 작업(추가·순서·쇼핑몰 연결·삭제)은 먼저 저장 안 된 칸을 저장하고, 실패하면
+ 작업하지 않는다(초안 유지). **항목 우클릭·⋯ 메뉴**: 위/아래에 줄 추가 · 위로/아래로(같은 구역 안) ·
쇼핑몰 연결(결과 자동)…(연결 안 함 + 실적 모듈 사용 중 쇼핑몰, 현재 값 체크) · 줄 삭제. 구역 칸 + = 그 구역 끝에 줄, [+ 구역 추가].
- 줄 이름은 눌러서 그 자리에서 수정. 회의록 삭제 = 그 주 줄 전부 삭제, 다음 주 회의록의 지난주 칸은 빈다(carry_from NULL).
+ 줄 이름은 눌러서 그 자리에서 수정. 회의록 삭제 = 그 주 줄 전부 삭제, 다음 주 회의록의 지난주 칸은 빈다 — 그 주를 다시 만들면 같은 연결키로
+ 다시 이어진다(새 회의록이라 글은 비어 있음, 018).
- API(관리자, 조회는 `project` 권한자): `GET /api/goals/meetings/{월요일}?year=&month=`(화면과 같은 계산) · `POST|PUT|DELETE
/api/goals/meetings/{월요일}`(PUT `{week_target, attendees, notes}`) · `POST /api/goals/meetings/{월요일}/items {section, label?,
ref_item_id?, place?}` · `PUT|DELETE /api/goals/meeting-items/{id}`(PUT `{label, content, target_amount, result_amount, status,
marketplace_code}`) · `POST /api/goals/meeting-items/{id}/move {direction}`. 015 미적용 503, 월요일 아님·금액 형식 400.
+### 6-9-3. 저장 안전장치 · 지난주 연결 · 실적 미확인 (2026-10-01 점검 반영 — `docs/reviews/GOALS_MEETINGS_REVIEW_2026-10-01.md`, 마이그레이션 018)
+
+**칸별 자동 저장 `createFieldSaver`**(project.js 공용, 목표 표 글·숫자 + 회의록 글·메모·금액·금주 목표 — 버그 1·2·3)
+- 칸마다 `{saved, chain, busy, timer, failed}`. **saved = 성공한 요청에 실어 보낸 값**만(응답 때 바뀌어 있는 화면 값을 저장됨으로 보지 않음).
+- **같은 칸 요청은 직렬화** — 앞 요청이 끝나야 다음 요청을 보내므로 서버에 닿는 쓰기 순서 = 보낸 순서(늦은 옛 요청이 최신 값을 덮지 못함, 응답만
+ 버리는 방식이 아님). 다음 요청은 보낼 때의 최신 초안을 읽어 진행 중에 새로 쓴 값도 뒤이어 저장. 앞 요청이 없으면 그 자리에서(동기) 보낸다.
+- 응답 반영: 서버 표기(쉼표·원 정수)는 **요청 뒤 초안이 그대로일 때만** 칸에 넣는다(`onSaved(..., same)`). 실패하면 초안·dirty 유지 +
+ 빨간 테두리(`is-save-failed`, 말풍선) + 토스트 — 다음 입력·칸 떠남·Enter·`flushAll` 이 다시 보낸다. 숫자 Esc = 저장된 값.
+- `flushAll()` = 대기 타이머 + 진행 중 요청 + 실패했던 칸까지 기다리고 하나라도 실패하면 reject. 목표 표 구조 작업(영역·줄 추가/이동/삭제,
+ 병합/해제)과 회의록 줄 작업은 **먼저 flushAll — 실패하면 구조 요청·표 교체를 하지 않는다**. 목표 표 구조 작업은 한 번에 하나(`withStruct`).
+- 목표 표 `refreshTable`: 시작 전 flush(실패 = throw), 표를 받는 사이 새로 입력한 글이 있으면 저장 후 다시 받기(최대 3번, 바꿔 끼우기 직전 검사는
+ 동기라 그 사이 입력 불가), 계속 입력 중이면 바꿔 끼우지 않고 `pendingRefresh` — 저장이 끝나면 다시 그린다. 이름 고치는 중이어도 기다림.
+- **초안 백업** — 글 칸은 입력할 때마다 `localStorage pj_draft:goal:{줄}:{칸}` · `pj_draft:meet:item:{id}:content` · `pj_draft:meet:notes:{월요일}` =
+ `{base(서버에 저장된 값), draft, at}`, 저장되면 지움(14일 지난 것은 열 때 정리). 다시 열 때 **서버 값 = base 면 되살려 다시 저장**, 서버 값이 바뀌었으면
+ (다른 사람·다른 창) 되살리지 않고 안내.
+- **페이지 떠남**(`beforeunload`): 진행 중 요청이 없는 dirty 글 칸은 `keepalive` PUT 으로 한 번 더 보낸다 — **브라우저가 끝까지 보낸다는 보장은 없어서**
+ 초안 백업이 함께 남는다(keepalive 도 같은 칸 줄에 들어가 순서가 섞이지 않음). 실패했던 칸·진행 중 요청이 있는 칸·Enter 전 숫자 칸이 있으면 브라우저
+ 이탈 경고. 저장이 다 끝났으면 경고 없음.
+
+**지난주 연결 — 연결키 `goal_meeting_items.line_key`(마이그레이션 018, 버그 4·5)**
+- 왜 키인가: 이름(label) 비교는 같은 이름 줄(기타·빈 이름)·다른 구역 같은 이름(마케팅/유통 "네이버")·이름 변경에서 다른 줄 결과가 섞인다.
+ `carry_from`(앞선 회의록 줄 id)은 만들 때 한 방향으로만 생겨 역순 생성·앞 주 삭제/재생성(ON DELETE SET NULL)에서 끊긴다.
+ 키는 **회의록을 만들 때 원본 줄 키를 그대로 이어받고 새 줄은 새 키** → "지난주" = `week_start − 7` 회의록의 같은 키 줄(UNIQUE `(week_start, line_key)`),
+ 생성 순서·이름 변경·순서 이동과 무관, 한 줄이 두 줄에 붙지 않는다.
+- 만들기 원본: 앞선 가장 가까운(줄 있는) 회의록 → 없으면 뒤의 가장 가까운 회의록 → 둘 다 없으면 양식(새 키).
+- **018 적용 전**에도 코드는 동작 — `_meeting_keys` 가 칸 유무를 보고, 없으면 `carry_from` 을 쓰되 **가리키는 줄이 정확히 7일 전 주일 때만** 지난주로
+ (버그 5 는 적용 전에도 고침, 역순 생성 연결(버그 4)은 018 필요). 018 은 `line_key` 기본값(랜덤 키)을 두어 **코드 배포 전에 적용해도** 예전 코드의
+ 줄 추가가 실패하지 않는다(그 줄은 연결 없이 새 키).
+- **018 의 기존 데이터 채우기(자동 복구 범위)**: `carry_from` 사슬을 따라 같은 키(뿌리 = 사슬 맨 앞 줄, `md5('goal_meeting_item:'||id)::uuid` 라 다시 돌려도
+ 같은 키). → 같은 원본(예: 9/14)에서 이어받은 9/28(먼저 만듦)·9/21(나중에 만듦) 줄은 자동으로 다시 이어진다. 이름 바꾼 줄도 사슬이면 이어진다.
+ **자동으로 잇지 않는 것**: `carry_from` 이 없는 줄(첫 회의록 양식 줄·줄 추가·앞 주 삭제로 끊긴 줄) — 이름이 같아도 붙이지 않는다.
+ 예: 9/21·9/28 을 둘 다 앞선 회의록 없이 양식으로 만들었다면 연결 안 됨. 이런 쌍은 `scripts/sql/project_db_018b_meeting_line_link_candidates.sql`
+ (**조회만**)로 "정확히 7일 차이 + 같은 구역·같은 이름이 양쪽 주에 각각 한 줄씩만 + 아직 연결 안 됨" 후보를 보고, 사람이 확인한 쌍만 그 파일 안
+ 주석의 UPDATE 로 따로 잇는다(운영 적용은 별도 승인·백업 후). 한 주 안 같은 키(정상 데이터엔 없음)는 순서가 뒤인 줄에 새 키.
+- 적용(운영은 백업·승인 후, 여러 번 돌려도 안전):
+ ```bash
+ docker exec -i postgres-db psql -U postgres -d project_db < scripts/sql/project_db_018_meeting_line_keys.sql
+ docker exec -i postgres-db psql -U postgres -d project_db -c \
+ "SELECT count(*) AS total, count(line_key) AS keyed FROM goal_meeting_items;" # total = keyed
+ docker exec -i postgres-db psql -U postgres -d project_db < scripts/sql/project_db_018b_meeting_line_link_candidates.sql # 후보 조회만
+ ```
+ 적용 전 확인(조회만): `SELECT week_start, count(*) FILTER (WHERE carry_from IS NULL) AS no_link, count(*) FROM goal_meeting_items GROUP BY 1 ORDER BY 1;`
+
+**실적 미확인(버그 6)** — `router._MeetingPerf`: `state` = `off`(실적 모듈 미연결) · `error`(쇼핑몰 목록 조회 실패) · `empty`(매출 집계 쇼핑몰 없음) · `ok`.
+조회 실패한 값은 None + `head.unknown`(`mtd`·`prev_result`·`week_result`, 기간마다 따로 → 부분 실패), 화면 "⚠ 미확인", 그 값에 기대는 달성 %·주당 필요
+매출도 계산하지 않음. 정상 조회 0건만 0원. 목록 장애면 쇼핑몰 연결 줄 결과 = 미확인(직접 입력 칸으로 바꾸지 않음, "실적 미사용"으로 오인하지 않음),
+연결 배지 "· 미확인". `head.perf` 는 예전 뜻(실적 모듈 연결 여부) 그대로 — 갱신 상자·"연결되지 않아" 문구 조건. 회의록 열기·직접 입력은 그대로.
+
+**테스트** — `tests/test_project_module.py`(`test_meeting_prev_week_links`: 역순 생성·같은 이름·다른 구역 같은 이름·이름 변경·이동·새 줄·삭제/재생성·
+건너뛴 주, 018 적용/미적용 둘 다 · `test_meeting_perf_unknown_vs_zero`: 미연결·목록 장애·매출 장애·부분 실패·정상 0·집계 쇼핑몰 없음),
+`tests/test_meeting_line_keys_migration.py`(018 백필·멱등·UNIQUE — 임시 스키마, 끝에 ROLLBACK), `tests/js/goals_meeting_ui.test.js`
+(`python tests/js/render_goals.py` 후 — 버그 1·2·3·5·6·7, UX 8·9, 분기 접기·열 너비·스크롤·참석자 회귀).
+
## 6-10. 권한·저장 안전장치 (2026-09-30 점검 반영, 새 마이그레이션·환경변수 없음)
**권한 공통 기준 — `access.py`** (라우터·마감 알림이 같은 규칙)
diff --git a/scripts/sql/project_db_018_meeting_line_keys.sql b/scripts/sql/project_db_018_meeting_line_keys.sql
new file mode 100644
index 0000000..b6e4baf
--- /dev/null
+++ b/scripts/sql/project_db_018_meeting_line_keys.sql
@@ -0,0 +1,87 @@
+-- =====================================================================
+-- project_db 마이그레이션 018 — 주간 회의록 줄 연결키(line_key)
+-- =====================================================================
+-- 멱등(idempotent). DROP TABLE/TRUNCATE/DELETE 없음 — 새 칸을 더하고 비어 있는 칸만 채운다.
+--
+-- 왜: 예전엔 "지난주" 줄을 carry_from(만들 때 앞선 회의록 줄 id)으로만 찾았다.
+-- · 다음 주(9/28)를 먼저 만들고 앞 주(9/21)를 나중에 만들면 9/28 의 carry_from 이 비어 지난주 리뷰가 빠졌다.
+-- · 한 주를 건너뛰면 몇 주 전 줄이 "지난주"로 보였다.
+-- · 앞 주를 지웠다 다시 만들면 ON DELETE SET NULL 로 끊긴 연결이 돌아오지 않았다.
+-- 이제: 줄마다 연결키(line_key) — 회의록을 만들 때 원본 줄의 키를 그대로 이어받고, 새 줄은 새 키.
+-- "지난주" = 정확히 7일 전 주 회의록에서 같은 키의 줄(생성 순서·이름 변경·순서 이동과 무관).
+--
+-- ① line_key UUID 칸 추가
+-- ② 기존 줄 채우기 — carry_from 사슬을 따라 같은 키를 준다(사슬의 맨 앞 줄 = 키의 뿌리).
+-- carry_from 이 없는 줄(첫 회의록·줄 추가·앞 주 삭제로 끊긴 줄)은 자기만의 새 키 → 다른 줄에 붙지 않는다.
+-- 이름(label)으로 추정해 붙이지 않는다(같은 이름 줄·이름 변경 때 다른 줄 결과가 섞일 수 있어서).
+-- → 9/14 를 원본으로 9/28 을 먼저, 9/21 을 나중에 만든 경우 두 주 줄이 모두 9/14 키를 받아 9/28 ↔ 9/21 이 다시 연결된다.
+-- → 둘 다 양식(앞선 회의록 없음)으로 만든 주끼리는 사슬이 없어 연결되지 않는다(자동 복구 범위 밖,
+-- project_db_018b_meeting_line_link_candidates.sql 로 후보를 조회해 사람이 확인 후 따로 연결).
+-- ③ 한 주 안에서 키가 겹치면(정상 데이터에선 없음) 순서가 뒤인 줄에 새 키 — 한 줄이 두 줄에 붙지 않게
+-- ④ 기본값(예전 코드 호환) + NOT NULL + (week_start, line_key) UNIQUE
+--
+-- 미적용이어도 회의록은 동작한다 — "지난주"는 carry_from 이 정확히 7일 전 주 줄을 가리킬 때만 보인다(역순 생성 연결은 안 됨).
+--
+-- 적용 (1회, 여러 번 돌려도 안전, 적용 전 project_db 백업):
+-- docker exec -i postgres-db psql -U postgres -d project_db \
+-- < scripts/sql/project_db_018_meeting_line_keys.sql
+-- 확인:
+-- docker exec -i postgres-db psql -U postgres -d project_db -c \
+-- "SELECT count(*) AS total, count(line_key) AS keyed FROM goal_meeting_items;"
+-- =====================================================================
+
+\set ON_ERROR_STOP on
+\connect project_db
+
+BEGIN;
+
+-- ① 칸 ─────────────────────────────────────────────────────────────
+ALTER TABLE goal_meeting_items ADD COLUMN IF NOT EXISTS line_key UUID;
+
+-- ② 기존 줄 — carry_from 사슬로 키 채우기(비어 있는 줄만). id 는 만든 순서라 자식 id > 부모 id(순환 방지).
+-- 뿌리 키 = md5('goal_meeting_item:' || 뿌리 id) — 같은 데이터면 몇 번 돌려도 같은 키.
+WITH RECURSIVE chain AS (
+ SELECT i.id, COALESCE(i.line_key, md5('goal_meeting_item:' || i.id)::uuid) AS k
+ FROM goal_meeting_items i
+ WHERE i.line_key IS NOT NULL
+ OR i.carry_from IS NULL
+ OR NOT EXISTS (SELECT 1 FROM goal_meeting_items p WHERE p.id = i.carry_from)
+ UNION ALL
+ SELECT c.id, chain.k
+ FROM goal_meeting_items c
+ JOIN chain ON c.carry_from = chain.id
+ WHERE c.line_key IS NULL AND c.id > chain.id
+)
+UPDATE goal_meeting_items g
+ SET line_key = chain.k
+ FROM chain
+ WHERE g.id = chain.id AND g.line_key IS NULL;
+
+-- 사슬에 닿지 않은 줄(있을 수 없지만 안전하게) — 자기만의 키
+UPDATE goal_meeting_items SET line_key = md5('goal_meeting_item:' || id)::uuid WHERE line_key IS NULL;
+
+-- ③ 한 주 안 같은 키 — 순서가 뒤인 줄만 새 키(줄 내용·carry_from 은 그대로)
+UPDATE goal_meeting_items g
+ SET line_key = md5('goal_meeting_item:dup:' || g.id)::uuid
+ FROM (SELECT id, row_number() OVER (PARTITION BY week_start, line_key ORDER BY sort_order, id) AS rn
+ FROM goal_meeting_items) d
+ WHERE g.id = d.id AND d.rn > 1;
+
+-- ④ 제약 ───────────────────────────────────────────────────────────
+-- 기본값 — 018 을 먼저 적용하고 코드를 나중에 배포해도(예전 코드는 line_key 를 넣지 않음) 줄 추가가 실패하지 않게 새 키.
+-- 새 코드는 늘 키를 직접 넣는다(이어받기 = 원본 키, 새 줄 = 새 키). pgcrypto 없이 되는 식(md5 → uuid).
+ALTER TABLE goal_meeting_items ALTER COLUMN line_key SET DEFAULT md5(random()::text || clock_timestamp()::text)::uuid;
+ALTER TABLE goal_meeting_items ALTER COLUMN line_key SET NOT NULL;
+CREATE UNIQUE INDEX IF NOT EXISTS uq_goal_meeting_items_week_key ON goal_meeting_items (week_start, line_key);
+CREATE INDEX IF NOT EXISTS idx_goal_meeting_items_key ON goal_meeting_items (line_key);
+
+COMMENT ON COLUMN goal_meeting_items.line_key IS
+ '주가 바뀌어도 같은 줄을 가리키는 연결키 — 회의록을 만들 때 원본 줄 키를 이어받음. 지난주 = 7일 전 주의 같은 키 줄';
+COMMENT ON COLUMN goal_meeting_items.carry_from IS
+ '만들 때 이어받은 앞선 회의록 줄(이력). 화면의 지난주 연결은 line_key(018) 로 찾는다';
+
+COMMIT;
+
+SELECT 'project_db 018 meeting line keys ready' AS status,
+ (SELECT count(*) FROM goal_meeting_items) AS items,
+ (SELECT count(*) FROM goal_meeting_items WHERE line_key IS NULL) AS missing_keys;
diff --git a/scripts/sql/project_db_018b_meeting_line_link_candidates.sql b/scripts/sql/project_db_018b_meeting_line_link_candidates.sql
new file mode 100644
index 0000000..57dd09f
--- /dev/null
+++ b/scripts/sql/project_db_018b_meeting_line_link_candidates.sql
@@ -0,0 +1,45 @@
+-- =====================================================================
+-- project_db 018b — 주간 회의록 "지난주" 연결 후보 조회 (읽기 전용, 자동 적용 없음)
+-- =====================================================================
+-- 018 은 carry_from 사슬이 있는 줄만 자동으로 이어 준다. 앞선 회의록 없이 양식으로 만든 주끼리
+-- (예: 9/28 을 먼저 양식으로 만들고 9/21 도 양식으로 만든 경우)는 사슬이 없어 연결되지 않는다.
+-- 이 조회는 그런 주 쌍(정확히 7일 차이)에서 **구역+줄 이름이 양쪽 주에 각각 한 줄씩만 있는** 줄만 후보로 보여 준다.
+-- 같은 구역에 같은 이름이 두 줄 이상이거나 이름이 빈 줄, 이미 연결된 줄은 후보에서 뺀다(추정 연결 금지).
+--
+-- 실행(조회만):
+-- docker exec -i postgres-db psql -U postgres -d project_db \
+-- < scripts/sql/project_db_018b_meeting_line_link_candidates.sql
+--
+-- 후보를 사람이 확인한 뒤에만, 한 쌍씩 아래처럼 연결한다(다음 주 줄이 앞 주 줄의 키를 받음). 운영 적용은 별도 승인·백업 후.
+-- BEGIN;
+-- UPDATE goal_meeting_items SET line_key = (SELECT line_key FROM goal_meeting_items WHERE id = <앞 주 줄 id>)
+-- WHERE id = <다음 주 줄 id>
+-- AND NOT EXISTS (SELECT 1 FROM goal_meeting_items x
+-- WHERE x.week_start = goal_meeting_items.week_start
+-- AND x.line_key = (SELECT line_key FROM goal_meeting_items WHERE id = <앞 주 줄 id>));
+-- -- 다음 주 다음(+14일) 회의록이 그 줄을 예전 키로 이어받았다면 그 줄도 같은 키로 맞춰야 사슬이 이어진다 — 결과 확인 후 COMMIT
+-- COMMIT;
+-- =====================================================================
+
+\set ON_ERROR_STOP on
+\connect project_db
+
+WITH items AS (
+ SELECT i.*, count(*) OVER (PARTITION BY i.week_start, i.section, i.label) AS same_name
+ FROM goal_meeting_items i
+ WHERE btrim(i.label) <> ''
+),
+pairs AS (
+ SELECT p.week_start AS prev_week, n.week_start AS week,
+ n.section, n.label, p.id AS prev_item_id, n.id AS item_id
+ FROM items n
+ JOIN items p ON p.week_start = n.week_start - 7 AND p.section = n.section AND p.label = n.label
+ WHERE n.same_name = 1 AND p.same_name = 1
+ AND n.line_key <> p.line_key
+ -- 이미 이 앞 주에 같은 키 줄이 있는 다음 주 줄(연결됨)은 빼고, 앞 주 줄이 다른 줄과 이미 이어진 것도 뺀다
+ AND NOT EXISTS (SELECT 1 FROM goal_meeting_items x WHERE x.week_start = p.week_start AND x.line_key = n.line_key)
+ AND NOT EXISTS (SELECT 1 FROM goal_meeting_items y WHERE y.week_start = n.week_start AND y.line_key = p.line_key)
+)
+SELECT prev_week, week, section, label, prev_item_id, item_id
+ FROM pairs
+ ORDER BY week, section, label;
diff --git a/tests/js/README.md b/tests/js/README.md
index 8cf25bd..065e08b 100644
--- a/tests/js/README.md
+++ b/tests/js/README.md
@@ -13,3 +13,15 @@ node tests/js/box_calc_ui.test.js
```
성공하면 마지막 줄에 `ALL PASS`, 실패하면 실패한 항목명이 출력되고 종료코드 1.
+
+# 연간 목표·주간 회의록 UI 테스트 (jsdom)
+
+`goals.html`·`goal_meeting.html` + `static/project.js` — 칸 저장 직렬화·늦은 응답·503·초안 보호·구조 변경 중단·이번주 실적 %·
+실적 미확인 표시·⋮ 메뉴(키보드·터치 클릭)·매출 갱신 안내를 가짜 서버(지연·실패를 직접 만듦)로 검증한다.
+
+```bash
+python tests/js/render_goals.py # → tests/js/.out/goals_*.html · meeting_*.html
+node tests/js/goals_meeting_ui.test.js # jsdom 필요(npm install jsdom 또는 NODE_PATH)
+```
+
+실제 브라우저 레이아웃·입력기·터치 기기는 아니다(그건 헤드리스 크롬으로 따로 확인).
diff --git a/tests/js/goals_meeting_ui.test.js b/tests/js/goals_meeting_ui.test.js
new file mode 100644
index 0000000..7349091
--- /dev/null
+++ b/tests/js/goals_meeting_ui.test.js
@@ -0,0 +1,664 @@
+// 연간 목표(goals.html)·주간 회의록(goal_meeting.html) + static/project.js UI 회귀 테스트 — jsdom.
+// 서버는 가짜(fetch 대체)로 두고 지연(deferred)·순서 역전·503·연속 입력을 직접 만든다. 실제 브라우저 레이아웃·입력기·터치 기기는 아니다.
+//
+// python tests/js/render_goals.py # 템플릿 렌더 → tests/js/.out/goals_*.html · meeting_*.html
+// npm install jsdom # (최초 1회, 또는 NODE_PATH 로 jsdom 이 있는 node_modules 지정)
+// node tests/js/goals_meeting_ui.test.js
+//
+// 성공하면 마지막 줄 ALL PASS, 실패하면 항목명과 종료코드 1.
+const fs = require("fs");
+const path = require("path");
+const { JSDOM, VirtualConsole } = require("jsdom");
+const WATCHDOG = setTimeout(function () { console.log("TIMEOUT — 어딘가에서 멈춤"); process.exit(2); }, 180000);
+
+const ROOT = path.join(__dirname, "..", "..");
+const OUT = path.join(__dirname, ".out");
+const JS = fs.readFileSync(path.join(ROOT, "app", "static", "project.js"), "utf8");
+const PAGE = {};
+["goals_admin", "goals_ro", "meeting_admin", "meeting_err", "meeting_ro"].forEach(function (n) {
+ PAGE[n] = fs.readFileSync(path.join(OUT, n + ".html"), "utf8");
+});
+const GOALS_URL = "http://localhost/project/goals/2026";
+const MEET_URL = "http://localhost/project/goals/2026/meetings/9?week=2026-09-28";
+
+const fails = [];
+function check(name, cond, extra) {
+ if (cond) console.log("PASS " + name);
+ else { console.log("FAIL " + name + (extra !== undefined ? " → " + JSON.stringify(extra) : "")); fails.push(name); }
+}
+function deferred() {
+ let resolve, reject;
+ const p = new Promise(function (a, b) { resolve = a; reject = b; });
+ return { promise: p, resolve: resolve, reject: reject };
+}
+function settle(n) {
+ return new Promise(function (r) { let i = 0; (function spin() { if (i++ >= (n || 40)) return r(); setImmediate(spin); })(); });
+}
+function wait(ms) { return new Promise(function (r) { setTimeout(r, ms); }); }
+const unhandled = [];
+process.on("unhandledRejection", function (e) { unhandled.push(String(e && e.message || e)); });
+
+// env.route(method, re, fn(url, body, call)) — fn 이 {status, body, text} 또는 "NETWORK" 를 돌려준다(Promise 가능)
+function makeEnv(html, url, opts) {
+ opts = opts || {};
+ const vc = new VirtualConsole();
+ const env = { calls: [], routes: [], navigations: 0, toasts: [], prompts: [], inflight: {}, maxInflight: {} };
+ vc.on("jsdomError", function (e) { if (/navigation/i.test(String(e && e.message))) env.navigations++; });
+ const dom = new JSDOM(html, { runScripts: "dangerously", pretendToBeVisual: true, url: url, virtualConsole: vc });
+ const w = dom.window, d = w.document;
+ env.w = w; env.d = d;
+ w.__PJ_TEST__ = true;
+ w.console.error = function () {};
+ w.scrollTo = function () {};
+ w.HTMLCanvasElement.prototype.getContext = function () { return null; };
+ w.erpConfirm = function () { return Promise.resolve(true); };
+ w.erpPrompt = function (msg, def) { env.prompts.push(msg); return Promise.resolve(opts.promptAnswer != null ? opts.promptAnswer : "새 이름"); };
+ w.erpAlert = function () {};
+ if (opts.storage) Object.keys(opts.storage).forEach(function (k) { w.localStorage.setItem(k, opts.storage[k]); });
+ if (opts.session) Object.keys(opts.session).forEach(function (k) { w.sessionStorage.setItem(k, opts.session[k]); });
+ env.route = function (method, re, fn) { env.routes.unshift({ method: method, re: re, fn: fn }); };
+ w.fetch = async function (u, o) {
+ const method = (o && o.method) || "GET";
+ let body = o && o.body;
+ if (typeof body === "string") { try { body = JSON.parse(body); } catch (_) {} }
+ const call = { method: method, url: String(u), body: body, keepalive: !!(o && o.keepalive), done: false };
+ env.calls.push(call);
+ const key = method + " " + String(u).replace(/^https?:\/\/[^/]+/, "");
+ env.inflight[key] = (env.inflight[key] || 0) + 1;
+ env.maxInflight[key] = Math.max(env.maxInflight[key] || 0, env.inflight[key]);
+ try {
+ for (const r of env.routes) {
+ if (r.method === method && r.re.test(String(u))) {
+ const out = await r.fn(String(u), body, call);
+ if (out === "NETWORK") throw new TypeError("Failed to fetch");
+ const status = out.status || 200;
+ return { ok: status < 400, status: status, statusText: "x",
+ json: async function () { return out.body || {}; }, text: async function () { return out.text || ""; } };
+ }
+ }
+ return { ok: true, status: 200, statusText: "OK", json: async function () { return {}; }, text: async function () { return ""; } };
+ } finally {
+ env.inflight[key]--;
+ call.done = true;
+ }
+ };
+ env.puts = function (re) { return env.calls.filter(function (c) { return c.method === "PUT" && re.test(c.url); }); };
+ env.toastText = function () { const t = d.querySelector(".erp-toast"); return t ? t.textContent : ""; };
+ return env;
+}
+async function boot(env) {
+ if (env.d.readyState === "loading") await new Promise(function (r) { env.d.addEventListener("DOMContentLoaded", r); });
+ env.w.eval(JS);
+ env.d.dispatchEvent(new env.w.Event("DOMContentLoaded"));
+ await settle();
+ return env;
+}
+function type(env, node, value) {
+ node.value = value;
+ node.dispatchEvent(new env.w.Event("input", { bubbles: true }));
+}
+function fire(env, node, name) { node.dispatchEvent(new env.w.Event(name, { bubbles: name !== "blur" && name !== "focus" })); }
+function key(env, node, k, extra) {
+ const e = new env.w.KeyboardEvent("keydown", Object.assign({ key: k, bubbles: true, cancelable: true }, extra || {}));
+ node.dispatchEvent(e);
+ return e;
+}
+// 블록 하나가 예외로 멈춰도 나머지 블록은 계속(예외는 FAIL 로)
+async function section(fn) {
+ try { await fn(); } catch (e) { check("블록 예외 없음: " + String(e && e.message || e).slice(0, 120), false); }
+}
+function itemLabel(b) { return (b.querySelector(".pj-ctxmenu-label") || b).textContent.trim(); }
+function unload(env) {
+ const e = new env.w.Event("beforeunload", { cancelable: true });
+ env.w.dispatchEvent(e);
+ return e;
+}
+
+// ── 가짜 서버 — 목표 표(글 칸 상태를 기억해 화면 GET 에 반영) ───────────────
+function goalsServer(env, st) {
+ st = Object.assign({ cells: {}, areaAdded: false, cellHook: null, metricHook: null, getHook: null }, st || {});
+ env.route("GET", /\/project\/api\//, function () { return { body: {} }; });
+ env.route("PUT", /\/project\/api\/goals\/rows\/\d+\/cells\/\d+$/, async function (u, body, call) {
+ const m = u.match(/rows\/(\d+)\/cells\/(\d+)/);
+ if (st.cellHook) { const r = await st.cellHook(u, body, call); if (r) return r; }
+ st.cells[m[1] + ":" + m[2]] = body.body;
+ return { body: { ok: true } };
+ });
+ env.route("PUT", /\/project\/api\/goals\/2026\/metrics$/, async function (u, body, call) {
+ if (st.metricHook) { const r = await st.metricHook(u, body, call); if (r) return r; }
+ const n = Number(String(body.value).replace(/[,\s]/g, ""));
+ st.metric = String(body.value);
+ return { body: { ok: true, label: body.value === "" ? "" : n.toLocaleString("en-US") } };
+ });
+ env.route("POST", /\/project\/api\/goals\/2026\/areas$/, function () { st.areaAdded = true; return { body: { ok: true } }; });
+ env.route("POST", /\/project\/api\/goals\/areas\/\d+\/rows$/, function () { return { status: 201, body: { ok: true } }; });
+ env.route("POST", /\/project\/api\/goals\/areas\/\d+\/move$/, function () { return { body: { ok: true } }; });
+ env.route("POST", /\/project\/api\/goals\/areas\/\d+\/merge$/, function () { st.merged = true; return { body: { ok: true, row_id: 10, start: 1 } }; });
+ env.route("GET", /\/project\/goals\/2026$/, async function () {
+ if (st.getHook) await st.getHook();
+ st.gets = (st.gets || 0) + 1;
+ let html = PAGE.goals_admin.replace(/(