diff --git a/app/modules/project/templates/project/help.html b/app/modules/project/templates/project/help.html index 8ed3eb8..0c54e69 100644 --- a/app/modules/project/templates/project/help.html +++ b/app/modules/project/templates/project/help.html @@ -2,7 +2,7 @@ {% block head_extra %} - + {% endblock %} @@ -11,7 +11,7 @@ {% block content %} {# ── 프로젝트 관리 도움말 — 처음 쓰는 사람을 위한 기능 안내(정적 페이지, DB 불필요). 기능이 바뀌면 이 페이지도 같이 고친다(docs/PROJECT_MODULE.md 와 짝). ── #} -
+
+ -
+

프로젝트 관리 도움말

프로젝트 관리는 아사나(Asana) 방식으로 팀의 일을 정리하는 도구입니다. 프로젝트 안에 할 일(작업)을 만들고, 담당자와 마감일을 정하고, 댓글로 이야기하며 끝까지 챙깁니다. @@ -52,6 +68,7 @@

4단계카드를 눌러 설명을 쓰고, 댓글에 @로 동료를 부릅니다.
5단계일을 마치면 ✓ 완료로 표시를 누릅니다.
+ @@ -89,34 +106,8 @@
  • 내 작업 — 내가 담당자인 작업 모음. 숫자 배지는 아직 끝나지 않은 작업 수입니다. (15장)
  • 휴지통 — 지운 작업을 3개월 보관합니다. 관리자에게만 보입니다. (19장)
  • 왼쪽 메뉴의 오른쪽 경계를 끌면 너비를 최소 170px까지 줄일 수 있습니다. 경계에 키보드 포커스를 놓고 좌우 방향키로도 조절할 수 있으며 너비는 내 브라우저에 기억됩니다. 전체 멤버는 메뉴 너비에 맞춰 4열 또는 3열로 자동 배치됩니다.
  • -
  • 목표 — 누르면 바로 아래에 연도가 펼쳐집니다. 연도를 누르면 오른쪽에 그해 전체 목표가 한 표로 나옵니다 — - 맨 위에 매출(목표·실적·달성률)과 로아스(목표·실적, 단위 %)를 달마다, 그 아래에 업무 영역(상품·마케팅·컨텐츠·유통 등)별로 - 연간·분기·월별 계획을 적습니다. 3·6·9·12월 오른쪽에 1~4분기 칸이 있고, 매출의 연간·분기 칸은 월 합계, - 달성은 실적÷목표(100% 이상 초록)로 저절로 계산됩니다. 분기 칸 머리의 ‹ 버튼을 누르면 그 분기의 월 칸 3개가 - 접히고, 다시 누르면 펼쳐집니다(접힌 상태는 내 브라우저에 기억). 월 이름을 누르면 그 달 주간 회의록이 열립니다. - 입력은 관리자만 할 수 있고(칸을 고치면 바로 저장), 다른 직원은 보기만 합니다. 관리자는 + 연도 추가로 새해 목표를 - 만듭니다(이전 연도의 업무 영역 구성을 그대로 가져옴). 글 칸에서 글자를 드래그해 선택하면 선택한 셀 상단에 나타나는 엑셀 형태 서식 도구로 색상·크기·굵게·기울임·밑줄을 바꿀 수 있으며 선택한 글자에만 적용됩니다. - 위/아래 화살표가 붙은 글자 버튼은 크기를 2px씩 키우거나 줄입니다(10~32px). 굵게·기울임·밑줄 버튼은 다시 누르면 해당 서식을 해제합니다. - 서식 초기화는 선택한 글자를 기본 서식으로 되돌리며 내용은 유지합니다. 서식도 자동으로 저장됩니다. 색상은 12색의 네모 견본에서 고릅니다. - 모든 행의 셀 오른쪽 경계를 끌어 열 너비를 조절하고, 더블클릭하면 그 열의 가장 긴 문단에 맞춰 자동으로 조절합니다. - 직접 넣은 줄바꿈은 유지하며 글자 크기·굵기·여백도 반영합니다. 병합 칸에서는 다른 열 너비를 유지하고 오른쪽 끝 열만 맞춥니다. 너비는 내 브라우저에 기억됩니다. - 셀을 우클릭하면 현재 열 너비 자동 맞춤·전체 열 너비 자동 맞춤을 사용할 수 있습니다. 전체 맞춤에는 접힌 월 열도 포함됩니다. - 관리자는 글 칸 하나를 클릭한 뒤 위·아래·왼쪽 테두리를 잡아 다른 글 칸으로 끌면 내용과 글자 서식을 함께 이동할 수 있습니다. 대상에 글이 있으면 덮어쓰기를 확인하며, Esc로 끌기를 취소합니다. - 행 높이는 가장 높은 글 칸에 맞춰 자동으로 늘어나거나 줄어들며, 위·아래 여백은 각각 6px입니다. 짧은 글도 같은 위치에서 상단 정렬됩니다. - 영역·줄 이름은 눌러서 그 자리에서 고치고(Enter 저장, Esc 취소), - 구역·항목 칸을 우클릭하거나 칸 오른쪽 위의 작은 ⋮ 버튼(마우스를 올리면 보임)을 눌러 색·순서·줄 추가·삭제를 합니다. - 키보드로는 Tab으로 이름 칸·⋮로 가서 Enter(이름 칸 = 이름 고치기, ⋮ = 메뉴), 메뉴 안에서 ↑↓·Enter, - Esc로 닫습니다. 터치 화면에서는 ⋮ 버튼이 늘 옅게 보여 손가락으로 누르면 됩니다. 업무 영역 칸은 엑셀처럼 병합할 수 있습니다 — 칸을 마우스로 - 끌어 여러 칸을 고른 뒤 우클릭 → "셀 병합", 병합된 칸은 우클릭 → "병합 해제"(글은 왼쪽 위 칸에 남음). - 가로 병합은 같은 분기의 월 칸끼리만(연간·분기 칸은 세로로만) 되고, 칸들의 글은 순서대로 첫 칸에 모입니다. -
    저장이 안 되면(네트워크 끊김 등) 칸 테두리가 빨갛게 되고 쓴 글은 그대로 남습니다 — 다시 입력하거나 칸을 떠나면 다시 저장합니다. - 저장 안 된 칸이 있으면 줄·영역 추가·병합·셀 이동은 하지 않고 알려 주며, 그 상태로 페이지를 떠나려 하면 브라우저가 한 번 묻습니다. - 글은 내 브라우저에도 잠시 보관되어, 저장되지 못한 채 창이 닫혀도 다음에 열면 되살아납니다(그 사이 다른 사람이 같은 칸을 고쳤으면 되살리지 않음).
  • -
  • 주간 회의록(목표 표의 월 이름) — 지난주 리뷰는 언제나 바로 앞 주(7일 전 월~일) 회의록만 보여 줍니다. 그 주 회의록이 없으면 - "회의록 없음"으로 비워 두고, 몇 주 전 결과를 지난주처럼 보이지 않습니다. 회의록을 만드는 순서(다음 주를 먼저 만들어도)와 줄 이름 변경·순서 이동과 - 관계없이 같은 줄끼리 이어집니다. 실적 모듈에서 매출을 읽지 못하면 그 칸은 0원이 아니라 ⚠ 미확인으로 보입니다(필요 매출·달성률도 미확인). - 매출 자동 갱신은 평소엔 조용히 돌고, 실패하거나 일부 쇼핑몰만 실패하면 숫자 아래에 작은 안내와 다시 시도가 나옵니다 - (안내의 "마지막 갱신 성공" 시각은 실적 모듈이 기록한 시각). 실적 권한이 없으면 갱신하지 않고 저장된 실적으로 보여 줍니다.
  • +
  • 목표 — 연도를 골라 매출·로아스와 업무 영역별 연간·분기·월 계획을 봅니다. (연간 목표 설명)
  • +
  • 주간 회의록 — 목표 표의 월 이름을 눌러 이번주 계획과 지난주 리뷰를 함께 봅니다. (주간 회의록 설명)
  • 프로젝트 — 내가 멤버인 프로젝트 목록입니다. 누르면 그 프로젝트 화면으로 갑니다. 완료한 프로젝트는 아래 완료 프로젝트에 흐리게 모입니다.
  • 전체 멤버 — 관리자에게만 보입니다. 사람 아이콘을 누르면 그 사람이 맡은 모든 작업을 한눈에 봅니다.
  • @@ -140,16 +131,17 @@

    프로젝트 관리 메뉴는 관리자 페이지에서 “프로젝트 관리” 권한을 받은 직원에게 보입니다.

    - - + + - + - + +
    할 수 있는 일누가
    프로젝트 보기그 프로젝트의 멤버(또는 관리자). 멤버가 아니면 주소를 알아도 열리지 않습니다.
    작업·하위 작업·댓글그 프로젝트 멤버 누구나 만들고 고칠 수 있습니다.
    프로젝트 보기그 프로젝트의 멤버·소유자(또는 관리자). 멤버가 아니면 주소를 알아도 열리지 않습니다.
    작업·하위 작업·댓글그 프로젝트의 멤버·소유자·관리자가 만들고 고칠 수 있습니다.
    작업·섹션·프로젝트 삭제만든 사람만 지울 수 있습니다(최고 관리자는 예외).
    댓글 고치기·지우기댓글을 쓴 사람(또는 관리자)만.
    새 프로젝트, 프로젝트 수정·순서 바꾸기관리자 (+ · ✎ · ⣿ 버튼이 관리자에게만 보입니다)
    새 프로젝트, 사이드바의 프로젝트 수정·순서 바꾸기관리자 (+ · ✎ · ⣿ 버튼이 관리자에게만 보입니다)
    멤버 배정·제외, 프로젝트 소유자 바꾸기관리자
    다른 프로젝트에서 연결돼 온 작업원래 프로젝트 멤버가 아니면 읽기만 — 내용·댓글·첨부는 보이지만 고치거나 댓글을 달 수 없습니다(연결된 보드 안에서 섹션 옮기기는 됩니다).
    멤버에서 빠졌을 때그 프로젝트의 작업은 내 작업·수신함·알림·검색에서 사라지고, 예전 링크로도 열리지 않습니다. 새 알림도 오지 않습니다.
    휴지통 보기·복구, 전체 멤버, 대시보드의 담당자별 차트관리자
    목표 보기누구나 · 목표 입력·연도 추가·업무 영역 편집은 관리자
    목표·주간 회의록 보기프로젝트 관리 권한이 있는 직원 누구나 · 입력·생성·삭제·구조 편집은 관리자
    프로젝트 제목 바로 고치기그 프로젝트 멤버·소유자·관리자
    @@ -331,7 +323,7 @@
  • 그 프로젝트에서 들어갈 섹션을 고릅니다.
  • 다른 프로젝트에 추가를 누릅니다. 빼려면 이름 옆 ×(연결 해제).
  • -

    작업은 하나라서 어느 보드에서 고쳐도 모두 같이 바뀝니다.

    +

    작업은 하나라서 원래 프로젝트에서 고친 내용이 연결된 보드에도 반영됩니다. 원래 프로젝트의 멤버가 아니면 연결된 작업의 내용·댓글·첨부는 읽기만 할 수 있습니다. 연결된 보드 안에서 섹션을 옮기는 것은 가능합니다.

    댓글

    작업 창 맨 아래에 항상 고정된 댓글 칸에 쓰고 Enter(스크롤해도 그 자리에 있습니다). 칸 오른쪽 ☺는 이모티콘, @는 멤버 태그입니다. 답글은 원 댓글 아래 들여 쓰여 ↳ 표시와 함께 보입니다. 내가 쓴 댓글은 ✎로 고치고 ×로 지웁니다. 댓글 속 웹 주소는 링크가 됩니다. 댓글에 붙인 파일은 그 댓글 아래에 보이고(파일만 보낸 댓글도), 첨부 파일 목록에는 댓글 표시가 붙습니다.

    댓글 대화창에서 파일을 보낼 때 보낼 수 없는 파일(빈 파일, 20MB 초과)이 있으면 댓글을 만들지 않고 그 파일만 빨갛게 표시합니다 — 빼고 다시 보내세요. 인터넷이 끊겨도 쓴 내용과 파일은 그대로 남아 다시 보낼 수 있고, 같은 댓글이 두 번 올라가지 않습니다. @태그는 이 작업을 볼 수 있는 사람만 고를 수 있습니다. 한글을 입력하는 중(조합 중)의 Enter는 글자 확정만 하고 보내지 않습니다.

    @@ -493,7 +485,7 @@ @@ -510,13 +502,161 @@
    하위 작업만 따로 지웠는데 상위 작업도 지워진 상태라면, 상위 작업을 먼저 복구해야 합니다.
    - + +
    +

    20연간 목표

    +

    한 해의 매출 목표·실적과 업무 계획을 한 표에서 관리합니다. 숫자는 위쪽 지표에, 실행 계획은 아래쪽 업무 영역에 적습니다. 프로젝트 관리 권한이 있는 직원은 볼 수 있고, 입력·구조 변경은 관리자만 할 수 있습니다.

    + +

    목표 열기와 연도 만들기

    +
      +
    1. 왼쪽 사이드바 목표를 눌러 연도 목록을 펼친 뒤 원하는 연도를 누릅니다. 올해는 목표가 아직 없어도 목록에 보입니다.
    2. +
    3. 관리자는 빈 연도 화면에서 해당 연도 목표 만들기, 또는 사이드바의 + 연도 추가로 새 표를 만듭니다.
    4. +
    5. 가장 가까운 이전 연도의 업무 영역·줄 구성을 가져옵니다. 이전 연도가 없으면 다음 연도의 구성을 사용하고, 처음이면 상품·마케팅·컨텐츠·유통으로 시작합니다. 이전 숫자와 계획 글은 복사하지 않습니다.
    6. +
    7. 위쪽 매출 단위를 확인한 뒤 월별 숫자와 계획을 입력합니다.
    8. +
    + +

    매출·로아스 입력과 달성률 계산

    + + + + + + + +
    칸입력·계산 방법
    매출 목표·실적관리자가 월별 숫자를 직접 입력합니다. 목표 표의 실적은 회의록의 자동 매출과 별도로 관리하므로 실적 모듈에서 자동으로 채워지지 않습니다.
    매출 단위예를 들어 단위가 백만원이면 30은 30,000,000원입니다. 단위를 바꿔도 이미 적은 숫자는 자동 환산되지 않으므로 숫자와 단위를 함께 확인하세요.
    연간·분기 매출해당 기간에 입력한 월 숫자의 합계입니다. 합계 칸에 따로 입력하지 않습니다.
    달성실적 ÷ 목표 × 100입니다. 월별로 계산하며, 연간·분기는 기간 전체 목표 합계 대비 입력된 실적 합계로 계산합니다. 목표가 없거나 0이면 달성률을 표시하지 않습니다. 100% 이상은 초록으로 표시됩니다.
    로아스(ROAS)광고비 대비 매출 비율을 % 단위로 적습니다. 예: 300은 300%입니다. 연간·분기는 월 매출과 ROAS로 환산한 광고비를 합쳐 계산하고, 필요한 월 매출이 빠져 있으면 입력된 ROAS의 단순 평균을 사용합니다.
    +

    숫자는 Enter 또는 칸을 떠날 때 저장됩니다. 숫자 칸을 비우면 값을 지우며, Esc를 누르면 마지막 저장값으로 돌아갑니다.

    +
    lightbulb
    1~3월 목표가 각각 100이고 1월 실적만 50이면 1분기 달성은 50 ÷ 300 = 약 16.7%입니다. 아직 실적을 넣지 않은 달의 목표도 분기 목표 합계에 포함됩니다.
    + +

    업무 영역·항목·연간·분기·월 계획

    +

    업무 영역은 상품·마케팅처럼 큰 분류, 항목은 그 안의 세부 주제입니다. 한 항목의 연간 칸에는 큰 방향, 분기 칸에는 중간 목표, 월 칸에는 구체적인 실행 계획을 적으면 주간 회의에서 확인하기 쉽습니다.

    + + +

    글자 서식 바꾸기

    +

    글 칸에서 글자를 드래그해 선택하면 해당 셀 상단에 서식 도구가 나타납니다. 선택한 글자에만 12색 견본·크기·굵게·기울임·밑줄을 적용합니다. 크기 버튼은 2px씩 조절하며 범위는 10~32px입니다.

    +

    굵게·기울임·밑줄은 다시 누르면 해제됩니다. 서식 초기화는 선택한 글자의 서식만 되돌리고 내용은 유지합니다. 글과 서식은 입력을 약 0.8초 멈추거나 칸을 떠날 때 자동 저장됩니다.

    + +

    분기 접기·열 너비·행 높이

    + + +

    셀 병합·병합 해제·내용 이동

    +
      +
    1. 관리자는 업무 영역의 글 칸을 마우스로 끌어 여러 칸을 선택한 뒤 우클릭 → 셀 병합을 누릅니다.
    2. +
    3. 가로 병합은 같은 분기의 월 칸끼리 가능합니다. 연간·분기 칸은 세로로만 병합합니다. 선택한 칸들의 글은 순서대로 첫 칸에 모입니다.
    4. +
    5. 병합된 칸을 우클릭 → 병합 해제하면 다시 나뉩니다. 글은 왼쪽 위 칸에 남습니다.
    6. +
    7. 글 칸 하나를 클릭한 뒤 위·아래·왼쪽 테두리를 잡아 다른 글 칸으로 끌면 내용과 글자 서식이 함께 이동합니다. 오른쪽 경계는 너비 조절용입니다. 대상에 글이 있으면 덮어쓰기를 확인하고, Esc로 이동을 취소합니다.
    8. +
    + +

    저장 실패와 연도 삭제

    +

    저장 성공 시 칸 테두리가 잠깐 초록으로 바뀝니다. 실패하면 빨간 테두리와 안내가 나오며 입력값은 유지됩니다. 다시 입력하거나 칸을 떠나면 재시도합니다. 저장 안 된 값이 있으면 영역·줄 추가, 병합, 내용 이동을 진행하기 전에 저장을 시도하고, 실패하면 해당 작업을 멈춥니다.

    +

    저장되지 않은 초안은 내 브라우저에도 잠시 보관합니다. 다음에 같은 화면을 열면 복원하지만, 그 사이 다른 사람이 같은 칸을 바꿨으면 자동으로 덮어쓰지 않습니다. 저장 안 된 상태로 페이지를 떠나려 하면 브라우저가 확인합니다.

    +

    관리자의 연도 삭제는 그 연도의 숫자·업무 영역·계획 글을 삭제합니다. 확인창에 연도를 직접 입력해야 진행되며 되돌릴 수 없습니다.

    +
    + + +
    +

    21주간 회의록

    +

    월 목표를 기준으로 지난주 결과를 리뷰하고 이번주 할 일과 금액 목표를 정하는 화면입니다. 연간 목표의 월 계획, 실적 모듈의 매출, 주별 결정 사항을 함께 확인합니다. 직원은 조회할 수 있고, 생성·입력·삭제는 관리자만 할 수 있습니다.

    + +

    회의록 열기와 주차 기준

    +
      +
    1. 왼쪽 목표에서 연도를 선택하고 표 머리의 월 이름을 누릅니다.
    2. +
    3. 위쪽 주차 탭 또는 오른쪽 작은 달력의 주 한 줄을 눌러 주를 고릅니다. 점은 회의록이 있는 주, 이번 주는 현재 주입니다. 이전·다음 달 버튼으로 달을 바꿉니다.
    4. +
    5. 한 주는 월요일~일요일이고, 월요일이 속한 달의 회의록입니다. 1주차는 그 달 첫 월요일이 있는 주입니다. 예: 2026년 10월 1주차는 10/5~10/11이며, 9/28~10/4는 9월 회의록입니다.
    6. +
    7. 작은 달력의 흐린 앞 달 주를 누르면 그 달 회의록으로 갑니다. 해당 연도 목표 버튼은 연간 목표 표로 돌아갑니다.
    8. +
    + +

    회의록 만들기와 이어받는 항목

    +

    선택한 주에 회의록이 없으면 관리자에게 해당 주차 회의록 만들기가 보입니다. 화면을 열기만 해서는 회의록이 만들어지지 않습니다.

    + + +

    이 달 계획 확인

    +

    제목 아래 해당 월 계획은 연간 목표 표에 적은 월 계획을 업무 영역별로 보여 줍니다. 빈 계획은 생략하고, 병합 칸은 해당 월을 포함하는 계획을 한 번 표시합니다. 여기서는 읽기만 하므로 수정하려면 연간 목표 표로 돌아갑니다.

    + +

    월 목표·누적·주당 필요 매출 읽기

    + + + + + + + + +
    지표뜻과 출처
    월 목표 매출·목표 ROAS연간 목표 표의 해당 월 숫자입니다. 매출 단위가 원·천원·만원·십만원·백만원·천만원·억원이면 원으로 환산합니다. 모르는 단위는 원 환산을 못 하므로 주당 필요 매출도 계산하지 못합니다.
    월 누적 실적(지난주까지)실적 모듈의 매출 집계 쇼핑몰 매출을 그 달 1일부터 선택한 주의 직전 일요일까지 합칩니다. 현재 날짜·월말을 넘기지 않습니다. 이번주 매출은 이 누적에 포함하지 않습니다.
    주당 필요(월 목표 매출 − 월 누적 실적) ÷ 이번주를 포함한 그 달 남은 주 수입니다. 원 단위 정수로 계산하고, 이미 월 목표를 달성했다면 0원입니다.
    전주 목표정확히 7일 전 회의록에 적은 금주 목표입니다. 그 주 회의록이 없으면 비어 있습니다.
    전주 결과·달성률실적 모듈의 전주 월~일 매출과 그 값 ÷ 전주 목표 × 100입니다. 전주 결과는 매출 자료이므로 전주 회의록이 없어도 조회될 수 있습니다. 목표가 없거나 0이면 달성률은 없습니다.
    금주 목표·현재 실적금주 목표는 관리자가 정하는 원 단위 금액입니다. 현재 실적은 선택한 주 월요일부터 일요일 또는 오늘 중 이른 날까지의 매출입니다. 아직 시작하지 않은 미래 주의 실적은 비어 있습니다.
    +
    lightbulb
    월 목표가 1억원이고 지난주까지 누적이 4천만원, 남은 주가 이번주 포함 3주이면 주당 필요는 2천만원입니다. 이 숫자는 계획 참고값이며 금주 목표로 자동 저장되지는 않습니다.
    +

    월 목표·누적은 달의 1일~말일 기준이고, 주간 결과는 월요일~일요일 기준입니다. 달을 넘는 마지막 주의 주간 결과에는 다음 달 날짜가 포함될 수 있습니다.

    + +

    이번주 할 일·정량 목표·참석자·메모 입력

    +
      +
    1. 금주 목표에 전체 매출 목표를 적습니다. 줄별 정량 목표는 각 항목의 목표 금액이며, 현재는 원 단위입니다. 금주 목표와 줄별 목표 합계는 자동으로 맞춰지지 않습니다.
    2. +
    3. 각 항목의 이번주 할 일 · 행사에 실행할 일과 일정을 적습니다.
    4. +
    5. 참석자를 눌러 프로젝트 관리 권한이 있는 등록 직원 중 선택합니다. 찾기·전원 선택·모두 해제를 사용할 수 있으며, 칩의 ×로 참석자를 뺍니다.
    6. +
    7. 아래 결정 사항 · 메모에 회의 결론과 다음주까지 확인할 일을 적습니다.
    8. +
    +

    금액은 1,200,000·120만·1.5억·3천만·1억2천만처럼 입력할 수 있습니다. Enter 또는 칸을 떠날 때 원 단위로 저장되고, 빈칸은 값을 지웁니다. 글·메모는 입력을 약 0.8초 멈추거나 칸을 떠날 때, 참석자·평가는 바꾸는 즉시 저장됩니다.

    + +

    지난주 리뷰·결과·평가

    +

    지난주 할 일과 목표는 정확히 7일 전 주의 같은 항목에서 가져옵니다. 이름 변경·순서 이동·회의록 생성 순서와 관계없이 이어진 같은 줄을 찾습니다. 그 주 회의록이 없으면 “회의록 없음”, 회의록은 있지만 항목이 없으면 “지난주 회의록에 없는 줄”로 표시합니다. 몇 주 전 기록을 지난주로 대신 보여 주지 않습니다.

    + + +

    쇼핑몰 연결·자동 실적·매출 갱신

    +
      +
    1. 항목을 우클릭하거나 ⋯ → 쇼핑몰 연결(결과 자동)…에서 실적 모듈의 사용 중인 쇼핑몰을 고릅니다. 자동 결과를 쓰지 않으려면 연결 안 함을 선택합니다.
    2. +
    3. 연결된 항목의 정량 목표 아래에 이번주 실적과 목표 대비 비율이 나옵니다. 지난주 리뷰의 자동 결과는 지난주 항목의 쇼핑몰 연결을 기준으로 계산합니다. 이번주 연결을 바꿔도 지난주 연결은 바뀌지 않습니다.
    4. +
    5. 유통 구역은 항목 이름으로 일부 쇼핑몰을 추측해 연결하므로 생성 후 연결 배지를 확인하세요. 마케팅의 “네이버” 같은 광고 항목은 자동 연결하지 않습니다.
    6. +
    +

    실적 갱신 권한이 있으면 주차를 열 때 지난주부터 선택한 주의 오늘까지 매출을 자동 갱신합니다. 같은 주의 자동 갱신은 브라우저에서 10분 간격으로 제한하며, 성공 시에는 별도 큰 안내 없이 숫자가 바뀝니다. 실패·일부 쇼핑몰 실패 시 작은 안내와 다시 시도가 나옵니다. 마지막 갱신 성공 시각은 실적 모듈 기록이며 숫자에 마우스를 올려 확인할 수 있습니다.

    + + + + + + + +
    표시·상태확인할 내용
    미확인조회에 실패해 값을 알 수 없습니다. 0원과 다릅니다. 이에 의존하는 달성률·주당 필요 매출도 계산하지 않습니다. 안내의 다시 시도를 사용하거나 실적 연결 상태를 확인하세요.
    0원매출 조회는 성공했지만 해당 기간에 저장된 실적이 없거나 합계가 0원입니다. 필요하면 실적 화면에서 매출 자료를 갱신하세요.
    실적 미사용연결 쇼핑몰이 사용 중이 아니거나 목록에 없습니다. 해당 항목의 결과는 직접 입력합니다.
    실적 미연결·집계 대상 없음자동 실적·누적이 비어 있습니다. 회의록 계획·메모는 계속 입력할 수 있습니다.
    실적 갱신 권한 없음새 매출을 요청하지 않고 저장된 실적을 보여 줍니다. 회의록 조회 권한과 매출 갱신 권한은 별개입니다.
    + +

    구역·줄 추가·순서·삭제

    + + +

    저장 확인·인쇄·회의록 삭제

    +

    저장 실패 시 칸이 빨갛게 표시되며 입력값은 남습니다. 다시 입력하거나 칸을 떠나면 재시도합니다. 금주 목표를 저장하거나 자동 실적을 갱신해도 다른 칸의 작성 중인 글은 유지됩니다. 저장이 안 된 상태에서는 줄 추가·순서 이동·쇼핑몰 연결 같은 작업에 앞서 저장을 다시 시도합니다. 실패하면 구조 변경을 멈춥니다. 초안 복원과 페이지 떠남 보호는 목표의 저장 안내와 같습니다.

    +

    인쇄는 브라우저 인쇄창을 엽니다. 인쇄용 화면에서는 사이드바·작은 달력·편집 도구를 숨깁니다. 브라우저의 PDF 저장도 사용할 수 있습니다.

    +

    관리자의 회의록 삭제는 선택한 한 주의 회의록과 줄을 삭제합니다. 다음주 화면의 지난주 리뷰도 비게 됩니다. 같은 주를 다시 만들면 항목 구성은 이어질 수 있지만 삭제한 글과 금액은 복구되지 않습니다.

    +
    + +
    -

    20단축키와 자주 묻는 질문

    +

    22단축키와 자주 묻는 질문

    단축키

    - + @@ -530,26 +670,14 @@

    Q. 다른 사람이 바꾼 내용이 안 보여요.
    보통 8초 안에 자동으로 반영됩니다. 오래 걸리면 새로고침(F5)하세요.

    Q. 하위 작업을 다른 프로젝트 작업으로 옮길 수 있나요?
    하위 작업은 같은 프로젝트 안의 작업으로만 옮길 수 있습니다.

    Q. 작업을 두 프로젝트에 같이 두고 싶어요.
    작업 편집 창의 “프로젝트” 칸에서 다른 프로젝트에 추가를 쓰세요. (8장)

    +

    Q. 목표 표의 실적과 회의록 매출이 달라요.
    목표 표의 월 실적은 직접 입력한 숫자이고, 회의록 매출은 실적 모듈 자료입니다. 매출 단위와 집계 기간도 확인하세요. (숫자 지표 · 회의록 지표)

    +

    Q. 지난주 회의록이 있는데 리뷰가 비어 있어요.
    화면의 지난주 날짜와 항목을 확인하세요. 정확히 7일 전 회의록의 이어진 같은 항목만 표시합니다. 따로 추가한 줄은 이름이 같아도 다른 항목일 수 있습니다. (지난주 리뷰)

    +

    Q. 도움말에서 필요한 설명을 빠르게 찾고 싶어요.
    이 페이지 위쪽 검색창에 단어를 입력하고 결과를 누르세요. 제목·본문의 일치 단어가 강조되고 해당 소제목으로 이동합니다. Enter는 첫 결과로 이동, Esc나 지우기는 검색을 초기화합니다.

    arrow_upward - + {% endblock %} diff --git a/app/static/project-help.css b/app/static/project-help.css index 79f948d..1186049 100644 --- a/app/static/project-help.css +++ b/app/static/project-help.css @@ -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; } +} diff --git a/app/static/project-help.js b/app/static/project-help.js new file mode 100644 index 0000000..cb65b52 --- /dev/null +++ b/app/static/project-help.js @@ -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); }); + } +})(); diff --git a/docs/PROJECT_MODULE.md b/docs/PROJECT_MODULE.md index 95a7114..693206f 100644 --- a/docs/PROJECT_MODULE.md +++ b/docs/PROJECT_MODULE.md @@ -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 화면에서 복원한다. 취소는 적용하지 않는다. diff --git a/tests/js/help.browser.test.js b/tests/js/help.browser.test.js new file mode 100644 index 0000000..ae79de3 --- /dev/null +++ b/tests/js/help.browser.test.js @@ -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; }); diff --git a/tests/js/help_ui.test.js b/tests/js/help_ui.test.js new file mode 100644 index 0000000..3f58185 --- /dev/null +++ b/tests/js/help_ui.test.js @@ -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(""); +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 복원"); diff --git a/tests/js/render_help.py b/tests/js/render_help.py new file mode 100644 index 0000000..232de70 --- /dev/null +++ b/tests/js/render_help.py @@ -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)
    키하는 일
    /전체 검색창으로 이동(입력 중이 아닐 때)
    /작업 화면에서는 전체 검색창, 이 도움말에서는 도움말 검색창으로 이동(입력 중이 아닐 때)
    Esc작업 편집 창 · 날짜 창 · 메뉴 닫기, 입력 취소
    Enter하위 작업 추가, 섹션 이름 저장, 댓글 전송, 날짜 직접 입력 확정
    Ctrl + 휠타임라인 확대·축소