@seedgrid/fe-backup 2026.7.0

package/dist/messages.js

@@ -0,0 +1,202 @@
+// Mensagens do módulo backup/export. Promovido de
+// seedgrid-cli/templates/modules/backup/src/modules/backup/messages.ts.hbs —
+// era puro (zero import "@/...", zero handlebars real), mesmo critério do
+// securityMessages do fe-security.
+const en = {
+    "backup.common.module_name": "Exports",
+    "backup.common.loading": "Loading...",
+    "backup.common.actions": "Actions",
+    "backup.common.cancel": "Cancel",
+    "backup.common.confirm": "Confirm",
+    "backup.common.refresh": "Refresh",
+    "backup.common.server_connection_error": "Could not connect to the server",
+    "backup.exports.list.title": "Data Exports",
+    "backup.exports.list.description": "Create and manage tenant data export jobs.",
+    "backup.exports.list.new": "New export",
+    "backup.exports.list.empty": "No export jobs found.",
+    "backup.exports.list.column.job_id": "Job ID",
+    "backup.exports.list.column.format": "Format",
+    "backup.exports.list.column.scope": "Scope",
+    "backup.exports.list.column.status": "Status",
+    "backup.exports.list.column.progress": "Progress",
+    "backup.exports.list.column.created_at": "Created at",
+    "backup.exports.list.column.finished_at": "Finished at",
+    "backup.exports.list.column.size": "Size",
+    "backup.exports.list.action.download": "Download",
+    "backup.exports.list.action.delete": "Delete",
+    "backup.exports.list.action.cancel": "Cancel",
+    "backup.exports.list.load_error": "Could not load export jobs.",
+    "backup.exports.list.delete_title": "Delete export",
+    "backup.exports.list.delete_message": "Delete or cancel the selected export job?",
+    "backup.exports.list.delete_success": "Export job deleted successfully.",
+    "backup.exports.list.delete_error": "Could not delete the export job.",
+    "backup.exports.list.download_error": "Could not download the export file.",
+    "backup.exports.create.title": "New export",
+    "backup.exports.create.description": "Configure and start a new data export job.",
+    "backup.exports.create.format_label": "Export format",
+    "backup.exports.create.scope_label": "Export scope",
+    "backup.exports.create.attachments_label": "Include attachments",
+    "backup.exports.create.format_csv_zip": "CSV (Portability)",
+    "backup.exports.create.format_csv_zip_hint": "CSV files in ZIP. Best for migration, compliance (LGPD/GDPR), and BI tools.",
+    "backup.exports.create.format_sql_dump_zip": "SQL Dump (Technical Restore)",
+    "backup.exports.create.format_sql_dump_zip_hint": "SQL dump in ZIP. Best for disaster recovery and faithful restoration.",
+    "backup.exports.create.scope_domain": "Business data",
+    "backup.exports.create.scope_domain_hint": "Exports business entities only (recommended).",
+    "backup.exports.create.scope_raw": "Raw database tables",
+    "backup.exports.create.scope_raw_hint": "Exports all tables. For advanced users only.",
+    "backup.exports.create.scope_custom": "Custom selection",
+    "backup.exports.create.scope_custom_hint": "Select specific modules to export.",
+    "backup.exports.create.submit": "Start export",
+    "backup.exports.create.success": "Export job created successfully.",
+    "backup.exports.create.error": "Could not create the export job.",
+    "backup.exports.status.REQUESTED": "Requested",
+    "backup.exports.status.QUEUED": "Queued",
+    "backup.exports.status.RUNNING": "Running",
+    "backup.exports.status.DONE": "Ready",
+    "backup.exports.status.DONE_NOTIFIED": "Ready",
+    "backup.exports.status.FAILED": "Failed",
+    "backup.exports.status.EXPIRED": "Expired",
+    "backup.exports.status.CANCELLED": "Cancelled",
+    "backup.exports.format.CSV_ZIP": "CSV / ZIP",
+    "backup.exports.format.SQL_DUMP_ZIP": "SQL Dump / ZIP",
+    "backup.exports.scope.DOMAIN": "Business data",
+    "backup.exports.scope.RAW": "Raw tables",
+    "backup.exports.scope.CUSTOM": "Custom",
+};
+const ptBr = {
+    "backup.common.module_name": "Exportacoes",
+    "backup.common.loading": "Carregando...",
+    "backup.common.actions": "Acoes",
+    "backup.common.cancel": "Cancelar",
+    "backup.common.confirm": "Confirmar",
+    "backup.common.refresh": "Atualizar",
+    "backup.common.server_connection_error": "Erro ao conectar ao servidor",
+    "backup.exports.list.title": "Exportacoes de dados",
+    "backup.exports.list.description": "Crie e gerencie jobs de exportacao de dados do tenant.",
+    "backup.exports.list.new": "Nova exportacao",
+    "backup.exports.list.empty": "Nenhum job de exportacao encontrado.",
+    "backup.exports.list.column.job_id": "ID do job",
+    "backup.exports.list.column.format": "Formato",
+    "backup.exports.list.column.scope": "Escopo",
+    "backup.exports.list.column.status": "Status",
+    "backup.exports.list.column.progress": "Progresso",
+    "backup.exports.list.column.created_at": "Criado em",
+    "backup.exports.list.column.finished_at": "Finalizado em",
+    "backup.exports.list.column.size": "Tamanho",
+    "backup.exports.list.action.download": "Baixar",
+    "backup.exports.list.action.delete": "Excluir",
+    "backup.exports.list.action.cancel": "Cancelar",
+    "backup.exports.list.load_error": "Nao foi possivel carregar os jobs de exportacao.",
+    "backup.exports.list.delete_title": "Excluir exportacao",
+    "backup.exports.list.delete_message": "Excluir ou cancelar o job de exportacao selecionado?",
+    "backup.exports.list.delete_success": "Job de exportacao excluido com sucesso.",
+    "backup.exports.list.delete_error": "Nao foi possivel excluir o job de exportacao.",
+    "backup.exports.list.download_error": "Nao foi possivel baixar o arquivo de exportacao.",
+    "backup.exports.create.title": "Nova exportacao",
+    "backup.exports.create.description": "Configure e inicie um novo job de exportacao de dados.",
+    "backup.exports.create.format_label": "Formato de exportacao",
+    "backup.exports.create.scope_label": "Escopo de exportacao",
+    "backup.exports.create.attachments_label": "Incluir anexos",
+    "backup.exports.create.format_csv_zip": "CSV (Portabilidade)",
+    "backup.exports.create.format_csv_zip_hint": "Arquivos CSV em ZIP. Ideal para migracao, conformidade (LGPD/GDPR) e ferramentas de BI.",
+    "backup.exports.create.format_sql_dump_zip": "SQL Dump (Restauracao tecnica)",
+    "backup.exports.create.format_sql_dump_zip_hint": "Dump SQL em ZIP. Ideal para recuperacao de desastre e restauracao fiel.",
+    "backup.exports.create.scope_domain": "Dados de negocio",
+    "backup.exports.create.scope_domain_hint": "Exporta apenas entidades de negocio (recomendado).",
+    "backup.exports.create.scope_raw": "Tabelas brutas do banco",
+    "backup.exports.create.scope_raw_hint": "Exporta todas as tabelas. Somente para usuarios avancados.",
+    "backup.exports.create.scope_custom": "Selecao personalizada",
+    "backup.exports.create.scope_custom_hint": "Selecione modulos especificos para exportar.",
+    "backup.exports.create.submit": "Iniciar exportacao",
+    "backup.exports.create.success": "Job de exportacao criado com sucesso.",
+    "backup.exports.create.error": "Nao foi possivel criar o job de exportacao.",
+    "backup.exports.status.REQUESTED": "Solicitado",
+    "backup.exports.status.QUEUED": "Na fila",
+    "backup.exports.status.RUNNING": "Em andamento",
+    "backup.exports.status.DONE": "Pronto",
+    "backup.exports.status.DONE_NOTIFIED": "Pronto",
+    "backup.exports.status.FAILED": "Falhou",
+    "backup.exports.status.EXPIRED": "Expirado",
+    "backup.exports.status.CANCELLED": "Cancelado",
+    "backup.exports.format.CSV_ZIP": "CSV / ZIP",
+    "backup.exports.format.SQL_DUMP_ZIP": "SQL Dump / ZIP",
+    "backup.exports.scope.DOMAIN": "Dados de negocio",
+    "backup.exports.scope.RAW": "Tabelas brutas",
+    "backup.exports.scope.CUSTOM": "Personalizado",
+};
+const ptPt = {
+    "backup.exports.list.title": "Exportacoes de dados",
+    "backup.exports.list.new": "Nova exportacao",
+    "backup.exports.list.empty": "Nenhum job de exportacao encontrado.",
+    "backup.exports.list.action.download": "Transferir",
+    "backup.exports.create.submit": "Iniciar exportacao",
+};
+const es = {
+    "backup.common.module_name": "Exportaciones",
+    "backup.common.loading": "Cargando...",
+    "backup.common.actions": "Acciones",
+    "backup.common.cancel": "Cancelar",
+    "backup.common.confirm": "Confirmar",
+    "backup.common.server_connection_error": "Error al conectar con el servidor",
+    "backup.exports.list.title": "Exportaciones de datos",
+    "backup.exports.list.description": "Crea y gestiona jobs de exportacion de datos del tenant.",
+    "backup.exports.list.new": "Nueva exportacion",
+    "backup.exports.list.empty": "No se encontraron jobs de exportacion.",
+    "backup.exports.list.action.download": "Descargar",
+    "backup.exports.list.action.delete": "Eliminar",
+    "backup.exports.list.action.cancel": "Cancelar",
+    "backup.exports.list.delete_title": "Eliminar exportacion",
+    "backup.exports.list.delete_message": "Eliminar o cancelar el job de exportacion seleccionado?",
+    "backup.exports.list.delete_success": "Job de exportacion eliminado correctamente.",
+    "backup.exports.list.delete_error": "No se pudo eliminar el job de exportacion.",
+    "backup.exports.create.title": "Nueva exportacion",
+    "backup.exports.create.submit": "Iniciar exportacion",
+    "backup.exports.create.success": "Job de exportacion creado correctamente.",
+    "backup.exports.create.error": "No se pudo crear el job de exportacion.",
+    "backup.exports.status.REQUESTED": "Solicitado",
+    "backup.exports.status.QUEUED": "En cola",
+    "backup.exports.status.RUNNING": "En progreso",
+    "backup.exports.status.DONE": "Listo",
+    "backup.exports.status.DONE_NOTIFIED": "Listo",
+    "backup.exports.status.FAILED": "Fallido",
+    "backup.exports.status.EXPIRED": "Expirado",
+    "backup.exports.status.CANCELLED": "Cancelado",
+};
+const fr = {
+    "backup.common.module_name": "Exportations",
+    "backup.common.loading": "Chargement...",
+    "backup.common.actions": "Actions",
+    "backup.common.cancel": "Annuler",
+    "backup.common.confirm": "Confirmer",
+    "backup.common.server_connection_error": "Erreur de connexion au serveur",
+    "backup.exports.list.title": "Exportations de donnees",
+    "backup.exports.list.description": "Creez et gerez les jobs d exportation des donnees du tenant.",
+    "backup.exports.list.new": "Nouvelle exportation",
+    "backup.exports.list.empty": "Aucun job d exportation trouve.",
+    "backup.exports.list.action.download": "Telecharger",
+    "backup.exports.list.action.delete": "Supprimer",
+    "backup.exports.list.action.cancel": "Annuler",
+    "backup.exports.list.delete_title": "Supprimer l exportation",
+    "backup.exports.list.delete_message": "Supprimer ou annuler le job d exportation selectionne ?",
+    "backup.exports.list.delete_success": "Job d exportation supprime avec succes.",
+    "backup.exports.list.delete_error": "Impossible de supprimer le job d exportation.",
+    "backup.exports.create.title": "Nouvelle exportation",
+    "backup.exports.create.submit": "Demarrer l exportation",
+    "backup.exports.create.success": "Job d exportation cree avec succes.",
+    "backup.exports.create.error": "Impossible de creer le job d exportation.",
+    "backup.exports.status.REQUESTED": "Demande",
+    "backup.exports.status.QUEUED": "En attente",
+    "backup.exports.status.RUNNING": "En cours",
+    "backup.exports.status.DONE": "Pret",
+    "backup.exports.status.DONE_NOTIFIED": "Pret",
+    "backup.exports.status.FAILED": "Echoue",
+    "backup.exports.status.EXPIRED": "Expire",
+    "backup.exports.status.CANCELLED": "Annule",
+};
+export const backupMessages = {
+    en,
+    es: { ...en, ...es },
+    fr: { ...en, ...fr },
+    "pt-BR": { ...en, ...ptBr },
+    "pt-PT": { ...en, ...ptBr, ...ptPt },
+};

package/dist/module.d.ts

@@ -0,0 +1,3 @@
+import type { SeedGridCliModuleManifest } from "@seedgrid/fe-core";
+export declare const module: SeedGridCliModuleManifest;
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAkBnE,eAAO,MAAM,MAAM,EAAE,yBAMpB,CAAC"}

package/dist/module.js

@@ -0,0 +1,23 @@
+// Reference-adjacent implementation of the manifest read by the SeedGrid CLI
+// (Rust). See seedgrid-cli/docs/adr/0004-module-manifest-contract.md.
+//
+// `messages` is filled in because `backupMessages` was a pure object (zero
+// `@/...` import) in the old CLI template and got promoted to lib as-is —
+// see scaffold/README.md.
+//
+// `navigation` uses the scaffold-local hook via `@/modules/backup` — the
+// wiring is plain string substitution into the app-shell-navigation markers,
+// so a scaffold alias is fine even though `useBackupAppShellSections`
+// hardcodes a scaffold route and calls `@/modules/security`/`@/i18n`. Same
+// mechanism as fe-security's `navigation`. Without it the CLI never wires the
+// backup menu into the app shell.
+//
+// No `provider` here: unlike fe-subdomain-tenancy's `TenantProvider`, this
+// module has no standalone React context to wrap the app with.
+export const module = {
+    id: "backup",
+    requires: ["security"],
+    configKey: "backup",
+    navigation: { import: "useBackupAppShellSections", from: "@/modules/backup" },
+    messages: { import: "backupMessages", from: "@seedgrid/fe-backup" },
+};

package/dist/module.json

@@ -0,0 +1,15 @@
+{
+  "id": "backup",
+  "requires": [
+    "security"
+  ],
+  "configKey": "backup",
+  "navigation": {
+    "import": "useBackupAppShellSections",
+    "from": "@/modules/backup"
+  },
+  "messages": {
+    "import": "backupMessages",
+    "from": "@seedgrid/fe-backup"
+  }
+}

package/dist/paths.d.ts

@@ -0,0 +1,9 @@
+export declare const BackupPaths: {
+    /** POST cria export · GET lista exports. */
+    readonly exports: "/exports";
+    /** GET status · DELETE remove. */
+    readonly byId: (jobId: string) => string;
+    /** GET download (application/zip). */
+    readonly download: (jobId: string) => string;
+};
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,WAAW;IACtB,4CAA4C;;IAE5C,kCAAkC;2BACpB,MAAM;IACpB,sCAAsC;+BACpB,MAAM;CAChB,CAAC"}

package/dist/paths.js

@@ -0,0 +1,11 @@
+// Paths do backup/export (espelho de RestControllerPath.java em seedgrid-quarkus-ext-backup).
+// A extensão monta em /exports; o prefixo final depende de como o app inclui a extensão.
+const seg = (value) => encodeURIComponent(value);
+export const BackupPaths = {
+    /** POST cria export · GET lista exports. */
+    exports: "/exports",
+    /** GET status · DELETE remove. */
+    byId: (jobId) => `/exports/${seg(jobId)}`,
+    /** GET download (application/zip). */
+    download: (jobId) => `/exports/${seg(jobId)}/download`,
+};

package/dist/server/create-backup-server.d.ts

@@ -0,0 +1,19 @@
+import type { SecurityServer } from "@seedgrid/fe-security";
+import type { ExportRequest, ExportResponse } from "../backup";
+export interface BackupServer {
+    /** Cria um export job (POST /exports). */
+    createExport(req: ExportRequest): Promise<ExportResponse>;
+    /** Lista os export jobs (GET /exports). */
+    listExports(): Promise<ExportResponse[]>;
+    /** Status de um job — pra polling até DONE (GET /exports/{jobId}). */
+    getExportStatus(jobId: string): Promise<ExportResponse>;
+    /** Remove um job (DELETE /exports/{jobId}). */
+    deleteExport(jobId: string): Promise<void>;
+    /**
+     * Baixa o zip (GET /exports/{jobId}/download). Devolve o Response CRU — o route
+     * handler do app faz o stream pro browser (apiFetchSecurity faria .json()).
+     */
+    downloadExport(jobId: string): Promise<Response>;
+}
+export declare function createBackupServer(session: SecurityServer): BackupServer;
+//# sourceMappingURL=create-backup-server.d.ts.map

package/dist/server/create-backup-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-backup-server.d.ts","sourceRoot":"","sources":["../../src/server/create-backup-server.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE/D,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1D,2CAA2C;IAC3C,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACzC,sEAAsE;IACtE,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACxD,+CAA+C;IAC/C,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAClD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY,CAkBxE"}

package/dist/server/create-backup-server.js

@@ -0,0 +1,19 @@
+// Helpers server-side de backup, sobre o motor de sessão do fe-security. SERVER-ONLY.
+//
+//   const session = createSecurityServer({ ... });
+//   export const backup = createBackupServer(session);
+import { BackupPaths } from "../paths";
+export function createBackupServer(session) {
+    return {
+        createExport: (req) => session.apiFetchSecurity(BackupPaths.exports, {
+            method: "POST",
+            body: JSON.stringify(req),
+        }),
+        listExports: () => session.apiFetchSecurity(BackupPaths.exports),
+        getExportStatus: (jobId) => session.apiFetchSecurity(BackupPaths.byId(jobId)),
+        deleteExport: (jobId) => session.apiFetchSecurity(BackupPaths.byId(jobId), {
+            method: "DELETE",
+        }),
+        downloadExport: (jobId) => session.fetchWithSession(BackupPaths.download(jobId)),
+    };
+}

package/dist/server/index.d.ts

@@ -0,0 +1,2 @@
+export { createBackupServer, type BackupServer, } from "./create-backup-server";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,GAClB,MAAM,wBAAwB,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,2 @@
+// Barrel SERVER (@seedgrid/fe-backup/server). Roda em action/route.
+export { createBackupServer, } from "./create-backup-server";

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@seedgrid/fe-backup",
+  "version": "2026.7.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SeedGrid/seedgrid-fe-components.git"
+  },
+  "homepage": "https://github.com/SeedGrid/seedgrid-fe-components",
+  "bugs": {
+    "url": "https://github.com/SeedGrid/seedgrid-fe-components/issues"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "default": "./dist/server/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "scaffold"
+  ],
+  "peerDependencies": {
+    "@seedgrid/fe-core": "*",
+    "@seedgrid/fe-security": "*"
+  },
+  "devDependencies": {
+    "@seedgrid/fe-core": "2026.7.1",
+    "@seedgrid/fe-security": "2026.7.2"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "postbuild": "node scripts/emit-module-manifest.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "pnpm run build && node --test tests/module-manifest.test.mjs tests/export-status.test.mjs"
+  }
+}

package/scaffold/README.md

@@ -0,0 +1,69 @@
+# `fe-backup` scaffold
+
+Conteúdo copiado para dentro do app gerado pelo CLI (git do app, editável à
+vontade — ver `seedgrid-cli/docs/adr/0004-module-manifest-contract.md`).
+Extraído de `seedgrid-cli/templates/modules/backup/` (17 arquivos, todos sem
+`{{...}}` real — nenhum ficou `.hbs`).
+
+Mesmo critério lib vs scaffold do `fe-security`/`fe-subdomain-tenancy`:
+import `@/...` real = scaffold; puro ou só-default-trivial = lib.
+
+## Promovido pra `@seedgrid/fe-backup` (lib)
+
+- `messages.ts` (`backupMessages`) — puro, zero import `@/...`.
+- `export-status.ts` (`classifyExportStatus`, `isExportInProgress`,
+  `isExportDownloadable`, `ExportStatusGroup`) — puro, opera só sobre o
+  `ExportStatus` já em `backup.ts`.
+
+## Corrigido: `BackupFormat`/`ArtifactInfo` (lib) estavam errados
+
+Conferido contra o backend real
+(`seedgrid-quarkus-ext-backup/runtime/.../domains/{BackupFormat,ExportScope,ExportStatus}.java`,
+`dtos/ExportResponse.java`):
+
+- `BackupFormat` em `backup.ts` tinha 8 valores fictícios
+  (`CSV`, `CSV_ZIP`, `ETL`, `GDPR`, `LGPD`, `SQL`, `SQL_DUMP_ZIP`, `ZIP`) — o
+  enum real só tem **2**: `CSV_ZIP`, `SQL_DUMP_ZIP`. Corrigido.
+- `ArtifactInfo.id` era `string` — o DTO real (`ExportResponse.ArtifactInfo.id`)
+  é `Long` → `number`. Corrigido.
+- `ExportScope` (`DOMAIN`/`RAW`/`CUSTOM`) e `ExportStatus` (8 valores) já
+  batiam certinho com o backend, não precisaram de ajuste.
+
+Antes dessa correção, o scaffold (extraído dos templates do CLI, que sempre
+usaram só os 2 formatos reais) tinha sua PRÓPRIA cópia local de
+`BackupFormat`/`ArtifactInfo` porque divergia da lib. Depois da correção os
+dois batem, então `scaffold/src/modules/backup/types.ts` virou um simples
+reexport de `@seedgrid/fe-backup` (`ArtifactInfo`, `BackupFormat`,
+`ExportRequest`, `ExportResponse`, `ExportScope`, `ExportStatus`) — nada
+redeclarado.
+
+## Ficou scaffold
+
+- `app/backup/exports/(list)/page.tsx` (+ teste), `app/backup/exports/(create)/new/page.tsx`
+  (+ teste) — telas concretas.
+- `app/api/backup/exports/[jobId]/download/route.ts` — route handler: por
+  natureza sempre scaffold (Next.js exige o arquivo num path físico
+  específico).
+- `modules/backup/config.ts` — `backupConfig.apiBaseUrl`/`routes`/`polling`
+  são acoplados ao app (rotas concretas, polling interval).
+- `modules/backup/services/{backup-api,backup-service}.ts` (+ testes) —
+  `backup-api.ts` usa `backupConfig.apiBaseUrl` (local) e `@/i18n` (1 chave
+  de fallback, mesmo padrão do `security-api.ts` do fe-security); `backup-service.ts`
+  depende de `backup-api.ts`, então segue a mesma cadeia pra scaffold.
+- `modules/backup/components/ExportStatusBadge.tsx` (+ teste) — usa
+  `useI18n()` direto dentro do componente (chama `t(key)` internamente, ao
+  contrário do `StatusBadge` do fe-security que recebe `label` já traduzido
+  via prop). Daria pra decopiar do mesmo jeito, mas não foi feito nesta
+  passada — ver Follow-ups.
+- `modules/backup/useBackupAppShellSections.tsx` (+ teste) — hardcoda rota
+  concreta (`backupConfig.routes.exports`) e usa `usePermission`/`@/i18n`.
+
+## Follow-ups (fora do escopo desta extração)
+
+- `ExportStatusBadge` poderia virar lib trocando `t(key)` interno por um
+  prop `label: string` (mesmo padrão do `StatusBadge` do fe-security) — não
+  fiz por tempo, mas é uma decoupling trivial se algum dia fizer falta.
+- `backup-api.ts`/`backup-service.ts` têm o mesmo tipo de acoplamento que
+  `security-api.ts`/`security-service.ts` do fe-security (`apiBaseUrl` local
+  + 1 chamada de tradução) — mesma ressalva: promover exigiria injeção de
+  config, redesenho deliberado, não mecânico.

package/scaffold/src/app/api/backup/exports/[jobId]/download/route.ts

@@ -0,0 +1,87 @@
+// seedgrid:managed
+
+import { type NextRequest, NextResponse } from "next/server";
+
+import { appEnvironment } from "@/config/environment";
+
+/**
+ * GET /api/backup/exports/[jobId]/download
+ *
+ * Server-side proxy that forwards the download request to the backend
+ * with the user's authorization token from the session cookie.
+ * Returns the ZIP file stream directly to the browser.
+ */
+export async function GET(
+  request: NextRequest,
+  context: { params: Promise<{ jobId: string }> }
+) {
+  const { jobId } = await context.params;
+  const decodedJobId = decodeURIComponent(jobId);
+
+  const authHeader = request.headers.get("authorization");
+  const cookieHeader = request.headers.get("cookie");
+
+  const backendUrl = `${appEnvironment.hosts.apiOrigin}/exports/${encodeURIComponent(decodedJobId)}/download`;
+
+  const headers: HeadersInit = {
+    Accept: "application/zip, application/octet-stream",
+  };
+
+  if (authHeader) {
+    headers["Authorization"] = authHeader;
+  }
+
+  if (cookieHeader) {
+    headers["Cookie"] = cookieHeader;
+  }
+
+  try {
+    const upstream = await fetch(backendUrl, {
+      method: "GET",
+      headers,
+      cache: "no-store",
+    });
+
+    if (!upstream.ok) {
+      if (upstream.status === 404) {
+        return NextResponse.json(
+          { message: "Export not found or not ready" },
+          { status: 404 }
+        );
+      }
+
+      if (upstream.status === 410) {
+        return NextResponse.json(
+          { message: "Export expired or failed" },
+          { status: 410 }
+        );
+      }
+
+      return NextResponse.json(
+        { message: "Failed to download export" },
+        { status: upstream.status }
+      );
+    }
+
+    const contentDisposition =
+      upstream.headers.get("Content-Disposition") ??
+      `attachment; filename="export-${decodedJobId}.zip"`;
+
+    const contentType =
+      upstream.headers.get("Content-Type") ?? "application/zip";
+
+    return new NextResponse(upstream.body, {
+      status: 200,
+      headers: {
+        "Content-Disposition": contentDisposition,
+        "Content-Type": contentType,
+        "Cache-Control": "no-store",
+      },
+    });
+  } catch {
+    return NextResponse.json(
+      { message: "Could not reach the export service" },
+      { status: 502 }
+    );
+  }
+}