box-nestjs-monorepo/prisma/mongo-stats/schema/events.prisma

model AdClickEvents {
  id           String  @id @map("_id") @default(auto()) @db.ObjectId

  uid          String                          // 设备码（from JWT / device）
  adsId        String  @db.ObjectId            // 广告 ID mongo objectId
  adId         Int     @db.Int                 // 广告 ID 自增数字唯一 ID
  adType       String                          // 广告类型 (BANNER/STARTUP/...)

  clickedAt    BigInt                          // 点击时间 (epoch)
  ip           String                          // 点击 IP
  channelId   String                          // 用户自带渠道 Id (required)
  machine      String                          // 客户端提供 : 设备的信息，品牌及系统版本什么的 (required)

  createAt     BigInt                          // 记录创建时间
  updateAt     BigInt                          // 记录更新时间

  // Query helpers
  // 1. 查某广告的点击列表
  @@index([adId, clickedAt])
  // 2. 查某设备的点击轨迹
  @@index([uid, clickedAt])
  // 3. 按渠道+设备分析（报表）
  @@index([channelId, uid, clickedAt])
  // 4. 按广告类型/时间分析
  @@index([adType, clickedAt])
  // 5. 全局按时间片
  @@index([clickedAt])

  @@map("adClickEvents")
}