pleasanter-script-deploy

Pleasanter Script Deploy

基本方針

Pleasanter のサイト設定やクライアントスクリプトを変更するときは、dry-run や見た目だけの成功扱いで終わらせない。対象 SiteId、API キー、ログインユーザー、権限、反映結果、実画面挙動を確認してから完了とする。

失敗した API 呼び出し、保存失敗、権限不足、画面未反映は成功として扱わない。エラーは握りつぶさず、ユーザーに原因候補と次の確認点を短く報告する。

スタートアップ確認

作業開始時に、既存ファイルやユーザー指示から以下を確認する。不明で、ローカルファイルや実画面から判定できないものだけユーザーへ質問する。

• 対象 Pleasanter URL。例: http://localhost:50001
• 対象 SiteId。フォルダー、テーブル、ガント対象テーブルを区別する。
• 変更対象がサイト設定、クライアントスクリプト、ビュー、リンク、ガント、レコードのどれか。
• .env または安全な環境変数に、対象 Pleasanter URL、API キー、SiteId、ブラウザ検証用ログイン情報が設定されていること。認証情報をチャットへ貼らない。
• ブラウザ検証用ログインユーザーとパスワード。
• そのユーザーが対象サイトを閲覧、編集、設定変更、レコード更新できるか。
• 作業してよい環境か。SiteId や環境名が曖昧なら変更前に確認する。
• 既存の要件定義、レビュー、検証記録、エクスポート、投入スクリプトの場所。

事前調査

1. docs/、exports/、scripts/、既存投入スクリプトを確認する。
2. 対象 SiteId と親子関係を混同しない。フォルダー SiteId とテーブル SiteId は別物として扱う。
3. 既存のサイト設定取得 API またはエクスポートから、SiteSettings.Scripts、ガント設定、リンク設定、列設定を確認する。
4. 既存スクリプトがある場合は、丸ごと上書きしてよいか、同一タイトルのスクリプトだけ置換すべきか判断する。
5. ユーザーが触っていない別サイトや本番環境には変更を広げない。

.env 運用

API 反映スクリプトは、ベース URL、API キー、SiteId をコードへ固定しない。原則としてプロジェクトに .env.example を用意し、ユーザーにはそれを .env にコピーして値を入れてもらう。

最低限のテンプレート:

PLEASANTER_BASE_URL=
PLEASANTER_API_KEY=
PLEASANTER_TARGET_SITE_ID=
PLEASANTER_LOGIN_ID=
PLEASANTER_LOGIN_PASSWORD=

複数サイトを扱う場合は、用途が分かる名前で PLEASANTER_ROOT_SITE_ID、PLEASANTER_TASK_SITE_ID などを追加する。.env は Git 管理、成果物、チャット貼り付けに含めない。.env.example には空値またはローカル開発用の非秘密値だけを書く。

反映対象がサブパス配下の Pleasanter の場合は、PLEASANTER_BASE_URL に API が届くベースパスを含める。クライアントスクリプト内で編集画面の相対パスを組み立てている場合は、EDIT_PATH_PREFIX などの設定が対象環境のパス構成に合うか確認する。

API 反映手順

実 API で反映する。一般的な流れは以下。

1. .env または環境変数から、ベース URL、API キー、対象 SiteId を取得する。未設定なら処理を中断し、成功扱いにしない。
2. POST /api/items/{siteId}/getsite で現在のサイト設定を取得する。
3. SiteSettings 内の対象設定だけを変更する。
4. POST /api/items/{siteId}/updatesite に Title、Body、SiteSettings を含めて送る。
5. レスポンスの StatusCode が成功であることを確認する。
6. 反映後に再取得またはエクスポートを行い、変更後の設定が保存されていることを確認する。

API レスポンスが失敗した場合は中断し、成功扱いにしない。フォールバック実装で失敗を隠さない。

ブラウザ検証

反映後は、実ブラウザで確認する。ユーザーがアプリ内ブラウザを指定している場合は、外部ブラウザではなくアプリ内ブラウザを使う。