62c345bbb5
[프로젝트]
- 보드 카드 끌기: 기울어진 끄는 모양 + 점선 자리 표시가 카드 사이로 FLIP 애니메이션, 놓은 자리 그대로(다른 섹션도 순서 저장)
- 컬럼 dragenter 도 허용 — 자리 표시가 들어온 직후 놓을 때 drop 이 거부되던 문제
- 끄는 동안 실시간 동기화가 보드를 다시 그리지 않음
- 주간 회의록 항목 칸을 끌어 위아래로 이동(묶인 줄·세로 병합째, 같은 구역) — POST meeting-items/{id}/move-to
- 주간 회의록 표 테두리 모두 검정
- 도움말·모듈 문서 갱신
[실적]
- 설정의 쇼핑몰 원본 데이터 확인·카페24 매출 대조·일별 한 번에 비교 카드 삭제(서버 API 는 유지)
- 보기 설정: 매출 단위 원·천원·백만원(이 브라우저 쿠키 perf_unit)
- 매출 실적 표 매출 칸 아래 광고비(ROAS%) 줄(광고비 색), 카페24 는 구글·메타 두 줄
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1409 lines
176 KiB
Markdown
1409 lines
176 KiB
Markdown
# 프로젝트 관리 모듈 (아사나식) — `app/modules/project/`
|
||
|
||
> 회사(dbxcorp.co.kr) 직원이 프로젝트→섹션→작업 3단계 구조를 캘린더/타임라인/
|
||
> 보드로 관리하는 아사나(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`), 프로젝트 관리 화면 상단 바 로그아웃
|
||
오른쪽 **?** 아이콘(`_help_btn.html`, `erp_base.html` 의 `topbar_after_logout` 블록)으로 새 탭에서 연다. 처음 쓰는 사람용
|
||
기능 설명 22장 — 목표·주간 회의록은 별도 장으로 진입·입력·지표 계산·쇼핑몰 연결·저장·삭제까지 설명한다.
|
||
도움말 검색은 실제 본문의 장·소제목으로 색인을 만들어 제목·본문을 한 글자부터 검색한다(띄어 쓴 단어는 모두 포함).
|
||
결과에 소제목·본문 일부와 일치 단어를 강조하고, 클릭 또는 Enter로 해당 소제목에 스크롤·포커스를 옮긴다.
|
||
`/`는 도움말 검색창, Esc·지우기는 초기화. 한글 조합 중에는 검색 이동을 하지 않는다.
|
||
검색어는 `?q=`, 읽는 위치는 `#소제목`으로 유지해 새로고침·공유·뒤로 가기에서도 복원한다. DB/API 호출 없이 동작한다.
|
||
검증: `python tests/js/render_help.py` 후 `node tests/js/help_ui.test.js`(jsdom),
|
||
`node tests/js/help.browser.test.js`(Playwright/Chromium — 실제 ERP 셸·390px 모바일·검색 이동·URL 복원).
|
||
**화면 기능을 바꾸면 도움말도 같이 고친다.**
|
||
**Project 옵션**(2026-10-02) — 도움말 오른쪽 톱니 버튼(`_options.html` 공통 include)이 native dialog를 연다.
|
||
현재 시스템 폰트(기본)·Pretendard Variable·NanumSquare·NanumSquareNeo·NanumSquareRound 중 선택하고 미리보기 → 저장 후 닫기.
|
||
`localStorage.pj_font`에 이 브라우저의 선택을 기억하며 모든 Project 화면에서 복원한다. 취소는 적용하지 않는다.
|
||
`project.css`의 `--pj-font`만 변경하므로 다른 ERP 화면은 영향을 받지 않으며 아이콘·코드 고정폭 폰트는 유지한다.
|
||
폰트는 `static/vendor/project-fonts/`에 원본·저작권/OFL을 함께 보관하고 `project-fonts.css`에서 선언한다(외부 CDN 없음).
|
||
저장 시 400/700 글꼴 로딩을 확인하고, 실패하면 이전 설정과 열린 창을 유지해 재시도할 수 있다.
|
||
2026-10-16 설정 창 개편 — 왼쪽 분류(일반·프로젝트 화면·보드·관리자) | 오른쪽 설정, 아래 [기본값으로]·취소·저장(한꺼번에 저장).
|
||
- **일반(폰트)** — 모두에게 보이고 **이 브라우저에만** 저장(`localStorage.pj_font`).
|
||
- **프로젝트 화면·보드** — 수퍼관리자·Admin(템플릿 `pj_admin` = `access.is_project_admin`)에게만 보이고, **서버에 저장해 모든 사용자에게 적용**
|
||
(`project_db.project_options`, 마이그레이션 029, 키 하나 = 행 하나, 값 JSONB). 키: `default_view`(왼쪽에서 프로젝트를 열 때 첫 탭
|
||
board/list/calendar/timeline/dashboard, 기본 board) · `board_cover`(보드 카드 표지 = 설명의 첫 이미지, 기본 켬).
|
||
허용 키·값·기본값은 `store.PROJECT_OPTION_DEFAULTS`·`normalize_project_options`(읽기 — 이상한 값은 기본값)·`validate_project_options`(쓰기 — 400) 한 곳.
|
||
API: `GET /project/api/options`(모듈 권한자 누구나, `can_edit`) · `PUT /project/api/options`(Admin 이상, 보낸 키만, 029 미적용 503).
|
||
프로젝트 화면(`/project/p/{id}`)은 서버가 `pj_options` → 루트 `data-default-view`·`data-board-cover` 로 넣고 `project.js` 가 쓴다
|
||
(읽기 실패·029 미적용이면 기본값 — 화면은 늘 열린다). 달력 월 이동 `?y=&m=` 은 마지막 뷰 `pj_view` 복원, `?scope=all` 은 대시보드, `?embed=1` 은 보드 그대로.
|
||
창은 열 때 서버 최신값을 읽고(못 읽으면 시스템 칸 잠금·폰트만 저장), 저장은 바뀐 키만 PUT → 성공해야 폰트도 적용(실패 시 창 유지·사유 표시).
|
||
저장하면 `pj-options-change` 이벤트로 보던 보드에 바로 반영, 다른 사용자는 다음에 화면을 열 때부터.
|
||
- **관리자(긴급 공지)** — 수퍼관리자만(`user.is_super_admin` — 공지 화면이 수퍼관리자 전용).
|
||
- 각 분류 제목 옆 배지로 적용 범위 표시(이 브라우저에만 / 모든 사용자에게). 새 옵션도 이 창의 분류·패널로 추가한다.
|
||
- 모달 대화창(`showModal`) 안의 말풍선은 공용 말풍선이 popover(top layer)로 띄운다(`initHoverTips` — 안 그러면 대화창 뒤에 가려짐).
|
||
테스트: `tests/test_project_options_api.py`, jsdom `project_ui.test.js`(렌더 `project_admin_render.html`·`project_super_render.html`).
|
||
**멤버 이름 표기** — 이메일 아이디의 첫 글자만 대문자(king → King). JS 는 `idOf(email)`/`capName(s)`,
|
||
템플릿은 `{{ nm[:1]|upper }}{{ nm[1:] }}` 로 화면에 그릴 때만 바꾼다(API `id`·DB 값은 그대로 — 멘션·검색은 이메일 기준).
|
||
**프로젝트 색상·아이콘(아사나식)** — 색상표는 32색(`store.COLOR_PALETTE`, 8칸×4줄 — 위 2줄은 아사나 프로젝트 16색, 아래 2줄은 같은 열의 진한 색. 진한 칸은 체크를 흰색 `.is-dark`. 새 프로젝트
|
||
기본은 파랑 `DEFAULT_PROJECT_COLOR`). 예전 팔레트 색으로 만든 프로젝트는 그 색 그대로(수정 팝업이 첫 칸으로
|
||
바꾸지 않는다). 아이콘은 아사나 프로젝트 아이콘과 같은 종류 42개를 Material Symbols 이름으로(`store.PROJECT_ICONS`
|
||
— 아사나의 실제 아이콘 이미지는 쓰지 않는다), `projects.icon`(마이그레이션 011, NULL = 색 + 첫 글자).
|
||
새 프로젝트·프로젝트 수정 팝업의 "아이콘" 격자(`renderIconPalette`, 첫 칸 "Aa" = 아이콘 없음), 사이드바 배지·
|
||
제목 알약에 흰 아이콘(`projBadgeInner`). 아이콘은 고르거나 바꿨을 때만 서버로 보내므로 011 전에도 다른 수정은 된다.
|
||
**색상표는 모든 편집창이 이 하나** — 섹션 편집도 같은 32색(`STAGE_COLOR_PALETTE = COLOR_PALETTE`). 섹션에서 첫 칸(연회색)은
|
||
"색 없음"(NULL, 기본 회색 머리), 예전 10색으로 칠한 섹션은 그대로(`LEGACY_STAGE_COLORS`). 밝은 색(연노랑·하늘·연분홍 등)
|
||
위에서는 글자·아이콘을 어둡게(`isLightColor` → `.is-light`: 섹션 머리·사이드바 배지·제목 알약).
|
||
|
||
## 1. 개요
|
||
|
||
| 항목 | 값 |
|
||
| --- | --- |
|
||
| URL prefix | `/project` |
|
||
| DB | `project_db` (PostgreSQL, 역할 `project_app` CRUD only) |
|
||
| 연결 env | `PROJECT_DB_URL` (미설정 시 "설정 필요" 안내, 앱은 죽지 않음) |
|
||
| 진입 권한 | 권한키 `project` (관리자 페이지 토글로 직원별 부여, admin 자동) |
|
||
| 멤버 배정 후보 | `project` 권한 보유 등록 사용자 자동 목록 (`GET /project/api/assignable-users`) |
|
||
| 생성 권한 | **새 최상위 프로젝트는 Pro user 이상(2026-10-12, 6-14). 섹션·작업·서브프로젝트는 그 프로젝트 멤버 누구나.** 프로젝트를 만든 사람은 자동으로 owner 가 되어 그 프로젝트를 관리(`_can_manage`)할 수 있다. 다른 사람을 owner 로 지정해 만드는 것도 Pro user 이상 |
|
||
| 소유자 변경 | **Pro user 이상**(2026-10-12, 예전 관리자만 2026-09-30). owner 는 멤버에서 빠져도 관리 권한이 남으므로, 일반 멤버가 스스로를 owner 로 바꿔 권한 회수를 피할 수 없게 `PUT /api/projects/{id}` 의 `owner_email` 변경은 비관리자 403(같은 값은 무시). 새 owner 는 `project` 권한이 있는 등록 사용자여야 한다(아니면 400) |
|
||
| 수정/이동 권한 | 서브프로젝트·작업·섹션 CRUD(이름변경·완료토글·순서변경 등) = 그 프로젝트의 배정 멤버 또는 owner 또는 슈퍼관리자(`_require_manage`). 작업 API 는 `_require_task(write=True)` = 원 소속 프로젝트 권한(FULL) |
|
||
| 조회 권한 | 프로젝트 화면(`/p/{id}`)·멤버/섹션/작업/활동/스냅샷 API 도 멤버·owner 만(`_require_manage`). 비멤버는 403. **관리자(is_admin)도 멤버가 아니면 못 본다 — 예외는 슈퍼관리자(`app.store.SUPER_ADMIN_EMAIL`) 한 명**(2026-10-07, `access.sees_all_projects`·`visible_project_ids`). 왼쪽 사이드바 프로젝트 목록·`GET /api/projects`·검색·수신함·알림·마감 알림·휴지통(목록·복구)도 같은 기준. 멤버 배정은 여전히 관리자만이라, 관리자는 자기가 멤버인 프로젝트에서만 배정할 수 있다(직원이 만든 프로젝트는 슈퍼관리자가 배정). `GET /api/users/tasks` 를 프로젝트 없이 부르면 내가 볼 수 있는 프로젝트의 작업만 돌려준다. 연결된(멀티호밍) 작업은 연결된 프로젝트 멤버에게 **읽기 전용**(6-10) |
|
||
| 지금 권한 기준 | 모든 판단은 **지금** 권한(`app/modules/project/access.py`) — 멤버에서 빠진 사람은 예전 담당자·멘션·협업자 기록이 있어도 내 작업·수신함·알림·검색·상세·공유 링크·댓글·첨부에서 그 작업이 보이지 않고, 새 알림·메일도 받지 않는다(기록은 이력으로 남김) |
|
||
| 입력 검증 | URL 의 섹션이 URL 의 프로젝트 것인지(`_stage_of_project`), 작업 생성/수정·연결 시 섹션이 그 프로젝트 것인지(`stage_in_project`), 하위 작업의 부모가 같은 프로젝트인지 확인 — 권한은 URL 의 project_id 로 보므로 이걸 안 보면 남의 프로젝트를 건드릴 수 있다. 새 담당자는 그 프로젝트를 볼 수 있는 사람만(400). 날짜 범위(시작 ≤ 마감, 같은 날이면 시작 시각 ≤ 마감 시각)는 부분 수정도 기존 값과 합친 최종 상태로 검사(400) |
|
||
| 삭제 권한 | **프로젝트·섹션은 Admin 이상이면 누구 것이든, 그 밖은 "만든 사람만"**(생성자 정보 없는 과거 데이터는 Admin 이상) — `_can_delete`. **작업은 멤버 누구나**(2026-10-12). **그리고 지금 그 프로젝트 권한이 있어야 한다**(멤버에서 빠진 생성자는 403, DB·휴지통 변화 없음) |
|
||
| 멤버 배정 | Pro user 이상, 자기가 멤버인 프로젝트만(2026-10-12). User 가 "새 프로젝트" 모달을 열면 멤버 선택란은 안내 문구만 뜨고 시도하지 않는다(불필요한 403 방지) |
|
||
| 메일 알림 | `app/mail.py` (stdlib smtplib). 작업 배정/완료 시 관리자에게 발송 |
|
||
|
||
## 1-1. 프로젝트 → 섹션 → 작업 (하위 작업 포함) 3단계 구조
|
||
|
||
**화면 조정(2026-10-03)** — 본문 좌우 여백 8px. 공용 왼쪽 메뉴 오른쪽 경계를 드래그해
|
||
170~500px로 조절(방향키도 지원, 더블클릭 기본값), `localStorage.pj_side_w`에 기억한다.
|
||
드래그 중에는 최신 마우스 위치를 화면 프레임당 한 번 반영하고, 목표 표 글 높이 등 전체 화면 재계산은
|
||
놓는 순간에 한 번만 실행한다. 창 포커스를 잃을 때도 마지막 위치를 저장하고 드래그를 종료한다.
|
||
수신함·내 작업 배지는 메뉴 이름 바로 옆에 표시. 댓글·답글 입력칸은 70px 고정 높이, 긴 글은 내부 스크롤.
|
||
전체 멤버는 메뉴 내부 폭 207px 이하에서는 3열, 그보다 넓으면 4열로 자동 재배치한다(container query).
|
||
각 멤버 칸은 최소 너비를 강제하지 않고 스크롤바용 여백 안에 맞추므로 오른쪽 멤버가 가려지지 않는다.
|
||
보드 그룹 머리의 왼쪽 화살표+세로선 아이콘은 그룹 축소, 축소 후 반대 방향 아이콘으로 펼치기.
|
||
축소 시 카드·추가 버튼을 숨기고 섹션 제목·작업 수를 세로로 표시하며
|
||
`localStorage['pj_board_fold:'+projectId]`에 섹션 id(전체 프로젝트 보기에서는 이름)별로 기억한다.
|
||
이 설정은 화면 표시만 바꾸므로 읽기 전용 사용자도 조절 가능하며 서버 작업·섹션 데이터는 변경하지 않는다.
|
||
목표 표 열 너비는 모든 행의 셀 오른쪽 경계에서 조절(병합 셀은 오른쪽 끝 열), 새 줄·병합·합계 재계산 뒤에도 유지.
|
||
경계를 더블클릭하면 그 열의 가장 긴 문단에 자동으로 맞춘다. 직접 넣은 줄바꿈은 유지하고 글꼴·크기·굵기·여백을
|
||
반영하며, 병합 칸은 다른 열 너비를 유지한 채 선택한 열만 맞춘다. 긴 문단은 드래그 최대 너비(600px)를 넘어도
|
||
맞추고 브라우저에 기억한다(이름 열도 자동 맞춤 가능). 현재 편집 중인 글·숫자도 내용 변경 없이 측정한다.
|
||
목표 업무 행 높이는 가장 높은 글 칸의 자연 높이에 맞춘다. 글·이름 칸 모두 위·아래 6px 여백을 사용한다.
|
||
1열(업무 영역)·2열(항목 이름)은 병합 여부와 행 높이에 관계없이 항상 세로 가운데 정렬하고, 목표 글 칸은 상단 정렬한다.
|
||
글이 짧아지면 행도 줄어든다. 글이 한 줄이거나 비어 있으면 한 줄 높이만 확보하고 보기 전용도 같은 규칙이다.
|
||
목표 글자를 선택하면 해당 셀 상단 중앙을 기준으로 셀 위에 서식 도구가 표시되며, 색상은 지정된 12색 견본으로만 선택한다.
|
||
기존 글의 다른 색상은 보존. 글자 선택 해제·외부 클릭·편집 셀 제거 시 도구를 닫고 기존 부분 서식·자동 저장을 재사용한다.
|
||
|
||
**"섹션"은 새 개념이 아니라 기존 "단계"(칸반 컬럼)를 그대로 재사용한다** —
|
||
아사나도 보드 뷰의 컬럼과 목록 뷰의 구분선이 같은 "섹션" 하나다. DB
|
||
컬럼/테이블 이름(`project_stages`, `stage_id`)은 그대로 두고, 사용자에게
|
||
보이는 문구만 "섹션"으로 바꿨다.
|
||
|
||
- **섹션 관리** — 프로젝트 화면(`/project/p/{id}`)에서 "이 프로젝트" 스코프로
|
||
볼 때만 보드 컬럼에 관리 UI가 붙는다(이름변경·완료토글·삭제·"+ 섹션 추가" — 아사나처럼
|
||
마지막 섹션 바로 오른쪽, `renderBoard` 가 매번 캔버스 끝에 붙인다).
|
||
컬럼 헤더를 **드래그해서 순서를 바꿀 수 있다**(카드 드래그와 같은 네이티브
|
||
HTML5 DnD, `PUT /api/projects/{id}/stages/order` 재사용). "전체 프로젝트"
|
||
스코프(여러 프로젝트를 섹션 '이름'으로 합쳐 보는 예전 방식)에서는 섹션을
|
||
하나로 특정할 수 없어 관리 UI가 없다.
|
||
- **보드 빠른 작업 추가**(2026-10-02) — 하단 `+ 작업 추가`·섹션 메뉴에서
|
||
상세창 대신 보드 안에 이름·담당자·마감일 입력 카드가 열린다. Enter는 저장 후 연속 입력,
|
||
카드 밖 클릭은 저장 후 닫기, Esc·빈 카드 밖 클릭은 취소. 섹션 기본 담당자를 적용하고,
|
||
저장 실패 시 입력을 유지하며 저장 중 반복 제출을 막는다. 기존 작업 생성 API를 재사용한다.
|
||
**섹션 머리 `+`는 기존 오른쪽 작업 상세창**(`openTaskModal`)을 열어 제목·설명·담당자·우선순위·마감일을 설정한다.
|
||
- **하위 작업(subtask)** — 새 테이블이 아니라 `tasks.parent_task_id` 재사용
|
||
(부모 삭제 시 CASCADE). 작업 편집 팝업 안에 인라인으로 표시되며(체크박스+
|
||
제목+담당자+마감일, 한 줄에서 바로 저장), 보드/캘린더/목록에는 최상위
|
||
작업만 카드로 뜬다(하위 작업은 부모 카드의 "N ⤷ ▾" 토글로 — 누르면 아사나처럼 카드 아래로
|
||
하위 작업 목록(완료 체크·제목·마감·담당자)이 펼쳐진다. 펼친 상태는 페이지에 머무는 동안 유지).
|
||
섹션을 갖지 않는다(칸반에 안 보이므로).
|
||
펼친 하위 작업 한 줄을 같은 카드 안에서 위아래로 드래그하면 순서가 저장된다
|
||
(`PUT /api/tasks/{parent_id}/subtasks/order` `{ordered_ids}` — 작업 팝업과 같은 API).
|
||
보라색 선으로 삽입 위치를 표시하며 실패 시 기존 순서를 유지한다.
|
||
다른 카드로 드래그하면 그 작업의 하위 작업으로 옮겨진다
|
||
(`POST /api/tasks/{id}/move-parent` `{parent_task_id}` → `db.move_subtask`, 활동 `subtask_moved`).
|
||
받는 쪽은 **같은 프로젝트의 최상위 작업만**(순환 방지), 하위 작업의 하위 작업은 함께 따라간다.
|
||
**카드 크기·표지**(2026-10-02): 카드 높이 100px 고정(`.pj-card-head` height 86px = 100 − 아래 여백 12 − 테두리 2, 제목 2줄·
|
||
프로젝트 배지가 있으면 1줄까지, 담당자·날짜 줄은 맨 아래), 담당자 13.2px·아바타 20px·날짜 12.1px(기존 +10%).
|
||
**카드 완료 표시**: 제목 왼쪽 원형 체크 버튼(`.pj-card-check`, role=checkbox·aria-checked).
|
||
완료된 카드는 녹색 원 안 흰 체크 + 회색 제목으로 표시하며 취소선은 없다. 클릭하면 기존 작업 PUT `{completed}`로 완료/취소.
|
||
저장 중 중복 클릭을 막고 응답 후 카드·내 작업 개수를 갱신한다. 실패하면 상태를 유지해 재시도할 수 있다.
|
||
읽기 전용 작업은 비활성 체크로 상태만 표시하며 카드 높이·표지·하위 작업 펼침과 드래그 구조는 유지한다.
|
||
설명에 이미지가 있으면 **첫 이미지를 카드 위 표지**로(아사나, `cardCoverSrc` — template 로 읽어 이미지를 불러오지 않음,
|
||
우리 첨부·http(s)·data:image 만, 높이 140px object-fit cover). 표지·펼친 하위 작업은 100px 위·아래에 더해진다.
|
||
**하위 작업이 없는 카드**도 같은 모양의 빈 토글(⤷ ▾, `.pj-card-subtoggle.is-empty` — 카드에 마우스를 올리면 보임, 편집 권한자만)이
|
||
있어 누르면 카드 아래가 펼쳐지며 곧바로 새 하위 작업 이름 입력 줄이 열린다(빈 목록엔 "하위 작업 없음" 대신 추가 줄).
|
||
펼친 하위 작업 목록 맨 아래 **"+ 하위 작업 추가"**(아사나, `renderSubAdd`) — 누르면 그 자리에 새 줄
|
||
(✓ · "작업 이름 입력" · 점선 달력 · 점선 사람)이 열려 Enter 로 바로 만들고, 줄은 열린 채 다음 입력으로.
|
||
이름을 쓴 채 다른 곳을 누르면 Enter 와 같이 만들고 줄은 닫힘(`onOutsideDown` — 문서 pointerdown, 한글 조합 중인
|
||
마지막 글자까지 반영하려고 한 박자 뒤 입력칸 값을 읽는다). Esc 또는 빈 채로 다른 곳을 누르면 닫힘. 보드가 8초마다 다시 그려져도 입력 중인 값·포커스는
|
||
`subDrafts` 에서 되살린다.
|
||
**하위 작업도 작업과 같은 팝업에서 똑같이 편집**(아사나식) — 보드 카드의 하위 작업 줄 클릭·우클릭 "열기",
|
||
작업 팝업 하위 작업 줄의 › 버튼, 공유 링크로 연다(`openTaskById`). 제목 위에 상위 작업 경로
|
||
(`#pj-t-parent`, 누르면 상위 작업으로 — `GET /api/tasks/{id}` 가 `parent_title` 을 준다),
|
||
섹션 칸·다른 프로젝트 연결은 숨긴다. 저장해도 보드 목록(`tasks`)엔 넣지 않는다(`mergeTask`).
|
||
작업 팝업의 하위 작업 줄(`initSubtaskBlock`)도 아사나식 — ⠿ 손잡이로 끌어 순서 변경
|
||
(`PUT /api/tasks/{id}/subtasks/order` → `db.reorder_subtasks`), ✓ 완료, 제목 칸은 글자 폭만큼
|
||
(`fitTitle`)이고 줄의 빈 곳을 누르면 하위 작업 열기, 마감일은 날짜 글자만(없으면 점선 달력
|
||
아이콘, 누르면 아사나식 날짜 팝업 `openDatePopover`), 담당자는 아이콘만(누르면 아이콘+이름 메뉴).
|
||
삭제는 우클릭 메뉴(줄에 × 없음). 그 하위 작업에도 하위 작업이 있으면 제목 옆에 "N ⤷"
|
||
아이콘(`nestedSubsHtml`, `list_tasks` 의 `subtask_total`), 댓글이 있으면 "N 말풍선", 설명이 있으면
|
||
줄글 아이콘(`subMetaHtml` — `comment_count`, `description` 을 `hasDescription` 으로 판정: 태그·공백뿐이면
|
||
없음, 이미지만 있어도 있음) — 보드 카드 펼친 목록도 같다. 보드의 최상위 작업 카드도 설명이 있으면
|
||
댓글 배지 옆에 같은 줄글 아이콘(`.pj-card-desc`).
|
||
하위 작업을 펼친 카드는 윗부분(`.pj-card-head` — 배지·제목·담당자/마감일/하위 작업 토글 줄)이
|
||
`position: sticky` 라 컬럼을 스크롤해도 카드가 끝날 때까지 컬럼 맨 위에 고정된다.
|
||
- **마감일 말풍선** — 지난 마감일(빨강, `dueInfo().cls === "is-overdue"`)은 "마감일 지남", 그 밖엔 "마감일 변경"
|
||
(`dueTip`). 보드 카드·카드 하위 작업 줄·작업 팝업 하위 작업 줄 공용.
|
||
- **날짜 팝업 닫힘** — 마감일을 고르면(달력 날짜·"오늘"·직접 입력) 저장하고 바로 닫힌다. 시작일 칸이 활성일 때
|
||
고른 날짜는 시작일로 넣고 마감일을 이어서 고르도록 열어 둔다.
|
||
- **날짜 팝업 색** — 일요일·공휴일(국경일·대체공휴일, `store.KR_HOLIDAYS`) 빨강, 토요일 파랑, 공휴일 이름은 말풍선.
|
||
공휴일 날짜는 숫자 밑에 이름(좁아서 "OO 대체"→"대체휴일", `HOLIDAY_SHORT`), 그 주만 줄이 높아진다.
|
||
공휴일 표는 `main.py` Jinja 전역 `pj_kr_holidays` → 공용 사이드바 `_side.html` 이 `window.PJ_HOLIDAYS` 로 넘긴다
|
||
(새 연도는 `KR_HOLIDAYS` 에만 추가하면 캘린더·타임라인·날짜 팝업 모두 반영).
|
||
- **날짜 고르기는 전부 아사나식 날짜 팝업(`openDatePopover`)** — 브라우저 기본 달력(`input[type=date]`)을
|
||
화면에 두지 않는다. 보드 카드·작업 팝업·하위 작업 줄은 직접 팝업을 열고, 폼의 날짜 칸(새 프로젝트 마감일,
|
||
프로젝트 수정 시작일·마감일(버튼 하나), 하위 작업 추가 마감일)은 `enhanceDateInput` 이 숨긴 input 옆에
|
||
날짜 버튼을 붙인다(input 은 값 저장소 — `.value` 읽기/쓰기·change 이벤트 그대로). 새 날짜 칸도 이 함수를 쓴다.
|
||
- **멀티호밍(다른 프로젝트에 연결)** — `task_project_links` 테이블. 작업 하나가
|
||
원래 소속(기본 홈, `tasks.project_id`/`stage_id`)과 무관하게 다른 프로젝트의
|
||
한 섹션에도 동시에 나타날 수 있다(아사나의 "Add to project"). 작업 편집
|
||
팝업의 "연결된 프로젝트" 칩에서 추가/해제한다. 새 연결을 만들 때는 원
|
||
프로젝트·대상 프로젝트 양쪽 관리 권한이 필요하지만(무단으로 남의 작업을
|
||
끌어와 노출시키는 것 방지), **이미 연결된 작업을 그 프로젝트 보드 안에서
|
||
다른 섹션으로 드래그하는 것은 대상 프로젝트 권한만 있으면 된다.**
|
||
`list_tasks(project_id=X)`(비재귀 단일 프로젝트 조회, 프로젝트 화면이 쓰는
|
||
바로 그 경로)가 자동으로 연결된 작업까지 포함해서 돌려준다 — 다른 호출
|
||
경로(홈/내 작업 등 `project_id` 없이 부르는 전체보기)는 원 소속만 세어
|
||
중복 노출을 막는다.
|
||
- **프로젝트 화면 머리** — 아사나처럼 왼쪽 위 두 줄: ① 프로젝트 색 네모 아이콘(아이콘 없으면
|
||
`folder`)+제목(클릭해 이름 수정)+멤버 아바타, ② 뷰 탭(보드/목록/캘린더/타임라인/대시보드).
|
||
위쪽 바의 "+ 작업 추가" 버튼은 없앴다(섹션의 + / "+ 작업 추가"로 만든다).
|
||
- **사이드바 프로젝트 스코프** — 프로젝트 화면 툴바 오른쪽에 "이 프로젝트"/"전체
|
||
프로젝트" 토글이 있다. "전체 프로젝트"면 제목이 "전체 프로젝트"로 바뀌고 멤버는
|
||
숨긴다(`#pj-title-wrap.is-all-scope`). 기본은 "이 프로젝트"(아사나처럼 지금 선택한
|
||
프로젝트의 섹션만 보드/캘린더/타임라인/목록에 나온다), "전체 프로젝트"는
|
||
예전처럼 접근 가능한 모든 프로젝트를 합쳐서 보여준다. 서버가 `tasks` 배열의
|
||
각 행에 `context_project_id`(어느 프로젝트를 보다가 담겼는지)를 표시해두고,
|
||
클라이언트가 이 값으로 스코프를 걸러낸다(순수 프론트 필터 — 서버 재조회 없음).
|
||
- **작업 설명 이미지 삽입** — 설명란이 `contenteditable` 로 바뀌어 이미지를
|
||
붙여넣거나 파일로 올릴 수 있다. 새 첨부 endpoint 없이 기존
|
||
`task_attachments` 업로드를 재사용하고, 표시는 `GET
|
||
/api/attachments/{id}/inline`(다운로드용 `/download` 는 `Content-Disposition:
|
||
attachment` 가 걸려 `<img>` 로 못 씀 — 그래서 인라인 전용 endpoint를 따로
|
||
뒀다)로 한다. 저장 전 서버가 `store.sanitize_description_html()` 로 허용
|
||
태그만 남기고 스크립트/이벤트속성/위험 URL 스킴을 제거한다(표준
|
||
`html.parser`, 외부 라이브러리 없음). 새 작업 작성 중(저장 전, task_id 없음)
|
||
에는 이미지 삽입이 비활성화된다 — 첨부가 작업 id 를 필요로 하기 때문.
|
||
|
||
## 2. 데이터 모델 (`scripts/sql/project_db_init.sql` + `..._002_*` ~ `..._006_*`)
|
||
|
||
- `projects` — `parent_id`(self-FK, NULL=최상위 / NOT NULL=서브프로젝트, `ON DELETE CASCADE`), name, description, color, owner_email, start/due_date, status(active|archived).
|
||
- `project_members` — 프로젝트↔사용자 배정. `UNIQUE(project_id, user_email)`. role 열(manager|member)은 남아 있지만
|
||
2026-10-07 부터 화면·권한에서 쓰지 않는다 — 배정 창의 역할 선택을 없앴고 새 배정은 늘 member, 배정된 멤버는 모두 보기·수정.
|
||
- `project_stages`(="섹션") — 진행단계(칸반 컬럼). **프로젝트 생성 시 자동으로
|
||
만들지 않는다**(아사나처럼 직접 "+ 섹션 추가"로 만든다 — `create_project`
|
||
의 `seed_stages` 기본값은 `False`). `is_done_stage`=TRUE 단계로 옮기면 작업
|
||
완료 처리. `created_by`(003) — 삭제를 "만든 사람만"으로 제한하기 위함.
|
||
`color`(004, nullable) — 섹션 생성/편집 팝업에서 아사나 10색 팔레트
|
||
(`store.STAGE_COLOR_PALETTE`) 중 선택, 보드 컬럼 헤더에 표시.
|
||
- `tasks` — 작업. stage_id, title, description(HTML — 이미지 삽입 지원), assignee_email/name, priority(low|normal|high), start/due_date, completed_at, `parent_task_id`(003, self-FK `ON DELETE CASCADE`, NULL=최상위 작업).
|
||
- `task_project_links`(003) — 멀티호밍. `(task_id, project_id)` UNIQUE, `stage_id` nullable(그 프로젝트 안에서의 섹션).
|
||
- `task_comments` — 댓글.
|
||
- `task_attachments` — 첨부(설명란 이미지도 이걸 재사용).
|
||
- `project_activity` — 활동 이력(created/assigned/completed/stage_changed). 메일 트리거 근거 + 타임라인.
|
||
- `task_mentions`(006) — @태그. `(task_id, COALESCE(comment_id,0), mentioned_email)` UNIQUE,
|
||
`source`=description|comment, `is_read`. 수신함의 "나를 태그한 작업" 목록 근거.
|
||
|
||
## 3. 화면 / 뷰
|
||
|
||
> **확인/알림/입력 창 규칙** — 프로젝트 관리 화면의 팝업 창 제목은 전부 **"KSN 프로그램"**
|
||
> (`project.js` 가 `window.ERP_DIALOG_TITLE` 로 지정, 공용 `erp-dialog.js`). `project.js` 안의
|
||
> `alert/confirm/prompt` 는 공용 창으로 가려져 있고 `confirm/prompt` 는 Promise 라 반드시 `await`.
|
||
> 브라우저 기본 `window.confirm` 등을 새로 쓰지 않는다.
|
||
|
||
> **말풍선(툴팁) 규칙 — 모든 화면·앞으로 추가하는 기능 공통.** 말풍선은 아사나식 공용 말풍선
|
||
> 하나(`.pj-hovertip`, `initHoverTips`)만 쓴다: 어두운 배경 + 아래 꼬리, 커서 바로 위, 화면 끝이면
|
||
> 안쪽으로 밀리고 위가 모자라면 아래로 뒤집힘. 요소에 `data-tip="문구"` 또는 `title="문구"` 만 달면
|
||
> 된다(`title` 은 마우스를 올리는 순간 `data-tip` 으로 옮겨져 브라우저 기본 말풍선이 안 뜬다).
|
||
> 별도 툴팁 구현 금지 — 부득이하면(대시보드 막대처럼 요소에 붙는 것) 같은 색·꼬리 모양으로.
|
||
>
|
||
> **댓글 말풍선(💬 N) 규칙** — 보드 카드·목록 행·캘린더 막대·내 작업 어디서든 **한 번 클릭**으로 댓글
|
||
> 대화창(`#pj-modal-comments`, `initCommentsChat`)이 열린다. `.pj-cmt-badge[data-task-id]` 만 달면
|
||
> 문서 캡처 단계 클릭 처리가 카드/행 클릭(작업 열기)보다 먼저 받아 막으므로 따로 연결할 필요 없다
|
||
> (`wireBadge` 는 안 읽음 표시만). 댓글 본문의 웹페이지 주소(`https://…`, `www.…`)는 작업 팝업 댓글·
|
||
> 대화창 모두 `linkifyToHtml` 로 새 탭 링크가 된다(나머지 글자는 이스케이프). 대화창 입력칸 붙여넣기는
|
||
> 글자가 있으면 글자 우선, 그림만 있을 때 첨부.
|
||
>
|
||
> **담당자 고르기 규칙 — 모든 화면·앞으로 추가하는 기능 공통.** 담당자를 고르는 곳은 항상 "아이콘 + 이름".
|
||
> 팝업 메뉴는 `assigneeMenuItems(emails, cur, onPick)` + `showContextMenu`(항목 `icon`/`checked` 지원), 폼의
|
||
> `<select>` 는 `enhanceAssigneeSelect(sel)` 로 감싼다(select 는 숨겨 값 저장소로 유지). 미지정 = 점선 원 사람 아이콘.
|
||
>
|
||
> **날짜 규칙.** 마감일(시작일) 고르기는 아사나식 팝업 `openDatePopover(anchor, {start, due, allowStart, onChange})`
|
||
> 하나만(브라우저 기본 date 캘린더 금지). 마감일 표기는 `dueInfo(iso, done)` — 어제(빨강)·오늘/내일(초록)·그 밖 mm/dd(요일),
|
||
> 지난 날짜 빨강, 완료 작업은 색 없음.
|
||
|
||
- **내 작업** (`/project/`): 프로젝트 모듈의 첫 화면. 예전 홈(프로젝트 카드 그리드)은
|
||
**없앴다** — 좌측 "내 작업" 메뉴와 같은 화면이다(`project/mytasks.html`).
|
||
내가 담당자인 작업을 한 표에 모아 보여준다: 완료 체크박스 · 작업 · 프로젝트 · 섹션 ·
|
||
우선순위 · 시작 · 마감. 헤더 클릭으로 정렬, 상단 탭으로 진행 중/완료/전체 필터,
|
||
오른쪽에 진행/완료/지연 요약. 체크박스는 그 자리에서 완료 토글, 행을 누르면 그
|
||
프로젝트로 이동하며 작업 편집 팝업이 열리고(`?task=`), 우클릭은 열기/완료/삭제 메뉴.
|
||
완료된 작업 행은 반투명 + 취소선. 8초 주기로 목록을 다시 받는다.
|
||
표/목록 화면이라 본문 폭은 1180px 로 제한한다(보드·캘린더 등 프로젝트 뷰는 전체 폭).
|
||
좌측 사이드바는 프로젝트·수신함 화면과 공용(`project/_side.html`, `side_active` 로
|
||
활성 메뉴 표시) — 수신함 · 내 작업 ·
|
||
프로젝트 트리(+ 새 프로젝트) · "전체 멤버". 프로젝트 트리는 **수신함·내 작업·휴지통·프로젝트
|
||
네 화면 모두 같다** — Pro user 이상에게 드래그 순서 변경(⣿)·✎ 수정·× 삭제·우클릭 메뉴(공용
|
||
`initSideTree`, 모달은 `project/_side_modals.html` 을 각 화면이 include). "전체 멤버"는 **Pro user 이상(`pj_pro`)에게만**
|
||
그리고 수신함·내 작업·프로젝트 화면 모두에서 나온다. 아이콘 클릭 = 그 사람의 담당 작업
|
||
팝업(`_member_tasks_modal.html`, `initMemberTasks`) — 프로젝트 화면에선 더블클릭 시 그 자리에서
|
||
편집 팝업, 다른 화면에선 그 작업의 프로젝트 화면(`?task=`)으로 이동.
|
||
- **프로젝트** (`/project/p/{id}`): 좌측 사이드바(공용 `_side.html`) + 우측 뷰 토글.
|
||
좌측 "내 작업"는 접이식 패널이 아니라 `/project/` 로 가는 링크다.
|
||
**이 프로젝트의 멤버는 화면 위 제목 오른쪽**에 겹친 아바타로 둔다(`.pj-title-members`) —
|
||
마우스를 올리면 이름(`data-tip`, `initHoverTips` 가 위임 방식이라 동적 요소에도 붙는다),
|
||
클릭하면 그 사람이 이 프로젝트에서 맡은 작업 팝업, 우클릭(Pro user 이상)하면 제외, 옆 `+` 는 **멤버 배정·제외 창**(2026-10-07 —
|
||
후보 전원 + 지금 멤버는 체크된 채, 체크 = 배정 `POST …/members`, 해제 = 제외 `DELETE …/members/{email}`(확인 뒤), 소유자는 잠금.
|
||
두 API 모두 Pro user 이상 + 그 프로젝트 관리 권한(`_require_manage`)).
|
||
좌측 트리의 작업 클릭도 페이지 이동 없이 바로 팝업(이미 로드된 전체 작업 데이터 사용).
|
||
좌측 맨 위 **수신함**(미확인 @태그 배지)과 **내 작업**(접이식, 기본 접힘 — 작업을 고르면
|
||
팝업이 열리며 다시 접힌다)가 있다. 예전 화면 오른쪽에 항상 떠 있던 "내 작업" 패널은 없앴고
|
||
이 메뉴가 그 역할을 대신한다(레이아웃도 3열 → 2열).
|
||
- **캘린더** — FullCalendar. 작업을 시작~마감 기간으로 표시. 클릭 편집.
|
||
- **타임라인** — vis-timeline(간트형). 기간 있는 작업만. 카드의 하위 작업은 개수(`N ⤷`, 말풍선 "하위 작업 N개")만
|
||
— 펼치기 버튼은 없앴다(`tlToggleSubs`·하위 작업 카드 코드는 남아 있지만 여는 곳이 없다). 설명이 있으면 `.pj-tli-desc`. 카드는 선택 없이 바로 끌어 날짜 이동
|
||
(`itemsAlwaysDraggable`, 펼친 하위 작업 카드 포함) — `onMove` 는 끈 거리를 **일 단위로 반올림해 원래
|
||
날짜에 더한다**(시각 유지). 끄는 동안도 `snap` 옵션으로 가장 가까운 날 0시에 붙여 칸 단위로만 움직인다
|
||
(vis 기본 스냅은 반나절 단위라 칸 가운데에 걸렸다). 카드의
|
||
**작업 이름(`.pj-tli-name`)을 누르면 오른쪽 작업 창**(`timeline.on("click")`, 누른 뒤 5px 넘게
|
||
움직였으면 끌기로 보고 무시 — 끌고 놓으면 브라우저가 click 을 보낸다). 선택된 막대 위 vis 의
|
||
`.vis-drag-center` 층은 `pointer-events:none`(이름 클릭이 닿게). 처음 보기 범위는 **하루 칸 = 날짜
|
||
글자("30일 (수)") 폭**(그려서 재고, `maxMinorChars` 도 그 폭에 맞춤 — 안 그러면 이틀 간격 라벨로
|
||
바뀜). 사용자가 옮긴 구간은 localStorage `pj_tl_window2`. **축소 한계** — 칸 폭을 잴 때마다 `zoomMax` 를
|
||
"하루 = 날짜 글자 폭"이 되는 구간 길이로 두어 Ctrl+휠로 그보다 줄여지지 않는다(더 줄이면 vis 가 이틀 간격
|
||
라벨로 바꿔 날짜가 빠진다). 저장된 구간이 한계보다 넓으면 줄인다.
|
||
**첫 표시 주의** — vis 는 생성 옵션에 start/end 가 있으면 첫 `rangechanged` 가 끝난 뒤의 `changed` 에서야
|
||
루트를 `visibility:visible` 로 바꾼다. 우리가 `changed` 안에서 `setWindow` 하면 그 `rangechanged` 는 비동기로
|
||
늦게 오고 vis 는 첫 그리기 전이라 다시 그리지 않아 **타임라인이 통째로 안 보인다** → `rangechanged` 에서
|
||
아직 숨어 있으면 `redraw()`. (`changed` 안에서 바로 `redraw()` 는 vis 의 프레임당 1회 제한에 걸려 무시됨)
|
||
**날짜 라벨 색·휴일 이름** — vis 는 라벨을 xss 필터(태그만, class 불가)를 거쳐 innerHTML 로 넣으므로 색은
|
||
태그로 싣는다: 빨강(일요일·공휴일) `<em>`, 파랑(토요일) `<i>`, 공휴일 이름 `<br><abbr title=전체이름>줄인이름`
|
||
(캘린더 날짜 팝업과 같은 `HOLIDAY_SHORT`·"대체휴일" 규칙). 예전의 "그린 뒤 class 달기(paintTLDays)"는
|
||
vis 가 라벨 요소를 재사용하며 옮길 때 다른 날짜에 색이 남아 폐기. 날짜 줄은 늘 두 줄 높이(CSS `height` —
|
||
vis 가 측정용 라벨 `.vis-measure` 로 재서 년·월 줄을 내린다).
|
||
**화면 배율(`html.pj-ui-scale`)** — vis 는 크기를 `getBoundingClientRect`(zoom 적용)와
|
||
`offsetHeight`(미적용)로 섞어 재서 zoom 안에서는 하단 년·월 축이 잘리고 끌기가 마우스의 0.75배만
|
||
움직인다. 그래서 `#pj-timeline` 에서 zoom 을 `1/--pj-z` 로 되돌려 실제 배율 1로 그리고, 타임라인
|
||
CSS 의 크기는 전부 `calc(Npx * var(--tz))`(배율 모드 `--tz: .75`), vis 옵션 높이·간격도
|
||
`uiZoom()` 을 곱한다. 배율을 토글하면(resize) 다시 그린다. **타임라인 CSS 에 px 크기를 새로 넣을
|
||
때도 `var(--tz)` 를 곱한다.**
|
||
- **대시보드** — 합계 타일 4개 + 미완료 작업(섹션별)·작업 합계(완료 상태별) 차트. **"담당자별 작업 합계(메인·하위
|
||
작업, 완료)" 표는 Pro user 이상에게만** 보인다(사람별 업무량이 드러나서, 세부 작업 API `subtasks-summary` 도 Pro user 이상) —
|
||
작업 데이터 자체는 멤버가 원래 볼 수 있는 범위 그대로다. (2026-10-07, 예전 "예정된 작업 합계(담당자별)" 막대 대신)
|
||
그 범위(이 프로젝트 = 여기 연결된 작업 포함 / 전체 프로젝트)에서 사람별로 배정된 작업 **전부**(마감일·필터와 무관) —
|
||
메인 작업(`scopeTasks()` 최상위, 중복 없이)과 하위 작업(화면 목록엔 없어 `GET /api/projects/{id}/subtasks-summary?scope=`
|
||
— `db.list_subtasks_of`, 그 범위 메인 작업의 하위만, 하위 작업 자신의 담당자 기준)을 나눠 세고, 메인·하위·전체 완료 수와
|
||
전체 완료율. 하위 요약은 15초 캐시(`paintWorkload`). **세로 막대**(같은 날 변경 — 사람마다 메인·하위 막대, 막대 = 그 작업 전체(100%),
|
||
초록 채움 높이 = 완료율, 위 = 완료/전체·%, 이름 왼쪽 프로필 아이콘(`avatarHtml`, 사진 없으면 기본 사람 아이콘 — 2026-10-13). 처음엔 높이를 작업 수로 그려 많은 사람 기준에 다른 막대가 눌려 보였다 → 완료율로 수정). 막대를 누르면 오른쪽 슬라이드 패널(`openWorkloadDrawer`, body 에 붙음, z 950 — 편집 창 아래)에
|
||
그 업무 목록(미완료·완료, 하위는 상위 작업 이름), 항목 → `openTaskById`(하위는 서버에서 받아) 편집 창. 편집 창이 닫히면
|
||
요약을 다시 받아 대시보드·패널을 다시 그린다. 하위 요약 API 는 id·제목·마감일·완료 시각도 준다.
|
||
**패널에서 연 편집 창은 패널 왼쪽에 붙어 열린다**(2026-10-13, `placeTaskBesideDrawer` — 패널은 그대로 보이고 다른 줄을 바로 누를 수 있음, 6-16).
|
||
**다시 그릴 때 깜박임 없음**(2026-10-13) — 편집 창을 닫거나 저장·8초 갱신으로 대시보드를 다시 그려도 패널은 닫았다 다시 열지 않고
|
||
내용만 바꾸며(`openWorkloadDrawer` 가 열린 패널 재사용 — 목록 스크롤·고른 줄 유지), 숫자·막대·도넛은 마지막 값(`dashPrev`/`dashFrom`)에서
|
||
시작해 바뀐 것만 움직인다. 0부터 차오르는 애니메이션과 카드 등장(투명→보임, CSS `.pj-dash-intro`)은 대시보드 탭에 들어올 때만(`selectView` 가 `dashPrev` 비움). 카드 안 스크롤도 유지.
|
||
- **보드** — 섹션별 칸반. `renderBoard` 는 캔버스를 통째로 다시 그리므로 **섹션 세로 스크롤(`.pj-col-body`,
|
||
섹션 id/이름 기준)·보드 가로 스크롤을 저장했다가 되돌린다**(작업 창 닫기·완료 체크·8초 갱신 후에도 보던 자리).
|
||
작업 창을 닫으면 펼친 카드의 하위 작업을 먼저 다 받은 뒤 한 번에 다시 그린다(짧아진 채 그리면 스크롤이 밀림). 섹션은 아사나처럼 **가로로 계속 늘어난다** — 화면을 넘치면
|
||
아래로 접히지 않고 보드가 가로로 스크롤된다(`.pj-board-canvas` = flex + `width:max-content`,
|
||
막대는 `attachHScrollIndicator` 가 직접 그린다. 예전 매이슨리 절대배치는 제거).
|
||
카드 안의 **담당자/마감일을 클릭하면 그 자리에서 바로 바꾼다**(담당자=멤버 목록 메뉴,
|
||
마감일=날짜 입력칸 + 지우기). 값이 없는 칩은 카드에 마우스를 올리면 흐리게 나타난다.
|
||
카드 드래그로 섹션 이동(`PUT /api/tasks/{id}` `stage_id`,
|
||
멀티호밍된 작업은 `POST /api/tasks/{id}/links`). 같은 섹션 안에서 드래그하면
|
||
이동이 아니라 카드 순서만 바꾼다(`PUT /api/projects/{id}/stages/{stage_id}/tasks/order`,
|
||
섹션 재정렬과 같은 패턴 — `tasks.sort_order`를 그 섹션 소속만 0부터 재배정).
|
||
섹션 컬럼 자체도 드래그로 재정렬(§1-1).
|
||
- **목록** — 표.
|
||
- 4개 뷰 모두 툴바의 "이 프로젝트"/"전체 프로젝트" 스코프 토글을 따른다(§1-1).
|
||
- 라이브러리는 현재 CDN 로드(스켈레톤). 추후 `app/static/vendor/` self-host 권장.
|
||
|
||
## 4. 메일 알림
|
||
|
||
- `app/mail.py` `send_email(...)` — `SMTP_HOST` 있어야 발송, 없으면 skip. STARTTLS/SSL/평문 지원.
|
||
- env: `SMTP_HOST/PORT/USER/PASSWORD/FROM/TLS`, 수신자 `PROJECT_NOTIFY_EMAIL`(쉼표, 비우면 admin 전원).
|
||
- 트리거: 작업 신규 배정(생성/수정 시 담당자 변경) · 완료단계 진입. `BackgroundTasks` 비동기, 실패는 로그만.
|
||
|
||
## 5. 배포
|
||
|
||
```bash
|
||
# 1) DB 생성 (superuser 1회, 컨테이너 postgres-db)
|
||
read -s -p "project_app password: " APP_PWD; echo
|
||
docker exec -i postgres-db psql -U postgres -v app_password="$APP_PWD" \
|
||
< scripts/sql/project_db_init.sql
|
||
|
||
# 2) /opt/www/main/.env 에 등록
|
||
# PROJECT_DB_URL=postgresql://project_app:<APP_PWD>@postgres-db:5432/project_db
|
||
# (메일 쓰려면 SMTP_* 추가)
|
||
|
||
# 3) 마이그레이션 002~008 적용 (첨부/알림, 섹션 생성자·하위 작업·멀티호밍,
|
||
# 작업 시간, 섹션 색상, 댓글 첨부, @태그)
|
||
docker exec -i postgres-db psql -U postgres -d project_db \
|
||
< scripts/sql/project_db_002_attachments_notifications.sql
|
||
docker exec -i postgres-db psql -U postgres -d project_db \
|
||
< scripts/sql/project_db_003_sections_subtasks_links.sql
|
||
docker exec -i postgres-db psql -U postgres -d project_db \
|
||
< scripts/sql/project_db_003b_task_times.sql
|
||
docker exec -i postgres-db psql -U postgres -d project_db \
|
||
< scripts/sql/project_db_004_stage_color.sql
|
||
docker exec -i postgres-db psql -U postgres -d project_db \
|
||
< scripts/sql/project_db_005_comment_attachments.sql
|
||
docker exec -i postgres-db psql -U postgres -d project_db \
|
||
< scripts/sql/project_db_006_mentions.sql
|
||
docker exec -i postgres-db psql -U postgres -d project_db \
|
||
< scripts/sql/project_db_007_live_version.sql
|
||
docker exec -i postgres-db psql -U postgres -d project_db \
|
||
< scripts/sql/project_db_008_followers_reminders_search.sql
|
||
docker exec -i postgres-db psql -U postgres -d project_db \
|
||
< scripts/sql/project_db_009_stage_default_assignee.sql
|
||
docker exec -i postgres-db psql -U postgres -d project_db \
|
||
< scripts/sql/project_db_010_trash.sql
|
||
docker exec -i postgres-db psql -U postgres -d project_db \
|
||
< scripts/sql/project_db_011_project_icon.sql
|
||
docker exec -i postgres-db psql -U postgres -d project_db \
|
||
< scripts/sql/project_db_012_comment_replies_reactions.sql
|
||
docker exec -i postgres-db psql -U postgres -d project_db \
|
||
< scripts/sql/project_db_013_goals.sql
|
||
docker exec -i postgres-db psql -U postgres -d project_db \
|
||
< scripts/sql/project_db_014_goal_halves_merges.sql
|
||
docker exec -i postgres-db psql -U postgres -d project_db \
|
||
< scripts/sql/project_db_015_goal_rect_merges_meetings.sql
|
||
docker exec -i postgres-db psql -U postgres -d project_db \
|
||
< scripts/sql/project_db_016_goal_row_label_groups.sql
|
||
docker exec -i postgres-db psql -U postgres -d project_db \
|
||
< scripts/sql/project_db_017_goal_quarters.sql
|
||
# 018 = 주간 회의록 줄 연결키(line_key) — 적용 전 백업, 적용·확인 방법은 6-9-3
|
||
docker exec -i postgres-db psql -U postgres -d project_db \
|
||
< scripts/sql/project_db_018_meeting_line_keys.sql
|
||
# 019 = 주간 회의록 이번주 글 셀 세로 병합 — 적용 전 project_db 백업
|
||
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db \
|
||
< scripts/sql/project_db_019_meeting_cell_editing.sql
|
||
# 020 = 새 주차(월요일 아닌 시작일)·지난주 결과 글·주차별 매출 목표 + 흡수된 월요일 회의록 이동 — 적용 전 project_db 백업(6-9-4)
|
||
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db \
|
||
< scripts/sql/project_db_020_meeting_periods.sql
|
||
# 022 = 회의 완료(goal_meetings.completed_at·completed_by) — 열 추가만(6-9-4)
|
||
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db \
|
||
< scripts/sql/project_db_022_meeting_complete.sql
|
||
# 021 = 회의록 정량 목표·결과에 글(target_text·result_text, 예: 20개) — 열 추가만(6-9-4)
|
||
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db \
|
||
< scripts/sql/project_db_021_meeting_amount_text.sql
|
||
|
||
# 4) 재배포 (git pull 후 반드시 --build)
|
||
cd /opt/www/main && docker compose up -d --build web
|
||
```
|
||
|
||
⚠️ 003 안에는 기존 `tasks.description`(일반 텍스트)을 안전한 HTML로 바꾸는
|
||
**1회성** `UPDATE` 문이 있다(설명란이 contenteditable 로 바뀌어 이제
|
||
description 을 항상 HTML로 취급하기 때문). 두 번 실행하면 이중 이스케이프되니
|
||
꼭 한 번만 돌릴 것.
|
||
|
||
## 5-1. 설명란 링크 · @태그(멘션)
|
||
|
||
- **설명란 링크** — 작업 편집 팝업의 설명란(contenteditable)에 웹주소를 붙여넣으면
|
||
자동으로 `<a target="_blank" rel="noopener noreferrer">` 가 된다(`linkifyToHtml`).
|
||
contenteditable 안에서는 브라우저가 링크를 기본으로 열지 않으므로 클릭을 직접 받아
|
||
새 탭으로 연다. 서식바의 링크 버튼으로 만든 링크도 같은 속성으로 맞춘다
|
||
(`normalizeEditorLinks`). 저장 시 sanitizer 가 `a` 의 `href/target/rel` 만 통과시킨다.
|
||
- **@태그(멘션)** — 설명란·댓글 입력칸에서 `@` 를 누르면 등록된 프로젝트 멤버 목록이 뜨고
|
||
(`GET /project/api/all-users`), 고르면
|
||
· 설명란: `<span class="pj-mention" data-email="...">@아이디</span>` 칩
|
||
· 댓글: `@아이디` 평문 + 이메일을 화면이 따로 기억해 전송 시 `mentions` 로 함께 보냄.
|
||
서버는 설명란은 **저장될 HTML 에서 직접** 이메일을 뽑고(`store.extract_mentions_from_html`,
|
||
화면이 보낸 목록을 믿지 않는다), 댓글은 받은 목록을 정규화해 쓴다.
|
||
새로 태그된 사람에게만 알림(`type=mention`)이 생긴다 — 같은 자리에서 중복 저장 안 됨.
|
||
- **수신함** (`/project/inbox`) — 위쪽 "나를 태그한 작업"(작업 1건당 1행, 최근 태그순.
|
||
누르면 확인 처리, "열기"는 `?task=` 로 그 작업 편집 팝업까지 연다) + 아래쪽 "알림".
|
||
내 작업·프로젝트 화면과 같은 2단 레이아웃(좌측 공용 사이드바 + 우측 프레임)이다.
|
||
API: `GET /api/mentions`, `GET /api/mentions/unread-count`, `POST /api/mentions/read`
|
||
(`task_id` 주면 그 작업만, 없으면 전부).
|
||
006 마이그레이션이 아직 안 돌아간 환경에서도 화면이 죽지 않게 조회/기록은 모두 감싸져 있다.
|
||
|
||
## 5-2. 작업 공유 링크 (퍼머링크)
|
||
|
||
- 작업 편집 팝업의 **공유** 버튼(`#pj-share-task`)이 `{origin}/project/t/{task_id}` 를
|
||
클립보드에 복사한다. 보드/목록/캘린더/타임라인 카드 우클릭과 내 작업 목록
|
||
우클릭의 "링크 복사"도 같은 함수(`shareTaskLink`)를 쓴다.
|
||
`navigator.clipboard` 는 https 에서만 동작하므로 임시 textarea 폴백을 두고,
|
||
둘 다 실패하면 주소를 `prompt` 로 보여준다.
|
||
- `GET /project/t/{task_id}` 는 권한만 확인하고 `/project/p/{project_id}?task=` 로
|
||
넘긴다(화면은 기존 경로가 그린다 — 작업이 다른 프로젝트로 옮겨가도 링크는 산다).
|
||
- 로그인 전이면 `/login?next=/project/t/{id}` 로 보내 **로그인 후 그 작업으로 복귀**.
|
||
- `project` 모듈 권한 없음 / 작업 없음 / 그 프로젝트 멤버 아님 → 각각 403·404·403
|
||
안내 화면(`denied.html`). 즉 **주소를 알아도 멤버가 아니면 못 본다**.
|
||
- 하위 작업 링크도 그 하위 작업 자신의 팝업으로 연다(목록엔 없으니 `GET /api/tasks/{id}` 로 받아 연다).
|
||
- `?task=` 로 들어왔는데 그 작업이 화면 목록에 없으면(완료 섹션 필터 등)
|
||
`GET /api/tasks/{id}` 로 그 작업만 받아 팝업을 연다.
|
||
|
||
## 6. 댓글 · 첨부 · 수신함 · 섹션 편집 (구현됨)
|
||
|
||
- **댓글** `task_comments` — 작업 모달 하단. 등록/삭제(본인·관리자). 새 댓글 시 관련자 인앱 알림.
|
||
- **작업 편집 팝업** — 버튼 줄(공유·완료·삭제·저장 상태·패널 접기)은 **팝업 맨 위에 고정**
|
||
(`.pj-modal-actions-top`) — 카드가 flex column 이고 `.pj-modal-body` 만 스크롤하므로 sticky 없이 고정된다(sticky 는 카드 padding 안쪽에 붙어 바가 밀려 내려오고 제목을 덮었다). 저장 버튼은 없다 — 실시간 저장(§6-6).
|
||
댓글 입력칸은 아사나처럼 **창 맨 아래 고정**(`#pj-comment-dock`) — `.pj-modal-body` 바깥 형제라서
|
||
끝까지 스크롤해도 마지막 내용이 입력칸 위에서 멈춘다(sticky 아님). 새 작업(id 없음)이면 숨긴다.
|
||
댓글·댓글 대화창(`#pj-cm-input`)·답글 입력칸은 여러 줄 입력칸(`textarea.pj-composer-ta`) — **Enter = 등록, Shift+Enter = 줄바꿈**,
|
||
입력칸 높이는 70px로 고정된다(`fitComposer`, 긴 글은 내부 스크롤). 댓글 본문은 `white-space: pre-wrap` 이라 줄바꿈이 그대로 보인다.
|
||
**설명란 이미지 더블클릭 → 별도 브라우저 창**(`openImageWindow`, 페이지 안 팝업 아님) — 창 크기 = 원본 크기(화면보다 크면 95%),
|
||
처음 원본 100%(창보다 크면 맞춤), 휠 = 커서 기준 확대·축소, 끌기 = 이동, 아래 막대 − / % / + · 1:1 · 맞춤, 더블클릭 = 원본↔맞춤,
|
||
키 + − 0 1 Esc. 팝업이 막히면 허용 안내 토스트.
|
||
**이미지 복사(2026-10-15)** — 설명란에서 고른 이미지 Ctrl+C, 보기 창 [복사]·Ctrl+C = 캔버스로 만든 **PNG 그림만** 클립보드에
|
||
(`copyImageToClipboard`, `navigator.clipboard.write` + `ClipboardItem` 에 Promise). 브라우저 기본 복사는 `<img src=첨부 주소>` HTML 을
|
||
넣는데 첨부 주소는 로그인해야 열려서 카카오톡·한글처럼 HTML 을 먼저 쓰는 프로그램엔 빈칸으로 붙었다(설명란 이미지 "선택"은 편집기 표시라
|
||
기본 Ctrl+C 는 아무것도 복사하지 않았음). 글자를 드래그해 둔 Ctrl+C 는 그대로 글자 복사. 검증 `tests/js/image_copy.browser.test.js`.
|
||
그 아래 메타(담당자·섹션·우선순위·마감일 한 줄 — 마감일은 캘린더 아이콘 버튼, 좁으면 2×2 | 협업자), 다시 그 아래 **설명란**과
|
||
**하위 작업**가 각각 팝업 너비 전체를 쓰는 별도 행(`.pj-desc-block` / `.pj-subtask-full`,
|
||
그리드 `1 / -1`). 하위 작업은 제목 왼쪽 체크박스로 완료를 토글하고, 완료된 줄은
|
||
반투명(50%) + 취소선. 좁은 화면과 "새 작업"(compact)에서는 단일 컬럼으로 흐른다.
|
||
- **첨부** `task_attachments` — 작업 모달. 파일 업로드(최대 20MB)/다운로드/삭제. 실제 파일은 `DATA_DIR/project/<task_id>/<uuid>.<ext>`, DB엔 메타만. 첨부 디렉토리는 운영 볼륨(DATA_DIR)에 저장돼 재배포에도 보존. 설명란 이미지 삽입도 이 표를 재사용(§1-1).
|
||
- **섹션 편집** — 보드 칸반 헤더(아사나식): 이름 바로 오른쪽에 작업 수(숫자만), 오른쪽 끝 **+**(작업 추가)·
|
||
**…**(메뉴: 작업 추가 / 이름 변경 / 섹션 편집(색상·기본 담당자) / 섹션 작업 모두 완료 / 완료 섹션 지정·해제 / 삭제,
|
||
헤더 우클릭도 같은 메뉴). 이름 클릭 = 그 자리 이름 변경. 트레일링 "+ 섹션 추가", **컬럼 드래그로 순서 변경**. `PUT .../stages/order`, `PUT .../stages/{id}`, 삭제는 만든 사람만.
|
||
- **수신함(인앱)** `project_notifications` — 배정/완료/댓글 시 수신자별 알림 생성. 우측 상단 벨(미읽음 배지) → `/project/inbox`. 항목 클릭=읽음, "모두 읽음". 본인 행동은 알림 제외.
|
||
- 마이그레이션: `scripts/sql/project_db_002_attachments_notifications.sql` (첨부·알림 테이블 + 권한), `scripts/sql/project_db_003_sections_subtasks_links.sql` (섹션 생성자·하위 작업·멀티호밍).
|
||
|
||
## 6-1. 실시간 반영 · 성능
|
||
|
||
- **live-version** — `GET /api/live-version` 이 돌려주는 값이 바뀌면 화면이 조용히 다시 받는다.
|
||
007 마이그레이션의 문장 단위 트리거가 projects·members·stages·tasks·comments·attachments·
|
||
links(+ mentions INSERT) 변경 때마다 `project_live_version.version` 을 1 올린다 — 삭제·섹션
|
||
이름변경·첨부 추가까지 감지되고, 서버는 PK 한 줄만 읽는다. 007 미적용이면 예전 MAX() 방식
|
||
(삭제 감지 못함)으로 자동 폴백하고 5분마다 다시 확인한다.
|
||
- 화면은 열자마자 기준값을 잡고, 탭이 안 보이는 동안(`document.hidden`)은 묻지 않는다.
|
||
바뀌면 `GET /api/projects/{id}/snapshot`(작업+섹션+멤버 한 번에)으로 이 프로젝트 맥락의
|
||
행을 통째로 바꿔 끼운다(삭제된 작업도 사라짐).
|
||
- 프로젝트 화면은 접근 가능한 모든 프로젝트의 작업/섹션을 각각 **쿼리 한 번**으로 읽는다
|
||
(`list_tasks_for_projects`, `list_stages_for_projects`). 행마다 `context_project_id`·
|
||
`is_linked`·`home_stage_id` 가 붙는다 — 연결 작업 행의 `stage_id` 는 연결된 쪽 섹션이고,
|
||
작업 편집 팝업의 "섹션" 선택은 항상 `home_stage_id`(원래 소속)를 쓴다.
|
||
- 라우터 핸들러는 전부 `def`(sync) — DB 드라이버가 동기라 `async def` 면 쿼리 동안 이벤트
|
||
루프 전체가 멈춘다. 첨부 업로드는 한도+1 바이트까지만 읽는다.
|
||
- 첨부 `/inline` 은 png/jpeg/gif/webp/bmp 만 화면에 띄우고 나머지(html·svg 등)는 다운로드로
|
||
내려준다(`X-Content-Type-Options: nosniff` + CSP sandbox). 작업/프로젝트/댓글 삭제 시
|
||
디스크 첨부도 같이 지운다.
|
||
- 설명란 sanitizer 는 URL 을 허용 목록(http/https/mailto/tel/상대경로, img 는 png·jpeg 등
|
||
data: 이미지)으로 검사한다 — 금지 목록은 `jav	ascript:` 로 우회됐다.
|
||
|
||
## 6-2. 검색 · 필터 · 정렬
|
||
|
||
- **전체 검색** — 좌측 사이드바 맨 위 검색창(`#pj-global-search`, 어디서든 `/` 키). 2글자 이상이면
|
||
`GET /api/search?q=` 로 내가 볼 수 있는 프로젝트의 작업(하위 작업 포함)를 제목·설명·댓글에서
|
||
찾는다. 설명은 HTML 이라 DB 에서 넉넉히 가져와 본문 텍스트로 다시 확인한다(태그 이름에만
|
||
걸린 결과 제거). 결과에 "설명/댓글" 어디서 걸렸는지와 미리보기. 누르면 `/project/t/{id}`.
|
||
008 의 pg_trgm GIN 인덱스(title·description·comment body)가 `ILIKE '%…%'` 를 받쳐준다.
|
||
- **필터 바** — 프로젝트 화면(`#pj-filterbar`): 찾기(제목·설명·담당자·섹션) · 상태 · 담당자
|
||
(나/없음/특정인) · 마감(지남/오늘/이번 주/없음) · 우선순위 · 정렬(기본/마감일/우선순위/제목/
|
||
담당자/최근 생성). 서버 재조회 없이 `visibleTasks()`(스코프 → 필터 → 정렬)에서 거르므로
|
||
보드·목록·캘린더·타임라인·대시보드 모두에 적용된다. 프로젝트별로 localStorage 에 기억.
|
||
필터나 정렬이 켜져 있으면 보드 카드 순서 드래그는 막는다(가려진 카드 때문에 순서가 어긋남).
|
||
목록은 열 제목 클릭 정렬이 우선. 내 작업 화면에도 찾기·마감·우선순위 필터(`#pj-mt-filterbar`).
|
||
공용 로직: `taskMatchesFilter` / `sortTasksBy`.
|
||
|
||
## 6-3. 협업자 · 마감 알림
|
||
|
||
- **협업자**(`task_followers`, 008) — 아사나의 협업자. 작업 팝업 메타 목록의 "협업자" 줄에서
|
||
추가(+ → 프로젝트 멤버)/빼기(×)/내 팔로우 토글. 즉시 저장(저장 버튼과 무관).
|
||
자동 팔로우: 만든 사람 · 담당자(배정 시) · 댓글 단 사람 · @태그된 사람. 008 이 기존 작업에도
|
||
같은 규칙으로 백필한다. API: `GET/POST /api/tasks/{id}/followers`(body `email`, 없으면 나),
|
||
`DELETE /api/tasks/{id}/followers/{email}` — 다른 사람은 그 프로젝트 멤버·owner·관리자만 추가 가능.
|
||
- **알림 수신자 변경** — 완료·댓글 인앱 알림은 이제 "담당자 + 협업자"에게만 간다(예전: 프로젝트
|
||
멤버 전원). 008 미적용이면 예전 방식으로 폴백.
|
||
- **마감 알림**(`reminders.py`) — 웹 프로세스 안 데몬 스레드가 5분마다 깨어, 영업일(주말·
|
||
`KR_HOLIDAYS` 제외) 설정 시각(`PROJECT_REMINDER_HOUR`, 기본 9시 KST) 이후 하루 한 번 돈다.
|
||
`due_soon`(다음 영업일까지 마감 — 금요일이면 주말·월요일분까지) · `due_today` · `overdue`
|
||
(최근 7일 이내 마감분). 수신자는 담당자, 없으면 협업자. `task_reminders` UNIQUE(작업·종류·
|
||
마감일·수신자)로 한 번만 — 재기동·중복 실행에도 안전, 마감일을 바꾸면 다시 알린다.
|
||
`PROJECT_REMINDER_EMAIL=true` 면 사람별 요약 메일 1통(SMTP 필요). `PROJECT_REMINDERS=false` 로 끔.
|
||
|
||
## 6-4. 섹션 기본 담당자 (마이그레이션 009)
|
||
|
||
- `project_stages.default_assignee_email`(TEXT, '' = 미지정). 섹션 편집 창(✎ / "+ 섹션 추가")의
|
||
"기본 담당자" 에서 지정 — 후보는 작업 담당자와 같다(프로젝트 멤버 + owner, 서버도 검증).
|
||
- **자동 배정 규칙**(`db._stage_default_assignee`) — 담당자가 **비어 있는** 작업만:
|
||
· 그 섹션에 작업 생성(`create_task`, 하위 작업 제외)
|
||
· 다른 섹션에서 그 섹션으로 이동(`update_task` 의 `stage_id` 변경 — 카드 드래그·작업 팝업 섹션 변경)
|
||
이미 담당자가 있으면 그대로. 지정된 사람이 프로젝트 멤버에서 빠졌으면 무시.
|
||
자동 배정도 일반 배정과 같이 활동이력·협업자·인앱 알림·메일이 나간다(`_newly_assigned`).
|
||
멀티호밍으로 연결된 프로젝트 쪽 섹션 이동(`/links`)은 대상 아님.
|
||
- 보드 섹션 머리 이름 옆에 기본 담당자 아바타(작게, 툴팁). 새 작업 팝업은 그 섹션 기본 담당자를 미리 채운다.
|
||
**2026-10-13**: 편집 권한자는 보드·목록 섹션 제목 오른쪽 아이콘(없으면 점선 원)을 눌러 그 자리에서 기본 담당자를 고른다(6-16).
|
||
- 009 미적용이어도 앱은 동작 — 조회는 `to_jsonb(행)->>'default_assignee_email'` 로 컬럼 유무와
|
||
무관, 지정 시도만 503("마이그레이션 009 필요"). 화면은 기본 담당자가 바뀐 경우에만 필드를 보낸다.
|
||
|
||
## 6-5. 휴지통 (마이그레이션 010)
|
||
|
||
- 작업을 지우면(하위 작업 CASCADE 포함) **지우기 직전 스냅샷**을 같은 트랜잭션에서 `project_trash.payload`(JSONB)에
|
||
남긴 뒤 예전처럼 삭제한다(`db.delete_task` → `(ids, trash_id)`). 스냅샷 = `tasks` + 딸린 테이블
|
||
`task_comments · task_followers · task_mentions · task_attachments · task_project_links · project_activity ·
|
||
task_reminders`(`TRASH_CHILD_TABLES`). 알림(`project_notifications`)은 되살리면 수신함이 옛 알림으로 차서 제외.
|
||
모든 조회 쿼리에 "삭제됨" 필터를 넣는 소프트 삭제 대신 이 방식 — 기존 화면·쿼리를 안 건드린다.
|
||
- 첨부 실물은 지우지 않고 `DATA_DIR/project/_trash/<trash_id>/<task_id>/` 로 옮긴다(복구 시 되돌림).
|
||
- **보관 3개월**(`expires_at`). 휴지통 화면을 열거나 작업을 지울 때 만료분을 영구 삭제(`_purge_trash`).
|
||
- **Pro user 이상**(2026-10-12, 예전 관리자 전용): 좌측 "휴지통" 메뉴·`/project/trash` 화면·`POST /project/api/trash/{id}/restore` 모두 `access.is_pro`.
|
||
복구는 원래 id 그대로(`restore_trash`): 같은 id 가 이미 있으면 거부, 프로젝트가 지워졌으면 거부, 하위 작업만
|
||
지웠는데 상위가 없으면 거부(상위 먼저 복구). 지워진 섹션은 섹션 없이, 지워진 프로젝트를 가리키는 연결/이력은 뺀다.
|
||
복구하면 휴지통 행은 지운다.
|
||
- 화면: 삭제 확인은 `confirmTaskDelete` 하나 — 하위 작업이 있으면 "하위 작업 N개까지 모두 삭제"를 분명히 묻는다.
|
||
카드의 하위 작업 줄 우클릭 = 열기 / 완료 / **하위 작업 삭제**. 삭제 후 토스트 "휴지통으로 옮겼습니다".
|
||
- 010 미적용이면 휴지통 없이 예전처럼 영구 삭제(휴지통 화면에 안내).
|
||
- 프로젝트 삭제(작업 전체 CASCADE)와 댓글 삭제는 아직 휴지통 대상이 아니다.
|
||
|
||
## 6-6. 작업 창 실시간 저장 · 제목 줄바꿈 · 프로젝트 제목 바로 수정
|
||
|
||
- **저장 버튼 없음**(아사나식). 칸마다 바로 `PUT /api/tasks/{id}` 로 **그 필드만** 보낸다(`saveField`) —
|
||
제목: blur/Enter(빈 값이면 되돌림) · 설명: 입력 멈춤 1.2초·blur(이미지 업로드 중이면 미룸) ·
|
||
담당자/섹션/우선순위/마감일: change 즉시. 요청은 `saveChain` 한 줄로 순서 보장, 보낼 값·id 는 부르는
|
||
순간 잡으므로 저장 중 다른 작업을 열어도 안전. 닫기·다른 작업 열기 직전 `flushAutoSave`. 버튼 줄에
|
||
"저장 중… / ✓ 저장됨 / 저장 실패" 표시(`#pj-autosave-state`).
|
||
- **새 작업**은 제목이 처음 생기는 순간 지금 칸 값으로 `POST` → 기존 작업 화면(댓글·첨부·하위 작업)으로
|
||
바꿔 연다. 그 사이 더 친 제목·설명은 이어서 저장. 제목 없이 닫으면 만들지 않는다.
|
||
- 섹션을 옮기면 서버가 기본 담당자를 넣거나 완료 처리할 수 있어 응답으로 담당자 칸·완료 버튼을 다시 맞춘다.
|
||
- 작업 제목칸은 `textarea`(자동 높이, `fitTitleHeight`) — 긴 제목은 다음 줄로. Enter·붙여넣은 줄바꿈은 막는다.
|
||
- 프로젝트 화면 제목 알약(`.pj-pill-name`)은 마우스 올림 → 테두리, 클릭 → contenteditable 로 이름 수정
|
||
(`PUT /api/projects/{id}` `{name}`, Enter/blur 저장·Esc 취소). `can_manage` 인 사람만.
|
||
|
||
## 6-7. 댓글 답글 · 이모티콘 반응 · 완료 이력 · @칩 (마이그레이션 012)
|
||
|
||
- `task_comments.parent_id`(답글, 한 단계 — 답글의 답글도 원 댓글에 붙음, 원 댓글 삭제 시 CASCADE) +
|
||
`task_comment_reactions`(comment_id·user_email·emoji PK, `task_id` 는 휴지통 스냅샷용 —
|
||
`TRASH_CHILD_TABLES` 에 포함). 012 트리거로 반응도 live-version 을 올린다.
|
||
- API: `GET /api/tasks/{id}/comments` → `{comments(+reactions), events, features}` —
|
||
`events` 는 `project_activity` 의 완료(`completed`) 이력 — **작업이 지금 완료 상태일 때 마지막 1건만**
|
||
(완료 취소하면 사라짐, 이력 행은 보존), 댓글 수에는 안 셈. `features` 는 012 적용 여부.
|
||
`POST /api/tasks/{id}/comments` 에 `parent_id`. `POST /api/comments/{id}/reactions` `{emoji}` = 켜기/끄기 토글.
|
||
- 화면: 작업 창 댓글은 시간순(댓글 + "OO 님이 이 작업을 완료했습니다" 줄), 답글은 원 댓글 아래 들여쓰기 +
|
||
답글 입력칸. 마우스 올림 도구 모음(👍 👀 🙌 ✅ · 반응 추가(이모티콘 창) · 답글 · 수정 · 삭제).
|
||
댓글 대화창은 말풍선 위 인용으로 답글 표시, 입력칸 위 "OO 님에게 답글" 줄.
|
||
본문의 `@아이디` 는 사용자 목록(`/api/all-users`)과 맞으면 아이콘+이름 칩(`commentBodyHtml`).
|
||
- 012 미적용이면 답글·반응 버튼이 숨겨지고, API 는 503 "마이그레이션 012 필요". 완료 이력·@칩은 012 없이도 동작.
|
||
- **반응 알림**(2026-10-13): 반응을 켤 때(끌 때 X) 그 댓글을 쓴 사람에게 수신함 알림 `type=reaction`,
|
||
제목 "내 댓글에 👍 반응: 업무 제목"(어떤 이모티콘인지), 본문 "프로젝트 · “댓글 앞부분”". 자기 댓글·지금 그 업무를 볼 수 없는 사람은 제외(`_notify_reaction`).
|
||
|
||
## 6-8. 수신함 오른쪽 작업 창 · 화면 배율
|
||
|
||
- 수신함의 "확인"(예전 "이동"/"열기")은 페이지를 떠나지 않고 오른쪽 패널(`.pj-inbox-panel`)에 작업 창만 띄운다.
|
||
프로젝트 화면을 `?task={id}&embed=1` 로 iframe 에 열고, `html.pj-embed` 가 작업 창 외에는 숨긴다.
|
||
작업 창을 닫으면 iframe 이 `postMessage({type:"pj-embed-close"})` → 패널 닫힘.
|
||
embed 에서만 작업 창 맨 위에 "프로젝트로 이동"(`#pj-goto-project`) — `window.top` 을 그 프로젝트 화면(`?task=`)으로. Ctrl+클릭은 새 탭(예전처럼 이동).
|
||
- **위쪽 여백 줄임**(2026-10-01): 프로젝트 관리 모든 화면(`.erp-page` 안이 `.pj-wrap`·`.pjh` 일 때만, `:has`)은 공통 본문 위 여백
|
||
24px → 6px, 화면 위 여백·제목 줄 위 여백 0 — 상단 바와 제목 사이 36px → 6px. 다른 모듈은 그대로.
|
||
- 화면 배율 토글(상단 바 `fit_screen`, `_help_btn.html`) — `html.pj-ui-scale` 이면 `.erp-app` 에 `zoom: .75`
|
||
(2880×1620·200% = CSS 폭 1440px 에서 1920 기준 화면처럼). zoom 안에서 줄어드는 `vh` 높이는 배율로 나눠
|
||
되돌린다. 팝업은 전부 `body` 에 붙어 배율 밖이라 좌표 보정 불필요(전체 검색 결과창도 body 로 옮김),
|
||
배율 안에서 마우스 거리로 크기를 바꾸는 작업 창 너비 조절만 `uiZoom()` 으로 나눈다. localStorage `pj_ui_scale`.
|
||
|
||
## 6-9. 연간 목표 (마이그레이션 013)
|
||
|
||
- 좌측 사이드바 개인 메뉴 맨 아래 **목표**(`_side.html` `#pj-side-goal`) — 누르면 바로 아래 연도 목록이 접혔다 펴진다
|
||
(`initGoalSide`, localStorage `pj_goal_open`, 목표 화면에선 항상 펼침). 연도 목록은 `router._goal_years_nav`
|
||
(`goal_years` 최근 연도 먼저 + **올해는 항상**, 013 미적용이면 올해만) — 사이드바를 그리는 모든 화면 컨텍스트에 `goal_years`.
|
||
- 연도를 누르면 `/project/goals/{연도}`(`goals.html`) — 스프레드시트 같은 한 표. 머리 줄(연간·1~12월)과 왼쪽 두 칸은 고정,
|
||
이번 달 열 강조. **가로 스크롤 때 3열(구분·항목·연간)까지 고정** — 연간 열 `position: sticky; left: 1열+2열 너비`, 경계 그림자.
|
||
월 칸 기본 너비 85px·연간 90px(여백 포함, `box-sizing: border-box`). 머리·왼쪽 이름은 가로 가운데 정렬이며,
|
||
업무 영역의 이름(1·2열)은 세로 가운데 정렬, 목표 글은 상단 정렬이며 위·아래 여백은 각 6px이다. 행 높이는 가장 높은 글 칸에 맞추고 글이 줄면 함께 줄어든다.
|
||
**모든 열**(구분·항목·연간·1~12월·분기)은 모든 행의 셀 오른쪽 끝에서 끌어 너비 조절(더블클릭 = 가장 긴 문단에 맞춤).
|
||
브라우저별 localStorage `pj_goal_col_w`(키 `c1`·`c2`·`y`·`m1`~`m12`·`q1`~`q4`, 기본값과 다른 칸만 저장).
|
||
드래그는 이름 두 칸 48~320px·CSS 변수 `--goal-c1-w`·`--goal-c2-w`, 나머지 40~600px·머리 칸의 `--cw`로 조절한다.
|
||
자동 맞춤은 긴 문단에 맞게 최대 너비를 넘어도 저장·복원한다. 분기를 펼칠 때도 지정한 열 너비를 그대로 사용한다.
|
||
- **틀 고정** — 세로 스크롤에도 머리 줄 + 숫자 지표(매출·로아스) 줄까지 위에 붙어 있다. 지표 칸 `position: sticky` + 줄마다 `--kpi-top`(머리 줄 높이 + 앞 지표 줄 높이 합, `stickKpi`, 창 크기 바뀌면 다시 잼). z-index: 영역 이름 칸 2(마우스 올림 6) < 지표 칸 7 < 지표 이름 칸 8 < 머리 줄 9 < 머리 이름 칸 10.
|
||
- **숫자 지표** `goal_metrics`(year·metric `sales|roas`·kind `target|actual`·month 1~12·value NUMERIC(18,2)) —
|
||
매출 목표/실적/달성, 로아스 목표/실적. 매출 연간 = 월 합계, 달성률 = 실적÷목표(월별, **연간·반기는 그 기간 목표 합계 전체 대비 입력된
|
||
실적 합계** — 2026-10-01 사용자 기준, 예전엔 실적이 있는 달의 목표만)는
|
||
화면에서 계산(저장 안 함). 매출 단위 글자는 `goal_years.sales_unit`.
|
||
- **업무 영역** `goal_areas`(연도별, 이름·색 `store.GOAL_AREA_COLORS` 연한 16색 + 색 없음(빈 값 = 흰 배경)·순서) → `goal_rows`(영역 안 줄, 최소 1줄 — 마지막 줄은
|
||
못 지움) → `goal_cells`(row × month, **0 = 연간**, 빈 글 = 행 삭제). 영역 색이 줄 전체 배경.
|
||
- 권한: 조회는 `project` 권한자 전원, **입력·구조 변경은 Pro user 이상**(`_require_pro`, 화면도 `pj_pro` 에게만 입력칸·도구 — 6-14).
|
||
- 연도 추가(`POST /api/goals/years {year}`)는 가장 가까운 이전 연도(없으면 다음 연도)의 영역·줄 구조를 글 없이 복사,
|
||
목표가 하나도 없으면 `store.DEFAULT_GOAL_AREAS`(상품·마케팅·컨텐츠·유통[콜라보·인플·쿠팡·기타]). 없는 연도 화면은
|
||
관리자에게 "목표 만들기" 버튼(GET 에서 자동 생성하지 않는다). 연도 삭제는 연도를 직접 입력해야 진행(CASCADE 전부 삭제).
|
||
- API(전부 Pro user 이상): `PUT /api/goals/{y}` `{sales_unit}` · `DELETE /api/goals/{y}` · `PUT /api/goals/{y}/metrics`
|
||
`{metric,kind,month,value}`(빈값 = 지움, 응답 `label` 은 쉼표 표기) · `POST /api/goals/{y}/areas` `{name,color}` ·
|
||
`PUT|DELETE /api/goals/areas/{id}` · `POST /api/goals/areas/{id}/move` `{direction:-1|1}` · `POST /api/goals/areas/{id}/rows` `{label, ref_row_id?, place?: above|below}`(기준 줄 위/아래, 없으면 맨 끝) ·
|
||
`PUT|DELETE /api/goals/rows/{id}` · `POST /api/goals/rows/{id}/move` · `PUT /api/goals/rows/{id}/cells/{month}` `{body}`.
|
||
013 미적용 503, 없는 대상 404, 입력 오류 400(`_goal_call`).
|
||
- 화면 동작(`initGoals`): 숫자 칸은 Enter/칸 떠남에 저장(Esc = 저장된 값으로), 글 칸은 0.8초 멈춤·칸 떠남에 저장,
|
||
저장되면 칸 테두리가 잠깐 초록, 실패하면 빨간 테두리(입력값 유지). 저장은 공용 `createFieldSaver`(6-9-3 — 같은 칸 요청 직렬화,
|
||
보낸 값만 저장됨으로, 실패 시 초안 유지·localStorage 초안 백업, 페이지 떠남 보호). 영역/줄 추가·순서·삭제·병합은 먼저 저장 안 된
|
||
글을 저장하고(실패하면 작업 중단) 그 자리에서 다시 그림(`refreshTable`), 영역 색은 팝업(body 에 붙임)에서 바로 바뀜.
|
||
목표 테이블은 live-version 트리거에 넣지 않았다(입력 중 새로고침 방지).
|
||
- 추후: 매출 실적을 실적 모듈(`performance_db`)에서 월별로 자동으로 채우기.
|
||
|
||
### 6-9-0. 1~4분기 칸 (마이그레이션 017, 2026-10-01 — 상·하반기 대신)
|
||
|
||
- **열 순서** — 연간 · 1~3월 · **1분기** · 4~6월 · **2분기** · 7~9월 · **3분기** · 10~12월 · **4분기**
|
||
(`store.GOAL_COL_ORDER = (0, 1, 2, 3, 13, 4, 5, 6, 15, 7, 8, 9, 14, 10, 11, 12, 16)`). 템플릿 컨텍스트 `quarters`
|
||
(`(분기, 월 목록, 글 칸 번호, "N분기")`), 월 칸 `data-h` = 분기 1~4, 분기 칸 클래스는 예전 이름 `pj-goal-half-col` 그대로.
|
||
- **분기 글 칸 번호**(`store.GOAL_QUARTER_COL`) = 1분기 13 · 2분기 15 · 3분기 14 · 4분기 16 — 예전 반기 칸 번호를 그대로 이어 써서
|
||
글을 옮기지 않는다(예전 상반기 글 → 1분기, 하반기 글 → 3분기에 보임). 15·16 은 017 이 `goal_cells` CHECK 를 0~16 으로 넓힌 뒤에만
|
||
저장(미적용이면 읽기 전용 칸 + API 503 `GoalMigration017Needed`, 적용 여부 = `db._goal_quarters` → `board.quarters`).
|
||
- **병합** — 가로는 **같은 분기 월 칸끼리만**, 연간·분기 칸은 세로로만(`goal_col_group`: year · q1~q4 · months1~4).
|
||
017 은 분기를 넘던 예전 반기 병합(예: 2~4월)을 그 분기 끝 월까지로 줄이고(글은 시작 칸 그대로), 한 칸짜리가 된 병합 행은 지운다.
|
||
화면(`_goal_area_layout`)도 분기를 넘는 병합은 잘라 그린다(017 전에도 안전).
|
||
- **숫자 지표** — 분기 칸 = 그 분기 월 합계, 달성률 = 분기 실적 합계 ÷ 분기 목표 합계(`SUM_SCOPES` 연간 + 4분기),
|
||
로아스 분기 = 매출 가중 평균(연간과 같은 규칙).
|
||
- **업무 영역 추가 · 줄 추가는 묻지 않고 바로**(2026-10-02) — 영역은 "새 업무 영역", 줄은 빈 이름으로 만들고 표를 다시 그린 뒤
|
||
그 이름 칸을 바로 입력 상태로(`editNewName` → `startNameEdit`, Enter 저장 · Esc 그대로).
|
||
- **분기 접기** — 분기 **머리 칸 아무 곳이나** 누르면(`.pj-goal-fold-th`, 너비 조절 손잡이를 끈 직후 0.3초 클릭은 무시) 그 분기 월 칸을
|
||
0.32초 동안 부드럽게 접었다 편다. 애니메이션 중에는 해당 월 칸 내용만 가리고, 글 칸은 원래 폭(`--fold-w`)으로
|
||
높이를 유지한다. 펼침이 끝난 뒤 숫자·글을 표시하므로 오른쪽 정렬 숫자가 밀리지 않는다. 분기별 타이머를 교체해
|
||
빠른 재클릭·여러 분기 동시 전환도 마지막 상태로 마무리한다. 동작 줄이기 설정에서는 즉시 표시/숨김한다.
|
||
아이콘은 엑셀 열 그룹처럼 네모 안 − (펼침, 누르면 접힘) / + (접힘) — 바뀔 때 90° 돌며 세로 막대가 자라거나 줄어든다.
|
||
- **분기 색(monday.com 그룹 색 띠 방식)** — 분기마다 차분한 색 하나(1 파랑 · 2 청록 · 3 보라 · 4 남색, 달성률 빨강·초록과 안 겹치게).
|
||
`data-h` 가 있는 칸에 `--qc`·`--qt`·`--qt2`. 머리 위 색 띠 = 월 칸 3px · 분기 칸 6px(`th::before`, 월 링크가 덮어도 보임),
|
||
분기 열 전체 옅은 음영(`td.pj-goal-half-col[data-h]` background-image — 영역 색 위에도), 분기 칸 오른쪽 2px 경계,
|
||
분기 머리 글자·아이콘은 분기 색, 접힌 분기 머리는 진한 음영.
|
||
열 너비 키는 `q1`~`q4`(기본 80px).
|
||
- 아래 6-9-1 의 상·하반기 설명은 014 당시 기록 — 칸 번호·접기·병합 규칙은 이 절이 우선.
|
||
|
||
### 6-9-1. 상·하반기 칸 · 반기 접기 · 이름 바로 수정 · 월 칸 병합 · 로아스 % (마이그레이션 014) — 017 에서 분기로 바뀜(6-9-0)
|
||
|
||
- **열 순서** — 연간 · 1~6월 · **상반기** · 7~12월 · **하반기**. 템플릿 컨텍스트 `halves`
|
||
(`(반기, 월 목록, 글 칸 번호 13|14, 이름)`), 월 칸은 `pj-goal-m` + `data-h="1|2"`, 반기 칸은 `pj-goal-half-col`.
|
||
- 숫자 지표: 매출 목표·실적의 반기 칸 = 그 반기 월 합계(`data-scope="13|14"`, 연간은 `0`), 달성률은 연간과 같은 규칙
|
||
(그 반기 목표 합계 대비 실적, `SUM_SCOPES`). **로아스 연간·반기**(목표·실적) = 기간 매출 ÷ 기간 광고비 — 광고비를 따로 적지 않아
|
||
월마다 매출 ÷ 로아스로 환산해 합친 **매출 가중 평균**(같은 목표/실적 매출 사용), 로아스가 있는 달 중 매출이 없는 달이 있으면 단순 평균
|
||
(말풍선에 방식·개월 수). 화면 계산(저장 안 함), 숫자 칸을 고치면 바로 다시 계산.
|
||
- 업무 영역 글: `goal_cells.month` **13 = 상반기, 14 = 하반기**(014 가 CHECK 를 0~14 로 넓힘). 014 미적용이면 반기 글 칸은
|
||
보기 전용 빈 칸이고, 저장 API 는 503 "마이그레이션 014 필요"(`store.GoalMigration014Needed`).
|
||
- **반기 접기** — 반기 칸 머리의 버튼(`.pj-goal-fold`, 펼침 ‹ / 접힘 뒤집힌 › + 강조색)이 그 반기 월 칸을 접었다 편다.
|
||
보기 전용 사용자도 쓸 수 있고 상태는 브라우저별 localStorage `pj_goal_fold`(`{"1":bool,"2":bool}`).
|
||
애니메이션(`applyFold`): 접기 = `.is-shrunk`(칸 width·padding·테두리 → 0, `.is-folding` 동안만 transition .32s) 뒤
|
||
`.is-gone`(display:none), 펴기 = 거꾸로. 줄어드는 동안 칸 안 내용은 원래 폭(`85px × --span`)으로 고정해 잘라 내서 줄 높이가
|
||
출렁이지 않는다. **표는 `width: 1px` + `table-layout: fixed`** — fixed 는 표 너비가 auto 가 아닐 때만 먹는다(auto 면 칸 너비가
|
||
내용을 따라가 펼칠 때 애니메이션 없이 한 번에 튄다). 표는 칸 너비 합만큼 늘어난다. contenteditable 글 칸은 고정 높이 없이
|
||
펼쳤을 때의 내용·너비로 자연 높이가 정해진다(예전 textarea는 숨겨져 있으면 측정을 건너뛰고 펼친 뒤 다시 잼).
|
||
`prefers-reduced-motion` 이면 애니메이션 없이.
|
||
- **영역·줄 이름 바로 수정**(관리자) — 이름(`[data-goal-edit="area|row"]`)을 누르면 contenteditable(`startNameEdit`) —
|
||
Enter·칸 떠남 = 저장, Esc = 취소, 붙여넣기는 글자만. 영역 이름 빈 값은 되돌림(서버도 400), 줄 이름은 빈 값 허용(빈 줄 이름은
|
||
마우스를 올리면 "줄 이름" 자리 표시). 예전 ✎(prompt) 버튼은 없앴다. 색·순서·줄 추가·삭제는 우클릭 메뉴(아래).
|
||
- **구역·항목 칸 메뉴 = 우클릭 + ⋮ 버튼**(2026-10-01) — 마우스 오버 도구 막대(색·↑·↓·+·×)는 뺐다(옆 칸으로 갈 때 걸리거나 고정되는 문제).
|
||
대신(점검 UX 8) 칸 오른쪽 위 작은 ⋮ 버튼(`.pj-goal-menu-btn`, 관리자만, `data-goal-menu="area|row"`) — absolute 라 자리를 차지하지 않고
|
||
평소 투명, 칸에 마우스·포커스가 오면 보임, 터치 화면(`hover: none`)은 늘 옅게(0.7). 우클릭과 **같은 메뉴**(`openAreaMenu`·`openRowLabelMenu`).
|
||
접근성: 버튼 `aria-label="{이름} 구역 메뉴|줄 메뉴"`·`aria-haspopup="menu"`·`aria-expanded`, Tab → Enter/Space 로 열면 첫 항목 포커스,
|
||
메뉴(`showContextMenu` 공용, `role=menu`/`menuitem`) 안 ↑↓·Home·End·Enter, Esc·Tab = 닫고 버튼으로 포커스 복귀, 같은 버튼 다시 누르면 닫힘.
|
||
이름 칸(`[data-goal-edit]`)도 `tabindex=0` — Enter·F2 = 이름 수정(한글 조합 중 Enter 무시).
|
||
1열(구역 칸) 우클릭(`areaMenuItems` → `goalAct`): 색 바꾸기(색 창은 우클릭한 자리, 현재 색은 `tbody[data-color]`) · 위로 · 아래로
|
||
(맨 위·맨 아래면 없음) · 줄 추가(구역 맨 아래) · 영역 삭제. 2열(항목 칸) 우클릭(`rowMenuItems`): 위/아래에 줄 추가 · **위로 · 아래로**
|
||
(묶이지 않은 칸만) · 항목 칸 나누기(묶인 칸) · 줄 삭제. 이름은 눌러서 바로 수정(그대로).
|
||
- **줄 추가·삭제(항목 칸)**(관리자) — 줄 이름 칸 도구 막대: ↑·↓(줄 2개 이상)·**+ = 이 줄 아래에 줄 추가**·×(줄 2개 이상). 항목 칸 **우클릭 메뉴**: 위에 줄 추가 / 아래에 줄 추가 / 줄 삭제(영역의 마지막 한 줄이면 없음). 추가는 이름을 묻고(비워도 됨) `db.add_goal_row(ref_row_id, place)` 가 영역 줄 순서를 다시 매긴다(영역 FOR UPDATE). 영역 이름 칸의 + 는 예전처럼 맨 끝에 추가.
|
||
- **칸 병합 — 엑셀식**(관리자, 014 + 015, 2026-10-01에 예전 Shift+클릭·떠 있는 병합 버튼·오른쪽/왼쪽 칸과 병합 메뉴를 대체)
|
||
— `goal_cell_merges(row_id, start_month, span, row_span)`. 시작 칸 = **왼쪽 위**(row_id = 맨 위 줄, start_month = 왼쪽 칸 번호).
|
||
- 범위: **같은 업무 영역 안 연속된 줄**(세로, `row_span` — 015) × 화면 순서(연간 · 1~6월 · 상반기 · 7~12월 · 하반기 =
|
||
`store.GOAL_COL_ORDER`)의 연속된 칸. 가로는 **같은 반기 월 칸끼리만**, 연간(0)·상반기(13)·하반기(14) 칸은 **세로로만**
|
||
(`store.validate_goal_rect_cols`, DB CHECK). 015 미적용이면 예전처럼 한 줄 월 칸 가로 병합만(세로·연간/반기는 503).
|
||
- 고르기: 글 칸을 **마우스로 끌기**(다른 칸으로 넘어가는 순간부터 범위 선택, 글 선택·포커스는 막음 — `html.pj-goal-selecting`)
|
||
또는 **Shift+클릭**(마지막으로 누른 칸부터). 범위가 병합된 칸에 걸치면 **엑셀처럼 그 칸 전체로 넓힌다**(`expand`). 칸 한 번 클릭은
|
||
그대로 입력. 다른 곳 누름·Esc = 해제.
|
||
- **우클릭**: "셀 병합 (N줄 × M칸)"(2칸 이상) · "병합 해제"(범위 안 병합된 칸, 여러 곳이면 개수). 범위 밖을 우클릭하면 그 칸만
|
||
고른 것으로(엑셀과 같음). 너비 자동 맞춤 메뉴도 함께 표시한다. 묶음이 다른 가로 범위는 서버를 부르지 않고 안내.
|
||
- `POST /api/goals/areas/{area_id}/merge {row_from, row_to(줄 id), col_from, col_to(칸 번호)}` → `db.merge_goal_rect`: 영역 FOR UPDATE,
|
||
걸친 병합 흡수(넓힌 뒤 묶음 다시 검사), 범위 안 글을 **왼쪽 위부터 줄·칸 순서대로 줄바꿈으로 이어 왼쪽 위 칸에**(글을 잃지 않게 —
|
||
엑셀은 왼쪽 위 값만 남기지만 여기선 잇는다), 나머지 칸 글·안쪽 병합은 지운다. 응답 `{row_id, start, span, row_span}`.
|
||
`DELETE /api/goals/rows/{row_id}/merge/{start}` = 해제 — **글은 왼쪽 위 칸에 남는다**(엑셀과 같음). 화면은 저장 안 된 글을 먼저
|
||
저장(`flushTexts`)한 뒤 부르고 새로고침.
|
||
- 화면 배치: `router._goal_area_layout` 이 영역 단위로 칸마다 `{m, kind, h, span, rspan, now}` — 시작 칸은 `colspan`·`rowspan`,
|
||
가려진 칸은 그리지 않는다(세로는 영역 끝, 가로는 같은 묶음 안으로 자름). 반기 접기는 병합 칸도 `pj-goal-m[data-h]` 로 함께 숨김.
|
||
- 가려진 칸으로 늦게 온 글 저장은 400("병합된 칸입니다", `_area_geometry`·`_covered_by` — 가로·세로 모두).
|
||
- 줄 작업과 세로 병합(엑셀처럼): 병합 **안쪽에 줄 끼우기** → `row_span + 1` · **가려진 줄 지우기** → `row_span − 1`(1칸이 되면 병합 삭제) ·
|
||
맨 위(시작) 줄 지우기 → 병합도 지워짐(CASCADE) · 세로 병합에 걸린 줄(자신이나 바꿀 이웃)의 **↑↓ 이동은 400**(해제 뒤 이동).
|
||
- 새 연도 만들기(구조 복사)는 병합을 복사하지 않는다(줄 이름만).
|
||
- **구조 변경 뒤 제자리 다시 그리기**(`refreshTable`, 2026-10-01) — 줄·영역 추가/삭제/이동, 병합/해제 뒤 페이지를 새로고침하지
|
||
않고 이 페이지를 다시 받아 **업무 영역 tbody 만** 바꿔 끼운다(열 너비·반기 접기 다시 적용, 새 글 칸 연결 `bindTexts`). 새로고침 때
|
||
저장된 열 너비가 늦게 적용돼 표가 줄었다 늘어나고 깜박이던 것을 없앴다. 애니메이션: 지운 줄은 흐려지며 사라지고, 남은 줄은 예전
|
||
자리에서 미끄러져 오고(FLIP, 0.28초), 새 줄은 위에서 내려오며 보라색으로 잠깐 강조(`is-new-row`), 병합·해제한 칸은 테두리 강조
|
||
(`is-merge-flash`). 동작 줄이기 설정이면 애니메이션 없이. 받아 오기 실패하면 예전처럼 새로고침.
|
||
- **3열(연간 칸) 우클릭 → 줄 메뉴**: 위에 줄 추가 · 아래에 줄 추가 · 줄 삭제. **3열에서 추가한 줄은 같은 항목 칸(2열) 안에** 들어간다
|
||
(2열은 하나, 3열부터 줄이 늘어남 — 이름을 묻지 않음, `same_label`, 마이그레이션 016). 세로로 병합된 연간 칸이면 아래 추가는 병합의
|
||
맨 아래 줄 기준, 삭제는 없음. 병합 메뉴(셀 병합·해제)가 있으면 그 아래에 붙는다.
|
||
- **항목 칸(2열) 묶음**(016 `goal_rows.label_cont` = 바로 위 줄 항목 칸에 묶임, 이름은 묶음 첫 줄에): 화면은 `router._goal_label_spans`
|
||
가 묶음 첫 줄에 `label_span`(2열 rowspan), 이어 붙은 줄은 2열을 그리지 않는다.
|
||
- `POST /api/goals/areas/{id}/rows {ref_row_id, place, same_label: true}` → 아래 = 새 줄이 이어 붙음, 위 = 기준 줄이 묶음 첫 줄이면
|
||
새 줄이 첫 줄이 되어 이름을 넘겨받고 기준 줄이 이어 붙음(이어 붙은 줄 위면 그냥 이어 붙음). 016 미적용이면 503.
|
||
- 2열 메뉴·+ 의 줄 추가는 **묶음 밖**(위 = 묶음 첫 줄 위, 아래 = 묶음 맨 아래 줄 아래, 이름 물음). 묶인 2열 우클릭 → **항목 칸 나누기**
|
||
(`POST /api/goals/rows/{첫 줄}/split-label` — 이어 붙은 줄들이 각자 빈 이름 항목 칸으로).
|
||
- 묶음 첫 줄 삭제 → 바로 아래 이어 붙은 줄이 첫 줄이 되고 이름이 비어 있으면 넘겨받음. 묶인 줄(첫 줄·이어 붙은 줄)과 바꾸는 ↑↓ 이동은 400
|
||
(나눈 뒤 이동), 묶음 첫 줄 도구 막대엔 ↑↓ 없음. 새 연도 만들기는 묶음도 복사한다.
|
||
- **선택한 글자 서식**(관리자, 2026-10-02) — 목표 업무 영역 글 칸은 `.pj-goal-text[contenteditable]`.
|
||
같은 칸의 글자를 드래그해 선택하면 셀 상단 중앙을 기준으로 셀 위에 엑셀 형태 도구가 나타난다(여러 줄 글의 어느 줄을 선택해도 동일 위치).
|
||
아이콘은 처음 엑셀 형태 도구 크기의 80%이다. 밑에 현재 색상 선을 둔 `가`+드롭다운은 기존 12색 견본,
|
||
`가`+위/아래 화살표는 크기 2px 증감(10~32px, 혼합 크기는 조각마다 증감), 굵게·기울임·밑줄은 적용 상태가 보이는 토글 버튼.
|
||
서식 초기화는 구분선 뒤의 지우개 아이콘(14.4px)으로 표시하며 접근성 이름·도움말은 `서식 초기화`이다.
|
||
모든 버튼은 24px 높이, 서식 바는 위아래 여백 4px로 한 줄에서 34px 높이. 서식 초기화는 선택 범위의 모든 서식만 제거하며 글은 유지한다.
|
||
기존 `createFieldSaver`의 자동 저장·실패 재시도·임시 복구를 재사용한다.
|
||
`goal_cells.body` TEXT에 `pj-rich:v1:` + JSON 텍스트 조각 배열 `{text,bold?,italic?,underline?,color?,size?}`를 저장한다(추가 마이그레이션 없음).
|
||
평문은 기존 형식 그대로, `store.validate_goal_text`가 허용 서식과 보이는 글자 길이를 검사하고 `goal_text_html`이 글을 escape한 안전한 span만 만든다.
|
||
셀 병합은 각 조각 서식을 보존하고, 회의록 월간 계획 추출은 `goal_text_plain`으로 글만 읽는다.
|
||
- **칸 아무 곳이나 눌러 입력**(엑셀처럼) — 글 입력칸은 글 높이만큼이라, 옆 칸 글이 길거나 세로 병합으로 칸이 길면 아래쪽을 눌러도
|
||
입력이 안 됐다. 이제 업무 영역 글 칸(`td.pj-goal-texttd`)·회의록 글/금액 칸 아무 곳이나 누르면 그 칸 입력으로 들어가고 커서는 글 끝.
|
||
칸 전체가 글 입력 마우스 모양. Shift+클릭(범위 고르기)·끌기(병합 선택)는 그대로.
|
||
입력 중 테두리·밝은 배경도 입력칸이 아니라 **칸 전체**(`td:focus-within`, 회의록 표도 같음).
|
||
- **고른 칸 내용 지우기(엑셀 Del)** — 끌기·Shift+클릭으로 고른 범위에서 Del → 범위 안 글 칸을 비우고 칸마다 바로 저장, 안내 토스트.
|
||
바로 직전 지우기는 **Ctrl+Z** 로 되돌림(되돌린 값도 저장). 입력 중(글 칸에 커서)일 때의 Del·Ctrl+Z 는 평소 글자 편집.
|
||
우클릭 메뉴에도 "내용 지우기 (Del)"(`ink_eraser`, 고른 범위에 글이 있을 때).
|
||
- **우클릭 너비 자동 맞춤**(2026-10-03) — 목표 표의 이름·글·숫자·머리 칸 모두 "현재 열 너비 자동 맞춤" / "전체 열 너비 자동 맞춤"을 표시한다.
|
||
보기 전용 사용자도 사용 가능하며 너비는 브라우저에 저장한다. 현재 열은 경계 더블클릭과 같고, 병합 칸은 오른쪽 끝 열을 맞춘다.
|
||
전체 맞춤은 접힌 월 열도 포함해 각 열의 가장 긴 문단에 맞추고, 병합 글에 부족한 폭은 그 병합의 마지막 열에 더한다.
|
||
- **셀 테두리로 내용 이동 — 연간 목표 표에서는 2026-10-07 요청으로 화면에서 없앴다**(테두리 손잡이·드래그 코드 삭제, 누른 칸 표시
|
||
`is-goal-active` 만 남김. `POST /api/goals/cells/move` API 는 남아 있음. 주간 회의록 표의 이동은 그대로). 아래는 예전 설명 —
|
||
(관리자, 2026-10-03) 업무 영역의 연간·월·분기 글 칸 하나를 클릭한 뒤 위·아래·왼쪽 테두리를 잡아
|
||
다른 글 칸에 놓으면 내용과 색·크기·굵게·기울임·밑줄을 옮긴다. 오른쪽 경계는 열 너비 조절용이다. 끄는 동안 대상 칸을 표시하고
|
||
표 가장자리에서는 자동 스크롤한다. Esc·창 포커스 해제·원본에 놓기는 취소한다. 대상에 글이 있으면 덮어쓰기를 확인한다.
|
||
병합 시작 칸의 글도 이동 가능하며 병합 배치·영역 색·열 너비는 유지한다. 연간·분기의 기본 글자 서식도 명시해 원본의 표시를 보존한다.
|
||
미저장 글을 먼저 저장한 후 `POST /api/goals/cells/move`로 두 칸을 한 트랜잭션에서 이동한다(추가 마이그레이션 없음).
|
||
일반 글 저장·병합과 영역 잠금을 공유하고 원본·대상 예상값을 비교한다. 다른 창의 수정·병합에 가려진 칸은 409로 중단한다.
|
||
성공 응답 뒤 원본을 비우며, 실패하면 두 칸의 화면 내용을 유지한다. 응답이 유실된 동일 요청 재시도는 완료 상태를 확인해 성공으로 반환한다.
|
||
- **우클릭 메뉴 아이콘** — `menuIcon(name)`(Material Symbols)을 `showContextMenu` 항목 `icon` 에: 위에 줄 추가 `add_row_above` ·
|
||
아래에 줄 추가 `add_row_below` · 줄 삭제 `delete`(빨강) · 셀 병합 `cell_merge` · 병합 해제 `call_split` · 항목 칸 나누기
|
||
`horizontal_split` · (회의록) 위로/아래로 `arrow_upward`/`arrow_downward` · 쇼핑몰 연결 `link` · 연결 안 함 `link_off` · 쇼핑몰 `storefront`.
|
||
- **월 머리 → 주간 회의록** — 목표 표 머리의 월 칸을 누르면 `/project/goals/{연도}/meetings/{월}`(6-9-2). 링크(`a.pj-goal-mlink`)는
|
||
글자만이 아니라 **칸 전체**(absolute inset 0), 오른쪽 끝 너비 조절 손잡이(z-index 5)는 링크 위라 그대로 끌 수 있다.
|
||
- **로아스 단위 %** — 로아스 목표·실적 칸은 `499%` 처럼 보인다(`router._goal_label`, 저장 응답 `label` 도 같음). 입력은 `499`·`499%`
|
||
둘 다 되고 저장 값은 숫자(`validate_goal_value` 가 `%` 를 뗀다).
|
||
|
||
### 6-9-2. 주간 회의록 (마이그레이션 015)
|
||
|
||
왼쪽 목표 연도 아래에는 생성된 회의록만 월별 폴더 트리로 표시한다(`project-goal-nav.js`·`.css`,
|
||
`GET /project/api/goals/meeting-nav`, 프로젝트 권한자 조회). 월요일이 속한 월로 묶고 월·주차는 날짜순이다.
|
||
월 폴더는 아이콘과 함께 접기·펼치기를 지원하며 `pj_goal_month_open:{연도}:{월}`에 선택을 기억한다.
|
||
연도 앞 화살표는 해당 연도의 하위 월 전체를 접고 펼친다(`pj_goal_year_open:{연도}`에 선택 기억, 기본 펼침).
|
||
연도 글자를 누르면 기존 연간 목표 화면으로 이동한다. 연도를 접어도 각 월의 접기·펼치기 상태는 유지된다.
|
||
현재 회의록의 월은 저장된 선택이 없으면 펼치고, 주간 링크는 그 주의 회의록으로 바로 이동한다. 조회로 회의록을 만들지 않는다.
|
||
주간 링크·회의록 안 주차/달 이동은 왼쪽 DOM과 스크롤을 유지하고 오른쪽 문서만 교체한다.
|
||
`?content=1`은 `_meeting_content_base.html`로 공통 메뉴 없는 회의록을 반환하며 `project-meeting-panel.js`가 부모 화면에 이동을 전달한다.
|
||
주소·뒤로/앞으로 이동·선택한 주 표시를 동기화한다. 교체 전 `PJFlushForNavigation`이 글·금액 저장을 완료하고,
|
||
실패하면 기존 회의록을 유지한다. 새 문서가 성공적으로 로드된 후 기존 문서를 제거해 편집 이벤트·타이머 중복을 방지한다.
|
||
|
||
지난주 목표·결과를 리뷰하고 월 목표를 달성하기 위한 이번주 목표·할 일을 정하는 회의(WBR — Weekly Business Review)용.
|
||
참고한 도구 방식: **WBR 지표 자동 집계**(목표 대비 누적·주당 필요 매출 = 페이싱), **Fellow·Notion 회의 템플릿의 이월**(지난 회의
|
||
항목을 다음 회의로 이어받아 나란히 리뷰), **OKR 체크인 평가**(완료/일부/미달).
|
||
|
||
- 화면 `/project/goals/{연도}/meetings/{월}?week={월요일}`(`goal_meeting.html`, `initGoalMeeting`) — 목표 표 월 머리를 누르면 열린다.
|
||
- **주차 탭**: 그 달의 주차(`store.month_weeks`) — **2026-10-07 부터 6-9-4 규칙**(그 달 안, 1주차는 1일부터, 말일 월·화는 앞 주차에).
|
||
아래 "1주차 = 첫 월요일" 설명은 예전 규칙. 다른 달의 날짜를 `?week=` 로 열면
|
||
그 달 회의록 주소로 303. 점 = 회의록 있음, "이번 주" 꼬리표. 기본 선택 = 이번 주(그 달 주면) 아니면 1주차.
|
||
‹ 이전 달 · 다음 달 › 링크, ← 목표 표.
|
||
- **월간 목표·누적은 늘 1일~말일**: 머리 숫자는 2026-10-07 부터 6-9-4(월 목표 · 월 누적 목표 · 월 누적 실적 · 누적 목표 대비 차액·%).
|
||
아래 "머리 숫자" 9칸 설명(주당 필요·전주 결과·금주 목표 등)은 예전 화면.
|
||
- 머리 배치: 왼쪽 = **[🚩 {연도}년 목표] 버튼**(연간 목표로, 큰 강조 버튼 `.pj-meet-goalbtn` — 예전 ← 화살표 대신)·제목·‹이전 달·다음 달›·
|
||
인쇄·회의록 삭제·**주차 탭(제목 줄 오른쪽 끝 = 달력 바로 왼쪽에 붙음, 한 줄짜리 작은 탭 — `1주차 10/5~11`, 같은 달이면 끝 월 생략, 전체 기간은 말풍선)**,
|
||
그 아래 **{월}월 계획**(달력 앞까지 너비), **오른쪽 위 = 작은 달력**(폭 174px, 날짜 10.5px·칸 높이 21px). 목표·회의록 제목은 32px 굵게(`h2.pj-goal-title`).
|
||
- **작은 달력**(`.pj-meet-cal`, `store.calendar_weeks`): 그 달 날짜가 든 주 전부(월요일 시작) — 앞 달에 속한 주(1일 앞쪽,
|
||
예: 10월 달력의 9/28 주)는 흐리게, 누르면 그 달(9월) 회의록. 줄 = 주(월~일) — 보고 있는 주는 영역 표시(테두리·배경),
|
||
오늘 동그라미, 토 파랑·일/공휴일(`store.KR_HOLIDAYS`) 빨강, 다른 달 날짜 흐리게, 회의록 있는 주는 왼쪽 점. 줄을 누르면 그 주 회의록
|
||
(`?week=`). 날짜 정보는 라우터가 주마다 `days`(d·in·today·wd·hol)로 넘긴다. 인쇄에선 숨김.
|
||
- **머리 숫자**(`router._meeting_view`): 월 목표 매출(목표 표 숫자 + 단위, 단위가 원/천/만/십만/백만/천만/억이면 원 환산 —
|
||
`store.sales_unit_multiplier`) · **월 누적 실적(지난주 일요일까지)** · **주당 필요 매출** = (월 목표 − 누적) ÷ 이번 주 포함 남은 주 수 ·
|
||
목표 ROAS(목표 표) / 전주 목표(바로 앞 주 회의록의 금주 목표) · **전주 결과** · 전주 달성률 · **금주 목표**(입력, 칸 안내 = 필요 매출) ·
|
||
금주 현재 실적. 실적·누적·결과는 **실적 모듈 `performance_store.daily_amounts`(대시보드 총매출과 같은 값, 매출 집계 쇼핑몰)** 에서
|
||
읽기만 한다 — 실적 모듈이 없거나 오류면 빈칸("직접 입력" 안내), 회의록은 그대로 동작.
|
||
숫자는 **한 줄 막대**(`.pj-meet-kpibar`, 칸 9개·값 15px, 좁은 화면 1300px 이하 두 줄) — 긴 설명은 말풍선(`title`).
|
||
**실적을 알 수 없으면 0 원이 아니라 "⚠ 미확인"**(6-9-3 — `head.perf_state`·`head.unknown`), 그 값에 기대는 달성 %·주당 필요 매출도 미확인.
|
||
실적 칸 말풍선 = 쇼핑몰별 마지막 갱신 성공 시각(실적 모듈 `perf_connection_status.last_success_sync_at`, `head.fresh_tip`).
|
||
- **이번주 ↔ 지난주 리뷰 순서 바꾸기**(표 왼쪽 위 [⇄ 순서 바꾸기], `initMeetOrder`): 줄마다 is-this(2칸)·is-prev(5칸) 묶음과
|
||
colgroup 을 통째로 옮긴다. 보는 사람마다 브라우저에 기억(localStorage `pj_meet_order:{로그인 이메일}`, `.pj-wrap[data-me]`).
|
||
- 표 머리 "지난주 리뷰 (MM/DD ~ MM/DD)" = 지난주 월~일(`prev_week`·`prev_week_end`) — **줄의 지난주 칸·결과·달성률·머리 전주 목표도 정확히 이
|
||
주(7일 전) 회의록만**(그 주 회의록이 없으면 머리에 "— 이 주 회의록 없음", 줄은 "지난주(MM/DD~) 회의록 없음", 회의록은 있는데 그 줄이 없으면
|
||
"지난주 회의록에 없는 줄"). 예전엔 몇 주 전 회의록 줄이 지난주 날짜 아래 보였다(점검 버그 5).
|
||
- 첫 회의록 기본 줄 마케팅 "메타"(예전 "메타(숫자)" — 017 이 그 이름 줄만 "메타"로 바꿈).
|
||
- **{월}월 계획**(`router._month_plan`, `.pj-meet-plan`, 머리 왼쪽 `.pj-meet-headleft` 안 — 제목 줄 아래·달력 왼쪽): 연간 목표 표의 그 달 열 글을 업무 영역별 작은 카드로
|
||
표시(영역 색, `항목: 글`, 빈 칸·글 없는 영역은 뺌). 굵게·기울임·밑줄·글자 색상·줄바꿈·들여쓰기를 유지하고
|
||
글자 크기만 카드 기본값을 사용(`goal_text_html(include_size=False)`), 원본 셀 서식은 변경하지 않는다.
|
||
가로 병합 칸(예: 9~10월)에 적은 글도 그 달 계획으로 보이고 범위를 오른쪽에 작게,
|
||
세로 병합은 한 번만, 묶인 줄(016 `label_cont`)은 묶음 항목 이름. 목표 표가 없으면(013 미적용) 칸 자체를 숨김, 읽기만.
|
||
- **줄**(구역 = 목표 표 업무 영역, 표의 구역 칸 rowspan): 항목 | **주요 업무**(`content`, 예전 "이번주 할 일·행사") | **정량 목표**(원, 예전 이름 "목표 금액")
|
||
‖ 지난주 리뷰: **결과**(지난주 줄 `content`, 읽기 전용 — 예전 "지난주 할 일") | **전주 목표**(지난주 줄 `target_amount`, 예전 "지난주 목표") |
|
||
**정량 목표**(지난주 줄 `result_amount` 입력, 예전 "결과"). 달성률·평가 열은 2026-10-06 요청으로 화면에서 뺐다(`status` 열·API 검증은 DB 호환으로 남음).
|
||
지난주 칸 = **7일 전 주 회의록에서 같은 연결키(`line_key`, 018)의 줄**
|
||
(예전 `carry_from` 은 이력으로만 — 6-9-3).
|
||
결과 금액은 **늘 직접 입력** — **지난 회의록 줄의 `result_amount` 에 저장**(그 주 결과는 그 주 줄에 남는다).
|
||
**줄 단위 실적 연동은 2026-10-06 요청으로 폐지** — 쇼핑몰별 지난주 자동 결과, "자동입력"/"실적 미사용" 배지, 정량 목표 아래 "이번주 실적",
|
||
줄 메뉴의 쇼핑몰 연결이 모두 없다. 실적 모듈 매출은 머리 카드(월 누적·주당 필요·전주 결과·금주 현재 실적)에만 쓴다.
|
||
`goal_meeting_items.marketplace_code` 열·만들 때 추측(`store.guess_meeting_market`)은 DB 호환으로 남아 있으나 화면에서 쓰지 않는다.
|
||
다시 그리기(`meetRepaint`)는 차례 번호(`meetRepaintSeq`)로 늦게 온 옛 화면을 버린다.
|
||
- **매출 자료 갱신**(`initMeetingSync`, **정상이면 화면 표시 없음** — 2026-10-01 상태 줄·[매출 갱신] 버튼은 요청으로 뺐다. 점검 UX 9 로
|
||
실패·일부 실패·권한 없음일 때만 숫자 막대 아래 한 줄 안내 `#pj-meet-sync.pj-meet-syncnote`(`data-state=error|partial|noperm|running`) +
|
||
[다시 시도] — 실패한 쇼핑몰 이름(상태), **서버가 기록한** 마지막 갱신 성공 시각(`data-fresh` = 매출 집계 쇼핑몰 중 가장 오래된 성공 시각,
|
||
다시 그릴 때 서버 값으로 바뀜. 브라우저 시각은 10분 제한 계산에만 쓰고 보여 주지 않음). 기록 `sessionStorage pj_meet_sync:{월요일}` =
|
||
`{at, state: ok|partial|error|noperm, bad}` — 일부 실패를 성공으로 기록하지 않고, 10분 안 다시 열면 부르지 않되 그 상태 안내는 유지.
|
||
실적 모듈 권한은 서버가 미리 알려 줘(`can_sync` → `data-can`) 권한이 없으면 API 를 부르지 않고 "권한이 없어 저장된 실적" 설명, 그래도 403 이면
|
||
noperm 으로 기억해 그 세션엔 다시 부르지 않음. 다른 업데이트에 합류(`joined`)했는데 그 작업 기간이 이 주 기간을 다 덮지 못하면 이 주 기간으로
|
||
한 번 더. 아래는 예전 설명(동작은 같음): 주차를 열면 실적 모듈 `POST /performance/api/sync {from: 지난주 월요일, to: 이번 주 일요일·오늘 중 이른 날, background: true}` 로 쇼핑몰에서 매출을 한 번 더 받고(진행 n/m 쇼핑몰·받은 자료), 끝나면 이 화면을 서버에서 다시 받아 **숫자 칸만** 바꿔 끼운다(머리 카드 — 입력 중인 칸·직접 입력 결과 칸·저장 안 된 글은 그대로). 같은 주는 브라우저별 10분에 한 번만 자동(sessionStorage `pj_meet_sync:{월요일}` — 줄 추가 등으로 새로고침해도 다시 부르지 않음), [매출 갱신] 버튼은 언제나. 이미 다른 매출 업데이트가 돌면 그 작업이 끝나길 기다린다. 실적 권한이 없으면 저장된 실적으로 보여 준다는 안내, 실패한 쇼핑몰은 이름·상태. 지난주가 아직 오지 않은 주(미래)는 갱신 줄이 없다.
|
||
- **참석자 = 전체 멤버에서 고르기**(2026-10-01): 칩(사진·이름, × = 빼기) + [참석자] 고르기 창(찾기·전원 선택·모두 해제·체크) —
|
||
후보는 `project` 모듈 권한 보유 등록 사용자(`router._meet_members`, 좌측 전체 멤버와 같음). 저장은 이메일을 쉼표로 이어 그대로
|
||
`goal_meetings.attendees`(최대 3000자), 예전 자유 입력 글자는 칩으로 남는다(`_parse_attendees`). 바뀔 때마다 바로 저장.
|
||
- **결정 사항·메모**. 인쇄 버튼(인쇄용 CSS — 사이드바·탭·도구 숨김).
|
||
- 데이터: `goal_meetings(week_start 월요일 PK, week_target 원, attendees, notes)` · `goal_meeting_items(week_start FK CASCADE, section,
|
||
section_color, label, content, target_amount, result_amount, status '', done, partial, miss, marketplace_code, carry_from FK SET NULL,
|
||
sort_order)`. 금액은 **원 정수** — 입력은 `1,200,000`·`120만`·`1.5억`·`3천만`·`1억2천만` 다 된다(`store.validate_meeting_amount`).
|
||
- **만들기**(관리자, `POST /api/goals/meetings/{월요일} {year}`, GET 에서 자동 생성 안 함): 줄이 있는 앞선 가장 가까운 회의록, 없으면 **뒤에 있는
|
||
가장 가까운 회의록**(다음 주를 먼저 만든 경우)의 줄(구역·이름·색·쇼핑몰 연결·순서)을 글 없이 이어받고 **원본 줄의 연결키(`line_key`)를 그대로**
|
||
(앞선 원본이면 `carry_from` 도 이력으로 기록), 둘 다 없으면 그 해 목표 표 업무 영역마다 **기본 양식 줄**(`store.MEETING_TEMPLATE` —
|
||
상품1~5 / 메타·구글·네이버·기타.신규 / 내용1~5 / 신규 인플루언서·콜라보·쿠팡·네이버·gs·토스·애터미·해외·오프라인·기타, 없는 구역은
|
||
빈 줄 하나). **유통** 구역 줄 이름으로 쇼핑몰 연결 추측(`store.guess_meeting_market`: 쿠팡·네이버/스마트스토어·gs·토스·11번가·카페24/자사몰·
|
||
롯데·지마켓·카카오·오늘의집 — 마케팅의 "네이버"는 광고라 연결 안 함). 줄 추가 때도 같은 추측.
|
||
- 편집(관리자, 칸별 즉시 저장 — 목표 표와 같은 권한, 공용 `createFieldSaver` 6-9-3): 글 0.8초 멈춤·칸 떠남, 금액 Enter·칸 떠남(서버 확정값을
|
||
쉼표 표기로 — 요청 뒤 다시 입력 중이면 그 초안 유지), 금주 목표 저장(`PUT` 응답에 확정 `week_target`) 뒤엔 **새로고침 없이** 머리 숫자만 서버
|
||
계산으로 다시(`meetRepaint` — 다른 칸의 저장 안 된 글 보존). 줄 작업(추가·순서·삭제)은 먼저 저장 안 된 칸을 저장하고, 실패하면
|
||
작업하지 않는다(초안 유지). **항목 우클릭·⋯ 메뉴**: 위/아래에 줄 추가 · 위로/아래로(같은 구역 안) · 줄 삭제. 구역 칸 + = 그 구역 끝에 줄, [+ 구역 추가].
|
||
줄 이름은 눌러서 그 자리에서 수정. 회의록 삭제 = 그 주 줄 전부 삭제, 다음 주 회의록의 지난주 칸은 빈다 — 그 주를 다시 만들면 같은 연결키로
|
||
다시 이어진다(새 회의록이라 글은 비어 있음, 018).
|
||
- **목표와 같은 셀 편집**: 주요 업무는 공용 `PJGoalText` 편집기·글자 서식 도구(`_cell_format.html`)를 사용한다.
|
||
글자 일부를 선택해 색·크기(10~32px)·굵게·기울임·밑줄·초기화를 적용하며, `pj-rich:v1:` 형식으로 서식을 함께 저장한다.
|
||
지난주 글·보기 전용 화면·인쇄도 허용한 서식만 출력하고, 사용자 글은 HTML escape한다. 글 길이 제한은 보이는 글 4,000자다.
|
||
목표·회의록 표에서 글·숫자·이름 입력 중 문단이 현재 칸보다 길면 해당 열 너비만 자동으로 늘리고 브라우저에 기억한다.
|
||
주간 회의록의 1열(구역)·2열(항목)은 행 높이·구역 병합·열 순서와 관계없이 항상 세로 가운데 정렬한다.
|
||
할 일·리뷰 등 내용 칸은 상단 정렬한다.
|
||
병합 칸은 나머지 열을 유지하고 오른쪽 끝 열을 늘린다. 입력 중 지워도 너비는 자동으로 줄이지 않으며, 수동 자동 맞춤으로 줄일 수 있다.
|
||
글 셀 Enter는 한 번에 개행하며 마지막 개행 뒤의 빈 줄·커서도 즉시 보인다. 빈 줄 표시용 요소는 저장 데이터에 포함하지 않는다.
|
||
`project-meeting-cells.js`는 열 경계 드래그·더블클릭/우클릭 현재·전체 열 자동 맞춤, **열 때마다 전체 열 자동 맞춤으로 시작**(2026-10-07 —
|
||
저장된 `pj_meet_col_w` 보다 우선, 글꼴 로딩 뒤 사람이 너비를 안 바꿨으면 한 번 더 맞춤),
|
||
같은 구역 글 셀 범위 선택(드래그·Shift+클릭), 내용 지우기(Del)·되돌리기(Ctrl+Z), 테두리 드래그 내용·서식 이동을 제공한다.
|
||
이동은 먼저 초안을 저장하고 원본·대상 예상값을 서버에서 비교한다. 값 변경은 409, 두 칸 변경은 한 트랜잭션으로 처리하며
|
||
응답 유실 후 같은 이동을 재전송해도 글을 다시 지우지 않는다. 열 순서 변경·75% 배율에도 논리 열 기준 너비를 유지한다.
|
||
**병합/해제(019)**는 같은 구역의 이번주 글 셀을 세로로 묶는다. 글·서식은 첫 셀에 줄바꿈으로 합치며, 해제해도 합친 글은 첫 셀에 남는다.
|
||
금액·계산값 칸은 독립적으로 유지한다. 병합 범위 안에 줄을 삽입하거나 해당 줄을 이동·삭제하려면 먼저 병합을 해제한다.
|
||
글 저장·이동·병합·줄 작업은 주차 머리를 먼저 잠가 동시 구조 변경을 직렬화한다. 019 미적용 시 병합 메뉴만 숨기고
|
||
병합 API는 503을 반환하며, 다른 셀 편집 기능은 사용할 수 있다.
|
||
- API(관리자, 조회는 `project` 권한자): `GET /api/goals/meetings/{월요일}?year=&month=`(화면과 같은 계산) · `POST|PUT|DELETE
|
||
/api/goals/meetings/{월요일}`(PUT `{week_target, attendees, notes}`) · `POST /api/goals/meetings/{월요일}/items {section, label?,
|
||
ref_item_id?, place?}` · `PUT|DELETE /api/goals/meeting-items/{id}`(PUT `{label, content, target_amount, result_amount, status,
|
||
marketplace_code}`) · `POST /api/goals/meeting-items/{id}/move {direction}`. 015 미적용 503, 월요일 아님·금액 형식 400.
|
||
셀 편집 API: `POST /api/goals/meeting-cells/move {source_item, target_item, source_body, target_body}` ·
|
||
`POST /api/goals/meeting-cells/merge {item_from, item_to}` · `DELETE /api/goals/meeting-items/{id}/cell-merge`.
|
||
|
||
### 6-9-4. 새 주차 · 위쪽 고정 영역 · 지난주 결과 글 · 주차별 매출 목표 (마이그레이션 020, 2026-10-07)
|
||
|
||
- **주차**(`store.month_weeks` — 6-9-2·6-9-3 의 "월요일~일요일 / 7일 전" 설명을 대신한다): 주차는 **그 달 안**에서만 나눈다.
|
||
1일이 월~금이면 1주차 = 1일 ~ 그 주 일요일, 1일이 토·일이면 1주차 = 1일 ~ 다음 주 일요일, 그 뒤 월~일,
|
||
**말일이 월·화이면 그 하루·이틀은 앞 주차에 붙는다**. 예: 2026-10 = 10/1~4 · 5~11 · 12~18 · 19~25 · 26~31,
|
||
2026-08 = 8/1(토)~9 · 10~16 · 17~23 · 24~31(월). 헬퍼: `week_period(날짜)` · `prev_week_period(시작일)`(= "지난주",
|
||
앞 달 마지막 주차일 수 있음) · `week_number` · `validate_period_start`(새 회의록·주차 목표는 주차 시작일만).
|
||
회의록 `week_start` = 주차 시작일(월요일이 아닐 수 있음). 화면 `?week=` 에 아무 날짜(예전 월요일 주소)를 주면 그 날짜가 든 주차로.
|
||
작은 달력은 월요일 시작 줄 그대로, 줄을 누르면 그 줄의 이 달 날짜가 든 주차(한 주차가 두 줄일 수 있음).
|
||
- **지난주** = 바로 앞 주차(`db.get_meeting` 이 `store.prev_week_period` 로 찾음) 회의록의 같은 연결키 줄.
|
||
- **머리 영역 3칸**(2026-10-07 개편, 아래 "위쪽 고정 영역" 설명을 대신함): 제목 줄 아래 `.pj-meet-board`(머리 `.pj-meet-headgrid` 안 —
|
||
`.pj-meet-pane` 밖이라 표를 스크롤해도 늘 보임, 칸 높이 230px·안에서 스크롤) = ① 월 계획(`router._month_plan`) + 머리 줄 오른쪽에
|
||
숫자 4개를 작게 1행(`.pj-meet-kpiline` — 월 목표 · 누적 목표 · 누적 실적 · 목표 대비, 클래스는 `.pj-meet-kpi` 그대로라 `meetRepaint` 가 갱신)
|
||
② 결정 사항·메모(`#pj-meet-notes`, 회의록이 있을 때) ③ **작업 등록 표**(`#pj-meet-quick`, `initMeetQuickTasks`): 제목 | 담당자 | 프로젝트 | 섹션 |
|
||
[적용]. 빈 칸을 누르면 `showContextMenu`(body) 목록 — 프로젝트 = `GET /api/projects` 의 최상위(내가 멤버인 것), 고르면 첫 섹션 자동,
|
||
담당자 = 그 프로젝트 멤버+소유자(`GET /api/projects/{id}/members`, 프로젝트 전이면 `PJ_MEET_MEMBERS`; 프로젝트를 바꿔 멤버가 아니면 비움),
|
||
섹션 = `GET /api/projects/{id}/stages`. [적용] = `POST /api/projects/{id}/tasks {title, stage_id, assignee_email}`(서버가 멤버·담당자 권한 검사)
|
||
→ 줄에 "등록됨" 링크(`/project/p/{id}?task=`) + 삭제(확인 뒤 `DELETE /api/tasks/{id}` — 그 프로젝트 작업도 삭제, 휴지통, 이미 없으면 줄만 지움),
|
||
적용 전 줄의 × = 줄만 지움. 줄(등록된 줄 포함)은 localStorage `pj_meet_quick:{이메일}`. 예전 `#pj-meet-top`(pane 안 sticky)은 없앴다.
|
||
- (예전) **위쪽 고정 영역**(`#pj-meet-top`, `.pj-meet-pane` 안 sticky): 왼쪽 절반 숫자 4칸 — **월 목표 매출**(목표 표, = 주차 목표 합) ·
|
||
**월 누적 목표 매출**(주차별 목표 1주차~이 주차 합, 원) · **월 누적 실적**(1일 ~ 오늘, 지난 주차면 그 주차 끝날 — 실적 모듈) ·
|
||
**누적 목표 대비 달성**(실적 − 누적 목표 차액 + 실적 ÷ 누적 목표 %) / 오른쪽 절반 **결정 사항·메모**(예전엔 표 아래).
|
||
표 머리 줄 sticky top = 이 영역 높이(`--pj-meet-top-h`, `initMeetTop` 의 ResizeObserver). 예전 9칸(주당 필요·목표 ROAS·전주 목표·
|
||
전주 결과·전주 달성률·금주 목표 입력·금주 현재 실적)은 없앴다(`goal_meetings.week_target` 열·API 는 남음). `head` 키:
|
||
`month_target_won · week_targets_set · cum_target · cum_target_won · mtd · mtd_end · gap · rate · prev_exists · perf* · unknown · fresh*`.
|
||
- **표 열**: 구역 | 항목 | 주요 업무 | 정량 목표 ‖ 지난주 리뷰: **전주 업무**(지난 주차 `content`) | **결과**(글, 지난 주차 줄
|
||
`result_note` — 020, `.pj-meet-rnote` textarea, 0.8초 멈춤·칸 떠남 저장, 초안 `pj_draft:meet:item:{지난 줄}:result_note`) |
|
||
**전주 목표**(지난 주차 `target_amount`) | **결과**(금액, 지난 주차 `result_amount`). 020 미적용이면 결과 글 칸은 보기만, API 503.
|
||
- **주차별 매출 목표**(`goal_week_targets(week_start PK, year FK goal_years CASCADE, month, value NUMERIC)` — 목표 표 매출 단위 그대로):
|
||
연간 목표 표 매출 **목표** 월 칸(`data-weekly`, readonly)을 누르면 그 달 입력 창(`.pj-goal-wkpop`, body 에 붙음, 보기만 하는 사람은 값만).
|
||
맨 위 **월 전체 목표**(직접 입력) → 주차별 목표 → 맨 아래 **주차 합계**·**차이(월 목표 − 주차 합계**, + 주황 = 덜 나눔,
|
||
− 빨강 = 넘침, 0 초록). `PUT /project/api/goals/{연도}/week-targets/{월} {month: 월 목표|"", weeks: {주차 시작일: 값|""}}`
|
||
(관리자) → 주차 저장 + `goal_metrics(sales, target)` 에 `month` 그대로(빈값 = 지움, 주차 합계와 무관). `month` 가 없는 요청(예전
|
||
화면 캐시)만 주차 합계를 월 목표로. 020 미적용이면 예전처럼 월 칸 직접 입력.
|
||
- **020 마이그레이션**(`scripts/sql/project_db_020_meeting_periods.sql`, 멱등): ① `goal_meeting_items.result_note` ② `goal_meetings`
|
||
월요일 CHECK 제거 ③ `goal_week_targets` ④ 새 주차에 흡수된 월요일 회의록(1일이 토·일인 달의 2·3일 월요일 → 1일, 말일이 월·화인 달의
|
||
마지막 월요일 → 7일 전 월요일)을 옮김 — 옮길 자리에 회의록이 있으면 옮기지 않고 NOTICE. 이미 쓰던 9/28(월) 회의록은 9월 마지막 주차
|
||
(9/28~30)로 그대로 남고, 10월 1주차(10/1~4)는 새로 만든다(그래서 10/5 주차의 지난주 리뷰는 10/1~4 회의록이 생겨야 채워진다).
|
||
- 코드는 020 전에도 동작(결과 글 보기만, 주차 목표 없음, 월요일 아닌 주차 회의록 만들기만 503 안내).
|
||
- **회의록 보드**(2026-10-07): 참석자 오른쪽 [회의록 보드] → 그 주차의 **빈 Google 슬라이드**를 독립 창(`window.open` popup, 창 이름
|
||
`pj_meet_board_{주차}`)으로. 누르는 순간 빈 창을 먼저 열고(팝업 차단 회피) `POST /project/api/goals/meetings/{주차 시작일}/board`
|
||
(프로젝트 권한자 누구나) 가 준 주소로 바꾼다. 서버(`app/integrations/google_slides.py`)는 공유 드라이브 `MEETING_BOARD_FOLDER_ID`
|
||
(기본 0AGF3CIEboPQiUk9PVA)에서 Drive appProperties `dbxMeetingWeek = 주차 시작일` 인 슬라이드를 찾고, 없으면 만든다 —
|
||
이름 `{월}월 {n}주차 ({기간})`(`router.meeting_board_title`), 첫 장의 제목·부제목 틀(TITLE 레이아웃)을 지우고 틀 없는 BLANK 한 장만.
|
||
파일 이름을 바꿔도 같은 보드, 휴지통에 버리면 다음에 새로 만든다. 인증은 Google 시트 설정 재사용 + Drive·Slides 범위
|
||
(`GOOGLE_SLIDES_OAUTH_REFRESH_TOKEN` 없으면 시트 토큰 — Drive·Slides 권한으로 재발급 필요, docs/DEPLOYMENT.md). DB 변경 없음.
|
||
- **회의록 누구나 수정 · 회의 완료 잠금**(마이그레이션 022, 2026-10-07): 회의록 만들기·머리 칸·줄 추가/삭제/이동·셀 이동/병합·줄 칸 API 가
|
||
`_require_admin` → `_require_user`(프로젝트 권한자 누구나). 회의록 삭제와 `POST /api/goals/meetings/{주차}/complete {done}`(회의 완료·완료 해제)만
|
||
Pro user 이상(2026-10-12, 예전 관리자). `goal_meetings.completed_at`·`completed_by` 가 있으면 잠금 — `db._check_meeting_open`(머리 칸·줄 추가·`_locked_meeting_items`)이
|
||
`store.MeetingLocked` → 409. 예외: 줄 칸 변경이 결과(`result_note`·`result_amount`·`status`)뿐이면 그 줄의 회의록이 아니라 **바로 다음 주차
|
||
회의록**(그 결과를 적는 회의)의 잠금을 본다. 화면은 `data-edit`(완료 전이면 누구나) 로 편집 도구를 켜고, Pro user 이상에게 [회의 완료]/[완료 해제],
|
||
완료면 "🔒 회의 완료" 표시. 022 전이면 완료 버튼 없음(`meeting.can_complete`).
|
||
- **알림 팝업**(2026-10-07): 나를 태그(mention)하거나 작업을 배정(assigned)받으면 프로젝트 화면 가운데 아래에 깜박이는 큰 팝업(`initTaskAlerts`,
|
||
`.pj-alert-pop`, body 에 붙음) — [닫기] 전까지 남는다. 20초마다(창을 다시 볼 때 바로) `GET /api/notifications/alerts?after=본 것`(읽지 않은
|
||
mention·assigned 중 after 보다 새 것, 지금 볼 수 있는 작업만, 오래된 것부터 10). 본 것 = localStorage `pj_alert_seen:{이메일}`, 처음 쓰는 브라우저는
|
||
latest_id 를 기준으로 삼아 옛 알림을 한꺼번에 띄우지 않는다. 다른 탭에서 닫으면 storage 이벤트로 함께 닫힌다. 수신함 iframe 안에선 돌지 않는다.
|
||
- **섹션 색 없앰**(2026-10-07): 보드 섹션 머리는 모두 `#f3f3f3`(`STAGE_HEAD_BG`), 섹션 편집 창의 색 고르기 삭제(저장 때 color 를 보내지 않는다),
|
||
타임라인 줄 색은 프로젝트 색. DB 의 `project_stages.color` 값은 남아 있지만 화면에서 쓰지 않는다.
|
||
- **정량 목표·결과(금액)에 글**(마이그레이션 021, 2026-10-07): 입력이 숫자로 읽히면(`store.validate_meeting_amount` — 1,200,000 · 120만 ·
|
||
1.5억) 지금처럼 `target_amount`/`result_amount`(원 정수), 아니면(예: "20개", 100자까지) `target_text`/`result_text` 에 — 둘 중 하나만
|
||
채운다(숫자로 바꾸면 글은 비움). 화면·전주 목표는 글이 있으면 글, 없으면 쉼표 숫자. 021 전이면 글은 예전처럼 400(숫자 오류).
|
||
입력칸은 `inputmode` 없음(글 키보드). 같은 날 함께 고침: `PUT /api/goals/meeting-items/{id}` 허용 키에 `result_note` 가 빠져
|
||
결과 글이 저장되지 않던 문제.
|
||
|
||
### 6-9-3. 저장 안전장치 · 지난주 연결 · 실적 미확인 (2026-10-01 점검 반영 — `docs/reviews/GOALS_MEETINGS_REVIEW_2026-10-01.md`, 마이그레이션 018)
|
||
|
||
**칸별 자동 저장 `createFieldSaver`**(project.js 공용, 목표 표 글·숫자 + 회의록 글·메모·금액·금주 목표 — 버그 1·2·3)
|
||
- 칸마다 `{saved, chain, busy, timer, failed}`. **saved = 성공한 요청에 실어 보낸 값**만(응답 때 바뀌어 있는 화면 값을 저장됨으로 보지 않음).
|
||
- **같은 칸 요청은 직렬화** — 앞 요청이 끝나야 다음 요청을 보내므로 서버에 닿는 쓰기 순서 = 보낸 순서(늦은 옛 요청이 최신 값을 덮지 못함, 응답만
|
||
버리는 방식이 아님). 다음 요청은 보낼 때의 최신 초안을 읽어 진행 중에 새로 쓴 값도 뒤이어 저장. 앞 요청이 없으면 그 자리에서(동기) 보낸다.
|
||
- 응답 반영: 서버 표기(쉼표·원 정수)는 **요청 뒤 초안이 그대로일 때만** 칸에 넣는다(`onSaved(..., same)`). 실패하면 초안·dirty 유지 +
|
||
빨간 테두리(`is-save-failed`, 말풍선) + 토스트 — 다음 입력·칸 떠남·Enter·`flushAll` 이 다시 보낸다. 숫자 Esc = 저장된 값.
|
||
- `flushAll()` = 대기 타이머 + 진행 중 요청 + 실패했던 칸까지 기다리고 하나라도 실패하면 reject. 목표 표 구조 작업(영역·줄 추가/이동/삭제,
|
||
병합/해제)과 회의록 줄 작업은 **먼저 flushAll — 실패하면 구조 요청·표 교체를 하지 않는다**. 목표 표 구조 작업은 한 번에 하나(`withStruct`).
|
||
- 목표 표 `refreshTable`: 시작 전 flush(실패 = throw), 표를 받는 사이 새로 입력한 글이 있으면 저장 후 다시 받기(최대 3번, 바꿔 끼우기 직전 검사는
|
||
동기라 그 사이 입력 불가), 계속 입력 중이면 바꿔 끼우지 않고 `pendingRefresh` — 저장이 끝나면 다시 그린다. 이름 고치는 중이어도 기다림.
|
||
- **초안 백업** — 글 칸은 입력할 때마다 `localStorage pj_draft:goal:{줄}:{칸}` · `pj_draft:meet:item:{id}:content` · `pj_draft:meet:notes:{월요일}` =
|
||
`{base(서버에 저장된 값), draft, at}`, 저장되면 지움(14일 지난 것은 열 때 정리). 다시 열 때 **서버 값 = base 면 되살려 다시 저장**, 서버 값이 바뀌었으면
|
||
(다른 사람·다른 창) 되살리지 않고 안내.
|
||
- **페이지 떠남**(`beforeunload`): 진행 중 요청이 없는 dirty 글 칸은 `keepalive` PUT 으로 한 번 더 보낸다 — **브라우저가 끝까지 보낸다는 보장은 없어서**
|
||
초안 백업이 함께 남는다(keepalive 도 같은 칸 줄에 들어가 순서가 섞이지 않음). 실패했던 칸·진행 중 요청이 있는 칸·Enter 전 숫자 칸이 있으면 브라우저
|
||
이탈 경고. 저장이 다 끝났으면 경고 없음.
|
||
|
||
**지난주 연결 — 연결키 `goal_meeting_items.line_key`(마이그레이션 018, 버그 4·5)**
|
||
- 왜 키인가: 이름(label) 비교는 같은 이름 줄(기타·빈 이름)·다른 구역 같은 이름(마케팅/유통 "네이버")·이름 변경에서 다른 줄 결과가 섞인다.
|
||
`carry_from`(앞선 회의록 줄 id)은 만들 때 한 방향으로만 생겨 역순 생성·앞 주 삭제/재생성(ON DELETE SET NULL)에서 끊긴다.
|
||
키는 **회의록을 만들 때 원본 줄 키를 그대로 이어받고 새 줄은 새 키** → "지난주" = `week_start − 7` 회의록의 같은 키 줄(UNIQUE `(week_start, line_key)`),
|
||
생성 순서·이름 변경·순서 이동과 무관, 한 줄이 두 줄에 붙지 않는다.
|
||
- 만들기 원본: 앞선 가장 가까운(줄 있는) 회의록 → 없으면 뒤의 가장 가까운 회의록 → 둘 다 없으면 양식(새 키).
|
||
- **018 적용 전**에도 코드는 동작 — `_meeting_keys` 가 칸 유무를 보고, 없으면 `carry_from` 을 쓰되 **가리키는 줄이 정확히 7일 전 주일 때만** 지난주로
|
||
(버그 5 는 적용 전에도 고침, 역순 생성 연결(버그 4)은 018 필요). 018 은 `line_key` 기본값(랜덤 키)을 두어 **코드 배포 전에 적용해도** 예전 코드의
|
||
줄 추가가 실패하지 않는다(그 줄은 연결 없이 새 키).
|
||
- **018 의 기존 데이터 채우기(자동 복구 범위)**: `carry_from` 사슬을 따라 같은 키(뿌리 = 사슬 맨 앞 줄, `md5('goal_meeting_item:'||id)::uuid` 라 다시 돌려도
|
||
같은 키). → 같은 원본(예: 9/14)에서 이어받은 9/28(먼저 만듦)·9/21(나중에 만듦) 줄은 자동으로 다시 이어진다. 이름 바꾼 줄도 사슬이면 이어진다.
|
||
**자동으로 잇지 않는 것**: `carry_from` 이 없는 줄(첫 회의록 양식 줄·줄 추가·앞 주 삭제로 끊긴 줄) — 이름이 같아도 붙이지 않는다.
|
||
예: 9/21·9/28 을 둘 다 앞선 회의록 없이 양식으로 만들었다면 연결 안 됨. 이런 쌍은 `scripts/sql/project_db_018b_meeting_line_link_candidates.sql`
|
||
(**조회만**)로 "정확히 7일 차이 + 같은 구역·같은 이름이 양쪽 주에 각각 한 줄씩만 + 아직 연결 안 됨" 후보를 보고, 사람이 확인한 쌍만 그 파일 안
|
||
주석의 UPDATE 로 따로 잇는다(운영 적용은 별도 승인·백업 후). 한 주 안 같은 키(정상 데이터엔 없음)는 순서가 뒤인 줄에 새 키.
|
||
- 적용(운영은 백업·승인 후, 여러 번 돌려도 안전):
|
||
```bash
|
||
docker exec -i postgres-db psql -U postgres -d project_db < scripts/sql/project_db_018_meeting_line_keys.sql
|
||
docker exec -i postgres-db psql -U postgres -d project_db -c \
|
||
"SELECT count(*) AS total, count(line_key) AS keyed FROM goal_meeting_items;" # total = keyed
|
||
docker exec -i postgres-db psql -U postgres -d project_db < scripts/sql/project_db_018b_meeting_line_link_candidates.sql # 후보 조회만
|
||
```
|
||
적용 전 확인(조회만): `SELECT week_start, count(*) FILTER (WHERE carry_from IS NULL) AS no_link, count(*) FROM goal_meeting_items GROUP BY 1 ORDER BY 1;`
|
||
|
||
**실적 미확인(버그 6)** — `router._MeetingPerf`: `state` = `off`(실적 모듈 미연결) · `error`(쇼핑몰 목록 조회 실패) · `empty`(매출 집계 쇼핑몰 없음) · `ok`.
|
||
조회 실패한 값은 None + `head.unknown`(`mtd`·`prev_result`·`week_result`, 기간마다 따로 → 부분 실패), 화면 "⚠ 미확인", 그 값에 기대는 달성 %·주당 필요
|
||
매출도 계산하지 않음. 정상 조회 0건만 0원. 줄 결과는 자동이 아니라 늘 직접 입력.
|
||
`head.perf` 는 예전 뜻(실적 모듈 연결 여부) 그대로 — 갱신 상자·"연결되지 않아" 문구 조건. 회의록 열기·직접 입력은 그대로.
|
||
|
||
**테스트** — `tests/test_project_module.py`(`test_meeting_prev_week_links`: 역순 생성·같은 이름·다른 구역 같은 이름·이름 변경·이동·새 줄·삭제/재생성·
|
||
건너뛴 주, 018 적용/미적용 둘 다 · `test_meeting_perf_unknown_vs_zero`: 미연결·목록 장애·매출 장애·부분 실패·정상 0·집계 쇼핑몰 없음),
|
||
`tests/test_meeting_line_keys_migration.py`(018 백필·멱등·UNIQUE — 임시 스키마, 끝에 ROLLBACK), `tests/js/goals_meeting_ui.test.js`
|
||
(`python tests/js/render_goals.py` 후 — 버그 1·2·3·5·6·7, UX 8·9, 분기 접기·열 너비·스크롤·참석자 회귀).
|
||
|
||
## 6-10. 권한·저장 안전장치 (2026-09-30 점검 반영, 새 마이그레이션·환경변수 없음)
|
||
|
||
**권한 공통 기준 — `access.py`** (라우터·마감 알림이 같은 규칙)
|
||
- 프로젝트 관리 = 관리자 · owner · 배정 멤버, 모두 `project` 모듈 권한이 있어야 한다(`can_manage_project`).
|
||
- 작업 권한 `task_access`: **FULL** = 원 소속 프로젝트 관리 가능 / **READ** = 원 소속 권한은 없지만 이 작업(또는 상위 작업)이
|
||
연결된 프로젝트를 관리 가능(`task_link_scope`, 재귀 CTE) / 없음. 라우터 `_require_task(write=)` 가 FULL/READ 를 검사.
|
||
- READ 로 되는 것: 작업 상세(`access:"read"`)·하위 작업 목록·댓글 목록·첨부 목록/다운로드/미리보기·공유 링크(연결된 프로젝트
|
||
화면으로 이동). 안 되는 것: 제목·설명·담당자·완료·섹션(원 소속)·댓글/답글/반응·첨부 추가/삭제·협업자·삭제·하위 작업 변경.
|
||
이미 연결된 작업을 연결된 프로젝트 안에서 섹션 이동(`POST /links`)은 예전처럼 허용, 새 연결은 양쪽 권한. 상세의 `links` 는
|
||
내가 볼 수 있는 프로젝트만(다른 연결 프로젝트 이름도 숨김), `followers` 는 READ 면 null. 원 소속의 다른 작업·멤버는 계속 403.
|
||
- 목록·배지·알림: 내 작업(`_my_visible_tasks`/`_my_open_count`)·수신함 태그(`_safe_mentions`)·알림(`_visible_notifications`)을
|
||
지금 권한으로 거른다(FULL 또는 READ). 기존 기록은 지우지 않는다.
|
||
- 알림·메일·멘션 수신자: `filter_recipients` — 지금 그 작업을 볼 수 있는 등록 사용자만(담당자·협업자여도 권한을 잃었으면 제외).
|
||
@태그는 볼 수 없는 사람(비멤버·권한 회수·미등록 이메일)을 기록·알림·자동 협업자 등록 없이 건너뛰고 응답 `mention_skipped` 로
|
||
알려 준다(payload 에 이메일을 직접 넣어도 같음). 멘션이 권한을 만들지 않는다. 태그 후보 `GET /api/all-users?task_id=`.
|
||
- 새 담당자는 그 프로젝트를 볼 수 있는 사람만(`_check_assignee`, 400). 비우거나 예전 값 유지는 허용.
|
||
- 댓글 수정·삭제도 지금 원 소속 권한이 있어야 한다(작성자라도 멤버에서 빠지면 403). 첨부는 본인 댓글에만 붙일 수 있다.
|
||
|
||
**저장·동기화**
|
||
- 작업 창 세대(`taskGen`): 창을 열 때마다 +1. 상세·하위 작업·연결·첨부·댓글·담당자 후보·저장 결과는 요청 때 세대를 잡고, 돌아왔을
|
||
때 다르면 반영하지 않는다(A→B, A→B→A). 하위 작업·연결 블록도 자체 `ctxSeq` 로 늦은 응답을 버리고, 추가·연결은 누른 순간의
|
||
작업 id 로 보낸다. 설명 이미지 업로드는 시작한 작업·세대가 바뀌었으면 설명에 넣지 않는다(파일은 원래 작업 첨부로 남음).
|
||
- 자동 저장(`saveField`)은 성공/실패를 돌려준다. 실패한 칸은 `failedFields` 에 남고 "저장 실패 · 다시 시도"(눌러 재시도).
|
||
닫기·Esc·다른 작업 열기(`openTaskModal` → `settleBeforeLeave`)는 이미지 업로드·만들기·저장 큐가 끝나길 기다리고 실패한 칸을
|
||
한 번 더 보낸 뒤, 그래도 실패하면 "버리고 넘어가기 / 계속 편집"을 묻는다. 버리기를 고를 때만 초안을 버린다(`discardTaskEdits`).
|
||
저장 성공 뒤 화면 다시 그리기 오류는 저장 실패로 표시하지 않는다. 미저장(실패·대기·업로드 중)일 때만 페이지 이탈 경고.
|
||
- 읽기 전용 작업 창: 제목·설명·담당자·섹션·우선순위·마감일 잠금, 완료·삭제·댓글 입력·첨부 추가·서식 도구·하위 작업 추가·
|
||
연결 추가/해제 숨김, 안내줄 `#pj-t-readonly`. 댓글 대화창도 `GET /comments` 의 `access` 로 입력칸을 숨긴다.
|
||
- 실시간 동기화(`initLiveRefresh`): `observed`(서버에서 본 버전)와 `applied`(화면에 반영 성공한 버전)를 나눈다. 반영이
|
||
성공해야 applied 를 올리고, 실패하면 다음 주기(8→16→32→60초)에 같은 버전을 다시 받는다. 동기화 중엔 겹쳐 돌지 않고, 늦게 온
|
||
응답은 버린다(`syncSeq`). 프로젝트 화면은 `GET /api/projects/{id}/snapshot?scope=all` — 화면이 들고 있는 범위(볼 수 있는 모든
|
||
최상위 프로젝트의 작업·섹션·프로젝트 목록)를 통째로 바꿔 끼운다(다른 프로젝트의 생성·삭제·섹션 변경·권한 회수 반영, 멀티호밍은
|
||
`context_project_id` 별 한 행). 이 프로젝트 권한을 잃으면(403) 작업을 비우고 창을 닫고 안내줄 `.pj-access-lost`.
|
||
- 날짜: 업무 기준 "오늘" = 한국시간(`kstTodayIso`, UTC+9 고정) — 대시보드 지연 수·마감 색·오늘/내일·내 작업 필터가 브라우저
|
||
시간대와 무관하게 서버(`today_kst`)·마감 알림과 같다.
|
||
|
||
**댓글 파일** — 파일이 있는 댓글은 `POST /api/tasks/{id}/comments/files`(multipart: `files[]`·`body`·`parent_id`·`mentions`(JSON)·
|
||
`client_token`) 한 요청으로, 댓글+첨부를 한 트랜잭션(`add_comment_with_attachments`)에 만든다. 빈 파일·20MB 초과가 하나라도
|
||
있으면 아무것도 만들지 않고 400 `detail.failed=[{index,name,reason}]` → 화면은 그 파일만 빨갛게 표시하고 입력·파일을 유지.
|
||
DB 실패면 방금 쓴 파일도 지운다. 글 댓글(`POST /comments`)은 본문 필수 — 예전 `has_attachment` 플래그는 받지 않는다.
|
||
`client_token` 으로 같은 댓글의 재전송(응답 유실·연타·동시 요청)은 10분간 첫 결과를 돌려준다(웹 프로세스 메모리 — 보장 범위는 6-15).
|
||
작업 창 댓글 목록도 댓글별 첨부(이미지 미리보기·파일명 다운로드, 이스케이프)를 보여 주고, 첨부 파일 목록엔 "댓글" 표시.
|
||
|
||
**마감 알림** — `add_reminder_notification`: 발송 기록(`task_reminders`)과 수신함 알림을 한 트랜잭션에. 알림 생성이 실패하면
|
||
기록도 되돌려져 다음 실행에서 다시 시도, 동시 실행도 UNIQUE 로 한 번만. 수신자는 지금 볼 수 있는 사람만. 보장 범위는 수신함
|
||
알림까지 — 메일(`PROJECT_REMINDER_EMAIL`)은 새로 만든 알림만 요약해 보내고 메일 실패는 재시도하지 않는다.
|
||
|
||
**완료 섹션에 바로 만든 작업** — `create_task` 가 완료 섹션이면 `completed_at`·완료 이력(1건)을 넣고, 라우터가 완료 섹션 이동과
|
||
같은 완료 알림(`_notify_completed`)을 보낸다. 섹션 없는 하위 작업·수동 완료/취소는 그대로.
|
||
|
||
**테스트** — `tests/test_project_module.py`(로컬 테스트용 PostgreSQL + FastAPI TestClient, `PROJECT_TEST_DB_URL` 가
|
||
localhost 일 때만), `tests/js/project_ui.test.js`(jsdom, `python tests/js/render_project.py` 후 실행, `PJ_TEST_TZ` 로 해외 시간대).
|
||
프런트 테스트 훅은 `window.__PJ_TEST__` 가 있을 때만 열린다.
|
||
|
||
**기존 데이터 점검(조회만 — 운영 교정은 따로 승인 후)**
|
||
```sql
|
||
-- 시작일 > 마감일(프로젝트·작업), 같은 날 시각 역전
|
||
SELECT id, name, start_date, due_date FROM projects WHERE start_date > due_date;
|
||
SELECT id, project_id, title, start_date, due_date, start_time, due_time FROM tasks
|
||
WHERE start_date > due_date OR (start_date = due_date AND start_time > due_time);
|
||
-- 본문도 첨부도 없는 빈 댓글(예전 파일 업로드 실패 흔적)
|
||
SELECT c.id, c.task_id, c.author_email, c.created_at FROM task_comments c
|
||
WHERE btrim(c.body) = '' AND NOT EXISTS (SELECT 1 FROM task_attachments a WHERE a.comment_id = c.id);
|
||
-- 완료 섹션에 있는데 미완료인 작업(예전 완료 섹션 직접 생성)
|
||
SELECT t.id, t.title FROM tasks t JOIN project_stages s ON s.id = t.stage_id
|
||
WHERE s.is_done_stage AND t.completed_at IS NULL;
|
||
```
|
||
교정안: 날짜 역전은 담당자와 확인해 한쪽을 고치고, 빈 댓글은 작성자 확인 후 삭제, 완료 섹션 미완료는 완료로 표시하거나 섹션을 옮긴다.
|
||
권한을 잃은 사람의 담당자·멘션·협업자 기록은 지우지 않아도 된다(화면·알림은 이미 지금 권한으로 거른다).
|
||
|
||
## 6-11. PC 알림 프로그램 (마이그레이션 023, 2026-10-08)
|
||
|
||
웹 큰 팝업(`initTaskAlerts`)은 브라우저 탭이 보일 때만 뜬다. 브라우저가 뒤에 있어도 같은 알림을 PC 화면 위에 크게 띄우는
|
||
Windows 트레이 프로그램 **DBX 알림**(`desktop/notifier/`, C# .NET Framework 4.8 WinForms, exe 하나). 빌드·배포·백신 주의는
|
||
`desktop/notifier/README.md`.
|
||
|
||
- **연결(토큰)**: 브라우저 쿠키를 쓸 수 없어 PC마다 토큰. ① 프로그램 `POST /project/api/notifier/link/start {device}`(로그인
|
||
없음 → 화면 코드 `XXXX-XXXX` + poll 비밀값, 10분, 대기 200건 상한 429) → ② 브라우저 `/project/notifier?code=`(로그인 필요,
|
||
없으면 `/login?next=`)에서 PC 이름·코드 확인 후 [연결] = `POST .../link/approve {code}` → ③ 프로그램 `POST .../link/poll {poll}`
|
||
→ `pending`/`expired`/`ok`(토큰 **한 번만**). `notifier_links`·`notifier_tokens` 에는 poll·토큰 **SHA-256 만** 저장.
|
||
PC 쪽 토큰은 Windows DPAPI(현재 사용자)로 암호화해 `%APPDATA%\DBXNotifier\settings.json`.
|
||
- **알림**: `GET /project/api/notifier/alerts?after=` (`Authorization: Bearer`) — 웹 `/api/notifications/alerts` 와 같은
|
||
`_alerts_payload`(태그·배정, 읽지 않은 것, 지금 볼 수 있는 작업만) + `name`. 토큰마다 **지금** 사용자 레코드·`project` 권한을
|
||
다시 확인(해제·권한 회수 = 401 → 프로그램이 연결 끊김 안내). `POST .../alerts/{id}/read`, `POST .../logout`(토큰 해제).
|
||
- **프로그램 동작**: 20초마다 확인(절전 해제 시 바로). 처음 연결하면 최신 번호를 기준으로(옛 알림 몰아 띄우지 않음),
|
||
새 번호가 오면 마우스가 있는 화면 아래 가운데에 웹과 같은 모양의 큰 창(맨 위, 포커스 안 뺏음, 보라↔주황 깜박임, 최대 6줄 +
|
||
"외 N건 더") + 알림 소리. [열기] = 기본 브라우저로 작업 + 읽음, [닫기] = 그 번호까지 본 것으로(PC 설정 `last_seen`).
|
||
웹에서 읽은 알림은 다음 확인 때 창에서 빠진다. 웹 팝업의 "본 것"(localStorage)과는 따로다.
|
||
- **화면** `/project/notifier`(수신함 머리의 [PC 알림 프로그램 설치] 버튼으로 들어감, 사이드바는 수신함 활성): 연결 승인 카드, 설치 안내, 내 연결된 PC 목록·[연결 해제]
|
||
(`POST /project/api/notifier/devices/{id}/revoke`). 내려받기 `GET /project/notifier/download` = 서버
|
||
`DATA_DIR/notifier/DBXNotifier.exe`(컨테이너 `/data/notifier/`) — 파일이 없으면 버튼 대신 "관리자에게 받으세요".
|
||
- **웹 팝업 쉬기**: 그 사용자의 PC 알림 프로그램이 돌고 있으면(해제 안 된 토큰 중 `last_seen_at` 3분 안 — `st.notifier_active`)
|
||
웹 `/api/notifications/alerts` 는 알림 없이 `latest_id` + `desktop: true` 만 준다. 웹은 그 번호까지 본 것으로 두므로, 프로그램을 끄면
|
||
3분쯤 뒤 그 뒤에 온 알림부터 웹 팝업이 다시 뜬다. 사용자 단위(어느 PC 에서 켰든 모든 브라우저 팝업이 쉼). 확인 실패면 웹 팝업 그대로.
|
||
- 023 미적용이면 화면은 안내만, notifier API 는 503.
|
||
|
||
## 6-12. 아사나 아이콘 · 색 12열 · 섹션 굵게 · 전체 보기 메뉴 · 설명란 글자 색/크기 (2026-10-08, 마이그레이션 없음)
|
||
|
||
- **프로젝트 색상표** 12칸씩(32색 = 3줄). **아이콘** 머리 "아이콘" 오른쪽 탭 [기본 아이콘](`PROJECT_ICONS`, 외곽선) /
|
||
[아사나 아이콘](`PROJECT_ASANA_ICONS` 33개, 채워진 모양). 아사나 아이콘 값은 `"asana:" + 이름`(`projects.icon` TEXT 그대로),
|
||
`validate_project_icon` 이 두 목록만 허용. 채워진 모양은 그 33개만 담은 글꼴
|
||
`static/vendor/material-symbols/material-symbols-asana.woff2`(Google Fonts `FILL 1` + `icon_names=` 부분 글꼴, 약 6KB) —
|
||
`.material-symbols-outlined.pj-ic-asana`. 목록을 늘리면 글꼴도 그 이름들로 다시 받는다. 그리는 곳: `projIconSpan`(JS)·
|
||
`_side.html`·`project.html` 제목 알약.
|
||
- **섹션 이름 굵게**(보드 `.pj-col-name`, 목록 묶음 `.pj-list-group-name`, 이름 바꾸기 칸).
|
||
- **전체 보기**: 프로젝트 화면 오른쪽 위 범위 토글(`#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 에서
|
||
`color`(#hex·rgb()) 와 `font-size`(`DESC_FONT_SIZES`)만 다시 조립해 남긴다(`desc_inline_style`). 멘션 칩·다른 태그의 style 은 버림.
|
||
|
||
## 6-13. 수신함 줄 클릭 · 용어 · 회의록 보드 링크 복사 (2026-10-08, 마이그레이션 없음)
|
||
|
||
- **수신함**: `inbox_page` 는 읽지 않은 알림(`unread_only`)·확인 안 한 태그(`unread_mentions`)만. [확인] 버튼 없음 — 줄(`data-href`,
|
||
`data-task-id`)을 누르면 `initInboxTaskPanel` 이 같은 작업의 줄(태그·알림)을 모두 확인(`POST /api/mentions/read {task_id}`,
|
||
`POST /api/notifications/{id}/read`)하고 오른쪽 iframe 작업 창을 연다. 다른 줄을 고르거나 창을 닫으면 앞서 확인한 줄은 목록에서
|
||
빠진다(빈 목록이면 "없습니다"). 오른쪽 클릭 = 열지 않고 확인. [태그 모두 확인]·[알림 모두 읽음] = 그 목록을 비운다.
|
||
- **용어**: 프로젝트 모듈 화면 글자 "하위 작업" → **"세부 작업"**, "작업 추가" → **"메인 작업 추가"**(세부 작업 추가는 그대로).
|
||
대시보드 담당자별 막대 이름 "메인 작업"·"세부 작업".
|
||
- **담당자별 작업 합계 — 세부 작업의 세부 작업까지**: `list_subtasks_of` 가 재귀 CTE 로 모든 단계(깊이 20 까지)를 돌려주고
|
||
`root_task_id`(맨 위 메인 작업)·`parent_title`(바로 위 작업) 을 붙인다. 화면은 `root_task_id` 가 이 범위 메인 작업이면 센다.
|
||
- **회의록 보드 링크 복사**: [회의록 보드] 오른쪽 🔗(`#pj-meet-board-copy`) — 같은 `POST …/board`(없으면 만든다)로 주소를 받아
|
||
클립보드에(실패하면 주소 창). 한 번 받은 주소는 그 화면에서 다시 쓴다.
|
||
|
||
## 6-14. 관리자 등급 4단계 — 수퍼관리자 · Admin · Pro user · User (2026-10-12, 마이그레이션 없음)
|
||
|
||
- **등급**: 사용자 레코드 `role` 이 `admin` / `pro` / `user`(`app.store.ROLES`, 관리자 페이지 등급 선택 — 표시 Admin · Pro user · User).
|
||
수퍼관리자는 role 이 아니라 `SUPER_ADMIN_EMAIL` 한 명(고정, 등급 변경·삭제·추가 불가). `pro` 는 **프로젝트 모듈에서만** 권한이
|
||
늘고, 그 밖(관리자 페이지·다른 모듈·`is_admin`)에서는 `user` 와 같다. 모듈 칩 기본값도 user 처럼 전부 꺼짐.
|
||
- **판단 함수**(`access.py`): `role_of` · `is_pro`(수퍼관리자·Admin·Pro user) · `is_project_admin`(수퍼관리자·Admin).
|
||
라우터 `_require_pro`(예전 `_require_admin` 자리 전부), 화면 값 `_role_ctx(user)` → `is_admin`(ERP 상단 관리자 메뉴용, 그대로) ·
|
||
`pj_pro` · `pj_admin`. 템플릿의 프로젝트 기능 버튼은 `pj_pro`, 마크업은 `data-is-pro`·`data-is-padmin`(사이드바·프로젝트·내 작업),
|
||
목표 표·회의록은 `data-pro`.
|
||
- **프로젝트 보기는 여전히 멤버·owner 만**(관리자도 마찬가지, 수퍼관리자만 전체 — 6-10). 아래 Pro user 권한도 멤버인 프로젝트 안에서만.
|
||
|
||
| 프로젝트 | Admin | Pro user | User | 서버 |
|
||
| --- | --- | --- | --- | --- |
|
||
| 프로젝트 보기, 작업·섹션 만들기·고치기·옮기기 | O | O | O | `_require_manage` |
|
||
| 작업 삭제(휴지통) | O | O | O | 멤버면 누구나 — 생성자 검사 없앰 |
|
||
| 섹션 삭제 | O | 만든 사람만 | 만든 사람만 | `_can_delete` (기록 없는 옛 섹션 = Admin 이상) |
|
||
| 서브프로젝트 만들기 | O | O | O | `_require_manage` |
|
||
| 새 프로젝트 만들기 | O | O | X | `POST /api/projects` → `_require_pro` |
|
||
| 프로젝트 이름·색·아이콘·날짜·완료 수정, 소유자 바꾸기 | O | O | X | `PUT /api/projects/{id}` → `_require_pro` + 멤버 |
|
||
| 프로젝트 삭제 | O | 만든 사람만 | 만든 사람만 | `_can_delete` + 멤버 |
|
||
| 멤버 배정·제외(+ 배정 후보 목록) | O | O(멤버인 프로젝트) | X | `_require_pro` + `_require_manage` |
|
||
| 사이드바 프로젝트 순서 | O | O | X | `PUT /api/projects/order` |
|
||
| 댓글 수정·삭제 / 댓글에 파일 붙이기 | O | 남의 것도 | 본인만 | `update_comment`·`delete_comment(is_admin=is_pro)` |
|
||
| 휴지통 보기·복구 | O | O | X | `/trash`·`/api/trash/{id}/restore` |
|
||
| 전체 보기 | O | O(멤버 범위) | X | 화면 `isPro` (`?scope=all` 도 isPro 일 때만) |
|
||
| 대시보드 담당자별 작업 합계 | O | O | X(안 보임) | `GET …/subtasks-summary` → `_require_pro` |
|
||
| 사이드바 전체 멤버 | O | O | X | 화면 `pj_pro` |
|
||
| 수신함·내 작업·PC 알림 | O | O | O(자기 것) | 변화 없음 |
|
||
|
||
| 목표·주간 회의록 | Admin | Pro user | User |
|
||
| --- | --- | --- | --- |
|
||
| 연간 목표 표 보기 | O | O | O |
|
||
| 목표 표 입력·구조 변경(매출·로아스, 영역·줄, 칸 병합·이동), 주차별·월 매출 목표, 연도 추가·삭제 | O | O | X |
|
||
| 회의록 만들기·글 수정·줄 추가·삭제·칸 병합(완료 전까지), 지난주 결과(다음 주 회의록이 열려 있는 동안) | O | O | O |
|
||
| 회의 완료·완료 해제, 회의록 삭제 | O | O | X |
|
||
| 회의록 보드 열기·링크 복사 | O | O | O |
|
||
| 회의록 작업 등록 표로 작업 만들기 | 멤버인 프로젝트만 | 멤버인 프로젝트만 | 멤버인 프로젝트만 |
|
||
|
||
- 회의록 표 첫 열 머리 글자 "구역" → **"구분"**(화면 글자만, 데이터·코드의 section 이름은 그대로).
|
||
- 테스트: `tests/test_project_roles.py`(DB 없이 등급별 API), `tests/test_project_module.py` 의 소유자·삭제 테스트를 새 규칙으로.
|
||
|
||
## 6-15. 검토 반영 — 권한·열기 경로·저장·동시성 (2026-10-12, 마이그레이션 없음)
|
||
|
||
권한 정책(6-14 표)은 그대로 두고, 그 정책이 새던 곳을 막았다. 테스트 `tests/test_project_review_fixes.py`(DB 없이),
|
||
`tests/test_project_meeting_lock.py`·`test_project_alerts_api.py`, `tests/js/project_ui.test.js` 의 [검토 *] 항목.
|
||
|
||
- **서브프로젝트 작업**: `GET /api/projects/{id}/tasks`(하위 프로젝트까지 재귀)는 작업마다 지금 권한으로 다시 거른다
|
||
(`access.filter_visible_tasks`) — 부모 멤버라고 멤버가 아닌 자식 프로젝트 작업이 보이지 않는다. 연결된 작업의 READ 는 그대로.
|
||
(이 API·`POST /subprojects` 는 지금 화면에서 부르지 않는다 — 외부 호출 호환 때문에 남겨 둠.)
|
||
- **사이드바 순서** `PUT /api/projects/order`: Pro user 이상 + 보낸 id **전부** 지금 관리할 수 있는 프로젝트여야(없는 id 도 같은 403,
|
||
하나라도 아니면 아무것도 안 바뀜). 빈 목록·정수 아님(참/거짓·소수·글자)·0 이하·중복 = 400. 순서는 예전처럼 모두가 같이 보는 순서.
|
||
- **작업 열기 경로 하나로**: 수신함 줄·웹 큰 팝업·PC 알림 [열기] = `/project/t/{task_id}`(공유 링크). 서버(`_task_open_project`)가
|
||
지금 권한으로 열 프로젝트를 고른다 — FULL 이면 원 소속, READ 면 내가 볼 수 있는 연결된 프로젝트. `?embed=1` 은 옮긴 주소에도
|
||
붙는다(수신함 iframe). 알림 응답에 `href` 가 붙는다. 예전 주소 `/p/{원 소속}?task=` 로 READ 사용자가 오면 403 대신 연결된
|
||
프로젝트로 보낸다(옛 PC 알림 프로그램·북마크). 작업 없는 프로젝트 알림은 예전처럼 `/p/{id}`.
|
||
- **보관·서브프로젝트 화면**: `project_page`·스냅샷(scope=all)·담당자별 합계(scope=all)는 같은 범위(`_view_scope`) — 활성 최상위
|
||
멤버 프로젝트 + **지금 연 프로젝트 하나**(보관됐거나 서브프로젝트여서 목록에 없을 때만). 다른 보관 프로젝트는 읽지 않는다. 그
|
||
프로젝트 메타는 `view_only: true` 로 와서 사이드바 목록엔 그리지 않는다(작업 권한 판단·타임라인 그룹용).
|
||
- **전체 보기**: 작업마다 한 행 — 원 소속 행이 있으면 그것, 원 소속을 볼 수 없어 연결된 프로젝트 행(READ)만 있으면 그중 첫 행
|
||
(`scopeTasks`). 예전엔 원 소속 행만 남겨 이런 작업이 빠졌다. 사용자별 작업 팝업(`/api/users/tasks`, 전체 대상)도 같은 기준(READ 포함).
|
||
- **큰 팝업 알림**(`_alerts_payload`, 웹·PC 공용): 수신자·읽지 않음·종류(태그·배정)·`id > after` 를 DB 에서 먼저 걸고
|
||
(`list_unread_after`) **오래된 것부터** 200건씩 넘기며 지금 볼 수 있는 것 10건을 모은다(한 번에 최대 25쪽 = 5,000행).
|
||
예전엔 최신 50건을 자른 뒤 걸러 — 배정 뒤 댓글 알림 50건, 배정 60건 이상, 볼 수 없는 알림이 앞을 채우면 팝업이 빠졌다.
|
||
기준점(`latest_id`)·처음 연결 때 옛 알림 안 띄움·PC 프로그램이 돌면 웹 팝업 쉼은 그대로.
|
||
- **수신함 오른쪽 작업 창**: 다른 줄로 바꾸거나 닫기(Esc·바깥 클릭·모두 확인·프로젝트 알림 이동) 전에 iframe 안 작업 창의
|
||
`window.__pjEmbedSettle()` 을 기다린다 — 작업 창 닫기와 같은 절차(업로드·만들기·저장 대기 → 실패 칸 재시도 → "버리고 넘어가기 /
|
||
계속 편집"). 계속 편집이면 창·입력·선택 그대로, 새 줄은 확인하지 않는다. 바꾸기는 한 번에 하나, 마지막 요청만(A→B→A·저장 중
|
||
Esc 연타). beforeunload 경고에 기대지 않는다. 읽음/확인은 **서버가 받았을 때만** 확인으로 두고(실패면 굵게 남기고 알림), 확인된
|
||
줄만 목록에서 뺀다. `POST /api/mentions/read` 는 006 미적용(표 없음)만 0건 성공, 그 밖의 DB 오류는 실패로 돌려준다.
|
||
- **일반 첨부**(`POST /api/tasks/{id}/attachments`): DB 저장이 실패하면 이 요청이 쓴 파일(새 uuid 이름)만 지운다. 크기·빈 파일·
|
||
권한·inline 정책은 그대로.
|
||
- **새 프로젝트 창**: ① 생성(한 번만) ② 멤버 배정(사람마다)을 나눠 안내 — 배정 실패면 창을 닫지 않고 실패한 멤버를 빨갛게,
|
||
[실패한 멤버 다시 배정]은 그 멤버만(프로젝트를 또 만들지 않음). 진행 중 연타 무시, 진행 중 닫아도 요청은 끝까지 가고 결과는 알림.
|
||
만든 프로젝트를 되돌리려고 지우지 않는다.
|
||
- **배지 개수**: 내 작업(`list_my_open_refs`)·수신함 태그(`list_unread_mention_refs`)·읽지 않은 알림(`list_unread_refs`)은 가벼운 열만
|
||
제한 없이 읽어 지금 권한으로 센다(예전 1000·1000·500건 상한). 내 작업 목록은 **미완료 전부** + 최근 완료 1000건
|
||
(`list_my_tasks(completed_limit=)`) — 오래된 완료가 새 미완료를 밀어내지 않는다.
|
||
- **동시성**: `update_task` 는 기존 값 읽기·섹션 확인·기본 담당자·완료 섹션 여부·최종 날짜 검사·변경·이력을 한 트랜잭션에서 그
|
||
작업 행을 잠그고(`FOR UPDATE`) 같은 연결로 한다 — 시작일·마감일을 동시에 바꿔도 역전되지 않고, 동시 완료의 완료 이력·알림은 실제로
|
||
바뀐 한 요청에서만. `update_project` 날짜 검사도 행 잠금 뒤. (한 창 저장 직렬화와 별개 — 여러 사람 사이의 충돌 방지.)
|
||
- **회의록**: 머리(메모·참석자·금주 목표) 수정은 그 회의록 행을 잠그고 완료 여부를 본다([회의 완료]도 같은 행을 잠근다). 결과 칸만
|
||
고칠 때(`_check_result_open`): 다음 주차 회의록이 **있으면** 그 회의록이 열려 있을 때만, **없으면** 그 주 회의록이 열려 있을 때만
|
||
(예전엔 다음 회의록이 없으면 완료된 주의 결과도 고칠 수 있었다). 다음 주차 = `week_period` 끝 + 1일(달이 바뀌어도, 월요일이 아닌
|
||
시작일도). 다음 회의록 행은 `FOR SHARE` — 잠금 순서는 늘 주차 오름차순(교착 없음).
|
||
- **소유자를 남으로 정해 만들기**: 만든 사람을 같은 트랜잭션에서 **일반 멤버 행**으로 넣는다(`create_project(member_emails=)`) —
|
||
`created_by` 로 권한을 주지 않으니 나중에 멤버에서 빼면 권한도 없어진다. 소유자 변경 뒤 옛 소유자 권한 회수도 그대로.
|
||
- **중복 방지 키**(`_once`, 댓글 `client_token`): 키별 잠금을 쓰는 요청 수로 관리해 0 이 되면 바로 뺀다(실패한 키도) — 결과를 먼저
|
||
저장한 뒤 잠금을 풀어 기다리던 요청은 결과로 답한다. 실패하면 다음 요청이 새로 만든다(재시도). **보장 범위: 웹 프로세스 하나**
|
||
— 지금 운영은 web 컨테이너 1개·uvicorn 워커 1개(Dockerfile). 워커·컨테이너를 늘리면 다른 워커로 간 재전송은 막지 못하고 재시작하면
|
||
기록도 사라진다(그때는 DB UNIQUE 키가 필요).
|
||
- **섹션 기본 담당자**: 자동 배정 전에 그 사람이 지금 등록된 project 권한 사용자인지도 본다(`_registered_project_user`, 사용자 목록만 —
|
||
잠근 트랜잭션 안에서 DB 연결을 더 빌리지 않음). 기본 담당자 지정도 같은 기준. 협업자 추가는 담당자 후보와 같은 `access.can_assign`
|
||
(예전엔 관리자는 멤버가 아니어도 넣을 수 있었다).
|
||
|
||
- **회의록 구역 순서**(2026-10-12): 첫 열 "구분" 칸 우클릭·⋯ = 구역 위로·아래로·구역 끝에 줄 추가.
|
||
`POST /api/goals/meeting-items/{item_id}/move-section {direction: -1|1}`(그 구역의 아무 줄) → `move_meeting_section` 이 회의록
|
||
행 잠금 안에서 이어진 같은 구역 줄 묶음과 옆 묶음의 자리를 바꾼다(묶음 안 줄 순서·세로 병합 그대로, 맨 끝이면 그대로). 줄 이동과 같은
|
||
권한(누구나, 회의 완료면 409). 다음 회의록은 `create_meeting` 이 이 순서를 이어받는다. 마이그레이션 없음.
|
||
|
||
- **회의록 항목 칸 묶음**(2026-10-12, 마이그레이션 027 `goal_meeting_items.label_cont`): "주요 업무" 칸 우클릭 → 위/아래 줄 추가는
|
||
**항목 칸은 그대로 두고 그 항목 안에** 줄을 늘린다(`POST …/items {same_label: true}` — 이름을 묻지 않음. 아래 = 새 줄이 이어 붙고,
|
||
묶음 첫 줄 위 = 새 줄이 첫 줄이 되어 이름을 넘겨받고 기준 줄이 이어 붙음 — 연간 목표 016 과 같은 규칙). 주요 업무 칸 메뉴에 "줄 삭제"(그 한 줄).
|
||
화면은 묶음 첫 줄 항목 칸 `rowspan`(`router._meeting_label_spans`, 구역 첫 줄은 늘 묶음 첫 줄), 이어 붙은 줄은 `tr[data-label-cont]`.
|
||
항목 칸 메뉴(우클릭·⋯) = 따로 추가(묶음 맨 위·맨 아래 기준, 이름 물음) · 묶였으면 위로/아래로 대신 **항목 칸 나누기**
|
||
(`POST /api/goals/meeting-items/{id}/split-label`) · 첫 줄 삭제(아래 줄이 이름을 이어받음). 묶인 줄의 순서 이동은 400.
|
||
줄마다 주요 업무·정량 목표·연결키(line_key)는 따로라 지난주 리뷰는 줄 단위 그대로, 다음 주 회의록은 묶음을 이어받는다.
|
||
027 미적용이면 같은 항목 칸 추가·나누기만 503, 나머지는 예전처럼.
|
||
- **회의록 줄 작업 애니메이션**(2026-10-12): 줄 추가·삭제·이동·항목 칸 나누기·구역 이동·셀 병합/해제 뒤 새로고침 대신 `refreshMeeting` —
|
||
같은 주소를 다시 받아 표의 구역(`tbody.pj-meet-sec`)만 바꿔 끼우고 저장·셀 도구(`PJMeetingCells.refresh`)·칸 순서(`pj-meet-rows` 이벤트)를
|
||
다시 붙인다. 지운 줄은 흐려지며 사라지고, 남은 줄은 미끄러지고(FLIP), 새 줄은 내려오며 강조(연간 목표 `refreshTable` 과 같음).
|
||
저장 안 된 글은 먼저 저장(실패면 작업 안 함), 계속 입력 중이면 저장 뒤 다시 그림, 받아 오기 실패면 새로고침. 줄 작업은 한 번에 하나씩.
|
||
|
||
- **회의록 작업 등록 — 새 프로젝트·새 섹션**(2026-10-12): 프로젝트 칸 목록 맨 위 "새 프로젝트"(Pro user 이상만 보임 — `POST /api/projects`,
|
||
만든 사람이 소유자), 섹션 칸 맨 위 "새 섹션"(그 프로젝트 멤버 — `POST /api/projects/{id}/stages`). 이름만 묻고 만든 뒤 바로 그 칸에 고른다.
|
||
- **회의록 작업 등록 — 고를 목록**(2026-10-12): 완료 프로젝트(`status = completed`)·완료 섹션(`is_done_stage`)은 목록에서 빼고,
|
||
프로젝트를 고를 때 자동으로 넣는 섹션도 완료 섹션이 아닌 첫 섹션.
|
||
- **회의록 작업 등록 — 주차별 서버 표**(2026-10-12, 마이그레이션 025 `goal_meeting_tasks`): 제목 "N주차 작업 등록"(`week_n`).
|
||
예전엔 각자 브라우저(localStorage)에만 있어 다른 사람이 적거나 등록한 줄이 안 보였다 → 주차(`week_start`)마다 한 표를 서버에.
|
||
API `GET/POST /api/goals/meetings/{주차}/quick-tasks` · `PUT/DELETE /api/goals/meeting-quick-tasks/{id}` ·
|
||
`POST …/{id}/apply`(줄을 FOR UPDATE 로 잠그고 task_id 가 없을 때만 `_create_task_for` — 작업 창과 같은 권한·알림, 동시에 눌러도 하나).
|
||
보기·고치기 = 회의록을 볼 수 있는 사람 누구나(회의 완료면 409), 줄에 고를 수 있는 프로젝트 = 내가 멤버인 것만(403),
|
||
내가 멤버가 아닌 프로젝트를 가리키는 남의 줄은 프로젝트·섹션 이름·작업 링크를 가린다(`registered` 만). [적용] 뒤 줄은 고칠 수 없다.
|
||
**작업 칸**(마이그레이션 026 `parent_task_id`): 프로젝트 → 섹션 → **작업** — 비우면 그 섹션에 새 작업, 이미 있는 작업을 고르면 [적용] 때
|
||
그 작업의 세부 작업으로(섹션 없음). 후보 = 그 섹션(섹션이 없으면 프로젝트)의 미완료 메인 작업(`GET /api/projects/{id}/tasks`).
|
||
서버는 고른 작업이 그 프로젝트 것인지 확인(400), 프로젝트를 바꾸면 섹션·작업을 비우고, [적용] 때 그 작업이 없어졌거나 옮겨졌으면 400.
|
||
026 미적용이면 작업 칸 저장만 503(나머지 그대로). (025 의 `parent_id` — 잠깐 있던 '표 안 줄끼리 세부 작업' — 는 화면·API 에서 뺐다, 열은 남김.)
|
||
**등록된 줄 제목 = 오른쪽 작업 창**: `/project/t/{id}?embed=1` 을 iframe 패널(`.pj-inbox-panel.pj-meet-task-panel`)에 — 수신함과 같이
|
||
바꾸기·닫기(Esc·바깥 클릭·작업 창 닫기) 전에 `__pjEmbedSettle`(저장 대기 → 실패면 버리기/계속 편집), 닫으면 표를 다시 읽는다.
|
||
**[크게 열기]** = 같은 표(DOM 그대로)를 넓은 창(`.pj-meet-quick-modal`, body 에, 고르기 메뉴 아래 z-index)으로 옮겨 쓰고 Esc·×로 제자리.
|
||
화면은 빈 줄 3개를 화면에만 두고
|
||
처음 채우는 순간 POST, 그 뒤 칸마다 PUT(줄마다 차례대로), 30초마다·창을 다시 볼 때 다시 읽는다(입력·저장 중엔 건너뜀).
|
||
이 브라우저에 남은 예전 표(`pj_meet_quick:{이메일}:{주차}`, 이번 주면 `pj_meet_quick:{이메일}`)는 처음 열 때 서버로 옮기고 지운다.
|
||
025 미적용이면 표 자리에 안내만(503).
|
||
- **말풍선 위치**(`initHoverTips`, 2026-10-12): 늘 커서 위 — 위 여유가 적으면(화면 맨 위 회의록 머리 버튼 등) 꼬리 간격을 줄여(커서 8px 위)
|
||
위에 두고, 그래도 안 들어갈 때만 아래로 뒤집되 마우스 화살표에 가리지 않게 커서 28px 아래. 예전엔 위 여백이 말풍선 높이+20px 보다
|
||
작으면 커서 바로 아래(22px)로 뒤집혀 화살표가 글자를 가렸다.
|
||
|
||
정책 결정이 필요한 것(바꾸지 않음): 배정·완료 **메일**은 `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`
|
||
([섹션 담당자]·[세부 업무 협업자]·[대시보드 담당자별] 패널 왼쪽·[전체 보기] 기본 대시보드).
|
||
|
||
## 6-17. 세부 업무 만들 때 협업자 · 카드 세부 업무 협업자 · 대시보드 프로젝트별 · 마감 지난 업무 위쪽 알림 (2026-10-13, 마이그레이션 없음)
|
||
|
||
- **만들 때 협업자** — `POST /api/projects/{id}/tasks` 에 `followers: [이메일]`(선택). `_check_followers` 가 협업자 추가 API 와 같은 기준
|
||
(`access.can_assign` — 그 프로젝트를 볼 수 있는 사람)으로 먼저 검사해 하나라도 안 되면 400(업무를 만들지 않음), 목록이 아니어도 400.
|
||
만든 뒤 자동 협업자(만든 사람·담당자)와 함께 `_follow`. 화면:
|
||
· 업무 창 세부 업무 추가 칸 — 담당자 오른쪽 **[협업자 없음 / 협업자 N명]** 버튼(`#pj-subtask-add-followers`), [추가] 뒤·다른 업무를 열면 비움.
|
||
· 보드 카드 "+ 세부 업무 추가" 새 줄 — 담당자 오른쪽 협업자 아이콘(`.pj-card-subnew-fol`, 초안 `followers`). 협업자만 고른 줄은 바깥 클릭으로 닫히지 않는다.
|
||
· 보드 "+ 메인 업무 추가" 입력 카드 — 담당자 옆 협업자 아이콘(`.pj-tasknew-fol`, 초안 `followers`, 담당자는 후보에서 빠지고 담당자로 고르면 협업자에서 빠짐).
|
||
· 이미 있는 보드 카드(메인 업무) — 아래줄 담당자 오른쪽 협업자 아이콘(`.pj-card-fol`). 카드 목록엔 협업자 정보가 없어 비어 보이면 카드에 마우스를
|
||
올릴 때만 보이고, 누르면 `GET /api/tasks/{id}/followers` 로 받아 멤버 메뉴(`openCardFollowers`). 받거나 고친 협업자는 `cardFollowers` 에 두어
|
||
이 화면에서 카드에 계속 보이고, 업무 창을 닫으면 비운다(창에서 바꿨을 수 있다).
|
||
- **이미 있는 세부 업무** — 업무 창 줄(`.pj-subtask-fol`, 6-16)은 비어 있어도 늘 옅게 보이게(예전엔 마우스를 올릴 때만), 보드 카드 펼친 세부 업무 줄에도
|
||
협업자 아이콘(`.pj-card-sub-fol`, 편집 권한자, 비어 있으면 줄 hover 때만). 셋 다 공용 `openFollowerMenu`(멤버 메뉴, 협업자 ✓, 고를 때마다
|
||
같은 자리에 다시 열려 여러 명) · `followerIconHtml` · `setTaskFollower`.
|
||
- **대시보드 업무 합계(프로젝트별)** — 완료 상태별 카드 바로 왼쪽(`dashProjectBars`). 지금 범위의 메인 업무를 원 소속 프로젝트별로 묶어
|
||
색 점·이름·가로 막대(채움 = 완료율)·완료/전체 · %, 업무 많은 순, 줄을 누르면 그 프로젝트(`/project/p/{id}`). 넘치면 카드 안 세로 스크롤.
|
||
- **마감 지난 내 업무 알림** — `static/erp-overdue.js`·`erp-overdue.css`, ERP 모든 화면(`erp_base.html`·`main.html`·`admin.html`) 위쪽 가운데
|
||
(body 에 붙음, z 5500 — 긴급 공지 6000 아래). `GET /project/api/my-overdue` = 내가 담당인 미완료 업무(세부 포함) 중 마감일 < 오늘(KST),
|
||
지금 볼 수 있는 것만(`access.filter_visible_tasks`), 마감 오래된 순 최대 200건(`db.list_my_overdue`). 알림은 최대 5줄 + "그 밖에 N건 — 내 업무에서 보기",
|
||
줄 = `/project/t/{id}`(마감 M/D · N일 지남). **[닫기]**(버튼 글자 "닫기"만 — 2026-10-14 "(1시간 뒤 다시)" 글자·말풍선 뺌) = localStorage `erp_overdue_snooze`({until, ids}) — 이 브라우저 모든 탭이
|
||
1시간 쉬고, 닫을 때 없던 업무가 새로 마감을 넘기면 바로 다시 띄운다. 5분마다·창을 다시 볼 때 확인, 다 완료하면 사라짐.
|
||
401·403(Project 권한 없음)·404·503 이면 조용히 멈춤, iframe 안에서는 안 돈다. 새 환경변수·DB 변경 없음.
|
||
- 검증: `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` [프로젝트 이동].
|
||
|
||
## 6-19. 담당자는 협업자가 아니다 · 세부 업무 추가 칸 아이콘 · 내 업무 오른쪽 업무 창 · 섹션별 카드 삭제 (2026-10-13, 마이그레이션 028)
|
||
|
||
- **규칙 — 협업자는 담당자 외의 멤버**(업무·세부 업무 모두). 예전엔 담당자를 자동 협업자로 넣었다.
|
||
· `db.add_followers` 가 그 업무의 담당자를 SQL 에서 거른다 — 자동 협업자(만든 사람·댓글 쓴 사람·@태그)·만들 때 고른 협업자 모두.
|
||
· 담당자를 정하면(`db.update_task` — 직접 지정·섹션 기본 담당자, `move_task_to_project` 의 기본 담당자) 같은 트랜잭션에서 그 사람을
|
||
협업자에서 뺀다(`_drop_assignee_follower`). 예전 담당자를 협업자로 자동으로 넣지는 않는다.
|
||
· `POST /api/tasks/{id}/followers` 에 담당자(빈 email = 나 자신이 담당자인 경우 포함)는 400.
|
||
· 화면: 협업자 고르기 메뉴(`openFollowerMenu` 의 assignee 인자)·업무 창 협업자 추가 메뉴에서 담당자를 뺀다, 내가 담당자면 [협업자로 참여] 숨김,
|
||
담당자를 바꾸면 화면의 협업자 목록에서도 바로 뺀다. 알림은 그대로 — 수신자 = 담당자 + 협업자(`_task_recipients`).
|
||
· **마이그레이션 028**(`project_db_028_followers_exclude_assignee.sql`) — 이미 겹친 `task_followers` 행(담당자와 같은 사람)을 지운다.
|
||
스키마 변경 없음, 멱등(008 미적용이면 건너뜀), 지운 행 수를 NOTICE 로. 되돌리기 = 적용 전 백업에서 task_followers 복원.
|
||
- **세부 업무 추가 칸**(업무 창) — 담당자·협업자·마감일은 글자 없는 동그라미 아이콘 버튼(담당자 = 아바타/점선 원, 협업자 = 첫 사람 + "+N"/점선 원
|
||
두 사람, 마감일 = 점선 원 달력 → 고르면 아이콘 + 날짜), 말풍선에 담당자 이름·협업자 목록. 남는 폭은 제목 칸이 다 쓴다(`.pj-subtask-form` nowrap).
|
||
- **내 업무 화면** — 줄(남의 상위 업무 안내 줄 포함)을 누르면 화면 이동 없이 오른쪽 업무 창(`createEmbedTaskPanel` — `/project/t/{id}?embed=1`
|
||
iframe, 수신함·회의록과 같은 저장 대기). 다른 줄 = 같은 창에서 바꿈, Esc·목록 밖 클릭 = 닫기 → 목록 다시 받기. 연 줄은 `.is-panel-selected`.
|
||
Ctrl·가운데 클릭 = 새 탭 프로젝트 화면, 우클릭 "프로젝트 화면에서 열기".
|
||
- **대시보드** — "미완료 업무 합계(섹션별)" 카드 삭제(요청). 남은 카드: 업무 합계(프로젝트별)·업무 합계(완료 상태별)·담당자별(Pro user 이상).
|
||
- 검증: `tests/test_project_module.py::test_assignee_is_never_follower`(실제 PG, 028 두 번 실행 포함),
|
||
`tests/test_project_review_fixes.py`(같은 트랜잭션에서 협업자 정리), `tests/js/project_ui.test.js` [내 업무 창](`render_project.py` 가 `mytasks_render.html` 도 만든다).
|
||
|
||
## 6-20. 세부 업무 자동 협업자 없음 · 마감일 아이콘 옅게 · 담당자별 패널 날짜 (2026-10-14)
|
||
|
||
- **세부 업무를 만들 때 만든 사람을 자동 협업자로 넣지 않는다** — 만들 때 고른 협업자만(`_create_task_for`: `parent_task_id`
|
||
가 있으면 `_follow` 에 만든 사람을 빼고 고른 사람만). 담당자도 자동 지정되지 않는다(세부 업무는 섹션이 없어 기본 담당자 없음).
|
||
메인 업무는 그대로 만든 사람 자동 협업자. 화면 `newTaskFollowers` 도 같은 규칙(고른 사람만). 이미 만든 세부 업무의 협업자는 그대로.
|
||
- **업무 창 세부 업무 줄 마감일 아이콘** — 마감일이 없을 때 점선 원 달력 아이콘을 협업자 아이콘처럼 늘 옅게(`opacity .5`, 줄 hover = 진하게).
|
||
- **대시보드 담당자별 합계 → 오른쪽 업무 목록 패널** — 오른쪽 날짜 `mm/dd(요일)`(예: 10/07(수)), 마감이 지난 미완료 업무는 빨간 굵은 글씨(`em.is-overdue`).
|
||
- **로그인 전 화면 주소 → 로그인 화면**: 공유한 회의록·업무 주소를 로그인 안 된(세션 만료·다른 브라우저) 상태로 열면
|
||
예전엔 `{"detail":"로그인이 필요합니다."}` JSON 이 보였다. 화면 주소(내 업무·프로젝트·휴지통·도움말·수신함·목표·회의록)는
|
||
`_page_user` 가 `/login?next=<원래 주소>` 로 보내 로그인 뒤 그 주소로 돌아온다(`/t/{id}`·`/notifier` 는 원래 그렇게 동작). API 는 그대로 401.
|
||
- 검증: `test_create_with_followers_and_my_overdue`(세부 = 고른 사람만, 메인 = 만든 사람), `project_ui.test.js` [대시보드 담당자별] 패널 날짜,
|
||
`tests/test_project_meeting_nav.py::PageLoginRedirectTests`.
|
||
|
||
## 6-21. 수신함 머리 — 성공하기 창 · 아이콘 버튼 (2026-10-15, 마이그레이션 없음)
|
||
|
||
- **[성공하기]** — 왼쪽 사이드바 프로젝트 목록 위 버튼(처음엔 수신함 머리에 있었음). 모듈 폴더의 `app/modules/project/dbx.html` 을 `GET /project/dbx`(`dbx_page`,
|
||
로그인·`project` 권한 = `_page_user`, DB 없이 파일 그대로)로 내주고, 화면은 `window.open(..., "pj-dbx", "popup=yes,…")` 별도 창으로 연다
|
||
(같은 창 이름이라 여러 번 눌러도 창 하나). 창 안에는 맨 위 [닫기](`window.close()`) 버튼만 — 내용은 dbx.html 을 고치면 바로 반영(`no-cache`).
|
||
- **[태그 모두 확인]·[알림 모두 읽음]** 은 글자 없이 아이콘만(`done_all`·`mark_email_read`, 말풍선 = `title`), [PC 알림] → **[PC 알림 프로그램 설치]**.
|
||
- 수신함 머리 줄 = **제목 가로 정가운데·굵게 | 버튼들 맨 오른쪽**(`1fr | 제목 | 1fr` 격자).
|
||
- **[성공하기]는 왼쪽 사이드바 프로젝트 목록 바로 위**(`_side.html` `#pj-dbx-open`, 아이콘 21.6px = 120%) — 모든 Project 화면 공용, 창 여는 코드는 project.js(문서 단위 클릭 위임).
|
||
- dbx.html: 첫 탭 제목 "DBX 존재이유 / 일하는 법", 탭 순서 = 존재이유·일을 잘한다는 것·일 못하는 사람 특징·부자/성공·마케팅?·인생을 결정하는 단 1가지(패널 id 는 그대로, 버튼 순서만), 강조는 `<b>`·형광 `<mark>`.
|
||
- dbx.html 탭은 Project 뷰 탭처럼 고른 탭 뒤 옅은 보라 사각형(`.tab-hl`)이 미끄러져 옮겨 간다(두 줄로 접혀도 위아래까지).
|
||
|
||
## 6-22. 회의록 [적용] 한 트랜잭션 · 업무 등록 표 저장 실패 처리 (2026-10-15 검토 F02·F03, 마이그레이션 없음)
|
||
|
||
- **[적용](`POST /api/goals/meeting-quick-tasks/{id}/apply`)** — ① 잠그기 전에 줄을 읽어 작업 창과 같은 확인(`_task_create_checks`:
|
||
멤버·담당자·협업자) ② `db.apply_meeting_task(task_fields, expect)` **한 연결·한 트랜잭션**: 줄 `FOR UPDATE` → 이미 업무가 있으면 그대로(200)
|
||
→ 확인에 쓴 줄 값(`MT_APPLY_KEYS`)이 그사이 바뀌었으면 409 → 상위 업무가 같은 프로젝트에 있는지 → `_insert_task(conn)`(업무 INSERT·이력,
|
||
`create_task` 와 같은 본문) → 줄에 `task_id`. 연결 기록이 실패하면 업무도 롤백(고아·재시도 중복 없음), 동시 클릭에도 업무 하나,
|
||
트랜잭션 안에서 같은 풀의 다른 연결을 빌리지 않는다(풀 1개로도 동작) ③ **커밋 뒤에만** 협업자·배정/완료 알림·관리자 메일(`_task_created_effects`).
|
||
예전엔 줄을 잠근 연결을 쥔 채 `create_task` 가 다른 연결에서 업무를 만들어 커밋했다.
|
||
- **업무 등록 표 저장**(`initMeetQuickTasks`) — 줄마다 저장 안 된 칸(`r.unsaved`)을 기억. `persist()` 는 실패하면 거부되는 약속을 돌려주고
|
||
(예전엔 실패를 삼켜 [적용]이 이전 제목으로 업무를 만들었다), [적용]은 `saveRow()`(치던 제목 보내기 → 앞선 저장 기다림 → 실패한 칸 다시
|
||
저장)가 끝까지 성공해야 보낸다. 실패한 초안은 그대로 두고 줄 빨간 테두리 + [다시 저장](`data-quick="retry"`), 자동·강제 새로고침도 초안을
|
||
지우지 않으며(이미 [적용]된 줄·409 만 서버 값), 저장 안 된 입력이 있으면 페이지 이탈 경고(`beforeunload`).
|
||
- 검증: `tests/test_project_module.py::test_review_meeting_apply_is_one_transaction`(실제 PostgreSQL — 테스트 전용 트리거로 연결 실패 주입,
|
||
풀 1개, 줄 바뀜 409), 기존 `test_review_meeting_quick_tasks_shared`(동시 4건), `tests/js/goals_meeting_ui.test.js` [2g9].
|
||
|
||
## 6-23. 보드 카드 끌기 실시간 미리보기 · 회의록 항목 칸 끌어 옮기기 · 회의록 표 검정 테두리 (2026-10-19, 마이그레이션 없음)
|
||
|
||
- **보드 카드 끌기**(`project.js` `startCardDrag`·`placeCardPh`·`flipBoardCards`·`endCardDrag`) — 네이티브 HTML5 DnD 그대로(왼쪽 프로젝트 목록 이동 6-18·세부 업무 끌기와 같은 이벤트).
|
||
- dragstart: 카드 복제를 `.pj-card-ghost`(body 에 잠깐, 화면 배율이면 zoom .75) 안에서 2.5° 기울여 `setDragImage`. 다음 틱에 원래 카드를 `.is-drag-src`(display none)로 숨기고
|
||
그 자리에 같은 높이의 점선 자리 표시 `.pj-card-ph`(같은 틱에 숨기면 크롬이 끌기를 취소).
|
||
- dragover(섹션 body): 마우스 Y 가 카드 중간선 위/아래 어디인지(애니메이션 중인 카드는 transform 을 빼고 계산 — 떨림 방지)로 자리 표시를 옮기고, 옮기기 전후 위치 차이로
|
||
FLIP(transform .18s) — 다른 카드가 미끄러지듯 비켜난다. 섹션을 넘어가도 같음. 순서를 못 정하는 경우(필터·정렬 중, 전체 보기 섹션 이름 보드)는 제 섹션 = 원래 자리, 다른 섹션 = 맨 끝.
|
||
- drop: 자리 표시 위치 = 놓을 자리. 같은 섹션 = `PUT stages/{id}/tasks/order`, 다른 섹션 = `PUT tasks/{id} {stage_id}` 뒤 그 섹션 `tasks/order`(기본 정렬·필터 없음일 때만,
|
||
화면 카드 순서 + 화면에 없는 그 섹션 업무는 뒤). 멀티호밍 연결 업무는 예전처럼 links 만(순서 저장 없음). 저장하는 동안 놓은 모양 유지(`dropped`) → 끝나면 `renderBoard`.
|
||
- 섹션 밖에 놓거나 취소하면 dragend 가 자리 표시를 지우고 카드를 원래 자리에 다시 보인다. 끄는 동안 `html.pj-card-dragging` — 실시간 동기화(`syncOnce`)가 보드를 다시 그리지 않는다(다음 주기 반영).
|
||
- **body 는 dragenter 도 preventDefault** — 자리 표시가 마우스 아래로 들어온 직후(다음 dragover 전) 놓으면 drop 이 거부되던 문제(Playwright 실제 크롬으로 재현).
|
||
- **회의록 항목 칸 끌어 옮기기** — 항목(`th.pj-meet-c-label`)을 마우스로 5px 이상 끌면 시작(그보다 짧으면 이름 수정 클릭 그대로, 끈 뒤 클릭은 막음).
|
||
- 묶음 = 항목 칸 첫 줄부터 이어 붙은 줄(`data-label-cont`)·주요 업무 세로 병합에 가려진 줄까지(서버 `move_meeting_group` 과 같은 경계). 묶음이 둘 이상인 구역만.
|
||
- 끄는 동안 그 묶음 tr 을 다른 묶음 중간선 기준으로 바로 옮겨 끼우고(구분 칸 `th.pj-meet-c-sec` 은 늘 구역 첫 줄로 옮김), 칸 단위 FLIP(`Element.animate` .17s). 끄는 줄은 연보라 + 왼쪽 보라 선.
|
||
- 놓으면 `POST /api/goals/meeting-items/{id}/move-to {before_item_id: 다음 묶음 첫 줄 | null = 구역 맨 끝}` → `refreshMeeting`. 실패하면 안내 후 서버 순서로 다시 그림. Esc = 원래 순서로.
|
||
- `db.move_meeting_group`: 같은 주 잠금(`_locked_meeting_items`, 회의 완료면 409)·묶음째·같은 구역만(다른 구역 400)·묶음 사이 자리(`before` 가 묶음 첫 줄이 아님) 409·제자리면 그대로. 권한은 줄 순서와 같음(누구나, 완료 전).
|
||
- **회의록 표 테두리** — `.pj-meet-table` 바깥·칸 테두리 모두 `#000`(예전 연회색). 칸은 오른쪽·아래 선만 그리므로 표 바깥 아래선은 없애(마지막 줄 아래선이 대신) 두 줄로 겹치지 않게, 모서리 둥글림 0. 구역 첫 줄 위 진한 선은 없앰(검정 1px 로 통일).
|
||
|
||
## 7. 추후 단계
|
||
|
||
작업 라벨(태그 분류) · 반복 작업 · 템플릿 · 작업 의존성.
|
||
(세부 작업의 세부 작업은 2026-10-08 부터 지원 — 6-13 담당자별 합계 참고.)
|