feat: unify drainage targets and carrier status UI

This commit is contained in:
hectorzhao
2026-08-28 17:24:01 +08:00
parent 9ac41e9308
commit c68ac7a3db
25 changed files with 265 additions and 65 deletions
+15 -1
View File
@@ -1,5 +1,5 @@
import { BadRequestException } from '@nestjs/common'; import { BadRequestException } from '@nestjs/common';
import { ClientBatchTaskDto, ClientDeleteResourceDto, ClientImportConfirmDto } from './client-write.dto'; import { ClientBatchTaskDto, ClientDeleteResourceDto, ClientDrainageInfoDto, ClientImportConfirmDto } from './client-write.dto';
import { strictValidationPipe } from './strict-validation.pipe'; import { strictValidationPipe } from './strict-validation.pipe';
function validate<T>(metatype: new () => T, value: unknown) { function validate<T>(metatype: new () => T, value: unknown) {
@@ -45,4 +45,18 @@ describe('strict client write DTOs', () => {
}), }),
).rejects.toBeInstanceOf(BadRequestException); ).rejects.toBeInstanceOf(BadRequestException);
}); });
it.each([
'https://example.com/path',
'13800138000',
'+86 138-0013-8000',
'0755-12345678',
'(010) 12345678-123',
])('accepts a drainage URL or phone number without a separate name: %s', async (url) => {
await expect(validate(ClientDrainageInfoDto, { url })).resolves.toEqual(expect.objectContaining({ url }));
});
it('rejects arbitrary drainage text that is neither a URL nor a phone number', async () => {
await expect(validate(ClientDrainageInfoDto, { url: '品牌官网' })).rejects.toBeInstanceOf(BadRequestException);
});
}); });
+8 -2
View File
@@ -101,8 +101,14 @@ export class ClientSmsSignatureUpdateDto extends PartialType(ClientSmsSignatureD
} }
export class ClientDrainageInfoDto { export class ClientDrainageInfoDto {
@IsString() @MinLength(1) @MaxLength(200) siteName!: string; @IsOptional() @IsString() @MaxLength(200) siteName?: string;
@IsUrl({ require_tld: false }) @MaxLength(2048) url!: string; @IsString()
@MinLength(1)
@MaxLength(2048)
@Matches(/^(?:https?:\/\/\S+|(?:\+?86[\s-]?)?1(?:[\s-]?\d){10}|(?:\+?86[\s-]?)?(?:\(?0\d{2,3}\)?[\s-]?)?\d{7,8}(?:[\s-]?(?:转|ext\.?)?[\s-]?\d{1,6})?)$/i, {
message: '引流信息必须是 http/https URL、手机号码或固定电话号码',
})
url!: string;
@IsOptional() @IsString() @MaxLength(1000) remark?: string; @IsOptional() @IsString() @MaxLength(1000) remark?: string;
@IsOptional() @IsObject() @IsBoundedJsonObject({ maxKeys: 200, maxDepth: 4 }) reportValues?: Record<string, unknown>; @IsOptional() @IsObject() @IsBoundedJsonObject({ maxKeys: 200, maxDepth: 4 }) reportValues?: Record<string, unknown>;
} }
@@ -240,7 +240,7 @@ export class ReportBatchGenerationService {
signatureId: signature.id, signatureId: signature.id,
drainageItemId: drainageInfo?.id, drainageItemId: drainageInfo?.id,
materialVersion, materialVersion,
name: selected.reportType === 'signature' ? signature.name : drainageInfo?.siteName ?? '引流资料', name: selected.reportType === 'signature' ? signature.name : drainageInfo?.url ?? '引流资料',
tenantName: signature.tenant.name, tenantName: signature.tenant.name,
applicationId: signature.applicationId ?? undefined, applicationId: signature.applicationId ?? undefined,
applicationName: signature.application?.name ?? '未指定应用', applicationName: signature.application?.name ?? '未指定应用',
@@ -251,9 +251,8 @@ export class ReportImportReviewService {
async stageDrainageRow(tenantId: string, applicationId: string | undefined, mappings: ImportMapping[], values: Record<string, unknown>) { async stageDrainageRow(tenantId: string, applicationId: string | undefined, mappings: ImportMapping[], values: Record<string, unknown>) {
const signatureName = mappedCoreValue(mappings, values, 'signatureName'); const signatureName = mappedCoreValue(mappings, values, 'signatureName');
const siteName = mappedCoreValue(mappings, values, 'siteName');
const url = mappedCoreValue(mappings, values, 'url'); const url = mappedCoreValue(mappings, values, 'url');
if (!signatureName || !siteName || !url) throw new Error('引流信息必须包含短信签名、站点名称和URL'); if (!signatureName || !url) throw new Error('引流信息必须包含短信签名和引流 URL 或号码');
const signature = await this.prisma.smsSignature.findFirst({ where: { tenantId, applicationId: applicationId ?? null, name: signatureName, auditStatus: 'approved' } }); const signature = await this.prisma.smsSignature.findFirst({ where: { tenantId, applicationId: applicationId ?? null, name: signatureName, auditStatus: 'approved' } });
if (!signature) throw new Error(`未找到已审核签名:${signatureName}`); if (!signature) throw new Error(`未找到已审核签名:${signatureName}`);
const remark = mappedCoreValue(mappings, values, 'remark'); const remark = mappedCoreValue(mappings, values, 'remark');
@@ -262,7 +261,7 @@ export class ReportImportReviewService {
return { return {
operation: existing ? 'update' : 'create', operation: existing ? 'update' : 'create',
targetId: existing?.id, targetId: existing?.id,
payload: { tenantId, applicationId, signatureId: signature.id, signatureName, siteName, url, remark, reportValues }, payload: { tenantId, applicationId, signatureId: signature.id, signatureName, siteName: url, url, remark, reportValues },
originalSnapshot: existing ? { originalSnapshot: existing ? {
id: existing.id, id: existing.id,
siteName: existing.siteName, siteName: existing.siteName,
@@ -311,10 +310,8 @@ export class ReportImportReviewService {
return targetId; return targetId;
} }
const signatureId = String(payload.signatureId ?? ''); const signatureId = String(payload.signatureId ?? '');
const siteName = String(payload.siteName ?? '');
const url = String(payload.url ?? ''); const url = String(payload.url ?? '');
const body = { const body = {
siteName,
url, url,
remark: typeof payload.remark === 'string' ? payload.remark : undefined, remark: typeof payload.remark === 'string' ? payload.remark : undefined,
reportValues: jsonRecord(payload.reportValues), reportValues: jsonRecord(payload.reportValues),
@@ -336,7 +333,7 @@ export class ReportImportReviewService {
targetId = created.id; targetId = created.id;
} }
} }
await this.smsConfig.approveDrainageInfo(targetId, { reviewerId, reason: `批量导入审核通过:${siteName || url}` }); await this.smsConfig.approveDrainageInfo(targetId, { reviewerId, reason: `批量导入审核通过:${url}` });
return targetId; return targetId;
} }
} }
@@ -20,11 +20,11 @@ export class ReportOfficialExportService {
const sheet = workbook.addWorksheet(reportType === 'signature' ? '签名资料' : '引流信息', { views: [{ state: 'frozen', ySplit: 1 }] }); const sheet = workbook.addWorksheet(reportType === 'signature' ? '签名资料' : '引流信息', { views: [{ state: 'frozen', ySplit: 1 }] });
const headers = reportType === 'signature' const headers = reportType === 'signature'
? ['短信签名', '用途说明', '营业执照图片', '授权书图片', '备注'] ? ['短信签名', '用途说明', '营业执照图片', '授权书图片', '备注']
: ['短信签名', '站点名称', 'URL', '备注', '网站截图']; : ['短信签名', '引流 URL 或号码', '备注', '主体证明'];
sheet.addRow(headers); sheet.addRow(headers);
sheet.addRow(reportType === 'signature' sheet.addRow(reportType === 'signature'
? ['示例签名', '验证码通知', '请在本单元格插入图片', '请在本单元格插入图片', '示例行,导入前请删除'] ? ['示例签名', '验证码通知', '请在本单元格插入图片', '请在本单元格插入图片', '示例行,导入前请删除']
: ['示例签名', '官方站点', 'https://example.com', '示例行,导入前请删除', '请在本单元格插入图片']); : ['示例签名', 'https://example.com 或 13800138000', '示例行,导入前请删除', '请在本单元格插入图片']);
styleHeader(sheet.getRow(1)); styleHeader(sheet.getRow(1));
sheet.columns.forEach((column) => { column.width = 24; }); sheet.columns.forEach((column) => { column.width = 24; });
sheet.getRow(2).height = 48; sheet.getRow(2).height = 48;
@@ -67,7 +67,7 @@ export class ReportPendingQueryService {
]); ]);
return [ return [
...signatures.map((item) => ({ id: `signature:${item.id}`, reportType: 'signature', signatureId: item.id, drainageItemId: null, materialVersion: item.materialVersion, changedAt: item.reportChangedAt, name: item.name, detail: item.purpose, tenant: item.tenant, application: item.application })), ...signatures.map((item) => ({ id: `signature:${item.id}`, reportType: 'signature', signatureId: item.id, drainageItemId: null, materialVersion: item.materialVersion, changedAt: item.reportChangedAt, name: item.name, detail: item.purpose, tenant: item.tenant, application: item.application })),
...drainageInfos.map((item) => ({ id: `drainage:${item.id}`, reportType: 'drainage', signatureId: item.signatureId, drainageItemId: item.id, materialVersion: item.materialVersion, changedAt: item.reportChangedAt, name: item.siteName, detail: item.url, signatureName: item.signature.name, tenant: item.tenant, application: item.application })), ...drainageInfos.map((item) => ({ id: `drainage:${item.id}`, reportType: 'drainage', signatureId: item.signatureId, drainageItemId: item.id, materialVersion: item.materialVersion, changedAt: item.reportChangedAt, name: item.url, detail: item.remark, signatureName: item.signature.name, tenant: item.tenant, application: item.application })),
].sort((left, right) => new Date(right.changedAt).getTime() - new Date(left.changedAt).getTime()); ].sort((left, right) => new Date(right.changedAt).getTime() - new Date(left.changedAt).getTime());
} }
} }
@@ -85,8 +85,8 @@ export function signatureCoreMapping(header: string): { code: string; kind: Impo
export function drainageCoreMapping(header: string): { code: string; kind: ImportMapping['targetKind']; required?: boolean } | undefined { export function drainageCoreMapping(header: string): { code: string; kind: ImportMapping['targetKind']; required?: boolean } | undefined {
if (/短信签名|签名名称/.test(header)) return { code: 'signature_name', kind: 'signatureName', required: true }; if (/短信签名|签名名称/.test(header)) return { code: 'signature_name', kind: 'signatureName', required: true };
if (/站点|网站名称/.test(header)) return { code: 'site_name', kind: 'siteName', required: true }; if (/引流.*(?:url|地址|号码)|网址|url|链接|手机号码|固定电话|电话号码/.test(header)) return { code: 'url', kind: 'url', required: true };
if (/引流地址|网址|url|链接/.test(header)) return { code: 'url', kind: 'url', required: true }; if (/站点|网站名称/.test(header)) return { code: 'site_name', kind: 'siteName' };
if (/备注|说明/.test(header)) return { code: 'remark', kind: 'remark' }; if (/备注|说明/.test(header)) return { code: 'remark', kind: 'remark' };
return undefined; return undefined;
} }
@@ -13,6 +13,17 @@ describe('ReportMaterialsService', () => {
expect(operationLog.create).toHaveBeenCalledWith({ data: expect.objectContaining({ userId: 'operator-1' }) }); expect(operationLog.create).toHaveBeenCalledWith({ data: expect.objectContaining({ userId: 'operator-1' }) });
}); });
it('builds a drainage template without a separate site-name column', async () => {
const operationLog = { create: jest.fn().mockResolvedValue({ id: 'log-drainage-template' }) };
const service = new ReportMaterialsService({ operationLog } as never, {} as never, {} as never);
const exported = await service.buildOfficialTemplate('drainage', 'operator-1');
const workbook = new ExcelJS.Workbook();
await workbook.xlsx.load(exported.content as never);
const headers = workbook.worksheets[0].getRow(1).values;
expect(headers).toEqual(expect.arrayContaining(['短信签名', '引流 URL 或号码', '备注', '主体证明']));
expect(headers).not.toEqual(expect.arrayContaining(['站点名称']));
});
it('rejects formula cells before storing or importing a workbook', async () => { it('rejects formula cells before storing or importing a workbook', async () => {
const workbook = new ExcelJS.Workbook(); const workbook = new ExcelJS.Workbook();
const sheet = workbook.addWorksheet('签名资料'); const sheet = workbook.addWorksheet('签名资料');
+16 -7
View File
@@ -11,6 +11,16 @@ import { SmsReportValidationService } from './report-validation.service';
import { SmsAuditService } from './audit.service'; import { SmsAuditService } from './audit.service';
import { shanghaiDateRange } from '../common/shanghai-date-range'; import { shanghaiDateRange } from '../common/shanghai-date-range';
const DRAINAGE_TARGET_PATTERN = /^(?:https?:\/\/\S+|(?:\+?86[\s-]?)?1(?:[\s-]?\d){10}|(?:\+?86[\s-]?)?(?:\(?0\d{2,3}\)?[\s-]?)?\d{7,8}(?:[\s-]?(?:转|ext\.?)?[\s-]?\d{1,6})?)$/i;
function normalizeDrainageTarget(value?: string) {
const target = value?.trim() ?? '';
if (!target || !DRAINAGE_TARGET_PATTERN.test(target)) {
throw new BadRequestException('引流信息必须是 http/https URL、手机号码或固定电话号码');
}
return target;
}
/** R3 domain service. Kept framework-agnostic and composed behind SmsConfigService. */ /** R3 domain service. Kept framework-agnostic and composed behind SmsConfigService. */
export class SmsDrainageService { export class SmsDrainageService {
constructor(private readonly prisma: PrismaService, private readonly reportValidation: SmsReportValidationService, private readonly audit: SmsAuditService) {} constructor(private readonly prisma: PrismaService, private readonly reportValidation: SmsReportValidationService, private readonly audit: SmsAuditService) {}
@@ -70,7 +80,7 @@ export class SmsDrainageService {
if (!signature) throw new NotFoundException('Signature not found'); if (!signature) throw new NotFoundException('Signature not found');
if (tenantId && signature.tenantId !== tenantId) throw new NotFoundException('Signature not found'); if (tenantId && signature.tenantId !== tenantId) throw new NotFoundException('Signature not found');
if (signature.auditStatus !== 'approved') throw new BadRequestException('签名审核通过后才能新增引流信息'); if (signature.auditStatus !== 'approved') throw new BadRequestException('签名审核通过后才能新增引流信息');
if (!data.siteName?.trim() || !data.url?.trim()) throw new BadRequestException('siteName and url are required'); const target = normalizeDrainageTarget(data.url);
await this.reportValidation.validateDrainageReportValues(signature.applicationId ?? undefined, data.reportValues); await this.reportValidation.validateDrainageReportValues(signature.applicationId ?? undefined, data.reportValues);
const auditStatus = options.initialAuditStatus ?? 'pending'; const auditStatus = options.initialAuditStatus ?? 'pending';
const item = await this.prisma.smsDrainageInfo.create({ const item = await this.prisma.smsDrainageInfo.create({
@@ -78,8 +88,8 @@ export class SmsDrainageService {
tenantId: signature.tenantId, tenantId: signature.tenantId,
signatureId, signatureId,
applicationId: signature.applicationId, applicationId: signature.applicationId,
siteName: data.siteName.trim(), siteName: target,
url: data.url.trim(), url: target,
remark: data.remark, remark: data.remark,
reportValues: data.reportValues as Prisma.InputJsonValue | undefined, reportValues: data.reportValues as Prisma.InputJsonValue | undefined,
auditStatus, auditStatus,
@@ -104,8 +114,7 @@ export class SmsDrainageService {
if (!current) throw new NotFoundException('Drainage info not found'); if (!current) throw new NotFoundException('Drainage info not found');
if (tenantId && current.tenantId !== tenantId) throw new NotFoundException('Drainage info not found'); if (tenantId && current.tenantId !== tenantId) throw new NotFoundException('Drainage info not found');
if (current.auditStatus === 'deleted') throw new BadRequestException('已删除的引流信息不能修改'); if (current.auditStatus === 'deleted') throw new BadRequestException('已删除的引流信息不能修改');
if (data.siteName !== undefined && !data.siteName.trim()) throw new BadRequestException('siteName is required'); const target = data.url === undefined ? undefined : normalizeDrainageTarget(data.url);
if (data.url !== undefined && !data.url.trim()) throw new BadRequestException('url is required');
const applicationId = current.signature.applicationId ?? current.applicationId ?? undefined; const applicationId = current.signature.applicationId ?? current.applicationId ?? undefined;
await this.reportValidation.validateDrainageReportValues(applicationId, data.reportValues ?? (isRecord(current.reportValues) ? current.reportValues : {})); await this.reportValidation.validateDrainageReportValues(applicationId, data.reportValues ?? (isRecord(current.reportValues) ? current.reportValues : {}));
const auditStatus = options.initialAuditStatus ?? 'pending'; const auditStatus = options.initialAuditStatus ?? 'pending';
@@ -113,8 +122,8 @@ export class SmsDrainageService {
where: { id: itemId }, where: { id: itemId },
data: { data: {
applicationId, applicationId,
siteName: data.siteName?.trim(), siteName: target,
url: data.url?.trim(), url: target,
remark: data.remark, remark: data.remark,
reportValues: data.reportValues as Prisma.InputJsonValue | undefined, reportValues: data.reportValues as Prisma.InputJsonValue | undefined,
auditStatus, auditStatus,
+1 -1
View File
@@ -54,7 +54,7 @@ export type UpdateSmsSignatureDto = Partial<Omit<CreateSmsSignatureDto, 'tenantI
}; };
export interface CreateSmsDrainageInfoDto { export interface CreateSmsDrainageInfoDto {
siteName: string; siteName?: string;
url: string; url: string;
remark?: string; remark?: string;
reportValues?: Record<string, unknown>; reportValues?: Record<string, unknown>;
@@ -967,7 +967,7 @@ describe('SmsConfigService', () => {
}]); }]);
const service = new SmsConfigService(prisma as never); const service = new SmsConfigService(prisma as never);
await expect(service.createDrainageInfo('sig-1', { siteName: '官网', url: 'https://example.com', reportValues: {} }, {}, 'tenant-1')) await expect(service.createDrainageInfo('sig-1', { url: 'https://example.com', reportValues: {} }, {}, 'tenant-1'))
.rejects.toThrow('引流信息缺少必填报备资料:网站主体'); .rejects.toThrow('引流信息缺少必填报备资料:网站主体');
expect(prisma.smsDrainageInfo.create).not.toHaveBeenCalled(); expect(prisma.smsDrainageInfo.create).not.toHaveBeenCalled();
}); });
@@ -1014,9 +1014,12 @@ describe('SmsConfigService', () => {
prisma.channelRouteRule.findMany.mockResolvedValue([]); prisma.channelRouteRule.findMany.mockResolvedValue([]);
const service = new SmsConfigService(prisma as never); const service = new SmsConfigService(prisma as never);
await expect(service.createDrainageInfo('sig-1', { siteName: '官网', url: 'https://example.com', reportValues: {} }, {}, 'tenant-1')) await expect(service.createDrainageInfo('sig-1', { url: '13800138000', reportValues: {} }, {}, 'tenant-1'))
.resolves.toEqual(expect.objectContaining({ id: 'drainage-1', auditStatus: 'pending' })); .resolves.toEqual(expect.objectContaining({ id: 'drainage-1', auditStatus: 'pending' }));
expect(prisma.smsDrainageInfo.create).toHaveBeenCalledWith(expect.objectContaining({
data: expect.objectContaining({ siteName: '13800138000', url: '13800138000' }),
}));
expect(prisma.auditRecord.create).toHaveBeenCalledWith({ data: expect.objectContaining({ targetType: 'sms_drainage_info', action: 'submit', statusAfter: 'pending' }) }); expect(prisma.auditRecord.create).toHaveBeenCalledWith({ data: expect.objectContaining({ targetType: 'sms_drainage_info', action: 'submit', statusAfter: 'pending' }) });
expect(prisma.channelSignatureReportTask.create).not.toHaveBeenCalled(); expect(prisma.channelSignatureReportTask.create).not.toHaveBeenCalled();
}); });
@@ -214,7 +214,7 @@
10. 发送前必须校验最终选中通道上的签名报备任务为 approved;补发切换到新通道时必须重新按新通道校验报备状态,未通过则该次发送失败。 10. 发送前必须校验最终选中通道上的签名报备任务为 approved;补发切换到新通道时必须重新按新通道校验报备状态,未通过则该次发送失败。
11. 企业签名页、通道报备详情页和报备任务页均允许人工修正报备状态,但三个入口必须操作同一份 `ChannelSignatureReportTask` 通道级事实并写 `ChannelSignatureReportRecord`;企业签名页修改时必须展示应用当前通道组内的具体通道矩阵,不允许直接修改移动/联通/电信汇总标签。 11. 企业签名页、通道报备详情页和报备任务页均允许人工修正报备状态,但三个入口必须操作同一份 `ChannelSignatureReportTask` 通道级事实并写 `ChannelSignatureReportRecord`;企业签名页修改时必须展示应用当前通道组内的具体通道矩阵,不允许直接修改移动/联通/电信汇总标签。
12. 每次人工状态变更或回执导入后,系统必须按应用当前生效路由规则重新汇总各运营商目标通道状态和签名全局 `reportStatus`。新增目标通道但尚无任务时按未报备计入分母;移出当前配置的历史通道不参与当前汇总,但任务和记录继续保留。 12. 每次人工状态变更或回执导入后,系统必须按应用当前生效路由规则重新汇总各运营商目标通道状态和签名全局 `reportStatus`。新增目标通道但尚无任务时按未报备计入分母;移出当前配置的历史通道不参与当前汇总,但任务和记录继续保留。
13. 报备任务和报备记录页面必须可按签名/引流信息类型筛选,并显示引流信息的站名称、地址和所属签名。报备记录查询必须关联真实任务、通道和引流实体,完整展示审核通过后创建、重置、冻结、导出、回执和人工状态变化。 13. 报备任务和报备记录页面必须可按签名/引流信息类型筛选,并显示引流 URL 或号码及所属签名。报备记录查询必须关联真实任务、通道和引流实体,完整展示审核通过后创建、重置、冻结、导出、回执和人工状态变化。
### 4.8 CMPP Gateway 与外部接入 ### 4.8 CMPP Gateway 与外部接入
@@ -1509,7 +1509,7 @@
### 2026-07-15 签名与引流资料批量导入、通道映射及统一报备 ### 2026-07-15 签名与引流资料批量导入、通道映射及统一报备
1. 运营端在“报备任务”下提供“待报备资料”工作台。WPS 在线表格须先由用户另存为 `.xlsx`,系统读取真实工作簿、工作表、表头、单元格和内嵌图片;原始文件及拆出的图片写入 MinIO,导入批次、映射和业务资料写入 PostgreSQL,不支持用 CSV、前端静态数组或浏览器本地存储冒充图片导入。 1. 运营端在“报备任务”下提供“待报备资料”工作台。WPS 在线表格须先由用户另存为 `.xlsx`,系统读取真实工作簿、工作表、表头、单元格和内嵌图片;原始文件及拆出的图片写入 MinIO,导入批次、映射和业务资料写入 PostgreSQL,不支持用 CSV、前端静态数组或浏览器本地存储冒充图片导入。
2. 导入分为“解析预览”和“确认入库”两步。用户可指定企业、企业应用、资料类型、表头行数、数据起始行并复用映射方案;每个源列可映射到签名名称、用途、所属签名、站点名称、URL、备注或报备字段库中的动态字段,同时配置文本/图片/文件、必填和转换规则。源文件中的签名名称同样必须使用完整中文黑括号格式 `【签名】`,不得通过导入绕过页面/API签名校验;源文件字段名称和顺序不固定,映射方案必须可持久化复用。 2. 导入分为“解析预览”和“确认入库”两步。用户可指定企业、企业应用、资料类型、表头行数、数据起始行并复用映射方案;每个源列可映射到签名名称、用途、所属签名、引流 URL 或号码、备注或报备字段库中的动态字段,同时配置文本/图片/文件、必填和转换规则。源文件中的签名名称同样必须使用完整中文黑括号格式 `【签名】`,不得通过导入绕过页面/API签名校验;源文件字段名称和顺序不固定,映射方案必须可持久化复用。
3. 导入和业务页面的新建/修改只将已审核签名或引流信息标记为待报备,并递增材料版本;不得在每次导入后自动创建通道报备任务。运营人员可跨签名、跨引流信息勾选资料,一次创建统一报备批次。 3. 导入和业务页面的新建/修改只将已审核签名或引流信息标记为待报备,并递增材料版本;不得在每次导入后自动创建通道报备任务。运营人员可跨签名、跨引流信息勾选资料,一次创建统一报备批次。
4. 创建批次时按每条资料所属企业应用的当前生效路由规则展开所有通道;一个签名走多个通道时,必须为每个通道创建或重置独立报备任务并生成一份该通道的 `.xlsx`。无生效路由、通道未配置字段或缺少通道必填资料时,该资料继续保留在待报备池,任务进入“资料待补充”,不得伪装为已完成。 4. 创建批次时按每条资料所属企业应用的当前生效路由规则展开所有通道;一个签名走多个通道时,必须为每个通道创建或重置独立报备任务并生成一份该通道的 `.xlsx`。无生效路由、通道未配置字段或缺少通道必填资料时,该资料继续保留在待报备池,任务进入“资料待补充”,不得伪装为已完成。
5. 通道“配置签名报备字段”和“配置引流信息字段”弹窗使用字段池,按资料类型分别配置。每列包含标准字段、通道导出表头、列顺序、必填、说明、列宽、文本转换、缺省值以及图片宽高;导出表头和列顺序必须严格使用通道配置,不受导入表格原始名称和顺序影响。 5. 通道“配置签名报备字段”和“配置引流信息字段”弹窗使用字段池,按资料类型分别配置。每列包含标准字段、通道导出表头、列顺序、必填、说明、列宽、文本转换、缺省值以及图片宽高;导出表头和列顺序必须严格使用通道配置,不受导入表格原始名称和顺序影响。
@@ -2179,3 +2179,10 @@
- 客户端签名与引流列表不展示使用场景、已提交资料或审核状态,只展示移动、联通、电信三网可用性;全部通过和部分通过均显示“报备通过”,数据来自当前应用路由和真实通道报备任务汇总。 - 客户端签名与引流列表不展示使用场景、已提交资料或审核状态,只展示移动、联通、电信三网可用性;全部通过和部分通过均显示“报备通过”,数据来自当前应用路由和真实通道报备任务汇总。
- 人工审核批量任务把`pending_review`独立显示为“待人工审核”,审核期间进度为0;客户端仅允许取消`scheduled`任务,并展示审核原因和驳回原因。运营审核页展示审核任务号与关联批量任务号。 - 人工审核批量任务把`pending_review`独立显示为“待人工审核”,审核期间进度为0;客户端仅允许取消`scheduled`任务,并展示审核原因和驳回原因。运营审核页展示审核任务号与关联批量任务号。
- 运营端签名质量的通道活跃度热力图支持通道名搜索;短信任务进度支持后端任务状态查询。 - 运营端签名质量的通道活跃度热力图支持通道名搜索;短信任务进度支持后端任务状态查询。
## 2026-08-28 签名与引流三网状态及引流字段统一
- 客户端“签名与引流信息”列表将移动、联通、电信的真实报备可用性集中展示为同一组三网状态单元;每个单元同时显示运营商名称、状态指示和“报备通过/暂不可用”,签名与关联引流信息使用一致布局。状态继续来自应用当前路由、通道运营商范围和真实报备任务汇总,不新增静态兜底或前端推测。
- 引流信息的业务主字段统一为“引流 URL 或号码”,支持 `http/https` URL、手机号码和固定电话号码。客户端新增/修改弹窗不再显示或要求“名称”,原“访问地址”统一改名为“引流 URL 或号码”。
- API 和服务端必须真实接受上述三种内容并拒绝无效任意文本。数据库既有 `SmsDrainageInfo.siteName` 仅作为兼容列保留,新建或修改时由后端同步写入规范化后的 URL/号码;客户端不得继续提交或依赖独立名称。
- 运营端单条审核列表、审核详情、导入审核、报备任务和报备记录统一只展示 URL/号码,不再把兼容列作为独立名称。批量导入映射和官方模板去掉“站点名称”必填列,只要求所属短信签名及“引流 URL 或号码”。
+12
View File
@@ -4952,3 +4952,15 @@ npm run verify:phase8
| TC-UI-REVIEW-008 | 创建命中人工审核规则的批量任务 | 两端显示“待人工审核”、进度为0;客户端无终止按钮,详情显示审核原因,运营审核页可见关联批量任务号 | | TC-UI-REVIEW-008 | 创建命中人工审核规则的批量任务 | 两端显示“待人工审核”、进度为0;客户端无终止按钮,详情显示审核原因,运营审核页可见关联批量任务号 |
| TC-UI-REVIEW-009 | 审核通过或驳回批量任务 | 状态按真实后端刷新;驳回时展示原因,不重复入队或发送 | | TC-UI-REVIEW-009 | 审核通过或驳回批量任务 | 状态按真实后端刷新;驳回时展示原因,不重复入队或发送 |
| TC-UI-REVIEW-010 | 接口对接某个日志子接口失败 | 接口概览仍可用且提示中文,不直接显示`Internal server error` | | TC-UI-REVIEW-010 | 接口对接某个日志子接口失败 | 接口概览仍可用且提示中文,不直接显示`Internal server error` |
## TC-DRAINAGE-UI-20260828 三网状态与引流字段统一
| 用例ID | 场景 | 预期 |
| --- | --- | --- |
| TC-DRAINAGE-UI-001 | 客户端查看签名及展开后的引流信息列表 | 移动、联通、电信在同一组三网状态单元中清晰展示;每项含运营商名称和真实“报备通过/暂不可用”状态,签名与引流行布局一致 |
| TC-DRAINAGE-UI-002 | 客户端打开新增或修改引流信息弹窗 | 仅有必填“引流 URL 或号码”,不存在“名称”和“访问地址”;提示明确支持 URL、手机号码和固定电话号码 |
| TC-DRAINAGE-UI-003 | 分别提交 `https://example.com/path``13800138000``0755-12345678` | 三种输入均通过真实客户端 API 和服务端校验,写入 PostgreSQL;兼容 `siteName` 列与 `url` 列同步保存相同目标值,进入真实待审核流程 |
| TC-DRAINAGE-UI-004 | 提交普通文字或空值 | 前端禁止空值提交;绕过前端提交普通文字时后端返回受控参数错误,不写数据库、不创建审核记录 |
| TC-DRAINAGE-UI-005 | 运营端查看单条审核列表、详情、报备任务及报备记录 | 统一显示“引流 URL 或号码”及真实目标值,不再显示独立站点名称或旧“引流地址”标签;审核通过/驳回仍调用原真实 API |
| TC-DRAINAGE-UI-006 | 下载引流官方导入模板并配置导入映射 | 模板和映射仅要求“所属短信签名”“引流 URL 或号码”,不再要求“站点名称”;导入项进入真实审核批次 |
| TC-DRAINAGE-UI-007 | 桌面和窄屏查看三网状态组及引流列表 | 状态单元不相互覆盖,文字不截断为不可辨认内容;窄屏沿用受控列表滚动,不产生页面级横向溢出 |
+2 -2
View File
@@ -54,9 +54,9 @@ export const adminGovernanceApi = {
request<SmsDrainageInfo[]>(withQuery('/admin/drainage-infos', query)), request<SmsDrainageInfo[]>(withQuery('/admin/drainage-infos', query)),
listAuditRecords: (query: { targetType?: string; targetId?: string } = {}) => listAuditRecords: (query: { targetType?: string; targetId?: string } = {}) =>
request<AuditRecord[]>(withQuery('/admin/audit-records', query)), request<AuditRecord[]>(withQuery('/admin/audit-records', query)),
createDrainageInfo: (signatureId: string, body: { siteName: string; url: string; remark?: string; reportValues?: Record<string, unknown> }) => createDrainageInfo: (signatureId: string, body: { url: string; remark?: string; reportValues?: Record<string, unknown> }) =>
request<SmsDrainageInfo>(`/admin/enterprise-signatures/${signatureId}/drainage-infos`, { method: 'POST', body: JSON.stringify(body) }), request<SmsDrainageInfo>(`/admin/enterprise-signatures/${signatureId}/drainage-infos`, { method: 'POST', body: JSON.stringify(body) }),
updateDrainageInfo: (id: string, body: { siteName?: string; url?: string; remark?: string; reportValues?: Record<string, unknown> }) => updateDrainageInfo: (id: string, body: { url?: string; remark?: string; reportValues?: Record<string, unknown> }) =>
request<SmsDrainageInfo>(`/admin/drainage-infos/${id}`, { method: 'PUT', body: JSON.stringify(body) }), request<SmsDrainageInfo>(`/admin/drainage-infos/${id}`, { method: 'PUT', body: JSON.stringify(body) }),
approveDrainageInfo: (id: string) => approveDrainageInfo: (id: string) =>
request<SmsDrainageInfo>(`/admin/drainage-infos/${id}/approve`, { method: 'POST', body: JSON.stringify({}) }), request<SmsDrainageInfo>(`/admin/drainage-infos/${id}/approve`, { method: 'POST', body: JSON.stringify({}) }),
+2 -2
View File
@@ -182,7 +182,7 @@ export const clientApi = {
}), }),
createDrainageInfo: ( createDrainageInfo: (
signatureId: string, signatureId: string,
body: { siteName: string; url: string; remark?: string; reportValues?: Record<string, unknown> }, body: { url: string; remark?: string; reportValues?: Record<string, unknown> },
) => ) =>
request<SmsDrainageInfo>(`/client/signatures/${signatureId}/drainage-infos`, { request<SmsDrainageInfo>(`/client/signatures/${signatureId}/drainage-infos`, {
method: 'POST', method: 'POST',
@@ -190,7 +190,7 @@ export const clientApi = {
}), }),
updateDrainageInfo: ( updateDrainageInfo: (
id: string, id: string,
body: { siteName?: string; url?: string; remark?: string; reportValues?: Record<string, unknown> }, body: { url?: string; remark?: string; reportValues?: Record<string, unknown> },
) => request<SmsDrainageInfo>(`/client/drainage-infos/${id}`, { method: 'PUT', body: JSON.stringify(body) }), ) => request<SmsDrainageInfo>(`/client/drainage-infos/${id}`, { method: 'PUT', body: JSON.stringify(body) }),
changeDrainageInfoStatus: (id: string, status: string) => changeDrainageInfoStatus: (id: string, status: string) =>
request<SmsDrainageInfo>(`/client/drainage-infos/${id}/status`, { request<SmsDrainageInfo>(`/client/drainage-infos/${id}/status`, {
+3 -3
View File
@@ -73,14 +73,14 @@ function DetailModal({ drainage, reportedAt, signature, task, onClose }: { drain
return ( return (
<Modal footer={<Button onClick={onClose}></Button>} onClose={onClose} open size="xl" title={drainage ? '查看引流信息详情' : '查看签名详情'}> <Modal footer={<Button onClick={onClose}></Button>} onClose={onClose} open size="xl" title={drainage ? '查看引流信息详情' : '查看签名详情'}>
<div className="channel-report-detail"> <div className="channel-report-detail">
<strong>{drainage ? String(drainage.siteName || drainage.url || '引流信息') : formatSignatureName(signature?.name ?? task.signature?.name)}</strong> <strong>{drainage ? String(drainage.url || '引流信息') : formatSignatureName(signature?.name ?? task.signature?.name)}</strong>
<p><span></span><span>{signature?.tenant?.name ?? task.tenantId}</span></p> <p><span></span><span>{signature?.tenant?.name ?? task.tenantId}</span></p>
<p><span></span><span>{signature?.application?.name ?? '-'}</span></p> <p><span></span><span>{signature?.application?.name ?? '-'}</span></p>
<p><span></span><DateTime value={drainage?.submittedAt ?? task.createdAt} /></p> <p><span></span><DateTime value={drainage?.submittedAt ?? task.createdAt} /></p>
<p><span></span><DateTime value={reportedAt} /></p> <p><span></span><DateTime value={reportedAt} /></p>
<p><span></span><DateTime value={task.lastSuccessfulSentAt} /></p> <p><span></span><DateTime value={task.lastSuccessfulSentAt} /></p>
{!drainage ? <><p><span></span><span>{String(profile.basis ?? '-')}</span></p><p><span></span><span>{String(profile.companyName ?? '-')}</span></p><p><span></span><span>{String(profile.creditCode ?? '-')}</span></p></> : null} {!drainage ? <><p><span></span><span>{String(profile.basis ?? '-')}</span></p><p><span></span><span>{String(profile.companyName ?? '-')}</span></p><p><span></span><span>{String(profile.creditCode ?? '-')}</span></p></> : null}
{drainage ? <><p><span></span><span>{String(drainage.url ?? '-')}</span></p><p><span></span><span>{String(drainage.remark ?? '-')}</span></p></> : null} {drainage ? <><p><span> URL </span><span>{String(drainage.url ?? '-')}</span></p><p><span></span><span>{String(drainage.remark ?? '-')}</span></p></> : null}
{Object.entries(reportValues).map(([key, value]) => <p key={key}><span>{key}</span><span>{typeof value === 'object' ? String(asRecord(value).fileName ?? asRecord(value).fileObjectId ?? '-') : String(value ?? '-')}</span></p>)} {Object.entries(reportValues).map(([key, value]) => <p key={key}><span>{key}</span><span>{typeof value === 'object' ? String(asRecord(value).fileName ?? asRecord(value).fileObjectId ?? '-') : String(value ?? '-')}</span></p>)}
<section><h3></h3><DeliveryStats task={task} /></section> <section><h3></h3><DeliveryStats task={task} /></section>
</div> </div>
@@ -185,7 +185,7 @@ export function AdminChannelReportPage() {
const reportedAt = task.approvedAt ?? approvedRecord(task.id)?.createdAt; const reportedAt = task.approvedAt ?? approvedRecord(task.id)?.createdAt;
return <div className={`channel-report-row ${drainage ? 'channel-report-row--drainage' : 'channel-report-row--signature'}`} key={task.id}> return <div className={`channel-report-row ${drainage ? 'channel-report-row--drainage' : 'channel-report-row--signature'}`} key={task.id}>
<span /> <span />
<div className={`channel-report-name ${drainage ? 'channel-report-name--flow' : ''}`}>{drainage ? <i /> : null}<span><strong>{drainage ? String(drainage.siteName || drainage.url || '引流信息') : formatSignatureName(signature?.name ?? task.signature?.name)}</strong><small>{drainage ? `${String(drainage.url ?? '')} · ${formatSignatureName(signature?.name ?? task.signature?.name)}` : <>{signature?.tenant?.name ?? task.tenantId} · {task.carrier ? <CarrierTag carrier={task.carrier} /> : '历史通道级(未拆分)'}</>}</small></span></div> <div className={`channel-report-name ${drainage ? 'channel-report-name--flow' : ''}`}>{drainage ? <i /> : null}<span><strong>{drainage ? String(drainage.url || '引流信息') : formatSignatureName(signature?.name ?? task.signature?.name)}</strong><small>{drainage ? formatSignatureName(signature?.name ?? task.signature?.name) : <>{signature?.tenant?.name ?? task.tenantId} · {task.carrier ? <CarrierTag carrier={task.carrier} /> : '历史通道级(未拆分)'}</>}</small></span></div>
<ReportStatus value={task.status} /> <ReportStatus value={task.status} />
<DateTime value={drainage?.submittedAt ?? task.createdAt} /> <DateTime value={drainage?.submittedAt ?? task.createdAt} />
<DateTime value={reportedAt} /> <DateTime value={reportedAt} />
+3 -4
View File
@@ -30,8 +30,7 @@ function DrainageDetail({ item, onClose }: { item: SmsDrainageInfo; onClose: ()
<div><span></span><strong>{item.application?.name ?? '-'}</strong></div> <div><span></span><strong>{item.application?.name ?? '-'}</strong></div>
<div><span></span><strong>{item.signature?.name ?? item.signatureId}</strong></div> <div><span></span><strong>{item.signature?.name ?? item.signatureId}</strong></div>
<div><span></span><Tag tone={meta.tone}>{meta.label}</Tag></div> <div><span></span><Tag tone={meta.tone}>{meta.label}</Tag></div>
<div><span></span><strong>{item.siteName}</strong></div> <div className="detail-grid__wide"><span> URL </span><strong>{item.url}</strong></div>
<div><span></span><strong>{item.url}</strong></div>
<div><span></span><strong>{formatDateTime(item.submittedAt)}</strong></div> <div><span></span><strong>{formatDateTime(item.submittedAt)}</strong></div>
<AuditReviewInfo targetId={item.id} targetType="sms_drainage_info" /> <AuditReviewInfo targetId={item.id} targetType="sms_drainage_info" />
<div className="detail-grid__wide"><span></span><strong>{item.remark || '-'}</strong></div> <div className="detail-grid__wide"><span></span><strong>{item.remark || '-'}</strong></div>
@@ -83,7 +82,7 @@ export function AdminDrainageAuditPage() {
} }
const columns = useMemo<Array<TableColumn<SmsDrainageInfo>>>(() => [ const columns = useMemo<Array<TableColumn<SmsDrainageInfo>>>(() => [
{ key: 'siteName', title: '站名称/引流地址', render: (record) => <div className="admin-task-enterprise"><strong>{record.siteName}</strong><span>{record.url}</span></div> }, { key: 'url', title: '引流 URL 或号码', render: (record) => <strong>{record.url}</strong> },
{ key: 'signature', title: '所属签名', render: (record) => record.signature?.name ?? record.signatureId }, { key: 'signature', title: '所属签名', render: (record) => record.signature?.name ?? record.signatureId },
{ key: 'tenant', title: '企业/应用', render: (record) => <div className="admin-task-enterprise"><strong>{record.tenant?.name ?? record.tenantId}</strong><span>{record.application?.name ?? '-'}</span></div> }, { key: 'tenant', title: '企业/应用', render: (record) => <div className="admin-task-enterprise"><strong>{record.tenant?.name ?? record.tenantId}</strong><span>{record.application?.name ?? '-'}</span></div> },
{ key: 'submittedAt', title: '提交时间', render: (record) => formatDateTime(record.submittedAt) }, { key: 'submittedAt', title: '提交时间', render: (record) => formatDateTime(record.submittedAt) },
@@ -95,7 +94,7 @@ export function AdminDrainageAuditPage() {
<div className="page-heading"><div><Breadcrumb items={['审核中心', '引流信息审核']} /><h1></h1></div></div> <div className="page-heading"><div><Breadcrumb items={['审核中心', '引流信息审核']} /><h1></h1></div></div>
{error ? <p className="form-error">{error}</p> : null} {error ? <p className="form-error">{error}</p> : null}
<Tabs items={[ <Tabs items={[
{ label: '单条引流信息审核', value: 'single', content: <div className="page-stack"><div className="surface audit-filter-card"><div className="ui-filter-row"><Input label="搜索" onChange={(event) => setKeyword(event.target.value)} placeholder="搜索企业、应用、签名、站点或网址" prefix={<Search size={16} />} value={keyword} /><Select label="审核状态" onChange={(event) => setStatus(event.target.value)} options={[{ label: '全部状态', value: 'all' }, { label: '待审核', value: 'pending' }, { label: '已通过', value: 'approved' }, { label: '已驳回', value: 'rejected' }]} value={status} /><DateRangeInput label="提交时间" onChange={setSubmittedDateRange} value={submittedDateRange} /><div className="audit-filter-actions ui-filter-actions"><Button icon={<Search size={17} />} onClick={loadData}></Button><Button onClick={() => { setKeyword(''); setStatus('pending'); setSubmittedDateRange({}); }} variant="ghost"></Button></div></div></div><div className="surface"><Table columns={columns} data={items} emptyText="暂无引流信息审核记录" rowKey="id" /></div></div> }, { label: '单条引流信息审核', value: 'single', content: <div className="page-stack"><div className="surface audit-filter-card"><div className="ui-filter-row"><Input label="搜索" onChange={(event) => setKeyword(event.target.value)} placeholder="搜索企业、应用、签名、URL或号码" prefix={<Search size={16} />} value={keyword} /><Select label="审核状态" onChange={(event) => setStatus(event.target.value)} options={[{ label: '全部状态', value: 'all' }, { label: '待审核', value: 'pending' }, { label: '已通过', value: 'approved' }, { label: '已驳回', value: 'rejected' }]} value={status} /><DateRangeInput label="提交时间" onChange={setSubmittedDateRange} value={submittedDateRange} /><div className="audit-filter-actions ui-filter-actions"><Button icon={<Search size={17} />} onClick={loadData}></Button><Button onClick={() => { setKeyword(''); setStatus('pending'); setSubmittedDateRange({}); }} variant="ghost"></Button></div></div></div><div className="surface"><Table columns={columns} data={items} emptyText="暂无引流信息审核记录" rowKey="id" /></div></div> },
{ label: '导入批次审核', value: 'import', content: <ReportImportAuditPanel reportType="drainage" /> }, { label: '导入批次审核', value: 'import', content: <ReportImportAuditPanel reportType="drainage" /> },
]} /> ]} />
{detail ? <DrainageDetail item={detail} onClose={() => setDetail(undefined)} /> : null} {detail ? <DrainageDetail item={detail} onClose={() => setDetail(undefined)} /> : null}
@@ -104,7 +104,7 @@ export function AdminEnterpriseSignaturesPage() {
return; return;
} }
const exists = readDrainagePayload(signature).links.some((current) => current.id === item.id); const exists = readDrainagePayload(signature).links.some((current) => current.id === item.id);
const body = { siteName: item.url.trim(), url: item.url.trim(), remark: item.remark, reportValues: item.reportValues }; const body = { url: item.url.trim(), remark: item.remark, reportValues: item.reportValues };
if (exists) await adminApi.updateDrainageInfo(item.id, body); if (exists) await adminApi.updateDrainageInfo(item.id, body);
else await adminApi.createDrainageInfo(signatureId, body); else await adminApi.createDrainageInfo(signatureId, body);
setDrainageModal(null); setDrainageModal(null);
+2 -2
View File
@@ -40,7 +40,7 @@ function recordSource(record: ReportRecord) {
function RecordDetailModal({ record, onClose }: { record: ReportRecord; onClose: () => void }) { function RecordDetailModal({ record, onClose }: { record: ReportRecord; onClose: () => void }) {
const isDrainage = record.task?.reportType === 'drainage'; const isDrainage = record.task?.reportType === 'drainage';
const target = isDrainage ? record.task?.drainageInfo?.siteName ?? record.task?.drainageInfo?.url : record.task?.signature?.name; const target = isDrainage ? record.task?.drainageInfo?.url : record.task?.signature?.name;
return ( return (
<Modal footer={<Button onClick={onClose}></Button>} onClose={onClose} open size="xl" title={<div className="template-modal-title"><h2></h2><p>{record.id}</p></div>}> <Modal footer={<Button onClick={onClose}></Button>} onClose={onClose} open size="xl" title={<div className="template-modal-title"><h2></h2><p>{record.id}</p></div>}>
<div className="report-record-detail"> <div className="report-record-detail">
@@ -100,7 +100,7 @@ export function AdminReportRecordsPage() {
{ key: 'task', title: '报备任务号', width: '190px', render: (record) => <strong className="admin-task-id">{record.taskId}</strong> }, { key: 'task', title: '报备任务号', width: '190px', render: (record) => <strong className="admin-task-id">{record.taskId}</strong> },
{ key: 'channel', title: '通道名称', width: '180px', render: (record) => record.channel?.name ?? '-' }, { key: 'channel', title: '通道名称', width: '180px', render: (record) => record.channel?.name ?? '-' },
{ key: 'targetType', title: '变更主体', width: '110px', render: (record) => <Tag tone={record.task?.reportType === 'drainage' ? 'info' : 'neutral'}>{record.task?.reportType === 'drainage' ? '引流信息' : '签名'}</Tag> }, { key: 'targetType', title: '变更主体', width: '110px', render: (record) => <Tag tone={record.task?.reportType === 'drainage' ? 'info' : 'neutral'}>{record.task?.reportType === 'drainage' ? '引流信息' : '签名'}</Tag> },
{ key: 'target', title: '主体内容', width: '260px', render: (record) => record.task?.reportType === 'drainage' ? <div className="admin-task-enterprise"><strong>{record.task?.signature?.name ?? '-'}</strong><span>{record.task?.drainageInfo?.siteName ?? '-'}</span><span>{record.task?.drainageInfo?.url ?? '-'}</span>{record.task?.drainageInfo?.remark ? <span>{record.task.drainageInfo.remark}</span> : null}</div> : <div className="admin-task-enterprise"><strong>{record.task?.signature?.name ?? '-'}</strong>{record.task?.signature?.purpose ? <span>{record.task.signature.purpose}</span> : null}</div> }, { key: 'target', title: '主体内容', width: '260px', render: (record) => record.task?.reportType === 'drainage' ? <div className="admin-task-enterprise"><strong>{record.task?.signature?.name ?? '-'}</strong><span>{record.task?.drainageInfo?.url ?? '-'}</span>{record.task?.drainageInfo?.remark ? <span>{record.task.drainageInfo.remark}</span> : null}</div> : <div className="admin-task-enterprise"><strong>{record.task?.signature?.name ?? '-'}</strong>{record.task?.signature?.purpose ? <span>{record.task.signature.purpose}</span> : null}</div> },
{ key: 'source', title: '修改入口', width: '150px', render: (record) => recordSource(record) }, { key: 'source', title: '修改入口', width: '150px', render: (record) => recordSource(record) },
{ key: 'action', title: '动作', width: '170px', render: (record) => actionLabel[record.action] ?? record.action }, { key: 'action', title: '动作', width: '170px', render: (record) => actionLabel[record.action] ?? record.action },
{ key: 'status', title: '状态变化', width: '210px', render: (record) => <Tag tone={statusTone[record.statusAfter ?? 'pending'] ?? 'info'}>{`${translateStatus(record.statusBefore)}${translateStatus(record.statusAfter)}`}</Tag> }, { key: 'status', title: '状态变化', width: '210px', render: (record) => <Tag tone={statusTone[record.statusAfter ?? 'pending'] ?? 'info'}>{`${translateStatus(record.statusBefore)}${translateStatus(record.statusAfter)}`}</Tag> },
+1 -1
View File
@@ -25,7 +25,7 @@ const actionLabels: Record<string, string> = {
function taskTargetLabel(task: ReportTask) { function taskTargetLabel(task: ReportTask) {
if (task.reportType !== 'drainage') return task.signature?.name ?? task.signatureId; if (task.reportType !== 'drainage') return task.signature?.name ?? task.signatureId;
return task.drainageInfo?.siteName || task.drainageInfo?.url || task.drainageItemId || '引流信息'; return task.drainageInfo?.url || task.drainageItemId || '引流信息';
} }
function TaskDetailModal({ task, onClose }: { task: ReportTask; onClose: () => void }) { function TaskDetailModal({ task, onClose }: { task: ReportTask; onClose: () => void }) {
+1 -1
View File
@@ -22,7 +22,7 @@ const itemStatusLabels: Record<string, string> = {
function itemName(item: ReportImportReviewItem) { function itemName(item: ReportImportReviewItem) {
if (item.reportType === 'signature') return String(item.payload.name ?? '-'); if (item.reportType === 'signature') return String(item.payload.name ?? '-');
return String(item.payload.siteName ?? item.payload.url ?? '-'); return String(item.payload.url ?? '-');
} }
function tone(status: string): 'neutral' | 'info' | 'success' | 'warning' | 'danger' { function tone(status: string): 'neutral' | 'info' | 'success' | 'warning' | 'danger' {
+1 -1
View File
@@ -18,7 +18,7 @@ const transforms = [{ label: '保持原值', value: '' }, { label: '去除首尾
function coreTargets(reportType: ReportType) { function coreTargets(reportType: ReportType) {
return reportType === 'signature' return reportType === 'signature'
? [{ label: '短信签名', value: 'signatureName:signature_name:string' }, { label: '签名用途/依据', value: 'purpose:purpose:string' }] ? [{ label: '短信签名', value: 'signatureName:signature_name:string' }, { label: '签名用途/依据', value: 'purpose:purpose:string' }]
: [{ label: '所属短信签名', value: 'signatureName:signature_name:string' }, { label: '站点名称', value: 'siteName:site_name:string' }, { label: '引流地址', value: 'url:url:string' }, { label: '备注', value: 'remark:remark:string' }]; : [{ label: '所属短信签名', value: 'signatureName:signature_name:string' }, { label: '引流 URL 或号码', value: 'url:url:string' }, { label: '备注', value: 'remark:remark:string' }];
} }
export function ReportMaterialImportModal({ onClose, onCompleted }: { onClose: () => void; onCompleted: () => void }) { export function ReportMaterialImportModal({ onClose, onCompleted }: { onClose: () => void; onCompleted: () => void }) {
@@ -0,0 +1,85 @@
import { fireEvent, render, screen, within } from '@testing-library/react';
import { beforeEach, describe, expect, it, vi } from 'vitest';
import { ClientSignaturesPage } from './ClientSignaturesPage';
const { clientApi } = vi.hoisted(() => ({
clientApi: {
listApplicationOptions: vi.fn(),
getSignatureWorkspace: vi.fn(),
listApplicationReportFields: vi.fn(),
listCommonApplicationReportFields: vi.fn(),
uploadFileObject: vi.fn(),
createSignature: vi.fn(),
updateSignature: vi.fn(),
submitSignature: vi.fn(),
createDrainageInfo: vi.fn(),
updateDrainageInfo: vi.fn(),
changeDrainageInfoStatus: vi.fn(),
},
}));
vi.mock('@/api/adminApi', () => ({ clientApi }));
vi.mock('@/components/ui', () => ({
Button: ({ children, icon: _icon, ...props }: React.ButtonHTMLAttributes<HTMLButtonElement> & { icon?: React.ReactNode }) => <button {...props}>{children}</button>,
CarrierTag: ({ carrier }: { carrier: string }) => <span>{({ mobile: '移动', unicom: '联通', telecom: '电信' } as Record<string, string>)[carrier]}</span>,
DeleteRiskAction: () => <button type="button"></button>,
FileActions: () => null,
Input: ({ hint, label, prefix: _prefix, ...props }: React.InputHTMLAttributes<HTMLInputElement> & { hint?: string; label?: string; prefix?: React.ReactNode }) => <label>{label}<input aria-label={label} {...props} />{hint ? <small>{hint}</small> : null}</label>,
Modal: ({ children, footer, open, title }: { children: React.ReactNode; footer: React.ReactNode; open: boolean; title: string }) => open ? <div aria-label={title} role="dialog">{children}{footer}</div> : null,
Pagination: () => null,
Select: ({ label, options, ...props }: React.SelectHTMLAttributes<HTMLSelectElement> & { label?: string; options: Array<{ label: string; value: string }> }) => <label>{label}<select aria-label={label} {...props}>{options.map((option) => <option key={option.value} value={option.value}>{option.label}</option>)}</select></label>,
Textarea: ({ label, ...props }: React.TextareaHTMLAttributes<HTMLTextAreaElement> & { label?: string }) => <label>{label}<textarea aria-label={label} {...props} /></label>,
}));
const signature = {
id: 'signature-1',
tenantId: 'tenant-1',
applicationId: 'app-1',
name: '【测试签名】',
auditStatus: 'approved',
createdAt: '2026-08-28T00:00:00.000Z',
updatedAt: '2026-08-28T01:00:00.000Z',
application: { id: 'app-1', name: '测试应用', status: 'active' },
submittedMaterialCount: 0,
reportValues: {},
carrierReportSummary: {
mobile: { status: 'approved', approved: 1, total: 1 },
unicom: { status: 'pending', approved: 0, total: 1 },
telecom: { status: 'partial_success', approved: 1, total: 2 },
},
drainageCarrierReportSummary: {},
drainageInfo: { links: [] },
};
describe('ClientSignaturesPage drainage presentation', () => {
beforeEach(() => {
Object.values(clientApi).forEach((mock) => mock.mockReset());
clientApi.listApplicationOptions.mockResolvedValue([{ id: 'app-1', name: '测试应用', status: 'active' }]);
clientApi.getSignatureWorkspace.mockResolvedValue({ items: [signature], summary: { total: 1, pending: 0, approved: 1, rejected: 0, draft: 0 }, total: 1, page: 1, pageSize: 10 });
clientApi.listApplicationReportFields.mockResolvedValue([]);
});
it('groups the three real carrier summaries into a readable status area', async () => {
render(<ClientSignaturesPage />);
expect(await screen.findByText('【测试签名】')).toBeVisible();
expect(screen.getByText('三网报备状态')).toBeVisible();
const row = screen.getByText('【测试签名】').closest('.client-signature-list-row');
expect(row).not.toBeNull();
expect(within(row as HTMLElement).getByText('移动')).toBeVisible();
expect(within(row as HTMLElement).getByText('联通')).toBeVisible();
expect(within(row as HTMLElement).getByText('电信')).toBeVisible();
expect(within(row as HTMLElement).getAllByText('报备通过')).toHaveLength(2);
expect(within(row as HTMLElement).getByText('暂不可用')).toBeVisible();
});
it('uses one URL-or-number field and removes the redundant name field', async () => {
render(<ClientSignaturesPage />);
await screen.findByText('【测试签名】');
fireEvent.click(screen.getByRole('button', { name: '展开引流信息' }));
fireEvent.click(screen.getByRole('button', { name: '新增引流信息' }));
const dialog = screen.getByRole('dialog', { name: '新增引流信息' });
expect(within(dialog).getByLabelText('引流 URL 或号码')).toBeVisible();
expect(within(dialog).queryByLabelText('名称')).not.toBeInTheDocument();
expect(within(dialog).queryByLabelText('访问地址')).not.toBeInTheDocument();
});
});
+24 -16
View File
@@ -1,6 +1,6 @@
import { useEffect, useState } from 'react'; import { useEffect, useState } from 'react';
import { ChevronDown, ChevronRight, Edit3, FileCheck2, Globe2, Plus, RotateCcw, Search, Trash2, Upload } from 'lucide-react'; import { ChevronDown, ChevronRight, Edit3, FileCheck2, Globe2, Plus, RotateCcw, Search, Trash2, Upload } from 'lucide-react';
import { Button, DeleteRiskAction, FileActions, Input, Modal, Pagination, Select, Tag, Textarea } from '@/components/ui'; import { Button, CarrierTag, DeleteRiskAction, FileActions, Input, Modal, Pagination, Select, Textarea } from '@/components/ui';
import { import {
clientApi, clientApi,
type ClientApplicationReportField, type ClientApplicationReportField,
@@ -22,9 +22,19 @@ const EMPTY_WORKSPACE: ClientSignatureWorkspace = {
type ClientDrainageInfo = ClientSmsSignatureView['drainageInfo']['links'][number]; type ClientDrainageInfo = ClientSmsSignatureView['drainageInfo']['links'][number];
type Carrier = 'mobile' | 'unicom' | 'telecom'; type Carrier = 'mobile' | 'unicom' | 'telecom';
function CarrierAvailability({ summary }: { summary?: { status: string; approved: number; total: number } }) { function CarrierAvailability({ carrier, summary }: { carrier: Carrier; summary?: { status: string; approved: number; total: number } }) {
const available = Boolean(summary && (summary.approved > 0 || ['approved', 'partial_success'].includes(summary.status))); const available = Boolean(summary && (summary.approved > 0 || ['approved', 'partial_success'].includes(summary.status)));
return <Tag tone={available ? 'success' : 'neutral'}>{available ? '报备通过' : '暂不可用'}</Tag>; return <div className={`client-carrier-status client-carrier-status--${available ? 'available' : 'unavailable'}`}>
<CarrierTag carrier={carrier} />
<span aria-hidden className="client-carrier-status__dot" />
<strong>{available ? '报备通过' : '暂不可用'}</strong>
</div>;
}
function DrainageTarget({ value }: { value: string }) {
return /^https?:\/\//i.test(value)
? <a className="client-drainage-target" href={value} rel="noreferrer" target="_blank" title={value}>{value}</a>
: <span className="client-drainage-target" title={value}>{value}</span>;
} }
function reportFileRef(value: unknown): FileRef | null { function reportFileRef(value: unknown): FileRef | null {
@@ -189,7 +199,6 @@ function SignatureModal({
function DrainageModal({ item, signature, onClose, onSaved }: { item?: ClientDrainageInfo; signature: ClientSmsSignatureView; onClose: () => void; onSaved: () => void }) { function DrainageModal({ item, signature, onClose, onSaved }: { item?: ClientDrainageInfo; signature: ClientSmsSignatureView; onClose: () => void; onSaved: () => void }) {
const [fields, setFields] = useState<ClientApplicationReportField[]>([]); const [fields, setFields] = useState<ClientApplicationReportField[]>([]);
const [siteName, setSiteName] = useState(item?.siteName ?? '');
const [url, setUrl] = useState(item?.url ?? ''); const [url, setUrl] = useState(item?.url ?? '');
const [remark, setRemark] = useState(item?.remark ?? ''); const [remark, setRemark] = useState(item?.remark ?? '');
const [values, setValues] = useState<Record<string, unknown>>(item?.reportValues ?? {}); const [values, setValues] = useState<Record<string, unknown>>(item?.reportValues ?? {});
@@ -221,7 +230,7 @@ function DrainageModal({ item, signature, onClose, onSaved }: { item?: ClientDra
setSaving(true); setSaving(true);
setError(''); setError('');
try { try {
const body = { siteName: siteName.trim(), url: url.trim(), remark: remark?.trim(), reportValues: values }; const body = { url: url.trim(), remark: remark?.trim(), reportValues: values };
if (item) await clientApi.updateDrainageInfo(item.id, body); if (item) await clientApi.updateDrainageInfo(item.id, body);
else await clientApi.createDrainageInfo(signature.id, body); else await clientApi.createDrainageInfo(signature.id, body);
onSaved(); onSaved();
@@ -234,7 +243,7 @@ function DrainageModal({ item, signature, onClose, onSaved }: { item?: ClientDra
const missingRequired = fields.some((field) => field.required && !values[field.code]); const missingRequired = fields.some((field) => field.required && !values[field.code]);
return <Modal return <Modal
footer={<><Button onClick={onClose} variant="ghost"></Button><Button disabled={!siteName.trim() || !url.trim() || missingRequired || saving || Boolean(uploadingCode)} onClick={() => void save()}>{saving ? '提交中...' : '提交审核'}</Button></>} footer={<><Button onClick={onClose} variant="ghost"></Button><Button disabled={!url.trim() || missingRequired || saving || Boolean(uploadingCode)} onClick={() => void save()}>{saving ? '提交中...' : '提交审核'}</Button></>}
onClose={onClose} onClose={onClose}
open open
size="xl" size="xl"
@@ -242,11 +251,10 @@ function DrainageModal({ item, signature, onClose, onSaved }: { item?: ClientDra
> >
<div className="signature-form"> <div className="signature-form">
{item?.rejectReason ? <div className="client-signature-reason"><strong></strong><span>{item.rejectReason}</span></div> : null} {item?.rejectReason ? <div className="client-signature-reason"><strong></strong><span>{item.rejectReason}</span></div> : null}
<Input label="名称" onChange={(event) => setSiteName(event.target.value)} placeholder="例如:品牌官网" required value={siteName} /> <Input hint="支持 http/https URL、手机号码或固定电话号码" label="引流 URL 或号码" onChange={(event) => setUrl(event.target.value)} placeholder="例如:https://example.com 或 13800138000" required value={url} />
<Input label="访问地址" onChange={(event) => setUrl(event.target.value)} placeholder="https://" required value={url} />
<Textarea label="说明" onChange={(event) => setRemark(event.target.value)} rows={3} value={remark ?? ''} /> <Textarea label="说明" onChange={(event) => setRemark(event.target.value)} rows={3} value={remark ?? ''} />
<section className="client-signature-form-section"> <section className="client-signature-form-section">
<div><h3></h3><p></p></div> <div><h3></h3><p> URL </p></div>
<ReviewFields fields={fields} onChange={(code, value) => setValues((current) => ({ ...current, [code]: value }))} onUpload={(field, file) => void upload(field, file)} uploadingCode={uploadingCode} values={values} /> <ReviewFields fields={fields} onChange={(code, value) => setValues((current) => ({ ...current, [code]: value }))} onUpload={(field, file) => void upload(field, file)} uploadingCode={uploadingCode} values={values} />
</section> </section>
{error ? <p className="form-error">{error}</p> : null} {error ? <p className="form-error">{error}</p> : null}
@@ -329,7 +337,7 @@ export function ClientSignaturesPage() {
<header className="client-signature-heading"> <header className="client-signature-heading">
<div className="client-signature-title"> <div className="client-signature-title">
<span className="client-signature-title__icon"><FileCheck2 size={23} /></span> <span className="client-signature-title__icon"><FileCheck2 size={23} /></span>
<div><h1></h1><p>使</p></div> <div><h1></h1><p>使 URL</p></div>
</div> </div>
<Button icon={<Plus size={17} />} onClick={() => setSignatureModal('new')}></Button> <Button icon={<Plus size={17} />} onClick={() => setSignatureModal('new')}></Button>
</header> </header>
@@ -342,7 +350,7 @@ export function ClientSignaturesPage() {
{error ? <p className="form-error">{error}</p> : null} {error ? <p className="form-error">{error}</p> : null}
<section className="client-signature-list-shell"> <section className="client-signature-list-shell">
<div className="client-signature-list-head"><span /><span></span><span></span><span></span><span></span><span></span><span></span><span></span></div> <div className="client-signature-list-head"><span /><span></span><span></span><span></span><span></span><span></span></div>
{loading ? <p className="client-signature-list-empty">...</p> : null} {loading ? <p className="client-signature-list-empty">...</p> : null}
{!loading && !visibleItems.length ? <p className="client-signature-list-empty"></p> : null} {!loading && !visibleItems.length ? <p className="client-signature-list-empty"></p> : null}
{visibleItems.map((signature) => { {visibleItems.map((signature) => {
@@ -354,7 +362,7 @@ export function ClientSignaturesPage() {
<button aria-label={expanded ? '收起引流信息' : '展开引流信息'} className="client-signature-expand" onClick={() => toggleExpanded(signature.id)} type="button">{expanded ? <ChevronDown size={18} /> : <ChevronRight size={18} />}</button> <button aria-label={expanded ? '收起引流信息' : '展开引流信息'} className="client-signature-expand" onClick={() => toggleExpanded(signature.id)} type="button">{expanded ? <ChevronDown size={18} /> : <ChevronRight size={18} />}</button>
<strong>{signature.name}</strong> <strong>{signature.name}</strong>
<span>{signature.application?.name ?? '未绑定'}</span> <span>{signature.application?.name ?? '未绑定'}</span>
{(['mobile', 'unicom', 'telecom'] as Carrier[]).map((carrier) => <CarrierAvailability key={carrier} summary={signature.carrierReportSummary?.[carrier]} />)} <div className="client-carrier-status-group">{(['mobile', 'unicom', 'telecom'] as Carrier[]).map((carrier) => <CarrierAvailability carrier={carrier} key={carrier} summary={signature.carrierReportSummary?.[carrier]} />)}</div>
<span>{formatDate(signature.updatedAt)}</span> <span>{formatDate(signature.updatedAt)}</span>
<div className="table-actions"> <div className="table-actions">
<Button disabled={!editable} icon={<Edit3 size={14} />} onClick={() => setSignatureModal(signature)} size="sm" variant="ghost"></Button> <Button disabled={!editable} icon={<Edit3 size={14} />} onClick={() => setSignatureModal(signature)} size="sm" variant="ghost"></Button>
@@ -362,12 +370,12 @@ export function ClientSignaturesPage() {
</div> </div>
</div> </div>
{expanded ? <div className="client-drainage-panel"> {expanded ? <div className="client-drainage-panel">
<div className="client-drainage-panel__head"><div><h3><Globe2 size={17} /> </h3><p>使</p></div><Button disabled={signature.auditStatus !== 'approved'} icon={<Plus size={15} />} onClick={() => setDrainageModal({ signature })} size="sm" variant="ghost"></Button></div> <div className="client-drainage-panel__head"><div><h3><Globe2 size={17} /> </h3><p>使 URL</p></div><Button disabled={signature.auditStatus !== 'approved'} icon={<Plus size={15} />} onClick={() => setDrainageModal({ signature })} size="sm" variant="ghost"></Button></div>
{links.length ? <div className="client-drainage-table"> {links.length ? <div className="client-drainage-table">
<div className="client-drainage-table__head"><span></span><span>访</span><span></span><span></span><span></span><span></span><span></span></div> <div className="client-drainage-table__head"><span> URL </span><span></span><span></span><span></span></div>
{links.map((item) => <div className="client-drainage-table__row" key={item.id}> {links.map((item) => <div className="client-drainage-table__row" key={item.id}>
<strong>{item.siteName}</strong><a href={item.url} rel="noreferrer" target="_blank">{item.url}</a>{(['mobile', 'unicom', 'telecom'] as Carrier[]).map((carrier) => <CarrierAvailability key={carrier} summary={signature.drainageCarrierReportSummary?.[item.id]?.[carrier]} />)}<span>{formatDate(item.updatedAt)}</span> <DrainageTarget value={item.url} /><div className="client-carrier-status-group">{(['mobile', 'unicom', 'telecom'] as Carrier[]).map((carrier) => <CarrierAvailability carrier={carrier} key={carrier} summary={signature.drainageCarrierReportSummary?.[item.id]?.[carrier]} />)}</div><span>{formatDate(item.updatedAt)}</span>
<div className="table-actions"><Button disabled={item.auditStatus === 'pending'} icon={<Edit3 size={14} />} onClick={() => setDrainageModal({ signature, item })} size="sm" variant="ghost"></Button><Button icon={<Trash2 size={14} />} onClick={() => setDeleting({ type: 'drainage', id: item.id, name: item.siteName })} size="sm" variant="danger"></Button></div> <div className="table-actions"><Button disabled={item.auditStatus === 'pending'} icon={<Edit3 size={14} />} onClick={() => setDrainageModal({ signature, item })} size="sm" variant="ghost"></Button><Button icon={<Trash2 size={14} />} onClick={() => setDeleting({ type: 'drainage', id: item.id, name: item.url })} size="sm" variant="danger"></Button></div>
</div>)} </div>)}
</div> : <p className="client-signature-empty-hint"></p>} </div> : <p className="client-signature-empty-hint"></p>}
</div> : null} </div> : null}
+54 -5
View File
@@ -8745,8 +8745,8 @@
align-items: center; align-items: center;
display: grid; display: grid;
gap: 14px; gap: 14px;
grid-template-columns: 24px minmax(120px, 1.1fr) minmax(110px, 1fr) 92px 92px 92px 142px minmax(144px, auto); grid-template-columns: 24px minmax(120px, 1.05fr) minmax(110px, .85fr) minmax(360px, 2.2fr) 142px minmax(144px, auto);
min-width: 1050px; min-width: 1030px;
} }
.client-signature-list-head { .client-signature-list-head {
@@ -8804,6 +8804,54 @@
color: var(--primary); color: var(--primary);
} }
.client-carrier-status-group {
display: grid;
gap: 8px;
grid-template-columns: repeat(3, minmax(0, 1fr));
min-width: 0;
}
.client-carrier-status {
align-items: center;
background: #f8faf9;
border: 1px solid #e3e9e6;
border-radius: 8px;
display: grid;
gap: 6px;
grid-template-columns: auto 7px minmax(0, 1fr);
min-height: 34px;
padding: 5px 8px;
}
.client-carrier-status strong {
color: var(--text-secondary);
font-size: 12px;
font-weight: 600;
min-width: 0;
white-space: nowrap;
}
.client-carrier-status__dot {
background: #b5c0bb;
border-radius: 50%;
height: 7px;
width: 7px;
}
.client-carrier-status--available {
background: #f1faf6;
border-color: #cfe8dc;
}
.client-carrier-status--available strong {
color: #176b49;
}
.client-carrier-status--available .client-carrier-status__dot {
background: #24a06b;
box-shadow: 0 0 0 3px rgba(36, 160, 107, .12);
}
.client-signature-inline-reason, .client-signature-inline-reason,
.client-signature-reason, .client-signature-reason,
.client-drainage-reason { .client-drainage-reason {
@@ -8855,8 +8903,8 @@
align-items: center; align-items: center;
display: grid; display: grid;
gap: 14px; gap: 14px;
grid-template-columns: minmax(120px, 1fr) minmax(200px, 1.7fr) 92px 92px 92px 142px minmax(144px, auto); grid-template-columns: minmax(220px, 1.35fr) minmax(360px, 2.2fr) 142px minmax(144px, auto);
min-width: 980px; min-width: 940px;
} }
.client-drainage-table__head { .client-drainage-table__head {
@@ -8873,8 +8921,9 @@
padding: 9px 14px; padding: 9px 14px;
} }
.client-drainage-table__row > a { .client-drainage-target {
color: var(--primary); color: var(--primary);
font-size: 13px;
min-width: 0; min-width: 0;
overflow: hidden; overflow: hidden;
text-overflow: ellipsis; text-overflow: ellipsis;