codever

Developers & Co를위한 북마크 및 스 니펫 관리자? ⚡️

우리의 Howto 페이지를 사용하여 책갈피와 코드 스 니펫을 관리 할 때 시간과 신경을 절약하기 시작하십시오. 다음과 같은 도우미와 확장이 도움이 될 것입니다.

확장

북마크	크롬 연장	Firefox Addon	Intellij 플러그인	vscode 확장

Chrome Extension 사용 예제 - 스 니펫 저장

다른 확장은 동일한 원칙 후에 다소 기능합니다.

공개 북마크

---

가치있는 공개 북마크는 CodeverDotDev/Bookmarks의 GitHub에 정기적으로 게시됩니다.

---

설정 (개발 또는 자체 호스팅)

이 지침을 통해 개발 및 테스트 목적으로 로컬 컴퓨터에서 프로젝트 사본을 실행할 수 있습니다.

이 프로젝트는 인증 및 승인을 위해 평균 스택 및 키 클로크로 개발되었습니다.

이 프로젝트에는 두 개의 앱이 포함되어 있습니다

• 사용자 인터페이스를 구성하는 Codever-UI. 이것은 각도 및 각도 CLI와 함께 사용합니다.
• UI를지지하는 API 인 Codever-API. MongoDB 및 KeyCloak과 함께 ExpressJ를 사용합니다. OpenAPI 사양을 참조하십시오

전제 조건

이 앱을 실행하는 데 필요한 것 :

• node 및 npm (NVM 사용 권장)
  • 노드가 최소한 ( v16.xx +) 및 NPM ( 8.xx +)을 실행하십시오.
• Nodemon npm install -g nodemon
• Docker- Docker Desktop을 사용하는 것이 좋습니다

Docker와 Docker-Compose는 현재 지역 개발에만 사용됩니다.

설치 ( 개발 설정 )

MongoDB 및 KeyCloak 서버를 시작하십시오

켈 docker compose 처음으로 실행할 때 처음에는 다음과 같은 -Dkeycloak.migration.action=import 라인 :

    # command: -Dkeycloak.migration.action=import -Dkeycloak.migration.provider=dir -Dkeycloak.migration.dir=/tmp/keycloak/export-import -Dkeycloak.migration.strategy=IGNORE_EXISTING

Docker-Compose 파일에서 초기 KeyCloak 설정 (영역 및 사용자)이로드되도록합니다 .

켈 Docker-Compose의 추가 스타트 업을 위해이 라인이 더 빨리 시작 되면서이 줄을 다시 주석 해야합니다.

docker-compose up

-d 사용하여 백그라운드에서 실행하십시오

설치 및 실행 (Frontend & Backend)

다음 명령으로 백엔드 API를 먼저 실행하려고합니다.

 # install
nvm use   # only if you are using nvm
npm install

# run
npm run frontend # to run the frontend
npm run backend # to run the backend

# alternatively run in parallel
npm start

또는 한 줄로 nvm use; npm install; npm start

이것은 시작됩니다

• http : // localhost : 3000/api에서 Nodemon이있는 API는 백엔드의 코드 변경 및 자동 재배치를 감시합니다.
• http : // localhost : 4200에서 제공되는 프론트 엔드. 초기 키 클로크 설정에서 사용자/비밀번호 mock/mock 로그인. 일부 북마크에는 처음에는 계정이 적재되어 있으므로 계정을 연주 할 수 있습니다.

KeyCloak 사용자를 추가하여 스크린 샷을 작성하여 자신의 테스트 사용자 또는 다른 추가 사용자를 만들 수 있습니다.

제목에 게시 날짜 및 지속 시간을 자동으로 추가하려면 Backend/Nodemon.json.example을 기반으로 Nodemon.json 파일을 작성하고 자신의 YouTube API 키를 추가해야합니다.

키 클로크

http : // localhost : 8080/auth in http : 8080/auth at admin/Pa55w0rd (docker compose 파일 참조)에서 키 클로크 관리자 콘솔.

테스트

Cypress를 사용한 E2E (통합) 테스트

KeyCloak 및 MongoDB는 위에 지정된대로 시작해야합니다 ( docker-compose up 명령)

다음 명령을 발행하여 통합 테스트를 실행하십시오.

 cd apps/codever-ui
npm run cy:run

Cypress를 열려면 다음 작업 npm run cy:open 실행할 수 있습니다.

API (백엔드)

통합 테스트

KeyCloak 및 MongoDB는 위에 지정된대로 시작해야합니다 ( docker-compose up 명령)

다음 명령을 발행하여 통합 테스트를 실행하십시오.

 cd apps/codever-api
npm run integration-tests

보고서가 생성됩니다.

디버깅

UI (프론트 엔드)

크롬 브라우저의 DEV 도구

Chromium 기반 브라우저 (예 : Chrome, Brave)에서 개발 도구를 사용할 수 있습니다. 다음 예와 같이 소스 및 중단점을 설정하려는 파일로 이동하십시오.

지적

Intellij에서는 아래와 같이 JavaScript 디버그 구성을 추가합니다.

백엔드

Intellij / webstorm (node.js 플러그인이 필요합니다)

npm run debug 다음 구성을 사용하여 --inspect 매개 변수로 NODEMON을 시작 하여이 프로세스에 첨부 할 수 있습니다.

비주얼 스튜디오 코드

NODEMON을 사용한 Code vs 코드의 Node.js 디버깅을 참조하십시오

블로그

Codever 기능 및 구현 세부 정보와 관련된 블로그 게시물은 Codepedia.org 및 Dev.to에서 찾을 수 있습니다.

기여

당사의 행동 강령에 대한 자세한 내용과 당사에 풀 요청을 제출하는 프로세스는 Contributing.md를 읽으십시오.

버전 작성

우리는 버전 관리에 Semver를 사용합니다. 사용 가능한 버전은이 저장소의 태그를 참조하십시오.

changelog

ChangeLog는 ChangeLog.md에서 사용할 수 있습니다

ChangeLog를 업데이트하려면 다음 명령을 실행합니다.

nvm use
standard-changelog

특허

이 프로젝트는 MIT 라이센스에 따라 라이센스가 부여됩니다. 자세한 내용은 라이센스 파일을 참조하십시오.

프로젝트에 사용 된 모든 미디어 자료는 저작권법에 속합니다.