diff --git "a/zh/ater.web/\347\272\246\345\256\232\345\222\214\350\247\204\350\214\203/RESTful API.md" "b/zh/ater.web/\347\272\246\345\256\232\345\222\214\350\247\204\350\214\203/RESTful API.md" index 9786585..5bd966d 100644 --- "a/zh/ater.web/\347\272\246\345\256\232\345\222\214\350\247\204\350\214\203/RESTful API.md" +++ "b/zh/ater.web/\347\272\246\345\256\232\345\222\214\350\247\204\350\214\203/RESTful API.md" @@ -1,9 +1,14 @@ # 控制器接口设计 +## 优化 + +部分DTO使用Record类型? + +## 接口定义 + 接口以控制器的方式管理,默认生成的控制器包括以下接口: |接口 |路由 |参数说明 |返回|说明| |---------|---------|---------|----------|----------| |获取详情 | GET/{id} |从路由中获取id |DetailDto|| |分页查询 | POST | 参数通过模型绑定 |PageList<ItemDto> | | - diff --git "a/zh/ater.web/\347\272\246\345\256\232\345\222\214\350\247\204\350\214\203/\347\272\246\345\256\232.md" "b/zh/ater.web/\347\272\246\345\256\232\345\222\214\350\247\204\350\214\203/\347\272\246\345\256\232.md" index 6185040..09f10f5 100644 --- "a/zh/ater.web/\347\272\246\345\256\232\345\222\214\350\247\204\350\214\203/\347\272\246\345\256\232.md" +++ "b/zh/ater.web/\347\272\246\345\256\232\345\222\214\350\247\204\350\214\203/\347\272\246\345\256\232.md" @@ -2,13 +2,18 @@ 为了更好的保持一致性和高效性,我们会使用在实践中总结出来的一些约定。 -## 默认偏好 +## 默认约定 - 使用`Guid`作为主键类型 - 使用`DateTimeOffset`类型作为时间格式 - 使用`DateOnly`作为日期格式 - 默认使用软删除 +## 代码风格 + +- 默认生成的Manager都是`sealed`的。 +- + ## EF模型定义 遵循`Entity Framework Core`的官方文档,对模型及关联关系进行定义。