用途:按多模型模式创建 Pydantic 模型,使 API 契约更清晰。规范将模型分为 Base(共享字段)、Create(创建请求,字段必填)、Update(更新请求,字段全部可选)、Response(完整 API 响应)、InDB(带 doc_type 的数据库文档)。
主要能力:演示 camelCase 别名映射(如 workspaceId、createdAt),通过 populate_by_name = True 同时接受 snake_case 与 camelCase;展示 PATCH 请求中字段可选并带 Field(None, min_length=1) 约束;展示 InDB 继承 Response 并追加 doc_type 供 Cosmos DB 查询。
使用方式:将内联模式中的类名与字段改成实际 API 契约;选择配置语法前先确认已安装的 Pydantic 版本;片段依赖项目自身的导入与类型,不假设存在独立模板文件。集成时在 src/backend/app/models/ 下创建模型,从 src/backend/app/models/init.py 导出,并补充对应的 TypeScript 类型。
适用场景:需要为后端接口定义请求与响应模型、区分读写模型、或在 Python 与 TypeScript 间保持一致契约时。
限制:仅在任务与上述范围明确匹配时使用;输出不能替代针对具体环境的验证、测试或专家评审;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。其他细节暂未提供。