diff --git a/CLAUDE.md b/CLAUDE.md index 04018e2..5d07bd7 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 를 댓글 사이에 표시(댓글 수 제외), 댓글 `@아이디` 는 아이콘+이름 칩. 수신함 "확인"은 페이지 이동 없이 오른쪽 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`) — 프로젝트 목록(순서 변경·✎·×)은 어느 화면에서나 같다. 보드는 아사나처럼 섹션이 가로로 계속 늘어나고(넘치면 가로 스크롤) 카드의 담당자·마감일을 클릭해 그 자리에서 바꾼다. 좌측 사이드바에 수신함·전체 보기(관리자만 — 예전 오른쪽 위 "전체 프로젝트" 토글, `?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/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/access.py b/app/modules/project/access.py index 6536e65..c8c539c 100644 --- a/app/modules/project/access.py +++ b/app/modules/project/access.py @@ -12,7 +12,7 @@ 작업 FULL : 원 소속 프로젝트를 관리할 수 있음 → 보기·수정·댓글·첨부·삭제(삭제는 추가로 생성자 규칙) READ : 원 소속 권한은 없지만, 이 작업(또는 상위 작업)이 연결된(멀티호밍) 프로젝트를 관리할 수 있음 - → 그 작업의 상세·하위 작업 목록·댓글·첨부 보기만. 원 소속의 다른 작업·멤버는 보이지 않는다. + → 그 작업의 상세·세부 작업 목록·댓글·첨부 보기만. 원 소속의 다른 작업·멤버는 보이지 않는다. 연결된 프로젝트 안에서의 섹션 이동(POST /links, 이미 연결된 경우)은 예전처럼 허용. None : 권한 없음 → 403/목록에서 제외/알림·메일 대상 제외 """ diff --git a/app/modules/project/db.py b/app/modules/project/db.py index d48d02c..336a5b9 100644 --- a/app/modules/project/db.py +++ b/app/modules/project/db.py @@ -417,9 +417,9 @@ class ProjectStore: ) -> list[dict[str, Any]]: """업무 목록. - 기본은 최상위 업무만(`parent_task_id IS NULL`) — 하위 업무는 부모 안에서만 + 기본은 최상위 업무만(`parent_task_id IS NULL`) — 세부 업무는 부모 안에서만 보인다(아사나와 동일, 보드/캘린더/리스트 카드로 따로 뜨지 않는다). - `parent_task_id` 를 주면 그 부모의 하위 업무만 받는다. + `parent_task_id` 를 주면 그 부모의 세부 업무만 받는다. `project_id` 하나만 지정하고(`include_subprojects=False`, 최상위 조회일 때) `include_links=True`(기본값)이면, 그 프로젝트에 멀티호밍 @@ -487,7 +487,7 @@ class ProjectStore: ) def list_subtasks_of(self, *, parent_ids: list[int]) -> list[dict[str, Any]]: - """하위 업무 요약(대시보드 담당자별 집계·업무 목록 패널용) — id·부모·제목·마감일·완료·담당자.""" + """세부 업무 요약(대시보드 담당자별 집계·업무 목록 패널용) — id·부모·제목·마감일·완료·담당자.""" ids = sorted({int(i) for i in parent_ids}) if not ids: return [] @@ -565,7 +565,7 @@ class ProjectStore: return [self._serialize(r) for r in rows] def count_my_open(self, *, assignee_email: str) -> int: - """사이드바 "내 업무" 배지 — 내가 담당인 미완료 업무 수(하위 업무 포함, + """사이드바 "내 업무" 배지 — 내가 담당인 미완료 업무 수(세부 업무 포함, 내 업무 화면 목록과 같은 기준).""" with self._pool.connection() as conn: row = conn.execute( @@ -577,7 +577,7 @@ class ProjectStore: def list_my_tasks(self, *, assignee_email: str, limit: int = 1000) -> list[dict[str, Any]]: """"내 업무" 화면 전용 — 내가 담당자인 업무를 레벨(최상위/하위) 상관없이 - 전부 반환한다. 하위 업무 행에는 부모 업무 정보(`parent_title` 등)를 같이 + 전부 반환한다. 세부 업무 행에는 부모 업무 정보(`parent_title` 등)를 같이 붙여서, 부모가 내 업무가 아니어도(다른 사람 담당) 화면에서 트리로 묶어 보여줄 수 있게 한다. """ @@ -643,7 +643,7 @@ class ProjectStore: with self._pool.connection() as conn: with conn.transaction(): if parent_task_id is not None: - # 하위 업무는 부모와 같은 프로젝트에 속하고(담당자 선택지 등이 + # 세부 업무는 부모와 같은 프로젝트에 속하고(담당자 선택지 등이 # 맞아떨어지게), 보드에는 안 보이므로 세션을 갖지 않는다. parent = conn.execute( "SELECT project_id FROM tasks WHERE id = %s", (parent_task_id,) @@ -652,7 +652,7 @@ class ProjectStore: raise KeyError(f"상위 작업을 찾을 수 없습니다: {parent_task_id}") # 권한은 URL 의 project_id 로 검사했으므로, 부모가 다른 프로젝트 # 업무면 거부한다(예전엔 부모 프로젝트로 조용히 바꿔 권한 없는 - # 프로젝트에 하위 업무를 만들 수 있었다). + # 프로젝트에 세부 업무를 만들 수 있었다). if int(parent["project_id"]) != int(project_id): raise ValueError("상위 작업이 이 프로젝트에 속하지 않습니다.") stage_id = None @@ -666,7 +666,7 @@ class ProjectStore: (project_id,), ).fetchone() stage_id = st["id"] if st else None - # 담당자 없이 만들면 그 세션의 기본 담당자를 배정(하위 업무는 + # 담당자 없이 만들면 그 세션의 기본 담당자를 배정(세부 업무는 # 세션이 없어 해당 없음). if not assignee and stage_id is not None: assignee, assignee_name = self._stage_default_assignee(conn, stage_id, project_id) @@ -711,12 +711,12 @@ class ProjectStore: def move_subtask( self, *, task_id: int, parent_task_id: int, actor: str = "" ) -> dict[str, Any]: - """하위 업무를 다른 상위 업무 밑으로 옮긴다(보드 카드로 드래그). + """세부 업무를 다른 상위 업무 밑으로 옮긴다(보드 카드로 드래그). 받는 쪽은 보드 카드 = 최상위 업무만 허용한다 — 그래서 자기 자신이나 자기 하위로 옮기는 순환이 생기지 않는다. 같은 프로젝트 안에서만 - (하위 업무는 부모와 같은 프로젝트에 속한다 — create_task 와 같은 규칙). - 하위 업무의 하위 업무는 그대로 따라간다. 목록 끝(sort_order 최대+1)으로. + (세부 업무는 부모와 같은 프로젝트에 속한다 — create_task 와 같은 규칙). + 세부 업무의 세부 업무는 그대로 따라간다. 목록 끝(sort_order 최대+1)으로. """ with self._pool.connection() as conn: with conn.transaction(): @@ -728,7 +728,7 @@ class ProjectStore: if not sub: raise KeyError(f"작업을 찾을 수 없습니다: {task_id}") if sub["parent_task_id"] is None: - raise ValueError("하위 작업만 다른 작업으로 옮길 수 있습니다.") + raise ValueError("세부 작업만 다른 작업으로 옮길 수 있습니다.") parent = conn.execute( "SELECT id, project_id, parent_task_id, title FROM tasks WHERE id = %s", (parent_task_id,), @@ -736,7 +736,7 @@ class ProjectStore: if not parent: raise KeyError(f"상위 작업을 찾을 수 없습니다: {parent_task_id}") if parent["parent_task_id"] is not None: - raise ValueError("하위 작업 안으로는 옮길 수 없습니다.") + raise ValueError("세부 작업 안으로는 옮길 수 없습니다.") if int(parent["project_id"]) != int(sub["project_id"]): raise ValueError("다른 프로젝트의 작업으로는 옮길 수 없습니다.") if int(parent["id"]) != int(sub["parent_task_id"]): @@ -839,7 +839,7 @@ class ProjectStore: newly_completed = True elif not done and prev.get("completed_at"): sets.append("completed_at = NULL") - # 직접 완료 토글 — 하위 업무는 세션(칸반 컬럼)이 없어 위 자동 세팅이 + # 직접 완료 토글 — 세부 업무는 세션(칸반 컬럼)이 없어 위 자동 세팅이 # 적용되지 않는다. "stage_id" 를 같이 보냈으면 그쪽 판정이 우선한다. elif "completed" in fields: if fields["completed"] and not prev.get("completed_at"): @@ -917,7 +917,7 @@ class ProjectStore: return payload def delete_task(self, *, task_id: int, deleted_by: str = "") -> tuple[list[int], int | None]: - """업무(+하위 업무 CASCADE) 삭제 → (지워진 업무 id 목록, 휴지통 id). + """업무(+세부 업무 CASCADE) 삭제 → (지워진 업무 id 목록, 휴지통 id). 휴지통 테이블(010)이 있으면 지우기 직전 스냅샷을 같은 트랜잭션에서 남긴다 (스냅샷 저장이 실패하면 삭제도 취소). 없으면 휴지통 id 는 None — 예전처럼 @@ -1007,7 +1007,7 @@ class ProjectStore: 행은 지운다. 복구할 수 없으면 ValueError(사유), 없으면 KeyError. - 같은 id 의 업무가 이미 있으면 거부(두 번 복구 방지). - - 프로젝트가 지워졌으면 거부. 하위 업무만 지웠던 경우 상위 업무가 없으면 거부. + - 프로젝트가 지워졌으면 거부. 세부 업무만 지웠던 경우 상위 업무가 없으면 거부. - 세션이 지워졌으면 세션 없이(미지정), 연결/이력 중 지워진 프로젝트를 가리키는 행은 뺀다.""" with self._pool.connection() as conn: @@ -1486,7 +1486,7 @@ class ProjectStore: ) def reorder_subtasks(self, *, parent_task_id: int, ordered_ids: list[int]) -> None: - """작업 팝업의 하위 작업 목록 드래그 재정렬 — 이 상위 작업의 하위 작업만 + """작업 팝업의 세부 작업 목록 드래그 재정렬 — 이 상위 작업의 세부 작업만 0부터 다시 매긴다(목록은 parent_task_id 로 먼저 거른 뒤 sort_order 순).""" with self._pool.connection() as conn: conn.execute( @@ -1818,7 +1818,7 @@ class ProjectStore: def search_tasks( self, *, query: str, project_ids: set[int] | None, limit: int = 30, ) -> list[dict[str, Any]]: - """제목/설명/댓글에 검색어가 들어간 업무(하위 업무 포함). + """제목/설명/댓글에 검색어가 들어간 업무(세부 업무 포함). project_ids 가 None 이면 전체(관리자), 아니면 그 프로젝트들만. 설명은 HTML 이라 태그 이름·속성에만 걸린 경우(예: "img")를 걸러내려고 @@ -1865,7 +1865,7 @@ class ProjectStore: # 마감 알림 (task_reminders, 마이그레이션 008) — reminders.py 가 부른다 # ════════════════════════════════════════════════════════════ def list_open_tasks_due_between(self, *, start: date, end: date) -> list[dict[str, Any]]: - """미완료 + 마감일이 [start, end] 인 업무(하위 업무 포함) + 팔로워 목록. + """미완료 + 마감일이 [start, end] 인 업무(세부 업무 포함) + 팔로워 목록. 보관(archived) 프로젝트는 뺀다.""" with self._pool.connection() as conn: rows = conn.execute( @@ -1913,7 +1913,7 @@ class ProjectStore: def task_link_scope(self, *, task_ids: list[int]) -> dict[int, set[int]]: """작업 id → 이 작업 또는 그 상위 작업들이 연결(멀티호밍)된 프로젝트 id 집합. - 연결된 프로젝트 멤버가 그 작업(과 하위 작업)을 읽기 전용으로 볼 수 있는지 판단한다.""" + 연결된 프로젝트 멤버가 그 작업(과 세부 작업)을 읽기 전용으로 볼 수 있는지 판단한다.""" ids = sorted({int(i) for i in task_ids}) if not ids: return {} diff --git a/app/modules/project/router.py b/app/modules/project/router.py index 9d3213b..466aede 100644 --- a/app/modules/project/router.py +++ b/app/modules/project/router.py @@ -740,7 +740,7 @@ def task_permalink(request: Request, task_id: int): if target is None: return _denied("이 작업을 볼 권한이 없습니다.", 403) - # 하위 업무도 업무처럼 자기 팝업으로 연다(아사나식 — 제목 위에 상위 업무 경로). + # 세부 업무도 업무처럼 자기 팝업으로 연다(아사나식 — 제목 위에 상위 업무 경로). return RedirectResponse(url=f"/project/p/{target}?task={task_id}", status_code=303) @@ -1339,8 +1339,8 @@ 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 → 볼 수 있는 모든 최상위 프로젝트(스냅샷과 같은 범위).""" + """대시보드 "담당자별 작업 합계" — 화면 업무 목록엔 세부 업무가 없어서(보드에 카드로 안 뜨게) 세부 업무만 따로. + scope=project → 이 프로젝트(+여기 연결된) 최상위 업무의 세부 업무, scope=all → 볼 수 있는 모든 최상위 프로젝트(스냅샷과 같은 범위).""" user = _require_user(request) st = _db_or_503(request) _require_manage(request, st, user, project_id) @@ -1547,21 +1547,21 @@ def api_delete_task(request: Request, task_id: int) -> JSONResponse: if trash_id is not None: _move_task_dirs_to_trash(request, removed_task_ids, trash_id) else: - _remove_task_dirs(request, removed_task_ids) # 하위 업무 첨부 폴더까지 + _remove_task_dirs(request, removed_task_ids) # 세부 업무 첨부 폴더까지 _purge_trash(request, st) return JSONResponse({"ok": True, "trash": trash_id is not None, "count": len(removed_task_ids)}) @router.get("/api/tasks/{task_id}") def api_get_task(request: Request, task_id: int) -> JSONResponse: - """업무 상세 — 하위 업무·연결된 프로젝트 포함. 업무 편집 팝업을 열 때 쓴다.""" + """업무 상세 — 세부 업무·연결된 프로젝트 포함. 업무 편집 팝업을 열 때 쓴다.""" user = _require_user(request) st = _db_or_503(request) task = _task_or_404(st, task_id) # 원 소속 권한(FULL) 또는 연결된 프로젝트의 읽기 권한(READ). READ 면 화면이 읽기 전용으로 연다. level = _require_task(st, user, task, write=False) task["access"] = level - # 하위 업무를 팝업으로 열면 제목 위에 상위 업무 경로를 보여준다(아사나식). + # 세부 업무를 팝업으로 열면 제목 위에 상위 업무 경로를 보여준다(아사나식). if task.get("parent_task_id"): parent = st.get_task(task_id=task["parent_task_id"]) task["parent_title"] = parent["title"] if parent else "" @@ -1586,7 +1586,7 @@ def api_get_task(request: Request, task_id: int) -> JSONResponse: def api_reorder_subtasks( request: Request, task_id: int, payload: dict[str, Any] = Body(...) ) -> JSONResponse: - """작업 팝업의 하위 작업 목록을 드래그로 재정렬. body: {"ordered_ids": [...]}""" + """작업 팝업의 세부 작업 목록을 드래그로 재정렬. body: {"ordered_ids": [...]}""" user = _require_user(request) st = _db_or_503(request) parent = _task_or_404(st, task_id) @@ -1608,7 +1608,7 @@ def api_move_subtask( task_id: int, payload: dict[str, Any] = Body(...), ) -> JSONResponse: - """하위 업무를 다른 상위 업무로 옮긴다 — 보드에서 하위 업무 줄을 다른 카드로 드래그. + """세부 업무를 다른 상위 업무로 옮긴다 — 보드에서 세부 업무 줄을 다른 카드로 드래그. body: {"parent_task_id": 받는 업무 id}. 받는 업무는 같은 프로젝트의 최상위 업무만. """ @@ -1698,7 +1698,7 @@ def api_remove_follower(request: Request, task_id: int, email: str) -> JSONRespo # ──────────────────────────────────────────────────────────── @router.get("/api/search") def api_search(request: Request, q: str = "", limit: int = 20) -> JSONResponse: - """제목·설명·댓글 검색 — 내가 볼 수 있는 프로젝트의 업무(하위 업무 포함). + """제목·설명·댓글 검색 — 내가 볼 수 있는 프로젝트의 업무(세부 업무 포함). 설명은 HTML 이라 DB 에서는 넉넉히 가져온 뒤 본문 텍스트에 실제로 검색어가 있는지 다시 확인한다(태그 이름·속성에만 걸린 결과 제거). 결과마다 어디서 @@ -2594,7 +2594,7 @@ def api_mentions_read( @router.get("/trash", response_class=HTMLResponse) def trash_page(request: Request) -> HTMLResponse: - """휴지통 — 관리자 전용. 지운 업무(하위 업무 포함)를 3개월 보관, 복구.""" + """휴지통 — 관리자 전용. 지운 업무(세부 업무 포함)를 3개월 보관, 복구.""" from app.main import build_erp_nav, render_template # noqa: WPS433 from app.store import is_admin # noqa: WPS433 @@ -2659,7 +2659,7 @@ 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 그대로.""" + """휴지통 항목 복구 — 관리자 전용. 업무·세부 업무·댓글 등 원래 id 그대로.""" user = _require_admin(request) st = _db_or_503(request) if not any(int(it["id"]) == trash_id for it in _visible_trash(st, user)): @@ -2705,8 +2705,9 @@ def inbox_page(request: Request) -> HTMLResponse: if st is None: return _render_config_needed(request, user) admin = is_admin(user) - items = _visible_notifications(st, user, st.list_notifications(recipient_email=user["email"], limit=100)) - mentioned = _safe_mentions(st, user) + # 수신함 = 아직 확인 안 한 것만(2026-10-08) — 누르면 읽음/확인 처리되고 목록에서 빠진다. + items = _visible_notifications(st, user, st.list_notifications(recipient_email=user["email"], unread_only=True, limit=100)) + mentioned = [t for t in _safe_mentions(st, user) if t.get("unread_mentions")] for t in mentioned: t["due_label"] = _fmt_date_kr(t.get("due_date")) # 좌측 사이드바(project/_side.html)는 세 화면 공용 — 같은 데이터가 필요하다. diff --git a/app/modules/project/store.py b/app/modules/project/store.py index ca8b9a7..880a215 100644 --- a/app/modules/project/store.py +++ b/app/modules/project/store.py @@ -40,7 +40,7 @@ ACTION_ASSIGNED = "assigned" ACTION_COMPLETED = "completed" ACTION_STAGE_CHANGED = "stage_changed" ACTION_REOPENED = "reopened" -ACTION_SUBTASK_MOVED = "subtask_moved" # 하위 업무를 다른 상위 업무로 옮김(보드 드래그) +ACTION_SUBTASK_MOVED = "subtask_moved" # 세부 업무를 다른 상위 업무로 옮김(보드 드래그) # 프로젝트 색상 팔레트 — 32색(8칸 × 4줄). 앞 16색은 아사나 프로젝트 색(아사나 색상표 # 순서 그대로), 뒤 16색은 같은 칸(열)에 대응하는 진한 색 — 3줄째 = 1줄째의 진한 색, diff --git a/app/modules/project/templates/project/_side.html b/app/modules/project/templates/project/_side.html index 0afe21e..8686fe0 100644 --- a/app/modules/project/templates/project/_side.html +++ b/app/modules/project/templates/project/_side.html @@ -22,7 +22,7 @@