diff --git a/CLAUDE.md b/CLAUDE.md index 8a384e4..2000c99 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` 칸반, 새 프로젝트는 섹션 없이 시작 — `create_project(seed_stages=True)` 일 때만 기본 4단계, 섹션 머리는 모두 `#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일~오늘)·누적 목표 대비 차액·%) | ② 결정 사항·메모 | ③ "N주차 작업 등록" 표(제목·담당자·프로젝트·섹션 → [적용] = 서버가 그 프로젝트에 작업 생성, `initMeetQuickTasks` — 주차별 서버 표 `goal_meeting_tasks`(마이그레이션 025)라 모두가 같이 보고, 남의 프로젝트 이름은 가림, 완료 프로젝트·섹션은 목록에서 뺌, 작업 칸(마이그레이션 026 `parent_task_id`) = 이미 있는 작업을 고르면 그 작업의 세부 작업으로 등록, 등록된 줄 제목 = 오른쪽 작업 창(편집, 저장 대기), [크게 열기] = 같은 표를 넓은 창으로), 실적 모듈 `performance_store` 매출은 머리 카드에만 읽기 전용 — 줄(쇼핑몰)별 자동 결과·이번주 실적·연결 배지·쇼핑몰 연결 메뉴는 폐지, 지난주 결과는 늘 직접 입력). 모든 열 너비 끌어서 조절(localStorage `pj_goal_col_w`), 세로 스크롤 틀 고정은 머리 줄+매출·로아스 줄까지, 항목 칸 +·우클릭으로 줄 위/아래 추가·삭제, 회의록 "주요 업무" 칸 우클릭 위/아래 줄 추가 = 항목 칸은 그대로 그 항목 안에(마이그레이션 027 `label_cont`, 항목 칸 나누기), 회의록 줄 작업은 새로고침 없이 제자리 다시 그리기(`refreshMeeting`)+애니메이션, 구분(구역) 칸 우클릭·⋯ = 구역 통째로 위/아래(`move-section`). 마감 알림(`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 패널, 다른 줄을 고르거나 패널을 닫으면 그 줄은 목록에서 빠짐. 용어는 **"업무"**(2026-10-13 "작업"에서 다시 통일 — 화면·메시지·알림 제목, 코드·DB 는 그대로)·"세부 업무"·"메인 업무 추가". 섹션 제목 오른쪽 담당자 아이콘 = 그 자리에서 기본 담당자 지정, 업무 창 세부 업무 줄 담당자 오른쪽 = 협업자 지정, 댓글 이모티콘 반응 = 댓글 쓴 사람에게 알림(`type=reaction`), 왼쪽 전체 보기 = 기본 대시보드, 대시보드 업무 목록 패널에서 연 업무 창은 패널 왼쪽에(docs/PROJECT_MODULE.md 6-16). 세부 업무를 만들 때(업무 창 추가 칸·보드 카드 새 줄) 협업자도 같이(`POST …/tasks` 의 `followers`, 비멤버 400), 보드 카드 세부 업무 줄에도 협업자 아이콘, 대시보드 "업무 합계(프로젝트별)" 카드, **마감 지난 내 업무 위쪽 알림**(`static/erp-overdue.js`, ERP 모든 화면, `GET /project/api/my-overdue`, 닫으면 1시간 뒤 다시 — 새로 지난 업무는 바로)(6-17). 패널(`/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` 칸반, 새 프로젝트는 섹션 없이 시작 — `create_project(seed_stages=True)` 일 때만 기본 4단계, 섹션 머리는 모두 `#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일~오늘)·누적 목표 대비 차액·%) | ② 결정 사항·메모 | ③ "N주차 작업 등록" 표(제목·담당자·프로젝트·섹션 → [적용] = 서버가 그 프로젝트에 작업 생성, `initMeetQuickTasks` — 주차별 서버 표 `goal_meeting_tasks`(마이그레이션 025)라 모두가 같이 보고, 남의 프로젝트 이름은 가림, 완료 프로젝트·섹션은 목록에서 뺌, 작업 칸(마이그레이션 026 `parent_task_id`) = 이미 있는 작업을 고르면 그 작업의 세부 작업으로 등록, 등록된 줄 제목 = 오른쪽 작업 창(편집, 저장 대기), [크게 열기] = 같은 표를 넓은 창으로), 실적 모듈 `performance_store` 매출은 머리 카드에만 읽기 전용 — 줄(쇼핑몰)별 자동 결과·이번주 실적·연결 배지·쇼핑몰 연결 메뉴는 폐지, 지난주 결과는 늘 직접 입력). 모든 열 너비 끌어서 조절(localStorage `pj_goal_col_w`), 세로 스크롤 틀 고정은 머리 줄+매출·로아스 줄까지, 항목 칸 +·우클릭으로 줄 위/아래 추가·삭제, 회의록 "주요 업무" 칸 우클릭 위/아래 줄 추가 = 항목 칸은 그대로 그 항목 안에(마이그레이션 027 `label_cont`, 항목 칸 나누기), 회의록 줄 작업은 새로고침 없이 제자리 다시 그리기(`refreshMeeting`)+애니메이션, 구분(구역) 칸 우클릭·⋯ = 구역 통째로 위/아래(`move-section`). 마감 알림(`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 패널, 다른 줄을 고르거나 패널을 닫으면 그 줄은 목록에서 빠짐. 용어는 **"업무"**(2026-10-13 "작업"에서 다시 통일 — 화면·메시지·알림 제목, 코드·DB 는 그대로)·"세부 업무"·"메인 업무 추가". 섹션 제목 오른쪽 담당자 아이콘 = 그 자리에서 기본 담당자 지정, 업무 창 세부 업무 줄 담당자 오른쪽 = 협업자 지정, 댓글 이모티콘 반응 = 댓글 쓴 사람에게 알림(`type=reaction`), 왼쪽 전체 보기 = 기본 대시보드, 대시보드 업무 목록 패널에서 연 업무 창은 패널 왼쪽에(docs/PROJECT_MODULE.md 6-16). 세부 업무를 만들 때(업무 창 추가 칸·보드 카드 새 줄) 협업자도 같이(`POST …/tasks` 의 `followers`, 비멤버 400), 보드 카드 세부 업무 줄에도 협업자 아이콘, 대시보드 "업무 합계(프로젝트별)" 카드, **마감 지난 내 업무 위쪽 알림**(`static/erp-overdue.js`, ERP 모든 화면, `GET /project/api/my-overdue`, 닫으면 1시간 뒤 다시 — 새로 지난 업무는 바로)(6-17). **업무를 다른 프로젝트로 이동** — 보드 카드를 왼쪽 프로젝트 목록에 끌어 놓으면 섹션 선택 창 → `POST /project/api/tasks/{id}/move-project`(세부 업무 함께, 원 소속 권한 + 대상 프로젝트 멤버)(6-18). 패널(`/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`. 매출 업데이트 진행 창에서 쇼핑몰별 [중지](그 쇼핑몰만 멈추고 다음 쇼핑몰로). **자동 업데이트**(`auto_sync.py`, 웹 프로세스 데몬 스레드) — 매일 09~19시 정각·30분마다 오늘 포함 최근 10일, 진행 창 작업으로 돌고 다른 업데이트 중이면 그 회차 건너뜀, env `PERFORMANCE_AUTO_SYNC`·`_DAYS`·`_HOURS`. 카페24 어댑터는 기존 `app/integrations/cafe24` 토큰 재사용. 1단계는 모의 데이터(`is_sample`)·구조까지, 실제 수집은 쇼핑몰별로 공식 문서 확인 후 순차 구현. 쿠팡은 판매자배송 발주서 + 로켓그로스 주문을 결제일로 합산(WING 판매분석 대조는 원본 데이터 확인으로). 설정의 쇼핑몰별 **수동 입력** 토글(마이그레이션 002 `manual_input`·`perf_manual_sales`) — 켜면 일자별 표 날짜 칸에 총매출 직접 입력, 넣은 날은 API 값 대신(`daily_amounts` 한 곳). 일자별 표 [엑셀 업로드] 팝업(`manual_upload.py`, `POST /performance/api/manual-sales/upload`) — 1열 날짜·2열부터 쇼핑몰 이름 머리글, 수동 입력 켜진 쇼핑몰 열의 값 있는 칸만 반영(덮어씀, 빈 칸 그대로), 잘못된 칸이 하나라도 있으면 전부 저장 안 함, 샘플 = 모듈 폴더 `upload_sample.xlsx`. 열 순서 카페24·네이버·쿠팡(윙)·쿠팡(로켓)·오늘의집·G마켓·카카오·GS샵·11번가·롯데ON·토스·애터미아자몰(마이그레이션 003). 쿠팡(로켓)·애터미아자몰은 **수동 입력 전용**(`adapters/manual.py`, `manual_only` — 매출 업데이트에서 빠지고 인증 설정·연결 테스트 없음, 수동 입력 늘 켜짐). 상세는 `docs/PERFORMANCE_MODULE.md` diff --git a/app/modules/notice/templates/notice/admin.html b/app/modules/notice/templates/notice/admin.html index 49f4b0a..6721ef9 100644 --- a/app/modules/notice/templates/notice/admin.html +++ b/app/modules/notice/templates/notice/admin.html @@ -2,7 +2,7 @@ {% block head_extra %} {# 프로젝트 화면 부품(설명 편집기·날짜 팝업·멤버 고르기)을 그대로 쓴다 — project.js 는 PJ_LIB_ONLY 로 부품만 #} - + {% endblock %} @@ -64,7 +64,7 @@ - + {% endif %} {% endblock %} diff --git a/app/modules/project/db.py b/app/modules/project/db.py index f4b3ec2..c8fafc5 100644 --- a/app/modules/project/db.py +++ b/app/modules/project/db.py @@ -933,6 +933,86 @@ class ProjectStore: out["_newly_completed"] = newly_completed if changed else False return out + def move_task_to_project( + self, *, task_id: int, project_id: int, stage_id: Any = None, actor: str = "", + assignee_allowed: Any = None, + ) -> dict[str, Any]: + """메인 업무를 다른 프로젝트(의 섹션)로 옮긴다 — 세부 업무(모든 단계)도 함께. 한 트랜잭션. + + · 메인 업무만(세부 업무는 상위 업무와 함께 움직인다). 같은 프로젝트면 ValueError. + · 섹션은 대상 프로젝트 것만(None = 섹션 없음). 목록 끝(sort_order 최대+1)으로. + · 섹션을 옮길 때와 같은 규칙 — 담당자가 비었으면 그 섹션 기본 담당자, 완료 섹션이면 완료 처리. + · 대상 프로젝트로 걸려 있던 연결(멀티호밍)은 이제 원 소속이라 지운다(다른 연결은 그대로). + · 활동 이력·알림·회의록 업무 등록 줄의 프로젝트도 따라 바꾼다(이력이 새 프로젝트 화면에 보이게). + 반환: 옮긴 업무(get_task) + `_moved_ids`·`_newly_assigned`·`_newly_completed`. + """ + newly_assigned: str | None = None + newly_completed = False + with self._pool.connection() as conn: + with conn.transaction(): + row = conn.execute("SELECT * FROM tasks WHERE id = %s FOR UPDATE", (task_id,)).fetchone() + if row is None: + raise KeyError(f"업무를 찾을 수 없습니다: {task_id}") + prev = self._serialize(row) + if prev.get("parent_task_id") is not None: + raise ValueError("세부 업무는 상위 업무와 함께 옮겨집니다. 상위 업무를 옮기세요.") + target = int(project_id) + if int(prev["project_id"]) == target: + raise ValueError("이미 이 프로젝트의 업무입니다.") + if not conn.execute("SELECT 1 FROM projects WHERE id = %s", (target,)).fetchone(): + raise KeyError(f"프로젝트를 찾을 수 없습니다: {target}") + new_stage = self._check_stage_in_project(conn, stage_id, target) + ids = [int(r["id"]) for r in conn.execute( + "WITH RECURSIVE tree AS (SELECT id FROM tasks WHERE id = %s " + "UNION ALL SELECT t.id FROM tasks t JOIN tree ON t.parent_task_id = tree.id) " + "SELECT id FROM tree", + (task_id,), + ).fetchall()] + nxt = conn.execute( + "SELECT COALESCE(MAX(sort_order), -1) + 1 AS n FROM tasks WHERE project_id = %s", + (target,), + ).fetchone() + conn.execute("UPDATE tasks SET project_id = %s WHERE id = ANY(%s)", (target, ids)) + sets = ["stage_id = %s", "sort_order = %s"] + params: list[Any] = [new_stage, int(nxt["n"])] + if new_stage is not None and not (prev.get("assignee_email") or ""): + dae, dan = self._stage_default_assignee(conn, new_stage, target, allowed=assignee_allowed) + if dae: + sets += ["assignee_email = %s", "assignee_name = %s"] + params += [dae, dan] + newly_assigned = dae + if self._stage_is_done_conn(conn, new_stage) and not prev.get("completed_at"): + sets.append("completed_at = %s") + params.append(now_kst()) + newly_completed = True + conn.execute(f"UPDATE tasks SET {', '.join(sets)} WHERE id = %s", (*params, task_id)) + conn.execute( + "DELETE FROM task_project_links WHERE task_id = ANY(%s) AND project_id = %s", (ids, target)) + conn.execute("UPDATE project_activity SET project_id = %s WHERE task_id = ANY(%s)", (target, ids)) + conn.execute("UPDATE project_notifications SET project_id = %s WHERE task_id = ANY(%s)", (target, ids)) + if self._table_exists(conn, "goal_meeting_tasks"): + conn.execute( + "UPDATE goal_meeting_tasks SET project_id = %s, stage_id = %s WHERE task_id = %s", + (target, new_stage, task_id)) + old_name = conn.execute("SELECT name FROM projects WHERE id = %s", (prev["project_id"],)).fetchone() + new_name = conn.execute("SELECT name FROM projects WHERE id = %s", (target,)).fetchone() + self._log(conn, project_id=target, task_id=task_id, actor=actor, + action=store.ACTION_PROJECT_MOVED, + detail=f"{prev['title']}: {(old_name or {}).get('name', '')} → {(new_name or {}).get('name', '')}") + if newly_assigned: + self._log(conn, project_id=target, task_id=task_id, actor=actor, + action=store.ACTION_ASSIGNED, detail=f"{prev['title']} → {newly_assigned}") + if newly_completed: + self._log(conn, project_id=target, task_id=task_id, actor=actor, + action=store.ACTION_COMPLETED, detail=prev["title"]) + out = self.get_task(task_id=task_id) + if out is None: + raise KeyError(task_id) + out["_moved_ids"] = ids + out["_newly_assigned"] = newly_assigned + out["_newly_completed"] = newly_completed + return out + # ════════════════════════════════════════════════════════════ # 휴지통 (마이그레이션 010) — 지우기 직전 스냅샷, 관리자 복구, 3개월 보관 # ════════════════════════════════════════════════════════════ diff --git a/app/modules/project/router.py b/app/modules/project/router.py index 7c3a74e..0f97e0e 100644 --- a/app/modules/project/router.py +++ b/app/modules/project/router.py @@ -1740,6 +1740,60 @@ def api_move_subtask( return JSONResponse({"task": task}) +@router.post("/api/tasks/{task_id}/move-project") +def api_move_task_project( + request: Request, + task_id: int, + bg: BackgroundTasks, + payload: dict[str, Any] = Body(...), +) -> JSONResponse: + """메인 업무를 다른 프로젝트로 옮긴다 — 보드 카드·목록 줄을 왼쪽 프로젝트 목록으로 드래그 → 섹션 선택 창. + + body: {"project_id": 대상, "stage_id": 대상 섹션 또는 null}. 원 소속 권한(FULL) + 대상 프로젝트 멤버여야 한다. + 세부 업무는 함께 옮겨진다. 응답의 `unseen` = 대상 프로젝트를 볼 수 없는 담당자·협업자(화면이 안내). + """ + user = _require_user(request) + st = _db_or_503(request) + existing = _task_or_404(st, task_id) + _require_task(st, user, existing, write=True) + try: + target = int(payload.get("project_id")) + except (TypeError, ValueError): + raise HTTPException(status_code=400, detail="옮길 프로젝트(project_id)가 필요합니다.") + _require_manage(request, st, user, target) + project = st.get_project(project_id=target) + if project is None: + raise HTTPException(status_code=404, detail="프로젝트를 찾을 수 없습니다.") + try: + task = st.move_task_to_project( + task_id=task_id, project_id=target, stage_id=payload.get("stage_id"), + actor=user["email"], assignee_allowed=_registered_project_user, + ) + except ValueError as exc: + raise HTTPException(status_code=400, detail=str(exc)) + except KeyError as exc: + raise HTTPException(status_code=404, detail=str(exc)) + task.pop("_moved_ids", None) + newly_assigned = task.pop("_newly_assigned", None) + if newly_assigned: # 대상 섹션 기본 담당자가 자동 배정됨 — 일반 배정과 같은 알림 + _follow(st, task["id"], [newly_assigned]) + _inbox( + st, recipients=[newly_assigned], actor=user["email"], project_id=target, task_id=task["id"], + ntype="assigned", title=f"업무 배정: {task['title']}", + body=f"{project['name']} · 마감 {task.get('due_date') or '-'}", + ) + if task.pop("_newly_completed", False): + _notify_completed(bg, request, st, project=project, task=task, actor=user["email"]) + people = [task.get("assignee_email") or ""] + try: + people += st.list_followers(task_id=task_id) + except Exception: # noqa: BLE001 - 008 미적용 + pass + unseen = sorted({store.norm_str(e, lower=True) for e in people if e} - + set(access.filter_recipients(st, task, [e for e in people if e]))) + return JSONResponse({"task": task, "unseen": unseen}) + + # ──────────────────────────────────────────────────────────── # JSON API — 팔로워 (아사나의 협업자) # ──────────────────────────────────────────────────────────── diff --git a/app/modules/project/store.py b/app/modules/project/store.py index e384344..0cb1cbc 100644 --- a/app/modules/project/store.py +++ b/app/modules/project/store.py @@ -41,6 +41,7 @@ ACTION_COMPLETED = "completed" ACTION_STAGE_CHANGED = "stage_changed" ACTION_REOPENED = "reopened" ACTION_SUBTASK_MOVED = "subtask_moved" # 세부 업무를 다른 상위 업무로 옮김(보드 드래그) +ACTION_PROJECT_MOVED = "project_moved" # 업무를 다른 프로젝트로 옮김(왼쪽 프로젝트 목록으로 드래그) # 프로젝트 색상 팔레트 — 32색(8칸 × 4줄). 앞 16색은 아사나 프로젝트 색(아사나 색상표 # 순서 그대로), 뒤 16색은 같은 칸(열)에 대응하는 진한 색 — 3줄째 = 1줄째의 진한 색, diff --git a/app/modules/project/templates/project/goal_meeting.html b/app/modules/project/templates/project/goal_meeting.html index b18aad1..893e075 100644 --- a/app/modules/project/templates/project/goal_meeting.html +++ b/app/modules/project/templates/project/goal_meeting.html @@ -1,7 +1,7 @@ {% extends "project/_meeting_content_base.html" if meeting_embedded else "erp_base.html" %} {% block head_extra %} - + {% endblock %} @@ -298,5 +298,5 @@ - + {% endblock %} diff --git a/app/modules/project/templates/project/goals.html b/app/modules/project/templates/project/goals.html index 04267fb..4752185 100644 --- a/app/modules/project/templates/project/goals.html +++ b/app/modules/project/templates/project/goals.html @@ -1,7 +1,7 @@ {% extends "erp_base.html" %} {% block head_extra %} - + {% endblock %} @@ -207,5 +207,5 @@ {% 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 9885d9d..004ef8d 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 %} diff --git a/app/modules/project/templates/project/inbox.html b/app/modules/project/templates/project/inbox.html index a9e8d21..71e38ad 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 %} @@ -102,5 +102,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 91318e3..ebca516 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/notifier.html b/app/modules/project/templates/project/notifier.html index b157ee2..4d0b933 100644 --- a/app/modules/project/templates/project/notifier.html +++ b/app/modules/project/templates/project/notifier.html @@ -1,7 +1,7 @@ {% extends "erp_base.html" %} {% block head_extra %} - + {% endblock %} @@ -108,5 +108,5 @@ }); })(); - + {% endblock %} diff --git a/app/modules/project/templates/project/project.html b/app/modules/project/templates/project/project.html index 3d40d9d..7b26165 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 %} - + @@ -469,5 +469,5 @@ - + {% endblock %} diff --git a/app/modules/project/templates/project/trash.html b/app/modules/project/templates/project/trash.html index 113cf9c..5012fc6 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 476c760..488461e 100644 --- a/app/static/project.css +++ b/app/static/project.css @@ -1616,6 +1616,24 @@ img.pj-person-ic { width: 22px; height: 22px; } box-shadow: var(--pj-card-shadow); padding: 18px 20px 20px; min-width: 0; } .pj-dash-card-wide { grid-column: 1 / -1; } +/* 업무 카드를 왼쪽 프로젝트에 끌어 놓을 때 — 놓일 프로젝트 줄 강조 */ +.pj-tree-row.is-task-drop { background: var(--pj-accent-tint); box-shadow: inset 0 0 0 2px var(--pj-accent); border-radius: 8px; } +/* 다른 프로젝트로 이동 — 섹션 선택 창(body 에 붙음) */ +.pj-move-card { width: min(420px, 92vw); box-sizing: border-box; } +.pj-move-card h3 { margin: 0 0 6px; } +.pj-move-what { display: flex; align-items: center; flex-wrap: wrap; gap: 6px; } +.pj-move-dot { display: inline-block; width: 10px; height: 10px; border-radius: 3px; } +.pj-move-label { margin: 12px 0 6px; font-size: 12.5px; font-weight: 700; color: var(--pj-ink-soft); } +.pj-move-stages { display: flex; flex-direction: column; gap: 4px; max-height: 46vh; overflow-y: auto; } +.pj-move-stage { + display: flex; align-items: center; gap: 8px; padding: 8px 10px; border: 1px solid var(--pj-border); border-radius: 8px; + cursor: pointer; font-size: 13.5px; +} +.pj-move-stage:hover { background: #f5f6f8; } +.pj-move-stage:has(input:checked) { border-color: var(--pj-accent); background: var(--pj-accent-tint); } +.pj-move-stage-name { flex: 1 1 auto; font-weight: 600; } +.pj-move-stage small { flex-basis: 100%; color: var(--pj-ink-soft); font-size: 11.5px; } +.pj-move-err { color: #c22b10; font-size: 12.5px; margin: 8px 0 0; } /* 업무 합계(프로젝트별) — 가로 막대 줄(채움 = 완료율) */ .pj-dash-projbars { display: flex; flex-direction: column; gap: 4px; max-height: 210px; overflow-y: auto; margin: 0 -6px; } .pj-dash-projrow { diff --git a/app/static/project.js b/app/static/project.js index 4cdb3f4..9af60b8 100644 --- a/app/static/project.js +++ b/app/static/project.js @@ -872,6 +872,9 @@ '' + '' + ""; + // 보드 카드를 왼쪽 프로젝트 목록으로 끌어 다른 프로젝트로 옮길 때 쓰는 드래그 종류(값 = 업무 id). + // 카드 안 섹션 이동은 예전처럼 text/plain — 사이드바는 이 종류만 받는다. + const TASK_DRAG_TYPE = "application/x-pj-task"; // 협업자 미지정 아이콘(점선 원 안의 두 사람) — 업무 창 세부 업무 줄. const FOLLOWER_EMPTY_ICON_SVG = '' + (s.is_done_stage ? '완료' : "") + ""; + }).join("") + : ''; + m.innerHTML = + '"; + m.querySelector(".pj-move-task").textContent = "‘" + (t.title || "") + "’"; + m.querySelector(".pj-move-proj").textContent = target.name || "프로젝트"; + m.querySelector(".pj-move-dot").style.background = target.color || "var(--pj-accent)"; + m.querySelectorAll(".pj-move-stage-name").forEach(function (n, i) { if (stageList[i]) n.textContent = stageList[i].name; }); + if (stageList.length && !m.querySelector("input:checked")) m.querySelector("input").checked = true; + document.body.appendChild(m); + moveModalEl = m; + document.addEventListener("keydown", onMoveKey, true); + m.addEventListener("click", function (e) { + if (e.target === m || e.target.closest("[data-move-cancel]")) closeMoveModal(); + }); + const ok = m.querySelector("[data-move-ok]"); + ok.addEventListener("click", async function () { + const sel = m.querySelector("input:checked"); + const stageId = sel && sel.value ? parseInt(sel.value, 10) : null; + const err = m.querySelector(".pj-move-err"); + ok.disabled = true; err.hidden = true; + try { + const res = await api("POST", "/project/api/tasks/" + t.id + "/move-project", + { project_id: target.projectId, stage_id: stageId }); + closeMoveModal(); + const st = stageList.find(function (s) { return s.id === stageId; }); + showToast("‘" + (t.title || "") + "’ 을(를) " + target.name + (st ? " · " + st.name : "") + "(으)로 옮겼습니다."); + if (res.unseen && res.unseen.length) { + showToast(res.unseen.map(idOf).join(", ") + " 님은 '" + target.name + "' 멤버가 아니라 이 업무를 볼 수 없습니다.", "error"); + } + await softSyncProjectRef(); + } catch (e2) { + err.textContent = "옮기지 못했습니다: " + e2.message; + err.hidden = false; + ok.disabled = false; + } + }); + setTimeout(function () { const c = m.querySelector("input:checked") || ok; if (c && c.isConnected) c.focus(); }, 0); + } + document.addEventListener("pj:task-to-project", function (e) { + const d = e.detail || {}; + const t = tasks.find(function (x) { return x.id === d.taskId && x.context_project_id === x.project_id; }) || + tasks.find(function (x) { return x.id === d.taskId; }); + if (!t) return; + if (t.parent_task_id) { showToast("세부 업무는 상위 업무와 함께 옮겨집니다.", "error"); return; } + if (t.project_id === d.projectId) { showToast("이미 이 프로젝트의 업무입니다."); return; } + openMoveToProject(t, d); + }); + async function applyTaskPatch(t, patch, failMsg) { try { const res = await api("PUT", "/project/api/tasks/" + t.id, patch); @@ -5679,6 +5811,8 @@ if (canManage) { card.addEventListener("dragstart", function (e) { e.dataTransfer.setData("text/plain", String(t.id)); + // 왼쪽 프로젝트 목록에 놓으면 다른 프로젝트로 옮기기(원 소속 업무만 — 연결로 보이는 카드는 원 소속에서 옮긴다) + if (t.context_project_id === t.project_id || !t.is_linked) e.dataTransfer.setData(TASK_DRAG_TYPE, String(t.id)); card.classList.add("is-dragging"); }); card.addEventListener("dragend", function () { card.classList.remove("is-dragging"); }); diff --git a/docs/PROJECT_MODULE.md b/docs/PROJECT_MODULE.md index a3383d2..8aef6a6 100644 --- a/docs/PROJECT_MODULE.md +++ b/docs/PROJECT_MODULE.md @@ -1284,6 +1284,21 @@ Windows 트레이 프로그램 **DBX 알림**(`desktop/notifier/`, C# .NET Frame - 검증: `tests/test_project_module.py::test_create_with_followers_and_my_overdue`(실제 PG), `tests/js/project_ui.test.js` ([세부 추가 협업자]·[카드 세부 협업자]·[카드 새 세부 협업자]·[대시보드 프로젝트별]), `tests/js/overdue_ui.test.js`. +## 6-18. 업무를 다른 프로젝트로 이동 — 왼쪽 프로젝트 목록으로 드래그 (2026-10-13, 마이그레이션 없음) + +- **화면**: 보드 카드를 끌어 왼쪽 사이드바의 프로젝트 줄에 놓는다(놓일 줄 강조 `.pj-tree-row.is-task-drop`). 카드 드래그는 섹션 이동용 + `text/plain` 에 더해 `application/x-pj-task`(= 업무 id, `TASK_DRAG_TYPE`)를 싣고, 사이드바(`initSideTree`)는 이 종류만 받아 + `pj:task-to-project` 이벤트를 낸다 → 프로젝트 화면이 **섹션 선택 창**(`openMoveToProject`, body 에 붙음 — 대상 프로젝트 섹션 목록, + 첫 진행 섹션이 기본, 섹션이 없으면 "섹션 없음") → [이동](Enter) = `POST /api/tasks/{id}/move-project` → `softSyncProjectRef` 로 다시 그림. + 같은 프로젝트·세부 업무는 창 없이 안내. 대상 프로젝트 멤버가 아니면 섹션 목록 조회가 403 → 안내. +- **API** `POST /api/tasks/{id}/move-project` `{project_id, stage_id|null}` — 원 소속 권한(FULL) + 대상 프로젝트 관리 권한(멤버, 403). + `db.move_task_to_project` 한 트랜잭션: 메인 업무만(세부 업무면 400, 같은 프로젝트 400, 남의 섹션 400), 세부 업무(모든 단계)도 project_id 변경, + 대상 섹션 목록 끝, 섹션 이동과 같은 규칙(담당자가 비면 섹션 기본 담당자 — 배정 알림, 완료 섹션이면 완료 — 완료 알림), 대상 프로젝트로의 + 연결(`task_project_links`)은 지움(다른 연결은 유지), `project_activity`·`project_notifications`·`goal_meeting_tasks` 의 프로젝트도 따라 바꿈, + 활동 `project_moved`("업무: 옛 프로젝트 → 새 프로젝트"). 응답 `unseen` = 대상 프로젝트를 볼 수 없는 담당자·협업자(화면이 안내 — 담당자는 그대로 둔다). +- 아직 안 되는 것: 목록·캘린더·타임라인 보기에서 끌기(보드 카드만), 이동 되돌리기(다시 끌어 옮기면 됨). +- 검증: `tests/test_project_module.py::test_move_task_to_other_project`(실제 PG), `tests/js/project_ui.test.js` [프로젝트 이동]. + ## 7. 추후 단계 작업 라벨(태그 분류) · 반복 작업 · 템플릿 · 작업 의존성. diff --git a/tests/js/project_ui.test.js b/tests/js/project_ui.test.js index b5eddde..788ce7f 100644 --- a/tests/js/project_ui.test.js +++ b/tests/js/project_ui.test.js @@ -773,6 +773,48 @@ function titleVal(d) { return d.getElementById("pj-t-title").value; } check("[세부 업무 협업자] 고른 뒤 메뉴가 다시 열려 이어서 고름", !!d.querySelector(".pj-ctxmenu")); d.dispatchEvent(new env.w.KeyboardEvent("keydown", { key: "Escape", bubbles: true })); await settle(); } + // ── 업무 카드를 왼쪽 프로젝트로 끌어 다른 프로젝트로 이동(2026-10-13) — 섹션 선택 창 → move-project ── + { + const env = makeEnv(); baseRoutes(env); + const moves = []; + env.route("GET", /\/project\/api\/projects\/2\/stages$/, function () { + return { body: { stages: [ + { id: 22, project_id: 2, name: "진행", is_done_stage: false, sort_order: 1 }, + { id: 21, project_id: 2, name: "할 일", is_done_stage: false, sort_order: 0 }, + { id: 23, project_id: 2, name: "완료", is_done_stage: true, sort_order: 2 }] } }; + }); + env.route("POST", /\/project\/api\/tasks\/101\/move-project$/, function (u, b) { + moves.push(b); return { body: { task: detail(101, "작업 A", { project_id: 2, stage_id: b.stage_id }), unseen: [] } }; + }); + await boot(env); const d = env.d, w = env.w; + const data = {}; const transfer = { types: [], dropEffect: "", effectAllowed: "", + setData: function (k, v) { data[k] = v; this.types.push(k); }, getData: function (k) { return data[k] || ""; } }; + function fire(el, kind) { + const e = new w.MouseEvent(kind, { bubbles: true, cancelable: true }); + Object.defineProperty(e, "dataTransfer", { value: transfer }); + el.dispatchEvent(e); return e; + } + const card = d.querySelector('.pj-card[data-task-id="101"]'); + fire(card, "dragstart"); + check("[프로젝트 이동] 카드 드래그에 이동 종류(업무 id)", data["application/x-pj-task"] === "101" && data["text/plain"] === "101"); + const li = d.querySelector('.pj-side .pj-tree-li[data-id="2"]'); + const over = fire(li.querySelector(".pj-tree-row") || li, "dragover"); + check("[프로젝트 이동] 왼쪽 프로젝트 줄 위 — 놓기 허용·강조", over.defaultPrevented && !!li.querySelector(".pj-tree-row.is-task-drop")); + fire(li.querySelector(".pj-tree-row") || li, "drop"); await settle(); await settle(); + const modal = d.body.querySelector(".pj-move-modal"); + const names = modal ? Array.from(modal.querySelectorAll(".pj-move-stage-name")).map(function (n) { return n.textContent; }) : []; + check("[프로젝트 이동] 섹션 선택 창(body 에, 섹션 순서대로, 첫 진행 섹션 선택)", !!modal && modal.parentElement === d.body && + JSON.stringify(names) === '["할 일","진행","완료"]' && modal.querySelector("input:checked").value === "21" && + /P2/.test(modal.textContent) && !li.querySelector(".is-task-drop"), [names, modal && modal.textContent]); + modal.querySelector('input[value="22"]').checked = true; + modal.querySelector("[data-move-ok]").click(); await settle(); await settle(); + check("[프로젝트 이동] [이동] → move-project(프로젝트·고른 섹션) 후 창 닫힘", + moves.length === 1 && moves[0].project_id === 2 && moves[0].stage_id === 22 && !d.body.querySelector(".pj-move-modal"), moves); + // 같은 프로젝트에 놓으면 창 없이 안내 + fire(card, "dragstart"); + fire(d.querySelector('.pj-side .pj-tree-li[data-id="1"]'), "drop"); await settle(); + check("[프로젝트 이동] 같은 프로젝트에 놓으면 창 없음", !d.body.querySelector(".pj-move-modal")); + } // ── 세부 업무를 만들 때 협업자 같이(업무 창 추가 칸·보드 카드 새 줄) · 카드 기존 줄 협업자 · 대시보드 프로젝트별(2026-10-13) ── { const env = makeEnv(); baseRoutes(env); diff --git a/tests/test_project_module.py b/tests/test_project_module.py index b221972..bbd1205 100644 --- a/tests/test_project_module.py +++ b/tests/test_project_module.py @@ -1418,6 +1418,44 @@ def test_create_with_followers_and_my_overdue(): assert not [x for x in req("GET", "/project/api/my-overdue", BOB).json()["tasks"] if x["project_id"] == p["id"]] +def test_move_task_to_other_project(): + """업무를 다른 프로젝트로 옮기기(2026-10-13) — 세부 업무 함께, 대상 섹션·기본 담당자·완료 섹션, 연결 정리, 권한.""" + a = _project("P-mvA", ADMIN, (ALICE, BOB)) + b = _project("P-mvB", ADMIN, (ALICE,)) + c = _project("P-mvC", ADMIN, (BOB,)) # ALICE 는 멤버 아님 + sa = _stage(a["id"], by=ADMIN) + sb = _stage(b["id"], name="진행", by=ADMIN) + sb_done = _stage(b["id"], name="완료", done=True, by=ADMIN) + req("PUT", f"/project/api/projects/{b['id']}/stages/{sb['id']}", ADMIN, json={"default_assignee_email": ALICE}) + t = ST.create_task(project_id=a["id"], title="옮길 업무", stage_id=sa["id"], created_by=ALICE) + sub = ST.create_task(project_id=a["id"], title="세부", parent_task_id=t["id"], created_by=ALICE) + subsub = ST.create_task(project_id=a["id"], title="세부의 세부", parent_task_id=sub["id"], created_by=ALICE) + assert req("POST", f"/project/api/tasks/{t['id']}/links", ALICE, json={"project_id": b["id"], "stage_id": sb["id"]}).status_code == 201 + url = f"/project/api/tasks/{t['id']}/move-project" + # 권한 — 대상 프로젝트 멤버가 아니면 403, 세부 업무만은 400, 남의 섹션은 400, 같은 프로젝트는 400 + assert req("POST", url, ALICE, json={"project_id": c["id"], "stage_id": None}).status_code == 403 + assert req("POST", f"/project/api/tasks/{sub['id']}/move-project", ALICE, json={"project_id": b["id"]}).status_code == 400 + assert req("POST", url, ALICE, json={"project_id": b["id"], "stage_id": sa["id"]}).status_code == 400 + assert req("POST", url, ALICE, json={"project_id": a["id"], "stage_id": sa["id"]}).status_code == 400 + assert ST.get_task(task_id=t["id"])["project_id"] == a["id"] + # 이동 — 세부 업무(모든 단계)까지 대상 프로젝트로, 섹션 기본 담당자 자동 배정, 대상 쪽 연결은 지움 + r = req("POST", url, ALICE, json={"project_id": b["id"], "stage_id": sb["id"]}) + assert r.status_code == 200, r.text + moved = r.json()["task"] + assert moved["project_id"] == b["id"] and moved["stage_id"] == sb["id"] and moved["assignee_email"] == ALICE + assert ST.get_task(task_id=sub["id"])["project_id"] == b["id"] and ST.get_task(task_id=subsub["id"])["project_id"] == b["id"] + assert _count("SELECT COUNT(*) AS n FROM task_project_links WHERE task_id=%s AND project_id=%s", t["id"], b["id"]) == 0 + assert _count("SELECT COUNT(*) AS n FROM project_activity WHERE task_id=%s AND action='project_moved' AND project_id=%s", t["id"], b["id"]) == 1 + # 옛 프로젝트 멤버(BOB, B 비멤버)는 이제 못 본다 / 새 프로젝트 멤버는 본다 + assert req("GET", f"/project/api/tasks/{t['id']}", BOB).status_code == 403 + assert req("GET", f"/project/api/tasks/{sub['id']}", ALICE).status_code == 200 + # 완료 섹션으로 옮기면 완료 처리 + t2 = ST.create_task(project_id=a["id"], title="완료로", stage_id=sa["id"], assignee_email=BOB, created_by=ALICE) + r2 = req("POST", f"/project/api/tasks/{t2['id']}/move-project", ALICE, json={"project_id": b["id"], "stage_id": sb_done["id"]}) + assert r2.status_code == 200 and r2.json()["task"]["completed_at"] + assert BOB in r2.json()["unseen"] # 담당자가 B 멤버가 아님 — 화면이 안내 + + if __name__ == "__main__": if not ENABLED: print("SKIP: PROJECT_TEST_DB_URL(localhost) not set")