diff --git a/CLAUDE.md b/CLAUDE.md
index 5d07bd7..c178868 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색, 수정 창 12열)·아이콘(`projects.icon`, Material Symbols 42종, 마이그레이션 011 + [아사나 아이콘] 탭 33종 `"asana:"+이름`, 채워진 모양 전용 부분 글꼴 `material-symbols-asana.woff2`)·작업(`tasks`: 담당자·우선순위·시작/마감)·진행단계(`project_stages` 칸반, 생성시 기본 4단계 seed, 섹션 머리는 모두 `#f3f3f3` — 섹션별 색 지정 없음, 섹션 이름 굵게, 섹션 기본 담당자 `default_assignee_email` — 담당자 빈 작업을 그 섹션에 만들거나 옮기면 자동 배정, 마이그레이션 009)·멤버 배정(`project_members`)·활동이력(`project_activity`). 첫 화면(`/project/`)은 **내 작업 목록**(프로젝트 홈 카드 화면은 폐지). 프로젝트 화면은 캘린더(FullCalendar)/타임라인(vis-timeline)/보드/목록/대시보드 뷰 토글. 좌측 사이드바는 수신함·내 작업·휴지통·프로젝트 화면 공용(`templates/project/_side.html` + 프로젝트 목록 동작 `initSideTree`, 새 프로젝트/수정 모달 `_side_modals.html`) — 프로젝트 목록(순서 변경·✎·×)은 어느 화면에서나 같다. 보드는 아사나처럼 섹션이 가로로 계속 늘어나고(넘치면 가로 스크롤) 카드의 담당자·마감일을 클릭해 그 자리에서 바꾼다. 좌측 사이드바에 수신함·전체 보기(관리자만 — 예전 오른쪽 위 "전체 프로젝트" 토글, `?scope=all`)·내 작업(접이식) 메뉴. 설명란 서식 도구에 글자 색·크기(서버는 span style 의 color·font-size 만 허용, `desc_inline_style`). 설명란은 주소 붙여넣기 시 자동 링크, 설명란·댓글에서 @로 멤버를 태그하면 (`task_mentions`, 마이그레이션 006) 수신함에 그 작업이 쌓인다. 진입 권한키 `project`(관리자 페이지 토글로 직원별 부여, admin 자동). 프로젝트 생성은 `project` 권한자 누구나(만든 사람이 owner), 삭제는 만든 사람만(슈퍼관리자 예외), 사용자 배정은 `is_admin` 만. 배정 멤버(또는 owner)만 그 프로젝트를 조회 — **관리자도 멤버가 아니면 안 보임, 예외는 슈퍼관리자뿐**(2026-10-07, `access.sees_all_projects`; 사이드바 목록·검색·휴지통·알림도 같은 기준, 화면·API 모두 비멤버 403)하고 서브프로젝트/작업/단계 CRUD — URL 의 섹션·부모 작업이 그 프로젝트 것인지 서버가 검증. 실시간 반영은 `project_live_version` 카운터(마이그레이션 007, 미적용 시 MAX 폴백). 사이드바 전체 검색(`/api/search`, 제목·설명·댓글, pg_trgm) + 프로젝트/내 작업 필터 바(찾기·상태·담당자·마감·우선순위·정렬, 클라이언트 필터). 협업자(`task_followers`, 자동 팔로우: 만든 사람·담당자·댓글·@태그) — 완료·댓글 알림은 담당자+협업자에게만. 나를 태그하거나 작업이 배정되면 프로젝트 화면 가운데 아래에 깜박이는 큰 팝업(닫기 전까지, `initTaskAlerts` + `GET /api/notifications/alerts`). 작업 삭제는 휴지통(`project_trash`, 마이그레이션 010) — 삭제 직전 스냅샷 3개월 보관, 관리자만 보기·복구(`/project/trash`). 권한은 **지금 기준 공통 모듈 `access.py`**(목록·배지·알림·멘션·메일 수신자·삭제·댓글 수정까지 — 멤버에서 빠지면 기록이 있어도 안 보이고 알림도 없음), 소유자 변경은 관리자만, 연결(멀티호밍)된 작업은 연결된 프로젝트 멤버에게 읽기 전용(docs/PROJECT_MODULE.md 6-10). 연간 목표(마이그레이션 013, `goal_*` 테이블) — 사이드바 "목표" → 연도 펼침 → `/project/goals/{연도}` 에 매출(목표·실적·달성)·로아스 월별 숫자 + 업무 영역(상품·마케팅·컨텐츠·유통 등)별 연간·월별 글, 조회는 전원·입력은 `is_admin` 만. 3·6·9·12월 오른쪽 1~4분기 칸(글 칸 13=1분기·15=2분기·14=3분기·16=4분기 — 예전 반기 칸 번호 재사용, 15·16 은 마이그레이션 017) + 분기 월 칸 접기 애니메이션(localStorage `pj_goal_fold_q`, 표는 `width:1px`+`table-layout:fixed`), 영역·줄 이름 클릭 바로 수정, **엑셀식 칸 병합**(마우스로 끌어 사각형 선택 → 우클릭 셀 병합/병합 해제, 같은 영역 안 세로 `row_span` + 같은 분기 월 칸 가로, 글은 왼쪽 위 칸 — `goal_cell_merges`, 마이그레이션 014·015·017), 3열 줄 추가는 같은 항목 칸(2열) 안에(`goal_rows.label_cont`, 마이그레이션 016), 구조 변경은 새로고침 없이 제자리 다시 그리기(`refreshTable`)+애니메이션, 로아스는 % 표기. 월 머리 → **주간 회의록**(`/project/goals/{연도}/meetings/{월}`, 프로젝트 권한자 **누구나 수정** — 관리자 [회의 완료](`completed_at`, 마이그레이션 022)면 잠금(지난주 결과는 다음 주 회의록이 열려 있는 동안 허용), 삭제·완료·완료 해제는 관리자, 주차 탭 — **주차는 그 달 안**(`store.month_weeks`: 1일이 월~금이면 1일~일요일이 1주차, 토·일이면 1일~다음 주 일요일, 그 뒤 월~일, 말일이 월·화면 앞 주차에 붙음, 회의록 `week_start` = 주차 시작일, 마이그레이션 020), `goal_meetings`·`goal_meeting_items` 마이그레이션 015 — 지난주 = **바로 앞 주차**(`store.prev_week_period`) 회의록의 같은 연결키 줄(`line_key`, 마이그레이션 018 — 생성 순서·이름 변경과 무관, 이름 추정 연결 금지)로 리뷰(열: 주요 업무·정량 목표 ‖ 전주 업무·결과(글, `result_note` 020)·전주 목표·결과 — 정량 목표·결과는 숫자면 원 정수 칸, 아니면 글 칸 `target_text`·`result_text`(예: 20개, 021)), 실적 조회 장애는 0원이 아니라 "미확인", 위에 목표 표 그 달 열 글을 영역별 "N월 계획" 카드로, 참석자 옆 [회의록 보드] = 그 주차의 빈 Google 슬라이드를 독립 창으로(오른쪽 🔗 아이콘 = 그 보드 링크 복사)(공유 드라이브 `MEETING_BOARD_FOLDER_ID`, 없으면 만듦, `app/integrations/google_slides.py`, Drive appProperties 로 주차 연결 — Drive·Slides 권한 토큰 필요), 표를 스크롤해도 보이는 머리 영역 3칸 = ① 월 계획 + 머리 줄에 숫자 4개 작게 1행(월 목표 매출·월 누적 목표 매출(목표 표 **주차별 매출 목표** `goal_week_targets` 1주차~이 주차 합 — 목표 표 매출 목표 월 칸을 누르면 입력 창 — 월 전체 목표는 직접 입력(주차 합계와 별개), 맨 아래 차이 = 월 목표 − 주차 합계)·월 누적 실적(1일~오늘)·누적 목표 대비 차액·%) | ② 결정 사항·메모 | ③ 작업 등록 표(제목·담당자·프로젝트·섹션 → [적용] = 그 프로젝트에 작업 생성, `initMeetQuickTasks`), 실적 모듈 `performance_store` 매출은 머리 카드에만 읽기 전용 — 줄(쇼핑몰)별 자동 결과·이번주 실적·연결 배지·쇼핑몰 연결 메뉴는 폐지, 지난주 결과는 늘 직접 입력). 모든 열 너비 끌어서 조절(localStorage `pj_goal_col_w`), 세로 스크롤 틀 고정은 머리 줄+매출·로아스 줄까지, 항목 칸 +·우클릭으로 줄 위/아래 추가·삭제. 마감 알림(`reminders.py` 데몬 스레드, 영업일 09시, D-1/당일/지연, `task_reminders` 로 중복 방지, `PROJECT_REMINDER_*` env) — 마이그레이션 008. 라우터 핸들러는 동기 DB 라 `def` 로 둔다(`async def` 금지). 말풍선은 전부 아사나식 공용 말풍선(`.pj-hovertip`) — 새 기능도 `title=`/`data-tip=` 만 달고 별도 툴팁 구현 금지. 멤버 배정 후보는 `project` 권한 보유 등록 사용자에서 자동 목록(`GET /project/api/assignable-users`). 작업 배정·완료 시 관리자에게 메일(`app/mail.py` stdlib smtplib, `SMTP_*`+`PROJECT_NOTIFY_EMAIL` env, 미설정 시 조용히 skip, `BackgroundTasks` 비동기). 목표 표·회의록 칸 저장은 공용 `createFieldSaver`(같은 칸 요청 직렬화·보낸 값만 저장됨·실패 시 초안 유지·localStorage 초안 백업, 저장 실패면 구조 변경 중단 — docs/PROJECT_MODULE.md 6-9-3), 구역·항목 메뉴는 우클릭 + ⋮ 버튼(키보드·터치). ERP 메뉴 이름은 "Project"(`app/main.py` 모듈 목록 title). **PC 알림 프로그램**(`desktop/notifier/`, C# .NET Framework 4.8 WinForms exe 하나·트레이 상주, 마이그레이션 023 `notifier_links`·`notifier_tokens`) — 브라우저가 뒤에 있어도 태그·배정 알림을 웹 팝업과 같은 모양으로 화면 위에. 브라우저 `/project/notifier?code=` 승인으로 PC별 토큰(서버는 SHA-256 만, PC 는 DPAPI), `GET /project/api/notifier/alerts`(Bearer)는 웹 알림과 같은 `_alerts_payload`, 토큰마다 지금 사용자·권한 재확인. 프로그램이 돌고 있으면(최근 3분 확인, `notifier_active`) 웹 큰 팝업은 쉰다(`desktop: true`). 압축·난독화 금지(백신 오탐), 빌드 `desktop/notifier/build.ps1`, 상세 docs/PROJECT_MODULE.md 6-11. 댓글·답글 입력칸은 Enter 등록·Shift+Enter 줄바꿈(textarea), 설명란 이미지 더블클릭 = 별도 창 이미지 보기(확대·축소·끌어 이동). 작업 창은 **저장 버튼 없이 실시간 저장**(칸별 PUT, `saveField`/`saveChain`, 새 작업은 제목이 생기는 순간 생성). 댓글 답글·이모티콘 반응(마이그레이션 012 `task_comments.parent_id`·`task_comment_reactions`, 미적용 시 버튼 숨김·API 503), 완료 이력 줄은 `project_activity` completed 를 댓글 사이에 표시(댓글 수 제외), 댓글 `@아이디` 는 아이콘+이름 칩. 수신함은 확인 안 한 태그·읽지 않은 알림만(2026-10-08) — [확인] 버튼 없이 줄을 누르면 읽음·확인 처리(같은 작업 줄 함께) + 페이지 이동 없이 오른쪽 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색, 수정 창 12열)·아이콘(`projects.icon`, Material Symbols 42종, 마이그레이션 011 + [아사나 아이콘] 탭 33종 `"asana:"+이름`, 채워진 모양 전용 부분 글꼴 `material-symbols-asana.woff2`)·작업(`tasks`: 담당자·우선순위·시작/마감)·진행단계(`project_stages` 칸반, 생성시 기본 4단계 seed, 섹션 머리는 모두 `#f3f3f3` — 섹션별 색 지정 없음, 섹션 이름 굵게, 섹션 기본 담당자 `default_assignee_email` — 담당자 빈 작업을 그 섹션에 만들거나 옮기면 자동 배정, 마이그레이션 009)·멤버 배정(`project_members`)·활동이력(`project_activity`). 첫 화면(`/project/`)은 **내 작업 목록**(프로젝트 홈 카드 화면은 폐지). 프로젝트 화면은 캘린더(FullCalendar)/타임라인(vis-timeline)/보드/목록/대시보드 뷰 토글. 좌측 사이드바는 수신함·내 작업·휴지통·프로젝트 화면 공용(`templates/project/_side.html` + 프로젝트 목록 동작 `initSideTree`, 새 프로젝트/수정 모달 `_side_modals.html`) — 프로젝트 목록(순서 변경·✎·×)은 어느 화면에서나 같다. 보드는 아사나처럼 섹션이 가로로 계속 늘어나고(넘치면 가로 스크롤) 카드의 담당자·마감일을 클릭해 그 자리에서 바꾼다. 좌측 사이드바에 수신함·전체 보기(Pro user 이상 — 예전 오른쪽 위 "전체 프로젝트" 토글, `?scope=all`)·내 작업(접이식) 메뉴. 설명란 서식 도구에 글자 색·크기(서버는 span style 의 color·font-size 만 허용, `desc_inline_style`). 설명란은 주소 붙여넣기 시 자동 링크, 설명란·댓글에서 @로 멤버를 태그하면 (`task_mentions`, 마이그레이션 006) 수신함에 그 작업이 쌓인다. 진입 권한키 `project`(관리자 페이지 토글로 직원별 부여, admin 자동). **관리자 등급 4단계(2026-10-12) — 수퍼관리자(`SUPER_ADMIN_EMAIL` 한 명 고정, 추가 불가) > Admin(`role=admin`) > Pro user(`role=pro`) > User** — 판단은 `access.is_pro`(Pro user 이상)·`access.is_project_admin`(Admin 이상), 라우터 `_require_pro`, 화면 `pj_pro`·`pj_admin`(`_role_ctx`, `is_admin` 은 ERP 상단 관리자 메뉴용 그대로). pro 는 프로젝트 모듈 밖에서는 user 와 같다. 새 프로젝트·프로젝트 이름/색/아이콘/소유자 수정·멤버 배정(자기가 멤버인 프로젝트)·사이드바 순서·남의 댓글 수정/삭제·휴지통·전체 보기·담당자별 합계·전체 멤버 = Pro user 이상, 프로젝트·섹션 삭제 = Admin 이상 또는 만든 사람, 작업 삭제·서브프로젝트 = 멤버 누구나(표는 docs/PROJECT_MODULE.md 6-14). 배정 멤버(또는 owner)만 그 프로젝트를 조회 — **관리자도 멤버가 아니면 안 보임, 예외는 슈퍼관리자뿐**(2026-10-07, `access.sees_all_projects`; 사이드바 목록·검색·휴지통·알림도 같은 기준, 화면·API 모두 비멤버 403)하고 서브프로젝트/작업/단계 CRUD — URL 의 섹션·부모 작업이 그 프로젝트 것인지 서버가 검증. 실시간 반영은 `project_live_version` 카운터(마이그레이션 007, 미적용 시 MAX 폴백). 사이드바 전체 검색(`/api/search`, 제목·설명·댓글, pg_trgm) + 프로젝트/내 작업 필터 바(찾기·상태·담당자·마감·우선순위·정렬, 클라이언트 필터). 협업자(`task_followers`, 자동 팔로우: 만든 사람·담당자·댓글·@태그) — 완료·댓글 알림은 담당자+협업자에게만. 나를 태그하거나 작업이 배정되면 프로젝트 화면 가운데 아래에 깜박이는 큰 팝업(닫기 전까지, `initTaskAlerts` + `GET /api/notifications/alerts`). 작업 삭제는 휴지통(`project_trash`, 마이그레이션 010) — 삭제 직전 스냅샷 3개월 보관, Pro user 이상만 보기·복구(`/project/trash`). 권한은 **지금 기준 공통 모듈 `access.py`**(목록·배지·알림·멘션·메일 수신자·삭제·댓글 수정까지 — 멤버에서 빠지면 기록이 있어도 안 보이고 알림도 없음), 소유자 변경은 Pro user 이상, 연결(멀티호밍)된 작업은 연결된 프로젝트 멤버에게 읽기 전용(docs/PROJECT_MODULE.md 6-10). 연간 목표(마이그레이션 013, `goal_*` 테이블) — 사이드바 "목표" → 연도 펼침 → `/project/goals/{연도}` 에 매출(목표·실적·달성)·로아스 월별 숫자 + 업무 영역(상품·마케팅·컨텐츠·유통 등)별 연간·월별 글, 조회는 전원·입력(주차별 목표·연도 추가/삭제 포함)은 Pro user 이상. 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/{월}`, 프로젝트 권한자 **누구나 수정** — Pro user 이상 [회의 완료](`completed_at`, 마이그레이션 022)면 잠금(지난주 결과는 다음 주 회의록이 열려 있는 동안 허용), 삭제·완료·완료 해제는 Pro user 이상, 표 첫 열 머리 글자 "구분", 주차 탭 — **주차는 그 달 안**(`store.month_weeks`: 1일이 월~금이면 1일~일요일이 1주차, 토·일이면 1일~다음 주 일요일, 그 뒤 월~일, 말일이 월·화면 앞 주차에 붙음, 회의록 `week_start` = 주차 시작일, 마이그레이션 020), `goal_meetings`·`goal_meeting_items` 마이그레이션 015 — 지난주 = **바로 앞 주차**(`store.prev_week_period`) 회의록의 같은 연결키 줄(`line_key`, 마이그레이션 018 — 생성 순서·이름 변경과 무관, 이름 추정 연결 금지)로 리뷰(열: 주요 업무·정량 목표 ‖ 전주 업무·결과(글, `result_note` 020)·전주 목표·결과 — 정량 목표·결과는 숫자면 원 정수 칸, 아니면 글 칸 `target_text`·`result_text`(예: 20개, 021)), 실적 조회 장애는 0원이 아니라 "미확인", 위에 목표 표 그 달 열 글을 영역별 "N월 계획" 카드로, 참석자 옆 [회의록 보드] = 그 주차의 빈 Google 슬라이드를 독립 창으로(오른쪽 🔗 아이콘 = 그 보드 링크 복사)(공유 드라이브 `MEETING_BOARD_FOLDER_ID`, 없으면 만듦, `app/integrations/google_slides.py`, Drive appProperties 로 주차 연결 — Drive·Slides 권한 토큰 필요), 표를 스크롤해도 보이는 머리 영역 3칸 = ① 월 계획 + 머리 줄에 숫자 4개 작게 1행(월 목표 매출·월 누적 목표 매출(목표 표 **주차별 매출 목표** `goal_week_targets` 1주차~이 주차 합 — 목표 표 매출 목표 월 칸을 누르면 입력 창 — 월 전체 목표는 직접 입력(주차 합계와 별개), 맨 아래 차이 = 월 목표 − 주차 합계)·월 누적 실적(1일~오늘)·누적 목표 대비 차액·%) | ② 결정 사항·메모 | ③ 작업 등록 표(제목·담당자·프로젝트·섹션 → [적용] = 그 프로젝트에 작업 생성, `initMeetQuickTasks`), 실적 모듈 `performance_store` 매출은 머리 카드에만 읽기 전용 — 줄(쇼핑몰)별 자동 결과·이번주 실적·연결 배지·쇼핑몰 연결 메뉴는 폐지, 지난주 결과는 늘 직접 입력). 모든 열 너비 끌어서 조절(localStorage `pj_goal_col_w`), 세로 스크롤 틀 고정은 머리 줄+매출·로아스 줄까지, 항목 칸 +·우클릭으로 줄 위/아래 추가·삭제. 마감 알림(`reminders.py` 데몬 스레드, 영업일 09시, D-1/당일/지연, `task_reminders` 로 중복 방지, `PROJECT_REMINDER_*` env) — 마이그레이션 008. 라우터 핸들러는 동기 DB 라 `def` 로 둔다(`async def` 금지). 말풍선은 전부 아사나식 공용 말풍선(`.pj-hovertip`) — 새 기능도 `title=`/`data-tip=` 만 달고 별도 툴팁 구현 금지. 멤버 배정 후보는 `project` 권한 보유 등록 사용자에서 자동 목록(`GET /project/api/assignable-users`). 작업 배정·완료 시 관리자에게 메일(`app/mail.py` stdlib smtplib, `SMTP_*`+`PROJECT_NOTIFY_EMAIL` env, 미설정 시 조용히 skip, `BackgroundTasks` 비동기). 목표 표·회의록 칸 저장은 공용 `createFieldSaver`(같은 칸 요청 직렬화·보낸 값만 저장됨·실패 시 초안 유지·localStorage 초안 백업, 저장 실패면 구조 변경 중단 — docs/PROJECT_MODULE.md 6-9-3), 구역·항목 메뉴는 우클릭 + ⋮ 버튼(키보드·터치). ERP 메뉴 이름은 "Project"(`app/main.py` 모듈 목록 title). **PC 알림 프로그램**(`desktop/notifier/`, C# .NET Framework 4.8 WinForms exe 하나·트레이 상주, 마이그레이션 023 `notifier_links`·`notifier_tokens`) — 브라우저가 뒤에 있어도 태그·배정 알림을 웹 팝업과 같은 모양으로 화면 위에. 브라우저 `/project/notifier?code=` 승인으로 PC별 토큰(서버는 SHA-256 만, PC 는 DPAPI), `GET /project/api/notifier/alerts`(Bearer)는 웹 알림과 같은 `_alerts_payload`, 토큰마다 지금 사용자·권한 재확인. 프로그램이 돌고 있으면(최근 3분 확인, `notifier_active`) 웹 큰 팝업은 쉰다(`desktop: true`). 압축·난독화 금지(백신 오탐), 빌드 `desktop/notifier/build.ps1`, 상세 docs/PROJECT_MODULE.md 6-11. 댓글·답글 입력칸은 Enter 등록·Shift+Enter 줄바꿈(textarea), 설명란 이미지 더블클릭 = 별도 창 이미지 보기(확대·축소·끌어 이동). 작업 창은 **저장 버튼 없이 실시간 저장**(칸별 PUT, `saveField`/`saveChain`, 새 작업은 제목이 생기는 순간 생성). 댓글 답글·이모티콘 반응(마이그레이션 012 `task_comments.parent_id`·`task_comment_reactions`, 미적용 시 버튼 숨김·API 503), 완료 이력 줄은 `project_activity` completed 를 댓글 사이에 표시(댓글 수 제외), 댓글 `@아이디` 는 아이콘+이름 칩. 수신함은 확인 안 한 태그·읽지 않은 알림만(2026-10-08) — [확인] 버튼 없이 줄을 누르면 읽음·확인 처리(같은 작업 줄 함께) + 페이지 이동 없이 오른쪽 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/main.py b/app/main.py
index e1c776a..b2c14e3 100644
--- a/app/main.py
+++ b/app/main.py
@@ -35,6 +35,8 @@ from .modules.vacation import router as vacation_router
from .store import (
APPROVER_KEYS,
MODULE_KEYS,
+ ROLE_LABELS,
+ ROLES,
SUPER_ADMIN_EMAIL,
UserStore,
allowed_modules,
@@ -663,6 +665,8 @@ async def admin_page(request: Request) -> HTMLResponse:
"module_keys": list(MODULE_KEYS),
"module_labels": MODULE_LABELS,
"approver_keys": list(APPROVER_KEYS),
+ "roles": list(ROLES),
+ "role_labels": ROLE_LABELS,
"super_admin_email": SUPER_ADMIN_EMAIL,
"is_admin": True,
},
diff --git a/app/modules/project/access.py b/app/modules/project/access.py
index c8c539c..e3a6723 100644
--- a/app/modules/project/access.py
+++ b/app/modules/project/access.py
@@ -7,7 +7,16 @@
프로젝트
관리(=보기·작업 CRUD) : 프로젝트 owner · 배정 멤버 · 슈퍼관리자. 모두 `project` 모듈 권한이 있어야 한다.
(2026-10-07 — 관리자(is_admin)도 멤버가 아닌 프로젝트는 보이지 않는다. 예외는 슈퍼관리자 한 명뿐.
- 멤버 배정 자체는 여전히 관리자만 — 라우터의 _require_admin.)
+ 멤버 배정은 Pro user 이상(2026-10-12) — 라우터의 _require_pro, 아래 등급 표.)
+
+등급(2026-10-12, app.store.ROLES) — 수퍼관리자 > admin > pro > user
+ is_project_admin : 수퍼관리자·admin — 남이 만든 프로젝트·섹션도 삭제.
+ is_pro : 수퍼관리자·admin·pro — 새 프로젝트 만들기, 프로젝트 이름·색·아이콘·소유자 수정,
+ 멤버 배정·제외(자기가 멤버인 프로젝트), 사이드바 순서, 남의 댓글 수정·삭제,
+ 휴지통 보기·복구, 전체 보기, 대시보드 담당자별 합계, 전체 멤버 메뉴,
+ 목표 표 입력·구조 변경·주차별 목표·연도 추가/삭제, 회의 완료·완료 해제·회의록 삭제.
+ user : 멤버인 프로젝트의 작업·섹션·서브프로젝트·작업 삭제, 회의록 작성(완료 전까지).
+ 프로젝트 단위 권한은 등급과 상관없이 멤버(owner)여야 한다 — 위 is_pro 권한도 멤버인 프로젝트 안에서만.
작업
FULL : 원 소속 프로젝트를 관리할 수 있음 → 보기·수정·댓글·첨부·삭제(삭제는 추가로 생성자 규칙)
@@ -43,6 +52,24 @@ def _is_super(user: dict[str, Any] | None) -> bool:
return bool(user) and email_of(user) == SUPER_ADMIN_EMAIL
+def role_of(user: dict[str, Any] | None) -> str:
+ """등급 — 'super' · 'admin' · 'pro' · 'user'. 모르는 role 값은 user 로 본다."""
+ if _is_super(user):
+ return "super"
+ role = (user or {}).get("role")
+ return role if role in ("admin", "pro") else "user"
+
+
+def is_project_admin(user: dict[str, Any] | None) -> bool:
+ """수퍼관리자·admin — 만든 사람이 아니어도 프로젝트·섹션을 지운다."""
+ return role_of(user) in ("super", "admin")
+
+
+def is_pro(user: dict[str, Any] | None) -> bool:
+ """수퍼관리자·admin·pro — 프로젝트 관리·목표 입력 등 운영 권한(모듈 docstring 의 등급 표)."""
+ return role_of(user) in ("super", "admin", "pro")
+
+
def sees_all_projects(user: dict[str, Any] | None) -> bool:
"""멤버가 아니어도 모든 프로젝트를 보는가 — 슈퍼관리자만(모듈 권한도 있어야)."""
return can_use_module(user) and _is_super(user)
diff --git a/app/modules/project/router.py b/app/modules/project/router.py
index 466aede..0538afc 100644
--- a/app/modules/project/router.py
+++ b/app/modules/project/router.py
@@ -3,8 +3,10 @@
- 경로: /project
- 권한:
· 모듈 진입: 로그인한 회사 직원 전원(도메인 게이트는 OAuth 단에서 처리).
- · 프로젝트 생성/삭제·사용자 배정: ERP 관리자(is_admin) 전용.
- · 서브프로젝트/업무/단계 관리: 해당 프로젝트 멤버(또는 owner) 또는 관리자.
+ · 등급(수퍼관리자 > Admin > Pro user > User)별 권한은 access.py 머리 표 — 새 프로젝트·프로젝트 수정·
+ 멤버 배정·휴지통·목표 입력·회의 완료 등은 Pro user 이상(_require_pro / access.is_pro),
+ 남이 만든 프로젝트·섹션 삭제는 Admin 이상(access.is_project_admin).
+ · 서브프로젝트/업무/단계 관리: 해당 프로젝트 멤버(또는 owner) — 등급과 무관.
- 데이터: ProjectStore (project_db / PostgreSQL) 전용.
PROJECT_DB_URL 미설정 시 store 가 None 이며, 각 페이지는 "설정 필요" 안내.
- 메일: 업무가 직원에게 '배정'되거나 '완료'되면 관리자에게 알림(BackgroundTasks).
@@ -84,13 +86,20 @@ def _require_user(request: Request) -> dict[str, Any]:
return user
-def _require_admin(request: Request) -> dict[str, Any]:
+def _require_pro(request: Request) -> dict[str, Any]:
+ """Pro user 이상(수퍼관리자·Admin·Pro user) — access.is_pro."""
+ user = _require_user(request)
+ if not access.is_pro(user):
+ raise HTTPException(status_code=403, detail="Pro user 이상만 할 수 있는 작업입니다.")
+ return user
+
+
+def _role_ctx(user: dict[str, Any]) -> dict[str, Any]:
+ """화면 공용 등급 값 — is_admin 은 ERP 공통(상단 관리자 메뉴), pj_pro·pj_admin 은 프로젝트 모듈 버튼용."""
from app.store import is_admin # noqa: WPS433
- user = _require_user(request)
- if not is_admin(user):
- raise HTTPException(status_code=403, detail="관리자만 할 수 있는 작업입니다.")
- return user
+ return {"is_admin": is_admin(user), "pj_pro": access.is_pro(user),
+ "pj_admin": access.is_project_admin(user)}
def _can_manage(request: Request, st: Any, user: dict[str, Any], project_id: int) -> bool:
@@ -104,17 +113,13 @@ def _require_manage(request: Request, st: Any, user: dict[str, Any], project_id:
def _can_delete(user: dict[str, Any], created_by: str | None) -> bool:
- """삭제는 '만든 사람'만. 슈퍼관리자는 예외 허용.
- 생성자 정보가 없는 과거 데이터는 관리자에게 허용(잠김 방지)."""
- from app.store import SUPER_ADMIN_EMAIL, is_admin # noqa: WPS433
-
+ """프로젝트·섹션 삭제 — 수퍼관리자·Admin 은 누구 것이든, Pro user·User 는 '만든 사람'만.
+ 생성자 정보가 없는 과거 데이터는 Admin 이상만(잠김 방지). 작업 삭제는 멤버 누구나(이 검사 안 함)."""
+ if access.is_project_admin(user):
+ return True
me = store.norm_str(user.get("email", ""), lower=True)
cb = store.norm_str(created_by or "", lower=True)
- if me == SUPER_ADMIN_EMAIL:
- return True
- if not cb:
- return is_admin(user)
- return me == cb
+ return bool(cb) and me == cb
_DELETE_DENIED = "삭제는 만든 사람만 할 수 있습니다."
@@ -403,7 +408,6 @@ def _notify_completed(
def _render_config_needed(request: Request, user: dict[str, Any]) -> HTMLResponse:
from app.main import build_erp_nav, render_template # noqa: WPS433
- from app.store import is_admin # noqa: WPS433
return render_template(
request,
@@ -414,7 +418,7 @@ def _render_config_needed(request: Request, user: dict[str, Any]) -> HTMLRespons
"scripts/sql/project_db_init.sql 로 project_db 를 초기화한 뒤 "
"컨테이너를 재기동하세요.",
"user": user,
- "is_admin": is_admin(user),
+ **_role_ctx(user),
"nav_items": build_erp_nav(user, active="project"),
},
status_code=503,
@@ -661,7 +665,7 @@ def my_tasks_page(request: Request) -> HTMLResponse:
"project/mytasks.html",
{
"user": user,
- "is_admin": admin,
+ **_role_ctx(user),
"nav_items": build_erp_nav(user, active="project"),
"page_title": "내 작업",
"page_subtitle": "내가 담당자인 작업을 한 곳에서 봅니다.",
@@ -693,7 +697,7 @@ def task_permalink(request: Request, task_id: int):
from urllib.parse import quote # noqa: WPS433
from app.main import build_erp_nav, get_current_user_record, render_template # noqa: WPS433
- from app.store import has_module, is_admin # noqa: WPS433
+ from app.store import has_module # noqa: WPS433
user = get_current_user_record(request)
if user is None:
@@ -709,7 +713,7 @@ def task_permalink(request: Request, task_id: int):
{
"reason": reason,
"user": user,
- "is_admin": is_admin(user),
+ **_role_ctx(user),
"nav_items": build_erp_nav(user, active="project"),
},
status_code=status,
@@ -770,7 +774,7 @@ def project_page(request: Request, project_id: int) -> HTMLResponse:
"reason": "이 프로젝트의 멤버만 볼 수 있습니다. "
"프로젝트 관리자에게 멤버 배정을 요청하세요.",
"user": user,
- "is_admin": admin,
+ **_role_ctx(user),
"nav_items": build_erp_nav(user, active="project"),
},
status_code=403,
@@ -873,7 +877,7 @@ def project_page(request: Request, project_id: int) -> HTMLResponse:
"project/project.html",
{
"user": user,
- "is_admin": admin,
+ **_role_ctx(user),
"can_manage": can_manage,
"nav_items": build_erp_nav(user, active="project"),
"page_title": project["name"],
@@ -932,19 +936,17 @@ def api_list_projects(request: Request) -> JSONResponse:
_PROJECT_ICON_MIGRATION_MSG = "프로젝트 아이콘 기능이 아직 준비되지 않았습니다(DB 마이그레이션 011 필요)."
-_OWNER_ADMIN_ONLY = "프로젝트 소유자는 관리자만 지정·변경할 수 있습니다."
+_OWNER_ADMIN_ONLY = "프로젝트 소유자는 Pro user 이상만 지정·변경할 수 있습니다."
def _owner_for_create(user: dict[str, Any], payload: dict[str, Any]) -> str:
- """새 프로젝트 소유자 — 만든 사람. 다른 사람을 소유자로 지정하는 건 관리자만(그 사람은
- 등록 사용자이고 project 모듈 권한이 있어야 한다). 비관리자가 남을 지정하면 거절."""
+ """새 프로젝트 소유자 — 만든 사람. 다른 사람을 소유자로 지정하는 건 Pro user 이상만(그 사람은
+ 등록 사용자이고 project 모듈 권한이 있어야 한다). User 가 남을 지정하면 거절."""
me = store.norm_str(user["email"], lower=True)
want = store.norm_str(payload.get("owner_email") or "", lower=True)
if not want or want == me:
return me
- from app.store import is_admin # noqa: WPS433
-
- if not is_admin(user):
+ if not access.is_pro(user):
raise HTTPException(status_code=403, detail=_OWNER_ADMIN_ONLY)
_check_owner_candidate(want)
return want
@@ -961,8 +963,8 @@ def _check_owner_candidate(email: str) -> None:
def api_create_project(
request: Request, payload: dict[str, Any] = Body(...)
) -> JSONResponse:
- """최상위 프로젝트 생성 — 로그인해 프로젝트 모듈에 접근할 수 있는 사용자 누구나."""
- user = _require_user(request)
+ """최상위 프로젝트 생성 — Pro user 이상(만든 사람이 owner). User 는 서브프로젝트만."""
+ user = _require_pro(request)
st = _db_or_503(request)
try:
project = st.create_project(
@@ -987,7 +989,7 @@ def api_create_project(
def api_create_subproject(
request: Request, project_id: int, payload: dict[str, Any] = Body(...)
) -> JSONResponse:
- """서브프로젝트 생성 — 멤버(또는 관리자)."""
+ """서브프로젝트 생성 — 그 프로젝트 멤버 누구나(등급 무관)."""
user = _require_user(request)
st = _db_or_503(request)
_require_manage(request, st, user, project_id)
@@ -1015,13 +1017,13 @@ def api_reorder_projects(
) -> JSONResponse:
"""홈 화면 프로젝트 카드 드래그 순서 변경. 최상위 프로젝트만 대상이며,
순서는 이 화면을 보는 모든 사용자에게 공유되므로(세션 재정렬과 동일 원칙)
- 관리자 전용으로 제한한다.
+ Pro user 이상으로 제한한다.
⚠️ 반드시 `PUT /api/projects/{project_id}` 보다 먼저 등록해야 한다 — 아니면
"order" 가 project_id 로 매칭 시도되어(정수 변환 실패로 422) 이 라우트가
영영 실행되지 않는다(경로 매칭은 등록 순서, path param 특이도 무관).
"""
- _require_admin(request)
+ _require_pro(request)
st = _db_or_503(request)
ids = payload.get("ordered_ids") or []
if not isinstance(ids, list) or not ids:
@@ -1034,23 +1036,20 @@ def api_reorder_projects(
def api_update_project(
request: Request, project_id: int, payload: dict[str, Any] = Body(...)
) -> JSONResponse:
- from app.store import is_admin # noqa: WPS433
-
- user = _require_user(request)
+ """프로젝트 이름·설명·색·아이콘·날짜·완료·소유자 — Pro user 이상, 그 프로젝트 멤버(owner)일 때."""
+ user = _require_pro(request)
st = _db_or_503(request)
_require_manage(request, st, user, project_id)
fields = dict(payload)
if "owner_email" in fields:
- # 소유자는 멤버 목록과 별개로 계속 관리 권한을 준다 — 스스로를 소유자로 바꿔 권한 회수를
- # 피할 수 없게 관리자만. 값이 그대로면(화면이 같이 보낸 경우) 그냥 무시한다.
+ # 소유자는 멤버 목록과 별개로 계속 관리 권한을 준다 — Pro user 이상만(위 _require_pro).
+ # 값이 그대로면(화면이 같이 보낸 경우) 그냥 무시한다.
current = st.get_project(project_id=project_id)
if current is None:
raise HTTPException(status_code=404, detail="프로젝트를 찾을 수 없습니다.")
want = store.norm_str(fields.get("owner_email") or "", lower=True)
if want == store.norm_str(current.get("owner_email") or "", lower=True):
fields.pop("owner_email")
- elif not is_admin(user):
- raise HTTPException(status_code=403, detail=_OWNER_ADMIN_ONLY)
elif want:
_check_owner_candidate(want)
try:
@@ -1066,7 +1065,7 @@ def api_update_project(
@router.delete("/api/projects/{project_id}")
def api_delete_project(request: Request, project_id: int) -> JSONResponse:
- """프로젝트 삭제 — '만든 사람'만(슈퍼관리자 예외). 안의 업무도 CASCADE."""
+ """프로젝트 삭제 — Admin 이상은 누구 것이든, Pro user·User 는 '만든 사람'만. 안의 업무도 CASCADE."""
user = _require_user(request)
st = _db_or_503(request)
project = st.get_project(project_id=project_id)
@@ -1089,11 +1088,11 @@ def api_delete_project(request: Request, project_id: int) -> JSONResponse:
# ────────────────────────────────────────────────────────────
@router.get("/api/assignable-users")
def api_assignable_users(request: Request) -> JSONResponse:
- """배정 후보 = 등록된 사용자 중 프로젝트 권한(project 모듈) 보유자. 관리자 전용.
+ """배정 후보 = 등록된 사용자 중 프로젝트 권한(project 모듈) 보유자. Pro user 이상.
관리자 페이지의 '프로젝트 관리' 토글을 켠 직원이 자동으로 후보가 된다.
"""
- _require_admin(request)
+ _require_pro(request)
from app.main import user_store # noqa: WPS433
from app.store import has_module # noqa: WPS433
@@ -1176,8 +1175,8 @@ def api_list_members(request: Request, project_id: int) -> JSONResponse:
def api_add_member(
request: Request, project_id: int, payload: dict[str, Any] = Body(...)
) -> JSONResponse:
- """사용자를 프로젝트에 배정 — 관리자 전용(그 프로젝트를 볼 수 있는 관리자)."""
- user = _require_admin(request)
+ """사용자를 프로젝트에 배정 — Pro user 이상, 자기가 멤버(owner)인 프로젝트만."""
+ user = _require_pro(request)
st = _db_or_503(request)
_require_manage(request, st, user, project_id)
try:
@@ -1196,7 +1195,7 @@ def api_add_member(
def api_remove_member(
request: Request, project_id: int, user_email: str
) -> JSONResponse:
- user = _require_admin(request)
+ user = _require_pro(request)
st = _db_or_503(request)
_require_manage(request, st, user, project_id)
st.remove_member(project_id=project_id, user_email=user_email)
@@ -1272,8 +1271,8 @@ def _stage_of_project(st: Any, stage_id: int, project_id: int) -> dict[str, Any]
def api_delete_stage(
request: Request, project_id: int, stage_id: int
) -> JSONResponse:
- """세션(단계) 삭제 — 만든 사람만(슈퍼관리자 예외). 생성자 정보가 없는 과거
- 데이터는 관리자에게 허용(잠김 방지) — `_can_delete` 규칙 그대로 재사용."""
+ """세션(단계) 삭제 — Admin 이상은 누구 것이든, 그 밖은 만든 사람만. 생성자 정보가 없는 과거
+ 데이터는 Admin 이상(잠김 방지) — `_can_delete` 규칙 그대로 재사용."""
user = _require_user(request)
st = _db_or_503(request)
_require_manage(request, st, user, project_id)
@@ -1340,8 +1339,9 @@ def api_project_snapshot(request: Request, project_id: int, scope: str = "projec
@router.get("/api/projects/{project_id}/subtasks-summary")
def api_subtasks_summary(request: Request, project_id: int, scope: str = "project") -> JSONResponse:
"""대시보드 "담당자별 작업 합계" — 화면 업무 목록엔 세부 업무가 없어서(보드에 카드로 안 뜨게) 세부 업무만 따로.
- scope=project → 이 프로젝트(+여기 연결된) 최상위 업무의 세부 업무, scope=all → 볼 수 있는 모든 최상위 프로젝트(스냅샷과 같은 범위)."""
- user = _require_user(request)
+ scope=project → 이 프로젝트(+여기 연결된) 최상위 업무의 세부 업무, scope=all → 볼 수 있는 모든 최상위 프로젝트(스냅샷과 같은 범위).
+ 사람별 업무량 표라 Pro user 이상만."""
+ user = _require_pro(request)
st = _db_or_503(request)
_require_manage(request, st, user, project_id)
if scope == "all":
@@ -1535,10 +1535,8 @@ def api_delete_task(request: Request, task_id: int) -> JSONResponse:
user = _require_user(request)
st = _db_or_503(request)
existing = _task_or_404(st, task_id)
- # 만든 사람이어도 지금 원 소속 프로젝트 권한이 없으면(멤버에서 빠짐) 지울 수 없다.
+ # 작업 삭제(휴지통으로)는 원 소속 프로젝트 멤버 누구나(2026-10-12, 등급 무관) — 멤버에서 빠지면 못 지운다.
_require_task(st, user, existing, write=True)
- if not _can_delete(user, existing.get("created_by")):
- raise HTTPException(status_code=403, detail=_DELETE_DENIED)
try:
removed_task_ids, trash_id = st.delete_task(task_id=task_id, deleted_by=user["email"])
except KeyError:
@@ -2054,15 +2052,13 @@ def _comment_task_access(st: Any, user: dict[str, Any], comment_id: int) -> dict
def api_update_comment(
request: Request, comment_id: int, payload: dict[str, Any] = Body(...)
) -> JSONResponse:
- from app.store import is_admin # noqa: WPS433
-
user = _require_user(request)
st = _db_or_503(request)
_comment_task_access(st, user, comment_id)
try:
comment = st.update_comment(
comment_id=comment_id, requester=user["email"],
- is_admin=is_admin(user), body=payload.get("body", ""),
+ is_admin=access.is_pro(user), body=payload.get("body", ""),
)
except ValueError as exc:
raise HTTPException(status_code=400, detail=str(exc))
@@ -2075,14 +2071,12 @@ def api_update_comment(
@router.delete("/api/comments/{comment_id}")
def api_delete_comment(request: Request, comment_id: int) -> JSONResponse:
- from app.store import is_admin # noqa: WPS433
-
user = _require_user(request)
st = _db_or_503(request)
_comment_task_access(st, user, comment_id)
try:
files = st.delete_comment(
- comment_id=comment_id, requester=user["email"], is_admin=is_admin(user)
+ comment_id=comment_id, requester=user["email"], is_admin=access.is_pro(user)
)
except KeyError:
raise HTTPException(status_code=404, detail="댓글을 찾을 수 없습니다.")
@@ -2123,7 +2117,6 @@ def api_upload_attachment(
) -> JSONResponse:
"""comment_id 를 주면 댓글 채팅 팝업의 첨부(이미지/파일)로도 등록 —
같은 표에 저장되므로 업무 "첨부파일" 패널에도 그대로 함께 나온다."""
- from app.store import is_admin # noqa: WPS433
user = _require_user(request)
st = _db_or_503(request)
@@ -2133,8 +2126,8 @@ def api_upload_attachment(
comment = st.get_comment(comment_id=comment_id)
if comment is None or comment["task_id"] != task_id:
raise HTTPException(status_code=400, detail="잘못된 댓글입니다.")
- # 남의 댓글에 파일을 붙일 수 없다(작성자 본인·관리자만).
- if not is_admin(user) and store.norm_str(comment.get("author_email") or "", lower=True) != \
+ # 남의 댓글에 파일을 붙일 수 없다(작성자 본인·Pro user 이상만 — 댓글 수정 권한과 같음).
+ if not access.is_pro(user) and store.norm_str(comment.get("author_email") or "", lower=True) != \
store.norm_str(user["email"], lower=True):
raise HTTPException(status_code=403, detail="본인 댓글에만 파일을 붙일 수 있습니다.")
@@ -2468,7 +2461,7 @@ def notifier_page(request: Request) -> Any:
"project/notifier.html",
{
"user": user,
- "is_admin": admin,
+ **_role_ctx(user),
"nav_items": build_erp_nav(user, active="project"),
"nav_projects": _nav_projects(st, user, admin),
"goal_years": _goal_years_nav(st),
@@ -2594,13 +2587,12 @@ def api_mentions_read(
@router.get("/trash", response_class=HTMLResponse)
def trash_page(request: Request) -> HTMLResponse:
- """휴지통 — 관리자 전용. 지운 업무(세부 업무 포함)를 3개월 보관, 복구."""
+ """휴지통 — Pro user 이상. 지운 업무(세부 업무 포함)를 3개월 보관, 복구(멤버인 프로젝트 것만)."""
from app.main import build_erp_nav, render_template # noqa: WPS433
- from app.store import is_admin # noqa: WPS433
user = _require_user(request)
- if not is_admin(user):
- raise HTTPException(status_code=403, detail="관리자만 볼 수 있습니다.")
+ if not access.is_pro(user):
+ raise HTTPException(status_code=403, detail="Pro user 이상만 볼 수 있습니다.")
st = _store(request)
if st is None:
return _render_config_needed(request, user)
@@ -2611,14 +2603,14 @@ def trash_page(request: Request) -> HTMLResponse:
"project/trash.html",
{
"user": user,
- "is_admin": True,
+ **_role_ctx(user),
"nav_items": build_erp_nav(user, active="project"),
"nav_projects": _nav_projects(st, user, True),
"goal_years": _goal_years_nav(st),
"my_open_total": _my_open_count(st, user),
"mention_unread": _safe_mention_unread(st, user),
"page_title": "휴지통",
- "page_subtitle": "삭제한 작업 — 3개월 보관, 관리자만 복구",
+ "page_subtitle": "삭제한 작업 — 3개월 보관, Pro user 이상만 복구",
"force_sidebar_collapsed": True,
"color_palette": list(store.COLOR_PALETTE),
"project_icons": list(store.PROJECT_ICONS),
@@ -2659,8 +2651,8 @@ def _trash_view_items(items: list[dict[str, Any]]) -> list[dict[str, Any]]:
@router.post("/api/trash/{trash_id}/restore")
def api_restore_trash(request: Request, trash_id: int) -> JSONResponse:
- """휴지통 항목 복구 — 관리자 전용. 업무·세부 업무·댓글 등 원래 id 그대로."""
- user = _require_admin(request)
+ """휴지통 항목 복구 — Pro user 이상. 업무·세부 업무·댓글 등 원래 id 그대로."""
+ user = _require_pro(request)
st = _db_or_503(request)
if not any(int(it["id"]) == trash_id for it in _visible_trash(st, user)):
raise HTTPException(status_code=404, detail="휴지통 항목을 찾을 수 없습니다.") # 멤버가 아닌 프로젝트 것은 없는 것처럼
@@ -2679,7 +2671,6 @@ def help_page(request: Request) -> HTMLResponse:
"""프로젝트 관리 도움말 — 상단 바 ? 아이콘(새 탭). 처음 쓰는 사람을 위한 기능 설명.
DB 없이 그리는 정적 안내라 DB 설정 전에도 열린다."""
from app.main import build_erp_nav, render_template # noqa: WPS433
- from app.store import is_admin # noqa: WPS433
user = _require_user(request)
return render_template(
@@ -2687,7 +2678,7 @@ def help_page(request: Request) -> HTMLResponse:
"project/help.html",
{
"user": user,
- "is_admin": is_admin(user),
+ **_role_ctx(user),
"nav_items": build_erp_nav(user, active="project"),
"page_title": "프로젝트 관리 도움말",
"page_subtitle": "처음 쓰는 분을 위한 기능 안내",
@@ -2718,7 +2709,7 @@ def inbox_page(request: Request) -> HTMLResponse:
"project/inbox.html",
{
"user": user,
- "is_admin": admin,
+ **_role_ctx(user),
"nav_items": build_erp_nav(user, active="project"),
"nav_projects": nav_projects,
"goal_years": _goal_years_nav(st),
@@ -2738,7 +2729,7 @@ def inbox_page(request: Request) -> HTMLResponse:
# ────────────────────────────────────────────────────────────
# 연간 목표 (마이그레이션 013) — 사이드바 "목표" → 연도 → 목표 표
-# 조회: project 권한자 전원 · 입력/구조 변경: 관리자(is_admin) 전용
+# 조회: project 권한자 전원 · 입력/구조 변경: Pro user 이상(_require_pro)
# ────────────────────────────────────────────────────────────
_GOALS_MIGRATION_MSG = "연간 목표 기능이 아직 준비되지 않았습니다(DB 마이그레이션 013 필요)."
_GOALS_014_MSG = "분기 칸과 칸 병합은 DB 마이그레이션 014 가 필요합니다."
@@ -2855,7 +2846,7 @@ def goals_home(request: Request) -> RedirectResponse:
@router.get("/goals/{year}", response_class=HTMLResponse)
def goals_page(request: Request, year: int) -> HTMLResponse:
"""한 해 전체 목표 — 매출(목표·실적·달성)·로아스(목표·실적) 월별 숫자 +
- 업무 영역(상품·마케팅·컨텐츠·유통 …)별 연간·월별 글. 입력은 관리자만."""
+ 업무 영역(상품·마케팅·컨텐츠·유통 …)별 연간·월별 글. 입력은 Pro user 이상."""
from app.main import build_erp_nav, render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433
@@ -2891,7 +2882,7 @@ def goals_page(request: Request, year: int) -> HTMLResponse:
"project/goals.html",
{
"user": user,
- "is_admin": admin,
+ **_role_ctx(user),
"nav_items": build_erp_nav(user, active="project"),
"nav_projects": _nav_projects(st, user, admin),
"goal_years": _goal_years_nav(st),
@@ -2920,9 +2911,9 @@ def goals_page(request: Request, year: int) -> HTMLResponse:
@router.put("/api/goals/{year}/week-targets/{month}")
def api_set_goal_week_targets(request: Request, year: int, month: int, payload: dict[str, Any] = Body(...)) -> JSONResponse:
- """그 달 주차별 매출 목표 {month: 월 목표|"", weeks: {주차 시작일: 값|""}} — 월 목표는 직접 입력(관리자).
+ """그 달 주차별 매출 목표 {month: 월 목표|"", weeks: {주차 시작일: 값|""}} — 월 목표는 직접 입력(Pro user 이상).
month 가 없으면(예전 화면) 주차 합계를 월 목표로."""
- user = _require_admin(request)
+ user = _require_pro(request)
st = _db_or_503(request)
raw = payload.get("weeks")
if not isinstance(raw, dict) or len(raw) > 6:
@@ -2942,8 +2933,8 @@ def api_set_goal_week_targets(request: Request, year: int, month: int, payload:
@router.post("/api/goals/years")
def api_create_goal_year(request: Request, payload: dict[str, Any] = Body(...)) -> JSONResponse:
- """연도 추가(관리자) — 가장 가까운 이전 연도의 영역·줄 구조를 글 없이 복사."""
- user = _require_admin(request)
+ """연도 추가(Pro user 이상) — 가장 가까운 이전 연도의 영역·줄 구조를 글 없이 복사."""
+ user = _require_pro(request)
st = _db_or_503(request)
y = _goal_call(store.validate_goal_year, payload.get("year"))
_goal_call(st.create_goal_year, year=y, created_by=user["email"])
@@ -2978,7 +2969,7 @@ def api_goal_meeting_nav(request: Request) -> JSONResponse:
@router.put("/api/goals/{year}")
def api_update_goal_year(request: Request, year: int, payload: dict[str, Any] = Body(...)) -> JSONResponse:
- _require_admin(request)
+ _require_pro(request)
st = _db_or_503(request)
_goal_call(st.update_goal_year, year=year, sales_unit=payload.get("sales_unit", ""))
return JSONResponse({"ok": True})
@@ -2986,7 +2977,7 @@ def api_update_goal_year(request: Request, year: int, payload: dict[str, Any] =
@router.delete("/api/goals/{year}")
def api_delete_goal_year(request: Request, year: int) -> JSONResponse:
- _require_admin(request)
+ _require_pro(request)
st = _db_or_503(request)
_goal_call(st.delete_goal_year, year=year)
return JSONResponse({"ok": True})
@@ -2995,7 +2986,7 @@ def api_delete_goal_year(request: Request, year: int) -> JSONResponse:
@router.put("/api/goals/{year}/metrics")
def api_set_goal_metric(request: Request, year: int, payload: dict[str, Any] = Body(...)) -> JSONResponse:
"""매출/로아스 목표·실적 한 칸 — {metric, kind, month, value}. value 빈값 = 지움."""
- user = _require_admin(request)
+ user = _require_pro(request)
st = _db_or_503(request)
value = _goal_call(store.validate_goal_value, payload.get("value"))
_goal_call(
@@ -3008,7 +2999,7 @@ def api_set_goal_metric(request: Request, year: int, payload: dict[str, Any] = B
@router.post("/api/goals/{year}/areas")
def api_add_goal_area(request: Request, year: int, payload: dict[str, Any] = Body(...)) -> JSONResponse:
- _require_admin(request)
+ _require_pro(request)
st = _db_or_503(request)
aid = _goal_call(st.add_goal_area, year=year, name=payload.get("name", ""), color=payload.get("color", ""))
return JSONResponse({"ok": True, "id": aid}, status_code=201)
@@ -3016,7 +3007,7 @@ def api_add_goal_area(request: Request, year: int, payload: dict[str, Any] = Bod
@router.put("/api/goals/areas/{area_id}")
def api_update_goal_area(request: Request, area_id: int, payload: dict[str, Any] = Body(...)) -> JSONResponse:
- _require_admin(request)
+ _require_pro(request)
st = _db_or_503(request)
fields = {k: payload[k] for k in ("name", "color") if k in payload}
_goal_call(st.update_goal_area, area_id=area_id, fields=fields)
@@ -3025,7 +3016,7 @@ def api_update_goal_area(request: Request, area_id: int, payload: dict[str, Any]
@router.delete("/api/goals/areas/{area_id}")
def api_delete_goal_area(request: Request, area_id: int) -> JSONResponse:
- _require_admin(request)
+ _require_pro(request)
st = _db_or_503(request)
_goal_call(st.delete_goal_area, area_id=area_id)
return JSONResponse({"ok": True})
@@ -3033,7 +3024,7 @@ def api_delete_goal_area(request: Request, area_id: int) -> JSONResponse:
@router.post("/api/goals/areas/{area_id}/move")
def api_move_goal_area(request: Request, area_id: int, payload: dict[str, Any] = Body(...)) -> JSONResponse:
- _require_admin(request)
+ _require_pro(request)
st = _db_or_503(request)
_goal_call(st.move_goal_area, area_id=area_id, direction=int(payload.get("direction") or 0))
return JSONResponse({"ok": True})
@@ -3041,7 +3032,7 @@ def api_move_goal_area(request: Request, area_id: int, payload: dict[str, Any] =
@router.post("/api/goals/areas/{area_id}/rows")
def api_add_goal_row(request: Request, area_id: int, payload: dict[str, Any] = Body(...)) -> JSONResponse:
- _require_admin(request)
+ _require_pro(request)
st = _db_or_503(request)
# ref_row_id + place(above|below) 가 있으면 그 줄 위/아래에, 없으면 영역 맨 끝에
ref = payload.get("ref_row_id")
@@ -3057,7 +3048,7 @@ def api_add_goal_row(request: Request, area_id: int, payload: dict[str, Any] = B
@router.put("/api/goals/rows/{row_id}")
def api_update_goal_row(request: Request, row_id: int, payload: dict[str, Any] = Body(...)) -> JSONResponse:
- _require_admin(request)
+ _require_pro(request)
st = _db_or_503(request)
_goal_call(st.update_goal_row, row_id=row_id, label=payload.get("label", ""))
return JSONResponse({"ok": True})
@@ -3065,7 +3056,7 @@ def api_update_goal_row(request: Request, row_id: int, payload: dict[str, Any] =
@router.delete("/api/goals/rows/{row_id}")
def api_delete_goal_row(request: Request, row_id: int) -> JSONResponse:
- _require_admin(request)
+ _require_pro(request)
st = _db_or_503(request)
_goal_call(st.delete_goal_row, row_id=row_id)
return JSONResponse({"ok": True})
@@ -3074,7 +3065,7 @@ def api_delete_goal_row(request: Request, row_id: int) -> JSONResponse:
@router.post("/api/goals/rows/{row_id}/split-label")
def api_split_goal_label(request: Request, row_id: int) -> JSONResponse:
"""항목 칸 나누기 — 묶음 첫 줄 아래 이어 붙은 줄들을 각자 항목 칸으로(016)."""
- _require_admin(request)
+ _require_pro(request)
st = _db_or_503(request)
n = _goal_call(st.split_goal_label, row_id=row_id)
return JSONResponse({"ok": True, "split": n})
@@ -3082,7 +3073,7 @@ def api_split_goal_label(request: Request, row_id: int) -> JSONResponse:
@router.post("/api/goals/rows/{row_id}/move")
def api_move_goal_row(request: Request, row_id: int, payload: dict[str, Any] = Body(...)) -> JSONResponse:
- _require_admin(request)
+ _require_pro(request)
st = _db_or_503(request)
_goal_call(st.move_goal_row, row_id=row_id, direction=int(payload.get("direction") or 0))
return JSONResponse({"ok": True})
@@ -3094,7 +3085,7 @@ def api_set_goal_cell(
) -> JSONResponse:
"""업무 영역 칸 글 — month 0 = 연간, 1~12 = 월, 분기 칸 13 = 1분기 · 15 = 2분기 · 14 = 3분기 · 16 = 4분기
(014, 15·16 은 017). 빈 글 = 지움."""
- user = _require_admin(request)
+ user = _require_pro(request)
st = _db_or_503(request)
_goal_call(
st.set_goal_cell, row_id=row_id, month=month,
@@ -3106,7 +3097,7 @@ def api_set_goal_cell(
@router.post("/api/goals/cells/move")
def api_move_goal_cell(request: Request, payload: dict[str, Any] = Body(...)) -> JSONResponse:
"""내용·글자 서식만 원자적으로 이동. 원본·대상의 예상값이 바뀌면 409, 병합 배치는 유지."""
- user = _require_admin(request)
+ user = _require_pro(request)
st = _db_or_503(request)
if any(not isinstance(payload.get(k), str) for k in ("source_body", "target_body", "body")):
raise HTTPException(status_code=400, detail="이동할 내용과 두 칸의 현재 내용을 보내 주세요.")
@@ -3123,7 +3114,7 @@ def api_move_goal_cell(request: Request, payload: dict[str, Any] = Body(...)) ->
def api_merge_goal_rect(request: Request, area_id: int, payload: dict[str, Any] = Body(...)) -> JSONResponse:
"""엑셀식 병합 {row_from, row_to(줄 id), col_from, col_to(칸 번호 0·1~12·13~16)} — 같은 영역 안 사각형,
가로는 같은 분기 월 칸끼리. 걸친 병합은 흡수, 글은 왼쪽 위부터 이어서 왼쪽 위 칸에."""
- user = _require_admin(request)
+ user = _require_pro(request)
st = _db_or_503(request)
res = _goal_call(
st.merge_goal_rect, area_id=area_id, row_from=payload.get("row_from"), row_to=payload.get("row_to"),
@@ -3135,7 +3126,7 @@ def api_merge_goal_rect(request: Request, area_id: int, payload: dict[str, Any]
@router.delete("/api/goals/rows/{row_id}/merge/{start}")
def api_unmerge_goal_cells(request: Request, row_id: int, start: int) -> JSONResponse:
"""병합 해제 — 글은 왼쪽 위(시작) 칸에 남는다(엑셀과 같음)."""
- _require_admin(request)
+ _require_pro(request)
st = _db_or_503(request)
_goal_call(st.unmerge_goal_cells, row_id=row_id, start=start)
return JSONResponse({"ok": True})
@@ -3386,7 +3377,7 @@ def _parse_attendees(text: str, members: list[dict[str, str]]) -> list[dict[str,
@router.get("/goals/{year}/meetings/{month}", response_class=HTMLResponse)
def goal_meeting_page(request: Request, year: int, month: int, week: str | None = None, content: bool = False) -> HTMLResponse:
- """주간 회의록 — 그 달과 겹치는 주(월~일) 탭, 주마다 회의록 하나. 입력은 관리자만(목표 표와 같음)."""
+ """주간 회의록 — 그 달과 겹치는 주(월~일) 탭, 주마다 회의록 하나. 글 수정은 누구나(완료 전까지), 완료·삭제는 Pro user 이상."""
from app.main import build_erp_nav, render_template # noqa: WPS433
from app.store import has_module, is_admin # noqa: WPS433
@@ -3424,7 +3415,7 @@ def goal_meeting_page(request: Request, year: int, month: int, week: str | None
"project/goal_meeting.html",
{
"user": user,
- "is_admin": admin,
+ **_role_ctx(user),
"nav_items": build_erp_nav(user, active="project"),
"nav_projects": _nav_projects(st, user, admin),
"goal_years": _goal_years_nav(st),
@@ -3534,8 +3525,8 @@ def api_open_meeting_board(request: Request, week_start: str) -> JSONResponse:
@router.post("/api/goals/meetings/{week_start}/complete")
def api_complete_meeting(request: Request, week_start: str, payload: dict[str, Any] = Body(default={})) -> JSONResponse:
- """회의 완료(수정 잠금) {done: true} · 완료 해제 {done: false} — 관리자만(2026-10-07, 마이그레이션 022)."""
- user = _require_admin(request)
+ """회의 완료(수정 잠금) {done: true} · 완료 해제 {done: false} — Pro user 이상(2026-10-12, 마이그레이션 022)."""
+ user = _require_pro(request)
st = _db_or_503(request)
ws = _goal_call(store.validate_week_start, week_start)
done = payload.get("done", True) is not False
@@ -3545,7 +3536,7 @@ def api_complete_meeting(request: Request, week_start: str, payload: dict[str, A
@router.delete("/api/goals/meetings/{week_start}")
def api_delete_meeting(request: Request, week_start: str) -> JSONResponse:
- _require_admin(request)
+ _require_pro(request)
st = _db_or_503(request)
ws = _goal_call(store.validate_week_start, week_start)
_goal_call(st.delete_meeting, week_start=ws)
diff --git a/app/modules/project/templates/project/_side.html b/app/modules/project/templates/project/_side.html
index 8686fe0..4d2c25e 100644
--- a/app/modules/project/templates/project/_side.html
+++ b/app/modules/project/templates/project/_side.html
@@ -1,6 +1,6 @@
{# ── 프로젝트 모듈 좌측 사이드바 (공용) ──────────────────────────────
수신함·내 업무·휴지통·프로젝트 화면이 함께 쓴다 — 어느 화면이든 프로젝트
- 목록은 똑같다(관리자: 드래그 순서 변경·✎ 수정·× 삭제·우클릭 메뉴).
+ 목록은 똑같다(Pro user 이상: 드래그 순서 변경·✎ 수정·× 삭제·우클릭 메뉴).
변수:
mention_unread 미확인 @태그 개수 (수신함 배지)
@@ -10,7 +10,8 @@
side_active 'inbox' | 'mytasks' | 'trash' | 'goals' | '' — 개인 메뉴 활성 표시
goal_years "목표" 아래 연도 목록(router._goal_years_nav — 올해는 항상 포함)
goal_year_active 목표 화면에서 보고 있는 연도
- is_admin 프로젝트 생성/수정/삭제 권한
+ pj_pro Pro user 이상 — 프로젝트 생성·수정·순서·전체 보기·휴지통·전체 멤버·연도 추가
+ pj_admin Admin 이상 — 남이 만든 프로젝트도 삭제(그 밖은 만든 사람만)
목록 동작은 project.js 의 initSideTree(첫 화면을 같은 마크업으로 다시 그림),
새 프로젝트/수정 모달은 각 화면이 include 하는 project/_side_modals.html. #}
{# 날짜 팝업(openDatePopover)이 공휴일을 빨강으로 칠할 때 쓰는 표 — 이 사이드바는
@@ -19,7 +20,7 @@
{# 모든 프로젝트 화면에서 같은 회의록 트리를 사용한다. #}
-