위키 초기 설계 및 동기화 방안

[!note] 수정이력 | 2026-05-03 00:44, 루키 (hermes)

1. 설계 목적

v0.1 구상(2026-04-24)에서 정의된 MiniCITY 지식정원을 실제 기술 환경에서 구동하기 위한 초기 설계.

2. 시스템 인프라 구성

2.1 맥미니 (M4 Pro) 호스팅 환경

항목	설정값	비고
SSG	Quartz4 (jackyzha0)	정적 사이트 생성기
실행 관리자	PM2 (`minicity-quartz`)	백그라운드 프로세스
로컬 포트	8080	내부 서비스 포트
리버스프록시	Caddy + Tailscale serve	`wiki.pinksky.kr` 서빙
동기화 대상	`/Users/pinksky/quartz/content/`	NAS 볼트 → 맥미니

2.2 동기화 파이프라인 설계

[NAS 옵시디언 볼트]
      |
      | tar 묶기 (rsync 불가 환경)
      ↓
[맥미니 content/]
      |
      | npx quartz build
      ↓
[public/]
      |
      | Caddy + Tailserve
      ↓
[wiki.pinksky.kr]

동기화 트리거: 수동 실행 또는 cron 스케줄
재시작: pm2 restart minicity-quartz

3. 폴더/파일 호환화 규칙

원본 옵시디언 볼트와 Quartz4 간 변환 표준.

원본 규칙	Quartz 변환	적용 대상
`.`	`_`	폴더명 (예: `01.PROJECTS` → `01_PROJECTS`)
`색인.md`	`index.md`	폴더 인덱스 파일
`YYYY-MM-DD`	`YYYYMMDD_HHMM`	파일명 날짜 형식 (진행중)

4. 공개(발행) 제외 규칙

대상	패턴	사유
수집함	`00.INBOX` / `00_INBOX`	정리되지 않은 임시 자료
아카이브	`04.ARCHIVE` / `04_ARCHIVE`	과거 프로젝트 폐기물
히스토리	`98.HISTORY`	버전별 백업 이력

5. 위키 접근 정보

배포 URL: https://wiki.pinksky.kr
관리 노드: 맥미니 M4 Pro (루키)
PM2 프로세스명: minicity-quartz