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
时间线评论、待办事项、活动	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()，并向上层传递错误。