实体管理器（Entity Manager）
实体管理器是 EspoCRM 的平台核心工具，用于管理业务对象（实体）的结构：字段、关系、标签、Stream、看板等。BringCRM 的所有外贸单据（报价单、销售单等）均为实体，均可在此查看与扩展。
入口
管理 → 实体管理器
列表中可见：
- Espo 原生实体：Account、Contact、User、Template…
- Bring 实体：CQuote、CSalesOrder、CPurchaseOrder…
点击实体名称进入该实体的管理页。
实体管理页功能
| 按钮/菜单 | 作用 |
|---|---|
| 编辑 | 修改实体参数（标签、Stream、看板状态字段等） |
| 字段 | 进入字段列表，添加/编辑字段 |
| 关系 | 查看与创建实体间关系 |
| 布局 | 快捷进入各布局类型 |
| 公式 | Before-save 公式脚本 |
| 删除 | 删除自定义实体（勿删 Bring 预置实体） |
创建新实体类型
- 实体管理器首页 → 创建实体
- 填写：
| 项 | 说明 |
|---|---|
| Name | 内部名，系统可能加 c 前缀防冲突 |
| Label | 单数中文名 |
| Plural Label | 复数中文名 |
| Type | 见下表 |
实体类型（Type）
| 类型 | 说明 | 自带能力 |
|---|---|---|
| Base | 基础 | Name、指派用户、团队、描述 |
| Base Plus | 基础增强 | + 活动、历史、任务面板 |
| Event | 事件 | 开始/结束时间、日历 |
| Person | 人员 | 姓名、邮箱、电话、地址 |
| Company | 公司 | 邮箱、电话、账单/发货地址 |
Bring 外贸业务实体为模块预置，一般不需要再建同类实体；扩展需求用 自定义字段 即可。
实体参数（编辑实体）
管理 → 实体管理器 → {实体} → 编辑
| 参数 | 中文 | 说明 |
|---|---|---|
| Labels | 标签 | 单数/复数显示名 |
| Default order | 默认排序 | 列表默认按哪列排序 |
| Stream | 信息流 | 启用后详情页有 Stream；Bring 客户/订单等多已启用 |
| Stars | 星标 | 用户可收藏记录 |
| Disabled | 禁用 | 整个实体从系统中隐藏 |
| Text Filter Fields | 文本筛选字段 | 列表顶栏搜索框搜哪些列 |
| Status Field | 状态字段 | 看板必填：enum 类型状态 |
| Kanban view | 看板 | 需指定 Status Field |
| Full-Text Search | 全文搜索 | 大数据量需索引 |
| Disable record count | 禁用总数 | 列表不显示总条数，大表加速 |
| Color / Icon | 颜色/图标 | 导航与识别 |
| Collaborators | 协作者 | 与指定用户共享记录 |
| Multiple Assigned Users | 多指派 | 一条记录多个负责人 |
| Lockable | 可锁定 | 记录锁定防并发编辑 |
| Pipelines | 管道 | 多管道看板（v10+） |
Bring 示例：
- CQuote：Status Field =
status，启用 Kanban - CSalesOrder：Status Field =
status - Account：Status Field =
followUpProgress（跟进进度看板）
字段管理
点击 字段 进入字段列表 → 见 字段类型详解 与 增加字段（Bring 简明）。
添加字段后必做
- 布局管理器 — 详情/编辑/列表
- 搜索筛选布局 — 否则列表无法按该字段搜
- PDF/Excel 模板占位符
关系（Relationships）
管理 → 实体管理器 → {实体} → 关系
关系类型
| 类型 | 说明 | 创建后界面 |
|---|---|---|
| One-to-Many 一对多 | 左一右多 | 右侧实体自动有 Link 字段；左侧可加底部关系面板 |
| Many-to-One 多对一 | 同上反向 | |
| Many-to-Many 多对多 | 双方底部面板 | |
| One-to-One Right/Left 一对一 | 唯一关联 | |
| Children-to-Parent 父子 | Link-Parent，多类型父实体 |
示例：自定义「合同 Contract」实体，与客户 Many-to-One → 合同上有 account Link 字段，客户详情底部可加「合同」面板。
关系参数
| 参数 | 说明 |
|---|---|
| Link Multiple Field | 创建 Link-Multiple 快捷多选（记录不多时方便） |
| Audited | 关联变更写入 Stream |
| Read-only | 不可在关系面板 unlink，仍可通过 Link 字段改 |
| Cascade removal | 删父记录时级联删子记录（v10+，慎用） |
完整 Bring 预置关系见 实体关系总表。
公式（Formula）
管理 → 实体管理器 → {实体} → 公式
- Before-save custom script：保存前自动计算字段、创建关联记录等
- 配合字段 只读 使用
- 列表可选记录 → 操作 → 重新计算公式
API Before-save（v7.5+）：见 API Before-Save script（英文）
Bring 利润、应收等由模块 PHP Hook 实现，一般不必在公式中重复。
复制自定义到另一环境
实体管理器产生的自定义保存在：
custom/Espo/Custom/
复制该目录到另一实例 → 执行 php rebuild.php。
也可在实体管理器页面 导出为扩展（下拉菜单）。
Bring 实体请勿删除
以下实体为外贸核心，不要在实体管理器中删除或 Disabled：
CQuote、CSalesOrder、CPurchaseOrder、CShippingOrder、CProduct、CReceivables、CProfit 等。