同步 Skill 1.5.48 公共快照

references/query-and-business-rules.md

@@ -72,6 +72,29 @@ WHERE s.C_STORE_ID = :store_id
 ```
 
 
+## BOS 新建表最小结构（仅生成 DDL）
+
+按照 BOS 系统规则，为新建表生成结构 SQL 时，至少包含下面八个基础字段和 `ID` 主键。业务字段在此基础上增加，不要只列业务字段而漏掉基础字段。`TableName` 是表名占位符，生成具体方案时替换为用户确认的表名。
+
+```sql
+CREATE TABLE TableName (
+    ID NUMBER(10) NOT NULL,
+    AD_CLIENT_ID NUMBER(10),
+    AD_ORG_ID NUMBER(10),
+    OWNERID NUMBER(10),
+    CREATIONDATE DATE,
+    MODIFIERID NUMBER(10),
+    MODIFIEDDATE DATE,
+    ISACTIVE CHAR(1) DEFAULT 'Y' NOT NULL,
+    PRIMARY KEY (ID)
+);
+```
+
+- “必须包含字段”不等于“所有字段非空”：本模板只有 `ID` 和 `ISACTIVE` 明确 `NOT NULL`，其余六个字段允许为空。
+- `ID`、`AD_CLIENT_ID`、`AD_ORG_ID`、`OWNERID`、`MODIFIERID` 使用 `NUMBER(10)`；`CREATIONDATE`、`MODIFIEDDATE` 使用 `DATE`；`ISACTIVE` 使用 `CHAR(1)`，默认值为 `'Y'`。
+- 不要把新增业务记录时的 `AD_CLIENT_ID=37`、`AD_ORG_ID=27` 或主键取号规则自动写成建表 `DEFAULT`；本最小模板只为 `ISACTIVE` 指定默认值，日期字段也不自动增加 `DEFAULT SYSDATE`。
+- 这是新建表结构规则，不表示可以自动修改既有表。Skill 仅生成 DDL 并明确“未执行”，由用户或 DBA 确认后人工执行；不通过 `query` / `qperm` 建表，也不隐式写入 BOS 元数据。
+
 ## 新增业务记录 SQL 生成规则
 
 当用户要求分析或生成新增业务表记录的 SQL 示例时，仍然保持只读安全边界：skill 可以生成 SQL 和说明，但不能直接通过查询通道执行 INSERT、UPDATE、DELETE、MERGE、DDL 等写操作。