PS.BOT-G-02 MiniCITY Wiki 구현 이력

PS.BOT-G-02 MiniCITY Wiki 구현 이력

Phase 1: 분석 & 설계 (2026-04-24)

1-1. aiee.app 분석

• Quartz v4 기반 지식정원 구조 분석
• 심볼릭 링크 publish 워크플로우 (옵시디언 8.quartz/ → Quartz content/)
• PM2 백그라운드 실행 방식
• 태그 체계: domain/topic/format/audience/intent/lang
• Mermaid 플로우차트, 한국어 로컬라이제이션 확인

1-2. PARA 방법론 연구

• Tiago Forte의 PARA: Projects → Areas → Resources → Archive
• 기존 v0.2 구조와 PARA 매핑 분석
• Gaps: Projects/Areas 경계 불명확, Areas 번호로 명명, Resources 분산

1-3. 기존 볼트 구조 (v0.2)

00.INBOX / 01.SYSTEM / 02.INFRA / 03.AGENTS /
04.SOFTWARE / 05.PROJECTS / 06.QnA / 07.ARCHIVE /
98.history / 99.TEMPLATES

Phase 2: PARA 이관 (2026-04-24)

2-1. v0.3 볼트 생성

• 경로: MiniCITY(v0.3_PARA_0424-)
• PARA 폴더 구조:
  • 00.INBOX — 분류 전 임시
  • 01.PROJECTS — 활성 프로젝트 (A~F)
  • 02.AREAS — 지속 관리 (인프라, 에이전트)
  • 03.RESOURCES — 참고 자료 (시스템규칙, 소프트웨어, QnA)
  • 04.ARCHIVE — 비활성 보관 (버전별, 완료프로젝트, 교훈로그, memory.openclaw)

2-2. v0.2 → v0.3 매핑

v0.2	v0.3 PARA	분류 근거
01.SYSTEM	03.RESOURCES/시스템규칙	참고 자료
02.INFRA	02.AREAS/인프라	지속 관리 영역
03.AGENTS	02.AREAS/에이전트	지속 관리 영역
04.SOFTWARE	03.RESOURCES/소프트웨어	참고 자료
05.PROJECTS	01.PROJECTS	활성 프로젝트
06.QnA	03.RESOURCES/QnA	참고 자료
07.ARCHIVE	04.ARCHIVE	비활성 보관

2-3. v0.2 원본 이동

• MiniCITY(v0.2_진행중_0419-) 전체를 04.ARCHIVE/버전별/v0.2-백업/으로 이동
• 볼트 루트에 v0.3만 남김

2-4. 추가 생성 파일

• 각 PARA 폴더별 index.md (폴더 페이지)
• MiniCITY.md (최상위 홈)
• 99.TEMPLATES/노트_템플릿.md, 프로젝트_템플릿.md

Phase 3: Quartz4 구현 (2026-04-24)

3-1. 설치

• 맥미니 M4 Pro에 Quartz4 클론 + npm install
• 경로: /Users/pinksky/quartz/

3-2. 설정 (quartz.config.ts)

• pageTitle: “MiniCITY 지식정원”
• locale: “ko-KR”
• baseUrl: “minicity.kr” (→ 후에 wiki.pinksky.kr로 논의 변경)
• ignorePatterns: 98.history, 04.ARCHIVE, 00.INBOX 제외

3-3. 동기화

• NAS 8.quartz/ 심볼릭 링크 구조:
  • PROJECTS → ../01.PROJECTS
  • AREAS → ../02.AREAS
  • RESOURCES → ../03.RESOURCES
• 실제 동기화: NAS tar → SSH 전송 → 맥미니 content/ 압축 해제
• (rsync 불가: NAS SSH가 서브시스템 요청 거부 이슈)

3-4. 폴더명 호환화

• Quartz가 ., (, ) 등 특수문자 처리 불가
• 01.PROJECTS → 01_PROJECTS (. → _ 변경)
• A.mini-happy → A_mini-happy
• v1.0_구상 → v1_0_구상
• 이 변경은 Quartz content에만 적용, NAS 원본은 그대로

3-5. 인덱스 통일

• 색인.md → index.md 로 이름 변경 (복사 아닌 이동)
• Quartz는 폴더 접속 시 index.md를 찾음
• NAS 원본에도 동일 적용

3-6. 서비스 실행

• PM2: minicity-quartz 프로세스 (port 8080)
• Caddy: wiki.pinksky.kr:8443 → 127.0.0.1:8080
• 모든 서비스 pinksky.kr 서브도메인 통일:
  • openclaw.pinksky.kr → OpenClaw
  • wiki.pinksky.kr → MiniCITY Wiki
  • dify.pinksky.kr → Dify

3-7. 빌드 결과

• 82개 Markdown 파일 파싱 → 253개 HTML 파일 생성
• 모든 주요 페이지 200 OK 확인 (HOME, PROJECTS, AREAS, RESOURCES)

🏷️ 태그 체계

aiee.app 스타일 프론트매터 태그:

카테고리	값 예시	용도
domain/	인프라, 에이전트, 프로젝트, 일반	영역 분류
topic/	네트워크, 하드웨어, 보안, OpenClaw, ERP, AI	주제
format/	가이드, 인덱스, 로그, 설정, 개요	문서 형식
audience/	전문가, 초보자, 일반	대상 독자
intent/	참고, 실행, 탐색, 내비게이션	의도
lang/	ko, en	언어

⚠️ 알려진 이슈

1. 자동 동기화 미구현 — NAS 수정 → 맥미니 content/ 반영이 수동 (tar + 전송)
2. 민감정보 노출 가능 — 02.AREAS/에이전트/OpenClaw-미미/민감정보-마스터.md 포함됨
3. DNS — wiki.pinksky.kr 접속 시 첫 인증서 발급 필요
4. git 날짜 — content가 git 추적 안 되어 날짜 정보 부정확 (경고 출력)

[!note] 수정이력 | 2026-04-24 22:40, 미미 (openclaw 2026.4.22)