- 분기마다 차분한 색(파랑·청록·보라·남색): 머리 위 색 띠(월 3px · 분기 6px), 분기 열 전체 옅은 음영, 분기 칸 오른쪽 2px 경계, 분기 머리 글자·아이콘은 분기 색 - 접기 아이콘: 네모 안 −(펼침) / +(접힘), 90° 돌며 세로 막대가 자라고 줄어드는 애니메이션 - project.css 캐시 버전 올림 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
86 KiB
프로젝트 관리 모듈 (아사나식) — app/modules/project/
회사(dbxcorp.co.kr) 직원이 프로젝트→섹션→작업 3단계 구조를 캘린더/타임라인/ 보드로 관리하는 아사나(Asana) 스타일 협업 모듈. DB는
project_db전용.
화면 용어는 아사나 한국어판에 맞춘다(2026-09-25 통일) — 새 화면·메시지도 이 표를 따른다.
작업(예전 "업무") · 하위 작업 / 상위 작업 · 내 작업 · 섹션(예전 "세션"·"단계") ·
협업자(예전 "팔로워", 버튼은 "협업자로 참여 / 협업자에서 나가기" — 예전 "팔로우 / 팔로우 취소") ·
목록(보기 탭, 예전 "리스트") · 캘린더(예전 "달력") · 수신함 · 첨부 파일 · 작업 링크 복사 ·
프로젝트 칸 + "다른 프로젝트에 추가"(예전 "연결된 프로젝트") · 담당자 없음(예전 "(미지정)").
"@태그"는 그대로 쓴다. 코드 식별자·DB 컬럼(tasks, stage_id, task_followers 등)과 코드 주석은 예전 이름 그대로다.
도움말 — /project/help(project/help.html + static/project-help.css), 프로젝트 관리 화면 상단 바 로그아웃
오른쪽 ? 아이콘(_help_btn.html, erp_base.html 의 topbar_after_logout 블록)으로 새 탭에서 연다. 처음 쓰는 사람용
기능 설명 20장 — 화면 기능을 바꾸면 도움말도 같이 고친다.
멤버 이름 표기 — 이메일 아이디의 첫 글자만 대문자(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) |
| 생성 권한 | 프로젝트·섹션·작업(하위 작업 포함) 생성은 로그인해 이 모듈에 접근할 수 있는 사용자 누구나. 프로젝트를 만든 사람은 자동으로 owner 가 되어 그 프로젝트를 관리(_can_manage)할 수 있다. 다른 사람을 owner 로 지정해 만드는 건 관리자만(비관리자가 owner_email 을 남으로 보내면 403) |
| 소유자 변경 | 관리자만(2026-09-30). owner 는 멤버에서 빠져도 관리 권한이 남으므로, 일반 멤버가 스스로를 owner 로 바꿔 권한 회수를 피할 수 없게 PUT /api/projects/{id} 의 owner_email 변경은 비관리자 403(같은 값은 무시). 새 owner 는 project 권한이 있는 등록 사용자여야 한다(아니면 400) |
| 수정/이동 권한 | 서브프로젝트·작업·섹션 CRUD(이름변경·완료토글·순서변경 등) = 그 프로젝트의 배정 멤버 또는 owner 또는 admin(_require_manage). 작업 API 는 _require_task(write=True) = 원 소속 프로젝트 권한(FULL) |
| 조회 권한 | 프로젝트 화면(/p/{id})·멤버/섹션/작업/활동/스냅샷 API 도 멤버·owner·admin 만(_require_manage). 비멤버는 403. 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 허용) — _can_delete 하나로 통일. 그리고 지금 그 프로젝트 권한이 있어야 한다(멤버에서 빠진 생성자는 403, DB·휴지통 변화 없음) |
| 멤버 배정 | 여전히 관리자(is_admin) 전용. 비관리자가 "새 프로젝트" 모달을 열면 멤버 선택란은 안내 문구만 뜨고 시도하지 않는다(불필요한 403 방지) |
| 메일 알림 | app/mail.py (stdlib smtplib). 작업 배정/완료 시 관리자에게 발송 |
1-1. 프로젝트 → 섹션 → 작업 (하위 작업 포함) 3단계 구조
"섹션"은 새 개념이 아니라 기존 "단계"(칸반 컬럼)를 그대로 재사용한다 —
아사나도 보드 뷰의 컬럼과 목록 뷰의 구분선이 같은 "섹션" 하나다. DB
컬럼/테이블 이름(project_stages, stage_id)은 그대로 두고, 사용자에게
보이는 문구만 "섹션"으로 바꿨다.
- 섹션 관리 — 프로젝트 화면(
/project/p/{id})에서 "이 프로젝트" 스코프로 볼 때만 보드 컬럼에 관리 UI가 붙는다(이름변경·완료토글·삭제·"+ 섹션 추가" — 아사나처럼 마지막 섹션 바로 오른쪽,renderBoard가 매번 캔버스 끝에 붙인다). 컬럼 헤더를 드래그해서 순서를 바꿀 수 있다(카드 드래그와 같은 네이티브 HTML5 DnD,PUT /api/projects/{id}/stages/order재사용). "전체 프로젝트" 스코프(여러 프로젝트를 섹션 '이름'으로 합쳐 보는 예전 방식)에서는 섹션을 하나로 특정할 수 없어 관리 UI가 없다. - 하위 작업(subtask) — 새 테이블이 아니라
tasks.parent_task_id재사용 (부모 삭제 시 CASCADE). 작업 편집 팝업 안에 인라인으로 표시되며(체크박스+ 제목+담당자+마감일, 한 줄에서 바로 저장), 보드/캘린더/목록에는 최상위 작업만 카드로 뜬다(하위 작업은 부모 카드의 "N ⤷ ▾" 토글로 — 누르면 아사나처럼 카드 아래로 하위 작업 목록(완료 체크·제목·마감·담당자)이 펼쳐진다. 펼친 상태는 페이지에 머무는 동안 유지). 섹션을 갖지 않는다(칸반에 안 보이므로). 펼친 하위 작업 한 줄을 다른 카드로 드래그하면 그 작업의 하위 작업으로 옮겨진다 (POST /api/tasks/{id}/move-parent{parent_task_id}→db.move_subtask, 활동subtask_moved). 받는 쪽은 같은 프로젝트의 최상위 작업만(순환 방지), 하위 작업의 하위 작업은 함께 따라간다. 하위 작업이 없는 카드도 같은 모양의 빈 토글(⤷ ▾,.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.pyJinja 전역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— 프로젝트↔사용자 배정. role(manager|member),UNIQUE(project_id, user_email).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-FKON DELETE CASCADE, NULL=최상위 작업).task_project_links(003) — 멀티호밍.(task_id, project_id)UNIQUE,stage_idnullable(그 프로젝트 안에서의 섹션).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로 활성 메뉴 표시) — 수신함 · 내 작업 · 프로젝트 트리(+ 새 프로젝트) · "전체 멤버". 프로젝트 트리는 수신함·내 작업·휴지통·프로젝트 네 화면 모두 같다 — 관리자에게 드래그 순서 변경(⣿)·✎ 수정·× 삭제·우클릭 메뉴(공용initSideTree, 모달은project/_side_modals.html을 각 화면이 include). "전체 멤버"는 관리자(is_admin)에게만 그리고 수신함·내 작업·프로젝트 화면 모두에서 나온다. 아이콘 클릭 = 그 사람의 담당 작업 팝업(_member_tasks_modal.html,initMemberTasks) — 프로젝트 화면에선 더블클릭 시 그 자리에서 편집 팝업, 다른 화면에선 그 작업의 프로젝트 화면(?task=)으로 이동. - 프로젝트 (
/project/p/{id}): 좌측 사이드바(공용_side.html) + 우측 뷰 토글. 좌측 "내 작업"는 접이식 패널이 아니라/project/로 가는 링크다. 이 프로젝트의 멤버는 화면 위 제목 오른쪽에 겹친 아바타로 둔다(.pj-title-members) — 마우스를 올리면 이름(data-tip,initHoverTips가 위임 방식이라 동적 요소에도 붙는다), 클릭하면 그 사람이 이 프로젝트에서 맡은 작업 팝업, 우클릭(관리자)하면 제외, 옆+는 멤버 배정. 좌측 트리의 작업 클릭도 페이지 이동 없이 바로 팝업(이미 로드된 전체 작업 데이터 사용). 좌측 맨 위 수신함(미확인 @태그 배지)과 내 작업(접이식, 기본 접힘 — 작업을 고르면 팝업이 열리며 다시 접힌다)가 있다. 예전 화면 오른쪽에 항상 떠 있던 "내 작업" 패널은 없앴고 이 메뉴가 그 역할을 대신한다(레이아웃도 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도 그 폭에 맞춤 — 안 그러면 이틀 간격 라벨로 바뀜). 사용자가 옮긴 구간은 localStoragepj_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 가 라벨 요소를 재사용하며 옮길 때 다른 날짜에 색이 남아 폐기. 날짜 줄은 늘 두 줄 높이(CSSheight— 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개 + 미완료 작업(섹션별)·작업 합계(완료 상태별) 차트. "예정된 작업 합계
(담당자별)" 차트는 관리자(
is_admin)에게만 보인다(사람별 업무량이 드러나서). 화면 표시만 막는 것 — 작업 데이터 자체는 멤버가 원래 볼 수 있는 범위 그대로다. - 보드 — 섹션별 칸반.
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.pysend_email(...)—SMTP_HOST있어야 발송, 없으면 skip. STARTTLS/SSL/평문 지원.- env:
SMTP_HOST/PORT/USER/PASSWORD/FROM/TLS, 수신자PROJECT_NOTIFY_EMAIL(쉼표, 비우면 admin 전원). - 트리거: 작업 신규 배정(생성/수정 시 담당자 변경) · 완료단계 진입.
BackgroundTasks비동기, 실패는 로그만.
5. 배포
# 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
# 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 없음)이면 숨긴다. 그 아래 메타(담당자·섹션·우선순위·마감일 한 줄 — 마감일은 캘린더 아이콘 버튼, 좁으면 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(bodyemail, 없으면 나),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_remindersUNIQUE(작업·종류· 마감일·수신자)로 한 번만 — 재기동·중복 실행에도 안전, 마감일을 바꾸면 다시 알린다.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)은 대상 아님. - 보드 섹션 머리 이름 옆에 기본 담당자 아바타(작게, 툴팁). 새 작업 팝업은 그 섹션 기본 담당자를 미리 채운다.
- 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). - 관리자 전용: 좌측 "휴지통" 메뉴·
/project/trash화면·POST /project/api/trash/{id}/restore모두is_admin. 복구는 원래 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 없이도 동작.
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()으로 나눈다. localStoragepj_ui_scale.
6-9. 연간 목표 (마이그레이션 013)
- 좌측 사이드바 개인 메뉴 맨 아래 목표(
_side.html#pj-side-goal) — 누르면 바로 아래 연도 목록이 접혔다 펴진다 (initGoalSide, localStoragepj_goal_open, 목표 화면에선 항상 펼침). 연도 목록은router._goal_years_nav(goal_years최근 연도 먼저 + 올해는 항상, 013 미적용이면 올해만) — 사이드바를 그리는 모든 화면 컨텍스트에goal_years. - 연도를 누르면
/project/goals/{연도}(goals.html) — 스프레드시트 같은 한 표. 머리 줄(연간·112월)과 왼쪽 두 칸은 고정, 이번 달 열 강조. 가로 스크롤 때 3열(구분·항목·연간)까지 고정 — 연간 열12월·상/하반기)은 머리 칸 오른쪽 끝을 끌어 너비 조절(더블클릭 = 기본 너비) — 브라우저별 localStorageposition: sticky; left: 1열+2열 너비, 경계 그림자. 월 칸 너비 85px·연간 90px(여백 포함,box-sizing: border-box), 머리·왼쪽 이름 가운데 정렬(왼쪽 이름은 세로도 가운데 — 관리자 도구는 칸 아래에 떠 있는 막대라 자리를 차지하지 않음). 모든 열(구분·항목·연간·1pj_goal_col_w(키c1·c2·y·m1320px·CSS 변수m12·h1·h2, 기본값과 다른 칸만 저장). 이름 두 칸은 48--goal-c1-w·--goal-c2-w, 나머지는 40~600px·머리 칸의--cw(table-layout: fixed 라 머리 칸 너비가 열 너비). 반기 접기 애니메이션의 월 칸 안쪽 고정 폭은--fold-w(병합 칸 = 걸친 월 너비 합)로 JS 가 넣는다.- 틀 고정 — 세로 스크롤에도 머리 줄 + 숫자 지표(매출·로아스) 줄까지 위에 붙어 있다. 지표 칸
position: sticky+ 줄마다--kpi-top(머리 줄 높이 + 앞 지표 줄 높이 합,stickKpi, 창 크기 바뀌면 다시 잼). z-index: 영역 이름 칸 2(마우스 올림 6) < 지표 칸 7 < 지표 이름 칸 8 < 머리 줄 9 < 머리 이름 칸 10. - 숫자 지표
goal_metrics(year·metricsales|roas·kindtarget|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권한자 전원, 입력·구조 변경은 관리자만(_require_admin, 화면도 관리자에게만 입력칸·도구). - 연도 추가(
POST /api/goals/years {year})는 가장 가까운 이전 연도(없으면 다음 연도)의 영역·줄 구조를 글 없이 복사, 목표가 하나도 없으면store.DEFAULT_GOAL_AREAS(상품·마케팅·컨텐츠·유통[콜라보·인플·쿠팡·기타]). 없는 연도 화면은 관리자에게 "목표 만들기" 버튼(GET 에서 자동 생성하지 않는다). 연도 삭제는 연도를 직접 입력해야 진행(CASCADE 전부 삭제). - API(전부 관리자):
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초 멈춤·칸 떠남·페이지 떠남(keepalive)에 저장, 저장되면 칸 테두리가 잠깐 초록. 영역/줄 추가·이름·순서·삭제는 저장 뒤 새로고침(스크롤 위치 sessionStorage 로 되살림), 영역 색은 팝업(body 에 붙임)에서 바로 바뀜. 목표 테이블은 live-version 트리거에 넣지 않았다(입력 중 새로고침 방지). - 추후: 매출 실적을 실적 모듈(
performance_db)에서 월별로 자동으로 채우기.
6-9-0. 1~4분기 칸 (마이그레이션 017, 2026-10-01 — 상·하반기 대신)
- 열 순서 — 연간 · 1
3월 · 1분기 · 46월 · 2분기 · 79월 · 3분기 · 1012월 · 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_cellsCHECK 를 0~16 으로 넓힌 뒤에만 저장(미적용이면 읽기 전용 칸 + API 503GoalMigration017Needed, 적용 여부 =db._goal_quarters→board.quarters). - 병합 — 가로는 같은 분기 월 칸끼리만, 연간·분기 칸은 세로로만(
goal_col_group: year · q1q4 · months14). 017 은 분기를 넘던 예전 반기 병합(예: 2~4월)을 그 분기 끝 월까지로 줄이고(글은 시작 칸 그대로), 한 칸짜리가 된 병합 행은 지운다. 화면(_goal_area_layout)도 분기를 넘는 병합은 잘라 그린다(017 전에도 안전). - 숫자 지표 — 분기 칸 = 그 분기 월 합계, 달성률 = 분기 실적 합계 ÷ 분기 목표 합계(
SUM_SCOPES연간 + 4분기), 로아스 분기 = 매출 가중 평균(연간과 같은 규칙). - 분기 접기 — 분기 머리 칸 아무 곳이나 누르면(
.pj-goal-fold-th, 너비 조절 손잡이를 끈 직후 0.3초 클릭은 무시) 그 분기 월 칸을 접었다 편다. 아이콘은 엑셀 열 그룹처럼 네모 안 − (펼침, 누르면 접힘) / + (접힘) — 바뀔 때 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월 · 상반기 · 712월 · 하반기. 템플릿 컨텍스트halves((반기, 월 목록, 글 칸 번호 13|14, 이름)), 월 칸은pj-goal-m+data-h="1|2", 반기 칸은pj-goal-half-col.- 숫자 지표: 매출 목표·실적의 반기 칸 = 그 반기 월 합계(
data-scope="13|14", 연간은0), 달성률은 연간과 같은 규칙 (그 반기 목표 합계 대비 실적,SUM_SCOPES). 로아스 연간·반기(목표·실적) = 기간 매출 ÷ 기간 광고비 — 광고비를 따로 적지 않아 월마다 매출 ÷ 로아스로 환산해 합친 매출 가중 평균(같은 목표/실적 매출 사용), 로아스가 있는 달 중 매출이 없는 달이 있으면 단순 평균 (말풍선에 방식·개월 수). 화면 계산(저장 안 함), 숫자 칸을 고치면 바로 다시 계산. - 업무 영역 글:
goal_cells.month13 = 상반기, 14 = 하반기(014 가 CHECK 를 0~14 로 넓힘). 014 미적용이면 반기 글 칸은 보기 전용 빈 칸이고, 저장 API 는 503 "마이그레이션 014 필요"(store.GoalMigration014Needed).
- 숫자 지표: 매출 목표·실적의 반기 칸 = 그 반기 월 합계(
- 반기 접기 — 반기 칸 머리의 버튼(
.pj-goal-fold, 펼침 ‹ / 접힘 뒤집힌 › + 강조색)이 그 반기 월 칸을 접었다 편다. 보기 전용 사용자도 쓸 수 있고 상태는 브라우저별 localStoragepj_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 면 칸 너비가 내용을 따라가 펼칠 때 애니메이션 없이 한 번에 튄다). 표는 칸 너비 합만큼 늘어난다. 접힌 칸의 글 칸 높이는 잴 수 없어(fit이offsetParent없으면 건너뜀) 펼친 뒤 다시 잰다.prefers-reduced-motion이면 애니메이션 없이. - 영역·줄 이름 바로 수정(관리자) — 이름(
[data-goal-edit="area|row"])을 누르면 contenteditable(startNameEdit) — Enter·칸 떠남 = 저장, Esc = 취소, 붙여넣기는 글자만. 영역 이름 빈 값은 되돌림(서버도 400), 줄 이름은 빈 값 허용(빈 줄 이름은 마우스를 올리면 "줄 이름" 자리 표시). 예전 ✎(prompt) 버튼은 없앴다. 색·순서·줄 추가·삭제는 우클릭 메뉴(아래). - 구역·항목 칸 메뉴 = 우클릭(2026-10-01) — 마우스 오버 도구 막대(색·↑·↓·+·×)는 뺐다(옆 칸으로 갈 때 걸리거나 고정되는 문제).
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) × 화면 순서(연간 · 16월 · 상반기 · 712월 · 하반기 =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 (나눈 뒤 이동), 묶음 첫 줄 도구 막대엔 ↑↓ 없음. 새 연도 만들기는 묶음도 복사한다.
- 칸 아무 곳이나 눌러 입력(엑셀처럼) — 글 칸(textarea)은 글 높이만큼이라, 옆 칸 글이 길거나 세로 병합으로 칸이 길면 아래쪽을 눌러도
입력이 안 됐다. 이제 업무 영역 글 칸(
td.pj-goal-texttd)·회의록 글/금액 칸 아무 곳이나 누르면 그 칸 입력으로 들어가고 커서는 글 끝. 칸 전체가 글 입력 마우스 모양. Shift+클릭(범위 고르기)·끌기(병합 선택)는 그대로. 입력 중 테두리·밝은 배경도 입력칸이 아니라 칸 전체(td:focus-within, 회의록 표도 같음). - 고른 칸 내용 지우기(엑셀 Del) — 끌기·Shift+클릭으로 고른 범위에서 Del → 범위 안 글 칸을 비우고 칸마다 바로 저장, 안내 토스트.
바로 직전 지우기는 Ctrl+Z 로 되돌림(되돌린 값도 저장). 입력 중(글 칸에 커서)일 때의 Del·Ctrl+Z 는 평소 글자 편집.
우클릭 메뉴에도 "내용 지우기 (Del)"(
ink_eraser, 고른 범위에 글이 있을 때). - 우클릭 메뉴 아이콘 —
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)
지난주 목표·결과를 리뷰하고 월 목표를 달성하기 위한 이번주 목표·할 일을 정하는 회의(WBR — Weekly Business Review)용. 참고한 도구 방식: WBR 지표 자동 집계(목표 대비 누적·주당 필요 매출 = 페이싱), Fellow·Notion 회의 템플릿의 이월(지난 회의 항목을 다음 회의로 이어받아 나란히 리뷰), OKR 체크인 평가(완료/일부/미달).
- 화면
/project/goals/{연도}/meetings/{월}?week={월요일}(goal_meeting.html,initGoalMeeting) — 목표 표 월 머리를 누르면 열린다.- 주차 탭: 그 달의 주(월
일,10/4 는 9월 마지막 주). 다른 달의 주를store.month_weeks) — 1주차 = 그 달 첫 월요일이 있는 주, 주는 월요일이 속한 달의 것 (2026-10-01 사용자 기준. 예: 2026년 10월 = 10/5·12·19·26 주, 9/28?week=로 열면 그 달 회의록 주소로 303. 점 = 회의록 있음, "이번 주" 꼬리표. 기본 선택 = 이번 주(그 달 주면) 아니면 1주차. ‹ 이전 달 · 다음 달 › 링크, ← 목표 표. - 월간 목표·누적은 늘 1일~말일(주차와 따로): 월 누적 실적 = 1일 ~ 이 주 앞(지난주 일요일, 1주차면 첫 월요일 전날)까지, 주당 필요 매출 = (월 목표 − 누적) ÷ 그 달 남은 주 수(이 주 포함).
- 머리 배치: 왼쪽 = [🚩 {연도}년 목표] 버튼(연간 목표로, 큰 강조 버튼
.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). - 표 머리 "지난주 리뷰 (MM/DD ~ MM/DD)" = 지난주 월~일(
prev_week·prev_week_end). - 첫 회의록 기본 줄 마케팅 "메타"(예전 "메타(숫자)" — 017 이 그 이름 줄만 "메타"로 바꿈).
- {월}월 계획(
router._month_plan,.pj-meet-plan, 머리 왼쪽.pj-meet-headleft안 — 제목 줄 아래·달력 왼쪽): 연간 목표 표의 그 달 열 글을 업무 영역별 작은 카드로 (영역 색,항목: 글, 빈 칸·글 없는 영역은 뺌). 가로 병합 칸(예: 9~10월)에 적은 글도 그 달 계획으로 보이고 범위를 오른쪽에 작게, 세로 병합은 한 번만, 묶인 줄(016label_cont)은 묶음 항목 이름. 목표 표가 없으면(013 미적용) 칸 자체를 숨김, 읽기만. - 줄(구역 = 목표 표 업무 영역, 표의 구역 칸 rowspan): 항목 | 이번주 할 일·행사 | 정량 목표(원, 예전 이름 "목표 금액") ‖ 지난주 리뷰: 지난주 할 일 |
지난주 목표 | 결과 | 달성률 | 평가(— · 완료 · 일부 · 미달). 지난주 칸 = 이 줄의
carry_from(지난 회의록 같은 줄). 결과는 그 줄이 쇼핑몰 연결(marketplace_code)이면 실적 모듈의 그 주(지난 회의록 주 월일) 그 쇼핑몰 매출 자동("자동" 표시), 아니면 직접 입력 — 지난 회의록 줄의오늘, 목표 대비 %)도 보인다.result_amount·status에 저장(그 주 결과는 그 주 줄에 남는다). 달성률은 저장 즉시 화면 계산. 지난 회의록 주가 아직 시작 전이면 "진행 전"(0 으로 보이지 않게), 연결한 쇼핑몰이 실적 모듈에서 사용 중이 아니면(사용 OFF·없는 코드) "실적 미사용" 표시 + 직접 입력. 자동 결과 말풍선 = 쇼핑몰·기간, 0 이면 "그 기간 실적 없음 — [매출 업데이트]" 안내. 쇼핑몰 연결 줄은 정량 목표 아래에 이번주 실적(이 주 월요일 - 매출 자료 갱신(
initMeetingSync, 화면 표시 없음 — 2026-10-01 상태 줄·[매출 갱신] 버튼은 요청으로 뺐고#pj-meet-sync는 기간만 가진 숨은 요소): 주차를 열면 실적 모듈POST /performance/api/sync {from: 지난주 월요일, to: 이번 주 일요일·오늘 중 이른 날, background: true}로 쇼핑몰에서 매출을 한 번 더 받고(진행 n/m 쇼핑몰·받은 자료), 끝나면 이 화면을 서버에서 다시 받아 숫자 칸만 바꿔 끼운다(머리 카드·자동 결과·달성률·이번주 실적 — 입력 중인 칸·직접 입력 결과 칸·저장 안 된 글은 그대로). 같은 주는 브라우저별 10분에 한 번만 자동(sessionStoragepj_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 에서 자동 생성 안 함): 앞선 가장 가까운 회의록이 있으면 그 줄(구역·이름· 색·쇼핑몰 연결·순서)을 글 없이 이어받고carry_from연결, 없으면 그 해 목표 표 업무 영역마다 기본 양식 줄(store.MEETING_TEMPLATE— 상품15 / 메타·구글·네이버·기타.신규 / 내용15 / 신규 인플루언서·콜라보·쿠팡·네이버·gs·토스·애터미·해외·오프라인·기타, 없는 구역은 빈 줄 하나). 유통 구역 줄 이름으로 쇼핑몰 연결 추측(store.guess_meeting_market: 쿠팡·네이버/스마트스토어·gs·토스·11번가·카페24/자사몰· 롯데·지마켓·카카오·오늘의집 — 마케팅의 "네이버"는 광고라 연결 안 함). 줄 추가 때도 같은 추측. - 편집(관리자, 칸별 즉시 저장 — 목표 표와 같은 권한): 글 0.8초 멈춤·칸 떠남·페이지 떠남(keepalive), 금액 Enter·칸 떠남(서버 표기로 바꿈), 금주 목표 저장 뒤엔 머리 숫자를 서버 계산으로 다시(새로고침). 항목 우클릭·⋯ 메뉴: 위/아래에 줄 추가 · 위로/아래로(같은 구역 안) · 쇼핑몰 연결(결과 자동)…(연결 안 함 + 실적 모듈 사용 중 쇼핑몰, 현재 값 체크) · 줄 삭제. 구역 칸 + = 그 구역 끝에 줄, [+ 구역 추가]. 줄 이름은 눌러서 그 자리에서 수정. 회의록 삭제 = 그 주 줄 전부 삭제, 다음 주 회의록의 지난주 칸은 빈다(carry_from NULL).
- 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.
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분간 첫 결과를 돌려준다(웹 프로세스 메모리, 단일 워커 기준).
작업 창 댓글 목록도 댓글별 첨부(이미지 미리보기·파일명 다운로드, 이스케이프)를 보여 주고, 첨부 파일 목록엔 "댓글" 표시.
마감 알림 — 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__ 가 있을 때만 열린다.
기존 데이터 점검(조회만 — 운영 교정은 따로 승인 후)
-- 시작일 > 마감일(프로젝트·작업), 같은 날 시각 역전
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;
교정안: 날짜 역전은 담당자와 확인해 한쪽을 고치고, 빈 댓글은 작성자 확인 후 삭제, 완료 섹션 미완료는 완료로 표시하거나 섹션을 옮긴다. 권한을 잃은 사람의 담당자·멘션·협업자 기록은 지우지 않아도 된다(화면·알림은 이미 지금 권한으로 거른다).
7. 추후 단계
작업 라벨(태그 분류) · 반복 작업 · 템플릿 · 작업 의존성 · 하위 작업의 하위 작업(다단계 중첩, 아사나도 UI상 1단계만 허용해 현재 의도적으로 안 함).