Ejemplos

Ejemplos y Tutoriales

Descubre ejemplos del mundo real y tutoriales paso a paso que demuestran cómo construir aplicaciones con Veloce-TS.

🎯 Ejemplos de Inicio Rápido

API Hello World

Una API simple “Hello World” perfecta para principiantes para entender los fundamentos de Veloce-TS.

Perfecto para: Aprender los fundamentos de Veloce-TS

Características demostradas:

• ✅ Routing basado en decoradores
• ✅ Validación de solicitudes con Zod
• ✅ Documentación OpenAPI automática
• ✅ Soporte TypeScript
• ✅ Soporte multi-idioma

TaskMaster - Sistema de Gestión de Tareas

Un ejemplo completo de backend que muestra todas las características de Veloce-TS incluyendo autenticación, RBAC, GraphQL, WebSockets y más.

Perfecto para: Entender las capacidades completas del framework

Características demostradas:

• ✅ Routing basado en decoradores
• ✅ Autenticación JWT & RBAC
• ✅ Integración SQLite
• ✅ Soporte GraphQL
• ✅ Handlers WebSocket
• ✅ Middleware personalizado
• ✅ Documentación OpenAPI

API de Gestión Financiera

Un sistema empresarial de control financiero listo para producción que demuestra lógica de negocio real avanzada con caché, auditoría y gestión automática de inventario.

Perfecto para: Construir aplicaciones empresariales listas para producción

Características demostradas:

• ✅ 7 Controladores REST (Auth, Ingresos, Gastos, Materiales, Empleados, Cheques, Notificaciones)
• ✅ Autenticación JWT con bcrypt
• ✅ PostgreSQL + Prisma ORM
• ✅ Caché Redis con invalidación inteligente
• ✅ Lógica de negocio compleja (auto-crear materiales desde gastos)
• ✅ Logging estructurado con Winston
• ✅ Health checks y monitoreo
• ✅ Registro de auditoría para cumplimiento
• ✅ Documentación OpenAPI/Swagger
• ✅ Docker Compose para configuración fácil

🏗️ Próximamente

Estamos trabajando en más ejemplos para ayudarte a comenzar:

Plataforma de Blog

• Gestión de artículos
• Sistema de comentarios
• Autenticación de usuarios
• Categorización de contenido
• Funcionalidad de búsqueda

Aplicación de Chat

• Mensajería en tiempo real
• Presencia de usuarios
• Gestión de salas
• Historial de mensajes
• Compartir archivos

API de Redes Sociales

• Perfiles de usuario
• Publicaciones y comentarios
• Sistema de seguimiento
• Notificaciones
• Moderación de contenido

📚 Serie de Tutoriales

Serie Principiante

1. API Hello World - Tu primera aplicación Veloce-TS
2. Operaciones CRUD Básicas - Construyendo una API simple de tareas
3. Configuración de Autenticación - Agregando autenticación JWT
4. Integración de Base de Datos - Trabajando con bases de datos

Serie Intermedia

1. Desarrollo de Middleware - Creando middleware personalizado
2. Integración GraphQL - Construyendo APIs GraphQL
3. Implementación WebSocket - Características en tiempo real
4. Estrategias de Testing - Probando tus aplicaciones

Serie Avanzada

1. Arquitectura de Microservicios - Construyendo sistemas distribuidos
2. Optimización de Rendimiento - Escalando tus aplicaciones
3. Mejores Prácticas de Seguridad - Asegurando tus APIs
4. Estrategias de Despliegue - Despliegue en producción

🎨 Ejemplos de la Comunidad

¿Has construido algo genial con Veloce-TS? ¡Nos encantaría mostrarlo!

• Envía tu ejemplo via GitHub Issues
• Comparte tu proyecto en nuestra comunidad Discord
• Escribe un tutorial y lo destacaremos aquí

🛠️ Contribuir Ejemplos

¿Quieres contribuir con un ejemplo? Así es como:

1. Hacer fork del repositorio
2. Crear tu ejemplo en el directorio examples/
3. Agregar documentación explicando tu implementación
4. Enviar un pull request

Requisitos del Ejemplo

• Código claro y bien documentado
• README con instrucciones de configuración
• Demuestra características específicas de Veloce-TS
• Incluye datos de muestra o usuarios demo
• Sigue nuestros estándares de código

📖 Ruta de Aprendizaje

Para Principiantes

1. Comienza con Hello World para aprender los fundamentos
2. Sigue la Guía de Inicio
3. Experimenta con decoradores y validación
4. Pasa a TaskMaster para características avanzadas

Para Desarrolladores Experimentados

1. Explora características avanzadas en TaskMaster
2. Sumérgete en GraphQL y WebSockets
3. Aprende sobre Inyección de Dependencias
4. Implementa plugins personalizados y middleware

🔗 Recursos Adicionales

• Documentación - Documentación completa del framework
• Referencia de API - Documentación detallada de la API
• Repositorio GitHub - Código fuente e issues
• Comunidad Discord - Obtén ayuda y comparte proyectos

---

:::tip ¿Listo para Empezar? ¡Elige un ejemplo que coincida con tu nivel de experiencia y comienza a construir con Veloce-TS hoy! :::