@nocobase/app-template-default 1.0.0-beta.89 → 1.0.0-beta.90

package/client/pages/settings/database-explorer/index.tsx

@@ -0,0 +1,358 @@
+import { ApiClientError, useApiClient } from '@nocobase/app-client';
+import { DatabaseExplorerClient } from '@nocobase/app-plugin-database-explorer/client';
+import { useTranslation } from '@nocobase/i18n/client';
+import {
+  useCallback,
+  useEffect,
+  useMemo,
+  useState,
+  type ReactNode,
+} from 'react';
+import { Link, useSearchParams } from 'react-router';
+import { PageContainer } from '#components/page-container';
+import { PageHeader } from '#components/page-header';
+import { Button } from '#components/ui/button';
+import { Input } from '#components/ui/input';
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from '#components/ui/select';
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from '#components/ui/table';
+
+/** A keyed read boundary prevents a late response from replacing a newer selection. */
+function Read<T>({
+  load,
+  children,
+}: {
+  load: () => Promise<T>;
+  children: (data: T) => ReactNode;
+}) {
+  const { t } = useTranslation();
+  const [attempt, setAttempt] = useState(0);
+  const [result, setResult] = useState<{ data: T } | { error: unknown }>();
+  useEffect(() => {
+    let active = true;
+    load().then(
+      (data) => {
+        if (active) setResult({ data });
+      },
+      (error: unknown) => {
+        if (active) setResult({ error });
+      },
+    );
+    return () => {
+      active = false;
+    };
+  }, [load, attempt]);
+  if (!result)
+    return (
+      <p role='status' className='p-4 text-sm text-muted-foreground'>
+        {t('databaseExplorer.loading')}
+      </p>
+    );
+  if ('error' in result) {
+    const status =
+      result.error instanceof ApiClientError ? result.error.status : undefined;
+    const key =
+      status === 401 ? 'expired' : status === 403 ? 'forbidden' : 'failed';
+    return (
+      <div role='alert' className='space-y-3 p-4'>
+        <p>{t(`databaseExplorer.${key}`)}</p>
+        {status === 401 ? (
+          <Link to='/login'>{t('databaseExplorer.signIn')}</Link>
+        ) : status !== 403 ? (
+          <Button
+            variant='outline'
+            onClick={() => {
+              setResult(undefined);
+              setAttempt((value) => value + 1);
+            }}
+          >
+            {t('databaseExplorer.retry')}
+          </Button>
+        ) : null}
+      </div>
+    );
+  }
+  return children(result.data);
+}
+
+export default function DatabaseExplorerPage() {
+  const { t } = useTranslation();
+  const api = useApiClient();
+  const client = useMemo(() => new DatabaseExplorerClient(api), [api]);
+  const load = useCallback(() => client.connections(), [client]);
+  const [params, setParams] = useSearchParams();
+  return (
+    <PageContainer className='space-y-6'>
+      <PageHeader
+        title={t('databaseExplorer.title')}
+        description={t('databaseExplorer.description')}
+      />
+      <Read load={load}>
+        {({ items, default: defaultConnection }) => {
+          if (!items.length)
+            return <p>{t('databaseExplorer.emptyConnections')}</p>;
+          const connection =
+            params.get('connection') ?? defaultConnection ?? items[0].name;
+          return (
+            <div className='space-y-6'>
+              <div className='max-w-sm space-y-2'>
+                <label
+                  htmlFor='database-connection'
+                  className='text-sm font-medium'
+                >
+                  {t('databaseExplorer.connections')}
+                </label>
+                <Select
+                  value={connection}
+                  onValueChange={(value) => {
+                    if (value) setParams({ connection: value });
+                  }}
+                >
+                  <SelectTrigger id='database-connection' className='w-full'>
+                    <SelectValue />
+                  </SelectTrigger>
+                  <SelectContent>
+                    {items.map((item) => (
+                      <SelectItem key={item.name} value={item.name}>
+                        {item.name} · {item.dialect}
+                        {item.isDefault
+                          ? ` · ${t('databaseExplorer.defaultConnection')}`
+                          : ''}
+                      </SelectItem>
+                    ))}
+                  </SelectContent>
+                </Select>
+              </div>
+              <ConnectionTables
+                key={connection}
+                client={client}
+                connection={connection}
+              />
+            </div>
+          );
+        }}
+      </Read>
+    </PageContainer>
+  );
+}
+
+function ConnectionTables({
+  client,
+  connection,
+}: {
+  client: DatabaseExplorerClient;
+  connection: string;
+}) {
+  const { t } = useTranslation();
+  const [params, setParams] = useSearchParams();
+  const selected = params.get('table');
+  const query = params.get('q') ?? '';
+  const load = useCallback(
+    () => client.allCollections(connection),
+    [client, connection],
+  );
+  return (
+    <div className='grid min-w-0 gap-6 lg:grid-cols-[minmax(14rem,1fr)_minmax(0,3fr)]'>
+      <section
+        aria-label={t('databaseExplorer.tables')}
+        className='min-w-0 space-y-3'
+      >
+        <h2 className='font-heading text-base font-semibold'>
+          {t('databaseExplorer.tables')}
+        </h2>
+        <Input
+          aria-label={t('databaseExplorer.searchTables')}
+          placeholder={t('databaseExplorer.searchTables')}
+          value={query}
+          onChange={(event) => {
+            setParams(
+              (previous) => {
+                const next = new URLSearchParams(previous);
+                next.set('q', event.target.value);
+                return next;
+              },
+              { replace: true },
+            );
+          }}
+        />
+        <Read load={load}>
+          {({ items, truncated }) => {
+            const matches = items.filter((item) =>
+              `${item.name} ${item.tableName} ${item.title ?? ''}`
+                .toLocaleLowerCase()
+                .includes(query.toLocaleLowerCase()),
+            );
+            return (
+              <>
+                {truncated ? (
+                  <p role='status' className='text-sm text-muted-foreground'>
+                    {t('databaseExplorer.truncated')}
+                  </p>
+                ) : null}
+                {matches.length ? (
+                  <ul className='max-h-96 space-y-1 overflow-auto rounded-lg border p-2'>
+                    {matches.map((item) => (
+                      <li key={item.name}>
+                        <Button
+                          variant={
+                            selected === item.name ? 'secondary' : 'ghost'
+                          }
+                          className='h-auto w-full justify-start whitespace-normal break-all text-left'
+                          aria-pressed={selected === item.name}
+                          onClick={() => {
+                            setParams((previous) => {
+                              const next = new URLSearchParams(previous);
+                              next.set('connection', connection);
+                              next.set('table', item.name);
+                              return next;
+                            });
+                          }}
+                        >
+                          {item.title
+                            ? `${item.title} (${item.name})`
+                            : item.name}
+                        </Button>
+                      </li>
+                    ))}
+                  </ul>
+                ) : (
+                  <p className='text-sm text-muted-foreground'>
+                    {t('databaseExplorer.emptyTables')}
+                  </p>
+                )}
+              </>
+            );
+          }}
+        </Read>
+      </section>
+      <section
+        aria-label={t('databaseExplorer.fields')}
+        className='min-w-0 space-y-3'
+      >
+        {selected ? (
+          <CollectionFields
+            key={selected}
+            client={client}
+            connection={connection}
+            collection={selected}
+          />
+        ) : (
+          <p className='rounded-lg border border-dashed p-6 text-sm text-muted-foreground'>
+            {t('databaseExplorer.selectTable')}
+          </p>
+        )}
+      </section>
+    </div>
+  );
+}
+
+function CollectionFields({
+  client,
+  connection,
+  collection,
+}: {
+  client: DatabaseExplorerClient;
+  connection: string;
+  collection: string;
+}) {
+  const { t } = useTranslation();
+  const [query, setQuery] = useState('');
+  const load = useCallback(
+    () => client.collection(connection, collection),
+    [client, connection, collection],
+  );
+  return (
+    <>
+      <h2 className='break-all font-heading text-base font-semibold'>
+        {collection}
+      </h2>
+      <Input
+        aria-label={t('databaseExplorer.searchFields')}
+        placeholder={t('databaseExplorer.searchFields')}
+        value={query}
+        onChange={(event) => setQuery(event.target.value)}
+      />
+      <Read load={load}>
+        {({ collection: artifact }) => {
+          const fields = (artifact.collection.fields ?? []).filter((field) =>
+            `${field.name} ${field.title ?? ''}`
+              .toLocaleLowerCase()
+              .includes(query.toLocaleLowerCase()),
+          );
+          return (
+            <>
+              {artifact.warnings.length ? (
+                <p role='status' className='text-sm text-muted-foreground'>
+                  {t('databaseExplorer.warnings')}
+                </p>
+              ) : null}
+              {fields.length ? (
+                <div className='overflow-hidden rounded-lg border'>
+                  <Table>
+                    <TableHeader>
+                      <TableRow>
+                        {[
+                          'name',
+                          'type',
+                          'nullable',
+                          'primaryKey',
+                          'target',
+                        ].map((key) => (
+                          <TableHead key={key}>
+                            {t(`databaseExplorer.${key}`)}
+                          </TableHead>
+                        ))}
+                      </TableRow>
+                    </TableHeader>
+                    <TableBody>
+                      {fields.map((field) => (
+                        <TableRow key={field.name}>
+                          <TableCell className='font-medium'>
+                            {field.name}
+                            {field.title ? (
+                              <span className='block text-muted-foreground'>
+                                {field.title}
+                              </span>
+                            ) : null}
+                          </TableCell>
+                          <TableCell>{field.type}</TableCell>
+                          <TableCell>
+                            {t(
+                              `databaseExplorer.${field.nullable === undefined ? 'unknown' : field.nullable ? 'yes' : 'no'}`,
+                            )}
+                          </TableCell>
+                          <TableCell>
+                            {t(
+                              `databaseExplorer.${field.primaryKey ? 'yes' : 'no'}`,
+                            )}
+                          </TableCell>
+                          <TableCell>{field.target ?? '—'}</TableCell>
+                        </TableRow>
+                      ))}
+                    </TableBody>
+                  </Table>
+                </div>
+              ) : (
+                <p className='text-sm text-muted-foreground'>
+                  {t('databaseExplorer.emptyFields')}
+                </p>
+              )}
+            </>
+          );
+        }}
+      </Read>
+    </>
+  );
+}

package/client/pages/settings/database-explorer/routes.ts

@@ -0,0 +1,14 @@
+import { defineAppRoutes } from '@nocobase/app-client/plugins';
+import { DATABASE_EXPLORER_ACCESS } from '@nocobase/app-plugin-database-explorer/client';
+
+export default defineAppRoutes([
+  {
+    parent: 'settingsSystem',
+    name: 'databaseExplorer',
+    path: '/database-explorer',
+    auth: 'required',
+    authz: DATABASE_EXPLORER_ACCESS,
+    breadcrumb: { title: 'databaseExplorer.title' },
+    componentLoader: () => import('./index.js'),
+  },
+]);

package/client/pages/settings/database-explorer/zh-CN.ts

@@ -0,0 +1,30 @@
+export default {
+  title: '数据库浏览器',
+  description: '查看应用的数据库连接、数据表和字段。',
+  connections: '数据库连接',
+  defaultConnection: '默认',
+  tables: '数据表',
+  searchTables: '搜索数据表',
+  fields: '字段',
+  searchFields: '搜索字段',
+  name: '名称',
+  type: '类型',
+  nullable: '允许为空',
+  primaryKey: '主键',
+  target: '关联表',
+  yes: '是',
+  no: '否',
+  unknown: '未指定',
+  emptyConnections: '尚未配置数据库连接。',
+  emptyTables: '没有找到数据表。',
+  emptyFields: '没有找到字段。',
+  selectTable: '选择数据表以查看字段。',
+  loading: '正在加载…',
+  failed: '无法加载数据库信息。',
+  forbidden: '你没有浏览此数据库的权限。',
+  expired: '登录已过期，请重新登录后继续。',
+  signIn: '登录',
+  retry: '重试',
+  truncated: '当前仅加载了部分数据表，请缩小数据库范围后查看其余数据表。',
+  warnings: '部分字段未能完整解析，显示的结构可能不完整。',
+};

package/client/plugins.ts

@@ -1,4 +1,5 @@
 import foundation from '@nocobase/app-plugin-foundation/client';
+import applicationManifest from '../package.json' with { type: 'json' };
 import defaultAccess from '@nocobase/app-plugin-authz-default-access/client';
 import sharingRules from '@nocobase/app-plugin-authz-sharing-rules/client';
 import restrictionRules from '@nocobase/app-plugin-authz-restriction-rules/client';
@@ -35,7 +36,13 @@ const clientPlugins: AppClientPlugins = defineClientPlugins([
   file(),
   scheduler(),
   mail(),
-  foundation({ settingsGroup: true }),
+  // The manifest is what the capability guide lists: every plugin this application declares.
+  foundation({
+    settingsGroup: true,
+    manifest: applicationManifest,
+    guideSettingsPath: '/settings',
+    navigation: false,
+  }),
 ]);
 
 export default clientPlugins;

package/client/routes.ts

@@ -1,3 +1,4 @@
+import databaseExplorerRoutes from './pages/settings/database-explorer/routes.js';
 import { createAppClientConfig } from '@nocobase/app-client';
 import { readAppClientRuntimeConfig } from '@nocobase/app-client/runtime';
 import { includeNotificationTemplateRoutes } from './pages/settings/notification-routes.js';
@@ -75,7 +76,7 @@ export function createApplicationRoutes(
 ): readonly AppClientRouteContribution[] {
   const config = createAppClientConfig({ rawConfig });
   return includeNotificationTemplateRoutes(
-    [appRoutes, settingsShellRoutes],
+    [appRoutes, settingsShellRoutes, databaseExplorerRoutes],
     config.get<boolean>('notificationTemplates.invitationConfigured') === true,
   );
 }

package/config.example.yml

@@ -22,13 +22,19 @@
 #     max: 600
 #     window: 1m
 
-# Realtime events are transient and local to this process. Clients refetch after subscription acknowledgement.
+# Realtime defaults to inMemory when broker is omitted. An explicit broker requires adapter.
+# For local-only selection: realtime: { broker: { adapter: inMemory } }.
+# For multiple processes, install @nocobase/app-plugin-realtime-redis and register its
+# @nocobase/app-plugin-realtime-redis/server definition in server/plugins.ts on every instance.
+# Realtime events are transient; clients refetch after subscription acknowledgement.
 # realtime:
-#   adapter: inMemory # Use redis for multiple application processes.
-#   redis:
+#   broker:
+#     adapter: redis
+#     setupTimeoutMs: 5000
 #     connection:
 #       host: 127.0.0.1
 #       port: 6379
+#       commandTimeout: 5000
 #   namespace: my-app # Defaults to the application name; keep applications isolated.
 #   authorizationTimeoutMs: 5000
 #   sessionCheckIntervalMs: 30000
@@ -116,8 +122,7 @@ auth:
   # Set app.publicOrigin before explicitly enabling automatic password recovery.
   # passwordReset:
   #   enabled: true
-  # email:
-  #   mailer: system # omit to use mailers.default
+  #   mailer: system # omit to preserve existing default selection
   # Existing inline auth.email and AUTH_EMAIL_* remain supported for compatibility.
   emailAndPassword:
     enabled: true
@@ -190,12 +195,13 @@ snowflake:
 # Upgrading deployments must set adapter: redis explicitly; templates no longer supply Redis defaults.
 # jobs:
 #   default: redis
-#   redis:
-#     adapter: redis
-#     connection:
-#       host: 127.0.0.1
-#       port: 6379
-#     # namespace: my-app # defaults to the application name; set it when deployments share one Redis
+#   backends:
+#     redis:
+#       adapter: redis
+#       connection:
+#         host: 127.0.0.1
+#         port: 6379
+#       # namespace: my-app # defaults to the application name; set it when deployments share one Redis
 
 # The jobs configuration the Scheduler plugin's schedules run on, by name. Left out, they follow jobs.default.
 # scheduler:

package/index.html

@@ -32,9 +32,6 @@
         transform-origin: 32px 32px;
         animation: app-bootstrap-spin 1.1s linear infinite;
       }
-      .app-bootstrap-loading span {
-        color: oklch(0.556 0 0);
-      }
 
       html,
       body {
@@ -60,11 +57,6 @@
         }
       }
 
-      @media (prefers-color-scheme: dark) {
-        .app-bootstrap-loading span {
-          color: oklch(0.708 0 0);
-        }
-      }
       @media (prefers-reduced-motion: reduce) {
         .app-bootstrap-loading .nocobase-loading-orbit {
           animation: none;
@@ -76,10 +68,16 @@
   <body>
     <noscript>You need to enable JavaScript to run this app.</noscript>
     <div id="root">
+      <!--
+        The language is unknown until the client starts, so this placeholder shows no text. A screen reader still
+        perceives it as an indeterminate progress bar, a role it announces in its own language, named after the
+        brand in <title>, which reads the same in every language. The client's localized loading, a polite status,
+        replaces it once the language is ready, so nothing is announced twice.
+      -->
       <div
         class="app-bootstrap-loading"
-        role="status"
-        aria-label="Loading application"
+        role="progressbar"
+        aria-label="NocoBase"
       >
         <svg
           data-slot="loading-indicator"
@@ -114,7 +112,6 @@
             </g>
           </g>
         </svg>
-        <span>Loading application…</span>
       </div>
     </div>
     <script type="module" src="/client/index.tsx"></script>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nocobase/app-template-default",
   "displayName": "Default Template",
-  "version": "1.0.0-beta.89",
+  "version": "1.0.0-beta.90",
   "type": "module",
   "prettier": "@nocobase/dev-config/prettier",
   "engines": {
@@ -9,7 +9,7 @@
   },
   "nocobase": {
     "templateKind": "app",
-    "defaultTemplateVersion": "1.0.0-beta.89"
+    "defaultTemplateVersion": "1.0.0-beta.90"
   },
   "devDependencies": {
     "@ai-sdk/react": "4.0.131",
@@ -76,7 +76,7 @@
     "@noble/hashes": "2.3.0",
     "@nocobase/app-client": "^4.0.0-beta.9",
     "@nocobase/app-plugin-template-print": "0.0.2-beta.2",
-    "@nocobase/app-skills": "0.1.0-beta.60",
+    "@nocobase/app-skills": "0.1.0-beta.61",
     "@nocobase/app-testing": "0.1.0-beta.8",
     "@nocobase/app-websocket": "^0.1.0-beta.1",
     "@nocobase/dev-config": "0.1.0-beta.25",
@@ -143,40 +143,40 @@
     "better-auth": "1.7.5",
     "hono": "^4.13.2",
     "@nocobase/concurrency": "^0.1.0-beta.1",
-    "@nocobase/app-plugin-concurrency": "^0.1.0-beta.2",
-    "@nocobase/app-plugin-agents": "^2.0.0-beta.6",
+    "@nocobase/app-plugin-concurrency": "^0.1.0-beta.3",
+    "@nocobase/app-plugin-agents": "^2.0.0-beta.7",
     "@nocobase/app-plugin-api-keys": "^1.0.0-beta.21",
-    "@nocobase/app-plugin-authentication": "^2.0.0-beta.19",
-    "@nocobase/app-plugin-authorization": "^1.0.0-beta.36",
+    "@nocobase/app-plugin-authentication": "^2.0.0-beta.20",
+    "@nocobase/app-plugin-authorization": "^1.0.0-beta.37",
     "@nocobase/app-plugin-database-explorer": "^1.0.0-beta.19",
-    "@nocobase/app-plugin-file": "^1.0.0-beta.29",
-    "@nocobase/app-plugin-foundation": "^0.1.0-beta.16",
-    "@nocobase/app-plugin-i18n": "^1.0.0-beta.21",
-    "@nocobase/app-plugin-knowledge": "^0.1.0-beta.17",
-    "@nocobase/app-plugin-mail": "^1.0.0-beta.21",
-    "@nocobase/app-plugin-notification": "^2.0.0-beta.5",
-    "@nocobase/app-plugin-notification-in-app": "^2.0.0-beta.2",
-    "@nocobase/app-plugin-notification-providers": "^1.0.0-beta.18",
-    "@nocobase/app-plugin-scheduler": "^1.0.0-beta.23",
-    "@nocobase/app-plugin-users": "^2.0.0-beta.16",
-    "@nocobase/app-server": "^5.0.0-beta.1",
+    "@nocobase/app-plugin-file": "^1.0.0-beta.30",
+    "@nocobase/app-plugin-foundation": "^0.1.0-beta.17",
+    "@nocobase/app-plugin-i18n": "^1.0.0-beta.22",
+    "@nocobase/app-plugin-knowledge": "^0.1.0-beta.18",
+    "@nocobase/app-plugin-mail": "^1.0.0-beta.22",
+    "@nocobase/app-plugin-notification": "^2.0.0-beta.6",
+    "@nocobase/app-plugin-notification-in-app": "^2.0.0-beta.3",
+    "@nocobase/app-plugin-notification-providers": "^1.0.0-beta.19",
+    "@nocobase/app-plugin-scheduler": "^1.0.0-beta.24",
+    "@nocobase/app-plugin-users": "^2.0.0-beta.17",
+    "@nocobase/app-server": "^5.0.0-beta.2",
     "@nocobase/config": "^0.1.0-beta.3",
-    "@nocobase/db": "^1.0.0-beta.25",
+    "@nocobase/db": "^1.0.0-beta.26",
     "@nocobase/db-sqlite": "^0.1.0-beta.6",
     "@nocobase/service-provider": "^0.0.2-beta.2",
     "@nocobase/snowflake": "^1.0.0-beta.4",
-    "@nocobase/app-plugin-authz-default-access": "^1.0.0-beta.19",
-    "@nocobase/app-plugin-authz-sharing-rules": "^1.0.0-beta.18",
-    "@nocobase/app-plugin-authz-restriction-rules": "^1.0.0-beta.17",
+    "@nocobase/app-plugin-authz-default-access": "^1.0.0-beta.20",
+    "@nocobase/app-plugin-authz-sharing-rules": "^1.0.0-beta.19",
+    "@nocobase/app-plugin-authz-restriction-rules": "^1.0.0-beta.18",
     "@nocobase/authorization": "^1.0.0-beta.16",
-    "@nocobase/queue": "^1.0.0-beta.10",
-    "@nocobase/jobs": "^1.0.0-beta.5",
+    "@nocobase/queue": "^1.0.0-beta.11",
+    "@nocobase/jobs": "^1.0.0-beta.6",
     "@nocobase/lifecycle": "^0.1.0-beta.4",
-    "@nocobase/i18n": "^2.0.0-beta.1",
+    "@nocobase/i18n": "^2.0.0-beta.2",
     "@nocobase/caching": "^1.0.0-beta.4",
     "@nocobase/repository-input": "^0.1.0-beta.3",
     "@nocobase/app-cli": "^1.0.0-beta.32",
-    "@nocobase/realtime": "^1.0.0-beta.1"
+    "@nocobase/realtime": "^1.0.0-beta.2"
   },
   "description": "NocoBase 3 application template with the standard product capabilities.",
   "imports": {

package/server/config/auth.ts

@@ -12,7 +12,7 @@ import { bearer, deviceAuthorization, username } from 'better-auth/plugins';
  */
 const CLI_CLIENT_IDS: readonly string[] = ['nocobase-cli'];
 
-// Use mailers for shared sending; defineAuthConfig retains AUTH_EMAIL_* for legacy inline senders.
+// Select a named sender with passwordReset.mailer; defineAuthConfig retains AUTH_EMAIL_* for legacy inline senders.
 // Automatic recovery requires passwordReset.enabled: true; leave the switch absent for custom callback compatibility.
 const auth: AppConfigFactory<AuthConfig> = defineAuthConfig({
   defaults: {

package/server/config/index.ts

@@ -18,6 +18,7 @@ import queue from './queue.js';
 import jobs from './jobs.js';
 import scheduler from './scheduler.js';
 import caching from './caching.js';
+import realtime from './realtime.js';
 import i18n from './i18n.js';
 import app from './app.js';
 import api from './api.js';
@@ -43,6 +44,7 @@ const defaultConfigs: AppConfigFactory<{
   jobs: ReturnType<typeof jobs>;
   scheduler: ReturnType<typeof scheduler>;
   caching: ReturnType<typeof caching>;
+  realtime: ReturnType<typeof realtime>;
   i18n: ReturnType<typeof i18n>;
   app: ReturnType<typeof app>;
   api: ReturnType<typeof api>;
@@ -67,6 +69,7 @@ const defaultConfigs: AppConfigFactory<{
   jobs,
   scheduler,
   caching,
+  realtime,
   i18n,
   app,
   api,