name: form-creator description: 创建表单、验证模式和CRUD API端点。在构建新的数据录入功能或管理现有表单时使用。
表单创建器
使用说明
1. 验证模式
- 文件:
src/lib/validations/{feature}.schema.ts - 操作: 定义Zod模式并导出推断类型。
export const featureSchema = z.object({ ... }); export type FeatureFormValues = z.infer<typeof featureSchema>;
2. 表单组件
- 文件:
src/components/forms/{feature}-form.tsx - 指令: 必须包含
"use client";。 - 设置: 使用
useForm配合zodResolver。 - 属性: 接受
initialData和onSubmit。 - 界面: 使用Shadcn组件(
Form、FormField、Input)。
3. API路由
- 文件:
src/app/api/{feature}/route.ts - 安全性: 使用
withAuthRequired或withSuperAdminAuthRequired包装。 - 逻辑:
GET: 处理分页/搜索。POST: 根据模式验证请求体 -> 插入数据库。PATCH: 验证部分请求体 -> 更新数据库。
参考
有关代码模式、最佳实践和示例,请参阅 reference.md。