补充商品明细条码新增配置

references/query-and-business-rules.md

@@ -132,6 +132,23 @@ CREATE TABLE TableName (
 - 需要提交的业务单据必须包含提交时间和提交人，并核实 `AD_TABLE.PROC_SUBMIT` 对应提交逻辑。上述常用字段名、字段类型、关联方式和可空性需按目标环境或用户确认的方案确定；新增草稿只设 `STATUS='1'`，提交时由提交动作维护提交人和时间。
 - 生成 BOS 元数据 SQL 时，先确认目标环境 `AD_COLUMN` 中“字段翻译器”“读写方式”“读写打印规则”“默认值”等配置项对应的实际列名，不凭中文标签猜测物理列名。建表 DDL 与表单元数据配置分别说明；这里仅记录默认规则并生成待人工确认的方案，不通过 Skill 查询通道创建表、维护生成器或写入 BOS 元数据。
 
+## 业务单据商品明细的条码新增配置
+
+业务单据的商品明细表有新增功能、需要通过商品新增输入框输入条码录入时，`AD_TABLE.CLASSNAME` 配置为 `nds.schema.AttributeDetailSupportTableImpl`。该实现类在 BOS 中表示商品明细支持这种条码新增输入方式；分析或生成商品明细方案时，应同时核实该明细表的新增功能和 `CLASSNAME`，不把它套用到所有明细表。
+
+商品明细通常包含以下三个维度字段：
+
+| 常用字段 | 业务含义 | 通常关联对象 | 默认配置说明 |
+| --- | --- | --- | --- |
+| `M_PRODUCT_ID` | 商品 ID / 款号 ID | `M_PRODUCT.ID` | 按目标表单实际配置核实 |
+| `M_PRODUCTALIAS_ID` | 条码 ID / SKU ID，用户也可能简称 `m_productalias` | `M_PRODUCT_ALIAS.ID` | 生成 SQL 前确认实际字段名 |
+| `M_ATTRIBUTESETINSTANCE_ID` | ASI ID / 色码属性 ID，简称 `asiid` | `M_ATTRIBUTESETINSTANCE.ID` | 字段读写规则一般为 `1100000000`，只在新增时可见 |
+
+- `1100000000` 是 ASI 字段的读写规则，按完整十位字符串保存；业务含义为只在新增时可见，不直接沿用主单据 `DOCNO`、`STATUS`、`ISACTIVE` 的 `0010111111` 规则，也不自行推断其他位含义。
+- 商品明细与主单据的关系先通过 `AD_REFBYTABLE` 核实，三个维度字段通过 `AD_COLUMN` 或实际表结构确认；条码字段常用名是 `M_PRODUCTALIAS_ID`，不能只凭用户简称生成不存在的 `M_PRODUCTALIAS` 列。
+- 主单据默认 `MASK='MDQSV'` 不表示商品明细自动支持新增；明细的新增动作配置按其实际 `AD_TABLE.MASK` 核实，需要条码新增时再维护上述 `CLASSNAME` 和字段配置。
+- 本节是 BOS 元数据和表单行为约定，仅用于分析或生成待人工确认的配置方案，不通过 Skill 查询通道写入 `AD_TABLE`、`AD_COLUMN` 或业务明细。
+
 ## 新增业务记录 SQL 生成规则
 
 当用户要求分析或生成新增业务表记录的 SQL 示例时，仍然保持只读安全边界：skill 可以生成 SQL 和说明，但不能直接通过查询通道执行 INSERT、UPDATE、DELETE、MERGE、DDL 等写操作。