feat(install): 설치 섹션 추가 — 아키텍처·PoC 사이, Notion 연동

Author: sungbin1015

.github/workflows/notion-sync.yml

@@ -31,6 +31,7 @@ jobs:
       _POC_DB:          ${{ secrets.NOTION_POC }}
       _DOCS_DB:         ${{ secrets.NOTION_DOCS }}
       _RELEASE_DB:      ${{ secrets.NOTION_RELEASE }}
+      _INSTALL_DB:      ${{ secrets.NOTION_INSTALL }}
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -88,6 +89,12 @@ jobs:
             pids+=($!)
           fi
 
+          if [ -n "$_INSTALL_DB" ]; then
+            NOTION_DATABASE_ID="$_INSTALL_DB" SAVE_DIR=docs/install FETCH_MODE=ALL \
+              python scripts/notion_to_docs_generic.py &
+            pids+=($!)
+          fi
+
           if [ ${#pids[@]} -eq 0 ]; then
             echo "동기화할 DB가 없습니다. GitHub Secrets에 NOTION_* 변수를 설정하세요."
             exit 0

docs/install/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "설치",
+  "position": 3,
+  "link": {
+    "type": "generated-index",
+    "description": "SceneMakerAI 프로젝트 설치 가이드를 정리합니다."
+  }
+}

docs/install/overview.md

@@ -0,0 +1,7 @@
+---
+id: overview
+title: 설치 개요
+sidebar_position: 0
+---
+
+SceneMakerAI 프로젝트 설치 방법을 정리합니다.

docusaurus.config.ts

@@ -147,6 +147,12 @@ const config: Config = {
           position: 'left',
           label: '아키텍처',
         },
+        {
+          type: 'docSidebar',
+          sidebarId: 'installSidebar',
+          position: 'left',
+          label: '설치',
+        },
         {
           type: 'docSidebar',
           sidebarId: 'pocSidebar',

scripts/sync-local.sh

@@ -65,6 +65,12 @@ if [ -n "$NOTION_RELEASE" ]; then
   pids+=($!)
 fi
 
+if [ -n "$NOTION_INSTALL" ]; then
+  NOTION_DATABASE_ID="$NOTION_INSTALL" SAVE_DIR=docs/install FETCH_MODE=ALL \
+    python scripts/notion_to_docs_generic.py &
+  pids+=($!)
+fi
+
 if [ ${#pids[@]} -eq 0 ]; then
   echo "동기화할 DB가 없습니다. .env 파일에 NOTION_* 변수를 설정하세요."
   exit 0

sidebars.ts

@@ -26,6 +26,10 @@ const sidebars: SidebarsConfig = {
     {type: 'autogenerated', dirName: 'architecture'},
   ],
 
+  installSidebar: [
+    {type: 'autogenerated', dirName: 'install'},
+  ],
+
   pocSidebar: [
     {type: 'autogenerated', dirName: 'poc'},
   ],