From 2a81f5668e8e453f6a61eb692c3822a3aaa780cd Mon Sep 17 00:00:00 2001 From: chen qiang <343005560@qq.com> Date: Wed, 30 Sep 2026 15:15:56 +0800 Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85=E5=95=86=E5=93=81=E6=98=8E?= =?UTF-8?q?=E7=BB=86=E6=9D=A1=E7=A0=81=E6=96=B0=E5=A2=9E=E9=85=8D=E7=BD=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 2 ++ CHANGELOG.md | 6 ++++++ README.md | 2 ++ SKILL.md | 3 ++- VERSION | 2 +- references/bos-metadata.md | 2 ++ references/query-and-business-rules.md | 17 +++++++++++++++++ 7 files changed, 32 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 691a9c1..7583218 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,5 +1,7 @@ # oracle-jump-query Skill Release Standard +Release 1.5.53: 补充商品明细新增时 CLASSNAME 为 nds.schema.AttributeDetailSupportTableImpl 的条码输入约定，以及商品、条码、ASI 三个常用字段和 ASI 读写规则 1100000000（只在新增时可见）。本次仅更新业务文档，不修改 Agent、transit-server、CLI/HTTP 接口、配置或审计 action、字段及保存策略，命令数保持 32。发布时同步私有主库、安装目录和无私有历史公共镜像。 + Release 1.5.52: 补充新建 BOS 业务单据表单的 DOCNO 生成器、STATUS/ISACTIVE 翻译器和选项组、字段读写打印规则、默认值、提交人和提交时间，以及表级 MDQSV 默认规则。ISACTIVE 默认 Y，STATUS 默认 1；仅生成方案。本次仅更新业务文档，不修改 Agent、transit-server、CLI/HTTP 接口、配置或审计 action、字段及保存策略，命令数保持 32。发布时同步私有主库、安装目录和无私有历史公共镜像。 Release 1.5.51: CLI 每次启动记录最后使用时间，按本机日期每日首次使用自动抓取 origin/main 并仅快进安装，成功后重新启动当前命令；本机状态与并发锁不提交 Git。保留本机配置，源码修改、暂存修改、分支分叉或配置冲突时暂停安装；失败不阻止业务命令。本次新增本机更新逻辑，不修改 Agent、transit-server、HTTP 接口、登录配置或审计 action、字段及保存策略，命令数保持 32。发布时同步私有主库、安装目录和无私有历史公共镜像。 diff --git a/CHANGELOG.md b/CHANGELOG.md index 04cf9af..8066af3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,9 @@ +## 1.5.53 (2026-09-30) + +- 补充业务单据商品明细新增配置：`AD_TABLE.CLASSNAME='nds.schema.AttributeDetailSupportTableImpl'` 表示在商品新增输入框输入条码录入。 +- 明确商品、条码、ASI 三个常用维度字段，ASI 字段读写规则一般为 `1100000000`，只在新增时可见；明细新增动作和实际字段名按目标环境核实。 +- 本次仅更新 Skill 业务文档，不修改 Agent、transit-server、CLI/HTTP 接口、配置格式或审计 action、字段及保存策略；命令数保持 32。 + ## 1.5.52 (2026-09-30) - 补充新建 BOS 业务单据表单默认配置：DOCNO 编号生成器和单据编号读写方式，STATUS/ISACTIVE 下拉框、选项组、字段翻译器、默认值和读写打印规则，以及提交人、提交时间。 diff --git a/README.md b/README.md index 5e98f00..124a74f 100644 --- a/README.md +++ b/README.md @@ -300,6 +300,8 @@ python scripts/oracle_skill.py ops_report HENLO ## 新增业务记录 SQL 生成规则 +业务单据的商品明细有新增功能、需要通过商品新增输入框输入条码录入时，`AD_TABLE.CLASSNAME` 配置为 `nds.schema.AttributeDetailSupportTableImpl`。明细通常有商品 ID `M_PRODUCT_ID`、条码 ID `M_PRODUCTALIAS_ID`、ASI ID `M_ATTRIBUTESETINSTANCE_ID`；ASI 字段读写规则一般为 `1100000000`，只在新增时可见。字段名称和明细新增动作需核实，详细规则见 [商品明细的条码新增配置](./references/query-and-business-rules.md#业务单据商品明细的条码新增配置)。 + 新建 BOS 业务单据表单时，在八个基础字段和主键之上通常还需 `DOCNO`、`STATUS`、提交时间、提交人；`ISACTIVE` 已在基础字段中。表级读写规则默认 `MDQSV`。`DOCNO` 维护编号生成器，读写方式为“单据编号”；`STATUS`、`ISACTIVE` 使用“下拉框选项”，选项名称分别为 `STATUS`、`YESNO`，字段翻译器均为 `nds.web.alert.LimitValueAlerter`，默认值分别为 `1`、`Y`。三个字段的读写打印规则均为 `0010111111`，保留前导零。提交人和提交时间由提交动作维护；详细规则见 [业务单据表单默认配置](./references/query-and-business-rules.md#bos-新建业务单据表单默认配置)。 本 skill 默认只读，不直接执行写库操作；当需要分析或生成新增业务记录 SQL 示例时，遵守以下 BOS 默认取值规则： diff --git a/SKILL.md b/SKILL.md index 064fd9a..bcf9514 100644 --- a/SKILL.md +++ b/SKILL.md @@ -5,7 +5,7 @@ description: Oracle 跳板查询技能。通过中转服务查询远程 Oracle # Oracle 跳板查询 -> **版本：v1.5.52** · [更新日志](./CHANGELOG.md) +> **版本：v1.5.53** · [更新日志](./CHANGELOG.md) ## 使用原则 @@ -127,6 +127,7 @@ AD_SUBSYSTEM - 条码、SKU 通常指 `M_PRODUCT_ALIAS`；查询条码时首查 `M_PRODUCT_ALIAS.NO`。 - 款号和条码是一对多关系。 - 商品明细里的 `M_PRODUCT_ID`、`M_PRODUCTALIAS_ID`、`M_ATTRIBUTESETINSTANCE_ID` 通常分别对应款号、条码、色码属性 ASI。 +- 业务单据的商品明细支持新增、需要在商品新增输入框输入条码录入时，`AD_TABLE.CLASSNAME` 配置为 `nds.schema.AttributeDetailSupportTableImpl`；ASI 字段 `M_ATTRIBUTESETINSTANCE_ID` 的读写规则一般为 `1100000000`，只在新增时可见。明细新增动作和实际字段名先核实，完整规则见 [商品明细的条码新增配置](./references/query-and-business-rules.md#业务单据商品明细的条码新增配置)。 - `M_ATTRIBUTESETINSTANCE` 是商品色码属性表：`VALUE1`/`VALUE1_CODE`/`VALUE1_ID` 对应颜色名称、颜色编号、颜色表 `M_COLOR.ID`；`VALUE2`/`VALUE2_CODE`/`VALUE2_ID` 对应尺码名称、尺码编号、尺码表 `M_SIZE.ID`。 - 库存通常查 `V_FA_STORAGE`，必须同时带店仓条件和款号/条码条件，并加行数限制。 - 新增业务记录 SQL 示例中，主键 `ID` 使用 `get_sequences('<表名称>')`。 diff --git a/VERSION b/VERSION index 87a4e43..a9b3eda 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -1.5.52 +1.5.53 diff --git a/references/bos-metadata.md b/references/bos-metadata.md index 64b8ac3..a4e6c8b 100644 --- a/references/bos-metadata.md +++ b/references/bos-metadata.md @@ -12,6 +12,8 @@ ### 通用查询规则 +商品明细新增行为还需检查 `AD_TABLE.CLASSNAME`：`nds.schema.AttributeDetailSupportTableImpl` 表示支持在商品新增输入框输入条码录入。商品 ID、条码 ID、ASI ID 及 ASI 字段 `1100000000`（只在新增时可见）的配置约定见 [商品明细的条码新增配置](./query-and-business-rules.md#业务单据商品明细的条码新增配置)。明细新增功能以实际动作配置为准，不从主单据 `MASK` 推断。 + 处理 BOS 业务单据（如零售单、采购单、调拨单、销售单等）时，必须遵循以下查询路径： 在品小二环境按中文名称或中文描述筛选时，遵守 [中文条件与字符集兼容](./query-and-business-rules.md#中文条件与字符集兼容) 规则：不要直接把中文写入 `LIKE` 或等值条件，改用 `UNISTR` Unicode 转义。直接中文字面量返回 0 行时，先用 `UNISTR` 形式重试。 diff --git a/references/query-and-business-rules.md b/references/query-and-business-rules.md index fa72406..76dfa62 100644 --- a/references/query-and-business-rules.md +++ b/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 等写操作。