diff --git a/CLAUDE.md b/CLAUDE.md
index 7513603..d5d2bff 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, 세션 기본 담당자 `default_assignee_email` — 담당자 빈 업무를 그 세션에 만들거나 옮기면 자동 배정, 마이그레이션 009)·멤버 배정(`project_members`)·활동이력(`project_activity`). 첫 화면(`/project/`)은 **내 업무 목록**(프로젝트 홈 카드 화면은 폐지). 프로젝트 화면은 달력(FullCalendar)/타임라인(vis-timeline)/보드/리스트/대시보드 뷰 토글. 좌측 사이드바는 두 화면 공용(`templates/project/_side.html`). 보드는 아사나처럼 세션이 가로로 계속 늘어나고(넘치면 가로 스크롤) 카드의 담당자·마감일을 클릭해 그 자리에서 바꾼다. 좌측 사이드바에 수신함·내 업무(접이식) 메뉴. 설명란은 주소 붙여넣기 시 자동 링크, 설명란·댓글에서 @로 멤버를 태그하면 (`task_mentions`, 마이그레이션 006) 수신함에 그 업무가 쌓인다. 진입 권한키 `project`(관리자 페이지 토글로 직원별 부여, admin 자동). 프로젝트 생성은 `project` 권한자 누구나(만든 사람이 owner), 삭제는 만든 사람만(슈퍼관리자 예외), 사용자 배정은 `is_admin` 만. 배정 멤버(또는 owner/admin)만 그 프로젝트를 조회(화면·API 모두, 비멤버 403)하고 서브프로젝트/업무/단계 CRUD — URL 의 세션·부모 업무가 그 프로젝트 것인지 서버가 검증. 실시간 반영은 `project_live_version` 카운터(마이그레이션 007, 미적용 시 MAX 폴백). 사이드바 전체 검색(`/api/search`, 제목·설명·댓글, pg_trgm) + 프로젝트/내 업무 필터 바(찾기·상태·담당자·마감·우선순위·정렬, 클라이언트 필터). 팔로워(`task_followers`, 자동 팔로우: 만든 사람·담당자·댓글·@태그) — 완료·댓글 알림은 담당자+팔로워에게만. 마감 알림(`reminders.py` 데몬 스레드, 영업일 09시, D-1/당일/지연, `task_reminders` 로 중복 방지, `PROJECT_REMINDER_*` env) — 마이그레이션 008. 라우터 핸들러는 동기 DB 라 `def` 로 둔다(`async def` 금지). 멤버 배정 후보는 `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, 세션 기본 담당자 `default_assignee_email` — 담당자 빈 업무를 그 세션에 만들거나 옮기면 자동 배정, 마이그레이션 009)·멤버 배정(`project_members`)·활동이력(`project_activity`). 첫 화면(`/project/`)은 **내 업무 목록**(프로젝트 홈 카드 화면은 폐지). 프로젝트 화면은 달력(FullCalendar)/타임라인(vis-timeline)/보드/리스트/대시보드 뷰 토글. 좌측 사이드바는 두 화면 공용(`templates/project/_side.html`). 보드는 아사나처럼 세션이 가로로 계속 늘어나고(넘치면 가로 스크롤) 카드의 담당자·마감일을 클릭해 그 자리에서 바꾼다. 좌측 사이드바에 수신함·내 업무(접이식) 메뉴. 설명란은 주소 붙여넣기 시 자동 링크, 설명란·댓글에서 @로 멤버를 태그하면 (`task_mentions`, 마이그레이션 006) 수신함에 그 업무가 쌓인다. 진입 권한키 `project`(관리자 페이지 토글로 직원별 부여, admin 자동). 프로젝트 생성은 `project` 권한자 누구나(만든 사람이 owner), 삭제는 만든 사람만(슈퍼관리자 예외), 사용자 배정은 `is_admin` 만. 배정 멤버(또는 owner/admin)만 그 프로젝트를 조회(화면·API 모두, 비멤버 403)하고 서브프로젝트/업무/단계 CRUD — URL 의 세션·부모 업무가 그 프로젝트 것인지 서버가 검증. 실시간 반영은 `project_live_version` 카운터(마이그레이션 007, 미적용 시 MAX 폴백). 사이드바 전체 검색(`/api/search`, 제목·설명·댓글, pg_trgm) + 프로젝트/내 업무 필터 바(찾기·상태·담당자·마감·우선순위·정렬, 클라이언트 필터). 팔로워(`task_followers`, 자동 팔로우: 만든 사람·담당자·댓글·@태그) — 완료·댓글 알림은 담당자+팔로워에게만. 마감 알림(`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` 비동기). 상세는 `docs/PROJECT_MODULE.md`
상세는 `docs/PROJECT_OVERVIEW.md`.
diff --git a/app/modules/project/templates/project/inbox.html b/app/modules/project/templates/project/inbox.html
index aecd711..a8794fc 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 %}
@@ -98,5 +98,5 @@
{% 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 ebe4c18..3d29584 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 %}
@@ -119,5 +119,5 @@
"today": {{ today | tojson }}
}
-
+
{% endblock %}
diff --git a/app/modules/project/templates/project/project.html b/app/modules/project/templates/project/project.html
index 2777e1f..4df8edb 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 %}
-
+
@@ -505,5 +505,5 @@
-
+
{% endblock %}
diff --git a/app/static/project.css b/app/static/project.css
index 484c01b..c234c1d 100644
--- a/app/static/project.css
+++ b/app/static/project.css
@@ -332,21 +332,29 @@
.pj-th-resize { position: absolute; top: 0; right: -3px; width: 8px; height: 100%; cursor: col-resize; z-index: 2; }
.pj-th-resize:hover { background: linear-gradient(90deg, transparent 40%, #c9d4ea 40%, #c9d4ea 60%, transparent 60%); }
-/* 마우스를 따라다니는 작은 툴팁 — 제목 옆 멤버 아이콘의 이름 표시용. */
+/* ── 공용 말풍선(아사나식) — 프로젝트 화면의 모든 말풍선은 이 모양 하나.
+ data-tip 또는 title 을 단 요소에 마우스를 올리면 initHoverTips 가 커서
+ 바로 위에 띄운다(가로 가운데 = 커서, 아래 꼬리가 커서를 가리킴).
+ 새 기능도 title= / data-tip= 만 달면 된다 — 별도 툴팁 구현 금지. */
.pj-hovertip {
- position: fixed; z-index: 1400; pointer-events: none;
- background: #1e1f21; color: #fff; font-size: 12.5px; font-weight: 600;
+ position: fixed; z-index: 3000; pointer-events: none;
+ background: #1e1f21; color: #fff; font-size: 12.5px; font-weight: 600; line-height: 1.35;
padding: 6px 10px; border-radius: 6px; white-space: nowrap;
- /* left/top 은 커서 좌표 그대로 — 말풍선 아래-가운데를 그 점에 맞춰
- 커서 바로 위, 가로로는 커서 중앙에 오게 한다. */
+ box-shadow: 0 2px 8px rgba(0,0,0,.18);
transform: translate(-50%, calc(-100% - 6px));
+ animation: pj-tip-in .12s ease-out;
}
-/* 아사나 말풍선처럼 아래쪽 가운데 꼬리 */
+/* 아래쪽 가운데 꼬리 — 가장자리 보정으로 말풍선이 밀리면 꼬리는 커서 쪽으로 */
.pj-hovertip::after {
- content: ""; position: absolute; left: 50%; top: 100%; transform: translateX(-50%);
+ content: ""; position: absolute; top: 100%;
+ left: calc(50% + var(--pj-tip-shift, 0px)); transform: translateX(-50%);
border: 5px solid transparent; border-top-color: #1e1f21;
}
+/* 위 공간이 모자라면 커서 아래로 뒤집고 꼬리는 위로 */
+.pj-hovertip.is-below { transform: translate(-50%, 0); }
+.pj-hovertip.is-below::after { top: auto; bottom: 100%; border-top-color: transparent; border-bottom-color: #1e1f21; }
.pj-hovertip[hidden] { display: none; }
+@keyframes pj-tip-in { from { opacity: 0; } to { opacity: 1; } }
/* ── 달력 (휴가 모듈과 동일한 월간 그리드 룩) ── */
.pj-cal-head { display: flex; align-items: center; gap: 10px; margin-bottom: 12px; }
@@ -1029,12 +1037,18 @@ label.pj-desc-fmtbtn { line-height: 26px; }
.pj-dash-legend-dot { width: 10px; height: 10px; border-radius: 50%; flex: 0 0 auto; }
/* 막대/세그먼트 호버 툴팁 — 값이 크게, 라벨은 보조(값 우선 원칙) */
+/* 공용 말풍선(.pj-hovertip)과 같은 모양 — 막대 위에 붙고 아래 꼬리 */
.pj-dash-tooltip {
- position: absolute; z-index: 2150; transform: translate(-50%, -100%);
- background: var(--pj-ink); color: #fff; padding: 6px 10px; border-radius: 8px;
+ position: absolute; z-index: 2150; transform: translate(-50%, calc(-100% - 6px));
+ background: #1e1f21; color: #fff; padding: 6px 10px; border-radius: 6px;
font-size: 12px; white-space: nowrap; pointer-events: none;
- box-shadow: var(--pj-card-shadow-hover);
+ box-shadow: 0 2px 8px rgba(0,0,0,.18);
}
+.pj-dash-tooltip::after {
+ content: ""; position: absolute; top: 100%; left: 50%; transform: translateX(-50%);
+ border: 5px solid transparent; border-top-color: #1e1f21;
+}
+.pj-dash-tooltip[hidden] { display: none; }
.pj-dash-tooltip b { font-size: 13.5px; margin-right: 6px; }
.pj-dash-tooltip span { color: #cfd3da; }
diff --git a/app/static/project.js b/app/static/project.js
index fa66faf..177a749 100644
--- a/app/static/project.js
+++ b/app/static/project.js
@@ -5032,8 +5032,16 @@
// ── 마우스를 따라다니는 작은 툴팁 — [data-tip] 달린 요소 아무데나 공용.
// 지금은 제목 옆 프로젝트 멤버 아이콘(이름 표시)에 쓴다. 나중에 그려지는
// 요소에도 붙도록 이벤트 위임 방식이다.
+ // ── 공용 말풍선(아사나식: 어두운 배경 + 아래 꼬리, 커서 바로 위) ──
+ // 프로젝트 화면의 "모든" 말풍선은 이것 하나로 통일한다(앞으로 추가하는 기능도).
+ // · data-tip="문구" 를 달면 이 말풍선이 뜬다.
+ // · 브라우저 기본 title 말풍선도 자동으로 이걸로 바뀐다 — 마우스를 올리는
+ // 순간 title 을 data-tip 으로 옮기고 title 은 지운다(기본 말풍선 억제).
+ // 그래서 새 코드에서 title= 을 써도 같은 모양이 된다.
+ // 이벤트 위임이라 나중에 그려지는 요소도 따로 배선할 필요가 없다.
function initHoverTips() {
let tipEl = null;
+ let shown = false;
function show(text, x, y) {
if (!tipEl) {
tipEl = document.createElement("div");
@@ -5041,20 +5049,38 @@
document.body.appendChild(tipEl);
}
tipEl.textContent = text;
- tipEl.style.left = x + "px";
- tipEl.style.top = (y - 10) + "px";
tipEl.hidden = false;
+ // 화면 가장자리 보정 — 좌우로 넘치면 말풍선만 안쪽으로 밀고 꼬리는
+ // 커서를 계속 가리키게(--pj-tip-shift). 위가 모자라면 커서 아래로 뒤집는다.
+ const w = tipEl.offsetWidth, h = tipEl.offsetHeight;
+ const vw = document.documentElement.clientWidth;
+ const cx = Math.min(Math.max(x, 8 + w / 2), vw - 8 - w / 2);
+ const below = y - 16 - h < 4;
+ tipEl.classList.toggle("is-below", below);
+ tipEl.style.setProperty("--pj-tip-shift", (x - cx) + "px");
+ tipEl.style.left = cx + "px";
+ tipEl.style.top = (below ? y + 22 : y - 10) + "px";
}
- function hide() { if (tipEl) tipEl.hidden = true; }
- // 이벤트 위임 — 멤버 아이콘(renderMemberList)처럼 나중에 그려지는
- // 요소에도 따로 배선하지 않고 그대로 동작한다.
- let shown = false;
+ function hide() { shown = false; if (tipEl) tipEl.hidden = true; }
+ document.addEventListener("mouseover", function (e) {
+ const el = e.target.closest ? e.target.closest("[title]") : null;
+ if (!el) return;
+ const t = el.getAttribute("title");
+ if (t) el.dataset.tip = t; // 코드가 title 을 새로 바꿨으면 최신 값으로
+ el.removeAttribute("title");
+ }, true);
document.addEventListener("mousemove", function (e) {
const target = e.target.closest ? e.target.closest("[data-tip]") : null;
- if (!target) { if (shown) { shown = false; hide(); } return; }
+ if (!target || !target.dataset.tip) { if (shown) hide(); return; }
shown = true;
show(target.dataset.tip, e.clientX, e.clientY);
});
+ // 누르거나 스크롤하면 숨긴다 — 클릭으로 요소가 다시 그려지면 말풍선만
+ // 허공에 남는 일이 없게.
+ document.addEventListener("mousedown", hide, true);
+ window.addEventListener("scroll", hide, true);
+ window.addEventListener("blur", hide);
+ document.addEventListener("mouseleave", hide);
}
document.addEventListener("DOMContentLoaded", function () {
diff --git a/docs/PROJECT_MODULE.md b/docs/PROJECT_MODULE.md
index 0a5b7b5..b8a83ba 100644
--- a/docs/PROJECT_MODULE.md
+++ b/docs/PROJECT_MODULE.md
@@ -86,6 +86,12 @@
## 3. 화면 / 뷰
+> **말풍선(툴팁) 규칙 — 모든 화면·앞으로 추가하는 기능 공통.** 말풍선은 아사나식 공용 말풍선
+> 하나(`.pj-hovertip`, `initHoverTips`)만 쓴다: 어두운 배경 + 아래 꼬리, 커서 바로 위, 화면 끝이면
+> 안쪽으로 밀리고 위가 모자라면 아래로 뒤집힘. 요소에 `data-tip="문구"` 또는 `title="문구"` 만 달면
+> 된다(`title` 은 마우스를 올리는 순간 `data-tip` 으로 옮겨져 브라우저 기본 말풍선이 안 뜬다).
+> 별도 툴팁 구현 금지 — 부득이하면(대시보드 막대처럼 요소에 붙는 것) 같은 색·꼬리 모양으로.
+
- **내 업무** (`/project/`): 프로젝트 모듈의 첫 화면. 예전 홈(프로젝트 카드 그리드)은
**없앴다** — 좌측 "내 업무" 메뉴와 같은 화면이다(`project/mytasks.html`).
내가 담당자인 업무를 한 표에 모아 보여준다: 완료 체크박스 · 업무 · 프로젝트 · 세션 ·