LivrEtecダウンロードLivrEtecソースコードのダウンロード

LivrEtec

その他のカテゴリー

1.0.0

ダウンロード

Livetec

おはよう、こんにちは、おやすみなさい。このプロジェクトは、ETECアリストテレスフェレイラスクールライブラリコレクションのマネージャーです

プロジェクト

このリポジトリには、3つのプロジェクトがあります。

図書館の従業員が本やローンを管理するために使用されるGIB （図書館内部マネージャー）。
図書館の図書館に含まれる本のコレクションを見るために学生が使用するAPB （図書館の公開コレクション）。
教師向けのパブリックAPIは、学生にHTTPコールや学生が作成した人気のあるサイトをテストすることを提案します。

ツール

Docker ：テスト環境を分離します
.NETコア：バックエンド全体のプラットフォーム
MySQL ：データベース
エンティティフレームワーク：アプリケーションをデータベースに接続するORM
GRPC ：GIBサーバーと顧客の間の通信プロトコルとして
Blazor Hybrid + Maui ：GIBカスタマーインターフェイス
Xunit ：ライブラリユニットテストを実行する
DOCFX ：ドキュメント作成用
Figma ：プロトタイプの設計へ

実行方法

現在、GRPCで作成されたGIB内部APIに部分的に完了しています。プロジェクトのユニットテストを実行することが可能です。

GIB APIを実行しています

APIを2つの方法で実行できます。マシン環境を使用するか、Dockerを使用します。 Dockerが既にインストールされている場合、またはマシン環境に実行の要件をインストールできない場合は、Dockerを使用することが望ましいです。

帯域幅のため、画像やパッケージをインストールするのに時間がかかる可能性があります。

地元の環境で走る

ローカル環境で実行するには、次の要件があります。

.NET 6.0.0
mysql

実行前にファイルを構成する必要があります./src/LivrEtec.GIB.Servidor/appsettings.json

appsettings.modelo.jsonファイルをコピーすることをお勧めします。これは、MySQLサーバーに従って認証キーと接続文字列として機能する文字列でAuthKeyプロパティを入力することをお勧めします。例として、Dockerで使用されているAppSettingsファイルを使用します。

プロジェクトを構成した後、Visual Studioでプロジェクトを開き、 livretec.gib.servatorを開始プロジェクトとして選択するか、ターミナルエミュレータで実行します./src/LivrEtec.GIB.Servidor

dotnet run

接続文字列や無効なポートなど、AppSettingsを正しく構成していない場合、エラーが発生する場合があります。エラーが発生した場合、投稿するのが快適です

Dockerを使用して実行します

Dockerを使用してサーバーを実行するには、 ./srcフォルダーで次のコマンドを実行するだけです

docker compose --profile backend up --build

前述のように、画像とパッケージをダウンロードする必要があるため、Nugetはインターネットバンドに応じてダウンロードするのに数分かかる場合があります。

電話

プロジェクトを実行した後、彼は聴いているドアに通知します。 SSL証明書はまだ構成されていないため、HTTP標準を使用することをお勧めします。

APIに電話をかけるには、GRPC Customerから選択を選択してください。

いくつかの選択肢は、不眠症または郵便配達員です。

Proto APIファイルは、./src/livretec.gib/protos/acervo.protoにあります。

その後、 GerenciamentoSessao中のloginのリクエストを介してAPIにログインする必要があります。ログインはログインとパスワードのハッシュに名前を付ける必要がありますが、サーバーを初めて起動すると、 admin:senhaとid 1が作成されます。

パスワードハッシュは次のように生成する必要があります： md5(senha + id) 。

したがって、リクエストは次のようにする必要があります。

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

そしてAuthorization: Bearer <JWT Token> JWTトークンを返します。これは次のようにヘッダーに追加する必要があります。

さて、これで、管理者としてAPIの残りの部分にアクセスできます。

テストの実行

ただし、GIB APIがローカル環境とDockerでテストできるように、MySQLサーバーをインストールしないとテストを行うことができます。

ローカル環境

テストは2つに分けられます。

sqlliteを使用して、テストプロセス自体の各サービスをテストするローカルテスト
統合テストであるリモートテスト。

ローカルテストのみを実行するには、.NET 6.0.0を単にインストールし、フォルダーに./src/次のコマンドを実行しました。

dotnet test LivrEtec.sln --filter Category=local

Visual Studioを使用している場合は、テストマネージャーを開き、 localテストカテゴリを実行します

また、リモートテストを実行するには、最初にGIBサーバーを実行する必要があります。実行したら、 ./src/LivrEtec.Testes/appsettings.json appsettings.jsonファイルを作成して構成する必要があります。

appsettings.modelo.jsonファイルをコピーして、この形式でリンクが表示される場合は、 http://[::]:21312 http://localhost:21312と同じことを意味する場合、gibサーバーappsettingsに記入された同じ情報を入力し、サーバーリンクを追加します。

また、プロジェクトを実行するためにサーバーとテストを構成した後、 ./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/ projects of-projects]にアクセスして、プロジェクトの概要を取得するために少し読んでから、興味のある問題を探します。プロジェクトフォークを見つけた場合は、プロジェクトのためにプルを行うことをお勧めします。