mygit-admin/ken_nogi
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
88a402ce0f
ken_nogi/ClaudePleasanter/files/README.md
Kenichiro NOGI 88a402ce0f up
2026-07-10 18:13:30 +09:00

6.4 KiB
Raw Blame History

プリザンター サイト構成 取得・レビュー・反映ツール

全体の流れ

① node get-site-config.js
   → configs/site-{SiteId}_latest.json に構成を保存
   → 続けて自動的に extract-site-config.js が実行され、
     Scripts / Styles / ServerScripts / Processes / ガイドHTML が
     configs/site-{SiteId}_{サイト名}/ 配下に個別ファイルとして分割保存される

② その latest.json をClaudeのチャットにアップロード
   → Claudeが構成をレビュー・仕様書化（configs/site-{SiteId}_spec.md）

③ configs/site-{SiteId}_{サイト名}/ 配下のファイルを直接編集、
   またはClaudeに「このスクリプトを◯◯に直して」等と修正を指示

④ node build-desired-config.js site-{SiteId}
   → 分割ファイルを再構成し、desired_config.json を生成（送信は行わない）

⑤ node apply-site-config.js
   → 実際には送信せず、差分・送信予定Body・curlコマンドのみ表示（常にドライラン）

⑥ 内容を確認し、問題なければ表示されたcurlコマンドを手動実行

extract-site-config.js は node get-site-config.js の中から自動実行されるため、通常は個別に実行する必要はありません （取得済みの latest.json から抽出をやり直したい場合のみ、単独で node extract-site-config.js を実行してください）。

初回セットアップ

  1. config.example.json を config.json にコピー
  2. BaseUrl / SiteId / ApiKey を実環境の値に書き換え
  3. Node.js 18以降がインストールされていることを確認（組み込みfetchを使用、追加パッケージ不要）

ファイル構成

ファイル 役割
config.json 接続情報（BaseUrl/SiteId/ApiKey）※Git管理・共有厳禁
config.example.json 上記のテンプレート
get-site-config.js サイト構成取得（getsite） → configs/site-{SiteId}_latest.json に保存し、続けて extract-site-config.js を自動実行
extract-site-config.js latest.json から Scripts/Styles/ServerScripts/Processes/ガイドHTML を configs/site-{SiteId}_{サイト名}/ に個別ファイル分割（get-site-config.js から自動呼び出し、または単独実行も可）
build-desired-config.js 分割ファイルを再構成し desired_config.json を生成（送信は行わない）
apply-site-config.js 希望構成JSONとの差分表示・送信内容確認（送信は行わない）
desired_config.json Claude、または build-desired-config.js が生成する「希望構成」
configs/site-{SiteId}_latest.json 直近取得した現状構成（Claudeへのアップロード対象）
configs/site-{SiteId}_spec.md SiteSettingsを読み解いたMarkdown仕様書
configs/site-{SiteId}_{サイト名}/manifest.json 分割ファイルの一覧（Id/Title/ファイル名の対応表）
configs/site-{SiteId}_{サイト名}/scripts/*.js クライアントスクリプト本体（1ファイル=1スクリプト）
configs/site-{SiteId}_{サイト名}/styles/*.css スタイル本体
configs/site-{SiteId}_{サイト名}/serverscripts/*.js サーバースクリプト本体
configs/site-{SiteId}_{サイト名}/html/*.html ガイドHTML（GridGuide等。値が空でないもののみ）
configs/site-{SiteId}_{サイト名}/processes.json プロセス設定（SiteSettings.Processes の定義ファイル）

Scripts/Styles/ServerScripts/Processes の反映について

  • build-desired-config.js が生成する desired_config.json は Mode:"partial"（updatesitesettings）です。 Scripts / Styles / ServerScripts / Processes の4項目のみを対象とし、それ以外のサイト設定（GridColumns等）には触れません。
  • ガイドHTML（html/*.html）はSiteSettingsではなくサイトデータ直下の項目のため、updatesitesettings では反映できません。 反映したい場合は Mode:"full"（updatesite）用の別の desired_config.json を用意し、Title/ReferenceType 等の必須項目とあわせて指定してください。
  • 抽出（extract-site-config.js）はその時点のスナップショットです。抽出後に元サイトが他の人・画面から変更されている可能性がある場合は、 反映前に node get-site-config.js → node extract-site-config.js を再実行し、最新状態を取り直してから編集してください。

参照した公式API仕様

安全設計について

  • apply-site-config.js は 常にドライラン です。デフォルトでは実際のAPI呼び出しコード自体に到達しないようガード（ENABLE_ACTUAL_SEND = false 固定）しています。
  • 反映する際は、表示されたcurlコマンドをご自身で実行するか、内容を確認の上でスクリプトを改修してください（Claudeが安全策なしに自動実行することはありません）。
  • APIキーは config.json にのみ保持し、Claudeにアップロードする latest.json には含まれません（get時のレスポンスにAPIキーは含まれないため）。念のためアップロード前に目視確認することをおすすめします。

注意事項

  • プリザンターのバージョンにより get レスポンスの構造（Response.Site.SiteSettings の位置など）が異なる場合があります。初回実行時にコンソールへ出力されるキー構造を確認してください。
  • サイト設定の更新系APIは テナント管理者権限のAPIキー が必要です（一般ユーザーのAPIキーでは403等になります）。