From c6de77897d492e41f229e2fdcac3f36e6780bc2d Mon Sep 17 00:00:00 2001
From: David <darranz@rodax-software.com>
Date: Mon, 14 Sep 2026 11:26:54 +0200
Subject: [PATCH] =?UTF-8?q?feat(ui):=20mejorar=20la=20estructura=20y=20com?=
 =?UTF-8?q?posici=C3=B3n=20de=20RdxPageContent=20en=20patrones=20y=20siste?=
 =?UTF-8?q?ma=20UI?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/frontend/frontend-architecture.md | 15 ++++++++++++++-
 docs/frontend/ui-patterns.md           | 12 +++++++-----
 docs/frontend/ui-system.md             | 15 +++++++++++++++
 3 files changed, 36 insertions(+), 6 deletions(-)

diff --git a/docs/frontend/frontend-architecture.md b/docs/frontend/frontend-architecture.md
index 0590715a..eb13e4db 100644
--- a/docs/frontend/frontend-architecture.md
+++ b/docs/frontend/frontend-architecture.md
@@ -68,9 +68,22 @@ AppMain
     ├── content
     │   └── RdxPageContainer
     │       └── RdxPageContent
-    └── footer opcional
+    └── footer opcional   
 ```
 
+```text
+RdxPageFrame
+→ estructura y scroll
+
+RdxPageContainer
+→ ancho y padding
+
+RdxPageContent
+→ composición de los hijos principales
+```
+
+Regla: Las Pages no deben reconstruir estas responsabilidades con wrappers HTML locales.
+
 ## 6. Identity y sesión
 
 El runtime actual se compone en `apps/web/src/app.tsx`:
diff --git a/docs/frontend/ui-patterns.md b/docs/frontend/ui-patterns.md
index c1836832..9ebf8007 100644
--- a/docs/frontend/ui-patterns.md
+++ b/docs/frontend/ui-patterns.md
@@ -36,18 +36,20 @@ El controller de página concentra URL, filtros, consulta, estados y navegación
 
 ```tsx
 <RdxPageFrame
-  header={<RdxEditorHeader title={title} onBack={onBack} />}
-  footer={<RdxEditorActionBar secondary={cancel} primary={submit} />}
+  header={<RdxEditorHeader />}
+  footer={<RdxEditorActionBar />}
 >
   <RdxPageContainer width="content">
-    <RdxPageContent aside={aside}>
-      {notice}
-      <RdxPanel title={sectionTitle}>{fields}</RdxPanel>
+    <RdxPageContent>
+      {pageError ? <ErrorAlert /> : null}
+      <Editor />
     </RdxPageContent>
   </RdxPageContainer>
 </RdxPageFrame>
 ```
 
+Los errores inline no definen su propio spacing estructural. Participan del spacing estándar de RdxPageContent igual que el resto de hijos principales.
+
 Footer y aside son opcionales. `content` es adecuado para formularios focalizados; `full` para editores documentales amplios. Create y Update deben compartir geometría cuando solo cambian defaults, submit o navegación.
 
 Loading y error bloqueante usan también `RdxPageFrame` y `RdxPageContainer`; no reconstruyen el viewport.
diff --git a/docs/frontend/ui-system.md b/docs/frontend/ui-system.md
index d2e28aca..c3577eb7 100644
--- a/docs/frontend/ui-system.md
+++ b/docs/frontend/ui-system.md
@@ -144,6 +144,21 @@ Excepción: un detalle documental puede configurar el contenido del frame con `o
 - Tablas y editores de líneas conservan su layout funcional.
 - Evitar card dentro de card y sombras acumuladas.
 
+### Composición del contenido principal
+
+`RdxPageContent` es el compositor estructural de los hijos principales de una página.
+
+Los avisos, errores inline, secciones y contenido funcional deben ser hijos directos cuando pertenezcan al mismo nivel visual.
+`RdxPanel` no es un wrapper genérico. Se usa únicamente cuando existe una sección con identidad visual o semántica propia.
+
+```tsx
+<RdxPageContent>
+  {error ? <ErrorAlert /> : null}
+  <Editor />
+</RdxPageContent>
+```
+No deben introducirse wrappers adicionales únicamente para controlar gap, ancho, padding o centrado.
+
 ## 8. Responsive y accesibilidad
 
 - Las columnas se apilan antes de producir overflow horizontal.