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

package/client/extensions/nocobase-workflow-management/README.md

@@ -5,8 +5,8 @@ Install with `yes n | pnpm exec shadcn add @nocobase/workflow-management`. This
 | File                   | Exports and responsibility                                                                                                                                                         |
 | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `layout.tsx`           | `WorkflowManagementLayout`: page container, shared header and line-style tabs, hidden in detail mode. `WorkflowDefinitionDetail`: diagram and parameter form cards in two columns. |
-| `definition-list.tsx`  | `WorkflowDefinitionList`: optional category rail, search slot, refresh and execution-activity sort controls, adapted definition rows and empty/status content.                     |
-| `execution-list.tsx`   | `WorkflowExecutionList`: filters slot, refresh, controlled ordering, adapted execution rows, empty/status content and controlled pagination.                                       |
+| `definition-list.tsx`  | `WorkflowDefinitionList`: optional category rail, search slot and execution-activity sort controls, adapted definition rows and empty/status content.                              |
+| `execution-list.tsx`   | `WorkflowExecutionList`: filters slot, controlled ordering, adapted execution rows, empty/status content and controlled pagination.                                                |
 | `execution-detail.tsx` | `WorkflowExecutionDetail`: ordered history, step selection, diagram rendering callback, effects and optional recorded-parameter content.                                           |
 
 ## Routes and ownership
@@ -53,11 +53,11 @@ const routes = defineAppRoutes([
 
 Add definition and execution detail routes beneath the corresponding tab route, also without `navigation`. The parent page maps the URL to `tab`, navigates in `onTabChange`, and supplies its `Outlet` as children. Reuse an existing system group instead of registering another one.
 
-Keep requests, query parameters, IME-aware search, filtering, pagination, category CRUD and permissions in application adapters. Map rows into display values and router links before passing them to the lists. `loaded` distinguishes an empty response from data that has not arrived; `loading` disables refresh, and the caller disables pagination while pending. Supply error/loading/retry content through `status`, and separate empty-catalog and no-results wording through `empty`. The search slot is constrained beside Refresh on wider screens; the category rail stacks above the list on small screens. Omit `categories` when classification is unnecessary. The installable demo provides in-memory category filtering, named color selection and add/edit/delete dialogs as an application adapter; deleting a category preserves its workflows and clears the selected category filter. Its definition header also demonstrates a colored category dropdown with an Uncategorized option; assignment uses the same category state as list filtering. The production adapter keeps the assignment API and read/update permission checks in the application.
+Keep requests, query parameters, IME-aware search, filtering, pagination, category CRUD and permissions in application adapters. Map rows into display values and router links before passing them to the lists. `loaded` distinguishes an empty response from data that has not arrived; `loading` supplies pending feedback, and the caller disables pagination while pending. Supply error/loading/retry content through `status`, and separate empty-catalog and no-results wording through `empty`. The search slot stays compact on wider screens; the category rail stacks above the list on small screens. Omit `categories` when classification is unnecessary. The installable demo provides in-memory category filtering, named color selection and add/edit/delete dialogs as an application adapter; deleting a category preserves its workflows and clears the selected category filter. Its definition header also demonstrates a colored category dropdown with an Uncategorized option; assignment uses the same category state as list filtering. The production adapter keeps the assignment API and read/update permission checks in the application.
 
 `WorkflowDefinitionDetail` accepts a diagram slot and a parameter form slot. Render the installed `@nocobase/lifecycle-diagram` or an existing compatible diagram in a definite-height or content-sized canvas. Keep schema validation, effective timing, complete-group saves, CAS conflicts and read-only permissions in the application's parameter editor. Show a translated empty state when a definition declares no adjustable parameters.
 
-`WorkflowExecutionDetail` sorts transitions by version, timestamp and id without mutating the input. Selecting a step passes only that history prefix and its destination state to `renderDiagram`; no transition or server action occurs. Pass the runtime's transition records directly, retaining extra fields through its generic history type. `effects` displays persisted statuses, attempts and failures; it does not retry them. Pass recorded parameter content through `parameters` and label historical facts separately from current configuration. Remount the detail on record changes or an explicit refresh to reset historical selection, as the example application does.
+`WorkflowExecutionDetail` sorts transitions by version, timestamp and id without mutating the input. Selecting a step passes only that history prefix and its destination state to `renderDiagram`; no transition or server action occurs. Pass the runtime's transition records directly, retaining extra fields through its generic history type. `effects` displays persisted statuses, attempts and failures; it does not retry them. Pass recorded parameter content through `parameters` and label historical facts separately from current configuration. Remount the detail on record identity changes; preserve a selected historical step during automatic updates.
 
 The application owns authentication, initial administrator grants, navigation and direct-page guards, server read/update authorization and any recovery actions. Configuration permission does not grant business approval permission. Installing this block creates source files, not routes, permissions, runtime services or database collections.
 
@@ -71,4 +71,4 @@ Omit `WorkflowDefinitionDetail.parameters` when the editor opens contextually so
 
 Ordering is optional: omit `onSort` when activity ordering is not supported so the header stays plain text. Omit a row's optional `name` when its linked `title` already supplies the complete display name. Hosts own filtering, pagination and their URL state; keep that state when opening and returning from a definition or execution.
 
-List hosts pass `listState={resolveListState(request, rows.length, hasEffectiveFilters)}` and `onClearFilters`, using the current request error and data. The DataTable dependency supplies shared loading, denial, session and failure copy; merge the `listFeedback` English/Chinese keys from the components README into application translations. `onRefresh` is reused for retry and must preserve the current query. Keep `loaded`, `loading`, custom `empty` content and existing permission checks when reconciling installed copies. A successful empty filter is `no-results`; an empty unfiltered read is `empty`. Hosts that retain the legacy status slot without a listState still own their error rendering.
+List hosts pass `listState={resolveListState(request, rows.length, hasEffectiveFilters)}` and `onClearFilters`, using the current request error and data. The DataTable dependency supplies shared loading, denial, session and failure copy; merge the `listFeedback` English/Chinese keys from the components README into application translations. `onRefresh` handles contextual failed-read retry and must preserve the current query; ready lists render no Refresh action. The host owns subscription/snapshot updates for open progress views. Keep `loaded`, `loading`, custom `empty` content and existing permission checks when reconciling installed copies. A successful empty filter is `no-results`; an empty unfiltered read is `empty`. Hosts that retain the legacy status slot without a listState still own their error rendering.

package/client/extensions/nocobase-workflow-management/definition-list.tsx

@@ -27,7 +27,8 @@ export interface WorkflowDefinitionListProps {
   loading: boolean;
   empty?: ReactNode;
   labels: {
-    refresh: string;
+    /** Legacy adapter label; ready lists no longer render a Refresh control. */
+    refresh?: string;
     workflow: string;
     executionCount: string;
     executionActivity: string;
@@ -66,14 +67,6 @@ export function WorkflowDefinitionList({
       <div className='flex w-full min-w-0 flex-1 flex-col gap-4'>
         <div className='flex flex-col items-stretch justify-between gap-2 sm:flex-row sm:items-center'>
           <div className='min-w-0 flex-1 sm:max-w-xs'>{search}</div>
-          <Button
-            className='shrink-0 self-start sm:self-auto'
-            variant='outline'
-            disabled={loading}
-            onClick={onRefresh}
-          >
-            {labels.refresh}
-          </Button>
         </div>
         {status}
         {(listState !== undefined || loaded || loading) && (

package/client/extensions/nocobase-workflow-management/execution-list.tsx

@@ -27,7 +27,8 @@ export interface WorkflowExecutionListProps {
   status?: ReactNode;
   empty?: ReactNode;
   labels: {
-    refresh: string;
+    /** Legacy adapter label; ready lists no longer render a Refresh control. */
+    refresh?: string;
     record: string;
     workflow: string;
     state: string;
@@ -72,9 +73,6 @@ export function WorkflowExecutionList({
     <section className='flex flex-col gap-4'>
       <div className='flex flex-wrap items-center justify-between gap-3'>
         <div className='flex flex-wrap items-center gap-2'>{filters}</div>
-        <Button variant='outline' disabled={loading} onClick={onRefresh}>
-          {labels.refresh}
-        </Button>
       </div>
       {status}
       {(listState !== undefined || loaded || loading) && (

package/client/layouts/app-layout.tsx

@@ -18,7 +18,6 @@ import {
   AppSidebarToggle,
 } from './components/app-sidebar.js';
 import { NavigationMenu } from './components/navigation-menu.js';
-import { AppBrand } from './components/app-brand.js';
 import { HeaderActions } from './components/header-actions.js';
 import { AppSidebarFooter } from './components/sidebar-footer.js';
 import {
@@ -62,9 +61,6 @@ export function AppLayout({ routes }: AppLayoutProps): ReactElement {
             <LayoutHeader className='sticky top-0 z-40 justify-between'>
               <div className='flex min-w-0 items-center gap-3'>
                 <AppSidebarToggle />
-                <div className='md:hidden'>
-                  <AppBrand />
-                </div>
                 <div className='h-5 w-px shrink-0 bg-border' />
                 {/* The current page's trail: the route tree's, or the one the page declares (`usePageBreadcrumb`). */}
                 <Breadcrumbs denied={denied} />

package/client/lib/navigation-transform.ts

@@ -31,7 +31,35 @@ export function transformNavigation(
   items: RouteNavigationItem[],
   routes: readonly AppClientRegisteredRoute[],
 ): RouteNavigationItem[] {
-  return collapseSettingsNavigation(organizeNavigation(items, routes));
+  const organized = organizeNavigation(items, routes);
+  const hasGuide = organized.some(
+    (item) =>
+      item.route.name === SETTINGS_GROUP &&
+      item.children.some(
+        (child) =>
+          child.route.packageName === '@nocobase/app-plugin-foundation' &&
+          child.route.name === 'capabilityGuide',
+      ),
+  );
+  return collapseSettingsNavigation(organized).map((item) =>
+    hasGuide && item.route.name === SETTINGS_HOME
+      ? {
+          ...item,
+          activeRouteKeys: [
+            ...(item.activeRouteKeys ?? []),
+            ...routes
+              .filter(
+                (route) =>
+                  route.packageName === '@nocobase/app-plugin-foundation' &&
+                  ['capabilityGuide', 'capabilityGuideEntry'].includes(
+                    route.name,
+                  ),
+              )
+              .map((route) => `${route.packageName}:${route.path}:${route.id}`),
+          ],
+        }
+      : item,
+  );
 }
 
 /**

package/client/locales/system/en-US.ts

@@ -1,3 +1,4 @@
+import databaseExplorer from '../../pages/settings/database-explorer/en-US.js';
 import settings from './settings-en-US.js';
 import type { LocaleResource } from '@nocobase/i18n';
 import deviceApprovalEnUS from '#extensions/nocobase-device-approval/locales/en-US';
@@ -8,6 +9,21 @@ import inboxEnUS from '#extensions/nocobase-inbox/locales/en-US';
  * upgrade replaces this file, so put the application's own copy in `../en-US.ts` rather than here.
  */
 const systemEnUS = {
+  databaseExplorer,
+  pendingFeedback: {
+    working: 'Working…',
+    longWait: 'This is taking longer than usual. You can keep waiting.',
+  },
+  taskProgress: {
+    queued: 'Waiting to start',
+    running: 'In progress',
+    completed: 'Completed',
+    failed: 'Failed',
+    canceled: 'Canceled',
+    count: '{{processed}} of {{total}}',
+    processed: '{{processed}} processed',
+    background: 'It keeps running if you leave this page.',
+  },
   listFeedback: {
     loading: 'Loading',
     empty: 'No data yet',
@@ -144,10 +160,14 @@ const systemEnUS = {
   'auth.foundationDescription': 'Reliable data, access control and governance.',
   'auth.marketingFooter': 'Freedom above. Confidence below.',
   'status.loading': 'Loading',
+  'status.refreshing': 'Refreshing',
   'status.loadingPage': 'Loading page',
   'status.denied': 'Access denied',
   'status.pageFailed': 'Unable to load page',
   'status.retry': 'Retry',
+  'status.reloadPage': 'Reload page',
+  'status.retryFailedDescription':
+    'It still could not be loaded. Reloading the whole page may help; unsaved changes on this page may be lost.',
   'navigation.brandHome': 'NocoBase home',
   'navigation.brandApps': 'NocoBase applications',
   'routeOverlay.close': 'Close',
@@ -401,6 +421,7 @@ const systemEnUS = {
     signingOut: 'Signing out…',
   },
   navigation: {
+    resources: 'Resources',
     home: 'Home',
     open: 'Open navigation',
     close: 'Close navigation',
@@ -412,6 +433,7 @@ const systemEnUS = {
     breadcrumb: 'Breadcrumb',
     breadcrumbMore: 'Show the levels in between',
     back: 'Back',
+    backTo: 'Back to {{label}}',
   },
   dataTable: {
     noResults: 'No results',
@@ -431,6 +453,7 @@ const systemEnUS = {
   datePicker: {
     placeholder: 'Pick a date',
     rangePlaceholder: 'Pick a date range',
+    clear: 'Clear',
   },
 };
 

package/client/locales/system/zh-CN.ts

@@ -1,3 +1,4 @@
+import databaseExplorer from '../../pages/settings/database-explorer/zh-CN.js';
 import settings from './settings-zh-CN.js';
 import type { SystemResource } from './en-US.js';
 import deviceApprovalZhCN from '#extensions/nocobase-device-approval/locales/zh-CN';
@@ -5,6 +6,21 @@ import inboxZhCN from '#extensions/nocobase-inbox/locales/zh-CN';
 
 /** The Chinese copy of what the template ships; see `./en-US.ts`. */
 const systemZhCN: SystemResource = {
+  databaseExplorer,
+  pendingFeedback: {
+    working: '正在处理…',
+    longWait: '耗时比平常更长，您可以继续等待。',
+  },
+  taskProgress: {
+    queued: '等待开始',
+    running: '进行中',
+    completed: '已完成',
+    failed: '失败',
+    canceled: '已取消',
+    count: '{{processed}} / {{total}}',
+    processed: '已处理 {{processed}}',
+    background: '离开此页面后任务会继续运行。',
+  },
   listFeedback: {
     loading: '加载中',
     empty: '暂无数据',
@@ -133,10 +149,14 @@ const systemZhCN: SystemResource = {
   'auth.foundationDescription': '可靠的数据、访问控制与治理',
   'auth.marketingFooter': '自由构建，可靠支撑',
   'status.loading': '加载中',
+  'status.refreshing': '正在刷新',
   'status.loadingPage': '正在加载页面',
   'status.denied': '无权访问',
   'status.pageFailed': '无法加载页面',
   'status.retry': '重试',
+  'status.reloadPage': '重新加载页面',
+  'status.retryFailedDescription':
+    '仍然无法加载。可以重新加载整个页面，但本页未保存的修改可能丢失。',
   'navigation.brandHome': 'NocoBase 首页',
   'navigation.brandApps': 'NocoBase 应用',
   'routeOverlay.close': '关闭',
@@ -376,6 +396,7 @@ const systemZhCN: SystemResource = {
     signingOut: '正在退出…',
   },
   navigation: {
+    resources: '参考资料',
     home: '首页',
     open: '打开导航',
     close: '关闭导航',
@@ -387,6 +408,7 @@ const systemZhCN: SystemResource = {
     breadcrumb: '面包屑',
     breadcrumbMore: '显示中间层级',
     back: '返回',
+    backTo: '返回{{label}}',
   },
   dataTable: {
     noResults: '无结果',
@@ -406,6 +428,7 @@ const systemZhCN: SystemResource = {
   datePicker: {
     placeholder: '选择日期',
     rangePlaceholder: '选择日期范围',
+    clear: '清除',
   },
 };
 

package/client/pages/home/index.tsx

@@ -5,8 +5,28 @@ import {
   CopyIcon,
   MessageSquareTextIcon,
   SparklesIcon,
+  ShieldCheckIcon,
+  PaperclipIcon,
+  GitBranchIcon,
+  BellIcon,
+  CalendarClockIcon,
+  BotIcon,
+  type LucideIcon,
 } from 'lucide-react';
-import { type ReactElement, useState } from 'react';
+import { type ReactElement } from 'react';
+import { Link } from 'react-router';
+import {
+  CAPABILITY_GUIDE_PATH,
+  capabilityPath,
+  createCapabilityCatalog,
+  entryContent,
+  format,
+  guideContent,
+  type CatalogEntry,
+  type GuideContent,
+} from '@nocobase/app-plugin-foundation/capability-guide';
+
+import applicationManifest from '../../../package.json' with { type: 'json' };
 
 import { PageContainer } from '#components/page-container';
 import { Button } from '#components/ui/button';
@@ -18,24 +38,25 @@ import {
   CardTitle,
 } from '#components/ui/card';
 
-import { CAPABILITIES, type Capability } from './capabilities.js';
-import { PromptDialog } from './prompt-dialog.js';
 import { useCopy } from './use-copy.js';
 
+// The cards and their wording come from the capability guide, built from this application's own dependencies, so
+// the home page and the guide never disagree; only the icons are the page's own.
+const catalog = createCapabilityCatalog(applicationManifest);
+const HOME_ICONS: Readonly<Record<string, LucideIcon>> = {
+  'app-plugin-authorization': ShieldCheckIcon,
+  'app-plugin-file': PaperclipIcon,
+  lifecycle: GitBranchIcon,
+  'app-plugin-notification': BellIcon,
+  'app-plugin-scheduler': CalendarClockIcon,
+  'app-plugin-agents': BotIcon,
+};
+
 const STEPS = ['describe', 'build', 'review'] as const;
 
 export default function HomePage(): ReactElement {
-  const { t } = useTranslation();
-  const [selected, setSelected] = useState<Capability>();
-  const [open, setOpen] = useState(false);
-  // Changes on every opening, so the dialog remounts and drops the edits of the previous one.
-  const [openCount, setOpenCount] = useState(0);
-
-  const openCapability = (capability: Capability): void => {
-    setSelected(capability);
-    setOpenCount((count) => count + 1);
-    setOpen(true);
-  };
+  const { i18n } = useTranslation();
+  const content = guideContent(i18n.language);
 
   return (
     <PageContainer className='mx-auto max-w-6xl'>
@@ -44,33 +65,31 @@ export default function HomePage(): ReactElement {
         aria-labelledby='home-capabilities'
         className='flex flex-col gap-4'
       >
-        <div className='flex flex-col gap-1'>
-          <h2 id='home-capabilities' className='text-base font-medium'>
-            {t('home.capabilitiesTitle')}
-          </h2>
-          <p className='text-sm text-muted-foreground'>
-            {t('home.capabilitiesDescription')}
-          </p>
+        <div className='flex flex-wrap items-end justify-between gap-2'>
+          <div className='flex flex-col gap-1'>
+            <h2 id='home-capabilities' className='text-base font-medium'>
+              {content.home.title}
+            </h2>
+            <p className='text-sm text-muted-foreground'>
+              {content.home.description}
+            </p>
+          </div>
+          <Link
+            to={CAPABILITY_GUIDE_PATH}
+            className='inline-flex items-center gap-1 text-sm font-medium text-primary hover:underline'
+          >
+            {format(content.home.viewAll, { count: catalog.entries.length })}
+            <ArrowRightIcon className='size-4' aria-hidden />
+          </Link>
         </div>
         <ul className='grid gap-4 sm:grid-cols-2 xl:grid-cols-3'>
-          {CAPABILITIES.map((capability) => (
-            <li key={capability.id} className='flex'>
-              <CapabilityCard
-                capability={capability}
-                onOpen={() => openCapability(capability)}
-              />
+          {catalog.featured.map((entry) => (
+            <li key={entry.id} className='flex'>
+              <CapabilityCard entry={entry} content={content} />
             </li>
           ))}
         </ul>
       </section>
-      {selected ? (
-        <PromptDialog
-          key={openCount}
-          capability={selected}
-          open={open}
-          onOpenChange={setOpen}
-        />
-      ) : null}
     </PageContainer>
   );
 }
@@ -144,26 +163,22 @@ function AgentIntro(): ReactElement {
 }
 
 function CapabilityCard({
-  capability,
-  onOpen,
+  entry,
+  content,
 }: {
-  readonly capability: Capability;
-  readonly onOpen: () => void;
+  readonly entry: CatalogEntry;
+  readonly content: GuideContent;
 }): ReactElement {
-  const { t } = useTranslation();
-  const prefix = `home.capabilities.${capability.id}`;
-  const Icon = capability.icon;
+  const text = entryContent(content, entry);
+  const Icon = HOME_ICONS[entry.id] ?? SparklesIcon;
 
   return (
-    <button
-      type='button'
-      onClick={onOpen}
+    <Link
+      to={capabilityPath(entry.id)}
       className='group flex w-full cursor-pointer rounded-xl text-left outline-none focus-visible:ring-3 focus-visible:ring-ring/50'
     >
       <Card className='w-full transition-[translate,box-shadow,background-color] duration-200 ease-out group-hover:-translate-y-0.5 group-hover:bg-hover group-hover:shadow-md motion-reduce:transition-none motion-reduce:group-hover:translate-y-0'>
         <CardHeader className='gap-3'>
-          {/* The chip only deepens its tint on hover rather than inverting: swapping a light background and a dark icon
-              passes both through the same color halfway, where the icon vanishes for a moment and reads as a flicker. */}
           <span className='flex size-9 items-center justify-center rounded-lg bg-primary/5 text-primary ring-1 ring-transparent transition-[background-color,box-shadow] duration-200 ease-out group-hover:bg-primary/10 group-hover:ring-border motion-reduce:transition-none'>
             <Icon
               className='size-4 transition-transform duration-200 ease-out group-hover:scale-110 motion-reduce:transition-none'
@@ -171,20 +186,20 @@ function CapabilityCard({
             />
           </span>
           <div className='flex flex-col gap-1'>
-            <CardTitle>{t(`${prefix}.title`)}</CardTitle>
+            <CardTitle>{text.title}</CardTitle>
             <CardDescription className='leading-6'>
-              {t(`${prefix}.description`)}
+              {text.summary}
             </CardDescription>
           </div>
         </CardHeader>
         <CardFooter className='mt-auto justify-between text-sm text-muted-foreground transition-colors duration-200 ease-out group-hover:text-foreground'>
-          {t('home.viewPrompts', { count: capability.prompts.length })}
+          {content.home.open}
           <ArrowRightIcon
             className='size-4 transition-transform duration-200 ease-out group-hover:translate-x-1 motion-reduce:transition-none'
             aria-hidden
           />
         </CardFooter>
       </Card>
-    </button>
+    </Link>
   );
 }

package/client/pages/settings/database-explorer/en-US.ts

@@ -0,0 +1,33 @@
+export default {
+  title: 'Database Explorer',
+  description:
+    'Browse the application’s database connections, tables and fields.',
+  connections: 'Database connection',
+  defaultConnection: 'Default',
+  tables: 'Tables',
+  searchTables: 'Search tables',
+  fields: 'Fields',
+  searchFields: 'Search fields',
+  name: 'Name',
+  type: 'Type',
+  nullable: 'Nullable',
+  primaryKey: 'Primary key',
+  target: 'Related table',
+  yes: 'Yes',
+  no: 'No',
+  unknown: 'Not specified',
+  emptyConnections: 'No database connections are configured.',
+  emptyTables: 'No tables found.',
+  emptyFields: 'No fields found.',
+  selectTable: 'Select a table to view its fields.',
+  loading: 'Loading…',
+  failed: 'Unable to load database information.',
+  forbidden: 'You do not have permission to browse this database.',
+  expired: 'Your session has expired. Sign in again to continue.',
+  signIn: 'Sign in',
+  retry: 'Retry',
+  truncated:
+    'Only part of the table list could be loaded. Narrow the database scope to browse the remaining tables.',
+  warnings:
+    'Some fields could not be fully resolved. The displayed structure may be incomplete.',
+};