기술 문서 (프로토타입 버전)

Reference README

저장소의 docs/reference/README.md 와 동일한 원문입니다. 아래에서 Markdown과 HTML 변환 결과를 각각 복사할 수 있습니다.

공개 문서 원문 (Markdown)

# Notion 레퍼런스 (`docs/reference/`)

`CLAUDE.md`·`README.md`에서 말하는 **SaaS 기획·요구사항 스냅샷**을 두는 폴더입니다.

## 생성 방법

프로젝트 루트 `.env.local`(또는 `.env`)에 다음을 넣은 뒤:

- `NOTION_TOKEN` — Notion Integration 시크릿
- `NOTION_PAGE_ID_SAAS` — 추출할 최상위 페이지 ID

실행:

```bash
pnpm extract-notion-saas
```

성공 시 `notion-saas.md`와 `notion-saas-summary.json`이 생성됩니다.

Integration이 해당 페이지에 **공유(Invite)** 되어 있어야 합니다.

## `502` / `503` 등으로 실패할 때

Notion API 쪽 일시 장애일 수 있습니다. 스크립트는 자동으로 몇 번 재시도합니다. 그래도 안 되면 **1~2분 뒤** 같은 명령을 다시 실행해 보세요.

공개 문서 변환 코드 (HTML)

<h1>Notion 레퍼런스 (<code>docs/reference/</code>)</h1>
<p><code>CLAUDE.md</code>·<code>README.md</code>에서 말하는 <strong>SaaS 기획·요구사항 스냅샷</strong>을 두는 폴더입니다.</p>
<h2>생성 방법</h2>
<p>프로젝트 루트 <code>.env.local</code>(또는 <code>.env</code>)에 다음을 넣은 뒤:</p>
<ul>
<li><code>NOTION_TOKEN</code> — Notion Integration 시크릿</li>
<li><code>NOTION_PAGE_ID_SAAS</code> — 추출할 최상위 페이지 ID</li>
</ul>
<p>실행:</p>
<pre><code class="language-bash">pnpm extract-notion-saas
</code></pre>
<p>성공 시 <code>notion-saas.md</code>와 <code>notion-saas-summary.json</code>이 생성됩니다.</p>
<p>Integration이 해당 페이지에 <strong>공유(Invite)</strong> 되어 있어야 합니다.</p>
<h2><code>502</code> / <code>503</code> 등으로 실패할 때</h2>
<p>Notion API 쪽 일시 장애일 수 있습니다. 스크립트는 자동으로 몇 번 재시도합니다. 그래도 안 되면 <strong>1~2분 뒤</strong> 같은 명령을 다시 실행해 보세요.</p>