Marco Teórico — biblioteca de contenido para el usuario Nuevo
Tema: Biblioteca de contenido teórico que las personas leen dentro de la plataforma Idioma: ES Estado: Propuesta a debatir con el cliente
Resumen en pocas palabras
Una sección Marco teórico dentro de la plataforma, con su propio índice a la izquierda, donde Existential publica contenido para que las personas aprendan sobre los E-Modes y sobre el modelo. El contenido se carga como piezas ya diseñadas —textos con imágenes, gráficos, formato propio— y el autor arma el índice: qué va primero, qué cuelga de qué, y qué artículo se relaciona con cuál.
El objetivo es que la persona pueda formarse sobre el modelo dentro de la plataforma, en lugar de depender de material suelto o de una sesión presencial; y que Existential pueda publicar y corregir ese material sin depender del equipo de desarrollo.
No existe nada de esto hoy. Es un módulo nuevo.
Por qué este documento existe, y su relación con el 12b
El nombre "Marco Teórico" venía nombrando dos cosas distintas, y la confusión ya costó una vuelta entera de análisis:
| Qué es | Quién lo consume | Dónde se trata | |
|---|---|---|---|
| Base de conocimiento de Brun-E | Fichas breves etiquetadas por E-Mode que el asistente consulta durante una conversación | Un modelo de lenguaje | 12b-base-conocimiento-brune.md |
| Marco teórico como contenido | Material de lectura con formato e imágenes, para entender el modelo | Una persona | Este documento |
Son dos productos distintos con dos formatos incompatibles: lo que sirve para que un modelo responda bien —texto plano, corto, auto-contenido— es exactamente lo que no sirve para que una persona lea y entienda, y al revés.
Cuál de los dos pidió el cliente: este. La solicitud es migrar hacia la plataforma la información sobre eModes y el material complementario que hoy está afuera, en PDFs y documentos sueltos, para que la gente lo lea adentro.
La base de conocimiento de Brun-E ya está construida y quedó fuera del presupuesto. El 12b sigue siendo válido como diagnóstico de sus límites, pero no se ofrece como módulo.
Nota de relevamiento (2026-08-03). Al contrastar el 12b con el código se detectó que la base de conocimiento de Brun-E puede no estar usándose hoy en las conversaciones. La herramienta existe y está habilitada, y la administración está construida, pero que el asistente efectivamente la consulte depende de la configuración del prompt, que vive fuera del sistema. Conviene verificarlo. No afecta a este documento.
Qué se publica
No es una ficha por E-Mode. Es una biblioteca abierta:
- Contenido inicial: los nueve E-Modes y cómo leerlos.
- Contenido eventual: lo que Existential vaya produciendo — un tema nuevo, una ampliación, material de apoyo.
Por eso la estructura no puede estar fijada de antemano. El autor crea las entradas que necesita, las agrupa y las ordena.
El índice admite tres niveles — por ejemplo E-Modes → E-Mode 4 → El miedo al vacío. Se puso un tope: sin él, la barra lateral se vuelve imposible de navegar y de mantener.
Cómo se vería
Para la persona
┌──────────┬──────────────────────────────────────────────┐
│ MARCO │ E-Mode 4 — El miedo al vacío │
│ TEÓRICO │ │
│ │ ┌────────────────────────────────────────┐ │
│ Buscar… │ │ │ │
│ │ │ contenido del artículo, │ │
│ ▾ E-Modes│ │ con su formato e imágenes │ │
│ E-Mode1│ │ │ │
│ … │ └────────────────────────────────────────┘ │
│ E-Mode4│ │
│ ★ tuyo │ ── Relacionados ────────────────────────── │
│ … │ [ Las 3 dimensiones ] [ Cómo leer un E-map ]│
│ ▸ Dimens.│ │
│ ▸ Niveles│ │
└──────────┴──────────────────────────────────────────────┘
El E-Mode de la persona aparece marcado en el índice, y su artículo es el que se abre al entrar. Puede leer los nueve: entender a otros es parte del sentido del material. En pantallas chicas el índice se colapsa.
Para el autor
┌─────────────────────────────────────────────────────────┐
│ Marco teórico — administración [ + Nuevo nodo ] │
│ │
│ ⣿ ▾ E-Modes publicado ⋮ │
│ ⣿ ▾ E-Mode 4 publicado ⋮ │
│ ⣿ El miedo al vacío borrador ⋮ │
│ ⣿ E-Mode 5 publicado ⋮ │
│ ⣿ ▸ Las tres dimensiones publicado ⋮ │
│ │
│ Arrastrá para reordenar o cambiar de nivel │
└─────────────────────────────────────────────────────────┘
Dentro de cada entrada: título, resumen, el material de cada idioma, los artículos relacionados y el botón de publicar.
Cómo entra el contenido
Existential produce el material por fuera —incluso con ayuda de IA— y sube una pieza ya diseñada: el texto con su formato, sus imágenes y sus gráficos, todo en un solo archivo. La plataforma no le pide que arme el diseño adentro ni que suba las imágenes una por una.
Esto trae una condición y una consecuencia:
La condición: el archivo tiene que ser auto-contenido. Las imágenes van embebidas dentro del propio archivo, no enlazadas a otro sitio. Un archivo que dependa de recursos externos se rechaza al subirlo, con un mensaje que explique qué falta. Es lo que garantiza que el material siga viéndose igual dentro de un año, sin depender de que un enlace ajeno siga vivo.
La consecuencia: el contenido se muestra aislado. Publicar material con formato propio significa publicar código dentro de la plataforma, y eso hay que tratarlo con cuidado: el artículo se muestra en un contenedor sellado, sin acceso a la sesión de quien lo lee ni al resto de la pantalla. Aunque el archivo traiga algo inesperado, no puede afectar a la aplicación ni a los datos de la persona. Es una decisión de seguridad no negociable, y condiciona dos cosas visibles:
- El artículo no hereda el modo claro/oscuro de la plataforma: se ve como lo diseñó el autor.
- Los enlaces entre artículos necesitan un mecanismo propio para funcionar (ver más abajo).
Previsualización antes de publicar. Como el material se produce afuera, el autor tiene que poder verlo tal como quedará, ya cargado y en borrador, antes de que lo vea nadie. Un borrador se ve idéntico a un publicado, pero solo para quien administra el contenido.
Cada subida conserva la anterior. Reemplazar el archivo de un artículo no borra la versión previa: queda registrada. Volver atrás con un clic desde la pantalla es una funcionalidad aparte y no está incluida, pero el material no se pierde.
Enlaces entre artículos
Dos formas, complementarias:
- Enlaces dentro del texto. El autor enlaza a otro artículo en medio de un párrafo. Al hacer clic, la plataforma navega sin recargar. Si el artículo de destino no existe o está en borrador, el lector ve un aviso discreto en lugar de un enlace roto.
- Bloque "Relacionados" al pie, con las entradas que el autor haya vinculado desde la administración.
Los enlaces apuntan a un identificador estable, no al título: renombrar un artículo no rompe los enlaces que apuntan a él.
Idiomas
Cada artículo puede tener hasta tres archivos: español, inglés y portugués. Los sube el autor; no hay traducción automática en este alcance. Si falta el idioma de la persona, se muestra el español.
Actores
| Actor | Qué hace |
|---|---|
| Persona | Navega el índice, lee los artículos, sigue los enlaces entre ellos. |
| Autor de contenido (Existential) | Crea entradas, sube el material de cada idioma, arma y reordena el índice, vincula artículos y publica. |
| Sistema | Muestra el índice publicado, resuelve el idioma, destaca el E-Mode de la persona y aísla el contenido. |
Casos de uso
| # | Caso | Qué pasa |
|---|---|---|
| CU-1 | Navegar la biblioteca | La persona entra a Marco teórico y ve el índice completo de lo publicado, con su E-Mode marcado. |
| CU-2 | Leer un artículo | Abre una entrada y lee el material con su formato e imágenes, en su idioma o en español si no está traducido. |
| CU-3 | Seguir una referencia | Desde un enlace del texto o del bloque de relacionados, salta a otro artículo sin perder el contexto. |
| CU-4 | Buscar (fase 2) | Busca por título y resumen y llega al artículo. No busca dentro del contenido. |
| CU-5 | Crear y publicar una entrada | El autor crea la entrada, sube el archivo, la previsualiza, la ubica en el índice y la publica. |
| CU-6 | Reordenar el índice | Cambia el orden de las entradas y el nivel del que cuelgan, arrastrándolas. |
| CU-7 | Actualizar contenido publicado | Sube una versión nueva del archivo. La anterior queda registrada. |
| CU-8 | Vincular artículos (fase 2) | Define qué entradas aparecen como relacionadas al pie de cada artículo. |
Reglas de negocio
| # | Regla |
|---|---|
| R-1 | El índice admite hasta tres niveles de profundidad. |
| R-2 | Una entrada puede ser solo agrupadora —sin material propio— y servir únicamente para organizar el índice. |
| R-3 | Una entrada en borrador no la ve ninguna persona; sí quien administra el contenido. |
| R-4 | Un archivo con referencias a recursos externos se rechaza al subirlo. |
| R-5 | Subir una versión nueva no elimina la anterior. |
| R-6 | Si falta el idioma de la persona, se muestra el español. |
| R-7 | El orden y la jerarquía del índice son los mismos para todos los lectores; los define el autor. |
| R-8 | Toda persona autenticada puede leer la biblioteca completa, sin importar su E-Mode ni su nivel. |
| R-9 | Publicar contenido requiere un permiso específico, distinto del de administrar usuarios u organizaciones. |
| R-10 | Renombrar una entrada no invalida los enlaces que apuntan a ella. |
Lo que ya existe hoy
| Componente | Estado |
|---|---|
| Biblioteca, índice, artículos, administración de contenido | Nuevo |
| Servicio de almacenamiento de archivos | Existe — el de los avatares, reutilizable (17-almacenamiento.md) |
| E-Mode de la persona, para destacar su artículo | Existe |
| Catálogo de permisos donde sumar el de publicación | Existe (02-permisos.md) |
| Interfaz en español, inglés y portugués | Existe — el contenido en tres idiomas es trabajo de contenido, no de desarrollo |
| Administración del marco teórico de Brun-E | Existe — es otra cosa; ver D-22.6 |
Decisiones a debatir con el cliente
| # | Pregunta | Impacto |
|---|---|---|
| D-22.1 | ¿El contenido es el mismo para todas las organizaciones, o cada cliente ve el suyo? Una sola biblioteca global es lo que está propuesto acá y lo que se cotiza. Contenido por organización cambia el modelo y la administración, y depende de 21-suscripciones-creditos.md. | Alto. Define el alcance del módulo. |
| D-22.2 | ¿Se arranca solo en español, o se cargan los tres idiomas desde el principio? El desarrollo es el mismo; el trabajo de contenido se triplica. | Trabajo de contenido. |
| D-22.3 | ¿Se registra qué leyó cada persona? ¿El líder lo ve? Son dos preguntas distintas y la segunda es delicada. | Alcance y privacidad. No incluido. |
| D-22.4 | ¿Quién puede publicar: solo Existential, o también administradores de cada organización? Se cruza con D-22.1. | Permisos y alcance. |
| D-22.5 | ¿El contenido teórico de una cápsula (18-capsulas-entrenamiento.md) sale de esta biblioteca o se carga aparte? Si no se define, el mismo material termina cargado dos veces en dos lugares distintos. | Conviene cerrarlo antes de empezar. |
| D-22.6 | ¿Se renombra el marco teórico de Brun-E a "Base de conocimiento de Brun-E"? Hoy dos secciones distintas se llaman igual. Es un cambio de etiqueta, no de funcionalidad. | Mínimo, y evita confusión permanente. |
| D-22.7 | ¿Se espera que Brun-E conozca lo que hay en esta biblioteca? Es la confusión que originó todo este análisis: el material pensado para que lo lea una persona no sirve tal cual para que lo use un modelo. Conectar ambas cosas es un desarrollo aparte, que engancha con el 12b. | Alto si la respuesta es sí. Conviene preguntarlo temprano. |
Composición del trabajo
Dos fases. La primera deja la biblioteca completa y usable.
| Fase | Qué deja | Peso |
|---|---|---|
| 1 — Biblioteca navegable | El índice como objeto (jerarquía de tres niveles, orden, identificador estable, estado de publicación); carga de material por idioma con validación de que sea auto-contenido y conservación de versiones; administración con reordenamiento arrastrando; previsualización del borrador; índice del lector colapsable; lectura aislada en contenedor sellado, ajustado a la altura del contenido; enlaces internos que navegan sin recargar; E-Mode destacado; permiso propio de publicación y resolución de idioma. | El módulo completo |
| 2 — Descubrimiento | Bloque de relacionados al pie y buscador por título y resumen. | Bastante más chica y posponible: con pocos artículos, el índice alcanza |
Se puede recortar en una primera versión: el reordenamiento arrastrando, reemplazándolo por un número de orden escrito a mano —incómodo de usar, bastante más barato—; y los enlaces dentro del texto, ya que el índice lateral permite llegar a cualquier artículo. La previsualización podría omitirse, pero no se recomienda: es la única red de contención frente a material producido fuera de la plataforma.
Inversión
USD 1.080 — precio cerrado por este entregable. Presentado a Existential el 5 de agosto de 2026. Cubre la fase 1 — biblioteca navegable, entregada y en producción. Se contrata por separado.
Incluye
- Índice de hasta tres niveles, con el orden y la jerarquía que defina Existential.
- Carga del material por idioma —español, inglés y portugués— con validación al subir: si el archivo depende de algo externo, se rechaza y se explica qué falta.
- Previsualización del borrador tal como va a quedar, antes de publicar.
- Publicar y despublicar, con conservación de las versiones anteriores.
- Enlaces entre artículos dentro del texto, que navegan sin recargar y avisan si el destino todavía no está publicado.
- El E-Mode de la persona destacado en el índice y abierto por defecto, pudiendo leer los nueve.
- Índice del lector, colapsable en pantallas chicas.
- Permiso propio de publicación, independiente del de administrar usuarios u organizaciones.
- Interfaz en los tres idiomas, pruebas automatizadas y puesta en producción.
- Reuniones de definición y seguimiento, y dos rondas de ajuste sobre lo entregado.
No incluye
- Contenido distinto por organización (D-22.1). La biblioteca es una sola, igual para todos. Que cada empresa vea la suya cambia el modelo entero.
- Buscador y bloque de relacionados al pie (fase 2). Con pocos artículos el índice alcanza para llegar a cualquier lado.
- Búsqueda dentro del contenido de los artículos, más allá de títulos y resúmenes: obliga a extraer e indexar el texto de cada archivo, que es otro problema.
- Traducción automática. Los tres idiomas los sube Existential.
- Que Brun-E conozca esta biblioteca (D-22.7). Es un desarrollo aparte.
- Métricas de lectura (D-22.3) — quién leyó qué, y si el líder lo ve.
- Restaurar una versión anterior con un clic. Las versiones se conservan; volver atrás desde la pantalla es otra funcionalidad.
- Producir o redactar el contenido. Es trabajo de Existential.
Supuestos. La biblioteca es única para todas las organizaciones —es la decisión que más mueve el alcance— y el material se sube ya diseñado y auto-contenido. Si alguno cambia, o se pide algo del bloque No incluye, se cotiza antes de ejecutarse.
Definición pendiente antes de empezar: D-22.5 — si el contenido teórico de las cápsulas sale de esta biblioteca o se carga aparte. Sin eso se corre el riesgo de cargar el mismo material dos veces.
Por qué sale esto y no más. Buena parte de lo que necesita este módulo ya está construido y pago: el servicio de archivos que hoy usan los avatares, el sistema de permisos donde se suma el de publicación, el E-Mode de cada persona y la plataforma en tres idiomas. Esta propuesta no rehace nada de eso: arma una biblioteca sobre cimientos existentes.
Forma de pago: 50% al inicio, 50% contra entrega.
Relación con otros documentos
- 12b-base-conocimiento-brune.md — la base de conocimiento de Brun-E, que es otra cosa; ver D-22.6 y D-22.7.
- 18-capsulas-entrenamiento.md — cápsulas de entrenamiento; ver D-22.5 para evitar duplicar contenido.
- 05-modos-existenciales.md — los E-Modes, contenido inicial de la biblioteca.
- 05b-emode-editable-perfil.md — el E-Mode vigente determina cuál se destaca en el índice.
- 17-almacenamiento.md — servicio de archivos, base para guardar el material.
- 02-permisos.md — catálogo donde se suma el permiso de publicación.
- 21-suscripciones-creditos.md — dependencia si el contenido se habilita por suscripción (D-22.1).
Correcciones / historial de validación
| Fecha | Versión | Cambio |
|---|---|---|
| 2026-08-03 | v1.0 | Documento inicial. Surge de separar dos pedidos que venían mezclados bajo el nombre "Marco Teórico": la base de conocimiento de Brun-E (12b) y el contenido de lectura para el usuario (este documento). Incluye estructura de índice de tres niveles, carga de material auto-contenido, aislamiento del contenido publicado, enlaces entre artículos, idiomas sin traducción automática, decisiones abiertas y composición del trabajo en dos fases. |
| 2026-08-05 | v1.1 | Este documento pasa a ser la solicitud del cliente. Al precisar el pedido —migrar hacia la plataforma la información sobre eModes y el material complementario que hoy vive afuera— se confirmó que se trata de material de lectura para personas, no de fichas para el asistente. El 12b sale de la lista de solicitudes y queda sin cotizar, porque el mecanismo que describe ya está construido. |
| 2026-08-10 | v1.2 | Recorte de lectura: Composición del trabajo pasa a tabla de fases, Qué agranda el trabajo se absorbe en No incluye y en la tabla D-22.x, y el origen del pedido deja de contarse dos veces. Sin cambios de alcance ni de precio. |