AchieveApex: app presentations

Generado desde achieveApex-Frontend/public/ai-docs el 2026-10-15. Contiene 12 archivos de la app presentations. Para el contexto general del producto ver apex-resumen.md.

id: presentations app: presentations nombre: Presentations estado: shipped permiso: can_access_presentations

Presentations

Creador de presentaciones con diapositivas HTML/CSS, IA, versiones y reproducción pública. Esta app es un módulo único; sus capacidades viven directamente en esta carpeta.

Para que sirve

• Una consultora crea y comparte una propuesta comercial con un enlace público que solo muestra la versión aprobada.
• Un equipo de ventas adapta un deck a la identidad de cada cuenta, genera un PDF y conserva su guion de presentación.
• Una agencia duplica una presentación de referencia para acelerar entregables sin reutilizar el enlace público anterior.
• Una empresa prepara una capacitación con animaciones, gráficos y notas sincronizadas para el facilitador.

Que lo hace diferente

• Presentation AI puede crear, reordenar y editar diapositivas, generar imágenes y consultar una web pública desde el builder.
• Cada deck separa el borrador de la versión Live: los cambios de trabajo no alteran el enlace compartido hasta Publish.
• El enlace público usa un token y ofrece modo de presentación, notas sincronizadas y descarga de la versión Live en PDF.
• El contexto y las skills se conservan por deck, e incluyen capacidades nativas para movimiento y gráficos de diapositivas.

Acceso

• Ruta principal: /[orgId]/presentations
• Como se llega: Header app switcher > Presentations
• Permiso requerido: can_access_presentations

Alcance tecnico

• Frontend: lista, builder y vistas públicas de Presentations
• Backend: decks, slides, render, IA, versiones y PDFs
• Superficies públicas: /p/[token] y /p/[token]/notes
• Integraciones externas: S3, OpenRouter y Puppeteer

Funcionalidades internas

Relaciones

• Depende de: Organizations, wallet y recursos S3.
• Usado por: personas presentadoras y visitantes con enlace público.

Limitaciones y notas

• El borrador no actualiza el enlace público hasta Publish.
• La visibilidad interna y el enlace público son controles independientes.

id: collections-access modulo: presentations app: presentations nombre: Organizar carpetas y acceso tipo: configuracion

Organizar carpetas y acceso

Agrupa presentaciones y controla propietario, visibilidad y miembros de carpetas o decks.

Que se logra

• Resultado: cada equipo ve y administra únicamente las carpetas y presentaciones que le corresponden.
• Caso de uso: una agencia mantiene privadas las propuestas de cada cliente y comparte una carpeta con las personas asignadas.
• Se combina con: duplicación de presentaciones y publicación pública.

Donde esta

• Ruta: /[orgId]/presentations
• Acceso en UI: Presentations > folder menu / card menu > Manage access``
• Componente(s): PresentationsListView.tsx, PresentationAccessDialog.tsx

Como funciona

1. Cree o seleccione una carpeta.
2. Abra Manage access.
3. Elija Organization o Private, propietario y miembros.
4. Guarde los cambios.

Reglas y validaciones

• Una carpeta privada oculta las presentaciones que contiene a quien no tenga acceso.
• Solo los administradores del recurso pueden administrar miembros.
• Al agregar a una carpeta se puede incluir presentaciones existentes.

Backend

• Servicios: presentation-collections, presentation-members, presentation-collection-members.

Relaciones

• Requiere: acceso al deck o carpeta.
• Afecta: visibilidad de presentaciones.

id: create-presentation modulo: presentations app: presentations nombre: Crear una presentación tipo: accion

Crear una presentación

Crea un deck con una diapositiva inicial y abre el builder.

Que se logra

• Resultado: un borrador de presentación con una diapositiva inicial, acceso del propietario y una base para diseñar o usar IA.
• Caso de uso: una consultora inicia una propuesta para un cliente y organiza el deck en la carpeta de su cuenta.
• Se combina con: tema, Presentation AI, versiones y publicación Live.

Donde esta

• Ruta: /[orgId]/presentations
• Acceso en UI: Presentations > New presentation``
• Componente(s): CreatePresentationDialog.tsx

Como funciona

1. Abra Presentations.
2. Seleccione New presentation.
3. Escriba el nombre y, opcionalmente, una carpeta.
4. Confirme para abrir el builder.

Reglas y validaciones

• El nombre es obligatorio.
• Puede copiar tema, CSS compartido, skills y contexto; no copia diapositivas.

Backend

• Servicios: presentations (create).
• Efectos: crea una diapositiva inicial, token público y membresía de propietario.

Relaciones

• Requiere: acceso a Presentations.
• Afecta: builder, visibilidad y versiones.

id: duplicate-presentation modulo: presentations app: presentations nombre: Duplicar una presentación tipo: accion

Duplicar una presentación

Copia un deck completo, incluso diapositivas, recursos, tema, skills y contexto de IA.

Que se logra

• Resultado: una nueva presentación parte de una estructura y marca probadas, sin compartir su historial ni enlace público.
• Caso de uso: un equipo comercial duplica una propuesta ganadora para personalizarla para otra cuenta.
• Se combina con: carpetas y acceso, tema, Presentation AI y publicación Live.

Donde esta

• Ruta: /[orgId]/presentations
• Acceso en UI: Presentation card > Duplicate``
• Componente(s): DuplicatePresentationDialog.tsx

Como funciona

1. Abra el menú de la tarjeta.
2. Seleccione Duplicate.
3. Indique un nuevo nombre y, si está disponible, la organización destino.
4. Confirme.

Reglas y validaciones

• El duplicado es un borrador nuevo: no conserva publicación pública, historial ni chat.
• La fuente debe ser visible para la persona que duplica.

Backend

• Servicios: presentation-duplicate (create).
• Efectos: crea nuevas relaciones y una nueva membresía de propietario.

Relaciones

• Requiere: acceso a la presentación fuente.
• Afecta: colecciones y recursos del destino.

id: presentation-ai-context-skills modulo: presentations app: presentations nombre: Configurar contexto y skills de Presentation AI tipo: configuracion

Configurar contexto y skills de Presentation AI

Define contexto o memoria por deck o diapositiva y habilita skills de organización o Apex para la IA.

Que se logra

• Resultado: la IA dispone de instrucciones y guías reutilizables para mantener coherencia en el deck y en diapositivas concretas.
• Caso de uso: un equipo de producto fija su audiencia y tono en el contexto, y activa Slide Charts para comunicar métricas en su presentación.
• Se combina con: Presentation AI, tema y versiones.

Donde esta

• Ruta: /[orgId]/presentations/[presentationId]
• Acceso en UI: Builder > AI Context``
• Componente(s): PresentationAIContextPanel.tsx

Como funciona

1. Abra AI Context.
2. Cree entradas de Context o Memory, opcionalmente para la diapositiva activa.
3. Active o desactive skills desde Skills.

Reglas y validaciones

• Las skills son de todo el deck, no por diapositiva.
• Slide Motion y Slide Charts se activan por defecto en decks nuevos; Design Taste (Slides) inicia desactivada.

Backend

• Servicios: presentation-ai-context, presentation-ai-skills, presentation-ai-skill-assignments, apex-presentation-ai-skills.

Relaciones

• Requiere: deck existente.
• Afecta: instrucciones y resultados de Presentation AI.

id: presentation-ai modulo: presentations app: presentations nombre: Crear con Presentation AI tipo: accion

Crear con Presentation AI

Usa chat de IA para diseñar y modificar diapositivas, ordenarlas, generar imágenes, capturar vistas y consultar web pública.

Que se logra

• Resultado: un deck evoluciona mediante instrucciones, desde el contenido y orden de las diapositivas hasta imágenes y gráficos renderizados.
• Caso de uso: una startup entrega a Presentation AI los puntos de su pitch y obtiene un borrador visual que luego revisa y publica.
• Se combina con: tema, contexto y skills, recursos, versiones y publicación Live.

Donde esta

• Ruta: /[orgId]/presentations/[presentationId]
• Acceso en UI: Builder toolbar > AI``
• Componente(s): usePresentationBuilderAI.ts, PresentationsBuilderView.tsx

Como funciona

1. Abra AI.
2. Seleccione la diapositiva activa y el viewport.
3. Escriba la solicitud o adjunte recursos.
4. Revise el resultado y el estado sin publicar.

Reglas y validaciones

• Requiere saldo positivo en la wallet.
• La IA lee la diapositiva antes de editarla y controla hashes para evitar sobrescrituras.
• Las capturas de validación no aparecen como recursos reutilizables.

Backend

• Servicios: presentation-builder-ai (create), presentation-builder-conversations, presentation-builder-messages, presentation-assets.
• Efectos: cobra wallet y puede modificar deck, diapositivas o recursos.

Relaciones

• Requiere: presentación y diapositiva activa.
• Afecta: versiones y estado de publicación.

id: presentation-pdf modulo: presentations app: presentations nombre: Descargar presentación en PDF tipo: accion

Descargar presentación en PDF

Genera un PDF de servidor para el deck en formato Desktop o Mobile.

Que se logra

• Resultado: el deck se entrega como un archivo descargable adaptado a pantalla de escritorio o móvil.
• Caso de uso: un equipo comercial descarga la versión aprobada para adjuntarla a una propuesta enviada por correo.
• Se combina con: tema, edición de diapositivas, versiones Live y presentación pública.

Donde esta

• Ruta: /[orgId]/presentations/[presentationId] y /p/[token]
• Acceso en UI: Builder toolbar > Download PDF``
• Componente(s): PresentationsBuilderView.tsx, PresentationPublicView.tsx

Como funciona

1. Seleccione Download PDF.
2. Elija Desktop o Mobile.
3. Abra el enlace de descarga generado.

Reglas y validaciones

• El builder exporta el borrador; el enlace público exporta Live.
• El PDF admite hasta 80 diapositivas.
• El enlace firmado expira después de 24 horas.

Backend

• Servicios: pdf-generator (create), public-presentation-pdf (create).
• Integraciones: Puppeteer y S3.

Relaciones

• Requiere: presentación o enlace público válido.
• Afecta: archivo descargable.

id: presentation-theme modulo: presentations app: presentations nombre: Configurar tema y marca tipo: configuracion

Configurar tema y marca

Personaliza colores, radio, fuentes Google o de marca; también puede analizar un sitio público para preparar una propuesta de tema.

Que se logra

• Resultado: todas las diapositivas usan una identidad visual preparada para vista previa, presentación pública y PDF.
• Caso de uso: una agencia analiza el sitio de su cliente, revisa la propuesta de tema y aplica su marca al deck de lanzamiento.
• Se combina con: recursos, Presentation AI, edición de diapositivas y PDF.

Donde esta

• Ruta: /[orgId]/presentations/[presentationId]
• Acceso en UI: Builder > Theme``
• Componente(s): PresentationThemePanel.tsx, GetThemeFromWebsiteDialog.tsx

Como funciona

1. Abra Theme.
2. Ajuste tokens o elija fuentes.
3. Opcionalmente seleccione Get theme from website, analice una URL y revise la propuesta.
4. Guarde el tema o Save and apply theme.

Reglas y validaciones

• La propuesta web no cambia el deck hasta confirmarla.
• Las herramientas de chat no modifican las fuentes.
• Copiar tema no copia diapositivas ni skills.

Backend

• Servicios: presentations (patch), presentation-assets, presentation-builder-ai.
• Efectos: el guardado crea un checkpoint y actualiza preview, público y PDF.

Relaciones

• Requiere: deck existente.
• Afecta: todas las diapositivas.

id: public-presentation modulo: presentations app: presentations nombre: Compartir y presentar públicamente tipo: publico

Compartir y presentar públicamente

Comparte la última versión Live en un reproductor público con presentación a pantalla completa y ventana de notas sincronizada.

Que se logra

• Resultado: una audiencia externa accede a una presentación controlada por el equipo mediante un enlace público con token.
• Caso de uso: una agencia envía a su cliente un enlace de propuesta que conserva la diapositiva abierta y permite presentar a pantalla completa.
• Se combina con: publicación Live, notas del orador y descarga de PDF.

Donde esta

• Ruta: /p/[token]
• Acceso en UI: Builder > Share>Make public``
• Componente(s): PresentationPublicView.tsx, PresentationSpeakerNotesView.tsx

Como funciona

1. Active Make public en Share.
2. Copie /p/[token].
3. Publique el borrador desde Versions cuando esté listo.
4. En la página pública use Present o Notes window.

Reglas y validaciones

• Si no hay versión Live, la primera activación pública publica el borrador.
• Desactivar el switch invalida el enlace inmediatamente.
• El hash de la URL conserva la diapositiva actual.

Backend

• Servicios: presentation-public (create).
• Efectos: expone solamente la instantánea publicada y notas/guion asociados.

Relaciones

• Requiere: token público activo y versión publicada.
• Afecta: espectadores externos.

id: slides-inline-editing modulo: presentations app: presentations nombre: Gestionar y editar diapositivas tipo: accion

Gestionar y editar diapositivas

Añade, ordena, elimina y corrige diapositivas desde el filmstrip y la vista previa.

Que se logra

• Resultado: el equipo ajusta la secuencia y el contenido visible del deck sin editar archivos externos.
• Caso de uso: una empresa reorganiza una presentación de producto y reemplaza una imagen antes de una demostración de ventas.
• Se combina con: tema, notas del orador, versiones y publicación Live.

Donde esta

• Ruta: /[orgId]/presentations/[presentationId]
• Acceso en UI: Filmstrip > +; preview > text or image
• Componente(s): PresentationsBuilderView.tsx, PresentationReplaceImageDialog.tsx

Como funciona

1. Use + para agregar una diapositiva.
2. Seleccione una fila para navegar.
3. Haga clic en texto para editarlo o en una imagen para reemplazarla.
4. Use el icono de basura para eliminar una diapositiva.

Reglas y validaciones

• Debe permanecer al menos una diapositiva.
• La edición en línea no permite arrastrar ni redimensionar el diseño.
• Los cambios afectan el borrador, no el enlace público hasta publicar.

Backend

• Servicios: presentation-slides (find/create/patch/remove), presentation-render.
• Efectos: guarda historial individual de HTML/CSS de la diapositiva.

Relaciones

• Requiere: deck existente.
• Afecta: versiones de diapositiva y estado sin publicar.

id: speaker-notes modulo: presentations app: presentations nombre: Añadir notas y guion del orador tipo: configuracion

Añadir notas y guion del orador

Mantiene recordatorios breves y un guion hablado para cada diapositiva.

Que se logra

• Resultado: la persona que presenta dispone de apoyo por diapositiva sin añadir ese contenido al material que ve la audiencia.
• Caso de uso: una empresa prepara el guion de una demo para que distintos representantes expliquen la oferta de forma consistente.
• Se combina con: presentación pública, versiones Live y PDF.

Donde esta

• Ruta: /[orgId]/presentations/[presentationId]
• Acceso en UI: Filmstrip row > notes icon; preview > Notes/Script``
• Componente(s): PresentationSlideNotesDialog.tsx

Como funciona

1. Seleccione una diapositiva.
2. Abra el icono de notas o pulse N / S en la vista previa.
3. Edite Notes o Script.
4. Guarde o salga de la superposición.

Reglas y validaciones

• Notas y guion se muestran como paneles alternativos.
• El builder permite editar; la presentación pública solo permite lectura.

Backend

• Servicios: presentation-slides (patch), presentation-render.

Relaciones

• Requiere: diapositiva.
• Afecta: modo Present, ventana de notas y versión publicada.

id: versions-publish modulo: presentations app: presentations nombre: Gestionar versiones y publicar Live tipo: accion

Gestionar versiones y publicar Live

Guarda checkpoints del deck, restaura historial y fija la instantánea Live que usa el enlace público.

Que se logra

• Resultado: el equipo puede experimentar en el borrador y compartir una versión estable que no cambia hasta la próxima publicación.
• Caso de uso: una consultora guarda una versión de revisión y publica solo la propuesta aprobada para su cliente.
• Se combina con: edición de diapositivas, Presentation AI, presentación pública y PDF.

Donde esta

• Ruta: /[orgId]/presentations/[presentationId]
• Acceso en UI: Builder > Versions``
• Componente(s): PresentationVersionsMenu.tsx

Como funciona

1. Abra Versions.
2. Use Save version para un checkpoint manual.
3. Elija un checkpoint, la versión Live o el historial de la diapositiva.
4. Seleccione Publish para actualizar Live.

Reglas y validaciones

• El borrador y Live son separados.
• Restaurar crea un nuevo checkpoint para que sea reversible.
• Se conservan los checkpoints recientes y se protege la versión publicada.

Backend

• Servicios: presentation-restore, presentation-slide-restore, presentations, presentation-slides.

Relaciones

• Requiere: deck existente.
• Afecta: enlace público, PDF público e historial.