Merge branch 'master' of http://124.243.245.42:3000/sh/shz-admin

config/routes.ts

@@ -246,6 +246,11 @@ export default [
         path: '/jobfair/outdoor-fair/detail',
         component: './Jobfair/Outdoorfair/Detail',
       },
+      {
+        name: '招聘会数据统计',
+        path: '/jobfair/fair-statistics',
+        component: './Jobfair/FairStatistics',
+      },
       {
         name: '跨域联合招聘会管理',
         path: '/jobfair/cross-city-fair',

src/pages/Jobfair/FairStatistics/index.tsx

@@ -0,0 +1,209 @@
+import React, { useEffect, useMemo, useState } from 'react';
+import {
+  Card,
+  Col,
+  DatePicker,
+  Empty,
+  Row,
+  Segmented,
+  Spin,
+  Statistic,
+  Table,
+  Typography,
+  message,
+} from 'antd';
+import { ArrowDownOutlined, ArrowUpOutlined } from '@ant-design/icons';
+import { PageContainer } from '@ant-design/pro-components';
+import { Line } from '@ant-design/charts';
+import type { ColumnsType } from 'antd/es/table';
+import { getOutdoorFairStatistics } from '@/services/jobportal/outdoorFair';
+import type {
+  OutdoorFairStatisticsResult,
+  OutdoorFairStatisticsSeriesItem,
+} from '@/services/jobportal/outdoorFair';
+
+const { RangePicker } = DatePicker;
+const { Text } = Typography;
+
+type Granularity = 'day' | 'week' | 'month' | 'year';
+
+const GRAN_OPTIONS: { label: string; value: Granularity }[] = [
+  { label: '按日', value: 'day' },
+  { label: '按周', value: 'week' },
+  { label: '按月', value: 'month' },
+  { label: '按年', value: 'year' },
+];
+
+const formatBound = (value: any, suffix: string): string | undefined => {
+  if (value && typeof value.format === 'function') {
+    return `${value.format('YYYY-MM-DD')} ${suffix}`;
+  }
+  return undefined;
+};
+
+const FairStatistics: React.FC = () => {
+  const [granularity, setGranularity] = useState<Granularity>('month');
+  const [dateRange, setDateRange] = useState<any>(null);
+  const [loading, setLoading] = useState(false);
+  const [result, setResult] = useState<OutdoorFairStatisticsResult | null>(null);
+
+  const fetchStats = async (gran: Granularity, range: any) => {
+    setLoading(true);
+    try {
+      const res = await getOutdoorFairStatistics({
+        granularity: gran,
+        startTime: formatBound(range?.[0], '00:00:00'),
+        endTime: formatBound(range?.[1], '23:59:59'),
+      });
+      if (res?.code === 200 && res.data) {
+        setResult(res.data);
+      } else {
+        message.error(res?.msg || '统计失败');
+      }
+    } catch (e) {
+      message.error('统计失败');
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  // 粒度或日期变化即查询；区间半选（只选了一端）不查询，避免中途无效查询
+  useEffect(() => {
+    const complete = dateRange && dateRange[0] && dateRange[1];
+    const empty = !dateRange || (!dateRange[0] && !dateRange[1]);
+    if (complete) {
+      fetchStats(granularity, dateRange);
+    } else if (empty) {
+      fetchStats(granularity, null);
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [granularity, dateRange]);
+
+  const chartData = useMemo(() => {
+    if (!result?.series) return [];
+    const rows: { time: string; category: string; value: number }[] = [];
+    result.series.forEach((item: OutdoorFairStatisticsSeriesItem) => {
+      rows.push({ time: item.time, category: '招聘会数', value: item.fairCount });
+      rows.push({ time: item.time, category: '参会单位数', value: item.companyCount });
+      rows.push({ time: item.time, category: '职位数', value: item.jobCount });
+    });
+    return rows;
+  }, [result]);
+
+  const columns: ColumnsType<OutdoorFairStatisticsSeriesItem> = [
+    { title: '时间', dataIndex: 'time', width: 140 },
+    { title: '招聘会数', dataIndex: 'fairCount', width: 120 },
+    { title: '参会单位数', dataIndex: 'companyCount', width: 120 },
+    { title: '职位数', dataIndex: 'jobCount', width: 120 },
+  ];
+
+  return (
+    <PageContainer
+      header={{ title: '招聘会数据统计' }}
+      content="按年/周/月/日维度统计时间区间内的招聘会趋势，含累计发布招聘会数及同比、环比。"
+    >
+      <Card style={{ marginBottom: 16 }}>
+        <Row gutter={16} align="middle">
+          <Col>
+            <span style={{ marginRight: 8 }}>统计粒度</span>
+            <Segmented
+              value={granularity}
+              onChange={(v) => setGranularity(v as Granularity)}
+              options={GRAN_OPTIONS}
+            />
+          </Col>
+          <Col flex="auto">
+            <span style={{ marginRight: 8, marginLeft: 16 }}>时间区间</span>
+            <RangePicker
+              value={dateRange}
+              onChange={(v) => setDateRange(v)}
+              style={{ width: 360 }}
+            />
+          </Col>
+        </Row>
+      </Card>
+
+      <Spin spinning={loading}>
+        {result ? (
+          <>
+            <Row gutter={16} style={{ marginBottom: 16 }}>
+              <Col span={8}>
+                <Card>
+                  <Statistic title="累计发布招聘会数" value={result.totals.fairCount} />
+                  <div style={{ marginTop: 8 }}>
+                    <RateText label="同比" rate={result.yoy?.rate} />
+                    <span style={{ marginLeft: 16 }}>
+                      <RateText label="环比" rate={result.mom?.rate} />
+                    </span>
+                  </div>
+                </Card>
+              </Col>
+              <Col span={8}>
+                <Card>
+                  <Statistic title="参会单位数" value={result.totals.companyCount} />
+                </Card>
+              </Col>
+              <Col span={8}>
+                <Card>
+                  <Statistic title="职位数" value={result.totals.jobCount} />
+                </Card>
+              </Col>
+            </Row>
+
+            <Card title="招聘会趋势" style={{ marginBottom: 16 }} bodyStyle={{ padding: 12 }}>
+              {chartData.length > 0 ? (
+                <Line
+                  height={320}
+                  data={chartData}
+                  xField="time"
+                  yField="value"
+                  seriesField="category"
+                  smooth
+                  legend={{ position: 'bottom' }}
+                  tooltip={{
+                    fields: ['value'],
+                  }}
+                />
+              ) : (
+                <Empty description="所选区间无数据" />
+              )}
+            </Card>
+
+            <Card title="分时段明细" bordered={false}>
+              <Table<OutdoorFairStatisticsSeriesItem>
+                rowKey="time"
+                dataSource={result.series || []}
+                columns={columns}
+                pagination={false}
+                size="small"
+              />
+            </Card>
+          </>
+        ) : (
+          <Empty description="暂无数据" />
+        )}
+      </Spin>
+    </PageContainer>
+  );
+};
+
+const RateText: React.FC<{ label: string; rate?: number | null }> = ({ label, rate }) => {
+  if (rate === null || rate === undefined) {
+    return (
+      <Text type="secondary">
+        {label}：--
+      </Text>
+    );
+  }
+  const up = rate >= 0;
+  const color = up ? '#cf1322' : '#3f8600';
+  const pct = `${(rate * 100).toFixed(1)}%`;
+  return (
+    <Text style={{ color }}>
+      {label}：
+      {up ? <ArrowUpOutlined /> : <ArrowDownOutlined />} {pct}
+    </Text>
+  );
+};
+
+export default FairStatistics;

src/pages/Jobfair/Outdoorfair/Detail/components/AttendeeTab.tsx

@@ -0,0 +1,174 @@
+import React, { useRef, useState } from 'react';
+import { useAccess } from '@umijs/max';
+import { Button, Modal, message } from 'antd';
+import { ActionType, ProColumns, ProTable, ModalForm, ProFormText, ProFormDateTimePicker } from '@ant-design/pro-components';
+import { PlusOutlined, DeleteOutlined, EditOutlined } from '@ant-design/icons';
+import {
+  getOutdoorFairAttendeeList,
+  addOutdoorFairAttendee,
+  updateOutdoorFairAttendee,
+  deleteOutdoorFairAttendee,
+} from '@/services/jobportal/outdoorFairAttendee';
+import type {
+  OutdoorFairAttendeeItem,
+  OutdoorFairAttendeeForm,
+} from '@/services/jobportal/outdoorFairAttendee';
+
+interface Props {
+  fairId: number;
+}
+
+const AttendeeTab: React.FC<Props> = ({ fairId }) => {
+  const access = useAccess();
+  const actionRef = useRef<ActionType>();
+  const [modalVisible, setModalVisible] = useState(false);
+  const [currentRow, setCurrentRow] = useState<OutdoorFairAttendeeItem>();
+
+  const handleDelete = (id: number) => {
+    Modal.confirm({
+      title: '确认删除',
+      content: '确定要删除该签到人员吗？',
+      onOk: async () => {
+        const res = await deleteOutdoorFairAttendee(id);
+        if (res.code === 200) {
+          message.success('删除成功');
+          actionRef.current?.reload();
+        } else {
+          message.error(res.msg || '删除失败');
+        }
+      },
+    });
+  };
+
+  const columns: ProColumns<OutdoorFairAttendeeItem>[] = [
+    { title: '人员', dataIndex: 'name', ellipsis: true },
+    { title: '手机号', dataIndex: 'phone', ellipsis: true, hideInSearch: true },
+    { title: '住址', dataIndex: 'address', ellipsis: true, hideInSearch: true },
+    {
+      title: '签到时间',
+      dataIndex: 'checkInTime',
+      valueType: 'dateTime',
+      hideInSearch: true,
+    },
+    {
+      title: '操作',
+      valueType: 'option',
+      width: 160,
+      fixed: 'right',
+      render: (_, record) => [
+        <Button
+          key="edit"
+          type="link"
+          size="small"
+          icon={<EditOutlined />}
+          hidden={!access.hasPerms('cms:outdoorFair:edit')}
+          onClick={() => {
+            setCurrentRow(record);
+            setModalVisible(true);
+          }}
+        >
+          编辑
+        </Button>,
+        <Button
+          key="delete"
+          type="link"
+          size="small"
+          danger
+          icon={<DeleteOutlined />}
+          hidden={!access.hasPerms('cms:outdoorFair:remove')}
+          onClick={() => handleDelete(record.id)}
+        >
+          删除
+        </Button>,
+      ],
+    },
+  ];
+
+  return (
+    <>
+      <ProTable<OutdoorFairAttendeeItem>
+        actionRef={actionRef}
+        rowKey="id"
+        headerTitle="参会人员管理"
+        search={{ labelWidth: 'auto' }}
+        options={false}
+        pagination={{ pageSize: 10 }}
+        scroll={{ x: 'max-content' }}
+        toolBarRender={() => [
+          <Button
+            key="add"
+            type="primary"
+            icon={<PlusOutlined />}
+            hidden={!access.hasPerms('cms:outdoorFair:add')}
+            onClick={() => {
+              setCurrentRow(undefined);
+              setModalVisible(true);
+            }}
+          >
+            录入签到人员
+          </Button>,
+        ]}
+        request={async (params) => {
+          const res = await getOutdoorFairAttendeeList({
+            fairId,
+            current: params.current,
+            pageSize: params.pageSize,
+            name: params.name,
+          });
+          return { data: res.rows || [], total: res.total || 0, success: res.code === 200 };
+        }}
+        columns={columns}
+      />
+
+      <ModalForm<OutdoorFairAttendeeForm>
+        title={currentRow ? '编辑签到人员' : '录入签到人员'}
+        open={modalVisible}
+        modalProps={{ destroyOnClose: true, onCancel: () => setModalVisible(false) }}
+        initialValues={
+          currentRow
+            ? {
+                id: currentRow.id,
+                fairId,
+                name: currentRow.name,
+                phone: currentRow.phone,
+                address: currentRow.address,
+                checkInTime: currentRow.checkInTime,
+              }
+            : { fairId }
+        }
+        onFinish={async (values) => {
+          const payload = { ...values, fairId };
+          const res = values.id
+            ? await updateOutdoorFairAttendee(payload)
+            : await addOutdoorFairAttendee(payload);
+          if (res.code === 200) {
+            message.success(values.id ? '修改成功' : '新增成功');
+            setModalVisible(false);
+            setCurrentRow(undefined);
+            actionRef.current?.reload();
+            return true;
+          }
+          message.error(res.msg || '操作失败');
+          return false;
+        }}
+      >
+        <ProFormText
+          name="name"
+          label="人员"
+          placeholder="请输入人员姓名"
+          rules={[{ required: true, message: '请输入人员姓名' }]}
+        />
+        <ProFormText name="phone" label="手机号" placeholder="请输入手机号" />
+        <ProFormText name="address" label="住址" placeholder="请输入住址" />
+        <ProFormDateTimePicker
+          name="checkInTime"
+          label="签到时间"
+          placeholder="请选择签到时间"
+          fieldProps={{ style: { width: '100%' } }}
+        />
+      </ModalForm>
+    </>
+  );
+};
+
+export default AttendeeTab;

src/pages/Jobfair/Outdoorfair/Detail/components/DeviceTab.tsx

@@ -0,0 +1,249 @@
+import React, { useRef, useState } from 'react';
+import { useAccess } from '@umijs/max';
+import { Button, Modal, message, Typography } from 'antd';
+import {
+  ActionType,
+  ProColumns,
+  ProTable,
+  ModalForm,
+  ProFormDigit,
+  ProFormSelect,
+} from '@ant-design/pro-components';
+import { PlusOutlined, DeleteOutlined, LinkOutlined, DisconnectOutlined } from '@ant-design/icons';
+import {
+  getOutdoorFairDeviceList,
+  batchGenerateOutdoorFairDevice,
+  bindOutdoorFairDevice,
+  deleteOutdoorFairDevice,
+  getOutdoorFairCompanyOptions,
+} from '@/services/jobportal/outdoorFairDevice';
+import type { OutdoorFairDeviceItem } from '@/services/jobportal/outdoorFairDevice';
+
+interface Props {
+  fairId: number;
+}
+
+const DeviceTab: React.FC<Props> = ({ fairId }) => {
+  const access = useAccess();
+  const actionRef = useRef<ActionType>();
+  const [batchVisible, setBatchVisible] = useState(false);
+  const [bindVisible, setBindVisible] = useState(false);
+  const [currentRow, setCurrentRow] = useState<OutdoorFairDeviceItem>();
+
+  const handleDelete = (id: number) => {
+    Modal.confirm({
+      title: '确认删除',
+      content: '确定要删除该设备码吗？',
+      onOk: async () => {
+        const res = await deleteOutdoorFairDevice(id);
+        if (res.code === 200) {
+          message.success('删除成功');
+          actionRef.current?.reload();
+        } else {
+          message.error(res.msg || '删除失败');
+        }
+      },
+    });
+  };
+
+  const handleUnbind = (record: OutdoorFairDeviceItem) => {
+    Modal.confirm({
+      title: '确认解绑',
+      content: `确定要解除设备码与「${record.companyName}」的绑定吗？`,
+      onOk: async () => {
+        const res = await bindOutdoorFairDevice(record.id, undefined);
+        if (res.code === 200) {
+          message.success('解绑成功');
+          actionRef.current?.reload();
+        } else {
+          message.error(res.msg || '解绑失败');
+        }
+      },
+    });
+  };
+
+  const columns: ProColumns<OutdoorFairDeviceItem>[] = [
+    {
+      title: '设备码',
+      dataIndex: 'deviceCode',
+      ellipsis: true,
+      render: (_, record) => (
+        <Typography.Text copyable code>
+          {record.deviceCode}
+        </Typography.Text>
+      ),
+    },
+    {
+      title: '绑定企业',
+      dataIndex: 'companyName',
+      ellipsis: true,
+      hideInSearch: true,
+      render: (_, record) => (record.companyName ? record.companyName : '— 未绑定 —'),
+    },
+    {
+      title: '绑定时间',
+      dataIndex: 'bindTime',
+      valueType: 'dateTime',
+      hideInSearch: true,
+    },
+    {
+      title: '操作',
+      valueType: 'option',
+      width: 200,
+      fixed: 'right',
+      render: (_, record) => [
+        record.companyId ? (
+          <Button
+            key="unbind"
+            type="link"
+            size="small"
+            icon={<DisconnectOutlined />}
+            hidden={!access.hasPerms('cms:outdoorFair:edit')}
+            onClick={() => handleUnbind(record)}
+          >
+            解绑
+          </Button>
+        ) : (
+          <Button
+            key="bind"
+            type="link"
+            size="small"
+            icon={<LinkOutlined />}
+            hidden={!access.hasPerms('cms:outdoorFair:edit')}
+            onClick={() => {
+              setCurrentRow(record);
+              setBindVisible(true);
+            }}
+          >
+            绑定企业
+          </Button>
+        ),
+        <Button
+          key="delete"
+          type="link"
+          size="small"
+          danger
+          icon={<DeleteOutlined />}
+          hidden={!access.hasPerms('cms:outdoorFair:remove')}
+          onClick={() => handleDelete(record.id)}
+        >
+          删除
+        </Button>,
+      ],
+    },
+  ];
+
+  return (
+    <>
+      <ProTable<OutdoorFairDeviceItem>
+        actionRef={actionRef}
+        rowKey="id"
+        headerTitle="设备管理"
+        search={{ labelWidth: 'auto' }}
+        options={false}
+        pagination={{ pageSize: 10 }}
+        scroll={{ x: 'max-content' }}
+        toolBarRender={() => [
+          <Button
+            key="batch"
+            type="primary"
+            icon={<PlusOutlined />}
+            hidden={!access.hasPerms('cms:outdoorFair:add')}
+            onClick={() => setBatchVisible(true)}
+          >
+            批量生成设备码
+          </Button>,
+        ]}
+        request={async (params) => {
+          const res = await getOutdoorFairDeviceList({
+            fairId,
+            current: params.current,
+            pageSize: params.pageSize,
+            deviceCode: params.deviceCode,
+            companyName: params.companyName,
+          });
+          return { data: res.rows || [], total: res.total || 0, success: res.code === 200 };
+        }}
+        columns={columns}
+      />
+
+      <ModalForm<{ quantity: number }>
+        title="批量生成设备码"
+        open={batchVisible}
+        modalProps={{ destroyOnClose: true, onCancel: () => setBatchVisible(false) }}
+        initialValues={{ quantity: 10 }}
+        onFinish={async (values) => {
+          const res = await batchGenerateOutdoorFairDevice({
+            fairId,
+            quantity: Number(values.quantity),
+          });
+          if (res.code === 200) {
+            message.success(`成功生成 ${res.data?.length || values.quantity} 个设备码`);
+            setBatchVisible(false);
+            actionRef.current?.reload();
+            return true;
+          }
+          message.error(res.msg || '生成失败');
+          return false;
+        }}
+      >
+        <ProFormDigit
+          name="quantity"
+          label="生成数量"
+          placeholder="请输入需要生成的设备码数量"
+          min={1}
+          max={1000}
+          fieldProps={{ precision: 0 }}
+          rules={[{ required: true, message: '请输入生成数量' }]}
+        />
+      </ModalForm>
+
+      <ModalForm<{ companyId: number }>
+        title="绑定参会企业"
+        open={bindVisible}
+        modalProps={{ destroyOnClose: true, onCancel: () => setBindVisible(false) }}
+        onFinish={async (values) => {
+          if (!currentRow) return false;
+          const res = await bindOutdoorFairDevice(currentRow.id, values.companyId);
+          if (res.code === 200) {
+            message.success('绑定成功');
+            setBindVisible(false);
+            setCurrentRow(undefined);
+            actionRef.current?.reload();
+            return true;
+          }
+          message.error(res.msg || '绑定失败');
+          return false;
+        }}
+      >
+        <ProFormSelect
+          name="companyId"
+          label="参会企业"
+          placeholder="请选择参会企业"
+          showSearch
+          request={async () => {
+            const [companies, devicesRes] = await Promise.all([
+              getOutdoorFairCompanyOptions(fairId),
+              getOutdoorFairDeviceList({ fairId, current: 1, pageSize: 1000 }),
+            ]);
+            // 排除已绑定到其他设备的企业
+            const boundIds = new Set(
+              (devicesRes.rows || [])
+                .map((d) => d.companyId)
+                .filter((cid): cid is number => cid != null),
+            );
+            return companies
+              .filter((item) => !boundIds.has(item.companyId))
+              .map((item) => ({
+                label: item.companyName,
+                value: item.companyId,
+              }));
+          }}
+          rules={[{ required: true, message: '请选择参会企业' }]}
+        />
+      </ModalForm>
+    </>
+  );
+};
+
+export default DeviceTab;

src/pages/Jobfair/Outdoorfair/Detail/index.tsx

@@ -9,6 +9,8 @@ import FairInfoTab from './components/FairInfoTab';
 import BoothTab from './components/BoothTab';
 import ParticipatingCompaniesTab from './components/ParticipatingCompaniesTab';
 import ParticipatingJobsTab from './components/ParticipatingJobsTab';
+import AttendeeTab from './components/AttendeeTab';
+import DeviceTab from './components/DeviceTab';
 
 const OutdoorFairDetail: React.FC = () => {
   const [searchParams] = useSearchParams();
@@ -41,6 +43,8 @@ const OutdoorFairDetail: React.FC = () => {
     { key: 'fair-info', label: '招聘会管理' },
     { key: 'participating-companies', label: '参会企业' },
     { key: 'participating-jobs', label: '参会岗位' },
+    { key: 'attendee', label: '参会人员管理' },
+    { key: 'device', label: '设备管理' },
     { key: 'booth', label: '展位图' },
   ];
 
@@ -84,6 +88,10 @@ const OutdoorFairDetail: React.FC = () => {
                     return <ParticipatingCompaniesTab fairId={fairId} />;
                   case 'participating-jobs':
                     return <ParticipatingJobsTab fairId={fairId} />;
+                  case 'attendee':
+                    return <AttendeeTab fairId={fairId} />;
+                  case 'device':
+                    return <DeviceTab fairId={fairId} />;
                   default:
                     return null;
                 }

src/services/jobportal/outdoorFair.ts

@@ -129,6 +129,53 @@ export async function getOutdoorFairInfo(id: number) {
   });
 }
 
+/** 招聘会统计-时间桶序列项（曲线图用） */
+export interface OutdoorFairStatisticsSeriesItem {
+  time: string;
+  fairCount: number;
+  companyCount: number;
+  jobCount: number;
+}
+
+/** 招聘会数同比/环比 */
+export interface OutdoorFairStatisticsRate {
+  fairCount: number;
+  previousFairCount: number;
+  /** 增长率：(current-previous)/previous；上期为 0 时为 null */
+  rate?: number | null;
+}
+
+/** 招聘会统计结果（dashboard） */
+export interface OutdoorFairStatisticsResult {
+  granularity: 'day' | 'week' | 'month' | 'year';
+  totals: { fairCount: number; companyCount: number; jobCount: number };
+  yoy: OutdoorFairStatisticsRate;
+  mom: OutdoorFairStatisticsRate;
+  series: OutdoorFairStatisticsSeriesItem[];
+}
+
+/** 招聘会统计查询参数 */
+export interface OutdoorFairStatisticsParams {
+  /** 粒度：day/week/month/year */
+  granularity?: 'day' | 'week' | 'month' | 'year';
+  /** 起始时间 yyyy-MM-dd HH:mm:ss */
+  startTime?: string;
+  /** 截止时间 yyyy-MM-dd HH:mm:ss */
+  endTime?: string;
+}
+
+/**
+ * 招聘会数据统计
+ * GET /api/cms/outdoor-fair/statistics
+ * skipErrorHandler: 由调用方自行处理错误，避免全局弹窗把 null msg 显示成 "null"
+ */
+export async function getOutdoorFairStatistics(params: OutdoorFairStatisticsParams) {
+  return request<{ code: number; msg?: string; data: OutdoorFairStatisticsResult }>(
+    `${CMS_OUTDOOR_FAIR_BASE}/statistics`,
+    { method: 'GET', params, skipErrorHandler: true },
+  );
+}
+
 /**
  * 新增户外招聘会
  * POST /api/cms/outdoor-fair

src/services/jobportal/outdoorFairAttendee.ts

@@ -0,0 +1,106 @@
+import { request } from '@umijs/max';
+
+/** 户外招聘会签到人员列表项 */
+export interface OutdoorFairAttendeeItem {
+  id: number;
+  fairId: number;
+  /** 人员姓名 */
+  name: string;
+  /** 手机号 */
+  phone?: string;
+  /** 住址 */
+  address?: string;
+  /** 签到时间 */
+  checkInTime?: string;
+  createBy?: string;
+  createTime?: string;
+  updateBy?: string;
+  updateTime?: string;
+  remark?: string;
+}
+
+/** 签到人员查询参数 */
+export interface OutdoorFairAttendeeListParams {
+  fairId?: number;
+  name?: string;
+  phone?: string;
+  current?: number;
+  pageSize?: number;
+}
+
+/** 签到人员列表响应 */
+export interface OutdoorFairAttendeeListResult {
+  code: number;
+  msg?: string;
+  total: number;
+  rows: OutdoorFairAttendeeItem[];
+}
+
+/** 签到人员新增/编辑表单 */
+export interface OutdoorFairAttendeeForm {
+  id?: number;
+  fairId: number;
+  name: string;
+  phone?: string;
+  address?: string;
+  checkInTime?: string;
+}
+
+/** 通用响应 */
+export interface OutdoorFairAttendeeCommonResult {
+  code: number;
+  msg?: string;
+  data?: OutdoorFairAttendeeItem;
+}
+
+const BASE = '/api/cms/outdoor-fair-attendee';
+
+const formatDateTime = (value: any) => {
+  if (value && typeof value.format === 'function') {
+    return value.format('YYYY-MM-DD HH:mm:ss');
+  }
+  return value;
+};
+
+/**
+ * 获取签到人员列表
+ * GET /api/cms/outdoor-fair-attendee/list
+ */
+export async function getOutdoorFairAttendeeList(params?: OutdoorFairAttendeeListParams) {
+  return request<OutdoorFairAttendeeListResult>(`${BASE}/list`, {
+    method: 'GET',
+    params,
+  });
+}
+
+/**
+ * 新增签到人员
+ * POST /api/cms/outdoor-fair-attendee
+ */
+export async function addOutdoorFairAttendee(data: OutdoorFairAttendeeForm) {
+  return request<OutdoorFairAttendeeCommonResult>(BASE, {
+    method: 'POST',
+    data: { ...data, checkInTime: formatDateTime(data.checkInTime) },
+  });
+}
+
+/**
+ * 修改签到人员
+ * PUT /api/cms/outdoor-fair-attendee
+ */
+export async function updateOutdoorFairAttendee(data: OutdoorFairAttendeeForm) {
+  return request<OutdoorFairAttendeeCommonResult>(BASE, {
+    method: 'PUT',
+    data: { ...data, checkInTime: formatDateTime(data.checkInTime) },
+  });
+}
+
+/**
+ * 删除签到人员
+ * DELETE /api/cms/outdoor-fair-attendee/{ids}
+ */
+export async function deleteOutdoorFairAttendee(ids: number | string) {
+  return request<OutdoorFairAttendeeCommonResult>(`${BASE}/${ids}`, {
+    method: 'DELETE',
+  });
+}

src/services/jobportal/outdoorFairDevice.ts

@@ -0,0 +1,130 @@
+import { request } from '@umijs/max';
+
+/** 户外招聘会设备码列表项 */
+export interface OutdoorFairDeviceItem {
+  id: number;
+  fairId: number;
+  /** 设备码（UUID） */
+  deviceCode: string;
+  /** 绑定的参会企业ID */
+  companyId?: number;
+  /** 绑定的参会企业名称 */
+  companyName?: string;
+  /** 绑定时间 */
+  bindTime?: string;
+  createBy?: string;
+  createTime?: string;
+  updateBy?: string;
+  updateTime?: string;
+  remark?: string;
+}
+
+/** 设备码查询参数 */
+export interface OutdoorFairDeviceListParams {
+  fairId?: number;
+  deviceCode?: string;
+  companyName?: string;
+  companyId?: number;
+  current?: number;
+  pageSize?: number;
+}
+
+/** 设备码列表响应 */
+export interface OutdoorFairDeviceListResult {
+  code: number;
+  msg?: string;
+  total: number;
+  rows: OutdoorFairDeviceItem[];
+}
+
+/** 批量生成参数 */
+export interface OutdoorFairDeviceBatchParams {
+  fairId: number;
+  quantity: number;
+}
+
+/** 批量生成响应 */
+export interface OutdoorFairDeviceBatchResult {
+  code: number;
+  msg?: string;
+  data?: OutdoorFairDeviceItem[];
+}
+
+/** 通用响应 */
+export interface OutdoorFairDeviceCommonResult {
+  code: number;
+  msg?: string;
+  data?: OutdoorFairDeviceItem;
+}
+
+/** 参会企业下拉选项 */
+export interface OutdoorFairCompanyOption {
+  companyId: number;
+  companyName: string;
+}
+
+const BASE = '/api/cms/outdoor-fair-device';
+
+/**
+ * 获取设备码列表
+ * GET /api/cms/outdoor-fair-device/list
+ */
+export async function getOutdoorFairDeviceList(params?: OutdoorFairDeviceListParams) {
+  return request<OutdoorFairDeviceListResult>(`${BASE}/list`, {
+    method: 'GET',
+    params,
+  });
+}
+
+/**
+ * 批量生成设备码（UUID）
+ * POST /api/cms/outdoor-fair-device/batch
+ */
+export async function batchGenerateOutdoorFairDevice(data: OutdoorFairDeviceBatchParams) {
+  return request<OutdoorFairDeviceBatchResult>(`${BASE}/batch`, {
+    method: 'POST',
+    data,
+  });
+}
+
+/**
+ * 绑定/解绑参会企业（companyId 为空表示解绑）
+ * PUT /api/cms/outdoor-fair-device/{id}/bind
+ */
+export async function bindOutdoorFairDevice(id: number, companyId?: number) {
+  return request<OutdoorFairDeviceCommonResult>(`${BASE}/${id}/bind`, {
+    method: 'PUT',
+    data: { companyId: companyId ?? null },
+  });
+}
+
+/**
+ * 删除设备码
+ * DELETE /api/cms/outdoor-fair-device/{ids}
+ */
+export async function deleteOutdoorFairDevice(ids: number | string) {
+  return request<OutdoorFairDeviceCommonResult>(`${BASE}/${ids}`, {
+    method: 'DELETE',
+  });
+}
+
+/**
+ * 获取招聘会参会企业下拉（复用主招聘会参会企业接口）
+ */
+export async function getOutdoorFairCompanyOptions(
+  fairId: number,
+): Promise<OutdoorFairCompanyOption[]> {
+  const res = await request<{ code: number; rows?: any[]; total?: number }>(
+    `/api/cms/outdoor-fair/${fairId}/companies`,
+    { method: 'GET', params: { current: 1, pageSize: 1000 } },
+  );
+  if (res.code === 200 && Array.isArray(res.rows)) {
+    return res.rows
+      .filter((item) => item && item.companyId != null)
+      .map((item) => ({
+        companyId: item.companyId,
+        companyName: item.companyName,
+      }));
+  }
+  return [];
+}