Architecture Decision Record

Active theme: Light

← Plantillas de registro de decisión

Plantilla de registro de decisión para un caso de negocio

Esta plantilla de ADR hace hincapié en elaborar un caso de negocio para una decisión, con criterios, candidatos y costos.

Nivel superior

  • Título
  • Estado
  • Criterios de evaluación
  • Candidatos a considerar
  • Investigación y análisis de cada candidato
    • Cumple o no cumple los criterios, y por qué
    • Análisis de costos
    • Análisis FODA (SWOT)
    • Opiniones y comentarios
  • Recomendación

Análisis detallado de bajo nivel

Título:

  • Una frase breve en imperativo y tiempo presente, de menos de 50 caracteres, como un mensaje de commit de git.

Estado:

  • Uno de: propuesto, aceptado, rechazado, obsoleto, sustituido, etc.

Criterios de evaluación:

  • Resumen: explique brevemente qué buscamos descubrir y por qué.

  • Detalles

Candidatos a considerar:

  • Resumen: explique brevemente cómo descubrimos los candidatos y llame la atención sobre cualquier valor atípico.

  • Enumere todos los candidatos y opciones relacionadas; ¿qué estamos evaluando como posibles soluciones?

  • Detalles

Investigación y análisis de cada candidato:

  • Resumen: explique brevemente los métodos de investigación y llame la atención sobre patrones, agrupaciones y valores atípicos.

  • Cumple o no cumple los criterios, y por qué

    • Resumen

    • Detalles

  • Análisis de costos

    • Resumen

    • Ejemplos

      • Licencias, como acuerdos contractuales y compromisos legales

      • Capacitación, como mejora de habilidades y gestión del cambio

      • Operación, como soporte y mantenimiento

      • Medición del consumo, como ancho de banda y uso de CPU

  • Análisis FODA (SWOT)

    • Resumen

    • Fortalezas (Strengths)

    • Debilidades (Weaknesses)

    • Oportunidades (Opportunities)

    • Amenazas (Threats)

  • Opiniones y comentarios internos

    • Resumen

    • Ejemplos

      • Del equipo, idealmente escritos por la persona misma

      • De otras partes interesadas

      • Atributos de calidad, también llamados requisitos transversales

  • Opiniones y comentarios externos

    • Resumen

    • ¿Quién ofrece la opinión?

    • ¿Qué otros candidatos consideró?

    • ¿Qué está creando?

      • Ejemplos

        • B2B o B2C

        • orientado al exterior o solo para empleados

        • escritorio o móvil

        • piloto o producción

        • monolito o microservicios

    • ¿Cómo evaluó a los candidatos?

    • ¿Por qué eligió al ganador?

    • ¿Qué ha ocurrido desde entonces?

      • Ejemplos

        • ¿Cómo se está desempeñando el ganador?

        • ¿Qué porcentaje del tráfico real de usuarios en producción fluye por el ganador?

        • ¿Qué tipos de integraciones intervienen, como con canalizaciones de entrega continua, sistemas de gestión de contenido, analítica y métricas, etc.?

        • Sabiendo lo que sabe ahora, ¿qué aconsejaría hacer de otra manera?

  • Anécdotas

Recomendación:

  • Resumen

  • Detalles