feat(project): 보드 가로 스크롤 · 카드 인라인 편집 · 내 업무 사이드 메뉴 · @태그

- 보드: 매이슨리 절대배치 제거 → 아사나식 flex 가로 배치. 세션이 늘어나면
  아래로 접히지 않고 계속 오른쪽으로 이어지고, 보드가 가로로 스크롤된다
  (막대는 attachHScrollIndicator 가 직접 그린다). 긴 세션은 컬럼 안에서 세로 스크롤.
- 카드: 담당자/마감일을 클릭하면 팝업을 열지 않고 그 자리에서 바꾼다.
  값이 없는 칩은 카드 호버 시 흐리게 나타나 바로 지정할 수 있다.
- 내 업무: 화면 오른쪽 상시 패널을 없애고 좌측 사이드바의 접이식 메뉴로 이전
  (기본 접힘, 업무를 고르면 팝업이 열리며 다시 접힘). 레이아웃 3열 → 2열.
- 설명란: 웹주소를 붙여넣으면 자동 링크(target=_blank), 클릭하면 새 탭으로 연다.
  contenteditable 은 브라우저가 링크를 기본으로 열지 않아 클릭을 직접 받는다.
- @태그: 설명란·댓글에서 @ 로 멤버를 고른다. 설명란은 멘션 칩(data-email),
  댓글은 화면이 고른 이메일을 함께 전송. 서버는 설명란의 경우 저장될 HTML 에서
  직접 이메일을 뽑는다(화면이 보낸 목록을 믿지 않는다).
  태그된 사람은 수신함(/project/inbox)에서 그 업무를 리스트로 본다.

DB: 마이그레이션 006(task_mentions) 신규 — 배포 시 적용 필요.
    미적용 환경에서도 화면이 죽지 않게 멘션 조회/기록은 모두 감쌌다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-09-22 11:04:21 +09:00
parent 79aa16bf49
commit fac8d5a0b1
11 changed files with 1152 additions and 166 deletions
+116 -2
View File
@@ -171,6 +171,37 @@ def _inbox(
logger.warning("알림 생성 실패: %s", r)
def _record_mentions(
st: Any, *, task: dict[str, Any], emails: list[str], actor: str,
comment_id: int | None = None, source: str = "description",
project_name: str = "",
) -> None:
"""@태그를 기록하고 새로 태그된 사람에게만 알림을 만든다.
태그는 부가 기능이라 여기서 실패해도(예: 006 마이그레이션 미적용) 본
저장/등록은 막지 않는다 — 로그만 남긴다.
"""
if not emails:
return
try:
added = st.add_mentions(
task_id=task["id"], emails=emails, actor_email=actor,
comment_id=comment_id, source=source,
)
except Exception: # noqa: BLE001
logger.warning("멘션 기록 실패: task=%s", task.get("id"))
return
if not added:
return
where = "댓글" if source == "comment" else "설명"
_inbox(
st, recipients=added, actor=actor,
project_id=task["project_id"], task_id=task["id"], ntype="mention",
title=f"나를 태그함: {task['title']}",
body=f"{project_name or task.get('project_name') or ''} · {where}",
)
def _render_config_needed(request: Request, user: dict[str, Any]) -> HTMLResponse:
from app.main import build_erp_nav, render_template # noqa: WPS433
from app.store import is_admin # noqa: WPS433
@@ -454,6 +485,8 @@ async def index(request: Request) -> HTMLResponse:
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)
mention_unread = _safe_mention_unread(st, user["email"])
# 홈 화면 카드/내업무에 노출된 업무 전체(id→업무) — 클릭 시 페이지 이동 없이
# 팝업으로 편집하기 위해 필요한 원본 데이터를 그대로 클라이언트에 넘긴다.
@@ -610,6 +643,8 @@ async def project_page(request: Request, project_id: int) -> HTMLResponse:
"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,
"stages": stages,
"tasks": all_tasks,
@@ -985,6 +1020,11 @@ async def api_create_task(
title=f"업무 배정: {task['title']}",
body=f"{project['name']} · 마감 {task.get('due_date') or '-'}",
)
_record_mentions(
st, task=task,
emails=store.extract_mentions_from_html(task.get("description") or ""),
actor=user["email"], project_name=project["name"],
)
return JSONResponse({"task": task}, status_code=201)
@@ -1053,6 +1093,12 @@ async def api_update_task(
actor=user["email"], project_id=existing["project_id"], task_id=task_id,
ntype="completed", title=f"업무 완료: {task['title']}", body=project_name,
)
if "description" in payload:
_record_mentions(
st, task=task,
emails=store.extract_mentions_from_html(payload["description"]),
actor=user["email"], project_name=project_name,
)
return JSONResponse({"task": task})
@@ -1185,6 +1231,13 @@ async def api_add_comment(
ntype="comment", title=f"새 댓글: {task['title']}",
body=comment["body"][:120],
)
# 댓글은 평문이라 본문에서 이메일을 꺼낼 수 없다 — 화면이 고른 멤버
# 목록을 그대로 받아 기록한다(설명란은 본문 HTML 에서 직접 뽑는다).
_record_mentions(
st, task=task, emails=store.normalize_emails(payload.get("mentions")),
actor=user["email"], comment_id=comment["id"], source="comment",
project_name=project.get("name", ""),
)
return JSONResponse({"comment": comment}, status_code=201)
@@ -1433,6 +1486,62 @@ async def api_notif_read_all(request: Request) -> JSONResponse:
return JSONResponse({"ok": True, "marked": n})
# ────────────────────────────────────────────────────────────
# 수신함 — 나를 @태그한 업무 (아사나 Inbox)
# ────────────────────────────────────────────────────────────
def _safe_mentions(st: Any, email: str, *, limit: int = 100) -> list[dict[str, Any]]:
"""task_mentions 조회. 006 마이그레이션 미적용 환경에서도 화면이 죽지 않게."""
try:
return st.list_mentioned_tasks(mentioned_email=email, limit=limit)
except Exception: # noqa: BLE001
logger.warning("멘션 조회 실패 — project_db_006 마이그레이션 확인 필요")
return []
def _safe_mention_unread(st: Any, email: str) -> int:
try:
return st.count_unread_mentions(mentioned_email=email)
except Exception: # noqa: BLE001
return 0
@router.get("/api/mentions")
async def api_mentions(request: Request) -> JSONResponse:
"""나를 태그한 업무 목록 + 미확인 개수."""
user = _require_user(request)
st = _db_or_503(request)
tasks = _safe_mentions(st, user["email"])
return JSONResponse({
"tasks": tasks,
"unread": _safe_mention_unread(st, user["email"]),
})
@router.get("/api/mentions/unread-count")
async def api_mentions_unread(request: Request) -> JSONResponse:
user = _require_user(request)
st = _db_or_503(request)
return JSONResponse({"unread": _safe_mention_unread(st, user["email"])})
@router.post("/api/mentions/read")
async def api_mentions_read(
request: Request, payload: dict[str, Any] = Body(default={})
) -> JSONResponse:
"""태그 확인 처리. task_id 를 주면 그 업무만, 없으면 전부."""
user = _require_user(request)
st = _db_or_503(request)
task_id = payload.get("task_id")
try:
n = st.mark_mentions_read(
mentioned_email=user["email"],
task_id=int(task_id) if task_id else None,
)
except Exception: # noqa: BLE001
n = 0
return JSONResponse({"ok": True, "marked": n})
@router.get("/inbox", response_class=HTMLResponse)
async def inbox_page(request: Request) -> HTMLResponse:
from app.main import build_erp_nav, render_template # noqa: WPS433
@@ -1443,6 +1552,9 @@ async def inbox_page(request: Request) -> HTMLResponse:
if st is None:
return _render_config_needed(request, user)
items = st.list_notifications(recipient_email=user["email"], limit=100)
mentioned = _safe_mentions(st, user["email"])
for t in mentioned:
t["due_label"] = _fmt_date_kr(t.get("due_date"))
return render_template(
request,
"project/inbox.html",
@@ -1450,9 +1562,11 @@ async def inbox_page(request: Request) -> HTMLResponse:
"user": user,
"is_admin": is_admin(user),
"nav_items": build_erp_nav(user, active="project"),
"page_title": "알림센터",
"page_subtitle": "내게 온 프로젝트 알림",
"page_title": "수신함",
"page_subtitle": "나를 태그한 업무와 프로젝트 알림",
"force_sidebar_collapsed": True,
"notifications": items,
"mentioned_tasks": mentioned,
"mention_unread": _safe_mention_unread(st, user["email"]),
},
)