codever

⚡ ⚡ ⚡ ós marcadores de marcadores y fragmentos para desarrolladores y co? ⚡️

Use nuestras páginas Howto para ponerlo en marcha y comenzar a ahorrar tiempo y nervios al administrar sus marcadores y fragmentos de código. Los siguientes ayudantes y extensiones lo ayudarán en el camino:

Extensiones

Marcador	Extensión de cromo	Complemento de Firefox	Complemento IntelliJ	Extensión VSCODE

Ejemplo de uso de la extensión de Chrome - Guardar fragmento

Las otras extensiones funcionan más o menos después del mismo principio

Marcadores públicos

---

Los marcadores públicos dignos se publican regularmente en GitHub en CodeverdotDev/Bookmarks.

---

Configuración (desarrollo o autosuficiencia)

Estas instrucciones le darán una copia del proyecto en funcionamiento en su máquina local para fines de desarrollo y prueba.

El proyecto se desarrolla con la pila media y el keycloak para la autenticación y la autorización:

El proyecto contiene dos aplicaciones

• Codever-ui que constituye la interfaz de usuario. Esto usa con CLI angular y angular.
• Codever-API, que es la API que admite la interfaz de usuario. Utiliza ExpressJs con MongoDB y KeyCloak. Ver la especificación de OpenAPI

Requisitos previos

Lo que necesitas para ejecutar esta aplicación:

• node y npm (recomendamos usar NVM)
  • Asegúrese de ejecutar el nodo al menos ( v16.xx +) y npm ( 8.xx +)
• Nodemon - npm install -g nodemon
• Docker - Recomendamos usar Docker Desktop

Docker y Docker-Compose se usan actualmente solo para el desarrollo local

Instalación ( configuración de desarrollo )

Iniciar MongoDB y KeyCloak Server

️ Cuando ejecuta docker compose por primera vez Uncomment el siguiente -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

En el archivo Docker-Compose, de modo que se cargue la configuración inicial de KeyCloak (reino y usuarios) .

️ Para más nuevas empresas de Docker-Compose, debe comentar esta línea , ya que comienza más rápido

docker-compose up

Use -d para ejecutarlo en segundo plano

Instalar y ejecutar (frontend y backend)

Desea que la API de backend se ejecute primero con los siguientes 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

o en una línea nvm use; npm install; npm start

Esto comienza

• La API con Nodemon en http: // localhost: 3000/API y observará los cambios en el código en el backend y se volverá a desplegar automáticamente.
• El frontend disponible en http: // localhost: 4200. Iniciar sesión el mock/mock de contraseña de usuario configurado para usted en la configuración inicial de KeyCloak. Algunos marcadores se cargan inicialmente con su cuenta, por lo que puede comenzar a jugar con ellos.

Puede crear su propio usuario de prueba o cualquier otro usuario adicional siguiendo las capturas de pantalla en Agregar un usuario de KeyCloak para crearlo.

Para poder agregar automáticamente los videos de YouTube, la fecha y la duración del título, necesita crear un archivo nodemon.json basado en el backend/nodemon.json.example y agregue su propia clave API de YouTube

Cloak

La consola de administración de KeyCloak accesible en http: // localhost: 8080/auth con el usuario/contraseña admin/Pa55w0rd (consulte el archivo de composición de Docker)

Pruebas

E2E (integración) pruebas con cipress

KeyCloak y MongoDB deben iniciarse como se especifica anteriormente (Comando docker-compose up )

Ejecute la prueba de integración emitiendo el siguiente comando.

 cd apps/codever-ui
npm run cy:run

Para abrir Cypress, puede ejecutar la siguiente tarea npm run cy:open

API (backend)

Pruebas de integración

KeyCloak y MongoDB deben iniciarse como se especifica anteriormente (Comando docker-compose up )

Ejecute la prueba de integración emitiendo el siguiente comando.

 cd apps/codever-api
npm run integration-tests

Se generará un informe.

Depuración

Ui (frontend)

Herramientas de desarrollo en los navegadores de cromo

Puede usar las herramientas de desarrollo en navegadores basados ​​en cromo (por ejemplo, Chrome, valiente). Navegue a las fuentes y el archivo que desea establecer sus puntos de descanso, como en el siguiente ejemplo:

IntestiJ

En IntelliJ, agregue la configuración de depuración de JavaScript como se muestra a continuación:

Backend

IntelliJ / Webstorm (se requiere el complemento Node.js)

La npm run debug comienza a nodemon con el parámetro --inspect para que pueda adjuntar a este proceso, utilizando la siguiente configuración:

Código de Visual Studio

Ver Node.js Depuración en VS Código con Nodemon

Blog

Las publicaciones de blog relacionadas con las características de Codever y los detalles de implementación se pueden encontrar en codepedia.org y dev.

Que contribuye

Lea Contriping.MD para obtener detalles sobre nuestro código de conducta y el proceso para enviarnos solicitudes de extracción.

Versiones

Usamos Semver para versiones. Para las versiones disponibles, consulte las etiquetas en este repositorio.

Colegio de cambios

El ChangeLog está disponible en ChangeLog.md

Para actualizar el cambio, ejecute los siguientes comandos:

nvm use
standard-changelog

Licencia

Este proyecto tiene licencia bajo la licencia MIT; consulte el archivo de licencia para obtener más detalles.

Todos los materiales de medios utilizados en el proyecto se encuentran bajo la ley de derechos de autor