更新 llms-full.txt

This commit is contained in:
oyo
2025-07-31 10:22:29 +08:00
parent 1b7022466d
commit 479548b334

View File

@@ -1399,13 +1399,7 @@ requestParams为请求参数列表response为返回结构requestParams中
TOC自动生成的类和方法会带有@AutoGenerated注解注解中有2个属性:locked为boolean类型如果locked=true则代表该文件或方法不建议修改;uuid为String类型表示该类或方法的唯一标识如果uuid中包含|字符则说明该uuid为特殊格式由不同类型的数据拼装而成(见**[3.2 设计元素到代码的映射规则及修改建议]**中每种设计元素的代码说明)。
### 4. TOCO 最佳实践
#### 4.1 设计分析结果应用(Design analysis results application):
在TOCO中设计分析(transferToPlanAgent工具)的结果按照用户的要求或需求的复杂度分为2种你需要分辨流程分析的结果类型然后根据不同类型做出不同的后续工具调用规划:
- 1.**细节设计分析**:针对简单或短流程需求,会直接进行读写方案、接口等分析、代码编写等结果。此时需要根据工具规划后续的调用。
- 2.**流程拆解设计分析**:针对复杂需求,不会直接分析细节的设计元素,而是根据内聚、解耦、复用等原则,参考**流程服务Function_Flow)**对业务需求拆解为多个短流程并返回结果。后续需要针对整体的API的定义、流程服务定义、**所有**流程节点中涉及的**所有**DTO、VO、读写方案、RPC等来进行对应的工具调用。注意此时**必须**调用createFunctionFlow工具来创建流程服务。
#### 4.2 为所有的写场景都创建写方案(Create WritePlan For All Write Scenarios):
通常在分析业务需求时,需要分析出**所有**写数据的场景,并按照**聚合维度**进行分组,然后针对每个写场景**都需要**创建对应的写方案,不能有遗漏。写方案可以按需根据聚合进行合并。
#### 4.3 接口参数类型和返回值选择(Interface Parameter & Return Type Definition):
#### 4.1 接口参数类型和返回值选择(Interface Parameter & Return Type Definition):
在做TOCO接口(API、RPC)设计时通常会先判断接口的主要功能是读数据库或写数据库并分析相关的读写方案以及对应的QTO和BTO。如果是读场景则参数会**优先使**用相关的QTO如果是写场景则参数会**优先**使用相关的BTO如果BTO和QTO无法满足要求则可以再增加基本类型或Enum、EO等类型参数。参数类型选择时必须遵循以下要求a.DTO、VO不能作为参数类型b.QTO、BTO不能作为返回值类型。
**重要说明:**
- 本章节描述的是参数选择的**优先级原则**,不是绝对限制