diff --git a/app/modules/project/router.py b/app/modules/project/router.py index e4bace0..c1c4e31 100644 --- a/app/modules/project/router.py +++ b/app/modules/project/router.py @@ -2057,6 +2057,27 @@ def api_restore_trash(request: Request, trash_id: int) -> JSONResponse: return JSONResponse({"ok": True, **result}) +@router.get("/help", response_class=HTMLResponse) +def help_page(request: Request) -> HTMLResponse: + """프로젝트 관리 도움말 — 상단 바 ? 아이콘(새 탭). 처음 쓰는 사람을 위한 기능 설명. + DB 없이 그리는 정적 안내라 DB 설정 전에도 열린다.""" + from app.main import build_erp_nav, render_template # noqa: WPS433 + from app.store import is_admin # noqa: WPS433 + + user = _require_user(request) + return render_template( + request, + "project/help.html", + { + "user": user, + "is_admin": is_admin(user), + "nav_items": build_erp_nav(user, active="project"), + "page_title": "프로젝트 관리 도움말", + "page_subtitle": "처음 쓰는 분을 위한 기능 안내", + }, + ) + + @router.get("/inbox", response_class=HTMLResponse) def inbox_page(request: Request) -> HTMLResponse: from app.main import build_erp_nav, render_template # noqa: WPS433 diff --git a/app/modules/project/templates/project/_help_btn.html b/app/modules/project/templates/project/_help_btn.html new file mode 100644 index 0000000..79c1612 --- /dev/null +++ b/app/modules/project/templates/project/_help_btn.html @@ -0,0 +1,6 @@ +{# 프로젝트 관리 도움말 — 상단 바 로그아웃 오른쪽의 ? 아이콘(erp_base 의 topbar_after_logout). + 새 탭으로 열어 하던 작업이 끊기지 않게 한다. #} + + help + diff --git a/app/modules/project/templates/project/help.html b/app/modules/project/templates/project/help.html new file mode 100644 index 0000000..4735edf --- /dev/null +++ b/app/modules/project/templates/project/help.html @@ -0,0 +1,498 @@ +{% extends "erp_base.html" %} + +{% block head_extra %} + + + +{% endblock %} + +{% block topbar_after_logout %}{% include "project/_help_btn.html" %}{% endblock %} + +{% block content %} +{# ── 프로젝트 관리 도움말 — 처음 쓰는 사람을 위한 기능 안내(정적 페이지, DB 불필요). + 기능이 바뀌면 이 페이지도 같이 고친다(docs/PROJECT_MODULE.md 와 짝). ── #} +
+ + +
+ +
+

프로젝트 관리 도움말

+

프로젝트 관리는 아사나(Asana) 방식으로 팀의 일을 정리하는 도구입니다. + 프로젝트 안에 할 일(작업)을 만들고, 담당자와 마감일을 정하고, 댓글로 이야기하며 끝까지 챙깁니다. + 처음이라면 아래 다섯 단계만 따라 해도 바로 쓸 수 있어요.

+
+
1단계왼쪽 목록에서 프로젝트를 누릅니다.
+
2단계보드에서 + 작업 추가로 할 일을 만듭니다.
+
3단계카드의 사람·달력 아이콘으로 담당자와 마감일을 정합니다.
+
4단계카드를 눌러 설명을 쓰고, 댓글에 @로 동료를 부릅니다.
+
5단계일을 마치면 ✓ 완료로 표시를 누릅니다.
+
+
+ + +
+

1먼저 알아둘 용어

+

화면에 나오는 말은 아사나 한국어판과 같은 용어를 씁니다.

+ + + + + + + + + + + + + +
용어뜻
프로젝트함께 진행하는 일의 큰 묶음입니다. 예) “마케팅”, “신상품 출시”. 색상과 아이콘으로 구분합니다.
섹션프로젝트 안의 단계나 분류입니다. 보드에서 세로 칸 하나가 섹션입니다. 예) “할 일 · 진행 중 · 검토 · 완료”.
작업실제 할 일 하나입니다. 보드의 카드 한 장이 작업 하나입니다.
하위 작업작업을 더 잘게 나눈 할 일입니다. 작업 안에 목록으로 붙습니다. 원래 작업은 상위 작업이라고 부릅니다.
담당자그 작업을 책임지고 하는 사람 한 명입니다.
협업자작업의 진행 소식(완료·댓글)을 함께 받는 사람들입니다. 만든 사람·담당자·댓글 쓴 사람·@태그된 사람은 자동으로 들어갑니다.
마감일 / 시작일언제까지 끝낼지(마감일), 언제 시작하는지(시작일, 선택)입니다.
우선순위높음 · 보통 · 낮음. 급한 일을 표시합니다.
@태그설명이나 댓글에서 @를 누르고 사람을 고르면, 그 사람의 수신함에 작업이 쌓입니다.
수신함나를 태그한 작업과 나에게 온 알림을 모아 보는 곳입니다.
내 작업모든 프로젝트에서 내가 담당자인 작업만 모아 보는 곳입니다.
+
+ + +
+

2화면 구성

+ +

왼쪽 사이드바

+
    +
  • 전체 검색 — 내가 볼 수 있는 모든 작업을 제목·설명·댓글로 찾습니다. (18장)
  • +
  • 수신함 — 나를 태그한 작업과 알림. 숫자 배지는 아직 확인하지 않은 @태그 수입니다. (17장)
  • +
  • 내 작업 — 내가 담당자인 작업 모음. 숫자 배지는 아직 끝나지 않은 작업 수입니다. (15장)
  • +
  • 휴지통 — 지운 작업을 3개월 보관합니다. 관리자에게만 보입니다. (19장)
  • +
  • 프로젝트 — 내가 멤버인 프로젝트 목록입니다. 누르면 그 프로젝트 화면으로 갑니다. 완료한 프로젝트는 아래 완료 프로젝트에 흐리게 모입니다.
  • +
  • 전체 멤버 — 관리자에게만 보입니다. 사람 아이콘을 누르면 그 사람이 맡은 모든 작업을 한눈에 봅니다.
  • +
+

위쪽 바

+
    +
  • notifications 종 아이콘 — 읽지 않은 알림 수가 표시되고, 누르면 수신함으로 갑니다.
  • +
  • help 물음표 — 지금 보고 있는 이 도움말을 새 탭으로 엽니다.
  • +
+
info +
여러 사람이 동시에 써도 걱정 없습니다. 다른 사람이 바꾼 내용은 약 8초 안에 내 화면에 자동으로 반영됩니다(새로고침하지 않아도 됩니다). 내가 입력 중인 창은 건드리지 않습니다.
+
+ + +
+

3누가 무엇을 할 수 있나요

+

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

+ + + + + + + + + +
할 수 있는 일누가
프로젝트 보기그 프로젝트의 멤버(또는 관리자). 멤버가 아니면 주소를 알아도 열리지 않습니다.
작업·하위 작업·댓글그 프로젝트 멤버 누구나 만들고 고칠 수 있습니다.
작업·섹션·프로젝트 삭제만든 사람만 지울 수 있습니다(최고 관리자는 예외).
댓글 고치기·지우기댓글을 쓴 사람(또는 관리자)만.
새 프로젝트, 프로젝트 수정·순서 바꾸기관리자 (+ · ✎ · ⣿ 버튼이 관리자에게만 보입니다)
멤버 배정·제외관리자
휴지통 보기·복구, 전체 멤버, 대시보드의 담당자별 차트관리자
+
+ + +
+

4프로젝트 만들기·고치기

+

새 프로젝트 만들기 (관리자)

+
    +
  1. 왼쪽 사이드바 프로젝트 제목 옆의 +를 누릅니다.
  2. +
  3. 이름(필수)과 설명을 적습니다.
  4. +
  5. 마감일 옆 달력 아이콘을 눌러 날짜를 고릅니다(없어도 됩니다).
  6. +
  7. 색상(16가지)과 아이콘을 고릅니다. 아이콘 첫 칸 Aa를 고르면 아이콘 대신 이름 첫 글자가 나옵니다.
  8. +
  9. 함께할 멤버에 체크하고 만들기를 누릅니다. 만든 사람은 자동으로 프로젝트 주인이 됩니다.
  10. +
+
lightbulb +
새 프로젝트는 섹션 없이 빈 보드로 시작합니다. 보드의 + 섹션 추가로 “할 일 · 진행 중 · 완료”처럼 단계를 먼저 만들어 두면 편합니다. (6장)
+

프로젝트 수정 (관리자)

+

사이드바의 프로젝트 이름에 마우스를 올리면 오른쪽에 ✎(수정)과 ×(삭제)가 나옵니다. + 이름에서 마우스 오른쪽 버튼을 눌러도 열기 · 수정 · 삭제 메뉴가 나옵니다.

+
    +
  • 이름 · 설명 · 마감일(날짜 창의 + 시작일로 시작일도) · 색상 · 아이콘을 바꿉니다.
  • +
  • 프로젝트 완료에 체크하면 목록 맨 아래 “완료 프로젝트”로 옮겨지고 흐리게 보입니다.
  • +
  • 색이 밝으면(연노랑·하늘색 등) 글자와 아이콘이 자동으로 어둡게 바뀌어 잘 보입니다.
  • +
+

순서 바꾸기 (관리자)

+

프로젝트 이름에 마우스를 올리면 왼쪽에 손잡이 ⣿가 나옵니다. 잡고 위아래로 끌어 놓으면 순서가 저장됩니다.

+

프로젝트 삭제

+

× 또는 우클릭 삭제. 프로젝트를 만든 사람만 지울 수 있고, 안의 작업도 모두 함께 지워집니다.

+
warning +
프로젝트 삭제는 되돌릴 수 없습니다. 끝난 프로젝트는 지우기보다 프로젝트 완료로 표시하는 것을 권합니다.
+

멤버 배정 (관리자)

+

프로젝트 화면 제목 오른쪽에 멤버 사진이 겹쳐서 보입니다.

+
    +
  • + — 멤버를 추가합니다(프로젝트 관리 권한이 있는 직원 중에서 고릅니다).
  • +
  • 사진에 마우스 → 이름이 보입니다. 클릭 → 그 사람이 이 프로젝트에서 맡은 작업 목록이 뜹니다.
  • +
  • 사진에서 우클릭 → 제외로 멤버에서 뺍니다.
  • +
+
+ + +
+

5보기 전환과 필터

+

보기 탭

+

프로젝트 화면 맨 위 왼쪽의 탭으로 같은 작업을 다른 모양으로 봅니다.

+ + + + + + + +
탭이럴 때 좋아요
보드섹션(단계)별 카드로 흐름을 볼 때. 카드를 끌어 단계를 옮깁니다. (6장)
목록표처럼 한 줄씩 빠르게 훑고 정렬할 때. (11장)
캘린더한 달 달력에서 일정을 볼 때. (12장)
타임라인기간(시작~마감)을 막대로 보며 일정을 조정할 때. (13장)
대시보드완료·미완료·지연 숫자와 차트로 진행 상황을 볼 때. (14장)
+

범위: 이 프로젝트 / 전체 프로젝트

+

화면 오른쪽 위 토글입니다. 이 프로젝트는 지금 프로젝트만, 전체 프로젝트는 내가 볼 수 있는 모든 프로젝트의 작업을 함께 보여줍니다. + 전체 프로젝트일 때 카드 위에는 어느 프로젝트 작업인지 이름이 붙습니다.

+

필터 바

+

탭 아래 한 줄로 작업을 거르고 정렬합니다. 다섯 가지 보기 모두에 똑같이 적용되고, 프로젝트마다 이 브라우저에 기억됩니다.

+
    +
  • 찾기 — 제목·설명·담당자에 들어간 글자로 거릅니다.
  • +
  • 상태 — 전체 / 미완료 / 완료
  • +
  • 담당자 — 전체 / 나 / 담당자 없음 / 특정 사람
  • +
  • 마감 — 전체 / 마감 지남 / 오늘 마감 / 이번 주 마감 / 마감일 없음
  • +
  • 우선순위 — 전체 / 높음 / 보통 / 낮음
  • +
  • 정렬 — 기본 / 마감일순 / 우선순위순 / 제목순 / 담당자순 / 최근 생성순
  • +
  • 초기화 — 필터를 모두 처음 상태로 되돌립니다.
  • +
+
info +
보드에서 카드 순서를 끌어 바꾸는 것은 “정렬: 기본”이고 필터를 쓰지 않을 때만 됩니다. 필터로 일부가 가려져 있으면 놓은 자리와 실제 순서가 어긋나기 때문입니다.
+
+ + +
+

6보드 — 섹션과 작업 카드

+

보드는 섹션(세로 칸)이 옆으로 늘어선 화면입니다. 섹션이 많으면 가로로 스크롤되고, 한 섹션에 카드가 많으면 그 섹션 안에서만 세로로 스크롤됩니다.

+

섹션 다루기

+
    +
  • 섹션 추가 — 보드 오른쪽 위 + 섹션 추가.
  • +
  • 이름 바꾸기 — 섹션 이름을 누르면 그 자리에서 고칩니다. Enter 저장, Esc 취소.
  • +
  • 순서 바꾸기 — 섹션 머리(이름 줄)를 잡고 좌우로 끌어 놓습니다.
  • +
  • … 메뉴(머리 오른쪽 … 또는 머리 우클릭): +
      +
    • 작업 추가 · 이름 변경
    • +
    • 섹션 편집 — 색상과 기본 담당자를 정합니다. 색상 첫 칸(연회색)은 “색 없음”입니다.
    • +
    • 섹션 작업 모두 완료 — 그 섹션의 미완료 작업을 한 번에 완료합니다.
    • +
    • 완료 섹션으로 지정 — 이 섹션으로 옮긴 카드는 자동으로 완료되고, 밖으로 빼면 다시 미완료가 됩니다. 완료 섹션은 흐리게, 보드 끝에 놓입니다.
    • +
    • 삭제 — 섹션을 만든 사람만. 안의 작업은 지워지지 않고 “미지정” 칸으로 모입니다.
    • +
    +
  • +
+
lightbulb +
기본 담당자를 정해 두면, 그 섹션에 담당자 없는 작업을 새로 만들거나 옮겨 올 때 그 사람이 자동으로 담당자가 됩니다. 예) “검토” 섹션의 기본 담당자 = 팀장.
+

작업 카드 다루기

+
    +
  • 작업 추가 — 섹션 머리의 + 또는 섹션 맨 아래 + 작업 추가, 또는 위쪽 바의 + 작업 추가. 오른쪽에 작업 편집 창이 열립니다.
  • +
  • 열기 — 카드를 누르면 오른쪽에 작업 편집 창이 열립니다. (8장)
  • +
  • 담당자·마감일 바로 바꾸기 — 카드의 사람 아이콘이나 날짜를 누르면 그 자리에서 바꿉니다. 비어 있으면 카드에 마우스를 올렸을 때 점선 원 아이콘이 나타납니다.
  • +
  • 옮기기 — 카드를 끌어 다른 섹션에 놓으면 섹션이 바뀌고, 같은 섹션 안에서 위아래로 놓으면 순서가 바뀝니다.
  • +
  • 우클릭 메뉴 — 열기 · 작업 링크 복사 · 완료로 표시 · 삭제
  • +
  • 댓글 — 카드의 💬 N을 한 번 누르면 댓글 대화창이 열립니다. (16장)
  • +
+

마감일 색의 의미

+ + + + + +
표시뜻
오늘 · 내일곧 마감(초록)
어제 · 09/20(일)마감이 지남(빨강). 완료한 작업도 지난 마감일은 빨강으로 남아 늦게 끝낸 것을 알 수 있습니다.
09/30(수)그 밖의 날짜(기본 글자색)
+
+ + +
+

7카드에서 하위 작업 다루기

+

하위 작업이 있는 카드에는 3 ⤷ ▾ 처럼 개수 버튼이 붙습니다. 누르면 카드 아래로 하위 작업 목록이 펼쳐집니다.

+
    +
  • 완료 — 줄 왼쪽 ✓를 누릅니다.
  • +
  • 마감일·담당자 — 줄 오른쪽 날짜나 사람 아이콘을 누르면 그 자리에서 바꿉니다.
  • +
  • 열기 — 줄을 누르면 그 하위 작업이 작업처럼 편집 창으로 열립니다.
  • +
  • 우클릭 — 열기 · 상위 작업 열기 · 완료로 표시 · 하위 작업 삭제
  • +
  • 다른 작업으로 옮기기 — 하위 작업 한 줄을 끌어서 다른 카드에 놓으면 그 작업의 하위 작업이 됩니다(놓을 수 있는 카드는 보라색 테두리가 생깁니다). 같은 프로젝트 안에서만 옮길 수 있습니다.
  • +
+

+ 하위 작업 추가

+
    +
  1. 펼친 목록 맨 아래 + 하위 작업 추가를 누릅니다.
  2. +
  3. 새 줄의 “작업 이름 입력” 칸에 이름을 씁니다.
  4. +
  5. 필요하면 달력 아이콘으로 마감일, 사람 아이콘으로 담당자를 고릅니다.
  6. +
  7. Enter를 누르면 만들어지고, 빈 줄이 다시 열려 다음 하위 작업을 이어서 쓸 수 있습니다.
  8. +
  9. 다 썼으면 Esc를 누르거나 빈 채로 다른 곳을 누르면 닫힙니다.
  10. +
+
+ + +
+

8작업 편집 창

+

카드·목록 줄·캘린더 막대를 누르면 화면 오른쪽에 작업 편집 창이 열립니다. 창의 왼쪽 가장자리를 끌면 너비를 넓히거나 좁힐 수 있습니다.

+

맨 위 버튼

+ + + + + + +
버튼하는 일
link공유이 작업의 주소를 복사합니다. 메신저로 보내면 받은 멤버가 바로 이 작업을 엽니다.
✓ 완료로 표시작업을 완료합니다. 다시 누르면 ↩ 완료 취소.
삭제작업을 지웁니다(만든 사람만). 하위 작업이 있으면 함께 지울지 한 번 더 묻습니다. 지운 작업은 휴지통에 3개월 보관됩니다.
취소 · 저장제목·담당자·섹션·우선순위·마감일·설명은 저장을 눌러야 반영됩니다. 저장하지 않고 닫으려 하면 “저장하시겠습니까?”를 묻습니다.
+
info +
협업자 · 하위 작업 · 첨부 파일 · 다른 프로젝트 추가 · 댓글은 누르는 즉시 저장됩니다. 저장 버튼이 필요 없습니다.
+

제목과 기본 정보

+
    +
  • 제목 — 맨 위 큰 글씨를 눌러 바로 고칩니다.
  • +
  • 담당자 — 사진+이름을 누르면 “아이콘 + 이름” 목록에서 고릅니다. 담당자 없음도 있습니다.
  • +
  • 섹션 — 이 작업이 들어갈 섹션을 고릅니다.
  • +
  • 우선순위 — 높음 · 보통 · 낮음
  • +
  • 마감일 — 달력 아이콘을 누르면 날짜 창이 열립니다. (10장)
  • +
+

협업자

+
    +
  • 협업자는 사진+이름으로 보입니다. 사람에 마우스를 올리면 ×가 나와 뺄 수 있습니다.
  • +
  • 협업자가 없으면 점선 원 협업자 없음을 눌러 추가하고, 있으면 옆 +로 추가합니다.
  • +
  • 오른쪽 협업자로 참여 / 협업자에서 나가기로 나 자신을 넣고 뺍니다.
  • +
  • 협업자에게는 작업 완료와 새 댓글 알림이 갑니다.
  • +
+

설명

+
    +
  • 서식 도구: B 굵게 · I 기울임 · U 밑줄 · 글머리 목록 · 번호 목록 · 인용 · 링크 · ×서식(서식 지우기) · 이미지 넣기
  • +
  • 이미지 — 캡처한 그림을 Ctrl+V로 바로 붙여 넣을 수 있습니다. 그림을 누르면 모서리를 끌어 크기를 바꾸거나 지울 수 있습니다.
  • +
  • 링크 — 웹 주소를 붙여 넣으면 자동으로 링크가 되고, 누르면 새 탭에서 열립니다.
  • +
  • @태그 — @를 누르면 사람 목록이 뜹니다. 고른 사람의 수신함에 이 작업이 쌓입니다.
  • +
+

첨부 파일

+

파일 추가로 파일을 올립니다(한 파일 최대 20MB). 파일 이름을 누르면 내려받고, ×로 지웁니다.

+

프로젝트 (다른 프로젝트에 추가)

+

작업 하나를 여러 프로젝트의 보드에 동시에 보이게 합니다. 예) 신상품 프로젝트의 작업을 디자인 프로젝트 보드에도 올리기.

+
    +
  1. “프로젝트” 칸에서 프로젝트를 고릅니다.
  2. +
  3. 그 프로젝트에서 들어갈 섹션을 고릅니다.
  4. +
  5. 다른 프로젝트에 추가를 누릅니다. 빼려면 이름 옆 ×(연결 해제).
  6. +
+

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

+

댓글

+

맨 아래 댓글 칸에 쓰고 Enter. 내가 쓴 댓글은 ✎로 고치고 ×로 지웁니다. 댓글 속 웹 주소는 링크가 됩니다.

+
+ + +
+

9작업 창의 하위 작업

+

작업 편집 창 가운데 “하위 작업” 목록입니다. 한 줄에 하나씩, 아사나처럼 다룹니다.

+
    +
  • 추가 — 목록 아래 입력칸에 이름을 쓰고, 필요하면 담당자·마감일을 고른 뒤 추가 또는 Enter.
  • +
  • 순서 바꾸기 — 줄에 마우스를 올리면 왼쪽에 ⠿ 손잡이가 나옵니다. 잡고 위아래로 끌어 놓습니다.
  • +
  • 완료 — ✓를 누릅니다. 완료한 줄은 취소선이 그어집니다.
  • +
  • 이름 고치기 — 이름 글자를 눌러 바로 고칩니다(칸은 이름 길이만큼만 차지합니다).
  • +
  • 마감일·담당자 — 날짜 글자나 사람 아이콘을 누릅니다. 비어 있으면 줄에 마우스를 올렸을 때 점선 아이콘이 나옵니다.
  • +
  • 열기 — 줄의 빈 곳이나 오른쪽 ›를 누르면 그 하위 작업이 편집 창으로 열립니다.
  • +
  • 삭제 — 줄에서 우클릭 → 하위 작업 삭제.
  • +
+

하위 작업을 열었을 때

+

하위 작업도 작업과 똑같이 설명 · 담당자 · 마감일 · 협업자 · 첨부 파일 · 댓글을 모두 쓸 수 있습니다. 제목 위에 ↰ 상위 작업 이름이 보이고, 누르면 상위 작업으로 돌아갑니다. 하위 작업에는 섹션이 없어서 섹션 칸은 나오지 않습니다.

+
+ + +
+

10날짜 고르기

+

마감일을 고르는 곳은 어디서나 같은 날짜 창이 열립니다.

+
    +
  • 달력에서 고르기 — 날짜를 누릅니다. ‹ ›로 달을 넘깁니다.
  • +
  • 직접 입력 — 위 칸에 2026-09-30, 9/30, 9월 30일, 0930 처럼 쓰고 Enter.
  • +
  • 오늘 — 오늘 날짜로. 지우기 — 날짜를 비웁니다.
  • +
  • + 시작일 — 기간이 있는 일이면 시작일도 넣습니다(보드 카드·프로젝트 수정에서).
  • +
  • 창 바깥을 누르거나 Esc로 닫습니다.
  • +
+
info +
보드 카드와 하위 작업 줄에서는 날짜를 누르는 즉시 저장됩니다. 작업 편집 창의 마감일은 저장을 눌러야 반영됩니다.
+
+ + +
+

11목록 보기

+
    +
  • 이 프로젝트 범위에서는 섹션별로 묶여 보이고, 전체 프로젝트에서는 프로젝트·섹션이 칸으로 나오는 표가 됩니다.
  • +
  • 칸 제목(작업 · 담당자 · 섹션 · 우선순위 · 시작 · 마감)을 누르면 그 기준으로 정렬하고, 한 번 더 누르면 반대로 정렬합니다.
  • +
  • 칸 제목 사이 경계를 끌면 칸 너비가 바뀝니다.
  • +
  • 줄을 누르면 작업 편집 창, 우클릭하면 작업 메뉴, 💬를 누르면 댓글 대화창이 열립니다.
  • +
+
+ + +
+

12캘린더 보기

+
    +
  • 한 달 달력에 작업이 시작일~마감일 막대로 표시됩니다(시작일이 없으면 마감일 하루). 공휴일은 빨간색입니다.
  • +
  • ‹ ›로 지난달·다음 달로 갑니다.
  • +
  • 막대를 누르면 작업 편집 창이 열리고, 끌어서 다른 날에 놓으면 날짜가 옮겨집니다.
  • +
  • 하루에 작업이 많으면 +N이 나옵니다. 누르면 그날 작업 목록이 뜹니다.
  • +
  • 막대 우클릭 → 작업 메뉴(열기 · 작업 링크 복사 · 완료로 표시 · 삭제).
  • +
+
+ + +
+

13타임라인 보기

+
    +
  • 기간이 있는(시작일 또는 마감일이 있는) 작업이 가로 막대로 나옵니다. 이 프로젝트는 섹션별 줄, 전체 프로젝트는 프로젝트별 줄이며 프로젝트 전체 기간이 옅은 배경으로 깔립니다.
  • +
  • 막대 몸통을 끌면 기간 전체가 이동하고, 양 끝을 끌면 시작일이나 마감일만 바뀝니다.
  • +
  • Ctrl + 마우스 휠로 확대·축소, 그냥 끌면 좌우로 이동합니다. 오늘로 오늘 날짜로 돌아옵니다.
  • +
  • 막대 더블클릭 → 작업 편집 창, 우클릭 → 작업 메뉴. 마우스를 올리면 작업 정보가 보입니다.
  • +
+
+ + +
+

14대시보드

+
    +
  • 위쪽 숫자 카드 4개: 완료된 작업 합계 · 미완료 작업 합계 · 마감일이 지난 작업 합계 · 작업 합계
  • +
  • 미완료 작업 합계(섹션별) — 섹션마다 남은 일이 몇 개인지 막대로 보여줍니다. 막대에 마우스를 올리면 숫자가 나옵니다.
  • +
  • 작업 합계(완료 상태별) — 완료와 미완료 비율을 도넛 차트로 보여줍니다.
  • +
  • 예정된 작업 합계(담당자별) — 사람별로 일정이 잡힌 미완료 작업 수(상위 10명). 관리자에게만 보입니다.
  • +
  • 범위(이 프로젝트/전체 프로젝트)와 필터 바 설정을 그대로 따라 계산합니다.
  • +
+
+ + +
+

15내 작업

+

왼쪽 사이드바 내 작업(프로젝트 관리 첫 화면)은 모든 프로젝트에서 내가 담당자인 작업만 한 표로 보여줍니다.

+
    +
  • 위쪽 탭 진행 중 · 완료 · 전체로 고릅니다. 옆에 전체 개수와 지연(마감 지남) 개수가 나옵니다.
  • +
  • 찾기(제목·설명·프로젝트), 마감(마감 지남·오늘·이번 주·마감일 없음), 우선순위로 거를 수 있습니다.
  • +
  • 칸 제목을 누르면 정렬합니다.
  • +
  • 줄을 누르면 그 작업의 프로젝트 화면으로 가서 작업 편집 창이 바로 열립니다. 우클릭하면 작업 메뉴가 나옵니다.
  • +
  • 내가 담당자인 하위 작업은 상위 작업 이름 아래에 들여 쓴 줄로 나옵니다.
  • +
+
+ + +
+

16댓글과 @태그

+

댓글 대화창

+

카드·목록·캘린더·내 작업에 보이는 💬 N을 한 번 누르면 메신저처럼 생긴 댓글 대화창이 열립니다.

+
    +
  • 입력칸에 쓰고 전송 또는 Enter.
  • +
  • attach_file로 파일을 붙이거나, 캡처한 이미지를 Ctrl+V로 붙여 넣습니다. 이미지는 작은 그림으로 보입니다.
  • +
  • 웹 주소를 붙여 넣으면 링크가 되고, 누르면 새 탭에서 열립니다.
  • +
  • 아직 읽지 않은 새 댓글이 있으면 말풍선이 깜빡이고 숫자가 빨간색으로 바뀝니다.
  • +
+

@태그로 동료 부르기

+
    +
  1. 설명이나 댓글에서 @를 누릅니다.
  2. +
  3. 이름 몇 글자를 치면 목록이 좁혀집니다. 방향키와 Enter 또는 마우스로 고릅니다.
  4. +
  5. 저장(설명) 또는 전송(댓글)하면, 태그된 사람의 수신함 → 나를 태그한 작업에 이 작업이 올라가고 그 사람은 자동으로 협업자가 됩니다.
  6. +
+
+ + +
+

17수신함과 알림

+

수신함 화면

+
    +
  • 나를 태그한 작업 — 누가 나를 @태그했는지와 함께 보입니다. 태그 모두 확인으로 한 번에 확인 처리합니다.
  • +
  • 알림 — 작업 배정 · 작업 완료 · 새 댓글 · 마감 알림이 쌓입니다. 항목을 누르면 읽음이 되고, 이동을 누르면 그 작업으로 갑니다.
  • +
  • 알림 모두 읽음으로 한 번에 읽음 처리합니다. 읽지 않은 알림에서 우클릭 → 읽음으로 표시도 됩니다.
  • +
+

어떤 알림이 누구에게 가나요?

+ + + + + + +
알림받는 사람
작업 배정새로 담당자가 된 사람
작업 완료 · 새 댓글담당자와 협업자
마감 알림담당자(담당자가 없으면 협업자 전원). 영업일 아침 9시에 “내일 마감 · 오늘 마감 · 마감 지남”을 한 번씩 알려줍니다.
@태그태그된 사람(수신함의 “나를 태그한 작업”)
+

내가 한 행동은 나에게 알리지 않습니다. 회사 설정에 따라 작업 배정·완료는 관리자 메일로도 갑니다.

+
+ + + + + +
+

19휴지통 (관리자)

+
    +
  • 지운 작업은 바로 사라지지 않고 3개월 동안 휴지통에 보관됩니다. 하위 작업 · 댓글 · 협업자 · 첨부 파일도 함께 보관됩니다.
  • +
  • 관리자는 왼쪽 사이드바 휴지통에서 지운 작업 목록(프로젝트 · 삭제한 사람 · 삭제 시각)을 봅니다.
  • +
  • 복구를 누르면 원래 프로젝트 · 섹션 자리로 그대로 돌아옵니다. 복구된 줄의 복구됨 · 열기로 바로 열어 볼 수 있습니다.
  • +
  • 3개월이 지나면 영구 삭제됩니다.
  • +
+
info +
하위 작업만 따로 지웠는데 상위 작업도 지워진 상태라면, 상위 작업을 먼저 복구해야 합니다.
+
+ + +
+

20단축키와 자주 묻는 질문

+

단축키

+ + + + + + + +
키하는 일
/전체 검색창으로 이동(입력 중이 아닐 때)
Esc작업 편집 창 · 날짜 창 · 메뉴 닫기, 입력 취소
Enter하위 작업 추가, 섹션 이름 저장, 댓글 전송, 날짜 직접 입력 확정
Ctrl + 휠타임라인 확대·축소
마우스 오른쪽 버튼작업 · 하위 작업 · 섹션 · 프로젝트에서 바로가기 메뉴
+

자주 묻는 질문

+

Q. 프로젝트가 목록에 안 보여요.
그 프로젝트의 멤버가 아니면 보이지 않습니다. 관리자에게 멤버 배정을 부탁하세요.

+

Q. 삭제 버튼을 눌렀는데 “삭제는 만든 사람만 할 수 있습니다”라고 나와요.
작업·섹션·프로젝트는 만든 사람만 지울 수 있습니다. 만든 사람이나 최고 관리자에게 부탁하세요.

+

Q. 작업을 잘못 지웠어요.
3개월 안이라면 관리자가 휴지통에서 복구할 수 있습니다.

+

Q. 카드 순서를 끌어도 안 바뀌어요.
필터를 쓰고 있거나 정렬이 “기본”이 아니면 순서를 바꿀 수 없습니다. 필터 바의 초기화를 누른 뒤 다시 해 보세요.

+

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

+

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

+

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

+
+
+
+ +arrow_upward + + +{% endblock %} diff --git a/app/modules/project/templates/project/inbox.html b/app/modules/project/templates/project/inbox.html index d7b71a7..b3bafd9 100644 --- a/app/modules/project/templates/project/inbox.html +++ b/app/modules/project/templates/project/inbox.html @@ -1,10 +1,12 @@ {% extends "erp_base.html" %} {% block head_extra %} - + {% endblock %} +{% block topbar_after_logout %}{% include "project/_help_btn.html" %}{% endblock %} + {% block content %} {# 내 업무/프로젝트 화면과 같은 2단 레이아웃 — 좌측은 공용 사이드바, 내용은 오른쪽 프레임 안에서만 스크롤한다. #} @@ -99,5 +101,5 @@ {% include "project/_side_modals.html" %} {% include "project/_member_tasks_modal.html" %} - + {% endblock %} diff --git a/app/modules/project/templates/project/mytasks.html b/app/modules/project/templates/project/mytasks.html index a5b3f37..50433e5 100644 --- a/app/modules/project/templates/project/mytasks.html +++ b/app/modules/project/templates/project/mytasks.html @@ -1,7 +1,7 @@ {% extends "erp_base.html" %} {% block head_extra %} - + {% endblock %} @@ -12,6 +12,8 @@ {% endblock %} +{% block topbar_after_logout %}{% include "project/_help_btn.html" %}{% endblock %} + {% block content %} {# 프로젝트 모듈의 첫 화면 = 내 업무. 예전 프로젝트 홈(카드 그리드)은 없앴다. #}
- + {% endblock %} diff --git a/app/modules/project/templates/project/project.html b/app/modules/project/templates/project/project.html index e1c9ce4..62909d0 100644 --- a/app/modules/project/templates/project/project.html +++ b/app/modules/project/templates/project/project.html @@ -1,7 +1,7 @@ {% extends "erp_base.html" %} {% block head_extra %} - + @@ -18,6 +18,8 @@ {% endif %} {% endblock %} +{% block topbar_after_logout %}{% include "project/_help_btn.html" %}{% endblock %} + {% block content %}
- + {% endblock %} diff --git a/app/modules/project/templates/project/trash.html b/app/modules/project/templates/project/trash.html index ad69ee6..f34212b 100644 --- a/app/modules/project/templates/project/trash.html +++ b/app/modules/project/templates/project/trash.html @@ -1,10 +1,12 @@ {% extends "erp_base.html" %} {% block head_extra %} - + {% endblock %} +{% block topbar_after_logout %}{% include "project/_help_btn.html" %}{% endblock %} + {% block content %} {# 휴지통 — 관리자 전용. 지운 업무(하위 업무·댓글·팔로워·첨부 포함)를 3개월 보관하고, [복구] 로 원래 id 그대로 되살린다(project_db 010). #} @@ -68,5 +70,5 @@ {% include "project/_side_modals.html" %} {% include "project/_member_tasks_modal.html" %} - + {% endblock %} diff --git a/app/static/project-help.css b/app/static/project-help.css new file mode 100644 index 0000000..659c19a --- /dev/null +++ b/app/static/project-help.css @@ -0,0 +1,116 @@ +/* ── 프로젝트 관리 도움말(/project/help, project/help.html) ── + 왼쪽 목차(스크롤을 따라 현재 위치 강조) + 오른쪽 본문 카드. 처음 쓰는 사람이 + 읽기 쉽게 — 단계는 번호 동그라미, 화면의 버튼·메뉴 이름은 .pjh-ui 칩으로 표시. */ +.pjh { + --pjh-ink: #1e1f21; --pjh-soft: #6d6e6f; --pjh-line: #e8eaee; + --pjh-accent: var(--pj-accent, #7b68ee); --pjh-tint: var(--pj-accent-tint, #f1eeff); + display: grid; grid-template-columns: 230px minmax(0, 1fr); gap: 28px; + max-width: 1180px; margin: 0 auto; padding: 4px 0 60px; color: var(--pjh-ink); + font-size: 14.5px; line-height: 1.7; +} +@media (max-width: 1000px) { + .pjh { grid-template-columns: minmax(0, 1fr); } + .pjh-toc { display: none; } +} + +/* 목차 */ +.pjh-toc { position: sticky; top: 12px; align-self: start; max-height: calc(100vh - 110px); overflow-y: auto; } +.pjh-toc-title { font-size: 12px; font-weight: 800; color: var(--pjh-soft); letter-spacing: .04em; margin: 0 0 8px 10px; } +.pjh-toc ol { list-style: none; margin: 0; padding: 0; counter-reset: toc; } +.pjh-toc li { counter-increment: toc; } +.pjh-toc a { + display: flex; gap: 8px; padding: 5px 10px; border-radius: 8px; color: #3d4046; + text-decoration: none; font-size: 13.5px; line-height: 1.45; +} +.pjh-toc a::before { content: counter(toc) "."; color: #9aa1a9; min-width: 18px; } +.pjh-toc a:hover { background: #f1f2f4; } +.pjh-toc a.is-active { background: var(--pjh-tint); color: var(--pjh-accent); font-weight: 700; } + +/* 머리말 */ +.pjh-hero { + background: linear-gradient(135deg, #f4f1ff 0%, #eef5ff 100%); border: 1px solid #e4defd; + border-radius: 16px; padding: 26px 30px; margin-bottom: 18px; +} +.pjh-hero h1 { margin: 0 0 6px; font-size: 24px; font-weight: 800; } +.pjh-hero p { margin: 0; color: #3d4046; } +.pjh-quick { display: grid; grid-template-columns: repeat(auto-fit, minmax(160px, 1fr)); gap: 10px; margin-top: 18px; } +.pjh-quick-step { background: #fff; border: 1px solid #e4defd; border-radius: 12px; padding: 12px 14px; font-size: 13.5px; line-height: 1.5; } +.pjh-quick-step b { display: block; color: var(--pjh-accent); font-size: 12px; margin-bottom: 2px; } + +/* 본문 카드 */ +.pjh-sec { + background: #fff; border: 1px solid var(--pjh-line); border-radius: 14px; + padding: 24px 30px; margin-bottom: 18px; scroll-margin-top: 16px; +} +.pjh-sec h2 { display: flex; align-items: center; gap: 10px; margin: 0 0 12px; font-size: 20px; font-weight: 800; } +.pjh-sec h2 .pjh-num { + display: inline-flex; align-items: center; justify-content: center; width: 30px; height: 30px; + border-radius: 9px; background: var(--pjh-tint); color: var(--pjh-accent); font-size: 15px; flex: none; +} +.pjh-sec h3 { margin: 22px 0 6px; font-size: 16px; font-weight: 800; } +.pjh-sec h3:first-of-type { margin-top: 8px; } +.pjh-sec p { margin: 6px 0; } +.pjh-sec ul { margin: 6px 0; padding-left: 20px; } +.pjh-sec li { margin: 3px 0; } +.pjh-lead { color: #3d4046; } + +/* 단계(번호 동그라미) */ +.pjh-steps { list-style: none; margin: 8px 0; padding: 0; counter-reset: step; } +.pjh-steps li { counter-increment: step; position: relative; padding: 2px 0 6px 36px; margin: 0; } +.pjh-steps li::before { + content: counter(step); position: absolute; left: 0; top: 3px; width: 24px; height: 24px; + border-radius: 50%; background: var(--pjh-accent); color: #fff; font-size: 12.5px; font-weight: 800; + display: flex; align-items: center; justify-content: center; +} + +/* 화면 요소 이름(버튼·메뉴) 칩, 키보드 키 */ +.pjh-ui { + display: inline-flex; align-items: center; gap: 3px; padding: 0 7px; border-radius: 6px; + background: #f1f2f4; border: 1px solid #e2e4e8; font-size: 13px; font-weight: 700; line-height: 22px; + white-space: nowrap; vertical-align: 1px; +} +.pjh-ui .material-symbols-outlined { font-size: 16px; } +.pjh kbd { + display: inline-block; min-width: 20px; padding: 0 6px; border-radius: 5px; text-align: center; + background: #fff; border: 1px solid #cfd3d9; box-shadow: 0 1px 0 #cfd3d9; + font: 700 12px/20px inherit; font-family: inherit; vertical-align: 1px; +} +.pjh-ic { font-size: 18px; vertical-align: -4px; color: var(--pjh-soft); } + +/* 팁·주의 */ +.pjh-tip, .pjh-note, .pjh-warn { + display: flex; gap: 10px; border-radius: 10px; padding: 10px 14px; margin: 10px 0; font-size: 13.5px; line-height: 1.6; +} +.pjh-tip { background: #f2faf5; border: 1px solid #cfe9da; } +.pjh-note { background: #f3f6ff; border: 1px solid #d6e0fb; } +.pjh-warn { background: #fff6f3; border: 1px solid #f6d6cc; } +.pjh-tip > .material-symbols-outlined { color: #3f8f6b; } +.pjh-note > .material-symbols-outlined { color: #4573d2; } +.pjh-warn > .material-symbols-outlined { color: #c24e2b; } +.pjh-tip > .material-symbols-outlined, .pjh-note > .material-symbols-outlined, +.pjh-warn > .material-symbols-outlined { font-size: 20px; flex: none; margin-top: 1px; } + +/* 표 */ +.pjh-table { width: 100%; border-collapse: collapse; margin: 8px 0; font-size: 13.5px; line-height: 1.55; } +.pjh-table th, .pjh-table td { border-bottom: 1px solid var(--pjh-line); padding: 8px 10px; text-align: left; vertical-align: top; } +.pjh-table th { background: #f7f8fa; font-weight: 800; color: #3d4046; white-space: nowrap; } +.pjh-table td:first-child { font-weight: 700; white-space: nowrap; } + +/* 화면 구성 그림(아주 단순한 모형) */ +.pjh-map { + display: grid; grid-template-columns: 170px 1fr; grid-template-rows: 44px 190px; gap: 8px; + margin: 12px 0; font-size: 12.5px; line-height: 1.45; +} +.pjh-map > div { border-radius: 10px; padding: 8px 12px; border: 1.5px dashed #c9c2f5; background: #faf9ff; } +.pjh-map b { display: block; color: var(--pjh-accent); } +.pjh-map-top { grid-column: 1 / -1; display: flex; align-items: center; justify-content: space-between; } +.pjh-map-side { grid-row: 2; } +.pjh-map-main { grid-row: 2; } + +/* 맨 위로 */ +.pjh-top { + position: fixed; right: 26px; bottom: 26px; width: 42px; height: 42px; border-radius: 50%; + display: inline-flex; align-items: center; justify-content: center; text-decoration: none; + background: var(--pjh-accent); color: #fff; box-shadow: 0 6px 18px rgba(123, 104, 238, .35); +} +.pjh-top:hover { filter: brightness(1.08); } diff --git a/app/static/project.css b/app/static/project.css index 7b1efc8..eb1b81f 100644 --- a/app/static/project.css +++ b/app/static/project.css @@ -1581,3 +1581,12 @@ img.pj-person-ic { width: 22px; height: 22px; } .pj-trash-act { text-align: right; } .pj-trash-table tr.is-restored td { opacity: .55; } .pj-trash-table tr.is-restored td.pj-trash-act { opacity: 1; } + +/* ── 상단 바 로그아웃 오른쪽 "?" 도움말(project/_help_btn.html → /project/help, 새 탭) ── */ +.pj-help-btn { + display: inline-flex; align-items: center; justify-content: center; flex: 0 0 auto; + width: 36px; height: 36px; border-radius: 50%; border: 1px solid #d8dce2; background: #fff; + color: #525860; text-decoration: none; transition: background .12s, color .12s, border-color .12s; +} +.pj-help-btn .material-symbols-outlined { font-size: 22px; } +.pj-help-btn:hover { background: var(--pj-accent-tint); border-color: var(--pj-accent); color: var(--pj-accent); } diff --git a/app/templates/erp_base.html b/app/templates/erp_base.html index 1470b7f..7937ef8 100644 --- a/app/templates/erp_base.html +++ b/app/templates/erp_base.html @@ -143,6 +143,8 @@
로그아웃 + {# 로그아웃 오른쪽 — 모듈별 도움말 버튼 등(예: 프로젝트 관리의 ? 아이콘) #} + {% block topbar_after_logout %}{% endblock %} diff --git a/docs/PROJECT_MODULE.md b/docs/PROJECT_MODULE.md index e8b6662..a9091b1 100644 --- a/docs/PROJECT_MODULE.md +++ b/docs/PROJECT_MODULE.md @@ -9,6 +9,9 @@ 목록(보기 탭, 예전 "리스트") · 캘린더(예전 "달력") · 수신함 · 첨부 파일 · 작업 링크 복사 · 프로젝트 칸 + "다른 프로젝트에 추가"(예전 "연결된 프로젝트") · 담당자 없음(예전 "(미지정)"). "@태그"는 그대로 쓴다. 코드 식별자·DB 컬럼(`tasks`, `stage_id`, `task_followers` 등)과 코드 주석은 예전 이름 그대로다. +**도움말** — `/project/help`(`project/help.html` + `static/project-help.css`), 프로젝트 관리 화면 상단 바 로그아웃 +오른쪽 **?** 아이콘(`_help_btn.html`, `erp_base.html` 의 `topbar_after_logout` 블록)으로 새 탭에서 연다. 처음 쓰는 사람용 +기능 설명 20장 — **화면 기능을 바꾸면 도움말도 같이 고친다.** **멤버 이름 표기** — 이메일 아이디의 첫 글자만 대문자(king → King). JS 는 `idOf(email)`/`capName(s)`, 템플릿은 `{{ nm[:1]|upper }}{{ nm[1:] }}` 로 화면에 그릴 때만 바꾼다(API `id`·DB 값은 그대로 — 멘션·검색은 이메일 기준). **프로젝트 색상·아이콘(아사나식)** — 색상표는 아사나 프로젝트 16색(`store.COLOR_PALETTE`, 8칸×2줄, 새 프로젝트