完善 DTO 规范：统一 description 标签并添加 AI 助手自动检查指引

- 修复所有 DTO 文件的 description 标签（10 个文件）
  - 枚举字段统一使用中文说明（用户类型、角色类型、权限类型等）
  - 状态字段明确说明 0/1 含义
  - validate 标签与 OpenAPI 标签保持一致

- 在 AGENTS.md 和 CLAUDE.md 添加 DTO 规范章节
  - AI 助手必须执行的 7 项检查清单
  - 常见枚举字段标准值参考
  - 确保未来 AI 助手自动遵循规范

- 创建规范文档
  - docs/code-review-checklist.md（Code Review 检查清单）
  - docs/dto-improvement-summary.md（DTO 改进总结）
  - docs/ai-dto-guidelines-update.md（AI 指引更新说明）

- 重新生成 OpenAPI 文档（375 个 description 标签）

影响：所有 API 字段现在都有清晰的中文说明，前端开发更友好

internal/model/permission_dto.go

@@ -34,11 +34,11 @@ type PermissionListRequest struct {
 	PageSize             int    `json:"page_size" query:"page_size" validate:"omitempty,min=1,max=100" minimum:"1" maximum:"100" description:"每页数量"`
 	PermName             string `json:"perm_name" query:"perm_name" validate:"omitempty,max=50" maxLength:"50" description:"权限名称模糊查询"`
 	PermCode             string `json:"perm_code" query:"perm_code" validate:"omitempty,max=100" maxLength:"100" description:"权限编码模糊查询"`
-	PermType             *int   `json:"perm_type" query:"perm_type" validate:"omitempty,min=1,max=2" minimum:"1" maximum:"2" description:"权限类型"`
-	Platform             string `json:"platform" query:"platform" validate:"omitempty,oneof=all web h5" description:"适用端口"`
+	PermType             *int   `json:"perm_type" query:"perm_type" validate:"omitempty,min=1,max=2" minimum:"1" maximum:"2" description:"权限类型 (1:菜单, 2:按钮)"`
+	Platform             string `json:"platform" query:"platform" validate:"omitempty,oneof=all web h5" description:"适用端口 (all:全部, web:Web后台, h5:H5端)"`
 	AvailableForRoleType *int   `json:"available_for_role_type" query:"available_for_role_type" validate:"omitempty,min=1,max=2" minimum:"1" maximum:"2" description:"可用角色类型 (1:平台角色, 2:客户角色)"`
 	ParentID             *uint  `json:"parent_id" query:"parent_id" description:"父权限ID"`
-	Status               *int   `json:"status" query:"status" validate:"omitempty,min=0,max=1" minimum:"0" maximum:"1" description:"状态"`
+	Status               *int   `json:"status" query:"status" validate:"omitempty,min=0,max=1" minimum:"0" maximum:"1" description:"状态 (0:禁用, 1:启用)"`
 }
 
 // PermissionResponse 权限响应
@@ -46,13 +46,13 @@ type PermissionResponse struct {
 	ID                    uint   `json:"id" description:"权限ID"`
 	PermName              string `json:"perm_name" description:"权限名称"`
 	PermCode              string `json:"perm_code" description:"权限编码"`
-	PermType              int    `json:"perm_type" description:"权限类型"`
-	Platform              string `json:"platform" description:"适用端口"`
-	AvailableForRoleTypes string `json:"available_for_role_types" description:"可用角色类型"`
+	PermType              int    `json:"perm_type" description:"权限类型 (1:菜单, 2:按钮)"`
+	Platform              string `json:"platform" description:"适用端口 (all:全部, web:Web后台, h5:H5端)"`
+	AvailableForRoleTypes string `json:"available_for_role_types" description:"可用角色类型 (1:平台角色, 2:客户角色)"`
 	URL                   string `json:"url,omitempty" description:"请求路径"`
 	ParentID              *uint  `json:"parent_id,omitempty" description:"父权限ID"`
 	Sort                  int    `json:"sort" description:"排序值"`
-	Status                int    `json:"status" description:"状态"`
+	Status                int    `json:"status" description:"状态 (0:禁用, 1:启用)"`
 	Creator               uint   `json:"creator" description:"创建人ID"`
 	Updater               uint   `json:"updater" description:"更新人ID"`
 	CreatedAt             string `json:"created_at" description:"创建时间"`
@@ -72,9 +72,9 @@ type PermissionTreeNode struct {
 	ID                    uint                  `json:"id" description:"权限ID"`
 	PermName              string                `json:"perm_name" description:"权限名称"`
 	PermCode              string                `json:"perm_code" description:"权限编码"`
-	PermType              int                   `json:"perm_type" description:"权限类型"`
-	Platform              string                `json:"platform" description:"适用端口"`
-	AvailableForRoleTypes string                `json:"available_for_role_types" description:"可用角色类型"`
+	PermType              int                   `json:"perm_type" description:"权限类型 (1:菜单, 2:按钮)"`
+	Platform              string                `json:"platform" description:"适用端口 (all:全部, web:Web后台, h5:H5端)"`
+	AvailableForRoleTypes string                `json:"available_for_role_types" description:"可用角色类型 (1:平台角色, 2:客户角色)"`
 	URL                   string                `json:"url,omitempty" description:"请求路径"`
 	Sort                  int                   `json:"sort" description:"排序值"`
 	Children              []*PermissionTreeNode `json:"children,omitempty" description:"子权限列表"`