# 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` 并确保全部通过；测试未通过禁止提交