easy-next-admin/CONTRIBUTING.md

贡献指南

感谢你关注 EasyNextAdmin。这个项目面向中文企业后台二次开发，贡献应优先围绕真实后台能力、清晰权限边界和稳定本地部署展开。

开发准备

docker compose up -d
cd easy-next-admin-server
mvn spring-boot:run

cd easy-next-admin-web
npm ci
npm run dev

提交要求

• 后端使用 Java 17、Spring Boot 3、MyBatis-Plus 和 Flyway。
• 前端使用 Vue 3、TypeScript、Vite、Pinia、Vue Router、Axios 和 Element Plus。
• 新页面要同时补齐后端菜单资源、权限码、前端 API wrapper 和基础错误处理。
• 不把规划项写成已完成功能，不引入低代码、BI 或完整 BPM 平台概念。
• 文档只描述当前仓库真实存在、可运行、可验证的能力。

验证命令

修改后端、SQL 或接口契约时，优先运行：

mvn -pl easy-next-admin-server -am verify

修改前端时，至少运行：

cd easy-next-admin-web
npm run test:unit
npm run build

Pull Request

提交 PR 时请说明：

• 变更目的和影响范围。
• 涉及的后端接口、前端页面、菜单权限或数据库迁移。
• 已运行的验证命令和结果。

安全问题不要直接提交公开 Issue 或 PR，请先阅读 安全策略。