webapp-starter/.roo/rules/04-api.md

接口定义规范

1. DTO定义

   • 必须包含description字段说明用途
   • 必须包含example字段提供示例值
   • 示例:

     export const CreateUserDto = z.object({
       username: z.string().min(3).max(20).openapi({
          example: 'john_doe',
          description: '用户名, 3-20个字符'
        }),
       password: z.string().min(6).openapi({
          example: 'password123',
          description: '密码, 最少6位'
       })
     })
     

2. API响应

   • 统一的API响应格式
   • 完善的Swagger文档