ken_nogi/NodeSrv/apps/healthcheck-survey-bot
Kenichiro NOGI 90d057aac9 feat: HC-SUBワークフロー(プロセス実行+案内送信)を追加
WP・WAから共通利用するExecute Workflow Triggerサブワークフローを実装。
秘密値・SiteId等はすべてworkflow_config_values(bNkadTyDgDepYx2p)から
Data Tableノード経由で取得し式参照、ハードコードなし。デプロイ・active化
まで実施、実行テスト(LINEWORKS実送信)は次段階でユーザー確認後に実施する。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-05 15:11:30 +09:00
..
scripts feat: n8n Public API操作用の共通スクリプトを追加 2026-09-05 14:41:11 +09:00
src/lib feat: LINEWORKS Webhook署名検証ロジックを追加 2026-09-05 14:37:44 +09:00
test feat: LINEWORKS Webhook署名検証ロジックを追加 2026-09-05 14:37:44 +09:00
workflows feat: HC-SUBワークフロー(プロセス実行+案内送信)を追加 2026-09-05 15:11:30 +09:00
.gitignore feat: healthcheck-survey-botプロジェクト雛形を追加 2026-09-05 14:14:34 +09:00
package.json feat: healthcheck-survey-botプロジェクト雛形を追加 2026-09-05 14:14:34 +09:00
README.md feat: HC-SUBワークフロー(プロセス実行+案内送信)を追加 2026-09-05 15:11:30 +09:00

healthcheck-survey-bot

健康診断管理(SiteId 508971)×LINEWORKS Bot連携。508971のSiteSettings.Processes をフロー定義として使い、n8n上でBot対話型のStatus管理を行う。

設計書: NodeSrv/docs/superpowers/specs/2026-09-05-healthcheck-lineworks-survey-n8n-design.md 実装計画: NodeSrv/docs/superpowers/plans/2026-09-05-healthcheck-lineworks-survey-n8n.md

実機調査メモ2026-09-05確認

508971への新規テストProcess追加なしで、既存本番プロジェクト「実行予算WF申請」SiteId 376872の 取得済みprocesses.jsonPleasanter/実行予算WF申請/configs/production/site-376872_実行予算WF申請/processes.json に入力検証タブを使ったProcessの実例があり、そこからJSON構造を確認できた。

Processの入力検証タブはSiteSettings.Processes[].ValidateInputs配列として保存される。 各要素は{"Id": number, "ColumnName": string, "Required": boolean}(実例: {"Id": 1, "ColumnName": "Class021", "Required": true})。 配列名はValidationsではなくValidateInputs。値を設定していない項目(クライアント/サーバ正規表現、エラーメッセージ、最小/最大等)は キー自体が省略される可能性が高い(今回の実例では未設定のため確認できていない)。

Task 5processFlow.jsgetValidationColumnNamesはこの構造(process.ValidateInputs[].ColumnName)を前提に実装する。

n8nリソースID一覧

(Task 8〜11完了後、ここに作成したData Table ID・ワークフローIDを記録する)

  • Data Table healthcheck_bot_state: jqMDa2YZTI4f0iQ7

    • projectId: LOcxF69Gm4PvnkqAorg-master-sync用プロジェクトを流用)
    • 列: resultId, targetEmail, currentStatus, pendingProcesses, awaitInput, awaitProcessId, awaitColumnすべてstring型
    • 注記: 設計上の8列目updatedAtはn8n Data Tableのシステム予約列名POST /data-tables400 Column name "updatedAt" is reserved as a system column name.を返すのため、列定義には含めていない。各行の更新日時はn8nが自動管理するupdatedAtメタデータで代替する。
  • ワークフロー HC-SUB: プロセス実行と案内送信: XRqcykbG2LuAjGG2

    • ファイル: workflows/hc-sub-run-process-and-notify.jsonExecute Workflow Trigger、入力{resultId, processId}
    • active化済みExecute Workflow Triggerサブワークフローは呼び出し元から実行可能にするためactive必須、asKvC5LSVg3q8tuUと同じ運用)
    • 秘密情報・SiteId等はすべてworkflow_config_valuesbNkadTyDgDepYx2p)からData Tableードで取得し式参照。ワークフローJSONに秘密値のハードコードなし
    • 未検証の暫定実装ありTask 12で要修正: ①484184(LINEWORKS_BOT_MASTER_SITE_ID)からのBotId解決ロジック実データ構造未調査のためSiteSettings.BotIdsまたはProcesses[].BotIdを仮定し、無ければ例外を投げる)、②/api/users/getのレスポンス形状(配列/単一オブジェクト両対応の防御的実装)
    • Step 4実行テスト・LINEWORKS実送信は本タスクでは未実施。次回、捨てレコードでの疎通確認とユーザー確認が必要