本仓库的全部开发指南、常用命令、架构说明与开发规范统一维护在 AGENTS.md 中,请先完整阅读并严格遵循该文件,不要重复维护两份内容。
其中与本仓库协作的关键约定(详见 AGENTS.md):
- 回复语言:所有沟通及文档必须使用中文。
- 双版本线:仓库同时维护 17.x(JDK 17 / Spring Boot 3.x /
jakarta.*)与 8.x(JDK 8 / Spring Boot 2.7.x /javax.*)两条版本线;处理 GitHub issue 必须遵循docs/conventions/workflow/github-issue.md的 worktree + 特性分支流程,不合并版本分支。 - 每次修改代码后必须执行本地编译/测试验证(后端
./mvnw clean test -P travis,前端pnpm test:pc/pnpm test:mobile)。 - 编码前必读:
docs/conventions/index.md(项目规范,最高优先级)与docs/capabilities/index.md(已有能力清单,必须复用、禁止重复实现)。