A "회의록 보드" button next to attendees opens the week's Google Slides deck in its own window. The deck is found (Drive appProperties) or created in the shared drive MEETING_BOARD_FOLDER_ID as one BLANK slide, named like "10월 2주차 (10/5~10/11)". Needs a token with Drive and Slides scopes; the authorize script now requests them. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
120 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·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 글꼴 로딩을 확인하고, 실패하면 이전 설정과 열린 창을 유지해 재시도할 수 있다.
멤버 이름 표기 — 이메일 아이디의 첫 글자만 대문자(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단계 구조
화면 조정(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-headheight 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.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
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
# 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. 팝업이 막히면 허용 안내 토스트. 그 아래 메타(담당자·섹션·우선순위·마감일 한 줄 — 마감일은 캘린더 아이콘 버튼, 좁으면 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). 머리·왼쪽 이름은 가로 가운데 정렬이며, 업무 영역의 이름(1·2열)은 세로 가운데 정렬, 목표 글은 상단 정렬이며 위·아래 여백은 각 6px이다. 행 높이는 가장 높은 글 칸에 맞추고 글이 줄면 함께 줄어든다. 모든 열(구분·항목·연간·1pj_goal_col_w(키c1·c2·y·m1m12·q1q4, 기본값과 다른 칸만 저장). 드래그는 이름 두 칸 48320px·CSS 변수600px·머리 칸의--goal-c1-w·--goal-c2-w, 나머지 40--cw로 조절한다. 자동 맞춤은 긴 문단에 맞게 최대 너비를 넘어도 저장·복원한다. 분기를 펼칠 때도 지정한 열 너비를 그대로 사용한다.- 틀 고정 — 세로 스크롤에도 머리 줄 + 숫자 지표(매출·로아스) 줄까지 위에 붙어 있다. 지표 칸
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초 멈춤·칸 떠남에 저장, 저장되면 칸 테두리가 잠깐 초록, 실패하면 빨간 테두리(입력값 유지). 저장은 공용createFieldSaver(6-9-3 — 같은 칸 요청 직렬화, 보낸 값만 저장됨으로, 실패 시 초안 유지·localStorage 초안 백업, 페이지 떠남 보호). 영역/줄 추가·순서·삭제·병합은 먼저 저장 안 된 글을 저장하고(실패하면 작업 중단) 그 자리에서 다시 그림(refreshTable), 영역 색은 팝업(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분기), 로아스 분기 = 매출 가중 평균(연간과 같은 규칙). - 업무 영역 추가 · 줄 추가는 묻지 않고 바로(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월 · 상반기 · 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 면 칸 너비가 내용을 따라가 펼칠 때 애니메이션 없이 한 번에 튄다). 표는 칸 너비 합만큼 늘어난다. 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) × 화면 순서(연간 · 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 (나눈 뒤 이동), 묶음 첫 줄 도구 막대엔 ↑↓ 없음. 새 연도 만들기는 묶음도 복사한다.
- 선택한 글자 서식(관리자, 2026-10-02) — 목표 업무 영역 글 칸은
.pj-goal-text[contenteditable]. 같은 칸의 글자를 드래그해 선택하면 셀 상단 중앙을 기준으로 셀 위에 엑셀 형태 도구가 나타난다(여러 줄 글의 어느 줄을 선택해도 동일 위치). 아이콘은 처음 엑셀 형태 도구 크기의 80%이다. 밑에 현재 색상 선을 둔가+드롭다운은 기존 12색 견본,가+위/아래 화살표는 크기 2px 증감(10~32px, 혼합 크기는 조각마다 증감), 굵게·기울임·밑줄은 적용 상태가 보이는 토글 버튼. 서식 초기화는 구분선 뒤의 지우개 아이콘(14.4px)으로 표시하며 접근성 이름·도움말은서식 초기화이다. 모든 버튼은 24px 높이, 서식 바는 위아래 여백 4px로 한 줄에서 34px 높이. 서식 초기화는 선택 범위의 모든 서식만 제거하며 글은 유지한다. 기존createFieldSaver의 자동 저장·실패 재시도·임시 복구를 재사용한다.goal_cells.bodyTEXT에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-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 을 통째로 옮긴다. 보는 사람마다 브라우저에 기억(localStoragepj_meet_order:{로그인 이메일},.pj-wrap[data-me]). - 표 머리 "지난주 리뷰 (MM/DD ~ MM/DD)" = 지난주 월
일() 회의록 없음", 회의록은 있는데 그 줄이 없으면 "지난주 회의록에 없는 줄"). 예전엔 몇 주 전 회의록 줄이 지난주 날짜 아래 보였다(점검 버그 5).prev_week·prev_week_end) — 줄의 지난주 칸·결과·달성률·머리 전주 목표도 정확히 이 주(7일 전) 회의록만(그 주 회의록이 없으면 머리에 "— 이 주 회의록 없음", 줄은 "지난주(MM/DD - 첫 회의록 기본 줄 마케팅 "메타"(예전 "메타(숫자)" — 017 이 그 이름 줄만 "메타"로 바꿈).
- {월}월 계획(
router._month_plan,.pj-meet-plan, 머리 왼쪽.pj-meet-headleft안 — 제목 줄 아래·달력 왼쪽): 연간 목표 표의 그 달 열 글을 업무 영역별 작은 카드로 표시(영역 색,항목: 글, 빈 칸·글 없는 영역은 뺌). 굵게·기울임·밑줄·글자 색상·줄바꿈·들여쓰기를 유지하고 글자 크기만 카드 기본값을 사용(goal_text_html(include_size=False)), 원본 셀 서식은 변경하지 않는다. 가로 병합 칸(예: 9~10월)에 적은 글도 그 달 계획으로 보이고 범위를 오른쪽에 작게, 세로 병합은 한 번만, 묶인 줄(016label_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분에 한 번만 자동(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 에서 자동 생성 안 함): 줄이 있는 앞선 가장 가까운 회의록, 없으면 뒤에 있는 가장 가까운 회의록(다음 주를 먼저 만든 경우)의 줄(구역·이름·색·쇼핑몰 연결·순서)을 글 없이 이어받고 원본 줄의 연결키(line_key)를 그대로 (앞선 원본이면carry_from도 이력으로 기록), 둘 다 없으면 그 해 목표 표 업무 영역마다 기본 양식 줄(store.MEETING_TEMPLATE— 상품15 / 메타·구글·네이버·기타.신규 / 내용15 / 신규 인플루언서·콜라보·쿠팡·네이버·gs·토스·애터미·해외·오프라인·기타, 없는 구역은 빈 줄 하나). 유통 구역 줄 이름으로 쇼핑몰 연결 추측(store.guess_meeting_market: 쿠팡·네이버/스마트스토어·gs·토스·11번가·카페24/자사몰· 롯데·지마켓·카카오·오늘의집 — 마케팅의 "네이버"는 광고라 연결 안 함). 줄 추가 때도 같은 추측. - 편집(관리자, 칸별 즉시 저장 — 목표 표와 같은 권한, 공용
createFieldSaver6-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/14 · 511 · 1218 · 1925 · 2631, 2026-08 = 8/1(토)9 · 1016 · 1723 · 2431(월). 헬퍼:week_period(날짜)·prev_week_period(시작일)(= "지난주", 앞 달 마지막 주차일 수 있음) ·week_number·validate_period_start(새 회의록·주차 목표는 주차 시작일만). 회의록week_start= 주차 시작일(월요일이 아닐 수 있음). 화면?week=에 아무 날짜(예전 월요일 주소)를 주면 그 날짜가 든 주차로. 작은 달력은 월요일 시작 줄 그대로, 줄을 누르면 그 줄의 이 달 날짜가 든 주차(한 주차가 두 줄일 수 있음). - 지난주 = 바로 앞 주차(
db.get_meeting이store.prev_week_period로 찾음) 회의록의 같은 연결키 줄. - 위쪽 고정 영역(
#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-rnotetextarea, 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 에 붙음, 보기만 하는 사람은 값만).PUT /project/api/goals/{연도}/week-targets/{월} {weeks: {주차 시작일: 값|""}}(관리자) → 저장 후 그 달 주차 합계를goal_metrics(sales, target)에 쓴다(모두 비면 월 목표도 지움). 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/2830)로 그대로 남고, 10월 1주차(10/14)는 새로 만든다(그래서 10/5 주차의 지난주 리뷰는 10/1~4 회의록이 생겨야 채워진다). - 코드는 020 전에도 동작(결과 글 보기만, 주차 목표 없음, 월요일 아닌 주차 회의록 만들기만 503 안내).
- 회의록 보드(2026-10-07): 참석자 오른쪽 [회의록 보드] → 그 주차의 빈 Google 슬라이드를 독립 창(
window.openpopup, 창 이름pj_meet_board_{주차})으로. 누르는 순간 빈 창을 먼저 열고(팝업 차단 회피)POST /project/api/goals/meetings/{주차 시작일}/board(프로젝트 권한자 누구나) 가 준 주소로 바꾼다. 서버(app/integrations/google_slides.py)는 공유 드라이브MEETING_BOARD_FOLDER_ID(기본 0AGF3CIEboPQiUk9PVA)에서 Drive appPropertiesdbxMeetingWeek = 주차 시작일인 슬라이드를 찾고, 없으면 만든다 — 이름{월}월 {n}주차 ({기간})(router.meeting_board_title), 첫 장의 제목·부제목 틀(TITLE 레이아웃)을 지우고 틀 없는 BLANK 한 장만. 파일 이름을 바꿔도 같은 보드, 휴지통에 버리면 다음에 새로 만든다. 인증은 Google 시트 설정 재사용 + Drive·Slides 범위 (GOOGLE_SLIDES_OAUTH_REFRESH_TOKEN없으면 시트 토큰 — Drive·Slides 권한으로 재발급 필요, docs/DEPLOYMENT.md). DB 변경 없음. - 정량 목표·결과(금액)에 글(마이그레이션 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 글 칸은keepalivePUT 으로 한 번 더 보낸다 — 브라우저가 끝까지 보낸다는 보장은 없어서 초안 백업이 함께 남는다(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 로 따로 잇는다(운영 적용은 별도 승인·백업 후). 한 주 안 같은 키(정상 데이터엔 없음)는 순서가 뒤인 줄에 새 키. - 적용(운영은 백업·승인 후, 여러 번 돌려도 안전):
적용 전 확인(조회만):
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분간 첫 결과를 돌려준다(웹 프로세스 메모리, 단일 워커 기준).
작업 창 댓글 목록도 댓글별 첨부(이미지 미리보기·파일명 다운로드, 이스케이프)를 보여 주고, 첨부 파일 목록엔 "댓글" 표시.
마감 알림 — 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단계만 허용해 현재 의도적으로 안 함).