LivrEtec

Livetec

早上好，下午好或晚安。該項目是Etec Aristotle Ferreira學校圖書館藏品的經理

專案

在此存儲庫中，將有三個項目：

• 圖書館員工使用的GIB （圖書館內部經理）來管理書籍和貸款。
• 學生使用的APB （圖書館的公共集合）來查看庫中包含的書籍的集合。
• 教師的公共API建議學生使用，測試HTTP呼叫以及學生製作的流行網站。

工具

• Docker ：隔離測試環境
• .NET核心：整個後端的平台
• mySQL ：數據庫
• 實體框架：ORM將應用程序連接到數據庫
• GRPC ：作為GIB服務器與客戶之間的通信協議
• 大黃金混合動力車 +毛伊島：GIB客戶界面
• Xunit ：執行圖書館單元測試
• DOCFX ：用於創建文檔
• 無花果：進行原型設計

如何執行

目前正在部分完成GRPC中製造的GIB內部API。可以執行項目的單元測試。

運行GIB API

您可以通過兩種方式運行API：使用機器環境或使用Docker。如果已經安裝或無法在機器環境中安裝執行要求，最好使用Docker。

由於帶寬，可能需要時間安裝圖像和軟件包。

在本地環境中運行

要在本地環境中執行以下要求：

• .NET 6.0.0
• mysql

有必要在執行之前配置文件./src/LivrEtec.GIB.Servidor/appsettings.json

我建議複製appsettings.modelo.json文件，並根據您的MySQL Server用作身份驗證密鑰和連接字符串的字符串填充AuthKey屬性。用作Docker中使用的AppSetting文件的示例。

配置項目後，您在Visual Studio中打開項目，然後選擇LivreTec.gib.servator作為啟動項目，或在終端模擬器上運行./src/LivrEtec.GIB.Servidor

dotnet run

如果未正確配置AppSetting，例如連接字符串或無效端口，則可能會發生錯誤。如果有任何錯誤，請舒適地發布

使用Docker運行

要使用Docker運行服務器很簡單，只需在./src文件夾中運行以下命令

docker compose --profile backend up --build

如前所述，由於有必要下載圖像和軟件包Nuget可能需要幾分鐘才能根據您的互聯網頻段下載。

打電話

執行項目後，他將通知他正在聽的門。由於尚未配置SSL證書，因此建議使用HTTP標準。

要撥打API，請選擇您選擇的GRPC客戶。

一些替代方案是失眠或郵遞員。

原始API文件位於./src/livretec.gib/protos/acervo.proto。

之後，有必要通過login GerenciamentoSessao中的請求登錄到API。需要登錄名來命名登錄和密碼哈希，但是第一次啟動服務器時，它將使用admin:senha和id 1的用戶創建用戶。

密碼哈希需要如下生成： md5(senha + id) 。

因此請求應如下：

{
	"IdUsuario" : 1 ,
	"HashSenha" : " 92f20dafc5e5ac1c66820903c492cc04 "
}

然後它將返回JWT令牌，該標記應如下： Authorization: Bearer <JWT Token>

好的，現在您可以作為管理員訪問其餘API。

執行測試

就像可以在本地環境和Docker中測試GIB API一樣，您也可以在沒有安裝的MySQL Server的情況下進行一些測試。

當地環境

測試分為兩個：

• 使用sqllite測試測試過程中每個服務的本地測試
• 遠程測試是集成測試。

要僅執行本地測試，只需安裝.NET 6.0.0和在文件夾中./src/執行以下命令：

dotnet test LivrEtec.sln --filter Category=local

如果您使用的是Visual Studio打開測試管理器並運行local測試類別

要執行遠程測試，您必須首先運行GIB服務器。執行後，您需要創建和配置./src/LivrEtec.Testes/appsettings.json文件。

複製AppSettings.modelo.json文件，並用填充Gib Server AppSettings的相同信息以及添加服務器鏈接，如果鏈接以這種格式出現： http://[::]:21312表示與http://localhost:21312

在配置服務器和測試以執行項目之後，只需在./src/目錄中運行以下命令

dotnet test LivrEtec.sln

在Visual Studio中，只需打開測試管理器，然後單擊“運行”。

Docker

如果要使用docker，只需轉到文件夾./src/ ，然後使用以下命令運行容器：

docker compose --profile teste up --build

--build是為了確保使用最新代碼執行容器。

運行測試後，數據庫容器將繼續運行。如果您想在測試之後自動出現，請在命令中添加--exit-code-from app作為標誌。

設計

該設計可從https://figma.com/community/file/1176031299741420547獲得

如何合作

如果您想協作，歡迎所有幫助。我們建議您首先轉到（Wiki）[./ Wiki/ wiki/ Projects-of-projects]，並閱讀一些以獲取項目概述，然後尋找（./ esloge）您感興趣的任何問題。如果您找到一個項目叉，進行修改，然後進行項目的拉動，然後對項目進行拉動。請確保在進行Pull請求之前進行測試，並對其進行測試，並對其進行了測試，並將您的整個驗證為您，並進行了所有的測試，並進行了整個測試，並進行了所有測試。

文件

有關該項目的更多信息，請參閱我們的文檔。

歡迎 ：）