# Discuz-Q-OpenSource **Repository Path**: Discuz/discuz-q-open-source ## Basic Information - **Project Name**: Discuz-Q-OpenSource - **Description**: Discuz Q项目当前已全面开源，并已组织开源社区。本项目将对开源项目及事项、项目推进、参与贡献提供相关的说明、介绍和记录。 - **Primary Language**: 其他 - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 32 - **Forks**: 11 - **Created**: 2022-02-26 - **Last Updated**: 2023-11-28 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Discuz-Q-OpenSource ## 开源声明 各位关注 Discuz！Q 的站长、开发者们大家好，我们是当前 Discuz！Q 的开源主持团队，在过去的一段时间里，我们基于 Discuz！Q 共同探索了移动互联网的私域流量新玩法。Discuz！Q 的目标是帮助流量大V、网红、知识付费、微信生态和移动互联网的创业者们，更轻易的完成用户沉淀和转化付费。很高兴看到不乏站长借助我们的平台获得盈利，建立起自己的私域流量池。在这段时间里也收到了非常多真诚有效的建议和关心，在此感谢所有人长期以来对 Discuz！Q 的关注，以及陪伴 Discuz！Q 成长！ 目前Discuz！Q项目已经转向完全开源，并将由开源社区进行后续维护。项目基于 Apache 2.0 协议进行开源。在项目开源的基础上，人人都可以贡献自己的力量，为项目提供开发支持、设计支持、美工支持、运营支持。 为了更好地管理项目，协助开源社区可以有效的运转起来，我们成立了开源委员会，当前在委员会中有原Discuz！Q开发人员及社区积极人员参与，当然，也会持续吸纳更多有意愿的同伴加入到委员会中。 开源社区、开源项目的参与，不是需要一定在委员会中才可以进行的。委员会作为协作者，更多的是服务广大的开源项目参与方，为大家做好参与项目的各项准备和方法。只要是有想法、能提供力量的参与者，均可以加入到开源社区中，共同进一步建设 Discuz-Q 项目，一起推动Discuz-Q更好地发展。 ## 项目推进方案 开源项目依赖开发者的持续贡献，而项目推进需要有一定的方式。因此， Discuz！Q 项目的持续推进方案，也将随着开源社区的建设、开源开发者的投入而持续发展、迭代。 目前 Discuz！Q 项目整体依托于 Gitee 平台，且具有产品论坛 [discuz.chat](http://www.discuz.chat) 。因此，项目的进一步推进也将同样基于 Gitee 平台及产品论坛来展开。 项目的推进方案，需要覆盖包括 issue 的提出、跟踪、开发、解决、合并版本、发版等多个开发相关步骤或事项，也要包括产品活动、社区运营、设计等多种更多围绕产品相关的步骤或事项。 所有这些事项，我们将持续明确方案、推进步骤，并不断回顾方案的有效性。 针对开源项目的各种说明，可以参考如下说明： ### 我发现了系统、代码的问题，如何反馈 在使用DzQ的过程中，如果你发现了系统的问题、bug、异常，欢迎你向我们进行反馈。目前提供的主要反馈方式为，通过向项目提交 issue 来记录问题，以便我们进一步跟踪。 提交 issue 的方法可以见说明，或者通过点击这里[向Diszuc-Q项目提交 issue](https://gitee.com/Discuz/Discuz-Q/issues/new)直接进入到提交页面。 * [登录gitee](https://gitee.com/) * 找到 Discuz-Q 项目：https://gitee.com/Discuz/Discuz-Q * 进入项目后，在上方切换到 Issue 栏目 * 通过右上角的 [新建 Issue](https://gitee.com/Discuz/Discuz-Q/issues/new) 按钮来创建提交新的 issue #### Issue 提交注意事项 **在哪个项目上提交 issue ?** 如果能识别问题出现在哪里，例如是后端（Discuz-Q）、前端（Discuz-FE）、管理后台（Discuz-FE-Admin）、 开发框架（Discuz-Q-Framework）、升级程序（Discuz-Q-Update），可以到指定项目中去提交 issue，这样便于开发者更快的识别问题所在，并进行后续的更新修复。 如果难以识别问题，可以在主项目（Discuz-Q）中提交 issue。 **提交 issue 需要包含哪些内容？** 越完整的描述，越便于发现问题所在，所以在提交 issue 时，建议包含足够多的消息，以免后续需要持续的确认更多信息。 提交时建议包含的内容如下，可以进一步基于这些内容有更丰富的描述： * 出问题的各系统版本 * 部署的环境，例如操作系统、语言版本、数据库型号及版本等 * 部署的方案，例如云虚拟机、容器、网络情况、数据库情况 * 出现问题时的使用流程 * 问题现象和期望情况，偏差在哪里，如果有现象的截图会更好 **我的问题是否解决或如何解决？** 在提交 issue 后，可以跟踪查看 issue 了解相关解决进度或情况，或在当前 issue 内进行进一步的沟通讨论。如果有相关的修复提交，也将会和此 issue 关联，可以看到修复的情况以及后续的版本发布、系统升级关联。 ### 我可以协助进行开发、贡献，该如何进行 感谢你可以协助 DzQ 项目继续往前发展，你的贡献都是项目进一步提升的来源。 目前 DzQ 项目采用 Fork + Pull Request的方案进行协同工作，对于 Fork + Pull Request 模式和协助方法，可以见 [Gitee的官方说明](https://gitee.com/help/articles/4128) 。采用这种模式，将便于所有的开发者可以进行项目协同。 在向 DzQ 项目提交 PR 时，建议将 PR 提交到源项目的 dev 分支中，通过 dev 分支，可以发起进一步的功能、问题解决的验证，并在验证成功后进一步合并至 master 分支。 在向 DzQ 项目提交 PR 时，也建议将 PR 和 issue 进行关联绑定，绑定方法也可以见 [Gitee 的官方指导](https://gitee.com/help/articles/4142) 。关联 issue 也便于追踪功能、问题的解决。