feat(project): 용어 "업무" 통일·섹션 담당자 바로 지정·세부 업무 협업자·반응 알림

- 화면·메시지·알림 제목·도움말의 "작업" → "업무"(조사 포함). 큰 알림 팝업·PC 알림 소스는 예전 "작업 배정:" 접두어도 뗀다
- 보드·목록 섹션 제목 오른쪽 담당자 아이콘을 눌러 기본 담당자를 그 자리에서 지정
- 섹션을 접으면 제목 보통 굵기, 펼치면 다시 굵게
- 업무 창 세부 업무 줄 담당자 오른쪽에 협업자 지정(subtasks[].followers, list_followers_of)
- 댓글 이모티콘 반응을 켜면 댓글 쓴 사람에게 어떤 이모티콘인지 수신함 알림(type=reaction)
- 왼쪽 전체 보기의 기본 보기는 대시보드
- 대시보드 업무 목록 패널에서 연 업무 창은 패널 왼쪽에 열림

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-13 11:27:38 +09:00
parent ac0f48bfce
commit 542e7fb7d1
26 changed files with 654 additions and 375 deletions
+28 -2
View File
@@ -4,9 +4,9 @@
> 보드로 관리하는 아사나(Asana) 스타일 협업 모듈. DB는 `project_db` 전용.
**화면 용어는 아사나 한국어판에 맞춘다(2026-09-25 통일)** — 새 화면·메시지도 이 표를 따른다.
작업(예전 "업무") · 하위 작업 / 상위 작업 · 내 작업 · 섹션(예전 "세션"·"단계") ·
**업무**(2026-10-13 다시 "작업" → "업무"로 통일 — 화면·메시지·알림 제목 모두, 6-16) · 세부 업무 / 상위 업무 · 메인 업무 · 내 업무 · 섹션(예전 "세션"·"단계") ·
협업자(예전 "팔로워", 버튼은 "협업자로 참여 / 협업자에서 나가기" — 예전 "팔로우 / 팔로우 취소") ·
목록(보기 탭, 예전 "리스트") · 캘린더(예전 "달력") · 수신함 · 첨부 파일 · 작업 링크 복사 ·
목록(보기 탭, 예전 "리스트") · 캘린더(예전 "달력") · 수신함 · 첨부 파일 · 업무 링크 복사 ·
프로젝트 칸 + "다른 프로젝트에 추가"(예전 "연결된 프로젝트") · 담당자 없음(예전 "(미지정)").
"@태그"는 그대로 쓴다. 코드 식별자·DB 컬럼(`tasks`, `stage_id`, `task_followers` 등)과 코드 주석은 예전 이름 그대로다.
**도움말** — `/project/help`(`project/help.html` + `static/project-help.css`·`static/project-help.js`), 프로젝트 관리 화면 상단 바 로그아웃
@@ -293,6 +293,7 @@
초록 채움 높이 = 완료율, 위 = 완료/전체·%. 처음엔 높이를 작업 수로 그려 많은 사람 기준에 다른 막대가 눌려 보였다 → 완료율로 수정). 막대를 누르면 오른쪽 슬라이드 패널(`openWorkloadDrawer`, body 에 붙음, z 950 — 편집 창 아래)에
그 업무 목록(미완료·완료, 하위는 상위 작업 이름), 항목 → `openTaskById`(하위는 서버에서 받아) 편집 창. 편집 창이 닫히면
요약을 다시 받아 대시보드·패널을 다시 그린다. 하위 요약 API 는 id·제목·마감일·완료 시각도 준다.
**패널에서 연 편집 창은 패널 왼쪽에 붙어 열린다**(2026-10-13, `placeTaskBesideDrawer` — 패널은 그대로 보이고 다른 줄을 바로 누를 수 있음, 6-16).
- **보드** — 섹션별 칸반. `renderBoard` 는 캔버스를 통째로 다시 그리므로 **섹션 세로 스크롤(`.pj-col-body`,
섹션 id/이름 기준)·보드 가로 스크롤을 저장했다가 되돌린다**(작업 창 닫기·완료 체크·8초 갱신 후에도 보던 자리).
작업 창을 닫으면 펼친 카드의 하위 작업을 먼저 다 받은 뒤 한 번에 다시 그린다(짧아진 채 그리면 스크롤이 밀림). 섹션은 아사나처럼 **가로로 계속 늘어난다** — 화면을 넘치면
@@ -512,6 +513,7 @@ description 을 항상 HTML로 취급하기 때문). 두 번 실행하면 이중
자동 배정도 일반 배정과 같이 활동이력·협업자·인앱 알림·메일이 나간다(`_newly_assigned`).
멀티호밍으로 연결된 프로젝트 쪽 섹션 이동(`/links`)은 대상 아님.
- 보드 섹션 머리 이름 옆에 기본 담당자 아바타(작게, 툴팁). 새 작업 팝업은 그 섹션 기본 담당자를 미리 채운다.
**2026-10-13**: 편집 권한자는 보드·목록 섹션 제목 오른쪽 아이콘(없으면 점선 원)을 눌러 그 자리에서 기본 담당자를 고른다(6-16).
- 009 미적용이어도 앱은 동작 — 조회는 `to_jsonb(행)->>'default_assignee_email'` 로 컬럼 유무와
무관, 지정 시도만 503("마이그레이션 009 필요"). 화면은 기본 담당자가 바뀐 경우에만 필드를 보낸다.
@@ -561,6 +563,8 @@ description 을 항상 HTML로 취급하기 때문). 두 번 실행하면 이중
댓글 대화창은 말풍선 위 인용으로 답글 표시, 입력칸 위 "OO 님에게 답글" 줄.
본문의 `@아이디` 는 사용자 목록(`/api/all-users`)과 맞으면 아이콘+이름 칩(`commentBodyHtml`).
- 012 미적용이면 답글·반응 버튼이 숨겨지고, API 는 503 "마이그레이션 012 필요". 완료 이력·@칩은 012 없이도 동작.
- **반응 알림**(2026-10-13): 반응을 켤 때(끌 때 X) 그 댓글을 쓴 사람에게 수신함 알림 `type=reaction`,
제목 "내 댓글에 👍 반응: 업무 제목"(어떤 이모티콘인지), 본문 "프로젝트 · “댓글 앞부분”". 자기 댓글·지금 그 업무를 볼 수 없는 사람은 제외(`_notify_reaction`).
## 6-8. 수신함 오른쪽 작업 창 · 화면 배율
@@ -1079,6 +1083,7 @@ Windows 트레이 프로그램 **DBX 알림**(`desktop/notifier/`, C# .NET Frame
- **전체 보기**: 프로젝트 화면 오른쪽 위 범위 토글(`#pj-scope-toggle`)은 숨기고, 왼쪽 메뉴 수신함 아래 **전체 보기**(Pro user 이상,
`#pj-side-allview`) — 지금 프로젝트(없으면 목록 첫 활성 프로젝트) `/project/p/{id}?scope=all`. 프로젝트 화면에서는 새로고침 없이
`applyAllScope(true)`. `?scope=all` 은 `data-is-pro` 일 때만 따른다. 이 프로젝트로 돌아가기 = 왼쪽 목록에서 프로젝트.
**기본 보기는 대시보드**(2026-10-13 — 메뉴를 누르거나 `?scope=all` 로 들어오면 `selectView("dashboard")`, 달력 이전/다음 달 새로고침은 예전처럼 마지막 보기).
- **수신함 작업 창**: [확인]으로 연 오른쪽 작업 창은 왼쪽 수신함 영역(`.pj-inbox-view`)을 누르면 닫힌다(메뉴·모달·알림 팝업 제외).
- **설명란 글자 색·크기**: 서식 도구 [글자 색](10색, 기본)·[글자 크기](작게 12px·보통·크게 18px·더 크게 22px·제목 28px).
`execCommand` 가 만든 `<font>` 를 바로 `<span style>` 로 바꾸고, 서버 `sanitize_description_html` 은 평범한 span 의 style 에서
@@ -1237,6 +1242,27 @@ Windows 트레이 프로그램 **DBX 알림**(`desktop/notifier/`, C# .NET Frame
정책 결정이 필요한 것(바꾸지 않음): 배정·완료 **메일**은 `PROJECT_NOTIFY_EMAIL`(없으면 Admin 전원)에게 프로젝트·작업 제목·담당자가
간다 — 화면에선 비멤버 Admin 이 그 프로젝트를 못 보지만 메일로는 제목을 받는다(4장 관리자 보고 정책).
## 6-16. 용어 "업무" · 섹션 담당자 바로 지정 · 세부 업무 협업자 · 반응 알림 · 전체 보기 대시보드 (2026-10-13, 마이그레이션 없음)
- **용어 "작업" → "업무"** — Project 모듈의 화면 글자·메시지·서버 오류 문구·알림 제목(`업무 배정:`·`업무 완료:`·메일 제목)·도움말 전부
(조사도 맞춤: 업무를·업무가·업무로). 코드 식별자·주석·DB 는 그대로. 이미 쌓인 알림 행 제목은 예전 글자 그대로라, 큰 알림 팝업은
`나를 태그함|업무 배정|작업 배정` 접두어를 모두 뗀다. PC 알림 프로그램(`desktop/notifier`) 소스도 둘 다 떼도록 바꿨다 —
**다시 빌드해 배포하기 전의 exe 는 새 알림에 "업무 배정:" 접두어가 제목에 남아 보인다**(기능 영향 없음).
- **섹션 제목 오른쪽 담당자** — 보드 섹션 머리·목록 섹션 줄의 기본 담당자 아이콘(`stageAssigneeHtml`). 편집 권한자는 눌러서
멤버 메뉴(`openStageAssigneeMenu` → `PUT /api/projects/{id}/stages/{sid}` `default_assignee_email`), 없으면 점선 원 아이콘. 접힌 보드 섹션에서는 숨김.
- **접은 섹션 제목은 보통 굵기** — 보드 `.pj-col.is-collapsed .pj-col-name`, 목록 `.pj-list-group-head.is-collapsed .pj-list-group-name` 은
`font-weight: 400`, 펼치면 다시 굵게(6-12).
- **업무 창 세부 업무 줄 협업자** — 담당자 아이콘 오른쪽 `.pj-subtask-fol`(없으면 점선 원 두 사람, 줄 hover 때만 / 있으면 첫 사람 + "+N").
누르면 멤버 메뉴(협업자는 ✓) → 그 세부 업무의 `POST/DELETE /api/tasks/{sub}/followers`. 데이터는 `GET /api/tasks/{id}` 의
`subtasks[].followers`(`db.list_followers_of` 로 한 번에, 008 미적용·읽기 전용이면 없음 → 아이콘 숨김).
- **댓글 반응 알림** — 6-7.
- **전체 보기 → 대시보드** — 6-12.
- **대시보드 업무 목록 패널 → 편집 창** — 패널 줄을 누르면 편집 창(`#pj-modal-task.pj-beside-drawer`)의 `right` 를 패널 폭(배율이면 `/ uiZoom()`)으로
두어 패널 왼쪽에서 슬라이드로 열린다(`overflow:hidden` 이라 슬라이드 중 패널을 덮지 않음). 고른 줄은 `.is-current`. 편집 창 바깥(왼쪽) 클릭은
예전처럼 편집 창 닫기 → 패널 다시 그림. 패널을 닫으면 편집 창은 화면 오른쪽 끝으로.
- 검증: `tests/test_project_module.py::test_subtask_followers_and_reaction_alert`(실제 PG), `tests/js/project_ui.test.js`
([섹션 담당자]·[세부 업무 협업자]·[대시보드 담당자별] 패널 왼쪽·[전체 보기] 기본 대시보드).
## 7. 추후 단계
작업 라벨(태그 분류) · 반복 작업 · 템플릿 · 작업 의존성.