notes/work/移动杭研/AI 项目/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

本文件用于指导 Claude Code（claude.ai/code）在此仓库中开展工作。

技术栈

• Java：21（<java.version>）
• 后端框架：Spring Boot 4.0.5
• 后端框架：Spring Ai 1.1.4

开发规范

如果涉及改动对外提供的 RESTful API 需对 docs/API-概览.md 及对应模块文档进行及时更新。

开发 MCP 相关功能需要遵守 docs/MCP-协议说明.md。

日志和注释

• 日志和注释使用中文
• 关键位置须有日志，日志级别仅需要 info 和 error 两个级别
• public 方法必须提供注释说明，关键位置也可以适量增加注释说明

测试规范（强约束）

• 新增功能、修复问题、修改业务行为：必须新增/更新对应的测试用例（优先单元测试），覆盖核心规则与边界条件
• 修复 Bug：必须提供回归测试（修复前失败、修复后通过）
• 纯代码格式/注释调整：可以不新增测试，但必须确保现有测试全部通过
• 必要时才写集成测试（如持久化/序列化/校验）：控制数量，避免把所有测试都写成 @SpringBootTest
• 提交前必须在仓库根目录运行 mvn test 并确保全部通过；测试未通过禁止提交