CuCoders es una plataforma creada con el fin de potenciar el desarrollo de software en Cuba y apoyar a los desarrolladores y emprendedores en su carrera profesional. En CuCoders puedes descubrir recursos, aplicaciones, artículos, perfiles de programadores y ofertas laborales. CuCoders es el lugar perfecto para encontrar oportunidades y mantenerse actualizado en el mundo de la programación.
Dentro del proyecto encontrarás las estructura de carpetas siguientes:
/
├── .github/workflows # Workflows de Github Actions para compilar el proyecto
├── public/ # Directorio con los ficheros publicos del proyecto
│ └── assets/
| └── img/
├── src/
│ ├── components/ # Todos los compoenentes reutilizables de la web
│ ├── content/ # Aqui se almacena el conenido que se muestra en la web, organizado por categorias y usuarios
| └── apps/
| └── blogs/
| └── events/
| └── resources/
│ ├── layouts/
│ └── pages/
│ └── templates/ # Las plantillas utilizadas para la generacion de ciertos documentos .md
└── package.json
Cualquier activo estático, como imágenes, se puede colocar en el directorio público/.
Todos los comandos se ejecutan desde la raíz del proyecto, desde una terminal:
| Command | Action |
|---|---|
npm install |
Installs dependencies |
npm run dev |
Starts local dev server at localhost:3000 |
npm run build |
Build your production site to ./dist/ |
npm run preview |
Preview your build locally, before deploying |
npm run astro ... |
Run CLI commands like astro add, astro preview |
npm run astro --help |
Get help using the Astro CLI |
CuCoders funciona con una arquitectura descentralizada utilizando como backend a GitHub. Los datos de los artículos, las aplicaciones y los eventos se almacenan en los ficheros físicos del repositorio público y los datos de cada usuario están en su poder en los repositorios especiales de cada usuario. La información más volátil que no necesita ser conservada en el tiempo como las ofertas laborales se encuentran almacenadas en microservicios que se acceden mediante una API, para los cuales en primera versión se crearon utilizando Airtable.
El sitio se recompila utilizando las GitHub Actions nutriéndose de la información almacenada en GitHub y utilizando el backend serverless desarrollado con Astro, el cual se encarga de conectarse y consumir información de los servicios de empleos y próximamente de los servicios y aplicaciones destacadas en la web.
El usuario visualiza la información en el sitio web estático construido con Astro y mediante el bot de Telegram con la publicación de las nuevas ofertas laborales.
Arquitectura permite mantener los costos del mantenimiento del proyecto casi nulos así como permite que la información se mantenga pública y siempre accesible para garantizar la continuidad del proyecto.
CuCoders puede ser desplegado en cualquier proveedor que permita la construcción de páginas estáticas. En estos momentos estamos utilizando GitHub Pages para la cual hay una serie de configuraciones específicas en los ficheros de configuración de las GitHub Actions y los ficheros de configuración de Astro.
CuCoders es una solución de código abierto. Los Pull Requests y las contribuciones son bienvenidas! Para contribuir con el proyecto puedes informar de algún error, sugerir una nueva característica o comenzar a trabar solucionando algún Issue que haya sido marcado como "aceptado".
Para más información lea el fichero Contributing.md.
Made with contrib.rocks.