rl-core-front 0.3.0 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rl-core-front",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Telas e componentes Next.js do core: login com 2FA, usu\u00e1rios, RBAC, auditoria, logs e listagens com filtro din\u00e2mico",
   "author": "Rodrigo Liberti",
   "license": "MIT",

package/src/_services/api/schema.d.ts

@@ -608,14 +608,14 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/audit/changes": {
+    "/audit/requests": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get: operations["AuditController_changes"];
+        get: operations["AuditController_requests"];
         put?: never;
         post?: never;
         delete?: never;
@@ -624,46 +624,14 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/audit/changes/filter-schema": {
+    "/audit/requests/filter-schema": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get: operations["AuditController_changesFilterSchema"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/audit/errors": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get: operations["AuditController_errors"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/audit/errors/filter-schema": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get: operations["AuditController_errorsFilterSchema"];
+        get: operations["AuditController_requestsFilterSchema"];
         put?: never;
         post?: never;
         delete?: never;
@@ -1122,6 +1090,11 @@ export interface components {
             permissionIds?: string[];
             isActive?: boolean;
         };
+        /**
+         * @description 0 = sucesso, 1 = erro, 2 = abortada
+         * @enum {number}
+         */
+        RequestOutcome: 0 | 1 | 2;
         AuditUserRefResponse: {
             /** Format: uuid */
             id: string;
@@ -1129,58 +1102,43 @@ export interface components {
             /** @example admin@admin.com */
             email: string;
         };
+        /**
+         * @description 0 = validação, 1 = autenticação, 2 = não encontrado, 3 = limite, 4 = banco, 5 = integração, 6 = interno
+         * @enum {number}
+         */
+        ErrorType: 0 | 1 | 2 | 3 | 4 | 5 | 6;
         RequestLogResponse: {
             /** Format: uuid */
             id: string;
-            /** @example GET /api/v1/users */
-            action: string;
-            /** @example User */
-            entity?: string | null;
-            entityId?: string | null;
-            /** @example GET */
+            /**
+             * @description 0 = sucesso, 1 = erro, 2 = abortada
+             * @example 0
+             */
+            outcome: components["schemas"]["RequestOutcome"];
+            /** @example Login */
+            action?: string | null;
+            /** @example POST */
             method?: string | null;
+            /** @example /api/v1/users/9f3c… */
             path?: string | null;
+            /** @example /users/:id */
+            route?: string | null;
             /** @example 200 */
             statusCode?: number | null;
             /** @example 42 */
             durationMs?: number | null;
-            /** @example 10.0.0.1 */
-            ipAddress?: string | null;
-            /** Format: uuid */
-            requestId?: string | null;
-            metadata?: Record<string, never> | null;
             userId?: string | null;
             user?: components["schemas"]["AuditUserRefResponse"] | null;
-            /** Format: date-time */
-            createdAt: string;
-            /** Format: date-time */
-            updatedAt: string;
-            /** Format: date-time */
-            deletedAt?: string | null;
-        };
-        PaginatedRequestLogsResponse: {
-            items: components["schemas"]["RequestLogResponse"][];
-            meta: components["schemas"]["PaginationMetaResponse"];
-        };
-        /** @enum {string} */
-        ErrorType: "VALIDATION" | "AUTH" | "NOT_FOUND" | "RATE_LIMIT" | "DATABASE" | "INTEGRATION" | "INTERNAL";
-        ErrorLogResponse: {
-            /** Format: uuid */
-            id: string;
-            type: components["schemas"]["ErrorType"];
-            /** @example 500 */
-            statusCode?: number | null;
-            message: string;
-            stack?: string | null;
-            /** @example POST */
-            method?: string | null;
-            path?: string | null;
-            /** @example 10.0.0.1 */
-            ipAddress?: string | null;
+            /** @description HMAC do IP — não é reversível ao endereço original */
+            ipHash?: string | null;
+            userAgent?: string | null;
             /** Format: uuid */
             requestId?: string | null;
-            userId?: string | null;
-            user?: components["schemas"]["AuditUserRefResponse"] | null;
+            /** @description 0 = validação, 1 = autenticação, 2 = não encontrado, 3 = limite, 4 = banco, 5 = integração, 6 = interno */
+            errorType?: components["schemas"]["ErrorType"] | null;
+            errorCode?: string | null;
+            errorMessage?: string | null;
+            errorStack?: string | null;
             /** Format: date-time */
             createdAt: string;
             /** Format: date-time */
@@ -1188,12 +1146,12 @@ export interface components {
             /** Format: date-time */
             deletedAt?: string | null;
         };
-        PaginatedErrorLogsResponse: {
-            items: components["schemas"]["ErrorLogResponse"][];
+        PaginatedRequestLogsResponse: {
+            items: components["schemas"]["RequestLogResponse"][];
             meta: components["schemas"]["PaginationMetaResponse"];
         };
-        /** @enum {string} */
-        AuditDataAction: "CREATE" | "UPDATE" | "DELETE";
+        /** @enum {number} */
+        AuditDataAction: 0 | 1 | 2;
         AuditDataChangeResponse: {
             /** Format: uuid */
             id: string;
@@ -1218,8 +1176,8 @@ export interface components {
             items: components["schemas"]["AuditDataChangeResponse"][];
             meta: components["schemas"]["PaginationMetaResponse"];
         };
-        /** @enum {string} */
-        NotificationType: "INFO" | "SUCCESS" | "WARNING" | "ERROR";
+        /** @enum {number} */
+        NotificationType: 0 | 1 | 2 | 3;
         UserNotificationResponse: {
             /** Format: uuid */
             id: string;
@@ -1245,8 +1203,8 @@ export interface components {
             /** @example 3 */
             unread: number;
         };
-        /** @enum {string} */
-        ScopeType: "USER" | "ROLE" | "ALL";
+        /** @enum {number} */
+        ScopeType: 0 | 1 | 2;
         NotificationTargetCommand: {
             type: components["schemas"]["ScopeType"];
             /** @description Id do usuário quando type=USER, nome do papel quando type=ROLE. Ignorado em ALL. */
@@ -2487,7 +2445,7 @@ export interface operations {
             };
         };
     };
-    AuditController_changes: {
+    AuditController_requests: {
         parameters: {
             query?: {
                 page?: number;
@@ -2515,54 +2473,7 @@ export interface operations {
             };
         };
     };
-    AuditController_changesFilterSchema: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["FilterFieldResponse"][];
-                };
-            };
-        };
-    };
-    AuditController_errors: {
-        parameters: {
-            query?: {
-                page?: number;
-                limit?: number;
-                search?: string;
-                /** @description Coluna para ordenar (whitelist por endpoint) */
-                sortBy?: string;
-                sortDir?: "ASC" | "DESC";
-                /** @description JSON, ex.: {"name":{"$SUBSTRING":"ana"}} */
-                filter?: string;
-            };
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["PaginatedErrorLogsResponse"];
-                };
-            };
-        };
-    };
-    AuditController_errorsFilterSchema: {
+    AuditController_requestsFilterSchema: {
         parameters: {
             query?: never;
             header?: never;

package/src/_utils/filter.ts

@@ -1,5 +1,5 @@
 import type { components } from "#core/_services/api/schema";
-import { formatDay, fromIsoDay, toIsoDay } from "#core/_utils/calendar";
+import { fromIsoDay, toIsoDay } from "#core/_utils/calendar";
 
 /**
  * Tipos derivados do `openapi.json` (§5): o catálogo é servido pelo backend,
@@ -63,8 +63,20 @@ export const hasValue = (draft: FilterDraftValue | undefined): boolean => {
   );
 };
 
-export const activeFilterCount = (values: FilterValues): number =>
-  Object.values(values).filter(hasValue).length;
+/**
+ * Quantos filtros o botão "Filtros" anuncia.
+ *
+ * `ignore` são os campos que a barra da listagem controla: eles filtram de
+ * verdade, mas o contador não pode cobrá-los, senão a tela abre marcando 1 num
+ * painel onde não há nada marcado.
+ */
+export const activeFilterCount = (
+  values: FilterValues,
+  ignore: string[] = [],
+): number =>
+  Object.entries(values).filter(
+    ([field, draft]) => hasValue(draft) && !ignore.includes(field),
+  ).length;
 
 /**
  * Ponta de um intervalo de datas em ISO **com o fuso de quem filtrou**.
@@ -280,34 +292,3 @@ const draftFrom = (
     }
   }
 };
-
-/** Resumo de um filtro ativo, para o chip. */
-export const describeValue = (
-  field: FilterField,
-  draft: FilterDraftValue,
-  labels: { from: string; to: string; yes: string; no: string; locale: string },
-): string => {
-  const show = (value: string): string =>
-    field.type === "DATE" || field.type === "DATETIME"
-      ? formatDay(value, labels.locale)
-      : value;
-
-  if (field.type === "BOOLEAN") {
-    return draft.value === "true" ? labels.yes : labels.no;
-  }
-  if (draft.values?.length) {
-    const optionLabel = (value: string): string =>
-      field.options?.find((option) => option.value === value)?.label ?? value;
-    return draft.values.map(optionLabel).join(", ");
-  }
-  if (draft.from && draft.to) {
-    return `${show(draft.from)} – ${show(draft.to)}`;
-  }
-  if (draft.from) {
-    return `${labels.from} ${show(draft.from)}`;
-  }
-  if (draft.to) {
-    return `${labels.to} ${show(draft.to)}`;
-  }
-  return draft.value ?? "";
-};

package/src/components/app-shell.tsx

@@ -46,6 +46,30 @@ interface NavItem {
   perm: string | null;
 }
 
+/**
+ * Item de menu declarado pelo projeto.
+ *
+ * O core não conhece as telas de quem o instala (§14), então elas entram por
+ * aqui em vez de o projeto reescrever o shell.
+ *
+ * ```tsx
+ * <AppShell navItems={[{ label: "nav.tasks", href: "/tarefas", icon: ListTodo }]}>
+ * ```
+ */
+export interface AppNavItem {
+  /**
+   * Chave de i18n (`nav.tasks`) ou o texto pronto (`"Tarefas"`).
+   *
+   * Chave sem tradução cadastrada volta como veio, então as duas formas
+   * funcionam — o projeto só precisa do dicionário quando for bilíngue.
+   */
+  label: string;
+  href: string;
+  icon: React.ComponentType<{ className?: string }>;
+  /** Permissão exigida para o item aparecer. Ausente, aparece para todos. */
+  permission?: string | null;
+}
+
 const DASHBOARD: NavItem = {
   key: "nav.dashboard",
   href: "/dashboard",
@@ -71,7 +95,13 @@ const ADMIN_CHILDREN: NavItem[] = [
   },
 ];
 
-export function AppShell({ children }: { children: React.ReactNode }): JSX.Element {
+export interface AppShellProps {
+  children: React.ReactNode;
+  /** Telas do projeto no menu, entre o dashboard e o grupo de administração. */
+  navItems?: AppNavItem[];
+}
+
+export function AppShell({ children, navItems }: AppShellProps): JSX.Element {
   const { user, loading, logout, hasPermission } = useAuth();
   const { t } = useI18n();
   const brand = useBrand();
@@ -89,6 +119,22 @@ export function AppShell({ children }: { children: React.ReactNode }): JSX.Eleme
     // eslint-disable-next-line react-hooks/exhaustive-deps
     [user],
   );
+
+  // Os itens do projeto passam pelo mesmo filtro de permissão dos do core: um
+  // menu que mostra o que o usuário não pode abrir só entrega 403.
+  const projectItems = useMemo<NavItem[]>(
+    () =>
+      (navItems ?? [])
+        .filter((item) => !item.permission || hasPermission(item.permission))
+        .map((item) => ({
+          key: item.label,
+          href: item.href,
+          icon: item.icon,
+          perm: item.permission ?? null,
+        })),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [user, navItems],
+  );
   const adminActive = adminChildren.some((c) => pathname === c.href);
   const [adminOpen, setAdminOpen] = useState(adminActive);
 
@@ -158,6 +204,10 @@ export function AppShell({ children }: { children: React.ReactNode }): JSX.Eleme
     <div className="flex flex-1 flex-col gap-1 overflow-y-auto overflow-x-hidden p-3">
       <NavLink item={DASHBOARD} mini={mini} />
 
+      {projectItems.map((item) => (
+        <NavLink key={item.href} item={item} mini={mini} />
+      ))}
+
       {adminChildren.length > 0 &&
         (mini ? (
           <>

package/src/components/brand-header.tsx

@@ -7,6 +7,12 @@ import { useBrand } from "#core/contexts";
 export interface BrandHeaderProps {
   /** Título do passo ou da tela, exibido sob a marca. */
   title: string;
+  /**
+   * Mostra logo e nome acima do título. Desligue quando a marca já estiver na
+   * tela por outro caminho — é o caso do `BrandPanel` ao lado do formulário,
+   * onde repeti-la no cartão seria dizer a mesma coisa duas vezes.
+   */
+  showBrand?: boolean;
 }
 
 /**
@@ -17,19 +23,28 @@ export interface BrandHeaderProps {
  * ela está. O conteúdo vem do `BrandProvider` do projeto; sem ele, do padrão do
  * core.
  */
-export function BrandHeader({ title }: BrandHeaderProps): JSX.Element {
+export function BrandHeader({
+  title,
+  showBrand = true,
+}: BrandHeaderProps): JSX.Element {
   const brand = useBrand();
 
   return (
     <div className="mb-6 flex flex-col items-center gap-1">
-      <div className="mb-2 flex h-12 w-12 items-center justify-center rounded-full bg-primary/10">
-        {brand.logo}
-      </div>
-      <span className="text-lg font-extrabold">{brand.name}</span>
-      {brand.tagline && (
-        <p className="text-sm text-muted-foreground">{brand.tagline}</p>
+      {showBrand && (
+        <>
+          <div className="mb-2 flex h-12 w-12 items-center justify-center rounded-full bg-primary/10">
+            {brand.logo}
+          </div>
+          <span className="text-lg font-extrabold">{brand.name}</span>
+          {brand.tagline && (
+            <p className="text-sm text-muted-foreground">{brand.tagline}</p>
+          )}
+        </>
       )}
-      <h1 className="mt-2 text-xl font-semibold">{title}</h1>
+      <h1 className={showBrand ? "mt-2 text-xl font-semibold" : "text-xl font-semibold"}>
+        {title}
+      </h1>
     </div>
   );
 }

package/src/components/brand-panel.tsx

@@ -0,0 +1,41 @@
+"use client";
+
+import type { JSX } from "react";
+
+import { useBrand } from "#core/contexts";
+import { cn } from "#core/lib/utils";
+
+export interface BrandPanelProps {
+  className?: string;
+}
+
+/**
+ * A marca ocupando metade da tela de login, ao lado do formulário.
+ *
+ * É o irmão grande do `BrandHeader`: mesma fonte (o `BrandProvider` do
+ * projeto), espaço diferente. Serve a quem tem logo grande — no cabeçalho do
+ * cartão ela sairia espremida.
+ *
+ * O core não dimensiona a logo: ela é um `ReactNode` do projeto, que sabe se é
+ * um SVG, um `next/image` ou um ícone. Aqui ela só ganha o espaço.
+ */
+export function BrandPanel({ className }: BrandPanelProps): JSX.Element {
+  const brand = useBrand();
+
+  return (
+    <div
+      className={cn(
+        "flex flex-1 flex-col items-center justify-center gap-4 bg-muted/30 p-8 text-center",
+        className,
+      )}
+    >
+      {brand.logo}
+      <span className="text-3xl font-extrabold">{brand.name}</span>
+      {brand.tagline && (
+        <p className="max-w-sm text-sm text-muted-foreground">
+          {brand.tagline}
+        </p>
+      )}
+    </div>
+  );
+}

package/src/components/index.ts

@@ -1,6 +1,7 @@
 // Barrel da pasta — importe daqui de fora; dentro da pasta use o caminho direto.
 export * from "./app-shell";
 export * from "./brand-header";
+export * from "./brand-panel";
 export * from "./breadcrumbs";
 export * from "./language-selector";
 export * from "./password-field";

package/src/components/ui/button.tsx

@@ -52,6 +52,11 @@ const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
       <Comp
         className={cn(buttonVariants({ variant, size, className }))}
         ref={ref}
+        // `<button>` sem `type` nasce `submit`: dentro de um form, um botão que
+        // só abre um modal acabava salvando o registro junto. Quem submete
+        // declara `type="submit"` — o spread abaixo deixa isso sobrescrever.
+        // Com `asChild` o filho pode não ser um `<button>`, então não força.
+        {...(asChild ? {} : { type: "button" as const })}
         {...props}
       />
     );

package/src/components/ui/confirm-dialog.tsx

@@ -43,7 +43,9 @@ export function ConfirmDialog({
 }: ConfirmDialogProps): React.JSX.Element {
   return (
     <Dialog open={open} onOpenChange={(o) => !o && onCancel()}>
-      <DialogContent className="max-w-sm">
+      {/* Sem ampliar: são duas linhas e dois botões, e o tamanho pequeno é
+          parte do recado — esticado só ganharia vazio. */}
+      <DialogContent className="max-w-sm" expandable={false}>
         <DialogHeader>
           <DialogTitle>{title}</DialogTitle>
           {description && <DialogDescription>{description}</DialogDescription>}

package/src/components/ui/data-table.tsx

@@ -39,7 +39,6 @@ import {
   ColumnVisibilityModal,
   ColumnVisibilityOption,
 } from "#core/components/ui/column-visibility-modal";
-import { FilterChips } from "#core/components/ui/filter-chips";
 import { FilterSheet } from "#core/components/ui/filter-sheet";
 import { Spinner } from "#core/components/ui/spinner";
 import {
@@ -94,6 +93,16 @@ interface DataTableProps<T extends RowData> {
    * não aparece — listagem sem catálogo continua funcionando igual.
    */
   filters?: FiltersState;
+  /**
+   * Campos que a `toolbar` já controla: somem do painel de filtros e não são
+   * contados no botão "Filtros", para a mesma escolha não existir em dois
+   * lugares.
+   *
+   * Some da interface, não do catálogo — é o catálogo que serializa o filtro,
+   * então o atalho da barra continua funcionando normalmente. O painel também
+   * não os desmarca ao aplicar nem ao limpar: não são dele.
+   */
+  hiddenFilterFields?: string[];
 }
 
 /** Extras que uma coluna pode declarar em `meta`. */
@@ -144,6 +153,7 @@ export function DataTable<T extends RowData>({
   onSortingChange,
   enableSorting = true,
   filters,
+  hiddenFilterFields,
 }: DataTableProps<T>): JSX.Element {
   const { t } = useI18n();
   const [colsOpen, setColsOpen] = useState(false);
@@ -220,7 +230,7 @@ export function DataTable<T extends RowData>({
       ? filters.tree && filters.filter
         ? countConditions(filters.tree)
         : 0
-      : activeFilterCount(filters.values);
+      : activeFilterCount(filters.values, hiddenFilterFields);
 
   return (
     <div>
@@ -257,8 +267,6 @@ export function DataTable<T extends RowData>({
         </div>
       </div>
 
-      {filters && <FilterChips filters={filters} />}
-
       <Card>
         <Table>
           <TableHeader>
@@ -394,6 +402,7 @@ export function DataTable<T extends RowData>({
           open={filtersOpen}
           onOpenChange={setFiltersOpen}
           filters={filters}
+          hiddenFields={hiddenFilterFields}
         />
       )}
     </div>