bitrix24-crm

Bitrix24 CRM（サーバーサイド）

対象範囲：Bitrix24 オンプレミス · 検証済み：crm 26.800.0、main 26.800.0

ポータル内で実行される PHP：/local/ のモジュール、ハンドラー、エージェント。REST 経由で CRM を呼び出す場合：bitrix24-rest-api。

タスク	参照先
コンテナ、Factory、アイテムの読み取り、フィールド名、電話番号／メールアドレス	rules/factory-items.md
追加／更新／削除、Context、チェック、カスタムアクション	rules/operations.md
スマートプロセス、ファネル、ステージ、スマート請求書	rules/smart-processes.md
権限チェック、権限でフィルタリングされたリスト	rules/permissions.md
変更への対応、Factory のオーバーライド、ロボット、トリガー	rules/events-automation.md
タイムラインのコメント、ToDo、アクティビティ	rules/timeline-activities.md
フィールドコレクション、ユーザーフィールド	rules/fields-uf.md
CCrmDeal／CCrmLead／…の置き換え、D7 ↔ REST の対応表	rules/legacy-rest.md

不変条件

• 最初に Loader::includeModule('crm') を呼び出し、サービスは Container::getInstance() から取得します。
• 書き込みには Factory の操作のみを使用します：getAddOperation()／getUpdateOperation()／getDeleteOperation() → launch()。DealTable::add()、$factory->getDataClass()::update()、Item::save()／Item::delete() は決して使用しないでください。これらは権限、必須フィールド、イベント、タイムライン、検索インデックス、ロボットをスキップします。
• Item::FIELD_NAME_* の名前を使用します。Factory がエンティティのカラムにマッピングします（リードの STAGE_ID → STATUS_ID）。
• 動的な entityTypeId、ファネル、ステージの ID はポータルごとに異なります。コードまたは意味に基づいて実行時に解決し、ハードコードしないでください。
• エージェント、CLI、キューにはユーザーが存在しません。ユーザー ID を指定した Context を渡すか、意図的にアクセスチェックを無効にしてください。
• すべての launch() で isSuccess() を確認し、エラーを呼び出し元に渡してください。