add-block

Add New Block Workflow

新規ブロック（Discord, Slack, Notion等の外部連携）を追加する際のワークフロー。

必読ドキュメント

以下を必ず先に読むこと：

1. docs/designs/UNIFIED_BLOCK_MODEL.md - Block execution architecture
2. docs/BLOCK_REGISTRY.md - Existing block definitions
3. backend/migrations/011_unified_block_model.sql - 既存パターン確認

標準手順（Migration追加）

ほとんどのブロックはこの方式で追加する:

1. Migrationファイル作成: backend/migrations/XXX_{name}_block.sql
2. block_definitionsテーブルにINSERT
   • tenant_id = NULL でシステムブロック
   • codeにJavaScriptコード（ctx.http等を使用）
   • ui_configにアイコン・カラー・設定スキーマ
3. Migration実行: make db-reset
4. docs/BLOCK_REGISTRY.md を更新

コード例

INSERT INTO block_definitions (tenant_id, slug, name, category, code, ui_config, is_system)
VALUES (
  NULL,  -- システムブロック
  'discord',
  'Discord通知',
  'integration',
  $code$
    const webhookUrl = config.webhook_url || ctx.secrets.DISCORD_WEBHOOK_URL;
    const payload = { content: renderTemplate(config.message, input) };
    return await ctx.http.post(webhookUrl, payload);
  $code$,
  '{"icon": "message-circle", "color": "#5865F2", "configSchema": {...}}',
  TRUE
);

ctx インターフェース

Go Adapterが必要な例外ケース

Go Adapter追加が必要な場合:

1. Create backend/internal/adapter/{name}.go
2. Implement Adapter interface
3. Register in registry
4. Add test {name}_test.go
5. Update docs/BACKEND.md

参考

• docs/designs/UNIFIED_BLOCK_MODEL.md
• docs/BLOCK_REGISTRY.md