issue wanted

问题想要

issue-wanted是一个Web应用程序，旨在通过将许多Haskell存储库中的GitHub问题集中到一个位置，以改善开源Haskell社区。 issue-wanted的目标是使所有技能水平的程序员更容易找到Haskell项目可以贡献，增加对开源Haskell项目的贡献，并鼓励更多的程序员成为Haskell社区的一部分。

体系结构描述

该项目的主要工作是在2019年Google Summer of Code中完成的。对于任何对实施issue-wanted的详细信息以及为何做出某些设计选择感兴趣的人，请查看以下博客文章：

• GSOC 2019-与Haskell构建Web应用程序
• 在问题中实施自定义的单声道效果指南
• GSOC 2019-最终评估

后端

先决条件（您需要在本地拥有什么）

您将需要在系统上安装以下内容，以构建和测试issue-wanted 。单击链接以了解如何安装每个链接：

1. GHC
2. 阴谋集或堆栈
3. Docker
4. libpq-dev ：运行命令sudo apt install libpq-dev进行安装。

安装了docker后，打开一个终端（确保您在issue-wanted目录中）并运行命令make postgres 。这将为您设置数据库，您应该准备好！

按照How to run server并测试端点下的说明，以查看是否正确设置了所有内容。

如果您仍然遇到麻烦，请参阅第81期。

如何构建

要构建项目，请在基本文件夹中打开终端并运行

stack build

或者

cabal v2-build

如何生成榆树类型

如果更改了任何类型，则应通过运行来更新生成的ELM类型：

stack run generate-elm

或者

cabal v2-run generate-elm

如何运行服务器

用于测试issue-wanted服务器以下步骤：

1. 打开基本文件夹中的终端并运行stack build
2. 运行命令stack exec issue-wanted

服务器将开始在http://localhost:8080/ 。

API

可用问题的端点可用：

端点	描述
/issues	返回所有问题。
/issues/:id	返回具有相应ID的单个问题。
/issues?label=<label name>	返回相应标签的问题列表。

提示：如果您停止运行服务器，然后尝试重新启动它，则可能需要运行命令fuser -n tcp -k 8080以释放端口。

如何在本地运行自动测试

1. 在单独的终端运行中， make postgres （此命令将在Docker容器中运行数据库）
2. 在第一个终端运行stack test或cabal new-test

如何为CI部署新的Docker图像

更新stack快照后，您需要相应地更新Dockerfile ，然后将新的Docker Image推向Docker Hub。仅当您可以访问帐户凭据时，才能做到这一点。

执行以下命令：

 docker build . -t kowainik/haskell-ci
docker push kowainik/haskell-ci

前端

当前，前端是使用Elm实施的。

先决条件（您需要在本地拥有什么）

• elm
• npm
• create-elm-app ：安装运行npm install -g [email protected]

如何运行

注意：所有操作均应在frontend文件夹中执行：

 cd frontend/

第一次

• 获取节点模块： npm install
• 继续进行后续步骤

随后的

• 在一个选项卡中： elm-app start
• 在另一个选项卡中： npm run-script watch-css

Frontend将开始在http://localhost:3000/ 。