ray-template/apps/docs/guide/first-page.md
XiaoDaiGua-Ray 59c1090ea4
feat(fullstack): add optional backend and source distributions
Add the NestJS backend with PostgreSQL and Redis, local setup, and
independent frontend and fullstack source archives.

Enforce permissions across redirects, let users dismiss the 403 page,
and restore missing translation warnings in development.
2026-11-06 19:53:49 +08:00

2.3 KiB

第一个业务页面

从一张订单表开始:先用本地数据验证页面与菜单,再改为远端查询。

创建页面

在 apps/admin/src/views/orders/index.tsx 添加:

import { RTablePro } from '@ray-template/ui/table-pro'
import { defineComponent } from 'vue'

const rows = [{ id: 'ORD-001', customer: '演示客户' }]

export default defineComponent({
  name: 'Orders',
  setup() {
    return () => (
      <RTablePro
        columns={[
          { key: 'id', title: '订单号' },
          { key: 'customer', title: '客户' },
        ]}
        data={rows}
        search={[{ key: 'customer', label: '客户' }]}
        columnStateKey="orders:list"
      />
    )
  },
})

默认行标识取 id 或 key。自定义标识字段时传 rowKey。示例中的列标题为中文,提供中英文界面时也要将列标题和查询提示加入语言包。

接入菜单

先在 apps/admin/src/router/config/views.ts 的 views 中登记组件白名单:

orders: { load: () => import('@/views/orders'), name: 'Orders' },

在 Mock 初始路由 JSON packages/demo-data/src/routes.json 中加入以下记录,或由自己的路由接口返回:

{
  "path": "/orders",
  "name": "Orders",
  "component": "orders",
  "meta": { "i18nKey": "menu.Orders", "icon": "navigation/table", "order": 20 }
}

在中英文 menu.json 中加入 Orders 翻译。已有浏览器修改过路由时,进入路由管理载入初始配置并保存到接口,或直接在管理页添加该记录;重新加载后,从菜单、直接地址和刷新三条路径检查页面。

现成的「系统管理 → 用户管理」已演示组织筛选、远端查询、新增编辑、详情、批量操作和接口权限。可先对照这条完整流程,再接入自己的业务。其 API 与数据结构见标准契约。

接入 API

在 apps/admin/src/api 写订单请求函数,将 TablePro 的分页、筛选条件映射成后端的字段,并把 data 替换成 request={loadOrders}。接口需返回当前页数据和筛选后的总数。参照远端 TablePro 在线示例接入排序、取消和错误重试。

下一步:TablePro · 路由与权限 · 接口约定