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/ 。