|
All checks were successful
Build & Push Container Image to Forgejo Registry / Build & Push Docker Image (push) Successful in 18m9s
|
||
|---|---|---|
| .forgejo/workflows | ||
| .storybook | ||
| .vscode | ||
| packages | ||
| products | ||
| public | ||
| src | ||
| .dockerignore | ||
| .editorconfig | ||
| .gitignore | ||
| .prettierrc | ||
| angular.json | ||
| ARQUITECTURA.md | ||
| commitlint.config.js | ||
| CONTRIBUTING.md | ||
| CONVENCIONES.md | ||
| Dockerfile | ||
| eslint.config.js | ||
| lefthook.yml | ||
| package.json | ||
| pnpm-lock.yaml | ||
| pnpm-workspace.yaml | ||
| README.md | ||
| tsconfig.app.json | ||
| tsconfig.json | ||
| tsconfig.spec.json | ||
🐝 Embeejayz Platform
Plataforma interactiva de recompensas y coleccionables inspirada en la escena competitiva de League of Legends® y la comunidad de Embeejayz.
🌐 Sitio Web en Producción • 📺 Canal de Twitch • ✨ Guía de Contribución • 📏 Convenciones de Código
📖 Acerca del Proyecto
Embeejayz Platform es la evolución de la plataforma comunitaria para los espectadores y seguidores del canal de Embeejayz. Convertimos la pasión por T1, la escena competitiva y League of Legends® en experiencias digitales coleccionables:
- 🎴 Packs de Cartas Coleccionables: Descubre y canjea cartas con momentos históricos de los esports y la comunidad.
- 🛡️ Bordes Clasificatorios Interactivos: Recompensas en vivo durante las retransmisiones oficiales del competitivo.
- ⚡ Rendimiento Ultrarrápido: Construido con Angular 21 Zoneless, SSR nativo y un UIKit modular con diseño oscuro inmersivo.
- 📱 Experiencia Fluida & Responsive: Carruseles táctiles, animaciones suaves y soporte multidispositivo (Mobile, Tablet y Desktop).
🛠️ Stack Tecnológico
| Capa | Tecnología | Descripción |
|---|---|---|
| Framework | Angular 21 | Reactividad basada en Signals, arquitectura Zoneless y SSR de alto rendimiento. |
| Diseño & UI | @embeejayz/uikit |
Design System propio con tokens CSS, botones temáticos, iconos SVG vectoriales y carrusel interactivo. |
| Lenguaje | TypeScript 5.9 | Tipado estricto con exactOptionalPropertyTypes y noImplicitReturns. |
| Testing | Vitest | Suite de pruebas unitarias ultrarrápida con cobertura completa. |
| Component Workshop | Storybook 8 | Documentación interactiva y aislamiento del catálogo de componentes UI. |
| Contenedores | Docker | Imagen de producción multi-stage con Node.js 22 Alpine para SSR. |
| Calidad & Git Hooks | Lefthook + Commitlint | Validación de ESLint, Prettier y Conventional Commits antes de cada commit. |
📁 Estructura del Proyecto
web-embeejayz/
├── packages/
│ └── uikit/ # 🎨 Design System & Component Library (@embeejayz/uikit)
│ ├── src/
│ │ ├── components/ # Botones, Carrusel, Iconos, Dropdowns, Inputs
│ │ ├── styles/ # Variables CSS, Reset, Tipografías (Nunito / Poppins)
│ │ └── index.ts # Barrel export público del UIKit
│ └── .storybook/ # Configuración de Storybook para el UIKit
├── src/
│ ├── app/ # 🚀 Vistas principales y Routing
│ │ ├── home/ # Vista Home (Carrusel con Banners 1, 2 y 3)
│ │ ├── layout/ # Shell principal con Navbar y Footer
│ │ └── app.routes.ts # Rutas de la aplicación
│ └── features/ # 🧩 Módulos funcionales de dominio
│ └── sections/ # Navbar, Footer, Enjambre, Créditos y Enlaces
├── public/ # 🖼️ Assets estáticos (imágenes, favicons, robots.txt)
├── Dockerfile # 🐳 Build & Server SSR en contenedor Docker
├── CONTRIBUTING.md # 🤝 Guía de contribución
└── CONVENCIONES.md # 📏 Estándares estrictos de código
🚀 Inicio Rápido
Prerrequisitos
1. Clonar el repositorio
git clone https://github.com/tomasjsdev/platform-embeejayz.git
cd platform-embeejayz/web-embeejayz
2. Instalar dependencias
pnpm install
3. Iniciar el servidor de desarrollo
pnpm start
Abre http://localhost:4200 en tu navegador para ver la aplicación con Hot-Reloading.
🧪 Scripts Disponibles
| Comando | Descripción |
|---|---|
pnpm start |
Inicia el servidor de desarrollo local de Angular en http://localhost:4200. |
pnpm build |
Compila la aplicación para producción (SSR + Client bundles en dist/). |
pnpm test |
Ejecuta la suite de pruebas unitarias con Vitest. |
pnpm ng test --no-watch |
Ejecuta las pruebas unitarias una sola vez (modo CI). |
pnpm lint |
Ejecuta ESLint para validar la calidad del código. |
pnpm storybook |
Inicia Storybook en http://localhost:6006 para explorar el @embeejayz/uikit. |
pnpm build-storybook |
Genera la versión estática de Storybook. |
🐳 Despliegue con Docker (SSR)
Puedes construir y correr la imagen de producción en un contenedor aislado:
# Construir la imagen
docker build -t web-embeejayz:latest .
# Ejecutar el contenedor
docker run -p 4000:4000 web-embeejayz:latest
La aplicación SSR estará disponible en http://localhost:4000.
👑 El Enjambre & Créditos de la Comunidad
Esta plataforma es el resultado del esfuerzo y cariño de la comunidad:
- Streamer Embeejayz
- Artistas: Su1zide
- Diseño de Interfaz & UX: GountzJs
- Desarrollo: GountzJs
- Equipo de Staff & Moderación: Skivel Su1zide GountzJs
🌐 Enlaces Oficiales
- Twitch: twitch.tv/embeejayz
- Twitter / X: @EmBeeJay_
- Instagram: @embeejayz
- Enlaces Útiles: links.embeejayz.com