codever

?

Use nossas páginas Howto para que você vá e comece a economizar tempo e nervos ao gerenciar seus favoritos e trechos de código. Os seguintes ajudantes e extensões o ajudarão ao longo do caminho:

Extensões

Bookmarklet	Extensão do cromo	Firefox Addon	Plugin Intellij	Extensão do vscode

Exemplo de uso de extensão do Chrome - salve snippet

As outras extensões funcionam mais ou menos após o mesmo princípio

Favoritos públicos

---

Os marcadores públicos dignos são publicados regularmente no GitHub em codeverDotDev/marcadores.

---

Configuração (desenvolvimento ou auto -hospedagem)

Essas instruções fornecerão uma cópia do projeto em funcionamento em sua máquina local para fins de desenvolvimento e teste.

O projeto é desenvolvido com a pilha média e a keycloak para autenticação e autorização:

O projeto contém dois aplicativos

• Codever-ui que compõe a interface do usuário. Isso usa com cli angular e angular.
• Código-api, que é a API que suporta a interface do usuário. Ele usa o ExpressJS com MongoDB e Keycloak. Veja a especificação OpenAPI

Pré -requisitos

O que você precisa para executar este aplicativo:

• node e npm (recomendamos o uso de NVM)
  • Verifique se você está executando pelo menos o nó ( v16.xx +) e o npm ( 8.xx +)
• Nodemon - npm install -g nodemon
• Docker - Recomendamos usar o Docker Desktop

Docker e Docker-Compose são atualmente usados ​​apenas para desenvolvimento local

Instalação ( configuração de desenvolvimento )

Inicie o MongoDB e o KeyCloak Server

️ Quando você executa docker compose pela primeira vez o descomment, o seguinte -Dkeycloak.migration.action=import linha:

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

No arquivo Docker-Comppose, de modo que a configuração inicial do keycloak (reino e usuários) seja carregada .

️ Para mais startups de Docker-CompomPese, você deve comentar essa linha , pois ela começa mais rápido

docker-compose up

Use -d para executá -lo em segundo plano

Instale e execute (front -end e back -end)

Você deseja que a API de back -end seja executada primeiro com os seguintes comandos:

 # 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

ou em uma linha, nvm use; npm install; npm start

Isso começa

• A API com Nodemon em http: // localhost: 3000/API e observará as alterações de código no back -end e a reimplantar automaticamente.
• O front -end disponível em http: // localhost: 4200. Login o usuário/ mock/mock de usuário configurado para você na configuração inicial do keycloak. Alguns favoritos são carregados inicialmente com sua conta, para que você possa começar a brincar com eles.

Você pode criar seu próprio usuário de teste ou qualquer outro usuário extra seguindo as capturas de tela, adicione um usuário do keycloak para criá -lo.

Para poder adicionar automaticamente os vídeos do YouTube Data e a duração publicadas ao título, você precisa criar um arquivo Nodemon.json com base no back -end/nodemon.json.example e adicionar sua própria tecla API do YouTube

Keycloak

Keycloak admin console acessível em http: // localhost: 8080/auth with the user/senha admin/Pa55w0rd (consulte o arquivo de composição do docker)

Teste

E2E (integração) testes com Cypress

Keycloak e MongoDB precisam ser iniciados conforme especificado acima (comando docker-compose up )

Execute o teste de integração emitindo o seguinte comando.

 cd apps/codever-ui
npm run cy:run

Para abrir o cipreste, você pode executar a seguinte tarefa npm run cy:open

API (back -end)

Testes de integração

Keycloak e MongoDB precisam ser iniciados conforme especificado acima (comando docker-compose up )

Execute o teste de integração emitindo o seguinte comando.

 cd apps/codever-api
npm run integration-tests

Um relatório será gerado.

Depuração

Interface do usuário (front -end)

Ferramentas de desenvolvimento em navegadores de cromo

Você pode usar as ferramentas de desenvolvimento em navegadores baseados em cromo (por exemplo, Chrome, Brave). Navegue para fontes e o arquivo que você deseja definir seus pontos de interrupção, como no exemplo a seguir:

Intellij

Em Intellij, você adiciona configuração de depuração JavaScript, como mostrado abaixo:

Back -end

Intellij / WebStorm (plug -in Node.js é necessário)

O npm run debug inicia o Nodemon com o parâmetro --inspect para que você possa anexar a esse processo, usando a seguinte configuração:

Código do Visual Studio

Veja Node.js Depuração no Código VS com Nodemon

Blog

As postagens do blog relacionadas aos recursos do codocróstico e detalhes da implementação podem ser encontradas em codepedia.org e dev.to

Contribuindo

Leia contribuindo.md para obter detalhes sobre nosso código de conduta e o processo para enviar solicitações de puxar para nós.

Versão

Usamos o Semver para versões. Para as versões disponíveis, consulte as tags neste repositório.

Changelog

O Changelog está disponível no Changelog.md

Para atualizar o Changelog, execute os seguintes comandos:

nvm use
standard-changelog

Licença

Este projeto está licenciado sob a licença do MIT - consulte o arquivo de licença para obter detalhes.

Todos os materiais de mídia usados ​​no projeto se enquadram na lei de direitos autorais