diff --git a/docs/componentes-de-interfaz.md b/docs/componentes-de-interfaz.md
index d0ec170..e860f67 100644
--- a/docs/componentes-de-interfaz.md
+++ b/docs/componentes-de-interfaz.md
@@ -151,6 +151,8 @@ El estándar se define en [Patrón de listados de entidades](patron-de-listados-
EntityTable recibe datos y columnas tipadas; utiliza TanStack Table para búsqueda, ordenación, visibilidad y paginación local. Admite búsqueda y filtros controlados por el módulo, conservando su semántica y ámbito. Las columnas de identificación y acciones quedan visibles. Los menús utilizan Base UI y conservan los callbacks de las acciones originales. No realiza peticiones ni conoce DTO de negocio.
+La primera columna con `value`, excluida `actions`, se ordena inicialmente en ascendente. Una columna puede declarar `defaultSort: "asc" | "desc"` para elegir otro criterio; declarar como máximo una por tabla. Tickets e intervenciones lo usan en última actualización descendente. La ordenación se aplica antes de paginar, conserva empates y se refleja en la cabecera y el selector, incluso sin filas. «Orden inicial» restaura este criterio y las cabeceras alternan dirección sin eliminar la ordenación. Las tablas sin columnas comparables conservan el orden recibido.
+
La paginación es local sobre los conjuntos que las API actuales ya devuelven. No simula paginación de servidor. La selección del activo para el panel sigue perteneciendo a Inventario, fuera de la tabla compartida.
Los inventarios de activos y recursos componen las primitivas Tabs de shadcn/ui con EntityTable para filtrar por plantilla. La barra admite desplazamiento horizontal y navegación por teclado; incluye «Todo» y las plantillas del catálogo de la compañía. Un único panel conserva la tabla, su ordenación y sus columnas al cambiar de pestaña. `filterKey` reinicia la página; `filtersApplied` y `onClearFilters` integran el filtro con los estados vacíos y la limpieza común del listado.
diff --git a/docs/patron-de-listados-de-entidades.md b/docs/patron-de-listados-de-entidades.md
index 764325e..3e28174 100644
--- a/docs/patron-de-listados-de-entidades.md
+++ b/docs/patron-de-listados-de-entidades.md
@@ -26,7 +26,7 @@ El pie opcional está fuera de la tabla y solo aparece cuando existe contenido c
- Búsqueda y filtros se combinan; filtrar o cambiar tamaño de página vuelve a la primera página. Si una actualización reduce resultados, se ajusta la página para no mostrar un rango inexistente.
- Contar los resultados filtrados antes de paginar. Cero resultados se expresa como 0-0 de 0. La ordenación actúa sobre todos los resultados filtrados antes de paginar y mantiene un orden estable para empates.
- Columnas configurables mediante controles con etiquetas; identificación y acciones no se ocultan. No se pierde acceso a una acción por ocultar otra columna. La configuración es local a la vista y no se guarda en datos de negocio.
-- Solo ofrecer ordenación para valores con significado comparable. Cabeceras ordenables son botones accesibles y expresan aria-sort. Permitir recuperar el orden inicial, respetando los órdenes existentes, por ejemplo última actualización en tickets e intervenciones.
+- Solo ofrecer ordenación para valores con significado comparable. Todo listado ordenable comienza con una columna ordenada e indicada mediante `aria-sort` y el selector de ordenación. El criterio común es la primera columna ordenable en ascendente: Nombre en usuarios, activos y catálogos; Persona en teletrabajo y accesos remotos; Departamento en asignaciones. Tickets e intervenciones usan última actualización descendente. Las cabeceras alternan ascendente/descendente y «Orden inicial» restaura el criterio del listado.
- El identificador principal abre la ficha existente si hay una. Usar enlace si existe una ruta real; botón si abre diálogo, detalle en memoria o panel. No inventar rutas.
- Representar estados mediante indicador visual y texto, nunca solo color. Mantener los avisos de revisión e información contextual.
- Las relaciones son navegables cuando el destino ya ofrece navegación adecuada; no introducir enlaces ficticios ni nuevas rutas.
diff --git a/modules/companies/src/web/interventions/list/ui/interventions-page.tsx b/modules/companies/src/web/interventions/list/ui/interventions-page.tsx
index 69734bd..f586a55 100644
--- a/modules/companies/src/web/interventions/list/ui/interventions-page.tsx
+++ b/modules/companies/src/web/interventions/list/ui/interventions-page.tsx
@@ -176,6 +176,7 @@ export function InterventionsPage(props: InterventionsPageProps) {
},
{
id: "updated",
+ defaultSort: "desc",
label: t("tickets.updated"),
value: (intervention) => intervention.history.at(-1)?.recordedAt,
render: (intervention) => <>{date(intervention.history.at(-1)?.recordedAt)},
diff --git a/modules/companies/src/web/tickets/list/ui/tickets-page.tsx b/modules/companies/src/web/tickets/list/ui/tickets-page.tsx
index 97fe489..efab759 100644
--- a/modules/companies/src/web/tickets/list/ui/tickets-page.tsx
+++ b/modules/companies/src/web/tickets/list/ui/tickets-page.tsx
@@ -148,6 +148,7 @@ export function TicketsPage(props: TicketsPageProps) {
},
{
id: "updated",
+ defaultSort: "desc",
label: t("tickets.updated"),
value: (ticket) => ticket.history.at(-1)?.recordedAt,
render: (ticket) => <>{date(ticket.history.at(-1)?.recordedAt)},
diff --git a/modules/companies/src/web/workspace/view/ui/workspace-sidebar.tsx b/modules/companies/src/web/workspace/view/ui/workspace-sidebar.tsx
index a64aef9..025089f 100644
--- a/modules/companies/src/web/workspace/view/ui/workspace-sidebar.tsx
+++ b/modules/companies/src/web/workspace/view/ui/workspace-sidebar.tsx
@@ -90,22 +90,12 @@ export function WorkspaceSidebar({
{area === "catalogs" && (
)}
))}
- {canManageUsers && (
-
-
- {identityTranslation("users")}
-
- )}
+
{current.area === "catalogs" && (
)}
+ {canManageUsers && (
+
+
+ {identityTranslation("users")}
+
+ )}
{companies.map((company) => (
= {
label: string;
render: (item: T) => ReactNode;
value?: (item: T) => string | number | boolean | null | undefined;
+ defaultSort?: "asc" | "desc";
hideable?: boolean;
};
diff --git a/packages/rdx-ui/src/components/entity-table-configuration.tsx b/packages/rdx-ui/src/components/entity-table-configuration.tsx
index 8fd01d7..e80a92c 100644
--- a/packages/rdx-ui/src/components/entity-table-configuration.tsx
+++ b/packages/rdx-ui/src/components/entity-table-configuration.tsx
@@ -40,9 +40,11 @@ export function EntityTableConfiguration({
onValueChange={(value) => {
const [column, direction] = value.split(":");
- setSorting(
- column && column !== "initial" ? [{ id: column, desc: direction === "desc" }] : []
- );
+ if (column && column !== "initial") {
+ setSorting([{ id: column, desc: direction === "desc" }]);
+ } else {
+ table.resetSorting();
+ }
onSort();
}}
options={[
diff --git a/packages/rdx-ui/src/entity-list.test.tsx b/packages/rdx-ui/src/entity-list.test.tsx
index 791dcc1..5aa8b3c 100644
--- a/packages/rdx-ui/src/entity-list.test.tsx
+++ b/packages/rdx-ui/src/entity-list.test.tsx
@@ -60,6 +60,105 @@ test("la búsqueda local reduce el conjunto completo antes de paginar y permite
assert.equal(html.includes("Persona 01"), false);
});
+test("el orden inicial ascendente se indica en la cabecera y se aplica antes de paginar", () => {
+ const html = renderToStaticMarkup(
+
+ );
+
+ assert.match(html, /]*aria-sort="ascending"[^>]*>[\s\S]*?Nombre/);
+ assert.ok(html.indexOf("Persona 01") < html.indexOf("Persona 02"));
+ assert.ok(html.includes("Persona 10"));
+ assert.equal(html.includes("Persona 11"), false);
+ assert.equal(html.includes("Persona 21"), false);
+});
+
+test("una columna explícita puede establecer un orden inicial descendente", () => {
+ const html = renderToStaticMarkup(
+ item.updated,
+ render: (item) => item.updated,
+ },
+ ]}
+ items={[
+ { id: "old", name: "Ana", updated: "2026-01-01T12:00:00Z" },
+ { id: "new", name: "Zoe", updated: "2026-02-01T12:00:00Z" },
+ ]}
+ title="Actividad"
+ />
+ );
+
+ assert.match(html, /]*aria-sort="descending"[^>]*>[\s\S]*?Actualización/);
+ assert.equal(html.includes('aria-sort="ascending"'), false);
+ assert.ok(html.indexOf(">Zoe<") < html.indexOf(">Ana<"));
+});
+
+test("el orden inicial ignora acciones y columnas sin valor comparable", () => {
+ const html = renderToStaticMarkup(
+ "Imagen" },
+ {
+ id: "actions",
+ label: "Acciones",
+ defaultSort: "desc",
+ value: (item) => item.name,
+ render: () => "Editar",
+ },
+ ...columns,
+ ]}
+ items={items.slice(0, 2).reverse()}
+ title="Personas"
+ />
+ );
+
+ assert.match(html, /]*aria-sort="ascending"[^>]*>[\s\S]*?Nombre/);
+ assert.equal(html.includes('aria-sort="descending"'), false);
+ assert.ok(html.indexOf("Persona 01") < html.indexOf("Persona 02"));
+});
+
+test("las tablas sin columnas ordenables conservan el orden recibido", () => {
+ const html = renderToStaticMarkup(
+ item.name }]}
+ items={[...items].reverse()}
+ title="Personas"
+ />
+ );
+
+ assert.equal(html.includes("aria-sort="), false);
+ assert.ok(html.indexOf("Persona 21") < html.indexOf("Persona 20"));
+});
+
+test("el orden inicial mantiene la estabilidad en empates y se indica con el listado vacío", () => {
+ const tied = renderToStaticMarkup(
+ item.name,
+ render: (item) => item.id,
+ },
+ ]}
+ items={[
+ { id: "second", name: "Igual" },
+ { id: "first", name: "Igual" },
+ ]}
+ title="Personas"
+ />
+ );
+ const empty = renderToStaticMarkup();
+
+ assert.ok(tied.indexOf(">second<") < tied.indexOf(">first<"));
+ assert.ok(empty.includes('aria-sort="ascending"'));
+});
+
test("una búsqueda controlada conserva los resultados filtrados por la pantalla", () => {
const html = renderToStaticMarkup(
({
}) {
const [localSearch, setLocalSearch] = useState("");
const currentSearch = search ?? localSearch;
- const [sorting, setSorting] = useState([]);
+ const sortableColumns = columns.filter((column) => column.id !== "actions" && column.value);
+ const defaultColumn = sortableColumns.find((column) => column.defaultSort) ?? sortableColumns[0];
+ const initialSorting: SortingState = defaultColumn
+ ? [{ id: defaultColumn.id, desc: defaultColumn.defaultSort === "desc" }]
+ : [];
+ const [sorting, setSorting] = useState(initialSorting);
const [visibility, setVisibility] = useState({});
const [pagination, setPagination] = useState(() => ({
pageIndex: 0,
@@ -82,6 +87,8 @@ export function useEntityTable({
const table = useReactTable({
data: [...items],
columns: definitions,
+ initialState: { sorting: initialSorting },
+ enableSortingRemoval: false,
getRowId: (item) => item.id,
state: {
sorting,