|
|
|
|
@ -1,95 +1,56 @@
|
|
|
|
|
# 反馈/贡献
|
|
|
|
|
# 贡献指南
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
感谢您对 `Furion` 项目的关注和贡献！本指南将指导您如何有效参与到项目中来，共同构建更强大的开源框架。
|
|
|
|
|
|
|
|
|
|
## 💢 特别说明：如果 Issue 没有严格按照模板编写且未提供测试源码下载或 Git 测试仓库地址，则视为无效 `Issue`，将无法得到答复。
|
|
|
|
|
## 错误报告
|
|
|
|
|
|
|
|
|
|
### Furion 版本号
|
|
|
|
|
若您在 `Furion` 中发现了非安全相关的漏洞，请首先在 `Furion` 仓库的 [Issues](https://gitee.com/dotnetchina/Furion/issues) 中搜索以确认该问题尚未被提交。若未找到相似问题，请创建一个新的 Issue，并详尽描述漏洞详情、重现步骤及环境信息。
|
|
|
|
|
|
|
|
|
|
哪个版本号？（升级至最新版后还有问题再反馈）
|
|
|
|
|
## 安全问题处理
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
### .NET SDK 版本号
|
|
|
|
|
对于安全问题的披露，请遵循以下流程：
|
|
|
|
|
|
|
|
|
|
- [ ] .NET5
|
|
|
|
|
- [ ] .NET6
|
|
|
|
|
- [ ] .NET7
|
|
|
|
|
1. **收集信息**：尽可能详细地记录漏洞的描述、影响范围、可能的攻击方法等信息。您可以在报告中提供相关的截图、日志文件等辅助信息。
|
|
|
|
|
2. **联系方式**：请您提供您的联系方式，以便我们与您进行进一步的沟通和反馈。您可以在报告中留下您的电子邮件地址、社交媒体账号或其他可靠的联系方式。
|
|
|
|
|
3. **发送报告**：请将您的安全漏洞报告发送至我们指定的安全邮箱 (monksoul@outlook.com) 或报告渠道（作者微信：ibaiqian）。如果我们有提供特定的报告指南或漏洞报告表格，请您按照指示进行报告。如果没有特定的指引，您可以通过邮件发送报告给我们的安全团队。
|
|
|
|
|
4. **等待回复**：我们将尽快收到您的报告后进行评估，并在确认漏洞的准确性后与您联系。请理解我们可能需要一些时间来进行调查和修复漏洞，我们会及时地与您保持沟通并提供进展更新。
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
## 解决现有问题
|
|
|
|
|
|
|
|
|
|
### 项目类型
|
|
|
|
|
欢迎您浏览仓库的 [Issues](https://gitee.com/dotnetchina/Furion/issues) 列表，挑选并尝试解决其中的问题。一旦解决问题，请提交 Pull Request，并在描述中关联到原始的 Issue 编号。
|
|
|
|
|
|
|
|
|
|
- [ ] WebApi
|
|
|
|
|
- [ ] Mvc
|
|
|
|
|
- [ ] Razor Pages
|
|
|
|
|
- [ ] Blazor Server
|
|
|
|
|
- [ ] MinApp
|
|
|
|
|
- [ ] WinForm
|
|
|
|
|
- [ ] WPF
|
|
|
|
|
- [ ] Console
|
|
|
|
|
## 提出新功能建议
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
我们鼓励通过 [Issues](https://gitee.com/dotnetchina/Furion/issues) 来提议新功能，并使用 "Feature/新特性" 标签标记。另外，也可以通过邮件（请参阅项目文档获取联系方式）向我们发送您的建议。项目团队会在评估后，将确认开发的新功能纳入下一个版本的计划任务列表。
|
|
|
|
|
|
|
|
|
|
### 操作系统和版本
|
|
|
|
|
## 开发环境搭建与测试运行
|
|
|
|
|
|
|
|
|
|
- [ ] Windows（版本号？）
|
|
|
|
|
- [ ] Linux（版本号？）
|
|
|
|
|
- [ ] MacOS（版本号？）
|
|
|
|
|
- [ ] 其他（版本号？）
|
|
|
|
|
从 `git clone https://gitee.com/dotnetchina/Furion.git` 开始，参照我们的 [开发环境配置文档](./DEVELOPMENT_SETUP.md) 设置 IDE 和其他相关环境。运行测试时，请按照 [测试指南](./TESTING_GUIDE.md) 操作。
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
## 变更日志撰写规则
|
|
|
|
|
|
|
|
|
|
### 代码环境
|
|
|
|
|
1. 使用现在时态描述变更。
|
|
|
|
|
2. 首行简洁扼要，字数适中。
|
|
|
|
|
3. 描述变更内容需准确、完整，符合项目的变更日志规范。
|
|
|
|
|
|
|
|
|
|
- [ ] 开发环境（Development）
|
|
|
|
|
- [ ] 生产环境（Production）
|
|
|
|
|
- [ ] 测试环境（Tests/单元测试/集成测试 ）
|
|
|
|
|
## 编码约定
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
遵循项目内的编码约定，具体见 [`.editorconfig`](https://gitee.com/dotnetchina/Furion/blob/v4/framework/.editorconfig) 文件。
|
|
|
|
|
|
|
|
|
|
### 描述你的问题
|
|
|
|
|
## 分支管理约定
|
|
|
|
|
|
|
|
|
|
发生了什么？
|
|
|
|
|
我们采用 [GitFlow](https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow) 分支管理模式进行开发，详细规定见 [分支管理文档](./BRANCH_MANAGEMENT.md)。
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
### 异常堆栈信息
|
|
|
|
|
|
|
|
|
|
异常堆栈是什么？
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
## 合并 Pull Request 的流程
|
|
|
|
|
|
|
|
|
|
### 测试项目代码
|
|
|
|
|
当满足以下条件时，您的 Pull Request 可以被合并至 `master/main` 分支：
|
|
|
|
|
|
|
|
|
|
> **⚠⚠ 必须提供完整可运行且包含错误的 `Git` 仓库 DEMO，DEMO 提供最简单的错误逻辑代码，否则将无法得到答复。⚠⚠**
|
|
|
|
|
1. 通过持续集成 (CI) 测试。
|
|
|
|
|
2. 至少获得两位维护者的批准。
|
|
|
|
|
3. 确保与最新版本兼容且无冲突。
|
|
|
|
|
|
|
|
|
|
您的代码下载地址？
|
|
|
|
|
**重要提示**：无论您是修复了 bug 还是改进了功能，我们都强烈建议您将更改同步回上游（即 `Furion` 主仓库）。请在完成工作后通过 Pull Request 或邮件通知我们，我们将迅速进行审核并考虑合并您的改动。
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
### 数据库信息和版本
|
|
|
|
|
|
|
|
|
|
请提供安装的 `NuGet` 包版本号。
|
|
|
|
|
|
|
|
|
|
- [ ] Sqlite（包名和版本号？）
|
|
|
|
|
- [ ] SqlServer（包名和版本号？）
|
|
|
|
|
- [ ] MySQL（包名和版本号？）
|
|
|
|
|
- [ ] Oracle（包名和版本号？）
|
|
|
|
|
- [ ] PostgreSQL（包名和版本号？）
|
|
|
|
|
- [ ] Firebird（包名和版本号？）
|
|
|
|
|
- [ ] Cosmos（包名和版本号？）
|
|
|
|
|
- [ ] InMemoryDatabase（包名和版本号？）
|
|
|
|
|
- [ ] 无
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
### 期待结果
|
|
|
|
|
|
|
|
|
|
期待的结果是？
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
### 确认工单
|
|
|
|
|
|
|
|
|
|
**为了减少不必要的沟通成本和时间成本，请再次确认 `Issue` 已按照要求正确填写，否则将被直接关闭。**
|
|
|
|
|
请尊重并遵守我们的 [行为准则](./CODE_OF_CONDUCT.md)，让我们共同营造一个友善、合作的开源社区氛围。感谢您的每一次贡献，若有任何疑问或需要协助，请随时联系我们。
|
|
|
|
|
|
百小僧
10 months ago