47 lines
1.6 KiB
Markdown
47 lines
1.6 KiB
Markdown
|
# 参与贡献 🎉
|
|||
|
|
|
|||
|
|
欢迎任何形式的贡献 —— 代码、文档、Bug 反馈、功能建议。
|
|||
|
|
|
|||
|
|
## 快速链接
|
|||
|
|
|
|||
|
|
- 📖 **完整贡献指南**: [service.fastapiadmin.com/about/contributing](https://service.fastapiadmin.com/about/contributing)
|
|||
|
|
- 🐛 **反馈 Bug**: [GitHub Issues](https://github.com/fastapiadmin/FastapiAdmin/issues) | [Gitee Issues](https://gitee.com/fastapiadmin/FastapiAdmin/issues)
|
|||
|
|
- 💡 **功能建议**: 先提 Issue 讨论，再动手写代码
|
|||
|
|
- 📝 **开发规范**: [代码风格指南](https://service.fastapiadmin.com/guide/guidelines)
|
|||
|
|
- 💬 **社区交流**: 扫码加入微信群（二维码见 [README](./README.md)）
|
|||
|
|
|
|||
|
|
## 开始之前
|
|||
|
|
|
|||
|
|
1. 先搜索现有 [Issues](https://github.com/fastapiadmin/FastapiAdmin/issues)，避免重复提交
|
|||
|
|
2. 较大改动建议先开 Issue 讨论方案
|
|||
|
|
3. 遵循 [提交信息规范](https://service.fastapiadmin.com/guide/guidelines)
|
|||
|
|
|
|||
|
|
## 本地开发环境
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 后端
|
|||
|
|
cd backend && uv sync && uv run main.py run --env=dev
|
|||
|
|
|
|||
|
|
# 前端
|
|||
|
|
cd frontend/web && pnpm install && pnpm run dev
|
|||
|
|
|
|||
|
|
# 文档
|
|||
|
|
cd frontend/docs && pnpm install && pnpm run dev
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Pull Request 流程
|
|||
|
|
|
|||
|
|
1. Fork 仓库，创建功能分支（`feature/xxx` 或 `bugfix/xxx`）
|
|||
|
|
2. 完成修改，使用约定式提交信息
|
|||
|
|
3. 运行检查：`ruff check`（后端）/ `pnpm lint`（前端）
|
|||
|
|
4. 提交 PR 到 **`dev`** 分支
|
|||
|
|
5. 等待审核 —— 我们会尽快回复
|
|||
|
|
|
|||
|
|
## 贡献者协议
|
|||
|
|
|
|||
|
|
提交贡献即表示你同意将代码以项目的 [MIT 协议](./LICENSE) 开源。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
**每一点贡献都很重要 —— 从修复错别字到开发新功能。感谢！❤️**
|