# 项目协作规则

## 基本原则

- 修改代码前先阅读相关文件，遵循现有项目结构、命名和实现风格。
- 保持改动聚焦，只处理当前任务相关内容，不做无关重构。
- 不要覆盖或回滚用户已有改动，除非用户明确要求。
- 不要提交日志、临时文件、构建产物或本地环境配置。

## 运行与构建

- 前端构建优先使用：
  `npm run build`
- 如果需要运行前端开发服务，先查看现有脚本和端口配置，再启动对应命令。
- 如果需要运行后端服务或测试，先查看后端目录中的 Maven/Gradle 配置，再选择合适命令。
- 运行命令失败时，需要说明失败原因和已尝试的验证方式。

## 修改限制

- 不要修改以下本地配置文件，除非用户明确要求：
  `code/backend/src/main/resources/application-dev.yml`
- 不要提交以下内容：
  `code/backend/logs/**`
  `logs/**`
- 涉及用户数据、方案、穴位、经络、调理内容时，要优先保证已有数据兼容性。
- 涉及中医术语、穴位定位和方案描述时，要保持表述准确、谨慎。

## 测试与验证

- 前端代码改动后，优先运行：
  `npm run build`
- 后端代码改动后，优先运行相关单元测试或项目已有验证命令。
- 如果改动范围较小且没有合适测试，也需要进行静态检查或说明未运行测试的原因。

## Git 规则

- 不要自动执行 `git push`，除非用户明确要求。
- 不要使用破坏性 Git 命令，例如 `git reset --hard`、`git checkout -- <file>`，除非用户明确要求。
- 提交前检查暂存内容，避免把本地配置、日志或无关文件加入提交。
- 如果用户要求提交，提交信息优先使用中文，并简洁描述本次改动。
- 不要将.cursor文件夹和.idea文件夹提交到git
- Git 仓库: http://git.iwintrue.com/liaoxg/ajy
- 同事分支：liyu_2026_04_07
- 我的分支：jiapu_aijiuyi
- 项目路径(仓库内): code/aijiuyi
- Git 用户名: jiapu
- 分支: jiapu_aijiuyi
- 拉取代码规则：将同事分支的openspec文件夹下的所有文件（不包括openspec目录）同步到我的code目录下。
- git提交日志：在每次提交的时候要询问我，如果我选择空白，则你可以自己总结边写日志
- 提交代码规则：application-dev.yml文件默认不参与git提交。

## 回复要求

- 完成修改后，简要说明改了哪些文件、做了什么验证。
- 如果有未完成事项、测试无法运行或需要用户决策的地方，需要明确说明。
- 语言：和我对话，思考的时候使用中文。

## 项目信息
- 项目名称: aijiuyi
- 可以读取并使用application.yml、application-dev.yml中的datasource属性