Cloudwiki/개선 계획

이 문서는 Cloudwiki의 향후 개선 방향을 7개 관점으로 나누어 조사·분석한 결과를 모은 **개선 계획 인덱스**다. 각 관점은 하위 문서로 분리되어 있으며, 본 문서는 전체 요약과 부문 교차 우선순위를 제공한다. (2026-06-06 작성 — 병렬 분석)

> 모든 하위 문서의 제안은 **분석 시점 기준 검토 의견**이며, 실제 구현 전에는 코드 현황을 다시 확인할 것. 일부 벤치마크 항목은 "추측"으로 표기되어 있다.

## 하위 분석 문서

| 관점 | 문서 | 한 줄 요약 |
|---|---|---|
| 벤치마크 | [[Cloudwiki/개선 계획/벤치마크]] | 경쟁 위키 9종 조사 → 공개 위키 코어(탐색성·재사용 구조물·문법 표현력) 우선 강화 |
| 에디터 & 문법 | [[Cloudwiki/개선 계획/에디터 및 위키 문법]] | `---` 의미 충돌·섹션 transclusion 부재, 슬래시 커맨드/포맷 단축키/라이브 린팅, 에디터 로드 속도 |
| 검색 & 탐색 | [[Cloudwiki/개선 계획/검색 및 탐색 UX]] | 정렬/네임스페이스/카테고리 필터, 전역 커맨드 팔레트(Cmd/K) |
| 확장 시스템 | [[Cloudwiki/개선 계획/확장 시스템]] | freq/stock 패턴 일반화 → 확장 SDK·매니페스트, chart/embed/tabs 내장 후보 |
| 디자인 | [[Cloudwiki/개선 계획/디자인 및 시각적 일관성]] | DESIGN.md 명세를 CSS 토큰으로 실체화, 본문 측정폭·컴포넌트 통합, 브랜딩 색/폰트 확대 |
| 코드 중복 | [[Cloudwiki/개선 계획/기능 일관성 및 코드 중복]] | 저장 4경로 후처리 매트릭스, 주시자 알림 누락, 추출 권장 헬퍼 |
| 아키텍처 | [[Cloudwiki/개선 계획/아키텍처 통합성]] | 저장 11진입점 단일 `commitPageMutation` 파이프라인 수렴, 타입/봉인으로 재발 방지 |

## 부문 교차 우선순위 (High)

여러 분석에서 공통으로 높은 우선순위로 꼽힌 항목들이다.

### 구조 건전성 (가장 시급)

* **단일 저장 파이프라인 도입** — 저장 경로가 11개로 분기하는데 공통 파이프라인이 없어 "한 경로에만 사이드이펙트가 빠지는" 버그(이번 MCP ACL 누락)가 반복된다. `commitPageMutation` 단일 함수로 수렴 + 타입 브랜딩/모듈 봉인으로 재발 차단. → 아키텍처 문서 참조.
* **주시자 알림 누락 수정** — 직접 PUT update를 제외한 모든 승인/revert/move 경로에서 문서 주시자에게 알림이 가지 않는다. 파이프라인 단계로 흡수하면 자동 해소.
* **revert 낙관적 락·backlink 캐시 누락**, **move HTTP/MCP 동작 불일치** — 단일 파이프라인 이행 시 함께 정리.

### 사용자 경험

* **전역 커맨드 팔레트(Cmd/Ctrl+K) + 검색 정렬·네임스페이스 필터** — 기존 `/api/search/suggest`·서버 분기를 재사용해 낮은 비용으로 탐색 동선을 크게 개선.
* **에디터 포맷 단축키(`Ctrl+B/I/K`) + 슬래시 커맨드 + 문맥 인지 블록 자동완성** — 초심자 진입 장벽을 낮추는 비용 대비 효과 큰 개선.
* **디자인 토큰 실체화 + 본문 측정폭(66ch)** — DESIGN.md가 이미 값을 정해뒀으므로 `:root` 변수화만으로 파편화·가독성 동시 해결.

### 제품 정체성 (공개 위키 코어 강화)

* **인포박스 / 카테고리 Live Template** + **백링크 패널 / 형식별 역링크** — 트랜스클루전·카테고리·백링크 데이터가 이미 있어 적합도 높음.
* **위키문법 표현력 확장**(접기/펼치기 등) 및 **확장 시스템 SDK화**(chart/embed/tabs 내장) — mermaid 지연 import·freq 로더 재사용 패턴 활용.

## 권고 실행 순서

1. **아키텍처 정비 먼저** — 단일 저장 파이프라인 1~2단계(승인 경로 수렴 + 주시자 알림/ACL 머지 흡수)로 버그 클래스 제거. 이후의 모든 기능 추가가 안전한 토대 위에서 진행되도록.
2. **저비용 UX 개선** — 검색 정렬/필터, 커맨드 팔레트, 에디터 단축키. 기존 인프라 재사용분이 커 빠른 ROI.
3. **디자인 토큰 실체화** — 이후 신규 UI(팔레트·확장·필터 등)가 통일된 토큰 위에서 만들어지도록 선행.
4. **정체성 기능 확장** — 확장 SDK, 인포박스/Live Template, 백링크 패널 등 공개 위키 코어 강화.