Saltar al contenido principal

Resumen

Un Sitemap es una forma visual de planear y documentar un producto digital construido sobre CXF — una web app, una mobile app o un servidor MCP. En un canvas interactivo mapeas las páginas del producto, las conectas con edges de navegación, y llenas cada página con secciones y componentes. Luego enlazas recursos de CXFendpoints, funnels y events — a cualquier nodo, para que el diagrama registre qué recursos impulsan qué partes del producto. Para el panorama completo, consulta Conceptos básicos.

Dónde encontrarlo

Los sitemaps están en Docs explorer → Sitemaps.

Estructura

Un sitemap es un canvas de páginas conectadas por edges. Cada página contiene una lista de secciones y componentes:
NodoRol
PageUna pantalla/ruta de primer nivel — los nodos que ves y conectas en el canvas.
SectionUna agrupación opcional dentro de una página.
ComponentUna pieza de una página — directa en la página, o anidada dentro de una sección.
Los edges conectan páginas y llevan un tipo: navigation, contains o depends on.

Qué hay en un nodo

Cada página, sección y componente lleva:
PropertyDescripción
labelNombre visible — único entre sus hermanos.
statusPlanned, In progress, Live o Deprecated.
relative_url(Páginas) La ruta de la página, p. ej. /home — combinada con la base URL por entorno del sitemap.
descriptionNotas en rich-text (markdown).
cxf_resourcesLos endpoints, funnels y events enlazados.
Cada nodo también tiene sus propias Activities — comentarios, tareas y aprobaciones — para que un equipo colabore justo en la parte del producto que está planeando.

Enlazar recursos de CXF

Adjunta endpoints, funnels y event templates a cualquier nodo para documentar qué lo impulsa. Una búsqueda de uso de recursos responde luego la pregunta inversa: ¿qué sitemaps y nodos referencian este endpoint / funnel / event?

Entornos & URLs

Un sitemap guarda una base URL por entorno (por ejemplo production y development); cada página agrega una sola ruta relativa. El canvas tiene un selector de entorno que previsualiza el enlace externo de cada página para el entorno seleccionado.

Properties del sitemap

PropertyTipoDescripción
namestringEl nombre del sitemap.
descriptionstringDescripción opcional.
platformenumweb, mobile o mcp (descriptivo).
statusenumdraft, active o archived.
urlsobjectBase URL por entorno.
nodes / edgesarrayLas páginas (con sus secciones y componentes) y los edges entre ellas.

Búsqueda & deep-linking

La búsqueda de la toolbar abarca cada página, sección, componente y recurso enlazado (insensible a acentos), y siempre devuelve el nodo coincidente. Cada nodo es deep-linkable, así puedes compartir un enlace directo a una página, sección o componente específico.

Export

Descarga un sitemap completo como un documento estructurado en PDF o Markdown. Los recursos enlazados se resuelven a sus definiciones reales — un endpoint lista sus parámetros (defaults establecidos vs expuestos a quien llama), y los funnels y events obtienen un resumen corto — así el export sirve también como documentación del producto.

Seeds

El soporte de Seeds para sitemaps está próximamente.

Gobernanza y permisos

Solo un super admin o un Master puede crear, editar y eliminar sitemaps.

Acceso por API

Los sitemaps tienen CRUD completo por la User API, más la búsqueda de uso de recursos y las operaciones de export en Markdown/PDF. Consulta la API reference.

Relacionado

APIs Playground

Los endpoints que enlazas a los nodos.

Engagement Funnels

Los funnels que enlazas a los nodos.

Events & Automation

Los events que enlazas a los nodos.

Activities

Colabora en cada nodo.