openxiangda 1.0.68 → 1.0.69

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "1.0.68",
+  "version": "1.0.69",
   "description": "OpenXiangda CLI, workspace build tools, runtime SDK, and form components.",
   "private": false,
   "bin": {

package/templates/openxiangda-react-spa/AGENTS.md

@@ -1,15 +1,16 @@
-# AGENTS.md — OpenXiangda React SPA 工作区
+# AGENTS.md — OpenXiangda React SPA 应用工作区
 
-本工作区是标准 React SPA 应用，不是旧 `sy-lowcode-app-workspace` 单页面上传模式。
+本工作区是标准 React 18 + Vite + React Router 应用。默认模板面向真实用户交付，不是开发验证控制台。
 
 ## 开发原则
 
+- 用户界面使用业务语言：工作台、待办、服务、数据、门户、公开服务。
+- 不在默认可见页面展示 SDK、Runtime、Cookie、Proxy、Playwright、AI 验证、调试上下文、构建号等开发语言。
 - 使用 React Router 管理路由，路由定义在 `src/app/router.tsx`。
 - 使用 Tailwind CSS 表达样式，不依赖平台 theme tokens。
-- 使用 `OpenXiangdaProvider` 包裹应用运行时，平台能力通过 SDK hooks 获取。
-- 不在页面里硬编码角色判断。菜单可见和 route 访问都由后端权限接口返回。
-- 页面、表单、字段、数据范围、流程动作、文件、连接器权限以后端为准。
-- 本地开发通过 Vite `/service` 代理远端平台，保留 HttpOnly Cookie。
+- 菜单、首页卡片、快捷入口和示例业务数据优先改 `src/app/navigation.ts` 与 `src/app/starter-content.ts`。
+- 页面、表单、字段、数据范围、流程动作、文件、连接器权限以后端接口为准；前端只做展示保护和清晰状态页。
+- 本地开发通过 Vite `/service` 代理远端平台，保持 HttpOnly Cookie 同域访问。
 
 ## 常用命令
 
@@ -24,8 +25,6 @@ openxiangda resource publish --profile <name>
 openxiangda runtime deploy --profile <name>
 ```
 
-`openxiangda runtime deploy` 会自动设置 `OPENXIANGDA_BUILD_ID` 和 Vite asset base，构建 `dist/`，上传 runtime release，并默认激活。不要手工改 `dist/index.html`。
-
 完整发布顺序：
 
 ```bash
@@ -34,31 +33,39 @@ openxiangda resource publish --profile <name>
 openxiangda runtime deploy --profile <name>
 ```
 
-如果应用需要平台表单、流程表单、详情页或数据列表页，在 `src/forms/<formCode>/schema.ts` 定义表单 schema，并用 `openxiangda workspace publish --form <formCode>` 发布。React SPA 自身继续用 `runtime deploy` 发布。
+`openxiangda runtime deploy` 会构建 `dist/`、上传应用前端包并激活当前版本。不要手工修改 `dist/index.html`。
+
+## 应用结构
+
+- `src/layouts/AdminShell.tsx`：管理后台应用壳、侧边栏、顶部栏、用户菜单。
+- `src/pages/admin/*`：业务工作台、待办中心、服务入口、数据中心。
+- `src/pages/portal/UserPortalPage.tsx`：普通用户门户。
+- `src/pages/public/PublicHomePage.tsx`：公开服务页。
+- `src/pages/defaults/*`：表单、流程、数据列表、文件预览等默认页。
+- `src/runtime/default-page-overrides.tsx`：整页覆盖默认页的入口。
 
 ## 权限资源
 
-React SPA 页面需要声明菜单 code、route code 和 path pattern：
+React SPA 页面需要声明菜单 code、route code 和 path pattern。默认菜单资源在 `src/resources/menus/menus.json`：
 
 ```json
 {
-  "code": "app_user_spa_pages",
-  "roles": ["app_user"],
-  "menuCodes": ["user_portal"],
-  "routeCodes": ["portal.home"],
-  "pathPatterns": ["/view/:appType/portal/*"]
+  "code": "admin_dashboard",
+  "name": "业务工作台",
+  "routeCode": "admin.dashboard",
+  "path": "/view/:appType/admin"
 }
 ```
 
-页面中使用：
+页面中可以使用：
 
 ```tsx
 import { PermissionBoundary, useAppMenus, useRuntimeBootstrap } from "openxiangda/runtime/react";
 ```
 
-`PermissionBoundary` 只能做展示保护，不能替代后端权限。
+`PermissionBoundary` 只能做展示保护，不能替代后端权限。后端返回 401 时跳登录，403 时展示无权限状态。
 
-## 默认页
+## 默认页与覆盖
 
 - 表单提交：`/view/:appType/admin/forms/:formUuid/new`
 - 表单详情：`/view/:appType/admin/forms/:formUuid/:formInstId`
@@ -66,4 +73,4 @@ import { PermissionBoundary, useAppMenus, useRuntimeBootstrap } from "openxiangd
 - 数据列表：`/view/:appType/admin/data/:formUuid`
 - 文件预览：`/view/file-preview?ticket=...`
 
-默认页可以替换成自定义 React route element；不要回到旧平台 `isRenderNav` 或 workbench 参数模型。
+需要自定义默认页时，在 `src/runtime/default-page-overrides.tsx` 中按页面类型和 `formUuid` 注册覆盖组件。不要回到旧平台 `isRenderNav` 或 workbench 参数模型。

package/templates/openxiangda-react-spa/src/app/navigation.ts

@@ -0,0 +1,165 @@
+import type { ComponentType } from "react";
+import {
+  ClipboardList,
+  Database,
+  FileText,
+  Globe2,
+  Home,
+  Inbox,
+  LayoutDashboard,
+  Search,
+  Workflow,
+} from "lucide-react";
+
+export type StarterNavigationItem = {
+  code?: string;
+  hint?: string;
+  icon: ComponentType<{ size?: string | number; className?: string }>;
+  name: string;
+  path: string;
+  routeCode?: string;
+};
+
+export type StarterNavigationGroup = {
+  title: string;
+  items: StarterNavigationItem[];
+};
+
+export type BuildStarterNavigationOptions = {
+  appType: string;
+  dataFormUuid?: string;
+  processFormUuid?: string;
+  receiptFormUuid?: string;
+};
+
+export const viewPath = (appType: string, path: string) =>
+  `/view/${appType}/${path}`.replace(/\/{2,}/g, "/");
+
+export const formPath = (appType: string, formUuid?: string) =>
+  formUuid ? viewPath(appType, `admin/forms/${encodeURIComponent(formUuid)}/new`) : viewPath(appType, "admin/forms");
+
+export const processPath = (appType: string, formUuid?: string) =>
+  formUuid ? viewPath(appType, `admin/forms/${encodeURIComponent(formUuid)}/new`) : viewPath(appType, "admin/process");
+
+export const dataPath = (appType: string, formUuid?: string) =>
+  formUuid ? viewPath(appType, `admin/data/${encodeURIComponent(formUuid)}`) : viewPath(appType, "admin/data");
+
+export function buildStarterAdminNavigation({
+  appType,
+  dataFormUuid,
+  processFormUuid,
+  receiptFormUuid,
+}: BuildStarterNavigationOptions): StarterNavigationGroup[] {
+  return [
+    {
+      title: "工作台",
+      items: [
+        {
+          code: "admin_dashboard",
+          hint: "业务概览",
+          icon: LayoutDashboard,
+          name: "业务工作台",
+          path: viewPath(appType, "admin"),
+          routeCode: "admin.dashboard",
+        },
+        {
+          code: "task_center",
+          hint: "待办与跟进",
+          icon: Inbox,
+          name: "待办中心",
+          path: viewPath(appType, "admin/tasks"),
+          routeCode: "admin.tasks",
+        },
+      ],
+    },
+    {
+      title: "业务办理",
+      items: [
+        {
+          code: "service_center",
+          hint: "常用服务",
+          icon: ClipboardList,
+          name: "服务入口",
+          path: viewPath(appType, "admin/services"),
+          routeCode: "admin.services",
+        },
+        {
+          code: "service_center",
+          hint: receiptFormUuid ? "提交业务申请" : "配置后可用",
+          icon: FileText,
+          name: "发起申请",
+          path: formPath(appType, receiptFormUuid),
+          routeCode: "admin.services",
+        },
+        {
+          code: "service_center",
+          hint: processFormUuid ? "发起流程办理" : "配置后可用",
+          icon: Workflow,
+          name: "流程办理",
+          path: processPath(appType, processFormUuid),
+          routeCode: "admin.services",
+        },
+      ],
+    },
+    {
+      title: "数据管理",
+      items: [
+        {
+          code: "data_center",
+          hint: "经营数据",
+          icon: Database,
+          name: "数据中心",
+          path: viewPath(appType, "admin/data"),
+          routeCode: "admin.data",
+        },
+        {
+          code: "data_center",
+          hint: dataFormUuid ? "业务台账" : "配置后可用",
+          icon: Search,
+          name: "数据查询",
+          path: dataPath(appType, dataFormUuid),
+          routeCode: "admin.data",
+        },
+      ],
+    },
+    {
+      title: "服务门户",
+      items: [
+        {
+          code: "user_portal",
+          hint: "普通用户入口",
+          icon: Home,
+          name: "用户门户",
+          path: viewPath(appType, "portal"),
+          routeCode: "portal.home",
+        },
+        {
+          code: "public_home",
+          hint: "公开服务",
+          icon: Globe2,
+          name: "公开访问",
+          path: viewPath(appType, "public"),
+          routeCode: "public.home",
+        },
+      ],
+    },
+  ];
+}
+
+export function filterNavigationByMenuCodes(
+  groups: StarterNavigationGroup[],
+  menuCodes: Set<string>,
+) {
+  if (!menuCodes.size) return groups;
+  return groups
+    .map(group => ({
+      ...group,
+      items: group.items.filter(
+        item =>
+          (!item.code && !item.routeCode) ||
+          Boolean(item.code && menuCodes.has(item.code)) ||
+          Boolean(item.routeCode && menuCodes.has(item.routeCode)),
+      ),
+    }))
+    .filter(group => group.items.length > 0);
+}

package/templates/openxiangda-react-spa/src/app/router.tsx

@@ -5,17 +5,20 @@ import {
   useParams,
 } from "react-router-dom";
 import { lazy, Suspense, type ReactNode } from "react";
-import { Database, FileText, Rocket, Settings, Shield, Sparkles, Workflow } from "lucide-react";
+import { FileText, Sparkles, Workflow } from "lucide-react";
 import { OpenXiangdaProvider } from "openxiangda/runtime/react";
 
 import { AdminShell } from "@/layouts/AdminShell";
 import { PublicShell } from "@/layouts/PublicShell";
 import { UserShell } from "@/layouts/UserShell";
-import { RuntimeWorkspacePage } from "@/pages/admin/RuntimeWorkspacePage";
+import { AdminDashboardPage } from "@/pages/admin/AdminDashboardPage";
+import { DataCenterPage } from "@/pages/admin/DataCenterPage";
+import { ServiceCenterPage } from "@/pages/admin/ServiceCenterPage";
+import { TaskCenterPage } from "@/pages/admin/TaskCenterPage";
 import { UserPortalPage } from "@/pages/portal/UserPortalPage";
 import { PublicHomePage } from "@/pages/public/PublicHomePage";
 import { NotFoundPage } from "@/pages/states/NotFoundPage";
-import { MacStatePage } from "@/shared/mac-admin";
+import { StatePage } from "@/shared/ui";
 
 const servicePrefix = process.env.APP_SERVICE_PREFIX || "/service";
 const DataRoutePage = lazy(() =>
@@ -37,7 +40,7 @@ const FormRoutePage = lazy(() =>
 const routeElement = (element: ReactNode) => (
   <Suspense
     fallback={
-      <MacStatePage
+      <StatePage
         description="正在加载页面组件。"
         icon={<Sparkles size={24} />}
         status="LOADING"
@@ -77,14 +80,12 @@ export const router = createBrowserRouter([
         path: "admin",
         element: <AdminShell />,
         children: [
-          { index: true, element: <RuntimeWorkspacePage /> },
-          { path: "forms", element: <MissingResourcePage type="form" /> },
-          { path: "process", element: <MissingResourcePage type="process" /> },
-          { path: "data", element: <MissingResourcePage type="data" /> },
-          { path: "verification", element: <AdminSectionPage type="verification" /> },
-          { path: "permissions", element: <AdminSectionPage type="permissions" /> },
-          { path: "releases", element: <AdminSectionPage type="releases" /> },
-          { path: "settings", element: <AdminSectionPage type="settings" /> },
+          { index: true, element: <AdminDashboardPage /> },
+          { path: "tasks", element: <TaskCenterPage /> },
+          { path: "services", element: <ServiceCenterPage /> },
+          { path: "forms", element: <ResourceEmptyPage type="form" /> },
+          { path: "process", element: <ResourceEmptyPage type="process" /> },
+          { path: "data", element: <DataCenterPage /> },
           { path: "data/:formUuid", element: routeElement(<DataRoutePage />) },
           { path: "forms/:formUuid/new", element: routeElement(<FormRoutePage mode="submit" />) },
           { path: "forms/:formUuid/:formInstId", element: routeElement(<FormRoutePage mode="detail" />) },
@@ -115,68 +116,25 @@ export const router = createBrowserRouter([
   { path: "*", element: <NotFoundPage /> },
 ]);
 
-function MissingResourcePage({ type }: { type: "form" | "process" | "data" }) {
+function ResourceEmptyPage({ type }: { type: "form" | "process" }) {
   const config = {
     form: {
-      description: "当前应用还没有可用于默认提交页的普通表单。发布表单资源后，菜单会自动进入对应默认页。",
+      description: "当前应用还没有配置可发起的普通表单。配置完成后，这里会进入对应的申请页面。",
       icon: <FileText size={24} />,
-      title: "暂无表单资源",
+      title: "暂无可发起申请",
     },
     process: {
-      description: "当前应用还没有可用于流程发起页的流程表单。发布流程资源后，菜单会自动进入对应默认页。",
+      description: "当前应用还没有配置流程办理入口。配置完成后，这里会进入对应的流程页面。",
       icon: <Workflow size={24} />,
-      title: "暂无流程资源",
-    },
-    data: {
-      description: "当前应用还没有可用于数据管理列表的普通表单。发布表单资源后，菜单会自动进入对应数据列表。",
-      icon: <Database size={24} />,
-      title: "暂无数据资源",
-    },
-  }[type];
-
-  return (
-    <MacStatePage
-      description={config.description}
-      icon={config.icon}
-      status="RESOURCE"
-      title={config.title}
-    />
-  );
-}
-
-function AdminSectionPage({
-  type,
-}: {
-  type: "verification" | "permissions" | "releases" | "settings";
-}) {
-  const config = {
-    verification: {
-      description: "这里预留 AI 验证、测试账号和一次性登录链接的工作台入口。后续可按项目需要替换为自定义实现。",
-      icon: <Sparkles size={24} />,
-      title: "AI 验证",
-    },
-    permissions: {
-      description: "这里预留页面 code、角色页面权限和菜单可见性配置说明。平台权限仍以后端接口为准。",
-      icon: <Shield size={24} />,
-      title: "角色权限",
-    },
-    releases: {
-      description: "这里预留运行时版本、构建记录和发布动作入口。当前模板默认通过 OpenXiangda CLI 发布。",
-      icon: <Rocket size={24} />,
-      title: "发布版本",
-    },
-    settings: {
-      description: "这里预留应用运行参数和本地开发代理配置入口。业务项目可以按需整页覆盖。",
-      icon: <Settings size={24} />,
-      title: "系统设置",
+      title: "暂无流程入口",
     },
   }[type];
 
   return (
-    <MacStatePage
+    <StatePage
       description={config.description}
       icon={config.icon}
-      status="ADMIN"
+      status="EMPTY"
       title={config.title}
     />
   );

package/templates/openxiangda-react-spa/src/app/starter-content.ts

@@ -0,0 +1,182 @@
+import type { AppTone } from "@/shared/ui";
+
+export const starterBrand = {
+  fallbackName: "业务应用",
+  logoText: "企",
+  subtitle: "运营后台",
+};
+
+export const dashboardHero = {
+  title: "业务工作台",
+  description: "集中处理待办事项、跟进关键业务进展，并快速进入常用服务。",
+};
+
+export const dashboardMetrics: Array<{
+  label: string;
+  value: string;
+  caption: string;
+  tone: AppTone;
+}> = [
+  {
+    caption: "待审批、待办理和需要补充资料的事项。",
+    label: "今日待办",
+    tone: "amber",
+    value: "18",
+  },
+  {
+    caption: "本周新增的申请、登记和服务请求。",
+    label: "新增业务",
+    tone: "blue",
+    value: "126",
+  },
+  {
+    caption: "按当前权限可查看的数据记录。",
+    label: "可查数据",
+    tone: "emerald",
+    value: "3,428",
+  },
+  {
+    caption: "近七日平均办理完成率。",
+    label: "办理效率",
+    tone: "violet",
+    value: "92%",
+  },
+];
+
+export const trendOverview = {
+  title: "近七日业务趋势",
+  description: "用于呈现申请、审批和数据更新节奏，帮助团队判断当前业务负载。",
+  values: [38, 52, 46, 68, 74, 63, 91],
+  summary: [
+    { label: "平均响应", value: "2.6 小时" },
+    { label: "按时完成", value: "94%" },
+    { label: "本周高峰", value: "周五" },
+  ],
+};
+
+export const quickActions = [
+  {
+    desc: "提交业务申请、登记信息或创建流程。",
+    label: "发起申请",
+    tone: "blue" as AppTone,
+    type: "form" as const,
+  },
+  {
+    desc: "查看需要当前用户处理的审批与任务。",
+    label: "处理待办",
+    tone: "amber" as AppTone,
+    type: "tasks" as const,
+  },
+  {
+    desc: "进入有权限的数据列表和业务台账。",
+    label: "数据查询",
+    tone: "emerald" as AppTone,
+    type: "data" as const,
+  },
+  {
+    desc: "打开面向普通用户的服务门户。",
+    label: "用户门户",
+    tone: "violet" as AppTone,
+    type: "portal" as const,
+  },
+];
+
+export const taskItems = [
+  {
+    assignee: "当前用户",
+    due: "今天 18:00",
+    priority: "high" as const,
+    status: "待处理",
+    title: "审批新的业务申请",
+  },
+  {
+    assignee: "业务运营组",
+    due: "明天 10:00",
+    priority: "medium" as const,
+    status: "跟进中",
+    title: "补充客户资料并更新台账",
+  },
+  {
+    assignee: "数据管理员",
+    due: "本周五",
+    priority: "low" as const,
+    status: "待确认",
+    title: "核对本周数据汇总结果",
+  },
+];
+
+export const recentActivities = [
+  "业务申请已提交并进入审批流程。",
+  "数据列表完成更新，新增记录已可查询。",
+  "用户门户服务入口已同步最新配置。",
+  "公开服务页收到新的访问请求。",
+];
+
+export const serviceEntries = [
+  {
+    desc: "适合信息登记、业务申请和资料收集。",
+    label: "普通表单",
+    tone: "blue" as AppTone,
+    type: "form" as const,
+  },
+  {
+    desc: "适合需要审批、办理或抄送的业务流程。",
+    label: "流程办理",
+    tone: "amber" as AppTone,
+    type: "process" as const,
+  },
+  {
+    desc: "按权限查看、筛选和维护业务数据。",
+    label: "数据管理",
+    tone: "emerald" as AppTone,
+    type: "data" as const,
+  },
+  {
+    desc: "面向内部普通用户的统一服务入口。",
+    label: "用户门户",
+    tone: "violet" as AppTone,
+    type: "portal" as const,
+  },
+];
+
+export const portalEntries = [
+  {
+    desc: "快速提交常用业务申请。",
+    label: "我要申请",
+    tone: "blue" as AppTone,
+  },
+  {
+    desc: "查看待处理、已提交和已完成事项。",
+    label: "我的事项",
+    tone: "amber" as AppTone,
+  },
+  {
+    desc: "查询当前账号有权限访问的数据。",
+    label: "数据查询",
+    tone: "emerald" as AppTone,
+  },
+];
+
+export const publicServices = [
+  {
+    desc: "发布无需登录即可查看的说明、指南或入口。",
+    label: "公开说明",
+    tone: "blue" as AppTone,
+  },
+  {
+    desc: "开放访客可提交的登记或反馈表单。",
+    label: "公开登记",
+    tone: "emerald" as AppTone,
+  },
+  {
+    desc: "使用短期凭证打开文件、邀请或查询页面。",
+    label: "安全链接",
+    tone: "amber" as AppTone,
+  },
+];
+
+export const dataRows = [
+  { count: "428", label: "本月新增", trend: "+12%" },
+  { count: "96", label: "处理中", trend: "-8%" },
+  { count: "2,904", label: "累计完成", trend: "+18%" },
+];