DedsiDDD .NET Coding

DedsiDDD + .NET 项目代码生成规范，遵循 DDD/CQRS 架构模式和统一约定。

何时使用

• 在 DedsiDDD + .NET 项目中生成新实体/聚合根

• 创建 CQRS Command/Query 处理器

• 配置 EF Core 映射和 DbContext

• 实现 Repository

• 创建 Controller 和 API 端点

• 定义 DTO 数据传输对象

• 遵循 DedsiDDD 约定进行代码审查

能力规则

没有这些规则，AI 无法解决问题或生成的代码无法正确运行。

领域模型

规则 影响 描述

aggregate-root-patterns.md HIGH 定义聚合根遵循 DedsiDDD 约定

entity-creation-validation.md HIGH 实体创建和验证模式

collection-management.md MEDIUM 集合管理和维护

DTO

规则 影响 描述

dto-conventions.md MEDIUM DTO 命名和结构约定

dto-xml-comments.md MEDIUM DTO XML 文档注释

数据库

规则 影响 描述

dbcontext-configuration.md HIGH DbContext 配置约定

ef-core-mapping.md HIGH EF Core 实体映射

仓储

规则 影响 描述

repository-patterns.md HIGH Repository 实现模式

CQRS

规则 影响 描述

command-handlers.md HIGH Command Handler 实现模式

query-handlers.md HIGH Query Handler 实现模式

pagination-queries.md HIGH 分页查询实现

Controller

规则 影响 描述

controller-patterns.md HIGH Controller 实现模式

通用

规则 影响 描述

cancellation-token.md HIGH CancellationToken 全链路传递

enum-conventions.md MEDIUM 枚举显式赋值约定

file-organization.md MEDIUM 文件组织规范

naming-conventions.md MEDIUM 命名约定

project-structure.md HIGH DDD 分层架构

效率规则

这些规则帮助 AI 更有效、更一致地解决问题。

质量保证

规则 影响 描述

common-pitfalls.md HIGH 常见错误和验收清单

交互协议

冲突优先级

本 SKILL 约定 > 现有仓库约定 > 一般 DDD/CQRS 习惯

澄清问题清单

在生成代码前，必须先澄清以下问题：

• 模块边界：实体属于哪个模块？命名空间与目录？

• 路由风格：Controller 使用 action route 还是资源路由？

• 聚合信息：实体单/复数名、主键类型（默认 string/ULID）、是否聚合根

• 字段清单：字段名/类型/必填/长度/默认值/enum/值对象

• 关系与集合：一对多/多对多、集合唯一性约束、更新策略（增量 vs Clear+Add）

• 数据库映射：表名、Schema、索引/唯一约束、是否软删

• API 契约：需要哪些端点（Get/Paged/Create/Update/Delete/Export）

• 返回结构：是否有统一的 ApiResponse/Result 包装？

缺省策略

• 主键：默认 string ，生成方式 Ulid.NewUlid().ToString()

• 分页：使用 DedsiPagedRequestDto

• 更新集合：默认 Clear + Add

• 导出组件：仅当仓库已存在 MiniExcel 时提供落地代码

交付标准

• 明确的文件清单与落点（Domain/Infrastructure/UseCase/HttpApi）

• 每个文件的代码模板或最小变更补丁

• 所有公开入口包含 CancellationToken 并透传到 EF Core/仓储

• 分页查询顺序：筛选 → Count → 排序 →（非导出则分页）→ 投影 → ToList

• Controller 能编译并能调用 Query/Mediator；Command/Query 返回类型与 Controller 对齐

占位符规则

必须替换的占位符：

• [Project]

• 项目名称

• [Domain]

• 领域实体名称

• [Entities]

• 实体复数形式

• [DbContext]

• DbContext 名称

• [Child]

• 子实体名称

推荐工作流

• 澄清边界与不变式

• 写领域模型（Domain）

• 定义 DTO（Contract）

• 配置 EF Core（DbContext + EntityConfiguration）

• 生成仓储（Repository）

• 实现 Commands（写侧）

• 实现 Queries（读侧）

• 实现 Controller（API 层）

• 一致性检查

参考

• DedsiFramework.md - Dedsi Framework 完整文档

• dedsi-framework - Dedsi Framework 接入指南