七星棋牌房卡“经典房卡棋牌免费玩”系统设计全公开：从零搭建无门槛体验层的核心代码

// controllers/FreeCardController.js
const User = require('../models/User');
const FreeCardLog = require('../models/FreeCardLog');

const DAILY_LIMIT = 3;
const FREECARD_EXPIRE_HOURS = 24; // 免费房卡当天有效

async function grantFreeCard(userId, grantType) {
  const today = new Date().toISOString().slice(0, 10);
  // 查询当日已领取次数
  const count = await FreeCardLog.countDocuments({
    userId,
    date: today,
    type: grantType
  });
  if (count >= DAILY_LIMIT) {
    throw new Error('今日免费房卡已达上限');
  }
  // 发放房卡，存入用户资产，标记为免费类型且带过期时间
  const card = {
    type: 'free_daily',
    source: grantType, // 'login' | 'video' | 'win_match'
    expireAt: new Date(Date.now() + FREECARD_EXPIRE_HOURS * 3600 * 1000),
    used: false
  };
  await User.updateOne({ _id: userId }, { $push: { roomCards: card } });
  await FreeCardLog.create({ userId, date: today, type: grantType });
  return { cardId: card._id, expireAt: card.expireAt };
}

// matchmaker/FreeRoomMatcher.js
const Room = require('../models/Room');

async function findOrCreateFreeRoom(playerId) {
  // 优先找已存在的免费房间，状态为waiting且有空位
  let freeRoom = await Room.findOne({
    roomType: 'free_newbie',
    status: 'waiting',
    'players.1': { $exists: false } // 至少空一个位子
  }).sort({ createdAt: 1 });

  if (!freeRoom) {
    // 没有就创建一间新免费房，消耗系统补贴池而非玩家房卡
    freeRoom = await Room.create({
      roomType: 'free_newbie',
      creator: 'system',
      status: 'waiting',
      players: [playerId],
      maxPlayers: 4,
      consumeCardType: 'free',
      prizePool: 100 // 系统补贴100金币基础奖池
    });
  } else {
    freeRoom.players.push(playerId);
    if (freeRoom.players.length === 4) {
      freeRoom.status = 'ready';
      // 触发开局
      startGame(freeRoom._id);
    }
    await freeRoom.save();
  }
  return freeRoom;
}

// controllers/ConvertController.js
async function offerConversion(userId, wonCoins) {
  const user = await User.findById(userId);
  if (!user.isNewUser || user.registeredAt < Date.now() - 7*86400000) {
    return null; // 非新用户或超时不展示
  }
  // 1000金币 = 1张付费房卡，限定最多兑换5张
  const maxCards = Math.min(5, Math.floor(wonCoins / 1000));
  if (maxCards < 1) return null;
  return {
    offerText: `用 ${maxCards * 1000} 金币兑换 ${maxCards} 张标准房卡？`,
    cost: maxCards * 1000,
    cards: maxCards
  };
}

// settlement/calcFinalScore.js
function calcFinalScore(baseScore, cardType) {
  if (cardType === 'paid') {
    return Math.round(baseScore * 1.5);
  }
  return baseScore;
}

// risk/FreeCardRiskGuard.js
const Device = require('../models/Device');
const redis = require('../utils/redis');

async function checkRisk(userId, ip, deviceId) {
  // 1. 同设备多账号
  const accountCount = await Device.countDocuments({ deviceId });
  if (accountCount > 2) {
    return { allowed: false, reason: '设备关联账号过多' };
  }
  // 2. 同IP短时间内大量领取
  const ipKey = `freecard_ip:${ip}`;
  const ipCount = await redis.incr(ipKey);
  await redis.expire(ipKey, 3600);
  if (ipCount > 10) {
    return { allowed: false, reason: 'IP领取频率异常' };
  }
  // 3. 用户行为检测：注册后立即领卡且无任何真实对局记录
  const matchCount = await Match.countDocuments({ userId });
  const user = await User.findById(userId);
  const hoursSinceReg = (Date.now() - user.registeredAt) / 3600000;
  if (hoursSinceReg < 1 && matchCount === 0 && ipCount > 3) {
    return { allowed: false, reason: '行为模式疑似脚本' };
  }
  return { allowed: true };
}