Cloudwiki/기능/문서 주시

# 개요

문서 주시(watch) 기능은 관심 있는 문서·하위 문서·카테고리의 편집 사항을 알림과 푸시로 받아볼 수 있는 구독 기능입니다. 로그인 후 사용할 수 있습니다.

# 주시 종류

Cloudwiki 의 주시 기능은 세 가지 형태로 제공됩니다.

|| 종류 || 구독 범위 ||
|| 이 문서만 || 지정한 문서가 편집될 때만 알림 ||
|| 하위 문서까지 || 지정한 문서 + `해당문서/...` 형태의 모든 하위 문서 편집 시 알림 ||
|| 카테고리 || 해당 카테고리에 속한 모든 문서의 편집 시 알림 ||

# 문서 주시 사용법

## 주시 설정

문서 페이지 상단의 `문서 도구` 드롭다운에서 `주시하기` 항목을 클릭하면 주시 옵션 모달이 열립니다.

* `이 문서만 주시` — 현재 문서가 편집될 때만 알림을 받습니다.
* `하위 문서까지 주시` — 현재 문서와 `현재문서/...` 형태의 모든 하위 문서 편집 시 알림을 받습니다.

원하는 옵션을 선택한 뒤 `주시 시작` 을 누르면 구독이 시작됩니다.

## 주시 변경 / 해제

이미 주시 중인 문서에서 다시 `주시하기` 항목을 클릭하면 같은 모달이 열리며, 다음 두 가지 동작을 할 수 있습니다.

* `변경 저장` — 다른 scope 로 갱신 (예: `이 문서만` → `하위 문서까지`)
* `주시 해제` — 구독 해제

# 카테고리 주시 사용법

카테고리 단위로 구독하면 그 카테고리에 속한 모든 문서의 편집 알림을 받을 수 있습니다.

* `카테고리:카테고리이름` 형태의 카테고리 문서가 존재하는 경우 — 문서 페이지의 `문서 도구` 드롭다운에 `카테고리 주시` 항목이 추가로 나타납니다.
* 카테고리 문서가 아직 작성되지 않은 경우 — `카테고리:카테고리이름` URL 의 카테고리 목록 페이지 상단에 `카테고리 주시` 버튼이 노출됩니다.

버튼을 다시 클릭하면 카테고리 주시가 해제됩니다.

# 알림

주시 중인 문서가 편집되면 다음 두 경로로 알림이 전송됩니다.

* '''사이트 내 알림''' — 헤더 종 아이콘에 표시되는 알림 패널
* '''웹 푸시''' — 푸시 알림을 허용한 경우 브라우저 푸시로도 전달

알림 본문에는 편집자 이름, 문서 슬러그, 편집 요약(앞 15자) 이 포함되며, 클릭 시 해당 리비전의 diff 페이지로 이동합니다.

# 권한 및 비공개 문서

* 주시 / 카테고리 주시 등록은 로그인한 모든 사용자가 사용할 수 있습니다.
* 비공개 문서(`is_private = 1`) 의 편집 알림은 `wiki:private` 권한을 가진 구독자에게만 발송됩니다. 권한이 없는 유저가 카테고리·상위 문서를 추측해 비공개 문서의 슬러그나 요약을 노출 받는 일은 발생하지 않습니다.

# 동작 메커니즘

문서가 편집되면 다음 세 가지 경로의 구독자가 합쳐져(중복 제거) 알림 대상이 됩니다.

# 편집된 문서 자체의 직접 주시자 (`page_watches`)
# 편집된 문서가 하위 문서인 경우, 모든 상위 슬러그를 `하위 문서까지` 로 주시하는 유저
 * 예: `A/B/C` 가 편집되면 `A`, `A/B` 를 subtree 로 주시하는 유저가 대상에 포함됩니다.
# 편집된 문서가 속한 카테고리를 주시하는 유저 (`category_watches`)

편집자 본인은 항상 알림 대상에서 제외됩니다.

# 관련 문서

* [[Cloudwiki/기능/토론]]
* [[Cloudwiki/기능/검색]]