AchieveApex: app sites

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

id: sites app: sites nombre: Sites estado: shipped permiso: can_access_sites

Sites

Constructor de sitios web de una organización con IA, recursos, SEO y publicación. Esta app es un módulo único; sus capacidades viven directamente en esta carpeta.

Para que sirve

• Una clínica crea un sitio informativo con páginas de servicios, SEO y formulario para convertir consultas web en contactos.
• Una inmobiliaria publica un sitio de proyectos con navegación y recursos de marca sin depender de un desarrollo separado.
• Una agencia importa una base HTML y la adapta para entregar micrositios a sus clientes.
• Un comercio local lanza una página de campaña en un subdominio de Apex y después la conecta a su propio dominio.

Que lo hace diferente

• Sites AI puede crear páginas y modificar contenido, navegación, header, footer, estilos y recursos dentro del mismo builder.
• El contexto, la memoria y las skills se guardan por sitio para que la IA conserve reglas de marca y trabajo entre conversaciones.
• Puede incrustar formularios publicados de Apex: los envíos no son solo visuales, se registran en Forms para la organización.
• La publicación incluye un subdominio gratuito de Apex; el dominio propio se conecta con validación y una suscripción de $5 USD/mes.

Acceso

• Ruta principal: /[orgId]/sites
• Como se llega: Header app switcher > Sites
• Permiso requerido: can_access_sites

Alcance tecnico

• Frontend: rutas de lista y builder de Sites, con componentes en components/sites
• Backend: sites, páginas, layouts, recursos, IA, render y publicación
• Superficies públicas: sitios publicados bajo pages.achieveapex.com
• Integraciones externas: S3, CloudFront, Stripe y OpenRouter

Funcionalidades internas

Relaciones

• Depende de: Organizations, wallet, Forms y permisos.
• Usado por: visitantes públicos y formularios embebidos.

Limitaciones y notas

• La publicación es de todo el sitio.
• El subdominio de plataforma es gratuito; un dominio propio cuesta $5 USD/mes.

id: ai-context-memory modulo: sites app: sites nombre: Mantener contexto y memoria de IA tipo: configuracion

Mantener contexto y memoria de IA

Guarda instrucciones durables del usuario y aprendizajes de la IA que sobreviven a conversaciones distintas.

Que se logra

• Resultado: Sites AI conserva las reglas de marca y decisiones del sitio entre sesiones de trabajo.
• Caso de uso: una agencia registra el tono, público y restricciones de una marca para que distintos editores mantengan el mismo criterio al usar la IA.
• Se combina con: Sites AI y skills de Sites AI.

Donde esta

• Ruta: /[orgId]/sites/[siteId]
• Acceso en UI: Site menu > AI Context & Memory>Context/Memory``
• Componente(s): SiteAIContextPanel.tsx, ContextEntriesTab.tsx

Como funciona

1. Abra AI Context & Memory.
2. En Context, agregue reglas que siempre deben respetarse.
3. En Memory, revise, corrija o elimine recuerdos generados por la IA.

Reglas y validaciones

• Contexto y memoria son distintos de la memoria de la conversación actual.
• Si una regla debe aplicarse siempre, debe estar en Context.

Backend

• Servicios: site-ai-context (find/create/patch/remove), site-builder-ai.
• Efectos: el contexto se incorpora al prompt del builder dentro de su presupuesto.

Relaciones

• Requiere: sitio creado.
• Afecta: comportamiento de Sites AI.

id: ai-skills modulo: sites app: sites nombre: Administrar skills de Sites AI tipo: configuracion

Administrar skills de Sites AI

Activa guías de IA para el sitio y permite mantener una biblioteca reutilizable de skills de la organización.

Que se logra

• Resultado: la IA aplica guías reutilizables de diseño o de la organización al trabajar sobre un sitio específico.
• Caso de uso: una agencia activa una guía de identidad visual para que la IA mantenga el estándar acordado en cada página de un cliente.
• Se combina con: Sites AI y contexto y memoria.

Donde esta

• Ruta: /[orgId]/sites/[siteId]
• Acceso en UI: AI Context & Memory > Skills``
• Componente(s): SkillsTab.tsx

Como funciona

1. Abra la pestaña Skills.
2. Active o desactive una skill para este sitio.
3. Use View para leer una skill de Apex.
4. Use Duplicate para crear una copia editable de una skill de Apex, o New skill para crear una propia.

Reglas y validaciones

• Las skills de Apex son de solo lectura.
• Una skill de organización empieza desactivada en otros sitios.
• Para dejar de usar una skill solo en un sitio, desactívela; eliminarla la quita de toda la organización.

Backend

• Servicios: site-ai-skills, site-ai-skill-assignments, apex-site-ai-skills.
• Efectos: la IA abre el contenido completo de una skill activa solo cuando la tarea coincide.

Relaciones

• Requiere: sitio creado.
• Afecta: Sites AI.
• Integra: Design Taste está disponible como skill de Apex.

id: create-site modulo: sites app: sites nombre: Crear un sitio tipo: accion

Crear un sitio

Crea un proyecto de sitio con una página inicial y un diseño compartido listos para editar.

Que se logra

• Resultado: un sitio con página de inicio, navegación, tema y diseño compartido listo para personalizar.
• Caso de uso: una consultora crea la base de su sitio corporativo para completar después sus páginas de servicios con Sites AI.
• Se combina con: importación de HTML, Sites AI, tema, páginas y publicación.

Donde esta

• Ruta: /[orgId]/sites
• Acceso en UI: Sites > New site``
• Componente(s): SitesListView.tsx

Como funciona

1. Abra Sites.
2. Seleccione New site.
3. Escriba el nombre y elija Blank o Import HTML.
4. Confirme para abrir el builder.

Reglas y validaciones

• El nombre es obligatorio.
• La opción Blank inicia con una página de inicio; no envía un prompt de IA al crear.

Backend

• Servicios: sites (create).
• Efectos: se crea el contenido inicial, incluyendo página de inicio, diseño predeterminado, navegación y tema.

Relaciones

• Requiere: acceso a Sites.
• Afecta: páginas, tema, navegación y publicación.

id: custom-domain modulo: sites app: sites nombre: Conectar dominio propio tipo: integracion

Conectar dominio propio

Asocia un hostname del cliente a un sitio ya publicado y guía su validación mediante CNAME.

Que se logra

• Resultado: los visitantes acceden al sitio de Apex mediante el dominio propio del negocio, una vez validado.
• Caso de uso: un despacho profesional mantiene su web creada en Apex en www.sudespacho.com sin perder la publicación existente.
• Se combina con: publicación de sitios y facturación por Stripe.

Donde esta

• Ruta: /[orgId]/sites/[siteId]
• Acceso en UI: Publish > Custom domain``
• Componente(s): SitePublishPanel.tsx

Como funciona

1. Publique primero el sitio.
2. Escriba el dominio y elija Connect domain.
3. Confirme la suscripción de $5/mes.
4. Cree el CNAME mostrado por la interfaz.
5. Use Check status hasta que esté activo.

Reglas y validaciones

• No admite dominios de AchieveApex ni el dominio base de la plataforma.
• El dominio debe ser globalmente único.
• Desconectar programa la cancelación al fin del período; reconectar antes reutiliza el período pagado.

Backend

• Servicios: site-custom-domains (create), cron-verify-site-domains.
• Integraciones: Stripe, CloudFront y DNS.
• Efectos: cobra $5 USD/mes por sitio y replica la publicación para el hostname.

Relaciones

• Requiere: sitio publicado.
• Afecta: URL canónica y facturación.

id: delete-site modulo: sites app: sites nombre: Eliminar un sitio tipo: accion

Eliminar un sitio

Elimina un sitio desde su tarjeta para retirarlo del listado de la organización.

Que se logra

• Resultado: el sitio deja de aparecer en el catálogo operativo de la organización.
• Caso de uso: una agencia retira un proyecto de prueba que ya no debe estar disponible para su equipo.
• Se combina con: publicación de sitios, que debe revisarse antes de eliminar un proyecto que estuviera público.

Donde esta

• Ruta: /[orgId]/sites
• Acceso en UI: Sites list > site menu > Delete``
• Componente(s): SitesListView.tsx

Como funciona

1. Abra Sites.
2. Abra el menú de la tarjeta.
3. Seleccione Delete y confirme.

Reglas y validaciones

• El backend usa borrado lógico para los registros compatibles.

Backend

• Servicios: sites (remove).

Relaciones

• Requiere: acceso al sitio.
• Afecta: páginas, layouts y recursos asociados según las relaciones del servicio.

id: embed-forms modulo: sites app: sites nombre: Insertar formularios de AchieveApex tipo: integracion

Insertar formularios de AchieveApex

Permite a Sites AI preferir e insertar formularios publicados de la organización para captar envíos reales en un sitio estático.

Que se logra

• Resultado: una página publicada capta solicitudes mediante un formulario de Apex que guarda envíos reales para la organización.
• Caso de uso: una inmobiliaria incorpora su formulario de visita a una página de proyecto para recibir prospectos desde el sitio.
• Se combina con: Forms, contactos y Sites AI.

Donde esta

• Ruta: /[orgId]/sites/[siteId]
• Acceso en UI: Builder toolbar > AI
• Componente(s): SitesBuilderView.tsx

Como funciona

1. Abra Sites AI y pida agregar un formulario.
2. La IA consulta los formularios publicados de la organización.
3. Inserta el widget de un formulario disponible o, cuando corresponde, un iframe.
4. Publique el sitio para probar envíos desde el dominio público.

Reglas y validaciones

• Se priorizan formularios publicados; los no publicados no aceptan envíos.
• Un formulario HTML escrito sin una integración real es solo una maqueta visual.
• En una misma página solo puede usarse un widget; para otro formulario se usa el embed aislado.
• La vista previa puede impedir enviar por las restricciones de su iframe, aunque el formulario se renderice.

Backend

• Servicios: forms (find/get), form-submissions (create).
• Hooks relevantes: la IA consulta formularios de la misma organización antes de generar un embed.
• Efectos: los envíos públicos se guardan como submissions del formulario.

Relaciones

• Requiere: Forms y un formulario publicado.
• Afecta: páginas generadas, captación de leads y envíos de formularios.

Notas

• Los sitios publicados en subdominios de AchieveApex están contemplados por la configuración CORS del embed.

id: import-html modulo: sites app: sites nombre: Importar HTML tipo: accion

Importar HTML

Incorpora HTML existente al sitio nuevo o a una página del sitio abierto.

Que se logra

• Resultado: una página o sitio existente queda incorporado al builder con contenido, estructura compartida y estilos detectables.
• Caso de uso: una agencia reutiliza la página HTML de un cliente y la convierte en una base editable antes de publicar una nueva campaña.
• Se combina con: páginas, layouts, tema, versiones y publicación.

Donde esta

• Ruta: /[orgId]/sites/[siteId]
• Acceso en UI: Pages > Import HTML``
• Componente(s): ImportSiteHtmlDialog.tsx, SiteHtmlImportFields.tsx

Como funciona

1. Elija Import HTML al crear o desde Pages.
2. Pegue o cargue el HTML.
3. Para un sitio existente, seleccione reemplazar la página actual o crear una nueva.
4. Confirme la importación.

Reglas y validaciones

• El HTML es obligatorio y tiene un límite de tamaño.
• Los estilos enlazados, imágenes relativas y scripts de analítica se omiten y se muestran como advertencias.
• Importar sobre una página conserva una versión anterior para poder restaurarla.

Backend

• Servicios: site-html-import (create), sites, site-pages, site-layouts.
• Efectos: detecta header, footer, estilos y fuentes cuando están dentro del HTML.

Relaciones

• Requiere: un sitio existente al importar una página.
• Afecta: diseños, páginas, tema y versiones.

id: pages-seo-navigation modulo: sites app: sites nombre: Gestionar páginas, rutas y SEO tipo: configuracion

Gestionar páginas, rutas y SEO

Organiza la página de inicio, las rutas de las páginas y sus metadatos para el sitio completo.

Que se logra

• Resultado: visitantes encuentran una estructura navegable y páginas preparadas para indexación o exclusión de buscadores.
• Caso de uso: una clínica organiza Inicio, Especialidades y Contacto, y evita indexar una página temporal de campaña.
• Se combina con: layouts, Sites AI, vista previa y publicación.

Donde esta

• Ruta: /[orgId]/sites/[siteId]
• Acceso en UI: Site menu > PagesyDomain & SEO``
• Componente(s): SitesBuilderView.tsx

Como funciona

1. Abra Pages para cambiar de página o importar una nueva.
2. Abra Domain & SEO.
3. Defina título, descripción, ruta y la página de inicio.
4. Guarde y republique cuando el sitio ya esté en línea.

Reglas y validaciones

• Solo una página puede ser la página de inicio (/).
• La publicación es por sitio completo, no por página individual.
• Las páginas marcadas para no indexar no entran en el sitemap.

Backend

• Servicios: site-pages (find/get/patch/create), site-render.
• Efectos: el render público genera metadatos, sitemap, robots y página 404.

Relaciones

• Requiere: sitio creado.
• Afecta: navegación, vista previa y publicación.

id: publish-site modulo: sites app: sites nombre: Publicar y republicar un sitio tipo: accion

Publicar y republicar un sitio

Hace público el sitio completo en un subdominio gratuito de AchieveApex y permite actualizarlo con Republish.

Que se logra

• Resultado: el sitio completo queda disponible para visitantes en una URL pública, con navegación, SEO y páginas actualizadas.
• Caso de uso: un negocio de eventos publica la web de una conferencia en un subdominio gratuito y la actualiza al cerrar la agenda.
• Se combina con: páginas y SEO, vista previa, formularios embebidos y dominio propio.

Donde esta

• Ruta: /[orgId]/sites/[siteId]
• Acceso en UI: Builder toolbar > Publish``
• Componente(s): SitePublishPanel.tsx

Como funciona

1. Abra Publish.
2. Elija un subdominio disponible.
3. Confirme Publish site.
4. Tras cambios, use Republish.

Reglas y validaciones

• Debe existir una página de inicio.
• Publicar, republicar y usar el subdominio de AchieveApex son gratuitos.
• Todas las páginas se publican juntas.

Backend

• Servicios: site-publish (create).
• Efectos: renderiza HTML estático, lo carga a S3 e invalida CloudFront.

Relaciones

• Requiere: sitio con página de inicio.
• Afecta: URL pública, sitemap, robots y versiones publicadas.

id: site-assets modulo: sites app: sites nombre: Gestionar recursos del sitio tipo: accion

Gestionar recursos del sitio

Carga y reutiliza imágenes del sitio, incluidas las que el usuario adjunta al chat o genera la IA.

Que se logra

• Resultado: las imágenes del negocio quedan disponibles para incorporarlas al contenido del sitio mediante el builder y la IA.
• Caso de uso: un hotel carga fotografías de sus habitaciones y las adjunta a Sites AI para renovar su página de reservas.
• Se combina con: Sites AI, tema y páginas.

Donde esta

• Ruta: /[orgId]/sites/[siteId]
• Acceso en UI: Site menu > Assets``
• Componente(s): SiteAssetsPanel.tsx

Como funciona

1. Abra Assets.
2. Cargue un archivo.
3. Revise los recursos disponibles.
4. Use Use AI para adjuntar una imagen a la siguiente conversación.

Reglas y validaciones

• Use AI adjunta el recurso, pero no envía un prompt automáticamente.
• Los recursos pueden provenir de carga, adjuntos del chat o generación de IA.

Backend

• Servicios: site-assets (find/create), s3-url-signing.
• Efectos: los archivos se almacenan en S3 y quedan disponibles para la IA.

Relaciones

• Requiere: sitio creado.
• Afecta: chat de Sites AI y contenido de páginas.

id: site-layout modulo: sites app: sites nombre: Configurar header, footer y diseños tipo: configuracion

Configurar header, footer y diseños

Administra el chrome compartido del sitio: header, footer y estilos comunes que pueden reutilizar sus páginas.

Que se logra

• Resultado: los cambios de identidad y navegación se aplican de forma coherente en todas las páginas que usan el mismo diseño.
• Caso de uso: una firma legal actualiza su menú y pie de página una vez para que sus páginas de práctica mantengan la misma navegación.
• Se combina con: páginas, Sites AI, tema y publicación.

Donde esta

• Ruta: /[orgId]/sites/[siteId]
• Acceso en UI: Site menu > Site Layout``
• Componente(s): SiteLayoutPanel.tsx

Como funciona

1. Abra Site Layout.
2. Revise los diseños y las páginas asignadas.
3. Use Sites AI para solicitar cambios al header, footer o estilos del diseño.
4. Publique de nuevo para llevar el cambio a visitantes.

Reglas y validaciones

• Una página puede usar un diseño propio o el predeterminado del sitio.
• No hay edición manual directa del HTML del diseño desde este panel.

Backend

• Servicios: site-layouts (find/get/patch), site-render, site-builder-ai.

Relaciones

• Requiere: sitio creado.
• Afecta: todas las páginas que usan el mismo diseño.

id: site-preview modulo: sites app: sites nombre: Previsualizar páginas y dispositivos tipo: vista

Previsualizar páginas y dispositivos

Muestra una composición del sitio en un iframe y permite revisar la página en Desktop, Tablet o Mobile.

Que se logra

• Resultado: el equipo detecta problemas de navegación, contenido o adaptación visual antes de exponer el sitio a visitantes.
• Caso de uso: un restaurante revisa en Mobile que su página de menú y el acceso a reservas sean legibles antes de republicar.
• Se combina con: páginas, tema, layouts y publicación.

Donde esta

• Ruta: /[orgId]/sites/[siteId]
• Acceso en UI: Builder toolbar > viewport selector / Open preview``
• Componente(s): SitesBuilderView.tsx

Como funciona

1. Abra una página del sitio.
2. Seleccione el viewport deseado.
3. Navegue por enlaces internos en la vista previa.
4. Use Open preview para abrir el HTML renderizado.

Reglas y validaciones

• La vista previa incorpora un puente de navegación exclusivo del builder.
• Una vista previa no equivale a publicar el sitio.

Backend

• Servicios: site-render (create).
• Efectos: fusiona layout, contenido, tema, fuentes y navegación.

Relaciones

• Requiere: sitio y página.
• Afecta: revisión previa a publicación.

id: site-versions modulo: sites app: sites nombre: Restaurar versiones de páginas tipo: accion

Restaurar versiones de páginas

Consulta el historial de una página y permite volver a un borrador o a la copia publicada sin perder el estado actual.

Que se logra

• Resultado: el equipo recupera una versión anterior de una página sin destruir el borrador que tenía antes de restaurar.
• Caso de uso: un comercio revierte la página de una promoción después de comprobar que el cambio reciente redujo la claridad de la oferta.
• Se combina con: edición con Sites AI, importación de HTML y publicación.

Donde esta

• Ruta: /[orgId]/sites/[siteId]
• Acceso en UI: Builder toolbar > Versions``
• Componente(s): SiteVersionsMenu.tsx

Como funciona

1. Abra Versions.
2. Elija Current, Published o una instantánea histórica.
3. Seleccione Restore this version.
4. Confirme la restauración.

Reglas y validaciones

• Antes de restaurar, el borrador actual se guarda como una nueva versión.
• La copia publicada solo está disponible mientras el sitio está publicado.
• Las instantáneas iniciales vacías se distinguen para evitar una restauración accidental.

Backend

• Servicios: site-page-restore (create), site-pages (patch).
• Efectos: cada edición de contenido crea historial y aumenta la versión de la página.

Relaciones

• Requiere: página existente.
• Afecta: borrador de la página; requiere republicar para actualizar visitantes.

id: sites-ai modulo: sites app: sites nombre: Editar el sitio con Sites AI tipo: accion

Editar el sitio con Sites AI

Permite pedir cambios de contenido y diseño, crear páginas, modificar layouts y generar imágenes mediante una conversación con IA.

Que se logra

• Resultado: el equipo transforma contenido, diseño y estructura del sitio desde instrucciones, con los cambios reflejados en el borrador.
• Caso de uso: una academia pide crear una página de cursos, ajustar el menú y generar imágenes para su lanzamiento sin salir del builder.
• Se combina con: contexto y memoria, skills, recursos, formularios, versiones y publicación.

Donde esta

• Ruta: /[orgId]/sites/[siteId]
• Acceso en UI: Builder toolbar > AI``
• Componente(s): BuilderAiChatLayer.tsx, SitesBuilderView.tsx

Como funciona

1. Abra AI desde la barra o el botón flotante.
2. Elija un modelo y escriba la solicitud.
3. Adjunte imágenes o una captura si hace falta.
4. Revise el resultado en la vista previa y republique cuando corresponda.

Reglas y validaciones

• Requiere saldo positivo en la wallet de la organización.
• Las ediciones usan comprobaciones de versión para evitar sobrescribir cambios recientes.
• Los usuarios normales no ven las llamadas internas de herramientas.

Backend

• Servicios: site-builder-ai (create), site-builder-conversations, site-builder-messages, ai-models.
• Efectos: consume wallet según uso del modelo y puede crear recursos o páginas.

Relaciones

• Requiere: sitio y página activa.
• Afecta: páginas, layouts, tema, navegación, recursos y versiones.

id: theme-typography modulo: sites app: sites nombre: Personalizar tema y tipografía tipo: configuracion

Personalizar tema y tipografía

Define colores, radios y tipografías que el renderer aplica como tema reutilizable del sitio.

Que se logra

• Resultado: el sitio adopta una identidad visual consistente en la vista previa y en su versión publicada.
• Caso de uso: una franquicia aplica sus colores, tipografías y fuente de marca a un sitio de sucursal sin editar cada página.
• Se combina con: layouts, recursos, Sites AI y publicación.

Donde esta

• Ruta: /[orgId]/sites/[siteId]
• Acceso en UI: Site menu > Theme``
• Componente(s): SiteThemePanel.tsx

Como funciona

1. Abra Theme.
2. Ajuste colores y radio.
3. Busque fuentes para encabezados y cuerpo, o cargue una fuente de marca.
4. Guarde el tema.

Reglas y validaciones

• El HTML o CSS que usa colores fijos puede no reflejar los cambios del tema.
• Sites AI conserva las fuentes elegidas en Theme; no las cambia mediante el chat.

Backend

• Servicios: sites (patch), site-assets, s3-url-signing.
• Efectos: la vista previa y la publicación cargan las fuentes y variables del tema.

Relaciones

• Requiere: sitio creado.
• Afecta: diseño, vista previa y sitio publicado.

id: unpublish-site modulo: sites app: sites nombre: Despublicar un sitio tipo: accion

Despublicar un sitio

Retira los archivos públicos del sitio sin borrar el proyecto ni sus borradores.

Que se logra

• Resultado: el sitio deja de estar disponible públicamente, mientras el proyecto y su contenido siguen editables en Apex.
• Caso de uso: una empresa retira una campaña estacional al terminarla y conserva el sitio para actualizarlo y volver a publicar después.
• Se combina con: publicación de sitios, versiones y dominio propio.

Donde esta

• Ruta: /[orgId]/sites/[siteId]
• Acceso en UI: Publish > Unpublish``
• Componente(s): SitePublishPanel.tsx

Como funciona

1. Abra Publish.
2. Seleccione Unpublish.
3. Confirme la acción.
4. Para volver a publicarlo, use el mismo subdominio.

Reglas y validaciones

• Despublicar no cancela un dominio propio ni su suscripción.
• El subdominio y la configuración del dominio se conservan para una publicación posterior.

Backend

• Servicios: site-publish (create).
• Efectos: elimina archivos públicos de S3 e invalida CloudFront.

Relaciones

• Requiere: sitio publicado.
• Afecta: disponibilidad pública; no elimina el borrador.