LivrEtec 다운로드 - LivrEtec 소스 코드 다운로드

LivrEtec

기타 카테고리

1.0.0

다운로드

livetec

좋은 아침, 좋은 오후 또는 좋은 밤. 이 프로젝트는 ETEC Aristotle Ferreira School Library Collection의 관리자입니다.

프로젝트

이 저장소에는 세 가지 프로젝트가 있습니다.

도서관 직원이 도서 및 대출을 관리하기 위해 사용하는 GIB (Library Internal Manager).
도서관에 포함 된 도서관의 책 모음을보기 위해 학생들이 사용하는 APB (도서관의 공개 컬렉션).
교사를위한 공개 API는 학생들에게 HTTP 통화 및 학생들이 만든 인기 사이트를 테스트하기 위해 학생들에게 제안합니다.

도구

Docker : 테스트 환경을 분리합니다
.NET 코어 : 전체 백엔드의 플랫폼
MySQL : 데이터베이스
엔티티 프레임 워크 : ORM 응용 프로그램을 데이터베이스에 연결합니다.
GRPC : GIB 서버와 고객 간의 통신 프로토콜로
Blazor Hybrid + Maui : GIB 고객 인터페이스
XUNIT : 라이브러리 단위 테스트를 수행합니다
DOCFX : 문서 작성을 위해
피그마 : 프로토 타이파 디자인

수행하는 방법

현재 GRPC에서 만든 GIB 내부 API를 부분적으로 완료하고 있습니다. 프로젝트의 단위 테스트를 수행 할 수 있습니다.

GIB API 실행

기계 환경을 사용하거나 Docker를 사용하는 두 가지 방법으로 API를 실행할 수 있습니다. Docker가 이미 설치되었거나 기계 환경에서 실행 요구 사항을 설치할 수없는 경우 Docker를 사용하는 것이 좋습니다.

대역폭으로 인해 이미지와 패키지를 설치하는 데 시간이 걸릴 수 있습니다.

지역 환경에서 실행

지역 환경에서 실행하려면 다음과 같은 요구 사항이 있습니다.

.NET 6.0.0
MySQL

실행 전에 파일을 구성하기 전에 ./src/LivrEtec.GIB.Servidor/appsettings.json 이 필요합니다.

AppSettings.modelo.json 파일을 복사하는 것이 좋습니다. Authkey 속성을 Authentication Key 및 MySQL 서버에 따라 연결 문자열로 사용하는 문자열로 채우는 것이 좋습니다. Docker에 사용 된 AppSettings 파일을 예제로 사용하십시오.

프로젝트를 구성한 후 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에 관리자로 액세스 할 수 있습니다.

테스트 수행

그러나 GIB API가 로컬 환경에서 테스트하고 Docker에서 테스트 할 수있는 것처럼 설치된 MySQL 서버 없이는 일부 테스트를 수행 할 수 있습니다.

지역 환경

테스트는 두 가지로 나뉩니다.

sqllite를 사용하여 테스트 프로세스 자체의 각 서비스를 테스트하는 로컬 테스트
통합 테스트 인 원격 테스트.

로컬 테스트 만 수행하려면 ./src/ 6.0.0을 설치하고 다음 명령을 수행하십시오.

dotnet test LivrEtec.sln --filter Category=local

Visual Studio를 사용하는 경우 테스트 관리자를 열고 local 테스트 카테고리를 실행하십시오.

원격 테스트를 수행하려면 먼저 GIB 서버를 실행해야합니다. 실행되면 ./src/LivrEtec.Testes/appsettings.json 파일을 작성하고 구성해야합니다.

AppSettings.modelo.json 파일을 복사하고 GIB 서버 AppSettings를 채운 동일한 정보를 작성하고 서버 링크를 추가하는 것과 동일한 정보를 작성하십시오. 링크 가이 형식으로 표시되면 http://[::]:21312 는 http://localhost:21312 와 동일합니다.

프로젝트를 실행하기 위해 서버 및 테스트를 구성한 후 ./src/ 디렉토리에서 다음 명령을 실행하십시오.

dotnet test LivrEtec.sln

Visual Studio에서는 테스트 관리자를 열고 실행을 클릭하십시오.

도커

Docker를 사용하려면 폴더 ./src/ 로 이동하여 다음 명령으로 컨테이너를 실행하십시오.

docker compose --profile teste up --build

--build 컨테이너가 최신 코드로 실행되도록하는 것입니다.

테스트를 실행하면 데이터베이스 컨테이너가 계속 실행됩니다. 테스트 후 자동으로 나오려면 --exit-code-from app 명령의 플래그로 추가하십시오.

설계

이 디자인은 https://figma.com/community/file/1176031299741420547에서 제공됩니다

협업하는 방법

협업하려면 모든 도움을 환영합니다. 먼저 (Wiki) [./ wiki/ projects-of-projects]로 가서 프로젝트 개요를 얻기 위해 조금 읽은 다음 관심있는 모든 문제를 찾는 것이 좋습니다. 프로젝트 포크를 찾은 다음 프로젝트에 대한 풀을 작성하기 전에 모든 구현에 대한 테스트를 만들었습니다.