1. Skip to content

1. Índice General

Documento vivo de estándares, buenas prácticas y decisiones técnicas del equipo.

Si se encuentra una mejora, ¡se agradece su actualización!

Última actualización: 2026-01-22

1.1 📖 Índice General

1.1.1 🎯 Fundamentos

  • Fundamentos
    • Niveles de criticidad
    • Fundamentos de red (Cliente-Servidor, IP, DNS, Load Balancer)
    • Reglas generales de código
    • Reglas por lenguaje
    • Reglas por framework
  • Onboarding
    • Guía de inicio, Arquitectura, Primer PR

1.1.2 🔬 Desarrollo y Testing

1.1.3 🏗️ Arquitectura y Diseño

  • Arquitectura y Patrones
    • Arquitecturas de software
    • Teorema CAP (Consistency, Availability, Partition Tolerance)
    • Escalabilidad: Vertical vs Horizontal
    • Arquitectura Hexagonal (Ports & Adapters)
    • Onion Architecture (Arquitectura de Cebolla)
    • Clean Architecture
    • Domain-Driven Design (DDD)
    • Screaming Architecture
    • Patrones de diseño
    • Patrones arquitectónicos avanzados
    • FSM (Finite State Machines)
  • Sesgos Cognitivos, Falacias y Leyes
    • Sesgos cognitivos, Falacias lógicas, Leyes paradójicas, Efectos psicológicos

1.1.4 🚀 Operaciones

1.1.5 🛠️ Resolución de Problemas y Mejora

1.1.6 ⚡ Performance y Producción

1.1.7 💾 Datos y APIs

  • Bases de Datos
    • SQL, NoSQL, Time Series, Graph, Columnar, In-memory
  • APIs y Protocolos
    • REST, GraphQL, gRPC, WebSockets, Event-Driven
    • Documentación por protocolo
    • Patrones de comunicación

1.1.8 📱 Interfaces y Experiencia

1.1.9 ☁️ Infraestructura y Costos

1.1.10 🤖 Datos Avanzados

1.1.11 📊 Estrategia y Negocio

1.1.12 👥 Roles y Cultura

1.1.13 📝 Documentación y Convenciones

  • Documentación y Diagramas
    • Markdown, Mermaid, LaTeX, PlantUML, C4, ER, UML
    • Tipos de diagramas: flujo, secuencia, clases, estado
  • Convenciones
    • Nomenclatura, Git/GitOps, i18n/l10n, Configuración, Dependencias

1.1.14 🤖 AI y Automatización

1.1.15 ⚖️ Ética y Gobernanza

1.1.16 📝 Comunicación y Artefactos

1.1.17 🔧 Gestión Técnica

1.1.18 🛡️ Resiliencia y Datos

1.1.19 📝 Gobernanza Low-Code/No-Code (LCNC)

  • Gobernanza Low-Code/No-Code (LCNC)
    • ¿Qué es LCNC Governance?, Riesgos Clave de LCNC, Políticas de Seguridad y Acceso, Data Governance para LCNC, Ciclo de Vida y Auditoría, Roles y Accountability, Anti-patrones, Recursos.

1.1.20 📚 Casos de Estudio

  • Casos de Estudio
    • Análisis detallado de proyectos reales con decisiones técnicas y arquitectónicas justificadas
    • Portafolio Personal (TypeScript, Angular, SQLite): Arquitectura Hexagonal, Screaming Architecture, i18n, ADRs

1.1.21 📝 Recursos de práctica de código y preparación para entrevistas

1.1.22 📝 Glosario

  • Glosario
    • Glosario de términos técnicos y conceptos.

1.1.23 📝 Reportes y Templates

Tipo de Reporte Template Ejemplo
Bug Report 📄 Ver Template 🐛 Ver Ejemplo
Feature Request 📄 Ver Template 💡 Ver Ejemplo
Post-Mortem 📄 Ver Template 💀 Ver Ejemplo
RFC 📄 Ver Template 📝 Ver Ejemplo

1.2 🎯 Cómo usar esta guía

1.2.1 Para nuevos desarrolladores

  1. Comenzar por Fundamentos
  2. Leer Onboarding
  3. Consultar Disciplinas de Desarrollo
  4. Revisar convenciones del lenguaje/framework que usarás

1.2.2 Para arquitectos

  1. Revisar Arquitectura y Patrones
  2. Consultar Infraestructura y Cloud
  3. Validar contra Seguridad
  4. Implementar Observabilidad

1.2.3 Para product managers

  1. Estudiar Product Management
  2. Definir Métricas y KPIs
  3. Usar Análisis Estratégico
  4. Aplicar Herramientas de Problemas

1.2.4 Para DevOps/SRE

  1. Implementar DevOps
  2. Configurar Observabilidad
  3. Optimizar Performance
  4. Gestionar Infraestructura Cloud

1.2.5 Para resolución de problemas

  1. Aplicar Herramientas de Problemas
  2. Usar Mejora Continua
  3. Consultar Testing
  4. Revisar Observabilidad

1.3 📋 Niveles de Criticidad

Criticidad Abrev. Explicación
Crítico 🔴 Incumplimiento = bug de seguridad o caída.
Alto 🟠 Afecta mantenibilidad o rendimiento.
Estilo 🟢 Preferencia de equipo, sin impacto funcional.

1.4 🤝 Contribuciones

Este documento es vivo y colaborativo:

  1. Proponer mejoras: Abrir PR con cambios sugeridos
  2. Reportar errores: Issues con etiqueta docs
  3. Agregar ejemplos: Ejemplos concisos con enlaces
  4. Actualizar herramientas: Mantener versiones y links actualizados

1.5 📚 Recursos Adicionales

Mantenedores: David Rolón (https://github.com/davichuder)