Descripción general para desarrolladores de FaceFlow
Descripción general para desarrolladores de FaceFlow
FaceFlow es el núcleo estructurado de creación sin código dentro de PageFace.
Desde una perspectiva técnica, es mejor entenderlo como un sistema de objetos reutilizables, renderizado gobernado y límites claros de propiedad, en lugar de como un editor de páginas de libre formato.
El modelo técnico central
FaceFlow está compuesto por un pequeño conjunto de tipos de objetos con responsabilidades distintas:
- Variables para fragmentos reutilizables y ligeros
- Componentes para contratos de secciones reutilizables
- Diseños para marcos compartidos de páginas
- Páginas para experiencias ensambladas
- Listas para salida dinámica impulsada por colecciones
- Formularios para flujos de envío estructurados
- Reseñas para contenido de confianza moderado
Cada objeto existe para resolver un nivel diferente del sistema del sitio web. Cuando esos límites permanecen claros, FaceFlow se mantiene mantenible a escala.
Cómo pensar sobre FaceFlow
El modelo mental más claro es:
Variables -> small reusable fragments
Components -> reusable sections
Layouts -> page shells
Pages -> assembled experiences
Lists -> dynamic archives and collections
Forms -> lead and request workflows
Reviews -> trust and proof workflowsEsto no es solo una jerarquía de contenido. Es una jerarquía arquitectónica.
Límites de los objetos
Usa este modelo de decisión:
- usa una Variable cuando la unidad reutilizable sea pequeña y parametrizada
- usa un Componente cuando la unidad reutilizable sea una sección completa con un esquema orientado al editor
- usa un Diseño cuando la preocupación sea el marco de página alrededor de muchas Páginas
- usa una Página cuando armes una ruta o experiencia final
- usa una Lista cuando la selección de contenido y la paginación formen parte del contrato
- usa un Formulario cuando estés recopilando envíos estructurados
- usa una Reseña cuando estés recopilando y publicando retroalimentación pública gobernada
La mayor parte de la deriva técnica en FaceFlow ocurre cuando un objeto comienza a asumir la responsabilidad de otro.
Sistema de ejemplo
Layout:
default-site-shell
Page:
/enterprise/
Components:
hero-banner
benefits-grid
demo-request-section
review-strip
Embedded systems:
<div data-form-embed="enterprise-demo-request"></div>
<div data-review-embed="customer-success-reviews"></div>
Variables:
[[site-announcement]]
[[sales-contact-badge]]Ese ejemplo sigue siendo mantenible porque cada preocupación tiene un hogar claro.
Alcance e impacto de los cambios
El alcance es uno de los conceptos técnicos más importantes en FaceFlow.
Controla si una sección reutilizable se comporta como:
- un activo a nivel de sitio
- un activo de la familia de diseños
- un activo local de la página
Cuando los usuarios técnicos eligen el alcance equivocado, el impacto de los cambios se vuelve difícil de predecir. Una sección local puede convertirse accidentalmente en una dependencia global, o el contenido repetido de una página puede permanecer duplicado mucho después de que debería haberse compartido.
Capa de plantillas
Las plantillas de FaceFlow se crean mediante Facet.
Eso significa que los usuarios técnicos deben entender:
- salida de campos
- condicionales
- bucles
- filtros
- incrustación de Variables
- composición segura de secciones
Ejemplo:
<section class="hero">
<h1>{{ title }}</h1>
{{#if summary}}
<p>{{ summary }}</p>
{{/if}}
[[sales-contact-badge]]
</section>Facet es la capa de plantillas. FaceFlow es el sistema de objetos estructurado alrededor de ella.
En qué deben centrarse los usuarios técnicos
Al diseñar con FaceFlow, las decisiones técnicas más importantes suelen ser:
- dónde pertenece la reutilización
- cuánta exposición de esquema debe tener una sección
- si algo debe ser dinámico o estático
- cuál es el verdadero radio de cambio de un activo compartido
- cuánto de la página pertenece en Diseño frente a Componente frente a composición de Página
Esas decisiones tienen más impacto en la mantenibilidad que cualquier elemento individual de contenido de la página.
Errores técnicos comunes
Evita estos patrones:
- usar Componentes donde las Variables serían más claras
- usar Variables donde se necesita un esquema de sección real
- empujar contenido específico de la página hacia el Diseño
- crear un Componente de gran tamaño que intenta resolver muchos casos de uso no relacionados
- tratar las Listas como un recurso alternativo para una arquitectura de contenido poco clara
- incrustar flujos de trabajo comerciales sin revisar la ruta completa de renderizado y moderación
Orden de lectura recomendado
Esa ruta avanza desde las unidades reutilizables más pequeñas hasta el ensamblaje completo del sitio y después a la capa de plantillas.