kcode-pi 0.1.0

package/knowledge/enterprise/tables.json

@@ -0,0 +1,159 @@
+{
+  "T_PUR_POORDER": {
+    "name": "采购订单表",
+    "module": "采购管理",
+    "description": "采购订单主表，记录采购订单的基本信息",
+    "fields": [
+      { "name": "FID", "type": "bigint", "nullable": false, "description": "主键ID" },
+      { "name": "FBILLNO", "type": "varchar(50)", "nullable": false, "description": "单据编号" },
+      { "name": "FDATE", "type": "datetime", "nullable": false, "description": "单据日期" },
+      { "name": "FDOCUMENTSTATUS", "type": "char(1)", "nullable": false, "description": "单据状态：A=暂存,B=已提交,C=已审核" },
+      { "name": "FCANCELSTATUS", "type": "char(1)", "nullable": false, "description": "作废状态：A=正常,B=已作废" },
+      { "name": "FSUPPLIERID", "type": "bigint", "nullable": false, "description": "供应商ID" },
+      { "name": "FPURCHASEORGID", "type": "bigint", "nullable": false, "description": "采购组织ID" },
+      { "name": "FPURCHASEDEPTID", "type": "bigint", "nullable": true, "description": "采购部门ID" },
+      { "name": "FPURCHASERID", "type": "bigint", "nullable": true, "description": "采购员ID" },
+      { "name": "FCURRENCYID", "type": "bigint", "nullable": false, "description": "币种ID" },
+      { "name": "FEXCHANGERATE", "type": "decimal(18,6)", "nullable": false, "description": "汇率" },
+      { "name": "FTOTALAMOUNT", "type": "decimal(18,2)", "nullable": false, "description": "价税合计" },
+      { "name": "FTOTALTAXAMOUNT", "type": "decimal(18,2)", "nullable": false, "description": "税额" },
+      { "name": "FDESCRIPTION", "type": "varchar(500)", "nullable": true, "description": "备注" },
+      { "name": "FCREATORID", "type": "bigint", "nullable": false, "description": "创建人ID" },
+      { "name": "FCREATETIME", "type": "datetime", "nullable": false, "description": "创建时间" },
+      { "name": "FMODIFIERID", "type": "bigint", "nullable": true, "description": "修改人ID" },
+      { "name": "FMODIFYTIME", "type": "datetime", "nullable": true, "description": "修改时间" },
+      { "name": "FAUDITORID", "type": "bigint", "nullable": true, "description": "审核人ID" },
+      { "name": "FAUDITDATE", "type": "datetime", "nullable": true, "description": "审核日期" }
+    ],
+    "relatedTables": [
+      { "table": "T_PUR_POORDERENTRY", "relation": "FID", "description": "采购订单明细" },
+      { "table": "T_PUR_POORDERFIN", "relation": "FID", "description": "采购订单财务信息" }
+    ]
+  },
+  "T_PUR_POORDERENTRY": {
+    "name": "采购订单明细表",
+    "module": "采购管理",
+    "description": "采购订单明细表，记录采购订单的物料明细",
+    "fields": [
+      { "name": "FENTRYID", "type": "bigint", "nullable": false, "description": "明细ID" },
+      { "name": "FID", "type": "bigint", "nullable": false, "description": "主表ID" },
+      { "name": "FSEQ", "type": "int", "nullable": false, "description": "行号" },
+      { "name": "FMATERIALID", "type": "bigint", "nullable": false, "description": "物料ID" },
+      { "name": "FUNITID", "type": "bigint", "nullable": false, "description": "单位ID" },
+      { "name": "FQTY", "type": "decimal(18,6)", "nullable": false, "description": "数量" },
+      { "name": "FPRICE", "type": "decimal(18,6)", "nullable": false, "description": "单价" },
+      { "name": "FAMOUNT", "type": "decimal(18,2)", "nullable": false, "description": "金额" },
+      { "name": "FTAXPRICE", "type": "decimal(18,6)", "nullable": false, "description": "含税单价" },
+      { "name": "FTAXAMOUNT", "type": "decimal(18,2)", "nullable": false, "description": "价税合计" },
+      { "name": "FTAXRATE", "type": "decimal(18,2)", "nullable": false, "description": "税率" },
+      { "name": "FDELIVERYDATE", "type": "datetime", "nullable": true, "description": "交货日期" },
+      { "name": "FWAREHOUSEID", "type": "bigint", "nullable": true, "description": "收货仓库ID" },
+      { "name": "FDESCRIPTION", "type": "varchar(500)", "nullable": true, "description": "备注" }
+    ],
+    "relatedTables": [
+      { "table": "T_PUR_POORDER", "relation": "FID", "description": "采购订单主表" },
+      { "table": "T_BD_MATERIAL", "relation": "FMATERIALID", "description": "物料表" }
+    ]
+  },
+  "T_SAL_ORDER": {
+    "name": "销售订单表",
+    "module": "销售管理",
+    "description": "销售订单主表，记录销售订单的基本信息",
+    "fields": [
+      { "name": "FID", "type": "bigint", "nullable": false, "description": "主键ID" },
+      { "name": "FBILLNO", "type": "varchar(50)", "nullable": false, "description": "单据编号" },
+      { "name": "FDATE", "type": "datetime", "nullable": false, "description": "单据日期" },
+      { "name": "FDOCUMENTSTATUS", "type": "char(1)", "nullable": false, "description": "单据状态：A=暂存,B=已提交,C=已审核" },
+      { "name": "FCUSTID", "type": "bigint", "nullable": false, "description": "客户ID" },
+      { "name": "FSALEORGID", "type": "bigint", "nullable": false, "description": "销售组织ID" },
+      { "name": "FSALEDEPTID", "type": "bigint", "nullable": true, "description": "销售部门ID" },
+      { "name": "FSALEERID", "type": "bigint", "nullable": true, "description": "销售员ID" },
+      { "name": "FCURRENCYID", "type": "bigint", "nullable": false, "description": "币种ID" },
+      { "name": "FEXCHANGERATE", "type": "decimal(18,6)", "nullable": false, "description": "汇率" },
+      { "name": "FTOTALAMOUNT", "type": "decimal(18,2)", "nullable": false, "description": "价税合计" },
+      { "name": "FDESCRIPTION", "type": "varchar(500)", "nullable": true, "description": "备注" }
+    ],
+    "relatedTables": [
+      { "table": "T_SAL_ORDERENTRY", "relation": "FID", "description": "销售订单明细" }
+    ]
+  },
+  "T_STK_INVENTORY": {
+    "name": "库存余额表",
+    "module": "库存管理",
+    "description": "库存余额表，记录各仓库的物料库存数量",
+    "fields": [
+      { "name": "FID", "type": "bigint", "nullable": false, "description": "主键ID" },
+      { "name": "FSTOCKID", "type": "bigint", "nullable": false, "description": "仓库ID" },
+      { "name": "FMATERIALID", "type": "bigint", "nullable": false, "description": "物料ID" },
+      { "name": "FLOT", "type": "varchar(50)", "nullable": true, "description": "批号" },
+      { "name": "FQTY", "type": "decimal(18,6)", "nullable": false, "description": "库存数量" },
+      { "name": "FBASEQTY", "type": "decimal(18,6)", "nullable": false, "description": "基本单位数量" },
+      { "name": "FSECQTY", "type": "decimal(18,6)", "nullable": true, "description": "辅助单位数量" },
+      { "name": "FAMOUNT", "type": "decimal(18,2)", "nullable": false, "description": "库存金额" },
+      { "name": "FPRICE", "type": "decimal(18,6)", "nullable": false, "description": "库存单价" }
+    ],
+    "relatedTables": [
+      { "table": "T_BD_MATERIAL", "relation": "FMATERIALID", "description": "物料表" },
+      { "table": "T_BD_STOCK", "relation": "FSTOCKID", "description": "仓库表" }
+    ]
+  },
+  "T_BD_MATERIAL": {
+    "name": "物料表",
+    "module": "基础资料",
+    "description": "物料主数据，记录物料的基本信息",
+    "fields": [
+      { "name": "FID", "type": "bigint", "nullable": false, "description": "主键ID" },
+      { "name": "FNUMBER", "type": "varchar(50)", "nullable": false, "description": "物料编码" },
+      { "name": "FNAME", "type": "varchar(200)", "nullable": false, "description": "物料名称" },
+      { "name": "FSPECIFICATION", "type": "varchar(500)", "nullable": true, "description": "规格型号" },
+      { "name": "FBASEUNITID", "type": "bigint", "nullable": false, "description": "基本单位ID" },
+      { "name": "FGROUPID", "type": "bigint", "nullable": false, "description": "物料分组ID" },
+      { "name": "FENABLESTATUS", "type": "char(1)", "nullable": false, "description": "启用状态：A=启用,B=禁用" },
+      { "name": "FDESCRIPTION", "type": "varchar(500)", "nullable": true, "description": "备注" }
+    ],
+    "relatedTables": [
+      { "table": "T_BD_UNIT", "relation": "FBASEUNITID", "description": "计量单位表" }
+    ]
+  },
+  "T_BD_SUPPLIER": {
+    "name": "供应商表",
+    "module": "基础资料",
+    "description": "供应商主数据，记录供应商的基本信息",
+    "fields": [
+      { "name": "FID", "type": "bigint", "nullable": false, "description": "主键ID" },
+      { "name": "FNUMBER", "type": "varchar(50)", "nullable": false, "description": "供应商编码" },
+      { "name": "FNAME", "type": "varchar(200)", "nullable": false, "description": "供应商名称" },
+      { "name": "FSHORTNAME", "type": "varchar(100)", "nullable": true, "description": "简称" },
+      { "name": "FTYPE", "type": "char(1)", "nullable": false, "description": "类型：1=普通供应商,2=内部供应商" },
+      { "name": "FENABLESTATUS", "type": "char(1)", "nullable": false, "description": "启用状态：A=启用,B=禁用" }
+    ],
+    "relatedTables": []
+  },
+  "T_BD_CUSTOMER": {
+    "name": "客户表",
+    "module": "基础资料",
+    "description": "客户主数据，记录客户的基本信息",
+    "fields": [
+      { "name": "FID", "type": "bigint", "nullable": false, "description": "主键ID" },
+      { "name": "FNUMBER", "type": "varchar(50)", "nullable": false, "description": "客户编码" },
+      { "name": "FNAME", "type": "varchar(200)", "nullable": false, "description": "客户名称" },
+      { "name": "FSHORTNAME", "type": "varchar(100)", "nullable": true, "description": "简称" },
+      { "name": "FTYPE", "type": "char(1)", "nullable": false, "description": "类型：1=普通客户,2=内部客户" },
+      { "name": "FENABLESTATUS", "type": "char(1)", "nullable": false, "description": "启用状态：A=启用,B=禁用" }
+    ],
+    "relatedTables": []
+  },
+  "T_BD_STOCK": {
+    "name": "仓库表",
+    "module": "基础资料",
+    "description": "仓库主数据，记录仓库的基本信息",
+    "fields": [
+      { "name": "FID", "type": "bigint", "nullable": false, "description": "主键ID" },
+      { "name": "FNUMBER", "type": "varchar(50)", "nullable": false, "description": "仓库编码" },
+      { "name": "FNAME", "type": "varchar(200)", "nullable": false, "description": "仓库名称" },
+      { "name": "FSTOCKORGID", "type": "bigint", "nullable": false, "description": "库存组织ID" },
+      { "name": "FENABLESTATUS", "type": "char(1)", "nullable": false, "description": "启用状态：A=启用,B=禁用" }
+    ],
+    "relatedTables": []
+  }
+}

package/knowledge/flagship/api-reference.md

@@ -0,0 +1,237 @@
+# 金蝶云星空旗舰版 Java API 参考
+
+## 核心服务类
+
+### BusinessDataServiceHelper
+
+业务数据服务助手，是最常用的数据访问类。
+
+**常用方法：**
+
+```java
+// 加载单个数据实体
+DynamicObject loadSingle(AppContext ctx, Object pkValue, String entityName)
+
+// 加载多个数据实体
+DynamicObject[] load(AppContext ctx, Object[] pkValues, String entityName)
+
+// 按条件查询
+DynamicObject[] load(AppContext ctx, String entityName, QFilter[] filters)
+
+// 按条件查询指定字段
+DynamicObject[] load(AppContext ctx, String entityName, String selectFields, QFilter[] filters)
+
+// 加载基础资料
+DynamicObject loadSingle(AppContext ctx, String entityName, Object pkValue, QFilter[] filters)
+```
+
+**使用示例：**
+
+```java
+// 加载采购订单
+QFilter filter = new QFilter("billno", "=", "PO-001");
+DynamicObject[] orders = BusinessDataServiceHelper.load(
+    ctx, 
+    "PUR_POOrder", 
+    new QFilter[]{filter}
+);
+
+if (orders.length > 0) {
+    DynamicObject order = orders[0];
+    String billNo = order.getString("billno");
+    BigDecimal totalAmount = order.getBigDecimal("totalamount");
+}
+```
+
+### DBRoute
+
+数据库路由，用于执行 SQL 查询。
+
+**常用方法：**
+
+```java
+// 执行查询，返回 DataSet
+DataSet queryDataSet(String routeName, String sql)
+
+// 执行查询带参数
+DataSet queryDataSet(String routeName, String sql, Object[] params)
+
+// 执行更新
+int execute(String routeName, String sql)
+
+// 执行更新带参数
+int execute(String routeName, String sql, Object[] params)
+```
+
+**使用示例：**
+
+```java
+// 查询采购订单
+String sql = "SELECT FBILLNO, FDATE, FAMOUNT FROM T_PUR_POORDER WHERE FDOCUMENTSTATUS = 'C'";
+DataSet ds = DBRoute.queryDataSet("default", sql);
+
+while (ds.next()) {
+    String billNo = ds.getString("FBILLNO");
+    Date date = ds.getDate("FDATE");
+    BigDecimal amount = ds.getBigDecimal("FAMOUNT");
+}
+```
+
+### DataAccess
+
+数据访问层，提供 ORM 功能。
+
+**常用方法：**
+
+```java
+// 执行查询
+DataSet executeDataSet(String sql)
+
+// 执行更新
+int executeUpdate(String sql)
+
+// 批量插入
+void insertBatch(String tableName, DataSet data)
+```
+
+---
+
+## 插件基类
+
+### AbstractBillPlugIn
+
+表单插件基类，用于表单事件处理。
+
+**常用事件：**
+
+```java
+// 表单加载后
+public void afterLoadData(EventObject e)
+
+// 字段值变更后
+public void afterPropertyChanged(PropertyChangedArgs e)
+
+// 保存前
+public void beforeSave(BeforeSaveEventArgs e)
+
+// 保存后
+public void afterSave(EventObject e)
+
+// 提交前
+public void beforeSubmit(BeforeSubmitEventArgs e)
+
+// 审核前
+public void beforeAudit(BeforeAuditEventArgs e)
+```
+
+### AbstractOperatePlugin
+
+操作插件基类，用于操作事件处理。
+
+**常用事件：**
+
+```java
+// 操作执行前
+public void beforeExecuteOperationTransaction(BeforeExecuteOperationTransactionArgs e)
+
+// 操作执行后
+public void afterExecuteOperationTransaction(AfterExecuteOperationTransactionArgs e)
+
+// 校验操作
+public void onGetValidateRules(GetValidateRulesEventArgs e)
+```
+
+### AbstractValidatePlugin
+
+校验插件基类，用于数据校验。
+
+**常用方法：**
+
+```java
+// 自定义校验规则
+public void onGetValidateRules(GetValidateRulesEventArgs e)
+
+// 校验数据
+public void validate(ValidateEventArgs e)
+```
+
+---
+
+## 常用工具类
+
+### StringUtils
+
+字符串处理工具。
+
+```java
+// 判断是否为空
+boolean isEmpty(String str)
+
+// 判断是否不为空
+boolean isNotEmpty(String str)
+
+// 去除空格
+String trim(String str)
+```
+
+### NumberUtils
+
+数字处理工具。
+
+```java
+// 判断是否为零
+boolean isZero(BigDecimal value)
+
+// 比较大小
+int compareTo(BigDecimal v1, BigDecimal v2)
+
+// 格式化数字
+String formatNumber(BigDecimal value, int scale)
+```
+
+### DateUtils
+
+日期处理工具。
+
+```java
+// 获取当前日期
+Date getNow()
+
+// 格式化日期
+String formatDate(Date date, String pattern)
+
+// 解析日期
+Date parseDate(String dateStr, String pattern)
+```
+
+---
+
+## 异常处理
+
+### KDException
+
+金蝶自定义异常。
+
+```java
+// 抛出异常
+throw new KDException("错误编码", "错误信息");
+
+// 带原因的异常
+throw new KDException("错误编码", "错误信息", cause);
+```
+
+### 异常处理最佳实践
+
+```java
+try {
+    // 业务逻辑
+} catch (KDException e) {
+    // 金蝶业务异常
+    logger.error("业务处理失败: " + e.getMessage(), e);
+    throw e;
+} catch (Exception e) {
+    // 其他异常
+    logger.error("系统异常: " + e.getMessage(), e);
+    throw new KDException("SYS001", "系统异常，请联系管理员", e);
+}
+```

package/knowledge/flagship/code-patterns.md

@@ -0,0 +1,246 @@
+# 金蝶云星空旗舰版 Java 代码模式
+
+## 数据访问模式
+
+### 模式一：BusinessDataServiceHelper 查询
+
+**适用场景：** 按主键或条件查询单个/多个实体
+
+```java
+// 按主键查询
+DynamicObject entity = BusinessDataServiceHelper.loadSingle(
+    ctx, 
+    primaryKey, 
+    "PUR_POOrder"
+);
+
+// 按条件查询
+QFilter filter = new QFilter("billno", "=", "PO-001");
+DynamicObject[] entities = BusinessDataServiceHelper.load(
+    ctx, 
+    "PUR_POOrder", 
+    new QFilter[]{filter}
+);
+
+// 查询指定字段
+String[] selectFields = new String[]{"id", "billno", "date", "amount"};
+DynamicObject[] entities = BusinessDataServiceHelper.load(
+    ctx, 
+    "PUR_POOrder", 
+    selectFields, 
+    new QFilter[]{filter}
+);
+```
+
+### 模式二：DBRoute SQL 查询
+
+**适用场景：** 复杂查询、报表查询、跨表查询
+
+```java
+// 简单查询
+String sql = "SELECT FBILLNO, FDATE, FAMOUNT FROM T_PUR_POORDER WHERE FDOCUMENTSTATUS = 'C'";
+DataSet ds = DBRoute.queryDataSet("default", sql);
+
+// 带参数查询
+String sql = "SELECT * FROM T_PUR_POORDER WHERE FDATE >= ? AND FDATE <= ?";
+DataSet ds = DBRoute.queryDataSet("default", sql, new Object[]{startDate, endDate});
+
+// 聚合查询
+String sql = "SELECT FSUPPLIERID, SUM(FAMOUNT) AS TOTAL FROM T_PUR_POORDER GROUP BY FSUPPLIERID";
+DataSet ds = DBRoute.queryDataSet("default", sql);
+```
+
+### 模式三：ORM 查询
+
+**适用场景：** 需要类型安全的查询
+
+```java
+// 使用 DataAccess
+DataAccess da = new DataAccess(ctx);
+DataSet ds = da.executeDataSet("SELECT * FROM T_PUR_POORDER WHERE FID = ?", new Object[]{id});
+```
+
+---
+
+## 事务处理模式
+
+### 事务内操作
+
+```java
+// 开始事务
+DBRoute.beginTransaction();
+try {
+    // 业务操作
+    DBRoute.execute("default", sql1);
+    DBRoute.execute("default", sql2);
+    
+    // 提交事务
+    DBRoute.commitTransaction();
+} catch (Exception e) {
+    // 回滚事务
+    DBRoute.rollbackTransaction();
+    throw e;
+}
+```
+
+### 使用 try-with-resources
+
+```java
+try (TransactionScope scope = new TransactionScope()) {
+    // 业务操作
+    DBRoute.execute("default", sql1);
+    DBRoute.execute("default", sql2);
+    
+    scope.complete();
+}
+```
+
+---
+
+## 异常处理模式
+
+### 业务异常处理
+
+```java
+public void processOrder(DynamicObject order) {
+    try {
+        // 业务逻辑
+        validateOrder(order);
+        saveOrder(order);
+    } catch (KDException e) {
+        // 业务异常，记录日志并抛出
+        logger.error("处理订单失败: " + e.getMessage(), e);
+        throw e;
+    } catch (Exception e) {
+        // 其他异常，包装为业务异常
+        logger.error("系统异常: " + e.getMessage(), e);
+        throw new KDException("SYS001", "系统异常，请联系管理员", e);
+    }
+}
+```
+
+### 校验异常处理
+
+```java
+public void validateOrder(DynamicObject order) {
+    List<String> errors = new ArrayList<>();
+    
+    // 校验必填字段
+    if (StringUtils.isEmpty(order.getString("billno"))) {
+        errors.add("单据编号不能为空");
+    }
+    
+    // 校验业务规则
+    BigDecimal amount = order.getBigDecimal("amount");
+    if (amount.compareTo(BigDecimal.ZERO) <= 0) {
+        errors.add("金额必须大于零");
+    }
+    
+    // 抛出校验异常
+    if (!errors.isEmpty()) {
+        throw new KDException("VALIDATE001", String.join("; ", errors));
+    }
+}
+```
+
+---
+
+## 日志记录模式
+
+### 使用 Logger
+
+```java
+private static final Logger logger = Logger.getLogger(OrderPlugin.class);
+
+// 记录信息
+logger.info("开始处理订单: " + billNo);
+
+// 记录警告
+logger.warn("订单金额较大: " + amount);
+
+// 记录错误
+logger.error("处理订单失败", exception);
+
+// 调试日志
+if (logger.isDebugEnabled()) {
+    logger.debug("订单详情: " + order.toString());
+}
+```
+
+---
+
+## 批量处理模式
+
+### 批量查询
+
+```java
+// 分批查询大量数据
+int batchSize = 1000;
+int offset = 0;
+List<DynamicObject> allResults = new ArrayList<>();
+
+while (true) {
+    String sql = String.format(
+        "SELECT * FROM T_PUR_POORDER ORDER BY FID OFFSET %d ROWS FETCH NEXT %d ROWS ONLY",
+        offset, batchSize
+    );
+    DataSet ds = DBRoute.queryDataSet("default", sql);
+    
+    if (ds.getRowCount() == 0) break;
+    
+    while (ds.next()) {
+        // 处理每行数据
+        allResults.add(convertToEntity(ds));
+    }
+    
+    offset += batchSize;
+}
+```
+
+### 批量更新
+
+```java
+// 使用事务批量更新
+DBRoute.beginTransaction();
+try {
+    for (DynamicObject entity : entities) {
+        String sql = "UPDATE T_PUR_POORDER SET FSTATUS = ? WHERE FID = ?";
+        DBRoute.execute("default", sql, new Object[]{"C", entity.getLong("id")});
+    }
+    DBRoute.commitTransaction();
+} catch (Exception e) {
+    DBRoute.rollbackTransaction();
+    throw e;
+}
+```
+
+---
+
+## 缓存使用模式
+
+### 基础资料缓存
+
+```java
+// 使用缓存加载基础资料
+DynamicObject supplier = BusinessDataServiceHelper.loadSingle(
+    ctx, 
+    supplierId, 
+    "BD_Supplier"
+);
+
+// 缓存会自动管理，无需手动清理
+```
+
+### 自定义缓存
+
+```java
+// 使用 CacheManager
+CacheManager cacheManager = CacheManager.getInstance();
+String cacheKey = "supplier_" + supplierId;
+
+DynamicObject supplier = (DynamicObject) cacheManager.get(cacheKey);
+if (supplier == null) {
+    supplier = BusinessDataServiceHelper.loadSingle(ctx, supplierId, "BD_Supplier");
+    cacheManager.put(cacheKey, supplier, 300); // 缓存5分钟
+}
+```

package/knowledge/flagship/cosmic-platform-note.md

@@ -0,0 +1,15 @@
+# Xingkong Flagship Cosmic Platform Note
+
+Xingkong Flagship is a Cosmic-family product. Load Cosmic platform knowledge first, then apply flagship-specific project knowledge.
+
+## Default Stack
+
+- Platform: Cosmic.
+- Language: Java.
+- Main concerns: plugin lifecycle, metadata verification, SDK signature verification, transaction boundaries, performance review.
+
+## Harness Rules
+
+- Do not route Xingkong Flagship to enterprise C# rules.
+- Do not treat `flagship` as a non-Cosmic Java BOS stack unless the project explicitly proves it is a legacy product outside Xingkong Flagship.
+- Use Cosmic plugin and KSQL rules for new development.