更新 llms-full.txt

llms-full.txt

@@ -42,11 +42,11 @@
     * **唯一标识符位置：** 其对应的唯一标志在类注解@AutoGenerated中指定 ,uuid规则: ${Enum在TOCO中的uuid}|ENUM|DEFINITION
     - **生成代码：** Enum会在common层生成Enum文件，如StatusEnum
     - **修改建议：** 不建议修改
-#### **2.3 值对象 (Eo)**
+#### **2.3 值对象 (EO)**
 - **定义与用途:** EO为一种POJO对象结构，可被其他模块使用，可被用来做为实体字段的类型。
 - **关键属性/配置:** 名称(以_eo结尾,全局唯一)。EO的字段类型只能为基本类型（含List）、EO、Enum，其他类型不允许。
-- **与其他元素关系:** 可以作为其他对象（Entity、Dto、Vo、Bto、Qto)的字段类型使用，同时一个Eo中可以嵌套其他EO作为字段类型。
-- **Eo设计元素的表达:**
+- **与其他元素关系:** 可以作为其他对象（Entity、Dto、Vo、Bto、Qto)的字段类型使用，同时一个EO中可以嵌套其他EO作为字段类型。
+- **EO设计元素的表达:**
     - 以Json格式表达，Json Schema定义及如下
   ```json
   {
@@ -57,7 +57,7 @@
           "uuid":{ "type": "string", "description": "该设计在TOCO中的唯一标识符，在创建EO的时候，该字段为空; 在更新时，该字段不能为空"},
           "moduleName":{ "type": "string", "description": "指定该设计元素所属的模块，在创建的时候该字段不能为空，在更新的时候，该字段可以为空"},
           "fieldList":{
-              "type":"array", "description": "定义Eo的属性字段列表",
+              "type":"array", "description": "定义EO的属性字段列表",
               "items":{ 
                 "type": "object",
                 "properties":{
@@ -1154,7 +1154,7 @@ DateTime endTime； //会议结束时间
 
 ####  **2.12 业务变更传输对象(BTO)**
 - **定义与用途:** 在TOCO中，BTO为写方案自动生成的参数结构，每个写方案会生成一个BTO。BTO为写方案选定的操作实体根据关系形成的树形集合，最外层为聚合根。写方案调用方按照BTO的结构向写方案生成的RPC方法传入需要操作的实体字段值，完成对数据库的写操作
-- **如何创建/生成:** 在创建写方案后，TOCO会自动生成一个BTO作为该写方案传入的参数结构，无需通过TOCO创建。
+- **如何创建/生成:** BTO只能由写方案自动创建，不能单独新建任何BTO。在创建写方案后，TOCO会自动生成一个BTO作为该写方案传入的参数结构。
 - **关键配置:**  名称（${WritePlanName}Bto，驼峰展示），嵌套的树形实体和字段列表，BTO内部的字段全部都来自Entity。以下为一个示例：
 ```
   class CreateUserBto {    //对应实体user
@@ -1168,8 +1168,8 @@ DateTime endTime； //会议结束时间
 ```
 - **与API的关系:** BTO通常可作为API的参数，API接收到参数后可直接透传给内部的RPC进行调用，注意BTO只用作写操作的参数，**禁止用作查询参数结构**
 - **复杂场景处理：** 对于涉及多个写方案的复杂API，可以：
-  a. 如果接口有一个主要的写场景，则创建一个主要的写方案，让其自动生成的BTO作为API入参，然后再增加其他基本类型的参数或EO
-  b. 使用基本类型参数或EO，在接口执行流程中将基本类型参数转换为各个写方案自动生成的BTO
+  a. 如果接口有一个主要的写场景，则创建一个主要的写方案，让其自动生成的BTO作为API参数，然后再增加其他基本类型的参数或EO
+  b. 使用基本类型参数或EO作为参数，在接口执行流程中将基本类型参数转换为各个写方案自动生成的BTO，再调用多个写方案
   c. 如果流程过于复杂，优先考虑使用基本类型参数或EO
 #### **2.13 服务层方法 (RPC)**
 - **定义与用途:** 在TOCO中，RPC为服务层的方法。RPC按照可见性可以分为两种，一种是公开RPC，可以被其他模块订阅，订阅后可以通过RPC适配器进行调用；另一种是非公开RPC，只能被当前模块调用。非公开RPC可以被公开，从而被其他模块订阅并调用