feat(proformas): mejorar la estructura de la página de actualización de proformas y corregir selectores en pruebas E2E

apps/web/src/layout/app-fullscreen-layout.tsx

@@ -8,7 +8,7 @@ interface AppFullscreenLayoutFrameProps {
 }
 
 export const AppFullscreenLayoutFrame = ({ children }: AppFullscreenLayoutFrameProps) => {
-  return <AppMain className="h-dvh w-dvw">{children}</AppMain>;
+  return <AppMain className="h-dvh w-dvw rdx-app-fullscreem-layout">{children}</AppMain>;
 };
 
 /**

apps/web/src/layout/app-sidebar-layout.tsx

@@ -21,7 +21,7 @@ export const AppSidebarLayoutFrame = ({ children }: AppSidebarLayoutFrameProps)
       }
     >
       <AppSidebar />
-      <SidebarInset className="flex h-dvh min-w-0 flex-col overflow-hidden bg-background">
+      <SidebarInset className="flex h-dvh min-w-0 flex-col overflow-hidden bg-background rdx-app-sidebar-layout">
         <AppTopbar />
         <AppMain>{children}</AppMain>
       </SidebarInset>

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`:

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.

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.

modules/customer-invoices/src/web/proformas/detail/ui/components/proforma-detail-header-meta.tsx

@@ -12,7 +12,10 @@ export const ProformaDetailHeaderMeta = ({
   const items = useMemo(() => [customerName, documentReference], [customerName, documentReference]);
 
   return (
-    <div className="flex flex-wrap items-center gap-x-3 gap-y-2 text-sm font-medium text-muted-foreground">
+    <div
+      className="flex flex-wrap items-center gap-x-3 gap-y-2 text-sm font-medium text-muted-foreground"
+      id="proforma-detail-identity"
+    >
       {items.map((item, index) => (
         <div className="flex items-center gap-3" key={`${item}-${index}`}>
           {index > 0 ? <span className="hidden text-border sm:inline">|</span> : null}

modules/customer-invoices/src/web/proformas/list/ui/blocks/proformas-grid/proforma-row-actions.tsx

@@ -246,6 +246,7 @@ export function ProformaRowActions({
 
   return (
     <RdxRowActions
+      data-testid={`proforma-row-${proforma.id}`}
       overflowActions={menuActions}
       overflowLabel={t("common.more_actions")}
       primaryActions={visibleActions}

modules/customer-invoices/src/web/proformas/update/ui/blocks/selected-recipient/selected-recipient-summary.tsx

@@ -72,7 +72,12 @@ export const SelectedRecipientSummary = ({
         <div className="min-w-0 space-y-3">
           <div className="min-w-0 space-y-1">
             <div className="flex min-w-0 flex-wrap items-center gap-2">
-              <p className="min-w-0 wrap-break-word text-base font-semibold">{recipient.name}</p>
+              <p
+                className="min-w-0 wrap-break-word text-base font-semibold"
+                id="proforma-recipient-name"
+              >
+                {recipient.name}
+              </p>
 
               {recipient.status ? (
                 <RdxBadge

modules/customer-invoices/src/web/proformas/update/ui/pages/proforma-update-page.tsx

@@ -49,14 +49,22 @@ export const ProformaUpdatePage = () => {
   };
 
   if (ctrl.isInitialLoading) {
-    return <ProformaUpdateSkeleton />;
+    return (
+      <RdxPageFrame>
+        <RdxPageContainer width="content">
+          <RdxPageContent>
+            <ProformaUpdateSkeleton />
+          </RdxPageContent>
+        </RdxPageContainer>
+      </RdxPageFrame>
+    );
   }
 
   if (ctrl.pageError) {
     return (
       <RdxPageFrame>
-        <RdxPageContainer width="full">
-          <div className="mx-auto w-full max-w-3xl">
+        <RdxPageContainer width="content">
+          <RdxPageContent>
             <PageErrorState
               description={ctrl.pageError.description}
               primaryAction={
@@ -90,13 +98,12 @@ export const ProformaUpdatePage = () => {
               title={ctrl.pageError.title}
               variant={ctrl.pageError.variant}
             />
-          </div>
+          </RdxPageContent>
         </RdxPageContainer>
       </RdxPageFrame>
     );
   }
 
-  const hasPageAlerts = updateCtrl.isUpdateError || updateCtrl.isSeriesLoadError;
   const actionBar = (
     <RdxEditorActionBar
       leading={
@@ -120,6 +127,7 @@ export const ProformaUpdatePage = () => {
       primary={
         <RhfSubmitActionButton
           busyLabel="Guardando..."
+          data-testid="proforma-update-submit"
           disabled={updateCtrl.isUpdating}
           formId={updateCtrl.formId}
           isBusy={updateCtrl.form.formState.isSubmitting}
@@ -188,61 +196,50 @@ export const ProformaUpdatePage = () => {
           }
         >
           <RdxPageContainer width="full">
-            {hasPageAlerts ? (
-              <RdxPageContainer className="pb-0" width="full">
-                <RdxPageContent spacing="compact">
-                  {updateCtrl.isUpdateError && (
-                    <ErrorAlert
-                      message={
-                        (updateCtrl.updateError as Error)?.message ??
-                        t(
-                          "pages.proformas.update.error_msg",
-                          "Revisa los datos e inténtalo de nuevo."
+            <RdxPageContent>
+              {updateCtrl.isUpdateError ? (
+                <ErrorAlert
+                  message={
+                    (updateCtrl.updateError as Error)?.message ??
+                    t("pages.proformas.update.error_msg", "Revisa los datos e inténtalo de nuevo.")
+                  }
+                  title={t("pages.proformas.update.error_title", "No se pudo guardar los cambios")}
+                />
+              ) : null}
+
+              {updateCtrl.isSeriesLoadError ? (
+                <ErrorAlert
+                  message={
+                    updateCtrl.seriesLoadError instanceof Error
+                      ? updateCtrl.seriesLoadError.message
+                      : t(
+                          "pages.proformas.update.series_load_error.message",
+                          "Inténtalo de nuevo más tarde."
                         )
-                      }
-                      title={t(
-                        "pages.proformas.update.error_title",
-                        "No se pudo guardar los cambios"
-                      )}
-                    />
+                  }
+                  title={t(
+                    "pages.proformas.update.series_load_error.title",
+                    "No se pudieron cargar las series de facturación"
                   )}
+                />
+              ) : null}
 
-                  {updateCtrl.isSeriesLoadError && (
-                    <ErrorAlert
-                      message={
-                        updateCtrl.seriesLoadError instanceof Error
-                          ? updateCtrl.seriesLoadError.message
-                          : t(
-                              "pages.proformas.update.series_load_error.message",
-                              "Inténtalo de nuevo más tarde."
-                            )
-                      }
-                      title={t(
-                        "pages.proformas.update.series_load_error.title",
-                        "No se pudieron cargar las series de facturación"
-                      )}
-                    />
-                  )}
-                </RdxPageContent>
-              </RdxPageContainer>
-            ) : null}
-
-            <ProformaUpdateEditorForm
-              className={hasPageAlerts ? "pt-0" : undefined}
-              formId={updateCtrl.formId}
-              isSubmitting={updateCtrl.isUpdating}
-              itemsCtrl={updateCtrl.itemsCtrl}
-              onChangeCustomerClick={selectCustomerCtrl.selectCtrl.openDialog}
-              onCreateCustomerClick={selectCustomerCtrl.openQuickCreateDialog}
-              onPaymentTermChange={updateCtrl.handlePaymentTermChange}
-              onReset={updateCtrl.resetForm}
-              onSubmit={updateCtrl.onSubmit}
-              paymentCtrl={updateCtrl.paymentCtrl}
-              selectedCustomer={updateCtrl.selectedCustomer}
-              seriesOptions={updateCtrl.seriesOptions}
-              taxCtrl={updateCtrl.taxCtrl}
-              totalsCtrl={updateCtrl.totalsCtrl}
-            />
+              <ProformaUpdateEditorForm
+                formId={updateCtrl.formId}
+                isSubmitting={updateCtrl.isUpdating}
+                itemsCtrl={updateCtrl.itemsCtrl}
+                onChangeCustomerClick={selectCustomerCtrl.selectCtrl.openDialog}
+                onCreateCustomerClick={selectCustomerCtrl.openQuickCreateDialog}
+                onPaymentTermChange={updateCtrl.handlePaymentTermChange}
+                onReset={updateCtrl.resetForm}
+                onSubmit={updateCtrl.onSubmit}
+                paymentCtrl={updateCtrl.paymentCtrl}
+                selectedCustomer={updateCtrl.selectedCustomer}
+                seriesOptions={updateCtrl.seriesOptions}
+                taxCtrl={updateCtrl.taxCtrl}
+                totalsCtrl={updateCtrl.totalsCtrl}
+              />
+            </RdxPageContent>
           </RdxPageContainer>
         </RdxPageFrame>
 

modules/customers/src/common/features/customer-selection/ui/dialogs/select-customer-dialog.tsx

@@ -88,7 +88,11 @@ export const SelectCustomerDialog = ({
             <Button onClick={ctrl.closeDialog} variant="outline">
               Cancelar
             </Button>
-            <Button disabled={ctrl.isLoading || !selectedCustomer} onClick={handleConfirm}>
+            <Button
+              disabled={ctrl.isLoading || !selectedCustomer}
+              id="customer-selection-confirm"
+              onClick={handleConfirm}
+            >
               {selectedCustomer ? "Confirmar selección" : "Seleccionar cliente"}
             </Button>
           </div>

modules/customers/src/common/features/customer-selection/ui/dialogs/select-customer-selection-list.tsx

@@ -50,6 +50,7 @@ export const SelectCustomerSelectionList = ({
             "cursor-pointer",
             customer.id === selectedCustomer?.id && "border-primary bg-accent"
           )}
+          data-testid={`customer-selection-${customer.id}`}
           key={customer.id}
           onClick={() => onSelect(customer)}
           role="listitem"

modules/customers/src/web/update/ui/pages/customer-update-page.tsx

@@ -29,52 +29,51 @@ export const CustomerUpdatePage = () => {
     return (
       <RdxPageFrame>
         <RdxPageContainer width="content">
-          <PageErrorState
-            description={ctrl.pageError.description}
-            primaryAction={
-              ctrl.pageError.canRetry
-                ? {
-                    label: ctrl.isRetrying
-                      ? t("update.page_error.actions.retrying")
-                      : t("update.page_error.actions.retry"),
-                    onClick: ctrl.retryUpdate,
-                    isLoading: ctrl.isRetrying,
-                  }
-                : ctrl.pageError.variant === "forbidden"
+          <RdxPageContent>
+            <PageErrorState
+              description={ctrl.pageError.description}
+              primaryAction={
+                ctrl.pageError.canRetry
                   ? {
-                      label: t("update.page_error.actions.go_home"),
-                      onClick: ctrl.goHome,
+                      label: ctrl.isRetrying
+                        ? t("update.page_error.actions.retrying")
+                        : t("update.page_error.actions.retry"),
+                      onClick: ctrl.retryUpdate,
+                      isLoading: ctrl.isRetrying,
                     }
-                  : {
+                  : ctrl.pageError.variant === "forbidden"
+                    ? {
+                        label: t("update.page_error.actions.go_home"),
+                        onClick: ctrl.goHome,
+                      }
+                    : {
+                        label: t("update.page_error.actions.back_to_list"),
+                        onClick: ctrl.goBackToList,
+                      }
+              }
+              reference={ctrl.pageError.reference}
+              secondaryAction={
+                ctrl.pageError.canRetry
+                  ? {
                       label: t("update.page_error.actions.back_to_list"),
                       onClick: ctrl.goBackToList,
                     }
-            }
-            reference={ctrl.pageError.reference}
-            secondaryAction={
-              ctrl.pageError.canRetry
-                ? {
-                    label: t("update.page_error.actions.back_to_list"),
-                    onClick: ctrl.goBackToList,
-                  }
-                : undefined
-            }
-            title={ctrl.pageError.title}
-            variant={ctrl.pageError.variant}
-          />
+                  : undefined
+              }
+              title={ctrl.pageError.title}
+              variant={ctrl.pageError.variant}
+            />
+          </RdxPageContent>
         </RdxPageContainer>
       </RdxPageFrame>
     );
   }
 
-  const hasPageAlerts = updateCtrl.isUpdateError;
-
   return (
     <FormProvider {...updateCtrl.form}>
       <UnsavedChangesProvider isDirty={updateCtrl.form.formState.isDirty}>
         <RdxPageFrame
-          contentClassName="bg-muted/20"
-          footer={<h1>hola</h1>}
+          contentClassName="bg-red-500"
           header={
             <CustomerUpdateHeader
               formId={updateCtrl.formId}
@@ -99,28 +98,16 @@ export const CustomerUpdatePage = () => {
             />
           }
         >
-          <RdxPageContainer className="bg-white" width="content">
+          <RdxPageContainer width="content">
             <RdxPageContent>
-              {hasPageAlerts ? (
-                <RdxPageContainer className="pb-0" width="full">
-                  <div className="flex min-w-0 flex-col gap-4">
-                    {updateCtrl.isUpdateError && (
-                      <ErrorAlert
-                        message={
-                          (updateCtrl.updateError as Error)?.message ??
-                          t(
-                            "pages.customers.update.error_msg",
-                            "Revisa los datos e inténtalo de nuevo."
-                          )
-                        }
-                        title={t(
-                          "pages.customers.update.error_title",
-                          "No se pudo guardar los cambios"
-                        )}
-                      />
-                    )}
-                  </div>
-                </RdxPageContainer>
+              {updateCtrl.isUpdateError ? (
+                <ErrorAlert
+                  message={
+                    (updateCtrl.updateError as Error)?.message ??
+                    t("pages.customers.update.error_msg", "Revisa los datos e inténtalo de nuevo.")
+                  }
+                  title={t("pages.customers.update.error_title", "No se pudo guardar los cambios")}
+                />
               ) : null}
 
               <CustomerUpdateEditorForm
@@ -130,26 +117,6 @@ export const CustomerUpdatePage = () => {
                 onReset={updateCtrl.resetForm}
                 onSubmit={updateCtrl.onSubmit}
               />
-
-              <div className="rounded-2xl border border-border/60 bg-background px-4 py-4 shadow-xs md:px-6 md:py-6">
-                <div className="flex min-w-0 flex-col gap-6">
-                  {updateCtrl.isUpdateError ? (
-                    <ErrorAlert
-                      message={
-                        (updateCtrl.updateError as Error)?.message ??
-                        t(
-                          "pages.customers.update.error_msg",
-                          "Revisa los datos e inténtalo de nuevo."
-                        )
-                      }
-                      title={t(
-                        "pages.customers.update.error_title",
-                        "No se pudo guardar los cambios"
-                      )}
-                    />
-                  ) : null}
-                </div>
-              </div>
             </RdxPageContent>
           </RdxPageContainer>
         </RdxPageFrame>

tests/e2e/customer-invoices/proformas/create-proforma.spec.ts

@@ -0,0 +1,16 @@
+import { expect, test } from "@playwright/test";
+
+import { loginViaUi } from "../../support/login-via-ui";
+
+import { createProformaViaUi } from "./support/create-proforma-via-ui";
+
+test("CUSTOMER-INVOICES-PROFORMA-CREATE-001: crea un borrador mínimo sin líneas y comprueba persistencia", async ({
+  page,
+}, testInfo) => {
+  await loginViaUi(page);
+  const proforma = await createProformaViaUi(page, testInfo);
+  await page.reload();
+  await expect(page).toHaveURL((url) => url.pathname === `/proformas/${proforma.id}/edit`);
+  await expect(page.locator('input[name="proformaReference"]')).toHaveValue(proforma.reference);
+  await expect(page.locator("#proforma-recipient-name")).toHaveText(proforma.customer.name);
+});

tests/e2e/customer-invoices/proformas/proforma-list.spec.ts

@@ -0,0 +1,21 @@
+import { expect, test } from "@playwright/test";
+
+import { loginViaUi } from "../../support/login-via-ui";
+
+import { createProformaViaUi } from "./support/create-proforma-via-ui";
+
+test("CUSTOMER-INVOICES-PROFORMA-LIST-001: muestra la proforma persistida propia del escenario", async ({
+  page,
+}, testInfo) => {
+  await loginViaUi(page);
+  const proforma = await createProformaViaUi(page, testInfo);
+  await page.goto("/proformas");
+  // La referencia asignada por el servidor permite aislar el registro sin depender de su página.
+  await page.locator('input[inputmode="search"]').fill(proforma.reference);
+  const row = page
+    .getByRole("row")
+    .filter({ has: page.getByTestId(`proforma-row-${proforma.id}`) });
+  await expect(row).toBeVisible();
+  await expect(row).toContainText(proforma.reference);
+  await expect(row).toContainText(proforma.customer.name);
+});

tests/e2e/customer-invoices/proformas/proforma-view.spec.ts

@@ -0,0 +1,19 @@
+import { expect, test } from "@playwright/test";
+
+import { loginViaUi } from "../../support/login-via-ui";
+
+import { createProformaViaUi } from "./support/create-proforma-via-ui";
+
+test("CUSTOMER-INVOICES-PROFORMA-VIEW-001: muestra referencia y cliente persistidos al abrir y recargar detalle", async ({
+  page,
+}, testInfo) => {
+  await loginViaUi(page);
+  const proforma = await createProformaViaUi(page, testInfo);
+  await page.goto(`/proformas/${proforma.id}`);
+  const identity = page.locator("#proforma-detail-identity");
+  await expect(identity).toContainText(proforma.reference);
+  await expect(identity).toContainText(proforma.customer.name);
+  await page.reload();
+  await expect(identity).toContainText(proforma.reference);
+  await expect(identity).toContainText(proforma.customer.name);
+});

tests/e2e/customer-invoices/proformas/support/create-proforma-via-ui.ts

@@ -0,0 +1,29 @@
+import { randomUUID } from "node:crypto";
+
+import type { Page, TestInfo } from "@playwright/test";
+import { expect } from "@playwright/test";
+
+import { createCustomerViaUi } from "../../../customers/support/create-customer-via-ui";
+
+export async function createProformaViaUi(page: Page, testInfo: TestInfo) {
+  const token = `e2eproforma${randomUUID().replaceAll("-", "")}`;
+  const customer = await createCustomerViaUi(page, testInfo, `E2E Proforma ${token}`);
+  await page.goto("/proformas/create");
+  await page.locator("#proforma-create-customer").click();
+  await page.getByRole("dialog").locator('input[inputmode="search"]').fill(token);
+  await page.getByTestId(`customer-selection-${customer.id}`).click();
+  await page.locator("#customer-selection-confirm").click();
+  await expect(page.locator("#proforma-create-customer")).toContainText(customer.name);
+  await page.getByTestId("submit-button").click();
+
+  await expect(page).toHaveURL(/\/proformas\/[^/]+\/edit\?returnTo=/);
+  const referenceInput = page.locator('input[name="proformaReference"]');
+  await expect(referenceInput).toHaveValue(/\S+/);
+  await expect(page.locator("#proforma-recipient-name")).toHaveText(customer.name);
+  const reference = await referenceInput.inputValue();
+  const id = new URL(page.url()).pathname.split("/")[2];
+  if (!id) {
+    throw new Error("Missing proforma ID in edit URL");
+  }
+  return { id, reference, customer, token };
+}

tests/e2e/customer-invoices/proformas/update-proforma.spec.ts

@@ -0,0 +1,29 @@
+import { expect, test } from "@playwright/test";
+
+import { loginViaUi } from "../../support/login-via-ui";
+
+import { createProformaViaUi } from "./support/create-proforma-via-ui";
+
+test("CUSTOMER-INVOICES-PROFORMA-UPDATE-001: modifica referencia y descripción del borrador y comprueba persistencia", async ({
+  page,
+}, testInfo) => {
+  await loginViaUi(page);
+  const proforma = await createProformaViaUi(page, testInfo);
+  const reference = `E2E ${proforma.token}`;
+  const description = `E2E updated draft ${proforma.token}`;
+  await page.locator('input[name="reference"]').fill(reference);
+  await page.locator('input[name="description"]').fill(description);
+  const responsePromise = page.waitForResponse(
+    (response) =>
+      response.request().method() === "PUT" &&
+      new URL(response.url()).pathname.endsWith(`/proformas/${proforma.id}`)
+  );
+  await page.getByTestId("proforma-update-submit").click();
+  expect((await responsePromise).status()).toBe(200);
+  await expect(page).toHaveURL((url) => url.pathname === `/proformas/${proforma.id}/edit`);
+  await expect(page.locator('input[name="reference"]')).toHaveValue(reference);
+  await expect(page.locator('input[name="description"]')).toHaveValue(description);
+  await page.reload();
+  await expect(page.locator('input[name="reference"]')).toHaveValue(reference);
+  await expect(page.locator('input[name="description"]')).toHaveValue(description);
+});