feat: enhance operations dashboard and reporting controls

src/apps/admin/AdminAnalyticsPage.tsx

@@ -607,12 +607,10 @@ function MatrixMetric({ metric, zeroWhenEmpty = false }: { metric?: SignatureCha
   if (zeroWhenEmpty && total === 0) return <span className="signature-quality-matrix__zero">0</span>;
 
   return (
-    <div className="signature-quality-matrix__metric">
-      <strong>{total.toLocaleString('zh-CN')} 次</strong>
-      <span className={`signature-quality-matrix__rate ${successRateClassName(successRate)}`}>
-        {successRate.toFixed(1)}%
-      </span>
-      <small>{formatDuration(metric?.averageArrivalMs)}</small>
+    <div className={`signature-quality-matrix__metric signature-quality-matrix__metric--${successRateTone(successRate)}`}>
+      <div><small>通道提交</small><strong>{total.toLocaleString('zh-CN')} 次</strong></div>
+      <div><small>成功率</small><span className={`signature-quality-matrix__rate ${successRateClassName(successRate)}`}>{successRate.toFixed(1)}%</span></div>
+      <div><small>平均到达</small><span>{formatDuration(metric?.averageArrivalMs)}</span></div>
       {(metric?.submitFailureCount ?? 0) > 0 ? <em>提交失败 {metric?.submitFailureCount}</em> : null}
     </div>
   );

src/apps/admin/AdminDrainageFieldsPage.test.tsx

@@ -2,16 +2,22 @@ import { fireEvent, render, screen, waitFor } from '@testing-library/react';
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 import { AdminDrainageFieldsPage } from './AdminDrainageFieldsPage';
 
-const { adminApi } = vi.hoisted(() => ({ adminApi: { listDrainageFields: vi.fn(), listCommonReportFields: vi.fn(), updateCommonReportField: vi.fn() } }));
+const { adminApi } = vi.hoisted(() => ({ adminApi: { listDrainageFields: vi.fn(), listCommonReportFields: vi.fn(), reorderCommonReportFields: vi.fn(), updateCommonReportField: vi.fn(), updateDrainageField: vi.fn(), createDrainageField: vi.fn(), deleteDrainageField: vi.fn() } }));
 vi.mock('@/api/adminApi', () => ({ adminApi }));
 
 describe('common reporting configuration', () => {
   beforeEach(() => {
     Object.values(adminApi).forEach((method) => method.mockReset());
     const field = { id: 'field-1', code: 'license', name: '主体证明', fieldType: 'file', status: 'active' };
-    adminApi.listDrainageFields.mockResolvedValue([field]);
-    adminApi.listCommonReportFields.mockResolvedValue([{ id: 'common-1', drainageFieldId: 'field-1', reportType: 'signature', required: false, drainageField: field }]);
+    const secondField = { id: 'field-2', code: 'smsContent', name: '短信内容', fieldType: 'string', status: 'active' };
+    adminApi.listDrainageFields.mockResolvedValue([field, secondField]);
+    adminApi.listCommonReportFields.mockResolvedValue([
+      { id: 'common-1', drainageFieldId: 'field-1', reportType: 'signature', required: false, sortOrder: 10, drainageField: field },
+      { id: 'common-2', drainageFieldId: 'field-2', reportType: 'signature', required: false, sortOrder: 20, drainageField: secondField },
+    ]);
+    adminApi.reorderCommonReportFields.mockResolvedValue([]);
     adminApi.updateCommonReportField.mockResolvedValue({});
+    adminApi.updateDrainageField.mockResolvedValue({});
   });
   it('opens existing values and saves the edited requirement with PUT API', async () => {
     render(<AdminDrainageFieldsPage />);
@@ -24,4 +30,31 @@ describe('common reporting configuration', () => {
     await waitFor(() => expect(screen.queryByRole('dialog')).not.toBeInTheDocument());
     expect(adminApi.listCommonReportFields).toHaveBeenCalledTimes(2);
   });
+
+  it('moves a common field within its own material type through the reorder API', async () => {
+    render(<AdminDrainageFieldsPage />);
+    fireEvent.click(await screen.findByRole('button', { name: '下移通用字段主体证明' }));
+    await waitFor(() => expect(adminApi.reorderCommonReportFields).toHaveBeenCalledWith({
+      reportType: 'signature',
+      ids: ['common-2', 'common-1'],
+    }));
+    await waitFor(() => expect(adminApi.listCommonReportFields).toHaveBeenCalledTimes(2));
+  });
+
+  it('edits a field definition and locks mapping keys for a referenced field', async () => {
+    adminApi.listDrainageFields.mockResolvedValueOnce([
+      { id: 'field-1', code: 'license', name: '主体证明', fieldType: 'file', status: 'active', usageCount: 1, description: '旧说明' },
+    ]);
+    render(<AdminDrainageFieldsPage />);
+    fireEvent.click(await screen.findByRole('button', { name: '编辑主体证明' }));
+    expect(screen.getByRole('dialog')).toHaveTextContent('编辑报备字段');
+    expect(screen.getByLabelText('字段代码')).toBeDisabled();
+    expect(screen.getByRole('button', { name: '字段类型' })).toBeDisabled();
+    fireEvent.change(screen.getByLabelText('字段名称'), { target: { value: '企业主体证明' } });
+    fireEvent.change(screen.getByLabelText('描述'), { target: { value: '新说明' } });
+    fireEvent.click(screen.getByRole('button', { name: '保存' }));
+    await waitFor(() => expect(adminApi.updateDrainageField).toHaveBeenCalledWith('field-1', {
+      code: 'license', name: '企业主体证明', fieldType: 'file', description: '新说明',
+    }));
+  });
 });

src/apps/admin/AdminDrainageFieldsPage.tsx

@@ -1,5 +1,5 @@
 import { useEffect, useMemo, useState } from 'react';
-import { Database, Edit3, FileCheck2, Link2, Plus, Search, Trash2 } from 'lucide-react';
+import { ArrowDown, ArrowUp, Database, Edit3, FileCheck2, Link2, Plus, Search, Trash2 } from 'lucide-react';
 import { Breadcrumb, Button, Input, Modal, Select, Textarea, Tag } from '@/components/ui';
 import { adminApi, type CommonReportField, type DictionaryItem } from '@/api/adminApi';
 
@@ -32,6 +32,8 @@ export function AdminDrainageFieldsPage() {
   const [type, setType] = useState('all');
   const [appliedType, setAppliedType] = useState('all');
   const [creating, setCreating] = useState(false);
+  const [editingField, setEditingField] = useState<DrainageField | null>(null);
+  const [fieldSaving, setFieldSaving] = useState(false);
   const [code, setCode] = useState('');
   const [name, setName] = useState('');
   const [fieldType, setFieldType] = useState<ReportFieldType>('string');
@@ -45,6 +47,7 @@ export function AdminDrainageFieldsPage() {
   const [commonReportType, setCommonReportType] = useState<'signature' | 'drainage'>('signature');
   const [commonRequired, setCommonRequired] = useState(false);
   const [commonDeleteTarget, setCommonDeleteTarget] = useState<CommonReportField | null>(null);
+  const [commonOrderingId, setCommonOrderingId] = useState<string>();
   const codeError = code && !/^[A-Za-z0-9]+$/.test(code) ? '字段代码只能包含阿拉伯数字和英文大小写字母' : '';
 
   function loadData() {
@@ -70,17 +73,38 @@ export function AdminDrainageFieldsPage() {
     [appliedKeyword, appliedType, fields],
   );
 
-  function createField() {
-    adminApi.createDrainageField({ code, name, fieldType, description, status: 'active' })
+  function closeFieldModal() {
+    setCreating(false);
+    setEditingField(null);
+    setCode('');
+    setName('');
+    setFieldType('string');
+    setDescription('');
+  }
+
+  function openFieldModal(field?: DrainageField) {
+    setEditingField(field ?? null);
+    setCode(field?.code ?? '');
+    setName(field?.name ?? '');
+    setFieldType((field?.fieldType as ReportFieldType | undefined) ?? 'string');
+    setDescription(field?.description ?? '');
+    setError('');
+    setCreating(true);
+  }
+
+  function saveField() {
+    if (fieldSaving) return;
+    setFieldSaving(true);
+    const request = editingField
+      ? adminApi.updateDrainageField(editingField.id, { code, name, fieldType, description })
+      : adminApi.createDrainageField({ code, name, fieldType, description, status: 'active' });
+    request
       .then(() => {
-        setCode('');
-        setName('');
-        setFieldType('string');
-        setDescription('');
-        setCreating(false);
+        closeFieldModal();
         loadData();
       })
-      .catch((failure: Error) => setError(failure.message || '报备字段新增失败'));
+      .catch((failure: Error) => setError(failure.message || '报备字段保存失败'))
+      .finally(() => setFieldSaving(false));
   }
 
   function deleteField() {
@@ -130,6 +154,26 @@ export function AdminDrainageFieldsPage() {
       .catch((failure: Error) => setError(failure.message || '通用字段删除失败'));
   }
 
+  async function moveCommonField(field: CommonReportField, direction: -1 | 1) {
+    if (commonOrderingId) return;
+    const group = commonFields.filter((item) => item.reportType === field.reportType);
+    const currentIndex = group.findIndex((item) => item.id === field.id);
+    const targetIndex = currentIndex + direction;
+    if (currentIndex < 0 || targetIndex < 0 || targetIndex >= group.length) return;
+    const ids = group.map((item) => item.id);
+    [ids[currentIndex], ids[targetIndex]] = [ids[targetIndex], ids[currentIndex]];
+    setCommonOrderingId(field.id);
+    setError('');
+    try {
+      await adminApi.reorderCommonReportFields({ reportType: field.reportType, ids });
+      loadData();
+    } catch (failure) {
+      setError(failure instanceof Error ? failure.message : '通用字段顺序调整失败');
+    } finally {
+      setCommonOrderingId(undefined);
+    }
+  }
+
   const signatureCommon = commonFields.filter((field) => field.reportType === 'signature');
   const drainageCommon = commonFields.filter((field) => field.reportType === 'drainage');
   const referencedCount = fields.filter((field) => (field.usageCount ?? 0) > 0 || (field.commonUsageCount ?? 0) > 0).length;
@@ -142,7 +186,7 @@ export function AdminDrainageFieldsPage() {
           <h1>报备字段库</h1>
           <p>统一维护签名和引流信息的资料字段，并配置全平台通用报备要求。</p>
         </div>
-        <Button icon={<Plus size={16} />} onClick={() => setCreating(true)} size="sm">添加字段</Button>
+        <Button icon={<Plus size={16} />} onClick={() => openFieldModal()} size="sm">添加字段</Button>
       </div>
       {error ? <p className="form-error">{error}</p> : null}
 
@@ -170,8 +214,8 @@ export function AdminDrainageFieldsPage() {
           <Button icon={<Plus size={16} />} onClick={() => openCommonField()} size="sm" variant="secondary">配置通用字段</Button>
         </div>
         <div className="admin-drainage-common-grid">
-          <CommonFieldGroup fields={signatureCommon} label="签名报备资料" onEdit={openCommonField} onDelete={setCommonDeleteTarget} tone="info" />
-          <CommonFieldGroup fields={drainageCommon} label="引流信息报备资料" onEdit={openCommonField} onDelete={setCommonDeleteTarget} tone="warning" />
+          <CommonFieldGroup fields={signatureCommon} label="签名报备资料" onEdit={openCommonField} onDelete={setCommonDeleteTarget} onMove={moveCommonField} orderingId={commonOrderingId} tone="info" />
+          <CommonFieldGroup fields={drainageCommon} label="引流信息报备资料" onEdit={openCommonField} onDelete={setCommonDeleteTarget} onMove={moveCommonField} orderingId={commonOrderingId} tone="warning" />
         </div>
       </div>
 
@@ -180,7 +224,7 @@ export function AdminDrainageFieldsPage() {
         {filteredFields.length ? <div className="admin-drainage-field-grid">{filteredFields.map((field) => {
           const locked = (field.usageCount ?? 0) > 0 || (field.commonUsageCount ?? 0) > 0;
           return <article className="admin-drainage-field-card" key={field.id}>
-            <div className="admin-drainage-field-card__top"><span className="admin-drainage-type">{typeLabels[field.fieldType ?? ''] ?? field.fieldType}</span><Button aria-label={`删除${field.name}`} disabled={locked} icon={<Trash2 size={14} />} iconOnly onClick={() => setDeleteTarget(field)} size="sm" variant="ghost">删除</Button></div>
+            <div className="admin-drainage-field-card__top"><span className="admin-drainage-type">{typeLabels[field.fieldType ?? ''] ?? field.fieldType}</span><div className="admin-drainage-field-card__actions"><Button aria-label={`编辑${field.name}`} icon={<Edit3 size={14} />} iconOnly onClick={() => openFieldModal(field)} size="sm" variant="ghost">编辑</Button><Button aria-label={`删除${field.name}`} disabled={locked} icon={<Trash2 size={14} />} iconOnly onClick={() => setDeleteTarget(field)} size="sm" variant="ghost">删除</Button></div></div>
             <h3>{field.name ?? '-'}</h3><code>{field.code}</code><p>{field.description || '暂无字段说明'}</p>
             <div className="admin-drainage-field-card__meta"><span>通道引用 <strong>{field.usageCount ?? 0}</strong></span><span>通用配置 <strong>{field.commonUsageCount ?? 0}</strong></span></div>
           </article>;
@@ -205,23 +249,25 @@ export function AdminDrainageFieldsPage() {
       <Modal
         footer={(
           <>
-            <Button onClick={() => setCreating(false)} variant="ghost">取消</Button>
-            <Button disabled={!code || !name || Boolean(codeError)} onClick={createField}>保存</Button>
+            <Button disabled={fieldSaving} onClick={closeFieldModal} variant="ghost">取消</Button>
+            <Button disabled={!code || !name || Boolean(codeError) || fieldSaving} onClick={saveField}>{fieldSaving ? '保存中...' : '保存'}</Button>
           </>
         )}
-        onClose={() => setCreating(false)}
+        onClose={closeFieldModal}
         open={creating}
-        title="添加报备字段"
+        title={editingField ? '编辑报备字段' : '添加报备字段'}
       >
         <div className="admin-system-modal-form">
-          <Input error={codeError} label="字段代码" onChange={(event) => setCode(event.target.value)} placeholder="仅允许数字和英文字母" value={code} />
+          <Input disabled={Boolean(editingField && ((editingField.usageCount ?? 0) > 0 || (editingField.commonUsageCount ?? 0) > 0))} error={codeError} label="字段代码" onChange={(event) => setCode(event.target.value)} placeholder="仅允许数字和英文字母" value={code} />
           <Input label="字段名称" onChange={(event) => setName(event.target.value)} value={name} />
           <Select
+            disabled={Boolean(editingField && ((editingField.usageCount ?? 0) > 0 || (editingField.commonUsageCount ?? 0) > 0))}
             label="字段类型"
             onChange={(event) => setFieldType(event.target.value as ReportFieldType)}
             options={typeOptions.filter((option) => option.value !== 'all')}
             value={fieldType}
           />
+          {editingField && ((editingField.usageCount ?? 0) > 0 || (editingField.commonUsageCount ?? 0) > 0) ? <p className="admin-system-modal-form__wide">该字段已被引用，为保护现有通道映射和历史资料，只能修改字段名称和描述。</p> : null}
           <Textarea
             className="admin-system-modal-form__wide"
             label="描述"
@@ -255,6 +301,6 @@ export function AdminDrainageFieldsPage() {
   );
 }
 
-function CommonFieldGroup({ fields, label, onEdit, onDelete, tone }: { fields: CommonReportField[]; label: string; onEdit: (field: CommonReportField) => void; onDelete: (field: CommonReportField) => void; tone: 'info' | 'warning' }) {
-  return <section className="admin-drainage-common-group"><div className="admin-drainage-common-group__title"><Tag tone={tone}>{label}</Tag><span>{fields.length} 项</span></div>{fields.length ? <div className="admin-drainage-common-list">{fields.map((field) => <div key={field.id}><div><strong>{String(field.drainageField.name ?? field.drainageField.code)}</strong><span>{String(field.drainageField.code)} · {typeLabels[String(field.drainageField.fieldType ?? '')] ?? '-'}</span></div><Tag tone={field.required ? 'warning' : 'neutral'}>{field.required ? '必填' : '选填'}</Tag><Button aria-label={`修改通用字段${field.drainageField.name}`} icon={<Edit3 size={14} />} onClick={() => onEdit(field)} size="sm" variant="ghost">修改</Button><Button aria-label="删除通用字段" icon={<Trash2 size={14} />} iconOnly onClick={() => onDelete(field)} size="sm" variant="ghost">删除</Button></div>)}</div> : <p className="admin-drainage-common-empty">暂未配置字段</p>}</section>;
+function CommonFieldGroup({ fields, label, onEdit, onDelete, onMove, orderingId, tone }: { fields: CommonReportField[]; label: string; onEdit: (field: CommonReportField) => void; onDelete: (field: CommonReportField) => void; onMove: (field: CommonReportField, direction: -1 | 1) => void; orderingId?: string; tone: 'info' | 'warning' }) {
+  return <section className="admin-drainage-common-group"><div className="admin-drainage-common-group__title"><Tag tone={tone}>{label}</Tag><span>{fields.length} 项</span></div>{fields.length ? <div className="admin-drainage-common-list">{fields.map((field, index) => <div key={field.id}><div><strong>{String(field.drainageField.name ?? field.drainageField.code)}</strong><span>{String(field.drainageField.code)} · {typeLabels[String(field.drainageField.fieldType ?? '')] ?? '-'}</span></div><Tag tone={field.required ? 'warning' : 'neutral'}>{field.required ? '必填' : '选填'}</Tag><div className="admin-drainage-common-order"><Button aria-label={`上移通用字段${field.drainageField.name}`} disabled={index === 0 || Boolean(orderingId)} icon={<ArrowUp size={14} />} iconOnly onClick={() => onMove(field, -1)} size="sm" variant="ghost">上移</Button><Button aria-label={`下移通用字段${field.drainageField.name}`} disabled={index === fields.length - 1 || Boolean(orderingId)} icon={<ArrowDown size={14} />} iconOnly onClick={() => onMove(field, 1)} size="sm" variant="ghost">下移</Button></div><Button aria-label={`修改通用字段${field.drainageField.name}`} icon={<Edit3 size={14} />} onClick={() => onEdit(field)} size="sm" variant="ghost">修改</Button><Button aria-label="删除通用字段" icon={<Trash2 size={14} />} iconOnly onClick={() => onDelete(field)} size="sm" variant="ghost">删除</Button></div>)}</div> : <p className="admin-drainage-common-empty">暂未配置字段</p>}</section>;
 }

src/apps/admin/AdminHome.tsx

@@ -78,6 +78,9 @@ export function AdminHome() {
   const totalSend = dashboard?.today.sent ?? 0;
   const averageSuccessRate = dashboard?.today.successRate ?? 0;
   const todaySpend = moneyUnitsToYuan(dashboard?.today.spendCents);
+  const todayReturned = moneyUnitsToYuan(dashboard?.today.returnedCents);
+  const todayBilled = moneyUnitsToYuan(dashboard?.today.billedCents);
+  const todayProfit = moneyUnitsToYuan(dashboard?.today.profitCents);
   const activeSignatureCount = new Set(quality?.signatures.map((item) => item.signatureId) ?? []).size;
   const downstreamAlertCount = dashboard?.downstreamDeliverySummary?.alertCount ?? 0;
   const pendingAudits = dashboard?.pendingAudits ?? { enterpriseCertifications: 0, smsAudits: 0, templates: 0, signatures: 0, drainageInfos: 0, total: 0 };
@@ -175,6 +178,36 @@ export function AdminHome() {
           <strong>{activeSignatureCount}</strong>
           <small>当天有真实发送记录的签名</small>
         </div>
+        <div className="surface metric-card">
+          <span>今日消息分片数</span>
+          <strong>{formatCount(dashboard?.today.segmentCount ?? 0)} 片</strong>
+          <small>来自真实分片审计记录</small>
+        </div>
+        <div className="surface metric-card">
+          <span>今日到达率</span>
+          <strong>{(dashboard?.today.arrivalRate ?? 0).toFixed(1)}%</strong>
+          <small>到达分片 / 发送总分片</small>
+        </div>
+        <div className="surface metric-card">
+          <span>今日返还金额</span>
+          <strong>¥{formatCurrency(todayReturned)}</strong>
+          <small>来自今日返还流水</small>
+        </div>
+        <div className="surface metric-card">
+          <span>今日计收金额</span>
+          <strong>¥{formatCurrency(todayBilled)}</strong>
+          <small>成功短信计费条数 × 客户价</small>
+        </div>
+        <div className="surface metric-card">
+          <span>今日利润</span>
+          <strong className={todayProfit < 0 ? 'metric-card__value--danger' : undefined}>¥{formatCurrency(todayProfit)}</strong>
+          <small>计收金额 - 成功分片通道成本</small>
+        </div>
+        <div className="surface metric-card">
+          <span>今日利润率</span>
+          <strong className={(dashboard?.today.profitRate ?? 0) < 0 ? 'metric-card__value--danger' : undefined}>{(dashboard?.today.profitRate ?? 0).toFixed(1)}%</strong>
+          <small>今日利润 / 今日计收金额</small>
+        </div>
       </div>
       {error ? <div className="surface ui-table__empty">{error}</div> : null}
 

src/apps/admin/enterprise-signatures/EnterpriseSignaturesTable.test.tsx

@@ -91,4 +91,10 @@ describe('EnterpriseSignaturesTable dense presentation', () => {
     expect(screen.queryByRole('button', { name: '签名降序' })).not.toBeInTheDocument();
     expect(screen.queryByText('待生成明细')).not.toBeInTheDocument();
   });
+
+  it('shows the complete signature context in the signature hover text', () => {
+    renderTable({ expandedSignatureId: '' });
+    expect(screen.getByLabelText(/签名：【聆界科技】/)).toHaveAttribute('title', expect.stringContaining('企业：深圳市聆界科技有限公司'));
+    expect(screen.getByLabelText(/签名：【聆界科技】/)).toHaveAttribute('title', expect.stringContaining('应用：营销通知应用'));
+  });
 });

src/apps/admin/enterprise-signatures/EnterpriseSignaturesTable.tsx

@@ -71,6 +71,15 @@ export function EnterpriseSignaturesTable({
           : payload.links;
         const cardVisual = signatureCardVisual(signature.auditStatus, signature.carrierReportSummary);
         const expanded = expandedSignatureId === signature.id || Boolean(appliedDrainageKeyword);
+        const signatureTooltip = [
+          `签名：${formatSignatureName(signature.name)}`,
+          `企业：${signature.tenant?.name ?? signature.tenantId}`,
+          `应用：${signature.application?.name ?? '未绑定应用'}`,
+          `用途：${signature.purpose || '未填写'}`,
+          `审核状态：${signature.auditStatus}`,
+          `创建时间：${signature.createdAt ? new Date(signature.createdAt).toLocaleString('zh-CN') : '未知'}`,
+          `更新时间：${signature.updatedAt ? new Date(signature.updatedAt).toLocaleString('zh-CN') : '未知'}`,
+        ].join('\n');
         return (
           <article
             aria-label={`签名总体状态：${cardVisual.label}`}
@@ -86,7 +95,7 @@ export function EnterpriseSignaturesTable({
               >
                 {expanded ? <ChevronDown size={18} /> : <ChevronRight size={18} />}
               </button>
-              <div className="enterprise-signature-table__signature" data-label="签名">
+              <div aria-label={signatureTooltip} className="enterprise-signature-table__signature" data-label="签名" title={signatureTooltip}>
                 <strong>{formatSignatureName(signature.name)}</strong>
               </div>
               <div data-label="企业">