toco/docs
Archived
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

更新 llms-full.txt

Browse Source
This commit is contained in:
ycl
2025-07-03 09:57:09 +08:00
parent 897ea6aa96
commit bbeb00da51
1 changed files with 3 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
llms-full.txt
View File

@@ -256,8 +256,9 @@
### 4. 本地代码阅读和编写指南 ### 4. 本地代码阅读和编写指南
#### 4.1 代码阅读 #### 4.1 代码阅读
- 根据**设计元素到代码的映射规则及修改建议**，在约读代码的时候，你可以识别出对应的TOCO设计元素，通过工具获取TOCO设计元素信息，辅助理解代码语义，特别是对于ReadPlan，WritePlan的设计元素 - 根据**设计元素到代码的映射规则及修改建议**，在约读代码的时候，你可以识别出对应的TOCO设计元素，通过工具获取TOCO设计元素信息，辅助理解代码语义，特别是对于ReadPlan，WritePlan的设计元素
- 读取类文件时，应该同时读取继承的基类文件（但注意不要去阅读BaseBOService里的代码） - 读取类文件时，应该同时读取继承的基类文件（但注意不要去阅读BaseBOService里的代码），**注意** 读取BO文件的时候，一点要读取基类的文件，避免字段没读全
- 不要去读VoConverter、DtoConverter、 BaseDtoConverter、BaseVoConverter的代码 - 不要去读VoConverter、DtoConverter、 BaseDtoConverter、BaseVoConverter
- 你无需关注BaseBoService里的代码
#### 4.2 代码编写 #### 4.2 代码编写
- 对于校验规则，先判断是否为业务不变性规则，如果是，则将代码写在BO对象的聚合校验函数中即可实现校验功能，不需要在Controller或Service中单独调用校验方法。聚合校验函数中适合做内存中数据的规则校验，不适合做很重的外部存储数据的获取或RPC调用，乐观锁字段由系统维护，无需校验 - 对于校验规则，先判断是否为业务不变性规则，如果是，则将代码写在BO对象的聚合校验函数中即可实现校验功能，不需要在Controller或Service中单独调用校验方法。聚合校验函数中适合做内存中数据的规则校验，不适合做很重的外部存储数据的获取或RPC调用，乐观锁字段由系统维护，无需校验
- 需要着重考虑单一职责原则、复用性，如Controller中更适合做参数校验及简单的不可复用的逻辑分支处理，不适合实现复杂的或通用的业务逻辑 - 需要着重考虑单一职责原则、复用性，如Controller中更适合做参数校验及简单的不可复用的逻辑分支处理，不适合实现复杂的或通用的业务逻辑