> For AI agents: the complete documentation index is available at https://docs.danqiuos.com/llms.txt, the full documentation bundle is available at https://docs.danqiuos.com/llms-full.txt.

# 设计数据与权限

数据地基是业务契约：除了存放记录，还需要确定字段含义、状态口径、读写责任、数据可见性与确认节点。

## 先判断是否需要业务台账

| 需求             | 可考虑的承载方式          |
| -------------- | ----------------- |
| 少量稳定事实、偏好或工作经验 | 记忆                |
| 手册、政策、说明和流程资料  | 知识库               |
| 多员工共享客户、订单等对象  | Arcubase 等结构化业务数据 |
| 定时巡检、派生指标、状态回写 | 有明确字段和权限的结构化台账    |

既有系统是业务真值来源时，先确认应直接接入还是同步到台账，不要无意间建立另一份相互矛盾的账本。

## 明确业务对象与字段

以订单协同为例，可先列出订单、客户、应收记录与负责人。每个字段写清名称、稳定标识、类型、来源、可空条件和修改责任。

| 字段示例 | 含义         | 关键规则         |
| ---- | ---------- | ------------ |
| 订单编号 | 对应一笔业务订单   | 唯一且可回到原始来源   |
| 约定交期 | 企业与客户确认的日期 | 变更需要来源依据     |
| 履约状态 | 当前业务阶段     | 使用明确的状态集合    |
| 负责人  | 需要处理该事项的人  | 必须可解析到真实协作对象 |

这些是概念示例，具体字段 key 和表标识应从企业最终结构回读，不按示例名称猜测。

## 建立读写权责矩阵

| 角色   | 读取       | 写入        | 人工确认      |
| ---- | -------- | --------- | --------- |
| 履约助手 | 授权订单与进度  | 巡检结果、风险建议 | 交期承诺、例外放行 |
| 销售人员 | 负责的客户与订单 | 跟进记录      | 对客户发送承诺   |
| 财务人员 | 授权应收与回款  | 核实后的回款记录  | 账务处理按企业流程 |

字段允许写入不意味着任何场景都可以写。技能还需要说明写入时机、证据和冲突处理方式。

## 选择新建还是复用

在创建或修改应用前，确认是新建专属应用、复用已有应用，还是扩展共享应用。复用时先回读表结构与权限；扩展共享表前评估对既有员工和应用的影响。

## 验证真值与权限

用获授权和未获授权的身份分别验证可见范围。执行写入后，独立回读记录检查字段与状态；员工回复“已更新”不能作为数据已经改变的证据。

更多能力见[Arcubase](https://docs.danqiuos.com/platform/arcubase.md)与[组织权限](https://docs.danqiuos.com/platform/security.md)。

## 区分资料、原文与索引

执行依据不等于操作对象：交期规则属于 Reference，订单记录属于业务数据。知识库中的查看、修改和索引维护应分别授权；资料已同步，不代表语义检索已可用。业务对象关系复杂到表和文档无法稳定表达时，再评估本体建模，无需每个场景都从本体开始。

[数据与知识工具](https://docs.danqiuos.com/reference/data.md)区分使用类与管理类能力。准备阶段确认索引状态，验收时检查引用、更新后检索、原文修改权限和未授权访问。