Docket

프로젝트 · 업무 · 작업을 상태 · 마감 · 간트/WBS/보드로 관리하는 옵시디언 PM 플러그인. 데일리·회의·일정 플러그인 Almanac과 frontmatter 규약으로 느슨하게 연계됩니다. (단독으로도 동작)

폴더 구성

docket/
├── main.js          ← 플러그인 본체
├── manifest.json    ← 플러그인 정보
├── styles.css       ← 디자인
├── templates/       ← 기본 템플릿 md 파일 3종 (project · task · subtask)
└── README.md

---

설치

방법 1 — BRAT 플러그인 사용 (권장)

1. 옵시디언 → 설정 → 커뮤니티 플러그인 → BRAT 검색 후 설치 및 활성화
2. BRAT 설정 → Add Beta plugin → 이 저장소의 GitHub URL 입력
3. BRAT가 main.js · manifest.json · styles.css를 자동으로 내려받아 설치
4. templates/ 안의 **project.md · task.md · subtask.md**를 볼트의 Templates/ 폴더에 복사
   • Templates/ 폴더가 없으면 볼트 루트에 직접 만들면 됩니다.
5. 옵시디언 → 설정 → 커뮤니티 플러그인 → Docket 활성화

방법 2 — 수동 설치

1. 이 저장소에서 main.js · manifest.json · styles.css · templates/ 폴더를 내려받습니다.
   • 폐쇄망/VDI: 파일을 미리 받아 두거나 USB 등으로 옮겨 온 뒤 2단계부터 진행합니다.
2. 볼트 안에 .obsidian/plugins/docket/ 폴더를 만듭니다.
   • .obsidian/ 폴더는 운영체제에서 숨김 처리되어 있을 수 있습니다. (Mac: Cmd+Shift+. 으로 토글)
3. main.js · manifest.json · styles.css 3개를 그 폴더에 복사합니다.
4. templates/ 안의 **project.md · task.md · subtask.md**를 볼트의 Templates/ 폴더에 복사합니다.
5. 옵시디언 → 설정 → 커뮤니티 플러그인 → 제한 모드 해제 → Docket 활성화

---

3계층 구조

Docket은 업무를 3단계로 나눠 관리합니다.

계층	frontmatter type	역할
프로젝트(project)	project	가장 큰 단위. 단계(phase)를 가짐
업무(task)	task	프로젝트에 속함 (project: [[..]]). 상태는 자식 작업에서 롤업
작업(subtask)	subtask	업무에 속함 (task: [[..]]). 실제 진행 단위

• 상태: 대기 · 진행중 · 완료 · 보류 · 취소
• 업무 상태는 직접 정하지 않고 자식 작업의 상태에서 자동 계산됩니다(롤업).

---

명령 · 리본

리본(왼쪽 아이콘 막대) 또는 커맨드 팔레트(Ctrl/Cmd+P → "Docket")에서 실행합니다.

• 새 프로젝트 / 새 업무 / 새 작업 — frontmatter·상위 링크 자동 기록. 현재 열어둔 상위 노트가 부모로 기본 선택됩니다.
• 상태 변경 (업무/작업 노트에서) — 대기/진행중/완료/보류/취소
• Docket 패널 열기 — 간트 · WBS · 보드 3종 뷰

새 작업 모달

• 출처 회의: 볼트의 type: meeting 노트를 최신순 드롭다운으로 선택 → from: [[회의]] 기록
• 요청자: 선택한 회의의 참석자(attendees)를 체크박스(4열)로 고르거나 추가 요청자를 자유 입력 → requested_by에 위키링크 배열로 기록(중복 제거)

---

세 가지 패널 뷰

리본 'Docket 패널' 또는 명령으로 엽니다. 전역/프로젝트 토글을 지원합니다.

간트

• 데일리 노트의 [[작업]] 백링크로 실제 진행 기간을 도출해 막대로 표시
• 기간이 길면 일 → 주 단위로 축이 자동 전환, 오늘 열 강조

WBS

• 프로젝트 → 업무 → 작업 들여쓰기 트리 + 상태 뱃지
• 노트 변경 시 자동 갱신

보드

• 상태별 칸반. 카드를 다른 칼럼으로 드래그하면 노트의 status가 바뀝니다.
• 카드 = 작업 + 자식 없는 업무
• 각 칼럼 안에서 프로젝트 → 업무로 2단 그룹핑되며 접을 수 있습니다(접힘은 칼럼별 독립).
• '전체 작업 접기' 토글, 드롭 도착 카드 강조 지원

---

데이터 규약 (Almanac 공유)

Docket과 Almanac은 같은 볼트·같은 frontmatter 규약을 가정하고, 규약으로만 결합합니다.

노트	주요 필드
project	type, phase (기본 단계 대기/진행/완료 — 설정에서 조직에 맞게 변경)
task	type, project: [[..]], status
subtask	type, task: [[업무]], status, from: [[회의]], requested_by: [[사람]](배열), due

• 사람·참석자는 태그가 아닌 위키링크로 다룹니다.
• 회의(from)·요청자(requested_by)·마감(due)은 작업(subtask) 단위 필드입니다.
• due는 작업 생성 시 입력받아 frontmatter에 데이터로만 보관하며, 뷰에는 표시하지 않습니다. 수정은 노트의 due: 값을 직접 편집합니다.
• 작업의 진행 기간은 데일리 노트의 [[작업]] 백링크에서 도출됩니다(간트).

---

설정

항목	설명
폴더	프로젝트 / 업무 / 작업 노트 폴더 경로
템플릿	템플릿 폴더 + 각 파일명 (없으면 내장 기본 템플릿 사용)
phase	프로젝트 단계 목록(조직에 맞게 변경)
간트 임계값	일/주 축 전환 기준

---

라이선스

MIT