审计日志
Paid按公司记录关键业务实体的变更历史。记录哪些内容、如何查看和筛选,以及旧记录如何归档。
审计日志记录受支持业务实体的创建、更新和删除。每条记录标明操作者和变更字段。日志按公司隔离,默认关闭。在设置 → 审计日志中启用。Carbon 只记录启用之后的变更。
日志按业务实体归组。例如修改物料成本会生成一条 Item(物料) 记录,而不是底层 itemCost 行的记录。
开启审计
Audit Logging(审计日志) 卡片只有一个开关。启用后会创建公司专属的存储、设置 auditLogEnabled,并把受支持的数据表订阅到变更管道。卡片会显示当前状态:
- 已启用:"Audit logging is enabled — All changes to auditable entities are being recorded."
- 已禁用:"Audit logging is disabled — Enable to start tracking changes to your data."
关闭日志会停止新记录,但保留已有历史。重新启用会继续记录,但不会补齐关闭期间的空档。
只有具备更新设置权限的用户才能切换开关。查看日志需要查看设置权限。设置模块与员工类型的对应关系参见权限与访问。
记录哪些内容
Carbon 跟踪一组固定的实体。不在列表中的对象不会被审计。
| 实体 | 实体 |
|---|---|
| 客户 | 供应商 |
| 物料 | 物料保质期 |
| 销售订单 | 采购订单 |
| 销售发票 | 采购发票 |
| 报价单 | 供应商报价 |
| 生产订单 | 员工 |
| 不合格项 | 变更通知 |
| 量具 | 发货单 |
| 收货单 | 仓库调拨 |
| 库存调拨 | 库存盘点 |
| 工作中心 | 维护计划 |
| 维护派生产订单 | 定价规则 |
| 价格覆盖 | 价格覆盖区间 |
| 固定资产 | 会计期间 |
| 租赁协议 | 日记账分录 |
| 付款 | 通知单 |
| 报销 | 拣货单 |
| 折旧运行 | 收入确认运行 |
| 租赁 |
每条记录包含操作(INSERT、UPDATE 或 DELETE)、操作者、字段级差异、请求元数据(IP 地址、用户代理和来源)以及时间戳。系统和 service-role 变更会把操作者显示为 System。差异会排除 updatedAt、updatedBy 和内部嵌入等记账字段。
查看与筛选
两个视图在不同范围呈现同一份数据。
按实体历史。 在大多数实体详情页(客户、销售订单、生产订单、发货单等)上,History(历史) 操作会打开抽屉,显示该记录的时间线。每次变更列出操作、操作者、发生时间,以及可展开的变更字段列表。如果审计日志未启用,抽屉会显示 "Audit logging is not enabled",并提供前往设置启用的快捷入口(或在你无权限时提示联系管理员)。
全局日志。 在审计日志设置页点击 View All(查看全部),打开全屏的 All Audit Logs(全部审计日志) 表格。它支持搜索和分页,并可筛选:
- 实体 — 限定为某一实体类型(销售订单、物料等)。
- 操作 — 创建、更新或删除。
- 操作者 — 负责的用户。
表格列包括实体、操作、操作者、变更和时间。操作显示为彩色标记——创建(绿)、更新(蓝)、删除(红)——每行可展开查看字段级差异。实体值可直接链接到对应记录。
保留与归档
实时日志保留 30 天的活动。每夜的任务会把更早的记录移入压缩归档,记录其日期范围、行数和大小,并从实时表中删除。
归档期间会显示在设置页面的 Archived Logs(归档日志) 下,每项都有 Download(下载) 按钮,生成指向压缩导出的短期签名链接。尚无归档时,卡片会说明超过 30 天的日志会自动归档并可在此下载。
启用审计日志只影响此后写入的数据,不会追溯重建启用之前的变更。