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) 방식으로 팀의 일을 정리하는 도구입니다. + 프로젝트 안에 할 일(작업)을 만들고, 담당자와 마감일을 정하고, 댓글로 이야기하며 끝까지 챙깁니다. + 처음이라면 아래 다섯 단계만 따라 해도 바로 쓸 수 있어요.
+화면에 나오는 말은 아사나 한국어판과 같은 용어를 씁니다.
+| 용어 | 뜻 |
|---|---|
| 프로젝트 | 함께 진행하는 일의 큰 묶음입니다. 예) “마케팅”, “신상품 출시”. 색상과 아이콘으로 구분합니다. |
| 섹션 | 프로젝트 안의 단계나 분류입니다. 보드에서 세로 칸 하나가 섹션입니다. 예) “할 일 · 진행 중 · 검토 · 완료”. |
| 작업 | 실제 할 일 하나입니다. 보드의 카드 한 장이 작업 하나입니다. |
| 하위 작업 | 작업을 더 잘게 나눈 할 일입니다. 작업 안에 목록으로 붙습니다. 원래 작업은 상위 작업이라고 부릅니다. |
| 담당자 | 그 작업을 책임지고 하는 사람 한 명입니다. |
| 협업자 | 작업의 진행 소식(완료·댓글)을 함께 받는 사람들입니다. 만든 사람·담당자·댓글 쓴 사람·@태그된 사람은 자동으로 들어갑니다. |
| 마감일 / 시작일 | 언제까지 끝낼지(마감일), 언제 시작하는지(시작일, 선택)입니다. |
| 우선순위 | 높음 · 보통 · 낮음. 급한 일을 표시합니다. |
| @태그 | 설명이나 댓글에서 @를 누르고 사람을 고르면, 그 사람의 수신함에 작업이 쌓입니다. |
| 수신함 | 나를 태그한 작업과 나에게 온 알림을 모아 보는 곳입니다. |
| 내 작업 | 모든 프로젝트에서 내가 담당자인 작업만 모아 보는 곳입니다. |
프로젝트 관리 메뉴는 관리자 페이지에서 “프로젝트 관리” 권한을 받은 직원에게 보입니다.
+| 할 수 있는 일 | 누가 |
|---|---|
| 프로젝트 보기 | 그 프로젝트의 멤버(또는 관리자). 멤버가 아니면 주소를 알아도 열리지 않습니다. |
| 작업·하위 작업·댓글 | 그 프로젝트 멤버 누구나 만들고 고칠 수 있습니다. |
| 작업·섹션·프로젝트 삭제 | 만든 사람만 지울 수 있습니다(최고 관리자는 예외). |
| 댓글 고치기·지우기 | 댓글을 쓴 사람(또는 관리자)만. |
| 새 프로젝트, 프로젝트 수정·순서 바꾸기 | 관리자 (+ · ✎ · ⣿ 버튼이 관리자에게만 보입니다) |
| 멤버 배정·제외 | 관리자 |
| 휴지통 보기·복구, 전체 멤버, 대시보드의 담당자별 차트 | 관리자 |
사이드바의 프로젝트 이름에 마우스를 올리면 오른쪽에 ✎(수정)과 ×(삭제)가 나옵니다. + 이름에서 마우스 오른쪽 버튼을 눌러도 열기 · 수정 · 삭제 메뉴가 나옵니다.
+프로젝트 이름에 마우스를 올리면 왼쪽에 손잡이 ⣿가 나옵니다. 잡고 위아래로 끌어 놓으면 순서가 저장됩니다.
+× 또는 우클릭 삭제. 프로젝트를 만든 사람만 지울 수 있고, 안의 작업도 모두 함께 지워집니다.
+프로젝트 화면 제목 오른쪽에 멤버 사진이 겹쳐서 보입니다.
+프로젝트 화면 맨 위 왼쪽의 탭으로 같은 작업을 다른 모양으로 봅니다.
+| 탭 | 이럴 때 좋아요 |
|---|---|
| 보드 | 섹션(단계)별 카드로 흐름을 볼 때. 카드를 끌어 단계를 옮깁니다. (6장) |
| 목록 | 표처럼 한 줄씩 빠르게 훑고 정렬할 때. (11장) |
| 캘린더 | 한 달 달력에서 일정을 볼 때. (12장) |
| 타임라인 | 기간(시작~마감)을 막대로 보며 일정을 조정할 때. (13장) |
| 대시보드 | 완료·미완료·지연 숫자와 차트로 진행 상황을 볼 때. (14장) |
화면 오른쪽 위 토글입니다. 이 프로젝트는 지금 프로젝트만, 전체 프로젝트는 내가 볼 수 있는 모든 프로젝트의 작업을 함께 보여줍니다. + 전체 프로젝트일 때 카드 위에는 어느 프로젝트 작업인지 이름이 붙습니다.
+탭 아래 한 줄로 작업을 거르고 정렬합니다. 다섯 가지 보기 모두에 똑같이 적용되고, 프로젝트마다 이 브라우저에 기억됩니다.
+보드는 섹션(세로 칸)이 옆으로 늘어선 화면입니다. 섹션이 많으면 가로로 스크롤되고, 한 섹션에 카드가 많으면 그 섹션 안에서만 세로로 스크롤됩니다.
+| 표시 | 뜻 |
|---|---|
| 오늘 · 내일 | 곧 마감(초록) |
| 어제 · 09/20(일) | 마감이 지남(빨강). 완료한 작업도 지난 마감일은 빨강으로 남아 늦게 끝낸 것을 알 수 있습니다. |
| 09/30(수) | 그 밖의 날짜(기본 글자색) |
하위 작업이 있는 카드에는 3 ⤷ ▾ 처럼 개수 버튼이 붙습니다. 누르면 카드 아래로 하위 작업 목록이 펼쳐집니다.
+카드·목록 줄·캘린더 막대를 누르면 화면 오른쪽에 작업 편집 창이 열립니다. 창의 왼쪽 가장자리를 끌면 너비를 넓히거나 좁힐 수 있습니다.
+| 버튼 | 하는 일 |
|---|---|
| link공유 | 이 작업의 주소를 복사합니다. 메신저로 보내면 받은 멤버가 바로 이 작업을 엽니다. |
| ✓ 완료로 표시 | 작업을 완료합니다. 다시 누르면 ↩ 완료 취소. |
| 삭제 | 작업을 지웁니다(만든 사람만). 하위 작업이 있으면 함께 지울지 한 번 더 묻습니다. 지운 작업은 휴지통에 3개월 보관됩니다. |
| 취소 · 저장 | 제목·담당자·섹션·우선순위·마감일·설명은 저장을 눌러야 반영됩니다. 저장하지 않고 닫으려 하면 “저장하시겠습니까?”를 묻습니다. |
파일 추가로 파일을 올립니다(한 파일 최대 20MB). 파일 이름을 누르면 내려받고, ×로 지웁니다.
+작업 하나를 여러 프로젝트의 보드에 동시에 보이게 합니다. 예) 신상품 프로젝트의 작업을 디자인 프로젝트 보드에도 올리기.
+작업은 하나라서 어느 보드에서 고쳐도 모두 같이 바뀝니다.
+맨 아래 댓글 칸에 쓰고 Enter. 내가 쓴 댓글은 ✎로 고치고 ×로 지웁니다. 댓글 속 웹 주소는 링크가 됩니다.
+작업 편집 창 가운데 “하위 작업” 목록입니다. 한 줄에 하나씩, 아사나처럼 다룹니다.
+하위 작업도 작업과 똑같이 설명 · 담당자 · 마감일 · 협업자 · 첨부 파일 · 댓글을 모두 쓸 수 있습니다. 제목 위에 ↰ 상위 작업 이름이 보이고, 누르면 상위 작업으로 돌아갑니다. 하위 작업에는 섹션이 없어서 섹션 칸은 나오지 않습니다.
+마감일을 고르는 곳은 어디서나 같은 날짜 창이 열립니다.
+2026-09-30, 9/30, 9월 30일, 0930 처럼 쓰고 Enter.왼쪽 사이드바 내 작업(프로젝트 관리 첫 화면)은 모든 프로젝트에서 내가 담당자인 작업만 한 표로 보여줍니다.
+카드·목록·캘린더·내 작업에 보이는 💬 N을 한 번 누르면 메신저처럼 생긴 댓글 대화창이 열립니다.
+| 알림 | 받는 사람 |
|---|---|
| 작업 배정 | 새로 담당자가 된 사람 |
| 작업 완료 · 새 댓글 | 담당자와 협업자 |
| 마감 알림 | 담당자(담당자가 없으면 협업자 전원). 영업일 아침 9시에 “내일 마감 · 오늘 마감 · 마감 지남”을 한 번씩 알려줍니다. |
| @태그 | 태그된 사람(수신함의 “나를 태그한 작업”) |
내가 한 행동은 나에게 알리지 않습니다. 회사 설정에 따라 작업 배정·완료는 관리자 메일로도 갑니다.
+| 키 | 하는 일 |
|---|---|
| / | 전체 검색창으로 이동(입력 중이 아닐 때) |
| Esc | 작업 편집 창 · 날짜 창 · 메뉴 닫기, 입력 취소 |
| Enter | 하위 작업 추가, 섹션 이름 저장, 댓글 전송, 날짜 직접 입력 확정 |
| Ctrl + 휠 | 타임라인 확대·축소 |
| 마우스 오른쪽 버튼 | 작업 · 하위 작업 · 섹션 · 프로젝트에서 바로가기 메뉴 |
Q. 프로젝트가 목록에 안 보여요.
그 프로젝트의 멤버가 아니면 보이지 않습니다. 관리자에게 멤버 배정을 부탁하세요.
Q. 삭제 버튼을 눌렀는데 “삭제는 만든 사람만 할 수 있습니다”라고 나와요.
작업·섹션·프로젝트는 만든 사람만 지울 수 있습니다. 만든 사람이나 최고 관리자에게 부탁하세요.
Q. 작업을 잘못 지웠어요.
3개월 안이라면 관리자가 휴지통에서 복구할 수 있습니다.
Q. 카드 순서를 끌어도 안 바뀌어요.
필터를 쓰고 있거나 정렬이 “기본”이 아니면 순서를 바꿀 수 없습니다. 필터 바의 초기화를 누른 뒤 다시 해 보세요.
Q. 다른 사람이 바꾼 내용이 안 보여요.
보통 8초 안에 자동으로 반영됩니다. 오래 걸리면 새로고침(F5)하세요.
Q. 하위 작업을 다른 프로젝트 작업으로 옮길 수 있나요?
하위 작업은 같은 프로젝트 안의 작업으로만 옮길 수 있습니다.
Q. 작업을 두 프로젝트에 같이 두고 싶어요.
작업 편집 창의 “프로젝트” 칸에서 다른 프로젝트에 추가를 쓰세요. (8장)