用途:定义所有进入系统的数据在信任边界处的校验模式,确保未经校验的数据不跨越信任边界。前端表单用 Zod,后端 API 请求用 Pydantic。
主要能力:Zod 表单模式配合 react-hook-form 与 zodResolver;类型通过 z.infer 推断而非手写;模式组合与 .refine 自定义校验;API 请求发送前校验;澳大利亚专用校验器,包括带校验和的 ABN、澳式电话、4 位邮编、DD/MM/YYYY 日期;Pydantic 请求模型与约束类型(如 Annotated、Field 的 min_length、gt、ge、le);FastAPI 路由集成自动校验;模式位置约定与校验清单;反模式对照表。
使用方式:前端定义 camelCase + Schema 后缀的模式,类型用 PascalCase 的 z.infer;后端定义 PascalCase + 用途后缀的模型,简单模式内联于路由,跨路由共享放 apps/backend/src/api/schemas/,领域模型放 apps/backend/src/models/。校验错误建议使用 error-taxonomy 的 DATA_VALIDATION_* 错误码,示例为 HTTPException 422。响应格式含 AGENT_ACTIVATED、PHASE、STATUS、NEXT_ACTION 字段。
适用场景:创建或修改含用户数据的表单输入、定义 API 请求响应模式、添加前端 Zod 模式、审查缺失输入校验的代码、构建接受 POST/PUT/PATCH 数据的新端点。
限制:不用于实现认证逻辑、设计错误响应格式或数据库模型定义。错误消息应面向用户、使用 en-AU。字段名前后端需一致。上述依赖(Zod、Pydantic、react-hook-form、FastAPI)与具体安装步骤资料未提供。