feat(project): add help search and detailed guides

This commit is contained in:
2026-10-03 09:41:09 +09:00
parent 7647e4b20f
commit cd0a509215
7 changed files with 648 additions and 58 deletions
+184 -56
View File
@@ -2,7 +2,7 @@
{% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20261003f" />
<link rel="stylesheet" href="/static/project-help.css?v=20261002d" />
<link rel="stylesheet" href="/static/project-help.css?v=20261003a" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
{% endblock %}
@@ -11,7 +11,7 @@
{% block content %}
{# ── 프로젝트 관리 도움말 — 처음 쓰는 사람을 위한 기능 안내(정적 페이지, DB 불필요).
기능이 바뀌면 이 페이지도 같이 고친다(docs/PROJECT_MODULE.md 와 짝). ── #}
<div class="pjh">
<div class="pjh" id="top">
<nav class="pjh-toc" aria-label="도움말 목차">
<p class="pjh-toc-title">목차</p>
<ol>
@@ -34,13 +34,29 @@
<li><a href="#inbox">수신함과 알림</a></li>
<li><a href="#search">전체 검색과 공유 링크</a></li>
<li><a href="#trash">휴지통 (관리자)</a></li>
<li><a href="#goals">연간 목표</a></li>
<li><a href="#meetings">주간 회의록</a></li>
<li><a href="#tips">단축키와 자주 묻는 질문</a></li>
</ol>
</nav>
<div class="pjh-body">
<div class="pjh-search" id="pjh-search" hidden>
<form id="pjh-search-form" role="search" aria-label="도움말 검색">
<label for="pjh-query">도움말 검색</label>
<div class="pjh-search-field">
<input type="search" id="pjh-query" name="q" placeholder="예: 회의록, 셀 병합, 쇼핑몰 연결" autocomplete="off"
aria-describedby="pjh-search-hint pjh-search-status" aria-controls="pjh-results" />
<button type="submit">검색</button>
<button type="button" id="pjh-search-clear" hidden>지우기</button>
</div>
<p class="pjh-search-hint" id="pjh-search-hint">한 글자부터 제목·본문을 검색합니다. 결과를 누르면 해당 설명으로 바로 이동합니다. 여러 단어는 띄어 쓰세요.</p>
</form>
<p class="pjh-search-status" id="pjh-search-status" role="status" aria-live="polite" aria-atomic="true"></p>
<ol class="pjh-results" id="pjh-results" aria-label="도움말 검색 결과" hidden></ol>
</div>
<!-- 머리말 + 빠른 시작 -->
<header class="pjh-hero" id="top">
<header class="pjh-hero">
<h1>프로젝트 관리 도움말</h1>
<p>프로젝트 관리는 <b>아사나(Asana) 방식</b>으로 팀의 일을 정리하는 도구입니다.
프로젝트 안에 할 일(작업)을 만들고, 담당자와 마감일을 정하고, 댓글로 이야기하며 끝까지 챙깁니다.
@@ -52,6 +68,7 @@
<div class="pjh-quick-step"><b>4단계</b>카드를 눌러 설명을 쓰고, 댓글에 <kbd>@</kbd>로 동료를 부릅니다.</div>
<div class="pjh-quick-step"><b>5단계</b>일을 마치면 <span class="pjh-ui">✓ 완료로 표시</span>를 누릅니다.</div>
</div>
<p class="pjh-quick-links">계획과 회의를 준비한다면 <a href="#goals">연간 목표</a> · <a href="#meetings">주간 회의록</a> 설명부터 읽어 보세요.</p>
</header>
<!-- 1. 용어 -->
@@ -89,34 +106,8 @@
<li><b>내 작업</b> — 내가 담당자인 작업 모음. 숫자 배지는 아직 끝나지 않은 작업 수입니다. (<a href="#mytasks">15장</a>)</li>
<li><b>휴지통</b> — 지운 작업을 3개월 보관합니다. 관리자에게만 보입니다. (<a href="#trash">19장</a>)</li>
<li>왼쪽 메뉴의 오른쪽 경계를 끌면 너비를 최소 170px까지 줄일 수 있습니다. 경계에 키보드 포커스를 놓고 좌우 방향키로도 조절할 수 있으며 너비는 내 브라우저에 기억됩니다. 전체 멤버는 메뉴 너비에 맞춰 4열 또는 3열로 자동 배치됩니다.</li>
<li><b>목표</b> — 누르면 바로 아래에 연도가 펼쳐집니다. 연도를 누르면 오른쪽에 그해 전체 목표가 한 표로 나옵니다 —
맨 위에 <b>매출</b>(목표·실적·달성률)과 <b>로아스</b>(목표·실적, 단위 %)를 달마다, 그 아래에 <b>업무 영역</b>(상품·마케팅·컨텐츠·유통 등)별로
연간·분기·월별 계획을 적습니다. 3·6·9·12월 오른쪽에 <b>1~4분기</b> 칸이 있고, 매출의 <b>연간·분기</b> 칸은 월 합계,
<b>달성</b>은 실적÷목표(100% 이상 초록)로 저절로 계산됩니다. 분기 칸 머리의 <b>‹</b> 버튼을 누르면 그 분기의 월 칸 3개가
접히고, 다시 누르면 펼쳐집니다(접힌 상태는 내 브라우저에 기억). 월 이름을 누르면 그 달 <b>주간 회의록</b>이 열립니다.
<b>입력은 관리자만</b> 할 수 있고(칸을 고치면 바로 저장), 다른 직원은 보기만 합니다. 관리자는 <b>+ 연도 추가</b>로 새해 목표를
만듭니다(이전 연도의 업무 영역 구성을 그대로 가져옴). 글 칸에서 <b>글자를 드래그해 선택</b>하면 선택한 셀 상단에 나타나는 엑셀 형태 서식 도구로 <b>색상·크기·굵게·기울임·밑줄</b>을 바꿀 수 있으며 선택한 글자에만 적용됩니다.
위/아래 화살표가 붙은 글자 버튼은 크기를 <b>2px씩</b> 키우거나 줄입니다(10~32px). 굵게·기울임·밑줄 버튼은 다시 누르면 해당 서식을 해제합니다.
<span class="pjh-ui">서식 초기화</span>는 선택한 글자를 기본 서식으로 되돌리며 내용은 유지합니다. 서식도 자동으로 저장됩니다. 색상은 12색의 네모 견본에서 고릅니다.
<b>모든 행의 셀 오른쪽 경계</b>를 끌어 열 너비를 조절하고, 더블클릭하면 <b>그 열의 가장 긴 문단에 맞춰</b> 자동으로 조절합니다.
직접 넣은 줄바꿈은 유지하며 글자 크기·굵기·여백도 반영합니다. 병합 칸에서는 다른 열 너비를 유지하고 오른쪽 끝 열만 맞춥니다. 너비는 내 브라우저에 기억됩니다.
셀을 <b>우클릭</b>하면 <span class="pjh-ui">현재 열 너비 자동 맞춤</span>·<span class="pjh-ui">전체 열 너비 자동 맞춤</span>을 사용할 수 있습니다. 전체 맞춤에는 접힌 월 열도 포함됩니다.
관리자는 글 칸 하나를 클릭한 뒤 <b>위·아래·왼쪽 테두리</b>를 잡아 다른 글 칸으로 끌면 <b>내용과 글자 서식을 함께 이동</b>할 수 있습니다. 대상에 글이 있으면 덮어쓰기를 확인하며, <kbd>Esc</kbd>로 끌기를 취소합니다.
<b>행 높이는 가장 높은 글 칸에 맞춰</b> 자동으로 늘어나거나 줄어들며, 위·아래 여백은 각각 6px입니다. 짧은 글도 같은 위치에서 상단 정렬됩니다.
영역·줄 이름은 <b>눌러서 그 자리에서 고치고</b>(Enter 저장, Esc 취소),
구역·항목 칸을 <b>우클릭</b>하거나 칸 오른쪽 위의 작은 <span class="pjh-ui">⋮</span> 버튼(마우스를 올리면 보임)을 눌러 색·순서·줄 추가·삭제를 합니다.
키보드로는 <kbd>Tab</kbd>으로 이름 칸·<span class="pjh-ui">⋮</span>로 가서 <kbd>Enter</kbd>(이름 칸 = 이름 고치기, ⋮ = 메뉴), 메뉴 안에서 <kbd>↑</kbd><kbd>↓</kbd>·<kbd>Enter</kbd>,
<kbd>Esc</kbd>로 닫습니다. 터치 화면에서는 ⋮ 버튼이 늘 옅게 보여 손가락으로 누르면 됩니다. 업무 영역 칸은 엑셀처럼 <b>병합</b>할 수 있습니다 — 칸을 마우스로
끌어 여러 칸을 고른 뒤 우클릭 → "셀 병합", 병합된 칸은 우클릭 → "병합 해제"(글은 왼쪽 위 칸에 남음).
가로 병합은 같은 분기의 월 칸끼리만(연간·분기 칸은 세로로만) 되고, 칸들의 글은 순서대로 첫 칸에 모입니다.
<br><b>저장이 안 되면</b>(네트워크 끊김 등) 칸 테두리가 빨갛게 되고 <b>쓴 글은 그대로 남습니다</b> — 다시 입력하거나 칸을 떠나면 다시 저장합니다.
저장 안 된 칸이 있으면 줄·영역 추가·병합·셀 이동은 하지 않고 알려 주며, 그 상태로 페이지를 떠나려 하면 브라우저가 한 번 묻습니다.
글은 내 브라우저에도 잠시 보관되어, 저장되지 못한 채 창이 닫혀도 다음에 열면 되살아납니다(그 사이 다른 사람이 같은 칸을 고쳤으면 되살리지 않음).</li>
<li><b>주간 회의록</b>(목표 표의 월 이름) — <b>지난주 리뷰</b>는 언제나 바로 앞 주(7일 전 월~일) 회의록만 보여 줍니다. 그 주 회의록이 없으면
"회의록 없음"으로 비워 두고, 몇 주 전 결과를 지난주처럼 보이지 않습니다. 회의록을 만드는 순서(다음 주를 먼저 만들어도)와 줄 이름 변경·순서 이동과
관계없이 같은 줄끼리 이어집니다. 실적 모듈에서 매출을 읽지 못하면 그 칸은 0원이 아니라 <b>⚠ 미확인</b>으로 보입니다(필요 매출·달성률도 미확인).
매출 자동 갱신은 평소엔 조용히 돌고, <b>실패하거나 일부 쇼핑몰만 실패</b>하면 숫자 아래에 작은 안내와 <span class="pjh-ui">다시 시도</span>가 나옵니다
(안내의 "마지막 갱신 성공" 시각은 실적 모듈이 기록한 시각). 실적 권한이 없으면 갱신하지 않고 저장된 실적으로 보여 줍니다.</li>
<li><b>목표</b> — 연도를 골라 매출·로아스와 업무 영역별 연간·분기·월 계획을 봅니다. (<a href="#goals">연간 목표 설명</a>)</li>
<li><b>주간 회의록</b> — 목표 표의 월 이름을 눌러 이번주 계획과 지난주 리뷰를 함께 봅니다. (<a href="#meetings">주간 회의록 설명</a>)</li>
<li><b>프로젝트</b> — 내가 멤버인 프로젝트 목록입니다. 누르면 그 프로젝트 화면으로 갑니다. 완료한 프로젝트는 아래 <b>완료 프로젝트</b>에 흐리게 모입니다.</li>
<li><b>전체 멤버</b> — 관리자에게만 보입니다. 사람 아이콘을 누르면 그 사람이 맡은 모든 작업을 한눈에 봅니다.</li>
</ul>
@@ -140,16 +131,17 @@
<p class="pjh-lead">프로젝트 관리 메뉴는 관리자 페이지에서 “프로젝트 관리” 권한을 받은 직원에게 보입니다.</p>
<table class="pjh-table">
<tr><th>할 수 있는 일</th><th>누가</th></tr>
<tr><td>프로젝트 보기</td><td>그 프로젝트의 <b>멤버</b>(또는 관리자). 멤버가 아니면 주소를 알아도 열리지 않습니다.</td></tr>
<tr><td>작업·하위 작업·댓글</td><td>그 프로젝트 멤버 누구나 만들고 고칠 수 있습니다.</td></tr>
<tr><td>프로젝트 보기</td><td>그 프로젝트의 <b>멤버·소유자</b>(또는 관리자). 멤버가 아니면 주소를 알아도 열리지 않습니다.</td></tr>
<tr><td>작업·하위 작업·댓글</td><td>그 프로젝트의 멤버·소유자·관리자가 만들고 고칠 수 있습니다.</td></tr>
<tr><td>작업·섹션·프로젝트 삭제</td><td><b>만든 사람만</b> 지울 수 있습니다(최고 관리자는 예외).</td></tr>
<tr><td>댓글 고치기·지우기</td><td>댓글을 쓴 사람(또는 관리자)만.</td></tr>
<tr><td>새 프로젝트, 프로젝트 수정·순서 바꾸기</td><td>관리자 (<span class="pjh-ui">+</span> · <span class="pjh-ui">✎</span> · <span class="pjh-ui">⣿</span> 버튼이 관리자에게만 보입니다)</td></tr>
<tr><td>새 프로젝트, 사이드바의 프로젝트 수정·순서 바꾸기</td><td>관리자 (<span class="pjh-ui">+</span> · <span class="pjh-ui">✎</span> · <span class="pjh-ui">⣿</span> 버튼이 관리자에게만 보입니다)</td></tr>
<tr><td>멤버 배정·제외, 프로젝트 소유자 바꾸기</td><td>관리자</td></tr>
<tr><td>다른 프로젝트에서 연결돼 온 작업</td><td>원래 프로젝트 멤버가 아니면 <b>읽기만</b> — 내용·댓글·첨부는 보이지만 고치거나 댓글을 달 수 없습니다(연결된 보드 안에서 섹션 옮기기는 됩니다).</td></tr>
<tr><td>멤버에서 빠졌을 때</td><td>그 프로젝트의 작업은 내 작업·수신함·알림·검색에서 사라지고, 예전 링크로도 열리지 않습니다. 새 알림도 오지 않습니다.</td></tr>
<tr><td>휴지통 보기·복구, 전체 멤버, 대시보드의 담당자별 차트</td><td>관리자</td></tr>
<tr><td>목표 보기</td><td>누구나 · <b>목표 입력·연도 추가·업무 영역 편집</b>은 관리자</td></tr>
<tr><td>목표·주간 회의록 보기</td><td>프로젝트 관리 권한이 있는 직원 누구나 · <b>입력·생성·삭제·구조 편집</b>은 관리자</td></tr>
<tr><td>프로젝트 제목 바로 고치기</td><td>그 프로젝트 멤버·소유자·관리자</td></tr>
</table>
</section>
@@ -331,7 +323,7 @@
<li>그 프로젝트에서 들어갈 섹션을 고릅니다.</li>
<li><span class="pjh-ui">다른 프로젝트에 추가</span>를 누릅니다. 빼려면 이름 옆 <span class="pjh-ui">×</span>(연결 해제).</li>
</ol>
<p>작업은 하나라서 어느 보드에서 고쳐도 모두 같이 바뀝니다.</p>
<p>작업은 하나라서 원래 프로젝트에서 고친 내용이 연결된 보드에도 반영됩니다. 원래 프로젝트의 멤버가 아니면 연결된 작업의 내용·댓글·첨부는 읽기만 할 수 있습니다. 연결된 보드 안에서 섹션을 옮기는 것은 가능합니다.</p>
<h3>댓글</h3>
<p>작업 창 맨 아래에 항상 고정된 댓글 칸에 쓰고 <kbd>Enter</kbd>(스크롤해도 그 자리에 있습니다). 칸 오른쪽 <span class="pjh-ui">☺</span>는 이모티콘, <span class="pjh-ui">@</span>는 멤버 태그입니다. 답글은 원 댓글 아래 들여 쓰여 <span class="pjh-ui">↳</span> 표시와 함께 보입니다. 내가 쓴 댓글은 <span class="pjh-ui">✎</span>로 고치고 <span class="pjh-ui">×</span>로 지웁니다. 댓글 속 웹 주소는 링크가 됩니다. 댓글에 붙인 파일은 그 댓글 아래에 보이고(파일만 보낸 댓글도), 첨부 파일 목록에는 <span class="pjh-ui">댓글</span> 표시가 붙습니다.</p>
<p>댓글 대화창에서 파일을 보낼 때 보낼 수 없는 파일(빈 파일, 20MB 초과)이 있으면 댓글을 만들지 않고 그 파일만 빨갛게 표시합니다 — 빼고 다시 보내세요. 인터넷이 끊겨도 쓴 내용과 파일은 그대로 남아 다시 보낼 수 있고, 같은 댓글이 두 번 올라가지 않습니다. @태그는 이 작업을 볼 수 있는 사람만 고를 수 있습니다. 한글을 입력하는 중(조합 중)의 <kbd>Enter</kbd>는 글자 확정만 하고 보내지 않습니다.</p>
@@ -493,7 +485,7 @@
<ul>
<li>작업 편집 창의 <span class="pjh-ui">공유</span> 또는 우클릭 <span class="pjh-ui">작업 링크 복사</span>로 주소를 복사합니다.</li>
<li>받은 사람이 주소를 열면(로그인 전이면 로그인 후) 그 작업이 바로 열립니다. 하위 작업 링크는 하위 작업 자체가 열립니다.</li>
<li>그 프로젝트의 <b>멤버만</b> 열 수 있어 밖으로 새지 않습니다.</li>
<li>현재 그 작업을 볼 수 있는 멤버·소유자·관리자가 열 수 있습니다. 연결된 프로젝트 멤버는 읽기 전용으로 보며, 멤버에서 제외되면 예전 링크로도 열 수 없습니다.</li>
</ul>
</section>
@@ -510,13 +502,161 @@
<div>하위 작업만 따로 지웠는데 상위 작업도 지워진 상태라면, 상위 작업을 먼저 복구해야 합니다.</div></div>
</section>
<!-- 20. 단축키와 FAQ -->
<!-- 20. 연간 목표 -->
<section class="pjh-sec" id="goals">
<h2><span class="pjh-num">20</span>연간 목표</h2>
<p class="pjh-lead">한 해의 매출 목표·실적과 업무 계획을 한 표에서 관리합니다. 숫자는 위쪽 지표에, 실행 계획은 아래쪽 업무 영역에 적습니다. 프로젝트 관리 권한이 있는 직원은 볼 수 있고, 입력·구조 변경은 관리자만 할 수 있습니다.</p>
<h3 id="goals-start">목표 열기와 연도 만들기</h3>
<ol class="pjh-steps">
<li>왼쪽 사이드바 <span class="pjh-ui">목표</span>를 눌러 연도 목록을 펼친 뒤 원하는 연도를 누릅니다. 올해는 목표가 아직 없어도 목록에 보입니다.</li>
<li>관리자는 빈 연도 화면에서 <span class="pjh-ui">해당 연도 목표 만들기</span>, 또는 사이드바의 <span class="pjh-ui">+ 연도 추가</span>로 새 표를 만듭니다.</li>
<li>가장 가까운 이전 연도의 업무 영역·줄 구성을 가져옵니다. 이전 연도가 없으면 다음 연도의 구성을 사용하고, 처음이면 상품·마케팅·컨텐츠·유통으로 시작합니다. 이전 숫자와 계획 글은 복사하지 않습니다.</li>
<li>위쪽 <span class="pjh-ui">매출 단위</span>를 확인한 뒤 월별 숫자와 계획을 입력합니다.</li>
</ol>
<h3 id="goals-metrics">매출·로아스 입력과 달성률 계산</h3>
<table class="pjh-table">
<tr><th>칸</th><th>입력·계산 방법</th></tr>
<tr><td>매출 목표·실적</td><td>관리자가 월별 숫자를 직접 입력합니다. 목표 표의 실적은 회의록의 자동 매출과 별도로 관리하므로 실적 모듈에서 자동으로 채워지지 않습니다.</td></tr>
<tr><td>매출 단위</td><td>예를 들어 단위가 <b>백만원</b>이면 30은 30,000,000원입니다. 단위를 바꿔도 이미 적은 숫자는 자동 환산되지 않으므로 숫자와 단위를 함께 확인하세요.</td></tr>
<tr><td>연간·분기 매출</td><td>해당 기간에 입력한 월 숫자의 합계입니다. 합계 칸에 따로 입력하지 않습니다.</td></tr>
<tr><td>달성</td><td>실적 ÷ 목표 × 100입니다. 월별로 계산하며, 연간·분기는 <b>기간 전체 목표 합계</b> 대비 입력된 실적 합계로 계산합니다. 목표가 없거나 0이면 달성률을 표시하지 않습니다. 100% 이상은 초록으로 표시됩니다.</td></tr>
<tr><td>로아스(ROAS)</td><td>광고비 대비 매출 비율을 <b>% 단위</b>로 적습니다. 예: 300은 300%입니다. 연간·분기는 월 매출과 ROAS로 환산한 광고비를 합쳐 계산하고, 필요한 월 매출이 빠져 있으면 입력된 ROAS의 단순 평균을 사용합니다.</td></tr>
</table>
<p>숫자는 <kbd>Enter</kbd> 또는 칸을 떠날 때 저장됩니다. 숫자 칸을 비우면 값을 지우며, <kbd>Esc</kbd>를 누르면 마지막 저장값으로 돌아갑니다.</p>
<div class="pjh-tip"><span class="material-symbols-outlined">lightbulb</span><div>1~3월 목표가 각각 100이고 1월 실적만 50이면 1분기 달성은 50 ÷ 300 = 약 16.7%입니다. 아직 실적을 넣지 않은 달의 목표도 분기 목표 합계에 포함됩니다.</div></div>
<h3 id="goals-plan">업무 영역·항목·연간·분기·월 계획</h3>
<p>업무 영역은 상품·마케팅처럼 큰 분류, 항목은 그 안의 세부 주제입니다. 한 항목의 연간 칸에는 큰 방향, 분기 칸에는 중간 목표, 월 칸에는 구체적인 실행 계획을 적으면 주간 회의에서 확인하기 쉽습니다.</p>
<ul>
<li><span class="pjh-ui">+ 업무 영역 추가</span>를 누르면 새 영역이 생기고 이름을 바로 고칠 수 있습니다.</li>
<li>영역·항목 이름을 클릭해 고칩니다. <kbd>Enter</kbd>는 저장, <kbd>Esc</kbd>는 취소입니다.</li>
<li>이름 칸을 우클릭하거나 <span class="pjh-ui">⋮</span>를 누르면 영역 색·위아래 순서·줄 추가·삭제 메뉴가 나옵니다. 항목 메뉴에서는 해당 줄 위·아래에 줄을 추가할 수 있습니다. 영역의 마지막 줄은 지울 수 없습니다.</li>
<li>연간 글 칸에서 우클릭해 줄을 추가하면 같은 항목 이름 아래에 여러 줄로 나눠 계획을 적을 수 있습니다.</li>
<li>키보드는 <kbd>Tab</kbd>으로 이름이나 ⋮ 버튼에 이동해 <kbd>Enter</kbd>로 열고, 메뉴에서 <kbd>↑</kbd><kbd>↓</kbd>·<kbd>Enter</kbd>로 선택합니다. <kbd>Esc</kbd>로 닫습니다. 터치 화면에서는 ⋮를 누릅니다.</li>
</ul>
<h3 id="goals-format">글자 서식 바꾸기</h3>
<p>글 칸에서 글자를 드래그해 선택하면 해당 셀 상단에 서식 도구가 나타납니다. <b>선택한 글자에만</b> 12색 견본·크기·굵게·기울임·밑줄을 적용합니다. 크기 버튼은 2px씩 조절하며 범위는 10~32px입니다.</p>
<p>굵게·기울임·밑줄은 다시 누르면 해제됩니다. <span class="pjh-ui">서식 초기화</span>는 선택한 글자의 서식만 되돌리고 내용은 유지합니다. 글과 서식은 입력을 약 0.8초 멈추거나 칸을 떠날 때 자동 저장됩니다.</p>
<h3 id="goals-table">분기 접기·열 너비·행 높이</h3>
<ul>
<li>열은 연간 → 1~3월 → 1분기 → 4~6월 → 2분기 → 7~9월 → 3분기 → 10~12월 → 4분기 순서입니다. <b>분기 머리 칸</b>을 누르면 해당 월 3개가 접힙니다. 네모 안 <b>−</b>는 접기, <b>+</b>는 펼치기입니다.</li>
<li>어느 행에서든 셀의 <b>오른쪽 경계</b>를 끌어 열 너비를 조절합니다. 경계를 더블클릭하면 가장 긴 문단에 맞춥니다. 직접 넣은 줄바꿈·글자 크기·굵기도 반영합니다.</li>
<li>셀 우클릭의 <span class="pjh-ui">현재 열 너비 자동 맞춤</span>·<span class="pjh-ui">전체 열 너비 자동 맞춤</span>도 사용할 수 있습니다. 전체 맞춤은 접힌 월 열까지 포함합니다. 병합 칸은 다른 열을 유지하며 오른쪽 끝 열 너비를 조절합니다.</li>
<li>접힘·열 너비는 내 브라우저에 기억됩니다. 행 높이는 가장 높은 글 칸에 맞춰 늘고, 글이 줄면 함께 줄어듭니다. 글은 상단 정렬입니다.</li>
<li>가로 스크롤에서는 구분·항목·연간 칸이, 세로 스크롤에서는 머리와 매출·로아스 지표가 고정됩니다.</li>
<li><b>월 이름</b>을 누르면 그 달의 <a href="#meetings">주간 회의록</a>으로 이동합니다.</li>
</ul>
<h3 id="goals-merge">셀 병합·병합 해제·내용 이동</h3>
<ol class="pjh-steps">
<li>관리자는 업무 영역의 글 칸을 마우스로 끌어 여러 칸을 선택한 뒤 우클릭 → <span class="pjh-ui">셀 병합</span>을 누릅니다.</li>
<li>가로 병합은 <b>같은 분기의 월 칸끼리</b> 가능합니다. 연간·분기 칸은 세로로만 병합합니다. 선택한 칸들의 글은 순서대로 첫 칸에 모입니다.</li>
<li>병합된 칸을 우클릭 → <span class="pjh-ui">병합 해제</span>하면 다시 나뉩니다. 글은 왼쪽 위 칸에 남습니다.</li>
<li>글 칸 하나를 클릭한 뒤 <b>위·아래·왼쪽 테두리</b>를 잡아 다른 글 칸으로 끌면 내용과 글자 서식이 함께 이동합니다. 오른쪽 경계는 너비 조절용입니다. 대상에 글이 있으면 덮어쓰기를 확인하고, <kbd>Esc</kbd>로 이동을 취소합니다.</li>
</ol>
<h3 id="goals-save">저장 실패와 연도 삭제</h3>
<p>저장 성공 시 칸 테두리가 잠깐 초록으로 바뀝니다. 실패하면 빨간 테두리와 안내가 나오며 입력값은 유지됩니다. 다시 입력하거나 칸을 떠나면 재시도합니다. 저장 안 된 값이 있으면 영역·줄 추가, 병합, 내용 이동을 진행하기 전에 저장을 시도하고, 실패하면 해당 작업을 멈춥니다.</p>
<p>저장되지 않은 초안은 내 브라우저에도 잠시 보관합니다. 다음에 같은 화면을 열면 복원하지만, 그 사이 다른 사람이 같은 칸을 바꿨으면 자동으로 덮어쓰지 않습니다. 저장 안 된 상태로 페이지를 떠나려 하면 브라우저가 확인합니다.</p>
<p>관리자의 <span class="pjh-ui">연도 삭제</span>는 그 연도의 숫자·업무 영역·계획 글을 삭제합니다. 확인창에 연도를 직접 입력해야 진행되며 되돌릴 수 없습니다.</p>
</section>
<!-- 21. 주간 회의록 -->
<section class="pjh-sec" id="meetings">
<h2><span class="pjh-num">21</span>주간 회의록</h2>
<p class="pjh-lead">월 목표를 기준으로 지난주 결과를 리뷰하고 이번주 할 일과 금액 목표를 정하는 화면입니다. 연간 목표의 월 계획, 실적 모듈의 매출, 주별 결정 사항을 함께 확인합니다. 직원은 조회할 수 있고, 생성·입력·삭제는 관리자만 할 수 있습니다.</p>
<h3 id="meetings-week">회의록 열기와 주차 기준</h3>
<ol class="pjh-steps">
<li>왼쪽 <span class="pjh-ui">목표</span>에서 연도를 선택하고 표 머리의 <b>월 이름</b>을 누릅니다.</li>
<li>위쪽 주차 탭 또는 오른쪽 작은 달력의 주 한 줄을 눌러 주를 고릅니다. 점은 회의록이 있는 주, <span class="pjh-ui">이번 주</span>는 현재 주입니다. 이전·다음 달 버튼으로 달을 바꿉니다.</li>
<li>한 주는 <b>월요일~일요일</b>이고, 월요일이 속한 달의 회의록입니다. 1주차는 그 달 첫 월요일이 있는 주입니다. 예: 2026년 10월 1주차는 10/5~10/11이며, 9/28~10/4는 9월 회의록입니다.</li>
<li>작은 달력의 흐린 앞 달 주를 누르면 그 달 회의록으로 갑니다. <span class="pjh-ui">해당 연도 목표</span> 버튼은 연간 목표 표로 돌아갑니다.</li>
</ol>
<h3 id="meetings-create">회의록 만들기와 이어받는 항목</h3>
<p>선택한 주에 회의록이 없으면 관리자에게 <span class="pjh-ui">해당 주차 회의록 만들기</span>가 보입니다. 화면을 열기만 해서는 회의록이 만들어지지 않습니다.</p>
<ul>
<li>줄이 있는 가장 가까운 앞선 회의록에서 <b>구역·항목 이름·색·쇼핑몰 연결·순서</b>를 이어받습니다. 앞선 회의록이 없으면 가장 가까운 다음 회의록의 구성을 가져옵니다.</li>
<li>어느 쪽에도 회의록이 없으면 해당 연도 목표 표의 업무 영역과 기본 양식으로 시작합니다.</li>
<li>이번주 할 일·금액·메모는 새로 적습니다. 구성을 이어받는 것과 <b>지난주 리뷰</b>는 다릅니다. 리뷰에는 정확히 7일 전 주의 같은 항목만 표시됩니다.</li>
</ul>
<h3 id="meetings-month-plan">이 달 계획 확인</h3>
<p>제목 아래 <span class="pjh-ui">해당 월 계획</span>은 연간 목표 표에 적은 월 계획을 업무 영역별로 보여 줍니다. 빈 계획은 생략하고, 병합 칸은 해당 월을 포함하는 계획을 한 번 표시합니다. 여기서는 읽기만 하므로 수정하려면 연간 목표 표로 돌아갑니다.</p>
<h3 id="meetings-kpis">월 목표·누적·주당 필요 매출 읽기</h3>
<table class="pjh-table">
<tr><th>지표</th><th>뜻과 출처</th></tr>
<tr><td>월 목표 매출·목표 ROAS</td><td>연간 목표 표의 해당 월 숫자입니다. 매출 단위가 원·천원·만원·십만원·백만원·천만원·억원이면 원으로 환산합니다. 모르는 단위는 원 환산을 못 하므로 주당 필요 매출도 계산하지 못합니다.</td></tr>
<tr><td>월 누적 실적(지난주까지)</td><td>실적 모듈의 매출 집계 쇼핑몰 매출을 <b>그 달 1일부터 선택한 주의 직전 일요일까지</b> 합칩니다. 현재 날짜·월말을 넘기지 않습니다. 이번주 매출은 이 누적에 포함하지 않습니다.</td></tr>
<tr><td>주당 필요</td><td>(월 목표 매출 − 월 누적 실적) ÷ <b>이번주를 포함한 그 달 남은 주 수</b>입니다. 원 단위 정수로 계산하고, 이미 월 목표를 달성했다면 0원입니다.</td></tr>
<tr><td>전주 목표</td><td>정확히 7일 전 회의록에 적은 금주 목표입니다. 그 주 회의록이 없으면 비어 있습니다.</td></tr>
<tr><td>전주 결과·달성률</td><td>실적 모듈의 전주 월~일 매출과 그 값 ÷ 전주 목표 × 100입니다. 전주 결과는 매출 자료이므로 전주 회의록이 없어도 조회될 수 있습니다. 목표가 없거나 0이면 달성률은 없습니다.</td></tr>
<tr><td>금주 목표·현재 실적</td><td>금주 목표는 관리자가 정하는 원 단위 금액입니다. 현재 실적은 선택한 주 월요일부터 일요일 또는 오늘 중 이른 날까지의 매출입니다. 아직 시작하지 않은 미래 주의 실적은 비어 있습니다.</td></tr>
</table>
<div class="pjh-tip"><span class="material-symbols-outlined">lightbulb</span><div>월 목표가 1억원이고 지난주까지 누적이 4천만원, 남은 주가 이번주 포함 3주이면 주당 필요는 2천만원입니다. 이 숫자는 계획 참고값이며 금주 목표로 자동 저장되지는 않습니다.</div></div>
<p>월 목표·누적은 달의 1일~말일 기준이고, 주간 결과는 월요일~일요일 기준입니다. 달을 넘는 마지막 주의 주간 결과에는 다음 달 날짜가 포함될 수 있습니다.</p>
<h3 id="meetings-edit">이번주 할 일·정량 목표·참석자·메모 입력</h3>
<ol class="pjh-steps">
<li><b>금주 목표</b>에 전체 매출 목표를 적습니다. 줄별 <b>정량 목표</b>는 각 항목의 목표 금액이며, 현재는 원 단위입니다. 금주 목표와 줄별 목표 합계는 자동으로 맞춰지지 않습니다.</li>
<li>각 항목의 <b>이번주 할 일 · 행사</b>에 실행할 일과 일정을 적습니다.</li>
<li><span class="pjh-ui">참석자</span>를 눌러 프로젝트 관리 권한이 있는 등록 직원 중 선택합니다. 찾기·전원 선택·모두 해제를 사용할 수 있으며, 칩의 <span class="pjh-ui">×</span>로 참석자를 뺍니다.</li>
<li>아래 <b>결정 사항 · 메모</b>에 회의 결론과 다음주까지 확인할 일을 적습니다.</li>
</ol>
<p>금액은 <code>1,200,000</code>·<code>120만</code>·<code>1.5억</code>·<code>3천만</code>·<code>1억2천만</code>처럼 입력할 수 있습니다. <kbd>Enter</kbd> 또는 칸을 떠날 때 원 단위로 저장되고, 빈칸은 값을 지웁니다. 글·메모는 입력을 약 0.8초 멈추거나 칸을 떠날 때, 참석자·평가는 바꾸는 즉시 저장됩니다.</p>
<h3 id="meetings-review">지난주 리뷰·결과·평가</h3>
<p>지난주 할 일과 목표는 <b>정확히 7일 전 주의 같은 항목</b>에서 가져옵니다. 이름 변경·순서 이동·회의록 생성 순서와 관계없이 이어진 같은 줄을 찾습니다. 그 주 회의록이 없으면 “회의록 없음”, 회의록은 있지만 항목이 없으면 “지난주 회의록에 없는 줄”로 표시합니다. 몇 주 전 기록을 지난주로 대신 보여 주지 않습니다.</p>
<ul>
<li><b>결과</b> — 쇼핑몰 연결 항목은 해당 쇼핑몰의 전주 매출이 자동 표시됩니다. 연결하지 않은 항목은 관리자가 결과 금액을 직접 입력합니다.</li>
<li><b>달성률</b> — 결과 ÷ 지난주 정량 목표 × 100입니다. 목표가 없거나 0이면 계산하지 않으며, 100% 이상은 초록으로 표시됩니다.</li>
<li><b>평가</b> — <span class="pjh-ui">— · 완료 · 일부 · 미달</span> 중 선택합니다. 달성률과 별개로 회의에서 판단해 정합니다.</li>
<li><b>저장 위치</b> — 이번 화면에서 입력한 지난주 결과·평가는 <b>지난주 회의록의 줄</b>에 저장됩니다. 이번주 할 일·정량 목표는 이번주 회의록에 저장됩니다.</li>
<li><span class="pjh-ui">순서 바꾸기</span>는 이번주와 지난주 리뷰의 좌우 배치만 바꿉니다. 선택은 로그인한 사람별로 내 브라우저에 기억됩니다.</li>
</ul>
<h3 id="meetings-markets">쇼핑몰 연결·자동 실적·매출 갱신</h3>
<ol class="pjh-steps">
<li>항목을 우클릭하거나 <span class="pjh-ui">⋯</span> → <span class="pjh-ui">쇼핑몰 연결(결과 자동)…</span>에서 실적 모듈의 사용 중인 쇼핑몰을 고릅니다. 자동 결과를 쓰지 않으려면 <span class="pjh-ui">연결 안 함</span>을 선택합니다.</li>
<li>연결된 항목의 정량 목표 아래에 이번주 실적과 목표 대비 비율이 나옵니다. 지난주 리뷰의 자동 결과는 <b>지난주 항목의 쇼핑몰 연결</b>을 기준으로 계산합니다. 이번주 연결을 바꿔도 지난주 연결은 바뀌지 않습니다.</li>
<li>유통 구역은 항목 이름으로 일부 쇼핑몰을 추측해 연결하므로 생성 후 연결 배지를 확인하세요. 마케팅의 “네이버” 같은 광고 항목은 자동 연결하지 않습니다.</li>
</ol>
<p>실적 갱신 권한이 있으면 주차를 열 때 지난주부터 선택한 주의 오늘까지 매출을 자동 갱신합니다. 같은 주의 자동 갱신은 브라우저에서 10분 간격으로 제한하며, 성공 시에는 별도 큰 안내 없이 숫자가 바뀝니다. 실패·일부 쇼핑몰 실패 시 작은 안내와 <span class="pjh-ui">다시 시도</span>가 나옵니다. 마지막 갱신 성공 시각은 실적 모듈 기록이며 숫자에 마우스를 올려 확인할 수 있습니다.</p>
<table class="pjh-table">
<tr><th>표시·상태</th><th>확인할 내용</th></tr>
<tr><td>미확인</td><td>조회에 실패해 값을 알 수 없습니다. <b>0원과 다릅니다.</b> 이에 의존하는 달성률·주당 필요 매출도 계산하지 않습니다. 안내의 다시 시도를 사용하거나 실적 연결 상태를 확인하세요.</td></tr>
<tr><td>0원</td><td>매출 조회는 성공했지만 해당 기간에 저장된 실적이 없거나 합계가 0원입니다. 필요하면 실적 화면에서 매출 자료를 갱신하세요.</td></tr>
<tr><td>실적 미사용</td><td>연결 쇼핑몰이 사용 중이 아니거나 목록에 없습니다. 해당 항목의 결과는 직접 입력합니다.</td></tr>
<tr><td>실적 미연결·집계 대상 없음</td><td>자동 실적·누적이 비어 있습니다. 회의록 계획·메모는 계속 입력할 수 있습니다.</td></tr>
<tr><td>실적 갱신 권한 없음</td><td>새 매출을 요청하지 않고 저장된 실적을 보여 줍니다. 회의록 조회 권한과 매출 갱신 권한은 별개입니다.</td></tr>
</table>
<h3 id="meetings-rows">구역·줄 추가·순서·삭제</h3>
<ul>
<li>구역 이름 옆 <span class="pjh-ui">+</span>는 그 구역 끝에 줄을 추가합니다. 표 아래 <span class="pjh-ui">+ 구역 추가</span>로 새 구역을 만듭니다.</li>
<li>항목 이름을 클릭하면 그 자리에서 고칩니다. 우클릭 또는 ⋯ 메뉴에서 <span class="pjh-ui">위에 줄 추가 · 아래에 줄 추가 · 위로 · 아래로 · 줄 삭제</span>를 사용합니다. 순서 이동은 같은 구역 안에서 합니다.</li>
<li>줄을 삭제하면 이번주 할 일·정량 목표도 함께 삭제됩니다. 새 줄은 지난주에 이어진 항목이 없으면 지난주 리뷰가 비어 있습니다.</li>
</ul>
<h3 id="meetings-save">저장 확인·인쇄·회의록 삭제</h3>
<p>저장 실패 시 칸이 빨갛게 표시되며 입력값은 남습니다. 다시 입력하거나 칸을 떠나면 재시도합니다. 금주 목표를 저장하거나 자동 실적을 갱신해도 다른 칸의 작성 중인 글은 유지됩니다. 저장이 안 된 상태에서는 줄 추가·순서 이동·쇼핑몰 연결 같은 작업에 앞서 저장을 다시 시도합니다. 실패하면 구조 변경을 멈춥니다. 초안 복원과 페이지 떠남 보호는 <a href="#goals-save">목표의 저장 안내</a>와 같습니다.</p>
<p><span class="pjh-ui">인쇄</span>는 브라우저 인쇄창을 엽니다. 인쇄용 화면에서는 사이드바·작은 달력·편집 도구를 숨깁니다. 브라우저의 PDF 저장도 사용할 수 있습니다.</p>
<p>관리자의 <span class="pjh-ui">회의록 삭제</span>는 선택한 한 주의 회의록과 줄을 삭제합니다. 다음주 화면의 지난주 리뷰도 비게 됩니다. 같은 주를 다시 만들면 항목 구성은 이어질 수 있지만 삭제한 글과 금액은 복구되지 않습니다.</p>
</section>
<!-- 22. 단축키와 FAQ -->
<section class="pjh-sec" id="tips">
<h2><span class="pjh-num">20</span>단축키와 자주 묻는 질문</h2>
<h2><span class="pjh-num">22</span>단축키와 자주 묻는 질문</h2>
<h3>단축키</h3>
<table class="pjh-table">
<tr><th>키</th><th>하는 일</th></tr>
<tr><td><kbd>/</kbd></td><td>전체 검색창으로 이동(입력 중이 아닐 때)</td></tr>
<tr><td><kbd>/</kbd></td><td>작업 화면에서는 전체 검색창, 이 도움말에서는 도움말 검색창으로 이동(입력 중이 아닐 때)</td></tr>
<tr><td><kbd>Esc</kbd></td><td>작업 편집 창 · 날짜 창 · 메뉴 닫기, 입력 취소</td></tr>
<tr><td><kbd>Enter</kbd></td><td>하위 작업 추가, 섹션 이름 저장, 댓글 전송, 날짜 직접 입력 확정</td></tr>
<tr><td><kbd>Ctrl</kbd> + 휠</td><td>타임라인 확대·축소</td></tr>
@@ -530,26 +670,14 @@
<p><b>Q. 다른 사람이 바꾼 내용이 안 보여요.</b><br>보통 8초 안에 자동으로 반영됩니다. 오래 걸리면 새로고침(<kbd>F5</kbd>)하세요.</p>
<p><b>Q. 하위 작업을 다른 프로젝트 작업으로 옮길 수 있나요?</b><br>하위 작업은 같은 프로젝트 안의 작업으로만 옮길 수 있습니다.</p>
<p><b>Q. 작업을 두 프로젝트에 같이 두고 싶어요.</b><br>작업 편집 창의 “프로젝트” 칸에서 <span class="pjh-ui">다른 프로젝트에 추가</span>를 쓰세요. (<a href="#task">8장</a>)</p>
<p><b>Q. 목표 표의 실적과 회의록 매출이 달라요.</b><br>목표 표의 월 실적은 직접 입력한 숫자이고, 회의록 매출은 실적 모듈 자료입니다. 매출 단위와 집계 기간도 확인하세요. (<a href="#goals-metrics">숫자 지표</a> · <a href="#meetings-kpis">회의록 지표</a>)</p>
<p><b>Q. 지난주 회의록이 있는데 리뷰가 비어 있어요.</b><br>화면의 지난주 날짜와 항목을 확인하세요. 정확히 7일 전 회의록의 이어진 같은 항목만 표시합니다. 따로 추가한 줄은 이름이 같아도 다른 항목일 수 있습니다. (<a href="#meetings-review">지난주 리뷰</a>)</p>
<p><b>Q. 도움말에서 필요한 설명을 빠르게 찾고 싶어요.</b><br>이 페이지 위쪽 검색창에 단어를 입력하고 결과를 누르세요. 제목·본문의 일치 단어가 강조되고 해당 소제목으로 이동합니다. <kbd>Enter</kbd>는 첫 결과로 이동, <kbd>Esc</kbd>나 <span class="pjh-ui">지우기</span>는 검색을 초기화합니다.</p>
</section>
</div>
</div>
<a class="pjh-top" href="#top" title="맨 위로" aria-label="맨 위로"><span class="material-symbols-outlined">arrow_upward</span></a>
<script>
// 목차 — 지금 읽고 있는 장을 강조한다(스크롤 위치 기준).
(function () {
var links = Array.prototype.slice.call(document.querySelectorAll(".pjh-toc a"));
var secs = links.map(function (a) { return document.querySelector(a.getAttribute("href")); });
if (!("IntersectionObserver" in window)) return;
var io = new IntersectionObserver(function (entries) {
entries.forEach(function (en) {
if (!en.isIntersecting) return;
var i = secs.indexOf(en.target);
links.forEach(function (a, k) { a.classList.toggle("is-active", k === i); });
});
}, { rootMargin: "-10% 0px -75% 0px" });
secs.forEach(function (s) { if (s) io.observe(s); });
})();
</script>
<script src="/static/project-help.js?v=20261003a" defer></script>
{% endblock %}
+44
View File
@@ -114,3 +114,47 @@
background: var(--pjh-accent); color: #fff; box-shadow: 0 6px 18px rgba(123, 104, 238, .35);
}
.pjh-top:hover { filter: brightness(1.08); }
/* 검색 — 결과는 소제목 단위로 이동하며 본문은 계속 읽을 수 있다. */
.erp-page:has(> .pjh) { box-sizing: border-box; }
.pjh-body { min-width: 0; }
.pjh [hidden] { display: none !important; }
.pjh-search { background: #fff; border: 1px solid var(--pjh-line); border-radius: 14px; padding: 18px 22px; margin-bottom: 18px; }
.pjh-search label { display: block; font-weight: 600; margin-bottom: 8px; }
.pjh-search-field { display: flex; gap: 8px; }
.pjh-search-field input { flex: 1; min-width: 0; border: 1px solid #cfd3d9; border-radius: 8px; padding: 10px 12px; font: inherit; }
.pjh-search-field button { border: 1px solid #d7d0f7; border-radius: 8px; background: var(--pjh-tint); color: #493790; padding: 8px 12px; font: inherit; cursor: pointer; }
.pjh-search-field button:hover { background: #e8e1ff; }
.pjh-search-hint, .pjh-search-status { font-size: 13px; margin: 8px 0 0; color: var(--pjh-soft); }
.pjh-search-status:empty { display: none; }
.pjh-results { list-style: none; margin: 12px 0 0; padding: 0; max-height: 340px; overflow-y: auto; }
.pjh-results li + li { border-top: 1px solid var(--pjh-line); }
.pjh-results a { display: block; padding: 10px; color: var(--pjh-ink); text-decoration: none; border-radius: 8px; }
.pjh-results a:hover { background: #f7f5ff; }
.pjh-results strong, .pjh-results span { display: block; overflow-wrap: anywhere; }
.pjh-results strong { color: #493790; font-weight: 600; }
.pjh-results span { margin-top: 4px; font-size: 13px; }
.pjh mark.pjh-match { background: #fff0a6; color: #423309; border-radius: 2px; padding: 0; }
.pjh-quick-links { margin-top: 16px !important; }
.pjh-sec h3 { scroll-margin-top: 20px; }
.pjh :focus-visible { outline: 2px solid var(--pjh-accent); outline-offset: 3px; }
.pjh-sec { overflow-wrap: anywhere; }
@media (max-width: 600px) {
.erp-app:has(.pjh) .erp-topbar { flex-wrap: wrap; height: auto; padding: 8px 12px; gap: 8px; }
.erp-app:has(.pjh) .erp-topbar-left { flex-basis: 100%; }
.erp-app:has(.pjh) .erp-topbar-right { width: 100%; gap: 6px; }
.erp-app:has(.pjh) .erp-user-chip { margin-right: auto; }
.erp-app:has(.pjh) .erp-user-email { display: none; }
.pjh { gap: 12px; }
.pjh-hero, .pjh-sec { padding: 18px 16px; }
.pjh-search { padding: 16px; }
.pjh-search-field { flex-wrap: wrap; }
.pjh-search-field input { flex-basis: 100%; }
.pjh-table td:first-child, .pjh-table th { white-space: normal; }
.pjh-table th, .pjh-table td { padding: 7px 5px; }
.pjh-map { grid-template-columns: minmax(0, 1fr); grid-template-rows: auto; }
.pjh-map-top { flex-wrap: wrap; gap: 6px; }
.pjh-map-side, .pjh-map-main { grid-row: auto; }
.pjh-top { right: 12px; bottom: 12px; }
}
+205
View File
@@ -0,0 +1,205 @@
/* 도움말의 제목·본문에서 검색하고 해당 소제목으로 이동한다. DB/API 불필요. */
(function () {
"use strict";
const root = document.querySelector(".pjh");
if (!root) return;
const input = document.getElementById("pjh-query");
const form = document.getElementById("pjh-search-form");
const results = document.getElementById("pjh-results");
const status = document.getElementById("pjh-search-status");
const clear = document.getElementById("pjh-search-clear");
const chapters = Array.from(root.querySelectorAll(".pjh-sec"));
const index = [];
let composing = false;
function plain(node) {
const copy = node.cloneNode(true);
copy.querySelectorAll(".pjh-num, .material-symbols-outlined").forEach(function (n) { n.remove(); });
return copy.textContent.replace(/\s+/g, " ").trim();
}
// 본문 자체에서 색인을 만든다. 도움말을 고치면 검색 결과도 함께 바뀐다.
chapters.forEach(function (chapter) {
const title = plain(chapter.querySelector("h2"));
let block = { chapter: chapter, title: title, heading: chapter.querySelector("h2"), nodes: [], order: index.length };
block.heading.id = block.heading.id || chapter.id + "-intro";
let ordinal = 0;
function finish() {
block.text = block.nodes.map(plain).join(" ");
block.search = (block.title + " " + block.text).toLowerCase();
index.push(block);
}
Array.from(chapter.children).forEach(function (node) {
if (node.tagName === "H2") return;
if (node.tagName === "H3") {
finish();
ordinal++;
node.id = node.id || chapter.id + "-" + ordinal;
block = { chapter: chapter, title: title + " › " + plain(node), heading: node, nodes: [], order: index.length };
} else block.nodes.push(node);
});
finish();
});
function words(query) {
return Array.from(new Set(query.trim().toLowerCase().split(/\s+/).filter(Boolean)));
}
// 검색어는 HTML이나 정규식으로 해석하지 않는다.
function marked(text, terms) {
const fragment = document.createDocumentFragment();
const lower = text.toLowerCase();
let pos = 0;
while (pos < text.length) {
let start = -1, length = 0;
terms.forEach(function (term) {
const found = lower.indexOf(term, pos);
if (found !== -1 && (start === -1 || found < start || (found === start && term.length > length))) {
start = found; length = term.length;
}
});
if (start === -1) { fragment.appendChild(document.createTextNode(text.slice(pos))); break; }
fragment.appendChild(document.createTextNode(text.slice(pos, start)));
const mark = document.createElement("mark");
mark.className = "pjh-match";
mark.textContent = text.slice(start, start + length);
fragment.appendChild(mark);
pos = start + length;
}
return fragment;
}
function highlight(terms) {
chapters.forEach(function (chapter) {
chapter.querySelectorAll("mark.pjh-match").forEach(function (mark) {
mark.replaceWith(document.createTextNode(mark.textContent));
});
chapter.normalize();
if (!terms.length) return;
const walker = document.createTreeWalker(chapter, NodeFilter.SHOW_TEXT);
const nodes = [];
let node;
while ((node = walker.nextNode())) {
if (!node.parentElement.closest(".material-symbols-outlined, .pjh-num") &&
terms.some(function (term) { return node.nodeValue.toLowerCase().includes(term); })) nodes.push(node);
}
nodes.forEach(function (n) { n.replaceWith(marked(n.nodeValue, terms)); });
});
}
function snippet(text, terms) {
const lower = text.toLowerCase();
const hits = terms.map(function (term) { return lower.indexOf(term); }).filter(function (n) { return n >= 0; });
const start = hits.length ? Math.max(0, Math.min.apply(null, hits) - 35) : 0;
return (start ? "…" : "") + text.slice(start, start + 155) + (text.length > start + 155 ? "…" : "");
}
function saveQuery(query) {
const url = new URL(window.location.href);
if (query.trim()) url.searchParams.set("q", query.trim());
else url.searchParams.delete("q");
window.history.replaceState(null, "", url);
}
function search(updateUrl) {
const query = input.value.slice(0, 160);
const terms = words(query);
results.replaceChildren();
clear.hidden = !query;
results.hidden = !terms.length;
highlight(terms);
if (updateUrl) saveQuery(query);
if (!terms.length) { status.textContent = ""; return; }
const matches = index.filter(function (entry) {
return terms.every(function (term) { return entry.search.includes(term); });
});
// 제목에 모든 단어가 있으면 먼저, 나머지는 문서 순서대로.
matches.sort(function (a, b) {
function score(entry) { return terms.every(function (term) { return entry.title.toLowerCase().includes(term); }) ? 1 : 0; }
return score(b) - score(a) || a.order - b.order;
});
status.textContent = matches.length
? "검색 결과 " + matches.length + "개 · 결과를 누르거나 Enter로 첫 설명에 이동하세요."
: "검색 결과가 없습니다. 다른 단어를 쓰거나 검색어를 줄여 보세요.";
matches.forEach(function (entry) {
const li = document.createElement("li");
const link = document.createElement("a");
link.href = "#" + entry.heading.id;
const title = document.createElement("strong");
title.appendChild(marked(entry.title, terms));
const preview = document.createElement("span");
preview.appendChild(marked(snippet(entry.text, terms), terms));
link.append(title, preview);
li.appendChild(link);
results.appendChild(li);
});
}
const tocLinks = Array.from(root.querySelectorAll(".pjh-toc a"));
function activate(chapter) {
tocLinks.forEach(function (link) {
const active = link.getAttribute("href") === "#" + chapter.id;
link.classList.toggle("is-active", active);
if (active) link.setAttribute("aria-current", "location");
else link.removeAttribute("aria-current");
});
}
function jump(id) {
const target = document.getElementById(id);
if (!target || !root.contains(target)) return;
target.setAttribute("tabindex", "-1");
target.focus({ preventScroll: true });
target.scrollIntoView({ block: "start" });
const chapter = target.closest(".pjh-sec");
if (chapter) activate(chapter);
}
root.addEventListener("click", function (event) {
const link = event.target.closest('a[href^="#"]');
if (!link || event.button !== 0 || event.ctrlKey || event.metaKey || event.shiftKey || event.altKey) return;
const id = link.getAttribute("href").slice(1);
if (!document.getElementById(id)) return;
event.preventDefault();
if (window.location.hash !== "#" + id) window.history.pushState(null, "", "#" + id);
jump(id);
});
input.maxLength = 160;
input.addEventListener("compositionstart", function () { composing = true; });
input.addEventListener("compositionend", function () { composing = false; search(true); });
input.addEventListener("input", function () { if (!composing) search(true); });
form.addEventListener("submit", function (event) {
event.preventDefault();
if (composing) return;
search(true);
const first = results.querySelector("a");
if (first) first.click();
});
function reset() { input.value = ""; search(true); input.focus(); }
clear.addEventListener("click", reset);
input.addEventListener("keydown", function (event) {
if (composing || event.isComposing || event.keyCode === 229) return;
if (event.key === "Escape") { event.preventDefault(); reset(); }
});
document.addEventListener("keydown", function (event) {
if (event.key !== "/" || event.isComposing || event.ctrlKey || event.metaKey || event.altKey ||
event.target.closest("input, textarea, select, [contenteditable='true']")) return;
event.preventDefault();
input.focus();
input.scrollIntoView({ block: "center" });
});
function restore() {
input.value = (new URL(window.location.href).searchParams.get("q") || "").slice(0, 160);
search(false);
if (window.location.hash) jump(window.location.hash.slice(1));
}
window.addEventListener("popstate", restore);
window.addEventListener("hashchange", function () { if (window.location.hash) jump(window.location.hash.slice(1)); });
document.getElementById("pjh-search").hidden = false;
restore();
if ("IntersectionObserver" in window) {
const observer = new IntersectionObserver(function (entries) {
entries.forEach(function (entry) { if (entry.isIntersecting) activate(entry.target); });
}, { rootMargin: "-10% 0px -75% 0px" });
chapters.forEach(function (chapter) { observer.observe(chapter); });
}
})();
+9 -2
View File
@@ -9,9 +9,16 @@
목록(보기 탭, 예전 "리스트") · 캘린더(예전 "달력") · 수신함 · 첨부 파일 · 작업 링크 복사 ·
프로젝트 칸 + "다른 프로젝트에 추가"(예전 "연결된 프로젝트") · 담당자 없음(예전 "(미지정)").
"@태그"는 그대로 쓴다. 코드 식별자·DB 컬럼(`tasks`, `stage_id`, `task_followers` 등)과 코드 주석은 예전 이름 그대로다.
**도움말** — `/project/help`(`project/help.html` + `static/project-help.css`), 프로젝트 관리 화면 상단 바 로그아웃
**도움말** — `/project/help`(`project/help.html` + `static/project-help.css`·`static/project-help.js`), 프로젝트 관리 화면 상단 바 로그아웃
오른쪽 **?** 아이콘(`_help_btn.html`, `erp_base.html` 의 `topbar_after_logout` 블록)으로 새 탭에서 연다. 처음 쓰는 사람용
기능 설명 20장 — **화면 기능을 바꾸면 도움말도 같이 고친다.**
기능 설명 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 화면에서 복원한다. 취소는 적용하지 않는다.
+81
View File
@@ -0,0 +1,81 @@
// 실제 Chromium + ERP 셸에서 검색·이동과 데스크톱/모바일 표시 검증(DB 미사용).
// python tests/js/render_help.py
// PJ_TEST_BROWSER=<설치된 Chrome 경로> node tests/js/help.browser.test.js (playwright 필요)
const assert = require("node:assert/strict");
const fs = require("node:fs");
const http = require("node:http");
const path = require("node:path");
const { chromium } = require("playwright");
const ROOT = path.resolve(__dirname, "../..");
const STATIC = path.join(ROOT, "app/static");
const OUT = path.join(__dirname, ".out");
const server = http.createServer(function (req, res) {
const url = new URL(req.url, "http://localhost");
if (url.pathname === "/project/help") {
res.setHeader("Content-Type", "text/html; charset=utf-8");
res.end(fs.readFileSync(path.join(OUT, "help_render.html"))); return;
}
const file = path.resolve(STATIC, "." + decodeURIComponent(url.pathname.slice(7)));
if (!url.pathname.startsWith("/static/") || !file.startsWith(STATIC + path.sep) || !fs.existsSync(file) || !fs.statSync(file).isFile()) {
res.statusCode = 404; res.end(); return;
}
const types = { ".css": "text/css", ".js": "text/javascript", ".woff2": "font/woff2", ".woff": "font/woff", ".png": "image/png" };
res.setHeader("Content-Type", types[path.extname(file)] || "application/octet-stream");
fs.createReadStream(file).pipe(res);
});
(async function () {
let browser;
try {
await new Promise(resolve => server.listen(0, "127.0.0.1", resolve));
browser = await chromium.launch({ headless: true, executablePath: process.env.PJ_TEST_BROWSER || undefined });
const page = await browser.newPage({ viewport: { width: 1600, height: 1000 } });
const errors = [], mutations = [];
page.on("pageerror", e => errors.push(e.message));
page.on("request", r => { if (r.method() !== "GET") mutations.push(r.url()); });
await page.goto("http://127.0.0.1:" + server.address().port + "/project/help");
await page.locator("#pjh-query").waitFor({ state: "visible" });
await page.locator("#pjh-query").fill("셀 병합");
const first = page.locator("#pjh-results a").first();
assert.equal(await first.getAttribute("href"), "#goals-merge");
await page.screenshot({ path: path.join(OUT, "help-desktop.png") });
await first.click();
assert.equal(await page.evaluate(() => document.activeElement.id), "goals-merge");
assert.ok(await page.locator("#goals-merge").isVisible());
const rect = await page.locator("#goals-merge").boundingBox();
assert.ok(rect.y >= 0 && rect.y < 300, "앵커 이동 후 소제목이 화면 위에 표시");
await page.screenshot({ path: path.join(OUT, "help-goals.png") });
await page.keyboard.press("/");
await page.locator("#pjh-query").fill("쇼핑몰 연결");
await page.locator("#pjh-query").press("Enter");
assert.equal(await page.evaluate(() => document.activeElement.id), "meetings-markets");
await page.reload();
await page.locator("#pjh-query").waitFor({ state: "visible" });
assert.equal(await page.locator("#pjh-query").inputValue(), "쇼핑몰 연결");
assert.equal(await page.evaluate(() => document.activeElement.id), "meetings-markets");
await page.goBack();
assert.equal(await page.evaluate(() => document.activeElement.id), "goals-merge");
assert.equal(await page.locator("#pjh-query").inputValue(), new URL(page.url()).searchParams.get("q"), "뒤로 간 주소의 검색어 복원");
await page.setViewportSize({ width: 390, height: 844 });
await page.waitForFunction(() => document.querySelector(".erp-sidebar").getBoundingClientRect().right <= 1);
await page.keyboard.press("/");
await page.locator("#pjh-query").fill("회의록");
await page.screenshot({ path: path.join(OUT, "help-mobile.png") });
assert.ok(await page.locator("#pjh-query").isVisible(), "모바일에서 목차가 숨겨져도 검색 유지");
const widths = await page.evaluate(() => {
const nodes = [document.documentElement, document.querySelector(".erp-page"), document.querySelector(".pjh"), document.querySelector(".pjh-body")];
return nodes.map(n => ({ name: n.className || n.tagName, scroll: n.scrollWidth, client: n.clientWidth }));
});
assert.ok(widths.every(n => n.scroll <= n.client + 1), "모바일에서 가로 넘침 없음: " + JSON.stringify(widths));
await page.locator('#pjh-results a[href="#meetings-review"]').click();
assert.equal(await page.evaluate(() => document.activeElement.id), "meetings-review");
await page.screenshot({ path: path.join(OUT, "help-meeting-mobile.png") });
assert.deepEqual(errors, [], "브라우저 JS 오류 없음");
assert.deepEqual(mutations, [], "도움말 검색은 데이터 쓰기 요청 없음");
console.log("ALL PASS — Chromium 검색·Enter·새로고침·뒤로 가기·390px 모바일 레이아웃");
} finally {
if (browser) await browser.close();
await new Promise(resolve => server.close(resolve));
}
})().catch(function (e) { console.error(e); process.exitCode = 1; });
+100
View File
@@ -0,0 +1,100 @@
// python tests/js/render_help.py && node tests/js/help_ui.test.js (jsdom 필요)
const assert = require("node:assert/strict");
const fs = require("node:fs");
const path = require("node:path");
const { JSDOM } = require("jsdom");
const ROOT = path.resolve(__dirname, "../..");
const html = fs.readFileSync(path.join(__dirname, ".out/help_render.html"), "utf8");
const js = fs.readFileSync(path.join(ROOT, "app/static/project-help.js"), "utf8");
function boot(url) {
const dom = new JSDOM(html, { url: url || "http://localhost/project/help", runScripts: "outside-only" });
const w = dom.window;
w.HTMLElement.prototype.scrollIntoView = function () { w.lastScroll = this.id; };
w.eval(js);
return dom;
}
const dom = boot(), w = dom.window, d = w.document;
const input = d.getElementById("pjh-query");
function search(query) { input.value = query; input.dispatchEvent(new w.Event("input", { bubbles: true })); }
function links() { return Array.from(d.querySelectorAll("#pjh-results a")); }
function reset() { d.getElementById("pjh-search-clear").click(); }
assert.equal(d.querySelectorAll(".pjh-sec").length, 22);
assert.equal(d.querySelectorAll(".pjh-toc a").length, 22);
assert.equal(d.getElementById("pjh-search").hidden, false);
assert.equal(d.getElementById("pjh-results").hidden, true);
const ids = Array.from(d.querySelectorAll("[id]")).map(n => n.id);
assert.equal(new Set(ids).size, ids.length, "앵커 ID는 중복 없음");
Array.from(d.querySelectorAll('.pjh a[href^="#"]')).forEach(function (link) {
assert.ok(d.getElementById(link.getAttribute("href").slice(1)), "도움말 내부 링크 유효");
});
search("셀 병합");
assert.equal(links()[0].hash, "#goals-merge", "소제목 일치를 먼저 표시");
assert.ok(links()[0].querySelector("mark"));
assert.ok(d.querySelector("#goals mark"), "본문도 일치어 강조");
links()[0].click();
assert.equal(w.location.hash, "#goals-merge");
assert.equal(d.activeElement.id, "goals-merge", "결과 클릭은 해당 소제목에 포커스");
assert.equal(w.lastScroll, "goals-merge");
assert.equal(d.querySelector('.pjh-toc [aria-current="location"]').hash, "#goals");
assert.equal(new URL(w.location.href).searchParams.get("q"), "셀 병합");
search("7일 전");
assert.ok(links().some(a => a.hash === "#meetings-review"), "제목에 없는 본문 단어도 검색");
search("쇼핑몰 연결");
assert.equal(links()[0].hash, "#meetings-markets");
d.getElementById("pjh-search-form").dispatchEvent(new w.Event("submit", { bubbles: true, cancelable: true }));
assert.equal(d.activeElement.id, "meetings-markets", "Enter/submit은 첫 결과 이동");
const original = d.getElementById("meetings").textContent;
search("ROAS");
assert.ok(links().some(a => a.hash === "#goals-metrics"), "영문 대소문자 구분 안 함");
search("로아스");
assert.ok(links().length > 0, "한글 검색");
search("원");
assert.ok(links().length > 0, "한 글자 검색");
search(" 쇼핑몰 연결 ");
assert.equal(links()[0].hash, "#meetings-markets", "연속 공백·여러 단어 검색");
search("zz-no-help-match");
assert.equal(links().length, 0);
assert.match(d.getElementById("pjh-search-status").textContent, /결과가 없습니다/);
search("<img src=x onerror=alert(1)>");
assert.equal(links().length, 0, "HTML을 검색어 문자열로만 처리");
assert.equal(d.querySelector('img[src="x"]'), null);
search("[");
assert.equal(links().length, 0, "정규식 특수문자에도 예외 없음");
reset();
assert.equal(input.value, "");
assert.equal(d.getElementById("pjh-results").hidden, true);
assert.equal(d.querySelectorAll("mark.pjh-match").length, 0);
assert.equal(d.getElementById("meetings").textContent, original, "검색·초기화 뒤 원문 보존");
assert.equal(new URL(w.location.href).searchParams.has("q"), false);
assert.equal(d.activeElement, input);
search("분기");
input.dispatchEvent(new w.KeyboardEvent("keydown", { key: "Escape", bubbles: true, cancelable: true }));
assert.equal(input.value, "");
d.body.dispatchEvent(new w.KeyboardEvent("keydown", { key: "/", bubbles: true, cancelable: true }));
assert.equal(d.activeElement, input, "/ 단축키는 도움말 검색");
search("셀 병합");
input.dispatchEvent(new w.CompositionEvent("compositionstart", { bubbles: true }));
input.value = "회의록";
input.dispatchEvent(new w.Event("input", { bubbles: true }));
const before = w.location.hash;
d.getElementById("pjh-search-form").dispatchEvent(new w.Event("submit", { cancelable: true }));
assert.equal(w.location.hash, before, "한글 조합 중 submit은 이동 안 함");
assert.equal(links()[0].hash, "#goals-merge", "조합 중 검색 안 함");
input.dispatchEvent(new w.CompositionEvent("compositionend", { bubbles: true }));
assert.ok(links().some(a => a.hash === "#meetings-intro"), "조합 확정 뒤 검색");
const restored = boot("http://localhost/project/help?q=" + encodeURIComponent("쇼핑몰 연결") + "#meetings-markets");
assert.equal(restored.window.document.getElementById("pjh-query").value, "쇼핑몰 연결");
assert.equal(restored.window.document.activeElement.id, "meetings-markets", "공유 링크·새로고침 복원");
w.history.pushState(null, "", "/project/help?q=" + encodeURIComponent("셀 병합") + "#goals-merge");
w.dispatchEvent(new w.PopStateEvent("popstate"));
assert.equal(input.value, "셀 병합");
assert.equal(d.activeElement.id, "goals-merge", "뒤로 가기 위치·검색 복원");
restored.window.close();
dom.window.close();
console.log("ALL PASS — 도움말 검색·앵커·한글 조합·안전한 문자열·초기화·URL 복원");
+25
View File
@@ -0,0 +1,25 @@
"""실제 ERP 기본 템플릿으로 도움말을 렌더한다. DB·운영 사용자 데이터 미사용.
python tests/js/render_help.py -> tests/js/.out/help_render.html
"""
from pathlib import Path
import jinja2
ROOT = Path(__file__).resolve().parents[2]
env = jinja2.Environment(
loader=jinja2.ChoiceLoader([
jinja2.FileSystemLoader(ROOT / "app/modules/project/templates"),
jinja2.FileSystemLoader(ROOT / "app/templates"),
]),
autoescape=jinja2.select_autoescape(["html"]),
)
html = env.get_template("project/help.html").render(
user={"email": "reader@test.local", "name": "Reader", "is_super_admin": False},
is_admin=False, nav_items=[], force_sidebar_collapsed=True,
page_title="프로젝트 관리 도움말", page_subtitle="처음 쓰는 분을 위한 기능 안내",
)
out = ROOT / "tests/js/.out/help_render.html"
out.parent.mkdir(parents=True, exist_ok=True)
out.write_text(html, encoding="utf-8")
print("rendered:", out)