Enlaces externos configurables Nuevo
Tema: Botones que Existential configura y que llevan al usuario fuera de la plataforma Idioma: ES Estado: Propuesta a debatir con el cliente
Resumen en pocas palabras
Existential puede crear ítems en la barra lateral que llevan a un destino externo: una agenda de Calendly, un formulario, cualquier enlace. Cada uno tiene título, ícono, enlace y un interruptor de activo. Quién los ve se controla con un permiso, así que cada organización decide si sus usuarios los tienen o no.
El primer caso es el botón Solicitud de E-Session —para reservar una sesión real con una persona—, pero la funcionalidad es general y sirve para dos cosas a la vez:
- Ofrecer servicios que no viven en la plataforma sin esperar a que exista el módulo que los gestione.
- Medir demanda antes de invertir. Cada clic queda registrado. Si un botón se usa mucho, hay evidencia concreta para construir el flujo de verdad; si no se usa, se apaga con un interruptor y no costó nada.
Cómo se vería
Para la persona — un ítem más en la barra lateral, entre lo que ya usa:
┌──────────────────┐
│ Inicio │
│ Mi perfil │
│ E-map │
│ Brun-E │
│ Marco teórico │
│ ──────────── │
│ 📅 Solicitar │
│ E-Session ↗ │
└──────────────────┘
La flecha indica que sale de la plataforma. Al hacer clic se abre en una pestaña nueva; la persona no pierde donde estaba.
Para Existential — administración de enlaces:
┌─────────────────────────────────────────────────────────┐
│ Enlaces externos [ + Nuevo enlace ] │
│ │
│ ⣿ 📅 Solicitar E-Session activo 124 ⋮ │
│ ⣿ 📝 Encuesta de satisfacción activo 37 ⋮ │
│ ⣿ 🎓 Inscripción E-Training 3 inactivo 0 ⋮ │
│ │
│ Arrastrá para reordenar │
└─────────────────────────────────────────────────────────┘
La columna de la derecha es la cantidad de clics acumulados.
Qué se configura
| Campo | Detalle |
|---|---|
| Título | Lo que se lee en la barra lateral |
| Ícono | Elegido de un conjunto predefinido; no se suben imágenes |
| Enlace | Obligatorio. Se valida que sea una dirección bien formada y segura (https) |
| Activo | Interruptor. Un enlace inactivo desaparece de la barra lateral de todos |
| Orden | Posición respecto de los demás enlaces |
Se valida el formato del enlace, no que el destino exista o funcione: eso queda del lado de quien lo carga.
Quién lo ve y quién lo edita
Ver — permiso nuevo, uno solo para todos los enlaces. Cada organización decide a qué roles se lo asigna. Sin el permiso, el ítem no aparece en la barra lateral y tampoco se entrega desde el servidor: no es esconder un botón en pantalla, es no enviarlo.
Editar — permiso separado, asignable únicamente a roles de organizaciones SUPER_ADMIN, con la misma regla que ya rige para el recurso ORGANIZATION (02-permisos.md).
Nota sobre el modelo de permisos. Los permisos del sistema son una lista cerrada: se definen en desarrollo y se agregan por migración (02-permisos.md). Por eso hay un permiso único para todos los enlaces, y no uno por enlace: crear un botón nuevo no puede crear un permiso nuevo sin cambiar esa regla. La consecuencia práctica es que quien tiene el permiso ve todos los enlaces activos, no un subconjunto. Si más adelante hace falta mostrar distintos enlaces a distintos roles, es un cambio de alcance — ver D-23.4.
Al hacer clic
- Se abre en pestaña nueva. La persona no pierde el contexto en el que estaba.
- Se aplica la protección estándar para que el sitio de destino no pueda manipular la pestaña de origen.
- Se registra quién, qué enlace y cuándo. Ese registro es el que da la métrica de uso.
No se envían datos de la persona al destino. Precargar el nombre o el email en el formulario externo es otro alcance y otra conversación — implica compartir datos personales con un tercero.
Actores
| Actor | Qué hace |
|---|---|
| Persona | Ve los enlaces que su rol le habilita y los usa. |
| Administrador de Existential | Crea, edita, ordena, activa y desactiva enlaces; consulta cuántos clics tuvo cada uno. |
| Administrador de la organización | Decide qué roles de su empresa tienen el permiso de ver los enlaces. |
| Sistema | Entrega solo los enlaces activos que la persona puede ver, y registra cada clic. |
Casos de uso
| # | Caso | Qué pasa |
|---|---|---|
| CU-1 | Usar un enlace | La persona ve el ítem en la barra lateral, hace clic y llega al destino en una pestaña nueva. |
| CU-2 | Crear un enlace | El administrador de Existential carga título, ícono y dirección, lo activa y queda disponible. |
| CU-3 | Activar o desactivar | Apaga un enlace y desaparece de la barra lateral de todos, sin borrarlo ni perder su historial de clics. |
| CU-4 | Reordenar | Cambia el orden en que aparecen los enlaces. |
| CU-5 | Ver el uso | Consulta cuántos clics acumuló cada enlace. |
| CU-6 | Habilitar el acceso en una organización | El administrador de la organización asigna el permiso de ver enlaces a los roles que corresponda. |
Reglas de negocio
| # | Regla |
|---|---|
| R-1 | Un enlace inactivo no lo ve nadie, sin importar sus permisos. |
| R-2 | Sin el permiso de ver enlaces, no se entregan desde el servidor. |
| R-3 | Solo roles de organizaciones SUPER_ADMIN pueden crear o editar enlaces. |
| R-4 | El enlace debe ser una dirección bien formada y https. |
| R-5 | Todos los enlaces se abren en pestaña nueva. |
| R-6 | Cada clic queda registrado con la persona, el enlace y el momento. |
| R-7 | Desactivar o borrar un enlace no elimina los clics ya registrados. |
| R-8 | Quien tiene el permiso de ver enlaces ve todos los activos; no hay visibilidad por enlace. |
| R-9 | Los enlaces son los mismos para todas las organizaciones. |
Lo que ya existe hoy
| Componente | Estado |
|---|---|
| Enlaces configurables, administración, registro de clics | Nuevo |
| Catálogo de permisos y asignación a roles | Existe (02-permisos.md, 03-roles.md) |
| Regla de permisos exclusivos de organizaciones SUPER_ADMIN | Existe — la usa el recurso ORGANIZATION |
| Barra lateral de navegación | Existe — hay que hacerla capaz de mostrar ítems configurables |
| Interfaz en tres idiomas | Existe — ver D-23.1 para el título de cada enlace |
Decisiones a debatir con el cliente
| # | Pregunta | Impacto |
|---|---|---|
| D-23.1 | ¿El título va en los tres idiomas o solo en español? La plataforma funciona en es/en/pt. Un título por idioma con respaldo en español es un poco más de administración; uno solo deja el ítem en español para todos. | Menor, pero conviene definirlo antes de construir. |
| D-23.2 | ¿Alcanza con el conteo de clics, o hace falta saber qué personas hicieron clic? Lo segundo es más útil para seguimiento comercial y más delicado en privacidad. | Alcance y privacidad. No incluido. |
| D-23.3 | ¿La E-Session necesita algo más que el enlace — por ejemplo, avisar a alguien de Existential cuando alguien la solicita? Con Calendly probablemente no, porque el aviso lo da Calendly. | Puede sumar notificaciones (16-notificaciones.md). |
| D-23.4 | ¿Hace falta mostrar distintos enlaces a distintos roles? Con el permiso único, quien lo tiene ve todos. Segmentar por enlace obliga a revisar la regla de lista cerrada de permisos. | Alto si la respuesta es sí. No incluido. |
| D-23.5 | ¿El super admin necesita elegir a qué organizaciones llega cada enlace? Hoy la propuesta es que sean globales y que cada organización filtre con el permiso. | Alcance. No incluido. |
| D-23.6 | ¿Los enlaces aparecen solo en la barra lateral, o también en otros lugares —al terminar una sesión de Brun-E, en el E-map, en el perfil—? Cada ubicación nueva es un cambio chico, pero hay que decidir cuáles. | Alcance incremental. No incluido. |
Composición del trabajo
Es un módulo chico. Una sola fase.
| Pieza | Qué implica |
|---|---|
| El enlace como objeto | Título, ícono, dirección, activo, orden. |
| Los dos permisos | Ver y editar, agregados al catálogo por migración; el de edición restringido a organizaciones SUPER_ADMIN. |
| Administración | Crear, editar, activar/desactivar, reordenar, validar la dirección. |
| Ítems en la barra lateral | Que la navegación pueda mostrar ítems que vienen del servidor y no están escritos en el código. |
| Apertura segura | Pestaña nueva con la protección correspondiente. |
| Registro de clics y conteo | Guardar cada uso y mostrar el total en la administración. |
| Textos en tres idiomas y pruebas | Interfaz en es/en/pt, pruebas automatizadas, revisión y despliegue. |
Se puede recortar en una primera versión: el reordenamiento arrastrando, con un número de orden escrito a mano; el conteo de clics en pantalla —lo importante es registrarlos desde el día uno, mostrarlos es una pantalla más—; y el ícono, fijándolo por defecto en lugar de configurable.
Inversión
USD 150 — precio cerrado por este entregable. Se contrata por separado: no depende de ningún otro documento de esta serie ni condiciona lo que se decida sobre los demás.
Incluye
- El enlace como objeto: título, ícono, dirección, activo, orden.
- Los dos permisos —ver y editar—, con el de edición restringido a organizaciones SUPER_ADMIN.
- Administración para crear, editar, activar, desactivar, reordenar y validar la dirección.
- Ítems en la barra lateral que vienen del servidor y no están escritos en el código.
- Apertura en pestaña nueva con la protección correspondiente.
- Registro de clics y conteo visible en la administración.
- Interfaz en español, inglés y portugués.
- Pruebas automatizadas, revisión y puesta en producción.
- Reuniones de definición y seguimiento durante la construcción.
- Dos rondas de ajuste sobre lo entregado.
No incluye
- Visibilidad configurable enlace por enlace (D-23.4). Es lo que más movería el alcance: obliga a revisar cómo se administran los permisos en todo el sistema. Con lo incluido, todos los enlaces se controlan con un mismo permiso.
- Enlaces distintos por organización (D-23.5).
- Mostrarlos en otros lugares además de la barra lateral (D-23.6).
- Precargar datos de la persona en el formulario externo. Implica compartir datos personales con un tercero y definir el consentimiento: es otro proyecto.
- Informe de uso más allá del conteo —quién, cuándo, evolución en el tiempo— (D-23.2).
Supuestos. Los enlaces son los mismos para todas las organizaciones que tengan el permiso, y el destino —Calendly, formulario o lo que sea— ya existe y lo provee Existential. Si alguno cambia, o se pide algo del bloque No incluye, se cotiza antes de ejecutarse.
Forma de pago: 50% al inicio, 50% contra entrega.
Relación con otros documentos
- 02-permisos.md — catálogo cerrado de permisos y regla de los recursos exclusivos de SUPER_ADMIN.
- 03-roles.md — asignación del permiso a los roles de cada organización.
- 16-notificaciones.md — dependencia solo si se decide avisar a alguien ante una solicitud (D-23.3).
- 18-capsulas-entrenamiento.md — mismo criterio de embeber contenido externo en lugar de construirlo (D-18.1).
Correcciones / historial de validación
| Fecha | Versión | Cambio |
|---|---|---|
| 2026-08-03 | v1.0 | Documento inicial. Surge del pedido de un botón de Solicitud de E-Session, generalizado a enlaces externos configurables. Incluye configuración desde organizaciones SUPER_ADMIN, control de visibilidad por permiso único —con la restricción que impone la lista cerrada de permisos—, apertura en pestaña nueva, registro de clics, decisiones abiertas y composición del trabajo. |
| 2026-08-10 | v1.1 | Recorte de lectura: se fusionan Resumen y Objetivo de negocio, Qué agranda el trabajo se absorbe en No incluye y en la tabla D-23.x, y los casos de uso pasan a tabla. Sin cambios de alcance ni de precio. |