ADR-005: Convencion de Nombres de la Plataforma
Estado: Aceptada
Fecha: 2026-05-18
Autor: Equipo de Arquitectura
Contexto
La plataforma necesita una convencion de nombres consistente que aplique a:
- Nombre de la plataforma
- Nombres de productos
- Repositorios de codigo
- Bases de datos
- Dominios y URLs
- Servicios internos
La consistencia en nombres reduce friccion cognitiva, facilita la navegacion del codigo y refuerza la identidad de marca.
Decision
Adoptar "Imagy" como nombre de la plataforma, derivado del nombre de la empresa (Reimagine). Los productos usan el prefijo "Imag" seguido del dominio:
Productos
| Producto | Dominio | Descripcion |
|---|---|---|
| ImagFlow | Orquestacion | Motor de flujos y orquestacion de proveedores |
| ImagLend | Credito | Originacion y gestion de creditos |
| ImagSign | Firma | Firma electronica y gestion documental |
| ImagID | Identidad | Verificacion de identidad y KYC |
| ImagGuard | Seguridad | Autenticacion, autorizacion y auditoria |
Repositorios
Formato: imagy-{dominio}[-calificador]
imagy-flow # Motor de flujos
imagy-lending # Servicio de creditos
imagy-sign # Servicio de firma
imagy-id # Servicio de identidad
imagy-guard # Servicio de seguridad
imagy-platform # Infraestructura compartida
imagy-docs # Documentacion
imagy-flow-ui # Frontend de flujos
imagy-lending-ui # Frontend de creditosBases de Datos
Formato: imagy_{dominio}
imagy_flow
imagy_lending
imagy_sign
imagy_subject
imagy_guardServicios y Dominios
api.reimaginetech.io # API Gateway principal
flow.reimaginetech.io # ImagFlow
lending.reimaginetech.io # ImagLend
sign.reimaginetech.io # ImagSign
id.reimaginetech.io # ImagID
guard.reimaginetech.io # ImagGuard
app.reimaginetech.io # Frontend principal
docs.reimaginetech.io # Documentacion publicaAlternativas Consideradas
| Alternativa | Pros | Contras |
|---|---|---|
| Prefijo "Reimagine" (ReFlow, ReLend) | Conexion directa con empresa | Muy largo, "Re" es generico y comun |
| Prefijo "Re-" (Re-Flow, Re-Lend) | Corto | Confuso con prefijo "re" del idioma, problemas con guiones en nombres tecnicos |
| Nombres completamente diferentes | Libertad creativa | Sin cohesion, dificil de recordar como familia |
| Prefijo "Imag" con plataforma "Imagy" (elegida) | Corto, memorable, cohesivo, derivado de la marca | Requiere verificar disponibilidad de dominio |
Consecuencias
Positivas
- Consistente y predecible: dado un dominio, se puede inferir el nombre del repo, DB y servicio
- Corto y memorable: facil de escribir en CLI, imports y configuraciones
- Cohesivo como familia de productos: todos comparten el prefijo "Imag"
- Funciona bien para dominios web (reimaginetech.io es corto y disponible)
- Auto-explicativo: ImagLend claramente es lending, ImagSign es firma
Negativas
- Requiere migrar nombres existentes si ya hay repos o servicios con otra convencion
- "Imagy" podria no ser inmediatamente obvio para externos (requiere branding)
Riesgos
- Disponibilidad del dominio reimaginetech.io debe verificarse
- Si la empresa cambia de nombre, el prefijo pierde su conexion semantica