Claude 보고서/위키 엔진 비교

Cloudwiki 를 대표적 오픈소스 위키 엔진인 **MediaWiki**(위키백과 구동 엔진)와 **Wiki.js**(Node.js 기반 모던 위키)와 비교합니다. 상위 문서: [[Claude 보고서]].

## 아키텍처 비교

| 항목 | Cloudwiki | MediaWiki | Wiki.js |
| --- | --- | --- | --- |
| 런타임 |  Cloudflare Workers (엣지) | PHP (LAMP) | Node.js |
| 데이터 | D1(SQLite) · R2 · KV | MySQL/MariaDB · 파일시스템 | PostgreSQL(권장) · 다중 저장소 |
| 배포/운영 |  서버리스, 자동 배포, 무중단 | 서버 직접 운영 | 컨테이너/서버 운영 |
| 전세계 지연시간 |  엣지에서 낮음 | 단일 리전 + CDN | 단일 리전 + CDN |
| 확장성 | 자동 스케일 | 수동 스케일/캐시 튜닝 | 수평 확장 제한적 |

## Cloudwiki 가 우수한 점

성공: AI · MCP 네이티브 연동
**MCP(Model Context Protocol) 서버를 OAuth 2.1(PKCE·DCR) 위에 1급 기능으로 내장**합니다. 50여 개 읽기/편집 도구, draft→승인 워크플로우, `[MCP] [+N -M]` 편집 요약 자동 태깅까지 갖춰 AI 협업 편집을 표준 기능으로 제공합니다. MediaWiki·Wiki.js 모두 이런 내장 AI 편집 파이프라인이 없습니다.


-  **풍부한 확장 문법 내장**: 콜아웃·카드·탭·아코디언·스텝·그리드·진행도바·배지·스탯·버튼·키캡·타임스탬프·임베드를 코어에서 제공. MediaWiki 는 템플릿/확장으로, Wiki.js 는 별도 마크업으로 흉내내야 하는 것을 기본 제공.
-  **컬러 팔레트 테마링**: `{palette:이름}` 로 라이트/다크 자동 대응 + WCAG 대비 자동 판정. 본문 색상 디자인 시스템이 엔진에 통합.
-  **세분화된 편집 ACL**: `aged`(가입 경과일)·`page_editor`·`any_editor`·`admin_only` 플래그 AND 조합, 카테고리 ACL 템플릿, prefix 일괄 규칙. Wiki.js 의 그룹/규칙보다 문서 단위로 더 정밀.
-  **운영 부담 제로에 가까움**: 메인 브랜치 푸시 → Cloudflare 자동 배포. DB/캐시 서버 운영 불필요.
-  **알림 인프라 내장**: Web Push(VAPID), Discord 웹훅(admin/community 채널·이벤트 화이트리스트), Analytics Engine, 인앱 알림·쪽지.
-  **나무위키류 한국어 친화 문법**: `[[문서]]`, `{{틀}}`+파라미터, 각주 `[* ]`, 자동 헤딩 번호, `map:` 가상 그래프.
-  **R2 리비전 저장 + 소프트 삭제/복원**, 백링크 인덱스, 하위 문서 트리.

## 부족한 점 (경쟁 엔진이 더 나은 부분)


MediaWiki 가 앞서는 것
- **VisualEditor**: 코어 번들 WYSIWYG. Cloudwiki 는 CodeMirror 마크다운 에디터만 존재(시각 편집 부재).
- **Scribunto(Lua 모듈)**: 조건·반복·연산이 가능한 프로그래밍형 템플릿. Cloudwiki 의 틀은 파라미터 치환만 가능(로직 없음).
- **Semantic MediaWiki / Cargo**: 페이지에 구조화 데이터를 심고 쿼리해 표·타임라인·지도 생성. Cloudwiki 에 구조화 데이터·시맨틱 쿼리 부재.
- **거대 확장 생태계 + 성숙한 i18n**(300+ 언어), 봇/API 성숙도, 패트롤·AbuseFilter·반달 대응.
- 위키백과 규모에서 검증된 안정성.

Wiki.js 가 앞서는 것
- **Git 기반 저장소 동기화**: 콘텐츠를 GitHub 등과 양방향 동기화/백업. Cloudwiki 는 외부 Git 동기화·외부 저장소 백엔드(S3/Azure) 부재.
- **모듈형 인증**: LDAP/AD, SAML 2.0, 다수 OAuth, 로컬 계정. Cloudwiki 는 Google·Discord 두 OAuth 만 지원.
- **다중 에디터**: 마크다운 + 비주얼 + WYSIWYG.
- **다국어 페이지 변형**(페이지별 로케일), 검색 엔진 선택(Elasticsearch/Algolia/DB).
- 코드 인젝션 기반 테마 커스터마이즈.



주의: Cloudwiki 공통 갭 요약
WYSIWYG · 프로그래밍형 템플릿 · 구조화/시맨틱 데이터 · 다국어 · 다양한 인증(LDAP/SAML/로컬) · 외부 저장소/Git 동기화 · 서버사이드 이미지 변환 · 이메일 알림 · 강력한 검색 랭킹/패싯. 또한 Cloudflare 종속(벤더 락인)과 일부 기능의 유료 티어 의존이 있습니다.


## 종합 포지셔닝

결론
Cloudwiki 는 **"엣지 서버리스 + AI 네이티브 + 디자인이 통합된 모던 위키"** 라는 독자 포지션을 가집니다. MediaWiki 의 *프로그래밍/시맨틱 깊이* 와 Wiki.js 의 *통합 유연성(저장소·인증)* 에는 미치지 못하지만, 운영 단순성·AI 협업·문서 표현력에서는 두 엔진을 앞섭니다. 개선 우선순위는 [[Claude 보고서/기능 제안]] 과 [[Claude 보고서/개선점]] 을 참고하세요.