bitrix-bizproc

业务流程（bizproc）

基线：main 23.0+ · 已验证：bizproc 26.1400.0、bizprocdesigner 26.800.0、main 26.800.0

运行时、文档和活动位于 bizproc 中；模板设计器 UI 位于 bizprocdesigner 中（需要功能 BizProc）。加载 bizproc 和文档所属模块（crm、lists 等）。

任务	阅读
启动、终止、强制结束、外部事件、文档 ID、Starter	rules/start-stop.md
自定义活动：文件夹、.description.php、类、保留名称、等待事件	rules/custom-activities.md
Nodes 设计器的自定义触发器	rules/triggers.md
模板权限、设计器控制器、导入、模板服务	rules/templates-access.md
卡住的暂停、故障限制、跟踪、存储清理、Agent 与 Messenger	rules/runtime-ops.md

不变量

• 文档 ID 的格式为 [moduleId, entity, documentId]，类型的格式为 [moduleId, entity, documentType]。从所属模块或现有模板中复制这些三元组；切勿自行编造。
• CBPDocument 方法通过 $errors（按引用传递）报告错误，而非抛出异常：每次调用后都要检查它。
• 在手动启动前，以及每个自定义控制器中，都要检查权限（CBPDocument::canUserOperateDocument() / canUserOperateDocumentType()）。
• 审批和文档状态机 → bizproc。定期同步和繁重的 I/O → Agent 或 Messenger（bitrix-background-jobs），切勿放在 execute() 中。
• 自定义活动类和辅助工具必须使用供应商前缀，且绝不复用 CBPActivity 成员名称。