openxiangda-cli 2.0.0-alpha.49 → 2.0.0-alpha.56

package/template/apps/web/src/InstrumentListPage.tsx

@@ -0,0 +1,390 @@
+import {
+  DeleteOutlined,
+  EditOutlined,
+  EyeOutlined,
+  ExportOutlined,
+  ImportOutlined,
+  PlusOutlined,
+  SearchOutlined,
+} from '@ant-design/icons';
+import { useDelete, useList } from '@refinedev/core';
+import {
+  App,
+  Button,
+  Card,
+  DatePicker,
+  Input,
+  InputNumber,
+  Popconfirm,
+  Result,
+  Select,
+  Space,
+  Table,
+  Tag,
+  Tooltip,
+  type TableColumnsType,
+} from 'antd';
+import { useMemo, useState } from 'react';
+import { useNavigate } from 'react-router-dom';
+import { Shell } from './Shell';
+import {
+  INSTRUMENT_CAPABILITIES,
+  type InstrumentListQuery,
+  type InstrumentRecord,
+} from './instrument';
+import { useRuntime } from './runtime';
+
+const colleges = [
+  { label: '先进材料学院', value: 'college-am' },
+  { label: '生命健康学院', value: 'college-lh' },
+  { label: '公共测试中心', value: 'college-pt' },
+];
+const admins = [
+  { label: '王老师', value: 'user-wang' },
+  { label: '李老师', value: 'user-li' },
+  { label: '陈老师', value: 'user-chen' },
+];
+const statuses = [
+  { label: '正常', value: 'normal' },
+  { label: '维修', value: 'maintenance' },
+  { label: '停用', value: 'disabled' },
+  { label: '报废', value: 'scrapped' },
+];
+
+export function InstrumentListPage() {
+  const navigate = useNavigate();
+  const { hasCapability } = useRuntime();
+  const { message } = App.useApp();
+  const [page, setPage] = useState(1);
+  const [pageSize, setPageSize] = useState(20);
+  const [draft, setDraft] = useState<Partial<InstrumentListQuery>>({});
+  const [query, setQuery] = useState<Partial<InstrumentListQuery>>({});
+  const [sort, setSort] = useState<{
+    field: string;
+    order: 'asc' | 'desc';
+  }>({ field: 'updatedAt', order: 'desc' });
+  const list = useList<InstrumentRecord>({
+    resource: 'instruments',
+    pagination: { currentPage: page, pageSize },
+    sorters: [sort],
+    meta: { query },
+  });
+  const remove = useDelete();
+  const data = (list.result.data || []) as InstrumentRecord[];
+  const total = list.result.total || 0;
+  const canCreate = hasCapability(INSTRUMENT_CAPABILITIES.create);
+  const canUpdate = hasCapability(INSTRUMENT_CAPABILITIES.update);
+  const canDelete = hasCapability(INSTRUMENT_CAPABILITIES.delete);
+  const columns = useMemo<TableColumnsType<InstrumentRecord>>(
+    () => [
+      {
+        title: '图片',
+        dataIndex: 'image',
+        width: 84,
+        render: value =>
+          value?.name ? <Tag>{String(value.name)}</Tag> : <span className="oxa-muted">无图</span>,
+      },
+      {
+        title: '仪器名称',
+        dataIndex: 'chineseName',
+        width: 210,
+        sorter: true,
+        render: (value, record) => (
+          <a onClick={() => navigate(`/instruments/${record.id}`)}>{value}</a>
+        ),
+      },
+      { title: '规格型号', dataIndex: 'specModel', width: 160 },
+      { title: '仪器编码', dataIndex: 'instrumentCode', width: 140 },
+      { title: '资产编码', dataIndex: 'assetCode', width: 140 },
+      {
+        title: '所属学院',
+        dataIndex: 'collegeId',
+        width: 140,
+        render: value =>
+          colleges.find(item => item.value === value)?.label || value,
+      },
+      {
+        title: '仪器管理员',
+        dataIndex: 'instrumentAdminIds',
+        width: 130,
+        render: values =>
+          (values as string[])
+            .map(
+              value =>
+                admins.find(item => item.value === value)?.label || value
+            )
+            .join('、'),
+      },
+      {
+        title: '仪器状态',
+        dataIndex: 'instrumentStatus',
+        width: 100,
+        render: value => (
+          <Tag
+            color={
+              value === 'normal'
+                ? 'green'
+                : value === 'maintenance'
+                  ? 'orange'
+                  : 'default'
+            }
+          >
+            {statuses.find(item => item.value === value)?.label || value}
+          </Tag>
+        ),
+      },
+      {
+        title: '对外开放',
+        dataIndex: 'openToOutside',
+        width: 90,
+        render: value => (
+          <Tag color={value ? 'green' : 'default'}>{value ? '是' : '否'}</Tag>
+        ),
+      },
+      {
+        title: '更新时间',
+        dataIndex: 'updatedAt',
+        width: 160,
+        sorter: true,
+        render: value => (value ? new Date(value).toLocaleString() : '-'),
+      },
+      {
+        title: '操作',
+        fixed: 'right',
+        width: 180,
+        render: (_, record) => (
+          <Space>
+            <Button
+              aria-label="查看"
+              icon={<EyeOutlined />}
+              size="small"
+              onClick={() => navigate(`/instruments/${record.id}`)}
+            />
+            {canUpdate && (
+              <Button
+                aria-label="编辑"
+                icon={<EditOutlined />}
+                size="small"
+                onClick={() => navigate(`/instruments/${record.id}/edit`)}
+              />
+            )}
+            {canDelete && (
+              <Popconfirm
+                title="确定删除这台仪器？"
+                description="删除后不可恢复"
+                onConfirm={() =>
+                  remove.mutate(
+                    {
+                      resource: 'instruments',
+                      id: record.id,
+                      meta: { expectedRevision: record.revision },
+                    },
+                    {
+                      onSuccess: () => {
+                        message.success('已删除');
+                        void list.query.refetch();
+                      },
+                    }
+                  )
+                }
+              >
+                <Button
+                  danger
+                  aria-label="删除"
+                  icon={<DeleteOutlined />}
+                  size="small"
+                />
+              </Popconfirm>
+            )}
+          </Space>
+        ),
+      },
+    ],
+    [canDelete, canUpdate, list.query, message, navigate, remove]
+  );
+  if (!hasCapability(INSTRUMENT_CAPABILITIES.read)) {
+    return (
+      <Shell>
+        <Result status="403" title="当前平台用户无仪器页面权限" />
+      </Shell>
+    );
+  }
+  return (
+    <Shell>
+      <Card>
+        <Space direction="vertical" size={16} style={{ width: '100%' }}>
+          <div className="oxa-page-heading">
+            <div>
+              <h1 className="oxa-title" data-testid="instrument-title">
+                仪器资源
+              </h1>
+              <div className="oxa-muted">
+                Refine 管理查询状态；CRUD 只经过平台 Data API adapter
+              </div>
+            </div>
+            <Space>
+              <Tooltip title="批量事务合同落地后启用，不用自定义接口绕过 Data API">
+                <Button disabled icon={<ImportOutlined />}>
+                  导入
+                </Button>
+              </Tooltip>
+              <Button
+                icon={<ExportOutlined />}
+                onClick={() => message.info('导出将使用当前 Data API 查询条件')}
+              >
+                导出
+              </Button>
+              {canCreate && (
+                <Button
+                  type="primary"
+                  icon={<PlusOutlined />}
+                  onClick={() => navigate('/instruments/new')}
+                >
+                  新增仪器
+                </Button>
+              )}
+            </Space>
+          </div>
+          <div className="oxa-filter-grid">
+            <Input
+              allowClear
+              prefix={<SearchOutlined />}
+              placeholder="仪器中文名关键词"
+              value={draft.keyword}
+              onChange={event =>
+                setDraft(value => ({ ...value, keyword: event.target.value }))
+              }
+            />
+            <Select
+              allowClear
+              options={colleges}
+              placeholder="所属学院"
+              value={draft.collegeId}
+              onChange={value =>
+                setDraft(item => ({ ...item, collegeId: value }))
+              }
+            />
+            <Select
+              allowClear
+              options={admins}
+              placeholder="仪器管理员"
+              value={draft.instrumentAdminId}
+              onChange={value =>
+                setDraft(item => ({ ...item, instrumentAdminId: value }))
+              }
+            />
+            <Select
+              allowClear
+              options={statuses}
+              placeholder="仪器状态"
+              value={draft.instrumentStatus}
+              onChange={value =>
+                setDraft(item => ({ ...item, instrumentStatus: value }))
+              }
+            />
+            <Select
+              allowClear
+              options={[
+                { label: '对外开放', value: true },
+                { label: '未开放', value: false },
+              ]}
+              placeholder="是否对外开放"
+              value={draft.openToOutside}
+              onChange={value =>
+                setDraft(item => ({ ...item, openToOutside: value }))
+              }
+            />
+            <DatePicker.RangePicker
+              onChange={(_, values) =>
+                setDraft(item => ({
+                  ...item,
+                  enabledDate:
+                    values[0] && values[1]
+                      ? [values[0], values[1]]
+                      : undefined,
+                }))
+              }
+            />
+            <Space.Compact>
+              <InputNumber
+                min={0}
+                placeholder="最低资产价值"
+                value={draft.assetValue?.[0]}
+                onChange={value =>
+                  setDraft(item => ({
+                    ...item,
+                    assetValue: [
+                      value === null ? undefined : Number(value),
+                      item.assetValue?.[1],
+                    ],
+                  }))
+                }
+              />
+              <InputNumber
+                min={0}
+                placeholder="最高资产价值"
+                value={draft.assetValue?.[1]}
+                onChange={value =>
+                  setDraft(item => ({
+                    ...item,
+                    assetValue: [
+                      item.assetValue?.[0],
+                      value === null ? undefined : Number(value),
+                    ],
+                  }))
+                }
+              />
+            </Space.Compact>
+            <Space>
+              <Button
+                type="primary"
+                icon={<SearchOutlined />}
+                onClick={() => {
+                  setPage(1);
+                  setQuery(draft);
+                }}
+              >
+                查询
+              </Button>
+              <Button
+                onClick={() => {
+                  setDraft({});
+                  setQuery({});
+                  setPage(1);
+                }}
+              >
+                重置
+              </Button>
+            </Space>
+          </div>
+          <Table<InstrumentRecord>
+            columns={columns}
+            dataSource={data}
+            loading={list.query.isLoading}
+            rowKey="id"
+            scroll={{ x: 1450 }}
+            onChange={(_, __, sorter) => {
+              const item = Array.isArray(sorter) ? sorter[0] : sorter;
+              if (item?.field && item.order) {
+                setSort({
+                  field: String(item.field),
+                  order: item.order === 'ascend' ? 'asc' : 'desc',
+                });
+              }
+            }}
+            pagination={{
+              current: page,
+              pageSize,
+              total,
+              showSizeChanger: true,
+              onChange: (next, size) => {
+                setPage(next);
+                setPageSize(size);
+              },
+            }}
+          />
+        </Space>
+      </Card>
+    </Shell>
+  );
+}

package/template/apps/web/src/Shell.tsx

@@ -0,0 +1,52 @@
+import { DatabaseOutlined, SafetyCertificateOutlined } from '@ant-design/icons';
+import { App, Button, Space, Tag } from 'antd';
+import type { ReactNode } from 'react';
+import { useRuntime } from './runtime';
+import { applicationApiPath } from './runtime-meta';
+
+export function Shell({ children }: { children: ReactNode }) {
+  const { identity } = useRuntime();
+  const { message } = App.useApp();
+  const inspectContext = async () => {
+    const response = await fetch(applicationApiPath('api/instruments/context'), {
+      credentials: 'include',
+      headers: { accept: 'application/json' },
+    });
+    if (!response.ok) throw new Error(`HTTP_${response.status}`);
+    const body = (await response.json()) as {
+      userId?: string;
+      data?: { userId?: string };
+    };
+    message.success(
+      `本地 Nest 已读取平台用户：${body.data?.userId || body.userId || identity.userId}`
+    );
+  };
+  return (
+    <div className="oxa-shell">
+      <header className="oxa-header">
+        <Space>
+          <DatabaseOutlined />
+          <strong>仪器资源管理</strong>
+          <Tag color="blue">{identity.environment.key}</Tag>
+        </Space>
+        <Space wrap>
+          <span>{identity.userId}</span>
+          <span className="oxa-header-roles">
+            {identity.roleCodes.join('、') || '无应用角色'}
+          </span>
+          <Button
+            ghost
+            size="small"
+            icon={<SafetyCertificateOutlined />}
+            onClick={() =>
+              void inspectContext().catch(error => message.error(error.message))
+            }
+          >
+            验证本地 Nest
+          </Button>
+        </Space>
+      </header>
+      <main className="oxa-main">{children}</main>
+    </div>
+  );
+}

package/template/apps/web/src/data-provider.ts

@@ -0,0 +1,42 @@
+import type { DataProvider } from '@refinedev/core';
+import type { InstrumentListQuery, InstrumentRecord } from './instrument';
+import { instrumentDataApi } from './platform-client';
+import { applicationCode } from './runtime-meta';
+
+export const instrumentProvider = {
+  getApiUrl: () =>
+    `/service/openxiangda-api/v2/applications/${applicationCode()}/native/data`,
+  getList: async ({ pagination, sorters, meta }) => {
+    const filters = (meta?.query || {}) as Partial<InstrumentListQuery>;
+    const sorter = sorters?.[0];
+    const result = await instrumentDataApi.list({
+      ...filters,
+      page: pagination?.currentPage || 1,
+      pageSize: pagination?.pageSize || 20,
+      sort: sorter
+        ? {
+            field: String(sorter.field),
+            order: sorter.order,
+          }
+        : { field: 'updatedAt', order: 'desc' },
+    });
+    return { data: result.rows, total: result.total };
+  },
+  getOne: async ({ id }) => ({ data: await instrumentDataApi.get(String(id)) }),
+  create: async ({ variables }) => ({
+    data: await instrumentDataApi.create(variables as Partial<InstrumentRecord>),
+  }),
+  update: async ({ id, variables, meta }) => ({
+    data: await instrumentDataApi.update(
+      String(id),
+      Number(meta?.expectedRevision),
+      variables as Partial<InstrumentRecord>
+    ),
+  }),
+  deleteOne: async ({ id, meta }) => ({
+    data: await instrumentDataApi.remove(
+      String(id),
+      Number(meta?.expectedRevision)
+    ),
+  }),
+} as DataProvider;

package/template/apps/web/src/fields.ts

@@ -0,0 +1,72 @@
+export type FieldKind =
+  | 'text'
+  | 'textarea'
+  | 'number'
+  | 'date'
+  | 'boolean'
+  | 'select'
+  | 'multi'
+  | 'email'
+  | 'phone'
+  | 'file';
+
+export interface InstrumentField {
+  key: string;
+  label: string;
+  kind: FieldKind;
+  section: keyof typeof sectionTitles;
+  required?: boolean;
+  system?: boolean;
+  createCapability?: string;
+  updateCapability?: string;
+  multiple?: boolean;
+  maxCount?: number;
+  accept?: string;
+  options?: Array<{ label: string; value: string }>;
+}
+
+const options = (pairs: Array<[string, string]>) =>
+  pairs.map(([label, value]) => ({ label, value }));
+
+export const sectionTitles = {
+  basic: '基本信息',
+  asset: '资产信息',
+  usage: '使用与归属',
+  management: '管理与联系',
+  materials: '地址与资料',
+} as const;
+
+// 30 fields: id/revision are Data API system fields; the remaining 28 are
+// declared by platform/data/instruments.ts.
+export const instrumentFields: InstrumentField[] = [
+  { key: 'id', label: '记录 ID', kind: 'text', section: 'basic', system: true },
+  { key: 'revision', label: '修订版本', kind: 'number', section: 'basic', system: true },
+  { key: 'instrumentCode', label: '仪器编码', kind: 'text', section: 'basic', required: true, createCapability: 'app:instrument-center:instrument:field:instrument-code:create', updateCapability: 'app:instrument-center:instrument:field:instrument-code:update' },
+  { key: 'chineseName', label: '仪器中文名', kind: 'text', section: 'basic', required: true },
+  { key: 'englishName', label: '仪器英文名', kind: 'text', section: 'basic' },
+  { key: 'aliasName', label: '别名', kind: 'text', section: 'basic' },
+  { key: 'image', label: '仪器图片', kind: 'file', section: 'basic', maxCount: 1, accept: 'image/*' },
+  { key: 'specModel', label: '规格型号', kind: 'text', section: 'basic', required: true },
+  { key: 'categoryId', label: '仪器分类', kind: 'select', section: 'basic', required: true, options: options([['显微成像', 'analysis_microscope'], ['光谱分析', 'analysis_spectrum'], ['色谱质谱', 'analysis_ms']]) },
+  { key: 'instrumentSource', label: '仪器来源', kind: 'select', section: 'basic', options: options([['购置', 'purchase'], ['捐赠', 'donation'], ['调拨', 'transfer']]) },
+  { key: 'manufacturer', label: '制造商', kind: 'text', section: 'basic' },
+  { key: 'assetCode', label: '资产编码', kind: 'text', section: 'asset', required: true, createCapability: 'app:instrument-center:instrument:field:asset-code:create', updateCapability: 'app:instrument-center:instrument:field:asset-code:update' },
+  { key: 'assetValue', label: '资产价值（元）', kind: 'number', section: 'asset', createCapability: 'app:instrument-center:instrument:field:asset-value:create', updateCapability: 'app:instrument-center:instrument:field:asset-value:update' },
+  { key: 'enabledDate', label: '启用日期', kind: 'date', section: 'asset', required: true },
+  { key: 'usageStatus', label: '使用状况', kind: 'select', section: 'usage', required: true, options: options([['在用', 'active'], ['闲置', 'idle'], ['借出', 'lent']]) },
+  { key: 'instrumentStatus', label: '仪器状态', kind: 'select', section: 'usage', required: true, options: options([['正常', 'normal'], ['维修', 'maintenance'], ['停用', 'disabled'], ['报废', 'scrapped']]) },
+  { key: 'openToOutside', label: '是否对外开放', kind: 'boolean', section: 'usage', required: true },
+  { key: 'subjectAreas', label: '学科领域', kind: 'multi', section: 'usage', options: options([['材料', 'material'], ['生命科学', 'life'], ['化学', 'chemistry'], ['物理', 'physics']]) },
+  { key: 'platformProperty', label: '平台属性', kind: 'select', section: 'usage', options: options([['共享平台设备', 'shared'], ['课题组设备', 'research']]) },
+  { key: 'collegeId', label: '所属学院', kind: 'select', section: 'usage', required: true, createCapability: 'app:instrument-center:instrument:field:college-id:create', updateCapability: 'app:instrument-center:instrument:field:college-id:update', options: options([['先进材料学院', 'college-am'], ['生命健康学院', 'college-lh'], ['公共测试中心', 'college-pt']]) },
+  { key: 'manageDepartmentId', label: '管理部门', kind: 'select', section: 'management', required: true, options: options([['材料测试中心', 'dept-am-test'], ['生命平台中心', 'dept-lh-core'], ['公共测试中心', 'dept-public']]) },
+  { key: 'useDepartmentId', label: '使用部门', kind: 'select', section: 'management', required: true, options: options([['材料测试中心', 'dept-am-test'], ['生命平台中心', 'dept-lh-core'], ['公共测试中心', 'dept-public']]) },
+  { key: 'instrumentAdminIds', label: '仪器管理员', kind: 'multi', section: 'management', required: true, createCapability: 'app:instrument-center:instrument:field:instrument-admin-ids:create', updateCapability: 'app:instrument-center:instrument:field:instrument-admin-ids:update', options: options([['王老师', 'user-wang'], ['李老师', 'user-li'], ['陈老师', 'user-chen']]) },
+  { key: 'contactUserIds', label: '联系人', kind: 'multi', section: 'management', required: true, options: options([['王老师', 'user-wang'], ['李老师', 'user-li'], ['陈老师', 'user-chen']]) },
+  { key: 'contactPhone', label: '联系电话', kind: 'phone', section: 'management', required: true },
+  { key: 'contactEmail', label: '联系邮箱', kind: 'email', section: 'management' },
+  { key: 'locationId', label: '存放点', kind: 'select', section: 'materials', options: options([['A 区 101', 'A-101'], ['B 区 203', 'B-203']]) },
+  { key: 'address', label: '详细地址', kind: 'textarea', section: 'materials' },
+  { key: 'serviceContent', label: '服务内容与主要功能', kind: 'textarea', section: 'materials' },
+  { key: 'attachments', label: '仪器资料', kind: 'file', section: 'materials', multiple: true, maxCount: 8 },
+];

package/template/apps/web/src/instrument.ts

@@ -0,0 +1,55 @@
+import type { DataFileRef } from 'openxiangda-contracts/browser';
+
+export interface InstrumentRecord extends Record<string, unknown> {
+  id: string;
+  revision: number;
+  instrumentCode: string;
+  chineseName: string;
+  englishName?: string;
+  aliasName?: string;
+  image?: DataFileRef | null;
+  specModel: string;
+  categoryId: string;
+  instrumentSource?: string;
+  manufacturer?: string;
+  assetCode: string;
+  assetValue?: number;
+  enabledDate: string;
+  usageStatus: string;
+  instrumentStatus: string;
+  openToOutside: boolean;
+  subjectAreas?: string[];
+  platformProperty?: string;
+  collegeId: string;
+  manageDepartmentId: string;
+  useDepartmentId: string;
+  instrumentAdminIds: string[];
+  contactUserIds: string[];
+  contactPhone: string;
+  contactEmail?: string;
+  locationId?: string;
+  address?: string;
+  serviceContent?: string;
+  attachments?: DataFileRef[];
+  updatedAt?: string;
+}
+
+export interface InstrumentListQuery {
+  page: number;
+  pageSize: number;
+  keyword?: string;
+  collegeId?: string;
+  instrumentAdminId?: string;
+  instrumentStatus?: string;
+  openToOutside?: boolean;
+  enabledDate?: [string, string];
+  assetValue?: [number | undefined, number | undefined];
+  sort?: { field: string; order: 'asc' | 'desc' };
+}
+
+export const INSTRUMENT_CAPABILITIES = {
+  read: 'app:instrument-center:data:instruments:read',
+  create: 'app:instrument-center:data:instruments:create',
+  update: 'app:instrument-center:data:instruments:update',
+  delete: 'app:instrument-center:data:instruments:delete',
+} as const;

package/template/apps/web/src/main.tsx

@@ -0,0 +1,58 @@
+import { Refine } from '@refinedev/core';
+import { App as AntdApp, ConfigProvider } from 'antd';
+import zhCN from 'antd/locale/zh_CN';
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import { BrowserRouter, Navigate, Route, Routes } from 'react-router-dom';
+import { instrumentProvider } from './data-provider';
+import { InstrumentDetailPage } from './InstrumentDetailPage';
+import { InstrumentFormPage } from './InstrumentFormPage';
+import { InstrumentListPage } from './InstrumentListPage';
+import { RuntimeBoundary } from './runtime';
+import { applicationBasename } from './runtime-meta';
+import './styles.css';
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+  <React.StrictMode>
+    <ConfigProvider
+      locale={zhCN}
+      theme={{ token: { borderRadius: 6, colorPrimary: '#1677ff' } }}
+    >
+      <AntdApp>
+        <RuntimeBoundary>
+          <BrowserRouter basename={applicationBasename()}>
+            <Refine
+              dataProvider={instrumentProvider}
+              resources={[
+                {
+                  name: 'instruments',
+                  list: '/instruments',
+                  create: '/instruments/new',
+                  edit: '/instruments/:id/edit',
+                  show: '/instruments/:id',
+                },
+              ]}
+            >
+              <Routes>
+                <Route path="/" element={<Navigate replace to="/instruments" />} />
+                <Route path="/instruments" element={<InstrumentListPage />} />
+                <Route
+                  path="/instruments/new"
+                  element={<InstrumentFormPage mode="create" />}
+                />
+                <Route
+                  path="/instruments/:id/edit"
+                  element={<InstrumentFormPage mode="edit" />}
+                />
+                <Route
+                  path="/instruments/:id"
+                  element={<InstrumentDetailPage />}
+                />
+              </Routes>
+            </Refine>
+          </BrowserRouter>
+        </RuntimeBoundary>
+      </AntdApp>
+    </ConfigProvider>
+  </React.StrictMode>
+);