From 8c68990aa969a5e0c63c38ae1d8d515db3b89e0b Mon Sep 17 00:00:00 2001 From: king Date: Tue, 22 Sep 2026 12:07:06 +0900 Subject: [PATCH] =?UTF-8?q?feat(project):=20=ED=99=88=20=ED=99=94=EB=A9=B4?= =?UTF-8?q?=20=ED=8F=90=EC=A7=80=20=E2=86=92=20=EB=82=B4=20=EC=97=85?= =?UTF-8?q?=EB=AC=B4=20=ED=99=94=EB=A9=B4=20=C2=B7=20=ED=95=98=EC=9C=84=20?= =?UTF-8?q?=EC=97=85=EB=AC=B4=20=EC=A0=84=EC=B2=B4=ED=8F=AD/=EC=99=84?= =?UTF-8?q?=EB=A3=8C=20=EC=B2=B4=ED=81=AC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - /project/ 가 프로젝트 홈(카드 그리드) 대신 "내 업무" 화면이 된다 (project/mytasks.html). 내가 담당자인 업무를 한 표에 모아 보여준다 — 완료 체크박스 · 업무 · 프로젝트 · 세션 · 우선순위 · 시작 · 마감, 헤더 클릭 정렬, 진행중/완료/전체 필터, 진행·완료·지연 요약. 체크박스로 그 자리에서 완료 토글, 행을 누르면 그 프로젝트로 이동하며 업무 편집 팝업(?task=), 우클릭은 열기/완료/삭제. - 좌측 "내 업무"는 접이식 패널을 없애고 이 화면으로 가는 링크로 바꿨다. - 좌측 사이드바를 project/_side.html 로 뽑아 두 화면이 공용으로 쓴다. - 홈 전용 코드 삭제: templates/project/index.html, project.js 의 initHome/wireProjectGridDrag/updateMyTreeCounts/wireMyTreeToggles(약 900줄), router 의 홈 카드 집계와 _group_my_tasks, project.css 의 홈 카드/내 업무 트리 스타일. 새 프로젝트 모달은 두 화면이 쓰도록 initNewProjectModal 로 분리했다. - 업무 편집 팝업: 하위 업무를 우측 칼럼에서 빼내 설명 바로 아래, 팝업 너비 전체를 쓰는 행으로 옮겼다(.pj-subtask-full). 제목 왼쪽 체크박스로 완료를 토글하고 완료된 줄은 반투명(50%) + 취소선. Co-Authored-By: Claude Opus 5 (1M context) --- CLAUDE.md | 2 +- app/modules/project/router.py | 154 +- .../project/templates/project/_side.html | 84 + .../project/templates/project/inbox.html | 4 +- .../project/templates/project/index.html | 436 ----- .../project/templates/project/mytasks.html | 104 ++ .../project/templates/project/project.html | 159 +- app/static/project.css | 203 +-- app/static/project.js | 1402 +++-------------- docs/PROJECT_MODULE.md | 32 +- 10 files changed, 572 insertions(+), 2008 deletions(-) create mode 100644 app/modules/project/templates/project/_side.html delete mode 100644 app/modules/project/templates/project/index.html create mode 100644 app/modules/project/templates/project/mytasks.html diff --git a/CLAUDE.md b/CLAUDE.md index e645bce..7ab178a 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/images` → PUT `detail_image`+`image_upload_type=A`), 옵션(생성/이름·썸네일·표시방식 수정/삭제)·품목(자체코드·추가금액·진열·판매)을 수정. 카페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)·업무(`tasks`: 담당자·우선순위·시작/마감)·진행단계(`project_stages` 칸반, 생성시 기본 4단계 seed)·멤버 배정(`project_members`)·활동이력(`project_activity`). 메인 뷰 달력(FullCalendar)/타임라인(vis-timeline) 버튼 토글 + 보드/리스트. 보드는 아사나처럼 세션이 가로로 계속 늘어나고(넘치면 가로 스크롤) 카드의 담당자·마감일을 클릭해 그 자리에서 바꾼다. 좌측 사이드바에 수신함·내 업무(접이식) 메뉴. 설명란은 주소 붙여넣기 시 자동 링크, 설명란·댓글에서 @로 멤버를 태그하면 (`task_mentions`, 마이그레이션 006) 수신함에 그 업무가 쌓인다. 진입 권한키 `project`(관리자 페이지 토글로 직원별 부여, admin 자동). 프로젝트 생성/삭제·사용자 배정은 `is_admin` 만, 배정 멤버(또는 owner)는 서브프로젝트/업무/단계 CRUD. 멤버 배정 후보는 `project` 권한 보유 등록 사용자에서 자동 목록(`GET /project/api/assignable-users`). 업무 배정·완료 시 관리자에게 메일(`app/mail.py` stdlib smtplib, `SMTP_*`+`PROJECT_NOTIFY_EMAIL` env, 미설정 시 조용히 skip, `BackgroundTasks` 비동기). 상세는 `docs/PROJECT_MODULE.md` +- 프로젝트 관리 (`app/modules/project/`, `project_db`) — 아사나식. 프로젝트/서브프로젝트(self-FK `parent_id`, CASCADE)·업무(`tasks`: 담당자·우선순위·시작/마감)·진행단계(`project_stages` 칸반, 생성시 기본 4단계 seed)·멤버 배정(`project_members`)·활동이력(`project_activity`). 첫 화면(`/project/`)은 **내 업무 목록**(프로젝트 홈 카드 화면은 폐지). 프로젝트 화면은 달력(FullCalendar)/타임라인(vis-timeline)/보드/리스트/대시보드 뷰 토글. 좌측 사이드바는 두 화면 공용(`templates/project/_side.html`). 보드는 아사나처럼 세션이 가로로 계속 늘어나고(넘치면 가로 스크롤) 카드의 담당자·마감일을 클릭해 그 자리에서 바꾼다. 좌측 사이드바에 수신함·내 업무(접이식) 메뉴. 설명란은 주소 붙여넣기 시 자동 링크, 설명란·댓글에서 @로 멤버를 태그하면 (`task_mentions`, 마이그레이션 006) 수신함에 그 업무가 쌓인다. 진입 권한키 `project`(관리자 페이지 토글로 직원별 부여, admin 자동). 프로젝트 생성/삭제·사용자 배정은 `is_admin` 만, 배정 멤버(또는 owner)는 서브프로젝트/업무/단계 CRUD. 멤버 배정 후보는 `project` 권한 보유 등록 사용자에서 자동 목록(`GET /project/api/assignable-users`). 업무 배정·완료 시 관리자에게 메일(`app/mail.py` stdlib smtplib, `SMTP_*`+`PROJECT_NOTIFY_EMAIL` env, 미설정 시 조용히 skip, `BackgroundTasks` 비동기). 상세는 `docs/PROJECT_MODULE.md` 상세는 `docs/PROJECT_OVERVIEW.md`. diff --git a/app/modules/project/router.py b/app/modules/project/router.py index cf0b3b3..9cb048e 100644 --- a/app/modules/project/router.py +++ b/app/modules/project/router.py @@ -236,31 +236,6 @@ def _fmt_date_kr(d: str | None) -> str: return dd.strftime("%m/%d") + f"({_WEEKDAYS_KR[dd.weekday()]})" -def _group_my_tasks(my_tasks: list[dict[str, Any]]) -> list[dict[str, Any]]: - """담당 업무를 프로젝트별로 묶고, "내 업무" 패널에 표시할 전체/진행/완료 - 개수를 함께 센다(홈 화면·프로젝트 화면 양쪽에서 재사용).""" - groups: dict[int, dict[str, Any]] = {} - for t in my_tasks: - pid = t.get("project_id") - g = groups.get(pid) - if g is None: - g = { - "id": pid, - "name": t.get("project_name") or "프로젝트", - "color": t.get("project_color") or "#4573d2", - "tasks": [], - } - groups[pid] = g - g["tasks"].append(t) - for g in groups.values(): - total = len(g["tasks"]) - done = sum(1 for t in g["tasks"] if t.get("completed_at")) - g["total"] = total - g["done"] = done - g["open"] = total - done - return list(groups.values()) - - def _build_tree(projects: list[dict[str, Any]]) -> list[dict[str, Any]]: """평면 프로젝트 목록 → parent_id 기준 트리(children 키).""" by_id: dict[int, dict[str, Any]] = {} @@ -405,7 +380,12 @@ async def api_live_version(request: Request) -> JSONResponse: @router.get("/", response_class=HTMLResponse) -async def index(request: Request) -> HTMLResponse: +async def my_tasks_page(request: Request) -> HTMLResponse: + """프로젝트 모듈의 첫 화면 = 내 업무. + + 예전 홈(프로젝트 카드 그리드)은 없앴다 — 좌측 "내 업무" 메뉴와 같은 + 화면이며, 좌측 사이드바는 프로젝트 화면과 공용(project/_side.html)이다. + """ from app.main import build_erp_nav, render_template # noqa: WPS433 from app.store import is_admin # noqa: WPS433 @@ -419,13 +399,30 @@ async def index(request: Request) -> HTMLResponse: include_archived=False, member_email=None if admin else user["email"], ) - tree = _build_tree(projects) - # 진행중/완료 프로젝트를 별도 섹션으로 분류. list_projects 가 이미 - # sort_order 순으로 내려주므로 필터링만 해도 각 섹션 내부 순서는 그대로. - active_projects = [p for p in tree if p.get("status") != "completed"] - done_projects = [p for p in tree if p.get("status") == "completed"] + nav_projects = [ + { + "id": p["id"], + "name": p["name"], + "color": p.get("color") or "#4573d2", + "created_by": p.get("created_by") or "", + "description": p.get("description") or "", + "start_date": p.get("start_date"), + "due_date": p.get("due_date"), + "status": p.get("status") or "active", + } + for p in projects + if not p.get("parent_id") + ] + + today_iso = today_kst().isoformat() + my_tasks = st.list_tasks(assignee_email=user["email"], limit=1000) + for t in my_tasks: + t["start_label"] = _fmt_date_kr(t.get("start_date")) + t["due_label"] = _fmt_date_kr(t.get("due_date")) + d = t.get("due_date") + t["due_overdue"] = bool(d and d[:10] < today_iso and not t.get("completed_at")) + my_open_total = sum(1 for t in my_tasks if not t.get("completed_at")) - # 아바타 맵: 이메일(소문자) → 구글 프로필 이미지 URL (홈 카드 업무 담당자 표시용) from app.main import user_store # noqa: WPS433 avatars = { store.norm_str(u["email"], lower=True): u.get("picture") or "" @@ -433,84 +430,24 @@ async def index(request: Request) -> HTMLResponse: if u.get("picture") } - # 프로젝트 카드에 업무 미리보기(담당자·마감일·진행률) 붙이기 — 한눈에 현황 파악용. - # 완료 업무도 취소선으로 계속 보이도록 목록에 포함하되, 미완료를 먼저 보여준다. - today_iso = today_kst().isoformat() - for p in tree: - p_tasks = st.list_tasks(project_id=p["id"], include_subprojects=True, limit=500) - total = len(p_tasks) - open_tasks = [t for t in p_tasks if not t.get("completed_at")] - done_tasks = [t for t in p_tasks if t.get("completed_at")] - open_tasks.sort(key=lambda t: (t.get("due_date") is None, t.get("due_date") or "", t["id"])) - done_tasks.sort(key=lambda t: t.get("completed_at") or "", reverse=True) - ordered_tasks = open_tasks + done_tasks - for t in ordered_tasks: - t["assignee_display"] = ( - t.get("assignee_name") - or (t["assignee_email"].split("@")[0] if t.get("assignee_email") else "") - ) - d = t.get("due_date") - t["due_overdue"] = bool(d and d[:10] < today_iso and not t.get("completed_at")) - t["due_label"] = _fmt_date_kr(d) - p["task_total"] = total - p["task_done"] = len(done_tasks) - p["task_percent"] = round(len(done_tasks) * 100 / total) if total else 0 - p["task_preview"] = ordered_tasks[:8] - p["task_more"] = max(0, len(ordered_tasks) - 8) - p["due_label"] = _fmt_date_kr(p.get("due_date")) - - # 프로젝트 이름 아래 표시할 멤버(아이콘+이름) + 업무추가 버튼 노출 권한 - # (관리자 또는 해당 프로젝트 멤버/owner). - p_members = st.list_members(project_id=p["id"]) - p["members"] = [ - { - "email": m["user_email"], - "name": m.get("user_name") or m["user_email"].split("@")[0], - "avatar": avatars.get(store.norm_str(m["user_email"], lower=True), ""), - } - for m in p_members - ] - member_emails = {store.norm_str(m["user_email"], lower=True) for m in p_members} - p["can_add_task"] = ( - admin - or store.norm_str(user["email"], lower=True) in member_emails - or store.norm_str(p.get("owner_email"), lower=True) == store.norm_str(user["email"], lower=True) - ) - # 세션이 하나도 없으면 업무를 넣을 곳이 없다 — "업무 추가" 버튼 비활성화용. - p["has_stages"] = bool(st.list_stages(project_id=p["id"])) - - my_tasks = st.list_tasks(assignee_email=user["email"], limit=500) - for t in my_tasks: - t["start_label"] = _fmt_date_kr(t.get("start_date")) - t["due_label"] = _fmt_date_kr(t.get("due_date")) - # 내 업무를 프로젝트별로 묶어 트리로 표시(전체/진행/완료 개수 포함) - my_projects = _group_my_tasks(my_tasks) - - # 홈 화면 카드/내업무에 노출된 업무 전체(id→업무) — 클릭 시 페이지 이동 없이 - # 팝업으로 편집하기 위해 필요한 원본 데이터를 그대로 클라이언트에 넘긴다. - home_tasks: dict[str, Any] = {} - for p in tree: - for t in p.get("task_preview", []): - home_tasks[str(t["id"])] = t - for t in my_tasks: - home_tasks[str(t["id"])] = t - return render_template( request, - "project/index.html", + "project/mytasks.html", { "user": user, "is_admin": admin, "nav_items": build_erp_nav(user, active="project"), - "page_title": "프로젝트 관리", - "page_subtitle": "달력·타임라인·보드로 프로젝트를 관리하세요.", + "page_title": "내 업무", + "page_subtitle": "내가 담당자인 업무를 한 곳에서 봅니다.", "force_sidebar_collapsed": True, - "active_projects": active_projects, - "done_projects": done_projects, - "my_projects": my_projects, + "nav_projects": nav_projects, + "my_tasks": my_tasks, + "my_open_total": my_open_total, + "mention_unread": _safe_mention_unread(st, user["email"]), "avatars": avatars, - "home_tasks": home_tasks, - "today": today_kst().isoformat(), + "priority_labels": store.PRIORITY_LABELS, + "color_palette": list(store.COLOR_PALETTE), + "today": today_iso, }, ) @@ -607,12 +544,11 @@ async def project_page(request: Request, project_id: int) -> HTMLResponse: } # 우측 "내 업무" 패널 — 홈 화면과 동일한 쿼리/그룹핑(프로젝트별)을 재사용. - my_tasks = st.list_tasks(assignee_email=user["email"], limit=500) - for t in my_tasks: - t["start_label"] = _fmt_date_kr(t.get("start_date")) - t["due_label"] = _fmt_date_kr(t.get("due_date")) - my_projects = _group_my_tasks(my_tasks) - my_open_total = sum(g["open"] for g in my_projects) + # 좌측 사이드바 "내 업무" 배지(진행 중 개수)와 수신함 배지. + my_open_total = sum( + 1 for t in st.list_tasks(assignee_email=user["email"], limit=1000) + if not t.get("completed_at") + ) mention_unread = _safe_mention_unread(st, user["email"]) # 달력(휴가식 월간 그리드) — ?y=&m= 로 월 이동, 기본 이번 달 @@ -641,8 +577,6 @@ async def project_page(request: Request, project_id: int) -> HTMLResponse: "force_sidebar_collapsed": True, "project": project, "current_project_id": project_id, - "my_projects": my_projects, - "my_tasks": my_tasks, "my_open_total": my_open_total, "mention_unread": mention_unread, "nav_projects": nav_projects, diff --git a/app/modules/project/templates/project/_side.html b/app/modules/project/templates/project/_side.html new file mode 100644 index 0000000..952ce0a --- /dev/null +++ b/app/modules/project/templates/project/_side.html @@ -0,0 +1,84 @@ +{# ── 프로젝트 모듈 좌측 사이드바 (공용) ────────────────────────────── + 내 업무 화면(mytasks.html)과 프로젝트 화면(project.html)이 함께 쓴다. + + 변수: + mention_unread 미확인 @태그 개수 (수신함 배지) + my_open_total 진행 중인 내 업무 개수 (내 업무 배지) + nav_projects 프로젝트 목록(평면) + current_pid 지금 보고 있는 프로젝트 id (내 업무 화면이면 0) + is_admin 프로젝트 생성/수정/삭제 권한 + 프로젝트 수정/삭제(✎/×) 버튼은 그 동작을 배선하는 initProject 가 도는 + 프로젝트 화면에서만 그린다(current_pid 로 판별). #} + diff --git a/app/modules/project/templates/project/inbox.html b/app/modules/project/templates/project/inbox.html index c23dda0..e9a5cc1 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 %} @@ -84,5 +84,5 @@ - + {% endblock %} diff --git a/app/modules/project/templates/project/index.html b/app/modules/project/templates/project/index.html deleted file mode 100644 index 99bf562..0000000 --- a/app/modules/project/templates/project/index.html +++ /dev/null @@ -1,436 +0,0 @@ -{% extends "erp_base.html" %} - -{% block head_extra %} - - -{% endblock %} - -{% block content %} -
- - {% macro project_card(p) %} - - {% endmacro %} - -
- -
-
-

진행중인 프로젝트

-
- - notifications - - - -
-
- - {% if not active_projects and not done_projects %} -
- 아직 프로젝트가 없습니다. 상단의 새 프로젝트 버튼으로 만들어 보세요. -
- {% elif not active_projects %} -
진행중인 프로젝트가 없습니다.
- {% endif %} - -
- {% for p in active_projects %}{{ project_card(p) }}{% endfor %} -
- - {% if done_projects %} -
-

완료 프로젝트

-
-
- {% for p in done_projects %}{{ project_card(p) }}{% endfor %} -
- {% endif %} -
- - - -
-
- - - - - - - - - - - - - - - - - - - -{% endblock %} diff --git a/app/modules/project/templates/project/mytasks.html b/app/modules/project/templates/project/mytasks.html new file mode 100644 index 0000000..1f016c8 --- /dev/null +++ b/app/modules/project/templates/project/mytasks.html @@ -0,0 +1,104 @@ +{% extends "erp_base.html" %} + +{% block head_extra %} + + +{% endblock %} + +{% block topbar_actions %} + + notifications + + +{% endblock %} + +{% block content %} +{# 프로젝트 모듈의 첫 화면 = 내 업무. 예전 프로젝트 홈(카드 그리드)은 없앴다. #} +
+
+ {% with current_pid = 0 %}{% include "project/_side.html" %}{% endwith %} + +
+
+
+ + + +
+
+

+ 내 업무 +

+
+
+
+ +
+ + + +
+ +
+
+
+
+ + + + + + + + + + +{% endblock %} diff --git a/app/modules/project/templates/project/project.html b/app/modules/project/templates/project/project.html index 023cec7..3005f9d 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 %} - + @@ -27,129 +27,8 @@ data-me="{{ user.email }}">
- - + + {% with current_pid = project.id %}{% include "project/_side.html" %}{% endwith %}
@@ -426,21 +305,22 @@
-
- -