企业官网建设流程全解析

Ushahidi Platform未来展望：路线图分析与社区贡献指南

【免费下载链接】platformUshahidi Platform API version 3+项目地址: https://gitcode.com/gh_mirrors/platform16/platform

Ushahidi Platform作为一款开源的API平台（版本3+），始终致力于通过社区协作不断优化和扩展其功能。本文将深入解析Ushahidi Platform的未来发展路线图，以及为新手和普通用户提供清晰易懂的社区贡献指南，帮助你快速参与到这个充满活力的开源项目中。

一、Ushahidi Platform路线图解析 🚀

Ushahidi Platform的路线图并非一成不变，而是基于社区反馈、项目需求和资源情况进行动态调整。了解路线图的制定和更新方式，能让你更好地把握项目的发展方向。

1.1 路线图的获取途径

Ushahidi Platform的路线图相关信息可以通过以下方式获取：

• 项目会根据资助项目、客户需求、优先级bug以及社区功能请求，持续滚动更新路线图。随着更开放的路线图规划策略的引入，你将能在公共位置获取近期路线图的汇总信息。
• 带有“consider for upcoming cycle”标签的issues，展示了项目正在考虑加入路线图的下一批功能，你可以通过相关链接进行查看。
• 带有“Stage: In progress”标签的issues，则标识了当前正在开发的功能，具体可查看此链接。

1.2 新功能纳入路线图的流程

一个新的功能或改进要被纳入Ushahidi Platform的路线图，需要经过以下评估过程：

• 由Ushahidi的工程、产品、设计、支持等多个职能部门协作进行评估。
• Ushahidi员工会对新提交的issues进行分类处理。为确保你的功能请求或bug报告能被正确理解和处理，请遵循issue提交指南，项目提供了完整的bug报告和功能请求模板，可在这里找到。
• 在分类和优先级排序过程中，团队可能会对你提交的内容提出后续问题，建议积极回应，以便他们充分了解工作范围和需求。
• 用第一人称简洁描述你面临的问题和需要解决的内容，有助于提高评估效率。

需要注意的是，系统的不同部分在任何时候获得的功能开发资金支持可能不同，这也会影响功能被Ushahidi员工优先开发的时间。例如，当资金用于特定目标（如改进数据分类流程以提高紧急情况下的工作效率）时，团队的重点通常会放在与该目标相关的一系列改进上。

1.3 任务优先级的决策依据

在众多issues中，Ushahidi Platform会根据以下原则来确定任务的优先级：

对于bug：

• 关键程度：是否影响核心功能的正常运行。
• 出现频率：在执行某个功能时，用户遇到该bug的普遍程度。例如，分类相关的问题通常比webhook设置流程中的问题优先级更高，因为分类是更常见的操作。
• 修复所需时间、可用团队以及预算等因素也会被综合考量。

对于功能：

• Ushahidi团队会结合所有成员的意见、他们与用户的互动以及用户测试结果，来确定下一个要在平台中实现的功能。
• 与Ushahidi平台目标的一致性、资源限制以及用户需求是重要的考量因素。项目会优先开展与使命紧密相关的工作，对于超出产品范围或意图的功能，可能会拒绝。例如，虽然日历功能听起来不错，但由于其超出产品范围且团队没有足够资源维护，可能不会从零开始开发，但如果有足够证据表明需要，可能会考虑集成现有日历工具。因此，在请求新功能时，建议说明你要解决的问题，以便共同找到适合Ushahidi Platform范围的解决方案。

1.4 路线图规划的下一步

Ushahidi团队正在努力改进路线图的优先级确定和issue推进流程。下一步将首先在内部讨论路线图决策的参与规则，编写关于新路线图决策结构的初步文档，之后会向社区征求意见。随着工作流程变得更加开放和透明，团队希望听到社区的声音，并在不久的将来开放流程供大家评论。

二、Ushahidi Platform社区贡献指南 🤝

Ushahidi Platform欢迎每一位社区成员的贡献，无论你是新手还是有经验的开发者，都可以通过以下步骤参与到项目中。

2.1 准备工作

2.1.1 创建GitHub账户

首先，你需要创建一个GitHub账户。Ushahidi的代码开发工作在GitHub上进行，前后端的所有任务都在Platform API仓库的issues中进行跟踪。

2.1.2 Fork仓库

Fork是仓库的副本，通过Fork仓库，你可以自由地进行更改实验，而不会影响原始项目。Ushahidi由3个独立的仓库构建而成，根据你要完成的任务，可能需要Fork其中一个或多个仓库，通常至少需要ForkAPI和Client仓库：

• Platform API：平台API的开发所在地。
• Platform Client：平台JS客户端的开发所在地。
• Platform Pattern Library：平台设计、HTML和CSS的开发所在地。

Fork仓库的步骤如下：

1. 点击上述仓库链接。
2. 在页面右上角，点击“Fork”按钮。

这样你就拥有了原始仓库的个人Fork。

2.1.3 Clone Fork到本地

如果你还没有克隆和安装平台代码，可以直接克隆你的Fork：

git clone https://gitcode.com/gh_mirrors/platform16/platform

如果你已经克隆并安装了平台，可以将新的Fork添加为“remote”仓库：

git remote rename origin upstream git remote add origin git@github.com:yourusername/platform.git

克隆仓库时，克隆的URL始终会被创建为“origin”远程仓库。上述命令将“origin”重命名为“upstream”，并创建一个指向你Fork的新“origin”，这样你就可以拉取平台的新版本，同时将自己的分支推送到Fork。

2.2 选择并开始任务

2.2.1 寻找合适的功能任务

选择要开发的功能的最佳方式是通过打开issue向Ushahidi的开发者打招呼，告知他们你想从事的工作（前端、后端等），并讨论适合你的任务。你可以在这里找到如何联系团队的更多信息。

Ushahidi的issues（bug、功能请求等）都在Github Issues中，你可以找到需要做的事情：

• Github中的Community tasks是社区开发者可以参与的功能。
• 其他尚未标记的任务也可能适合开发，如果你打算从事某个吸引你的任务，随时联系团队。

2.2.2 创建功能分支

如果你正在开发一个无人认领的功能，需要创建一个特定于该功能的Ushahidi分支。在终端窗口中，进入你的Ushahidi代码目录，输入：

git checkout master git pull git checkout -b some-task

其中“some-task”是对该任务的简短描述（不含空格），例如“visualise-data”。现在你就可以开始编写代码了。

2.3 编写代码与提交

2.3.1 编写代码

在编写代码时，请确保符合Ushahidi编码标准，如果需要更改CSS，请使用Ushahidi模式库。

如果你遇到困难或想讨论想法，可以联系其他Ushahidi开发者。

2.3.2 提交代码

当你准备好提交代码以供审核时，请执行以下步骤：

1. 提交并推送代码

git add . git commit -m “message about this commit” git push origin some-task

2. 然后，在github上打开你的Fork，即“https://www.github.com/yourusername/platform”。你会看到一个横幅，表明你最近推送了一个新分支，并且可以将该分支“upstream”提交到原始仓库。
3. 点击“Compare and Pull Request”创建拉取请求，输入标题和描述，然后点击“Create pull request”。

为了方便他人审核你的拉取请求，请编写一个测试和评估提交的清单。

你第一次提交代码时，可能会被要求签署Ushahidi的贡献者协议。

Ushahidi管理员会审查并评论你的代码，要么接受你的代码，要么要求你进行更改。如果你被要求更改代码，进行更改后使用以下命令重新提交：

git add . git commit -m “message about this commit” git push origin some-task

如果你的代码被接受，管理员会合并你的拉取请求，你的代码将出现在Ushahidi Platform github仓库中，并归功于你。

2.4 进一步学习

• Contributing to open source
• Forking projects

三、Ushahidi Platform架构与工作流

了解Ushahidi Platform的架构和工作流，能帮助你更好地理解项目的设计理念和开发模式，为参与贡献打下坚实基础。

3.1 架构分层

Ushahidi Platform采用分层架构，清晰的层次划分有助于代码的维护和扩展。

Ushahidi Platform架构分层图.png)图：Ushahidi Platform架构分层图，展示了Application Layer、Core Layer和Framework Layer的组成及相互关系，有助于理解Ushahidi Platform的技术架构。

从图中可以看出，架构主要分为：

• Application Layer：包含HTTP（Validators、Formatters、Controllers）、Console（Commands）和Persistence（Repository Implementations）等部分。
• Core Layer：由Domain（Entities、Repository Interfaces、Authorization Rules、Tool Interfaces）和Use Cases（CRUDS、Receive Message、Bulk Import等）组成。
• Framework Layer：提供DB abstractions、Validation Engine、HTTP Routing等基础功能。

3.2 API请求流程

API请求在Ushahidi Platform中的处理流程如下：

图：Ushahidi Platform API请求流程图，清晰展示了从请求到响应的完整处理过程，包括Kohana、Controller、Usecase、OutputFormatter等组件的协作，是理解Ushahidi Platform工作机制的重要参考。

请求首先经过Kohana，然后传递给Controller，接着进行request payload identifier filters处理，之后进入Usecase，Usecase会依赖Repository、Validator、Authorizer等组件进行处理，处理完成后生成response，最后通过OutputFormatter输出。

通过对架构和API请求流程的了解，你可以更有针对性地进行代码开发和问题排查。

参与Ushahidi Platform的社区贡献，不仅能为开源项目贡献力量，还能提升自己的技术能力和协作能力。希望本文的路线图分析和贡献指南能帮助你顺利加入Ushahidi Platform的社区大家庭，共同推动项目的发展！

【免费下载链接】platformUshahidi Platform API version 3+项目地址: https://gitcode.com/gh_mirrors/platform16/platform