box-nestjs-monorepo/prisma/mongo-stats/schema/user-login-history.prisma

model UserLoginHistory {
  id          String   @id @map("_id") @default(auto()) @db.ObjectId
  
  uid         String                          // 设备码
  ip          String                          // 登录 IP
  userAgent   String?                         // UA (optional but useful)
  appVersion  String?                         // 客户端版本 (optional)
  os          String?                         // iOS / Android / Browser
  channelId   String                          // 用户自带渠道 Id (required)
  machine     String                          // 客户端提供 : 设备的信息，品牌及系统版本什么的 (required)

  createAt    BigInt                          // 登录时间 (epoch)

  tokenId     String?                         // 登录 token

  // Queries you will use a lot:
  // 1. 查某设备所有登录记录
  @@index([uid, createAt])
  
  // 2. 按渠道查登陆情况
  @@index([channelId, createAt])
  
  // 3. 查某 IP 的登陆情况（反刷）
  @@index([ip, createAt])
  
  // 4. 全局统计（按时间分片）
  @@index([createAt])

  @@map("userLoginHistory")
}