guide-maker

Guide Maker

Place 프로젝트 기능에 대한 가시성 높은 사용자 가이드를 Notion에 생성.

사전 요구사항

• Notion MCP (MCP_DOCKER) 연결
• 부모 페이지 ID: 0656783731824d52aa4ac9523521bd14

워크플로우

1. 기능 분석

해당 기능의 코드(app/ 폴더) 분석 → 주요 버튼, 폼, 테이블, 상태값 파악

2. 콘텐츠 구조 설계

문서 구조에 맞춰 전체 블록 배열 설계 (페이지 위치, Part별 Step, 테이블, FAQ 등)

3. 한 번에 생성 (🚨 필수!)

반드시 code-mode 스크립트 한 번으로 전체 가이드 생성:

// 1. 페이지 생성
const result = JSON.parse(this['API-post-page']({
  parent: { page_id: "0656783731824d52aa4ac9523521bd14" },
  properties: { title: [{ text: { content: "📑 [기능명]" } }] }
}));
const pageId = result.id;

// 2. 모든 블록을 하나의 배열로 구성
const allBlocks = [
  // Part 1 헤더 + Step 1~N + divider
  // Part 2 헤더 + Step 1~N + divider
  // 테이블들
  // FAQ 토글들
];

// 3. 단 한 번의 API 호출로 콘텐츠 추가
this['API-patch-block-children']({ block_id: pageId, children: allBlocks });

return `https://www.notion.so/${pageId.replace(/-/g, '')}`;

❌ 금지: Step별/Part별로 나눠서 여러 번 API 호출 ✅ 필수: 전체 블록을 하나의 배열로 → 단 1회 API 호출

4. 완료

URL 전달: https://www.notion.so/[page_id_without_hyphens]

---

문서 구조 (필수)

## 페이지 위치
**가맹점 대시보드** → **기능명**
[이미지]
---

## [기능] 방법

### Step 1. [작업 제목]
[설명]
[이미지]
1. **'버튼명'**을 클릭합니다.
2. [동작]
💡 Tip: [정보]
---

### Step 2. ...

## [테이블명] 컬럼 설명
| 컬럼명 | 설명 |
|--------|------|
| ... | ... |
---

## [상태] 안내
| 상태 | 색상 | 설명 |
|------|------|------|
| ✅ 완료 | 🟢 초록 | ... |
| ⏳ 대기 | 🟡 노랑 | ... |
| ❌ 실패 | 🔴 빨강 | ... |
---

## 자주 묻는 질문
> Q: [질문]?
A: [답변]

---

가시성 원칙

요소	용도	예시
테이블	컬럼/상태/필드 설명	상태 테이블, 입력 필드 테이블
→ 화살표	경로/흐름	대시보드 → 원비청구
이모지+색상	상태 구분	✅ 완납 🟢, ❌ 미납 🔴
굵은 텍스트	버튼/메뉴 강조	**'저장'**
인라인 코드	입력값/형식	`010-1234-5678`
콜아웃	팁/주의/자동화	💡⚠️⚡
코드 블록	예시 데이터	입력 예시

---

레퍼런스

• Notion 블록 JSON: references/notion-blocks.md
• 가시성 패턴 예시: references/visual-patterns.md

---

체크리스트

필수

• 페이지 위치 (→ 화살표 + 이미지)
• 모든 Step에 이미지 블록
• 버튼/메뉴: '작은따옴표'와 굵게
• 각 Step 끝에 divider
• FAQ 섹션 (최소 3개 토글)

가시성

• 컬럼 설명 테이블
• 상태값 테이블 (이모지+색상)
• 입력 형식: 인라인 코드
• 콜아웃 활용 (💡⚠️⚡)