项目架构、开发规范与测试

核心认识

Coze Studio 是大型前后端项目。开发前先理解模块边界和生成代码流程，后端遵循 Go 与 IDL 规范，前端遵循类型和测试规范，变更要覆盖功能测试。

• 修改前定位应用层、领域层和基础设施层。
• IDL 变更先更新定义再生成客户端与服务端代码。
• 不要手改应由生成器产生的代码。
• 提交前运行相关单测、类型检查和功能验证。

操作方法

1. 阅读官方架构和目标模块。
2. 建立最小复现或失败测试。
3. 实现变更并运行局部测试。
4. 运行全量相关测试并记录验证。

验收与边界

• 能说明本功能的输入、输出和权限边界。
• 能用一个最小示例验证配置生效。
• 真实生产数据和凭据未写入页面、仓库或日志。