feat: densify sms records and improve uplink matching

api/src/operations/operations.helpers.ts

@@ -303,6 +303,7 @@ export function clientUplinkView(message: Record<string, any>) {
     applicationId: message.applicationId ?? null,
     messageRecordId: message.messageRecordId ?? null,
     messageId: message.messageId ?? null,
+    gatewayMessageId: message.gatewayMessageId ?? null,
     phoneNumber: message.phoneNumber,
     destId: message.destId,
     content: message.content,

api/src/operations/operations.service.spec.ts

@@ -359,6 +359,50 @@ describe('OperationsService', () => {
     });
   });
 
+  it('returns the matched message record and the distinct uplink gateway message id to the client view', async () => {
+    const prisma = createPrismaMock();
+    prisma.smsUplinkMessage.findMany.mockResolvedValue([{
+      id: 'uplink-1',
+      tenantId: 'tenant-1',
+      applicationId: 'app-1',
+      messageRecordId: 'record-1',
+      messageId: null,
+      gatewayMessageId: '8412634832294102675',
+      phoneNumber: '13800000001',
+      destId: '10690000',
+      content: 'TD',
+      matchStatus: 'matched',
+      matchReason: '手机号 72 小时窗口唯一匹配',
+      receivedAt: new Date('2026-08-26T01:00:00.000Z'),
+      createdAt: new Date('2026-08-26T01:00:00.000Z'),
+      application: { id: 'app-1', name: '应用A' },
+      messageRecord: {
+        id: 'record-1',
+        applicationId: 'app-1',
+        messageId: 'MSG-1',
+        phoneNumber: '13800000001',
+        content: '通知内容',
+        billingUnits: 1,
+        amountCents: 325,
+        status: 'delivered',
+        queuedAt: new Date('2026-08-25T01:00:00.000Z'),
+        application: { id: 'app-1', name: '应用A' },
+      },
+      matchCandidates: [],
+    }]);
+    const service = new OperationsService(prisma as never);
+
+    const [uplink] = await service.listClientUplinkMessages({ tenantId: 'tenant-1' });
+
+    expect(uplink).toMatchObject({
+      messageId: null,
+      gatewayMessageId: '8412634832294102675',
+      messageRecordId: 'record-1',
+      matchStatus: 'matched',
+      messageRecord: { id: 'record-1', messageId: 'MSG-1' },
+    });
+  });
+
   it('returns client message views without supplier channel, submit, tenant, or gateway internals', async () => {
     const prisma = createPrismaMock();
     prisma.smsMessageRecord.findMany.mockResolvedValue([{