👋 Día 1 - Bienvenida y Contexto del Equipo

¡Bienvenido al equipo! 🎉

Al final de este día comprenderás nuestra misión, dominarás el contexto técnico y sabrás exactamente cómo contribuir al equipo.

🎯 Misión y Productos del Equipo

¿Qué Construimos?

🏨 Web Tenant - Whitelabel para XXXXX

TODO

🏗️ Arquitectura de Soluciones

Modernización Progresiva:

Current Stack: ASP.NET Core 8 + Vue.js 3 con TypeScript (desarrollo activo)
Microfrontends: Componentes Vue.js embebidos en aplicaciones ASP.NET existentes

💻 Stack Tecnológico y Decisiones Clave

🏛️ Principios Arquitectónicos

SOLID + Clean Architecture

Base fundamental para organización de código y mantenibilidad a largo plazo

Domain-Driven Design

Modelado del dominio que refleja la realidad del negocio de reservas

Repository Pattern + Dapper

Sin Entity Framework. Preferimos control granular sobre queries SQL

🔧 Stack Backend (.NET)

Stack Moderno

Nuevos Desarrollos:

.NET Core 8: Runtime multiplataforma y performance mejorado
ASP.NET Core Web API: APIs REST para microfrontends
Dapper: Mantiene consistencia con proyectos existentes

🎨 Stack Frontend (Evolución)

Tecnología	Estado	Uso
Vue.js 3 + TS	✅ Activo	Motor de reservaciones (microfrontends)
Composition API	✅ Estándar	Obligatorio para todos los componentes Vue
ASP.NET Views	🔄 Actual	Plataformas administrativas independientes

🗄️ Bases de Datos Multi-Engine

PostgreSQL: Base principal
MongoDB: Logs, configuraciones, datos semi-estructurados
DynamoDB: Configuraciones
Redis: Cache distribuido y gestión de sesiones

👥 Estructura del Equipo y Roles

🏢 Organización

Equipo FullStack:

Todo el equipo puede aportar tanto en front como en back
Colaboración cross-vertical cuando es necesario
Colaboración flexible aunque cada persona puede tener áreas de mayor experiencia, todos contribuyen donde se necesite

🤝 Ceremonias del Equipo

Daily Standup: 11:00 AM (30 min) - Sincronización diaria
Sprint Planning: Bi-weekly - Planificación de iteraciones
Tech Talks: Cada 2 semanas - Mejora continua y Sharing de conocimiento técnico

📚 Cultura de Documentación

🎯 Principios de Documentación

“La documentación es parte del desarrollo, no una actividad separada”

✅ Living Documentation: Se actualiza junto con el código
✅ Audience-Driven: Contenido específico para cada audiencia
✅ Actionable: Comandos copy-paste que funcionan
✅ Searchable: Organización que facilita encontrar información

📁 Estructura de Conocimiento

📁 Documentación del Equipo
├── 🏢 Productos/                   # Capacidades de negocio
│   ├── Web Tenant
│   └── Home
├── 💻 Proyectos/                   # Repositorios técnicos específicos
│   ├── Web-tenant                 # ASP.NET + Vue.js microfrontends
│   ├── Plataformas-Admin          # ASP.NET independientes
│   ├── APIs                       # .NET Core APIs
│   └── Shared-Libraries
├── 📖 Guías de Desarrollo/         # Conocimiento técnico profundo
│   ├── Backend .NET/
│   ├── Frontend Vue.js/            # ← Para microfrontends
│   └── Database Guidelines/
└── ⚙️ Procesos/                    # Workflows del equipo
    ├── Code Review Process
    ├── Deployment Guidelines
    └── Incident Response

Markdown + Starlight:

Editor: VS Code con extensión markdownlint
Sintaxis: MDX con componentes Astro (<Aside>, <Card>, etc.)
Audiencia: Siempre pensar en quién va a leer

Pull Request Workflow:

Crear branch desde master
Escribir/actualizar contenido
Self-review con checklist
PR con al menos 1 approval
Merge y deploy automático

🔄 Workflows y Procesos

💻 Code Review Process

Estándares de Calidad:

Backend: SOLID principles, unit tests, performance considerations
Frontend: Composition API, TypeScript strict, accesibilidad
Database: Índices apropiados, queries optimizadas, migrations seguras

Review Checklist:

✅ Functionality: ¿Resuelve el problema correctamente?
🧹 Code Quality: ¿Sigue nuestros estándares?
🚀 Performance: ¿No introduce regresiones?
📋 Documentation: ¿Está documentado lo necesario?

🚀 Deployment Guidelines

🧪 Development

Deploy manual desde feature branches

Ambiente para testing de features

🎭 Staging

Deploy manual desde feature branches

Validación final pre-producción

🏭 Production

Deploy controlado con aprobaciones

Rollback strategy siempre disponible

📞 Comunicación

Canales por Propósito:

💬 Discord: Comunicación diaria, quick questions
🏗️ GitHub: Work items, bugs, user stories
📧 Email: Comunicación formal, stakeholders externos
🎯 Discord Meetings: Sincronización, pair programming

🗺️ Mapa de Recursos y Herramientas

🔧 Herramientas de Desarrollo

Categoría	Herramienta	Propósito
IDE Principal	Visual Studio 2022 Community	Desarrollo .NET + debugging
Editor Ligero	VS Code	Frontend, scripts, markdown
Package Manager	pnpm	Frontend dependencies (microfrontends)
Base de Datos	DBeaver Community	Manager universal SQL/NoSQL
Redis Client	Another Redis Desktop Manager	Gestión cache y sesiones
Version Control	Git + GitHub	Source control
API Testing	Postman	Testing de endpoints

🌐 Aplicaciones Internas del Ecosistema

URLs de Acceso:

📚 Recursos de Aprendizaje

Documentación Técnica:

Clean Architecture Guide
Vue.js 3 Frontend Patterns ← Para microfrontends
Database Patterns with Dapper

Referencias Externas:

ASP.NET Core Documentation
Vue.js 3 Official Guide ← Para microfrontends
Dapper Documentation

✅ Checklist de Finalización - Día 1

Al terminar el día, deberías poder responder:

🎯 Contexto del Equipo

Productos: ¿Cuáles son las 3 verticales y qué aplicaciones incluye cada una?
Stack: ¿Cuándo usar microfrontends vs aplicaciones independientes?
Arquitectura: ¿Cómo encajan las diferentes tecnologías en cada vertical?

👥 Personas y Procesos

Colaboración: ¿Cómo funciona el trabajo cross-vertical y fullstack?
Workflows: ¿Cómo funciona code review y deployment?
Comunicación: ¿Qué canal usar para cada propósito?

📚 Recursos

Herramientas: ¿Qué usamos para cada stack (frontend vs backend)?
Aplicaciones: ¿Dónde están los sistemas internos del ecosistema?
Documentación: ¿Cómo contribuir y mantener actualizada?

🤝 ¡Bienvenido al Equipo!

Ahora tienes una comprensión sólida de:

✅ Qué construimos en la empresa
✅ Cómo trabajamos como equipo fullstack en múltiples stacks
✅ Con quién colaboras y cómo comunicarte efectivamente
✅ Dónde encontrar la información que necesitas

Próximo paso: Día 2 - Setup Completo del Entorno donde configuraremos todas las herramientas para que seas completamente productivo.

¿Preguntas sobre algo específico? No dudes en consultar a cualquier miembro del equipo usando los canales de comunicación apropiados. ¡Estamos aquí para ayudarte! 🎉