[接口]新增玩家-钱包记录，玩家-抽奖记录

[接口]优化新增购买抽奖券时记录DicePlayerTicketRecord
[色子游戏]玩家获取抽奖券记录-重构DicePlayerCoinRecord为DicePlayerTicketRecord
2026-03-04 20:01:25 +08:00 · 2026-03-04 17:36:52 +08:00 · 2026-03-04 17:25:05 +08:00 · 2026-03-04 17:06:30 +08:00 · 2026-03-04 17:06:24 +08:00 · 2026-03-04 16:07:07 +08:00
46 changed files with 2270 additions and 89 deletions
--- a/saiadmin-artd/src/views/plugin/dice/api/player_ticket_record/index.ts
+++ b/saiadmin-artd/src/views/plugin/dice/api/player_ticket_record/index.ts
@@ -1,7 +1,7 @@
 import request from '@/utils/http'

 /**
- * 玩家购买抽奖记录 API接口
+ * 抽奖券获取记录 API接口
 */
 export default {
  /**
@@ -11,7 +11,7 @@ export default {
   */
  list(params: Record<string, any>) {
    return request.get<Api.Common.ApiPage>({
-      url: '/dice/player_coin_record/DicePlayerCoinRecord/index',
+      url: '/dice/player_ticket_record/DicePlayerTicketRecord/index',
      params
    })
  },
@@ -23,7 +23,7 @@ export default {
   */
  read(id: number | string) {
    return request.get<Api.Common.ApiData>({
-      url: '/dice/player_coin_record/DicePlayerCoinRecord/read?id=' + id
+      url: '/dice/player_ticket_record/DicePlayerTicketRecord/read?id=' + id
    })
  },

@@ -34,7 +34,7 @@ export default {
   */
  save(params: Record<string, any>) {
    return request.post<any>({
-      url: '/dice/player_coin_record/DicePlayerCoinRecord/save',
+      url: '/dice/player_ticket_record/DicePlayerTicketRecord/save',
      data: params
    })
  },
@@ -46,7 +46,7 @@ export default {
   */
  update(params: Record<string, any>) {
    return request.put<any>({
-      url: '/dice/player_coin_record/DicePlayerCoinRecord/update',
+      url: '/dice/player_ticket_record/DicePlayerTicketRecord/update',
      data: params
    })
  },
@@ -58,7 +58,7 @@ export default {
   */
  delete(params: Record<string, any>) {
    return request.del<any>({
-      url: '/dice/player_coin_record/DicePlayerCoinRecord/destroy',
+      url: '/dice/player_ticket_record/DicePlayerTicketRecord/destroy',
      data: params
    })
  },
@@ -68,7 +68,7 @@ export default {
   */
  getPlayerOptions() {
    return request.get<Api.Common.ApiData>({
-      url: '/dice/player_coin_record/DicePlayerCoinRecord/getPlayerOptions'
+      url: '/dice/player_ticket_record/DicePlayerTicketRecord/getPlayerOptions'
    })
  }
 }
--- a/saiadmin-artd/src/views/plugin/dice/api/player_wallet_record/index.ts
+++ b/saiadmin-artd/src/views/plugin/dice/api/player_wallet_record/index.ts
@@ -80,5 +80,21 @@ export default {
      url: '/dice/player_wallet_record/DicePlayerWalletRecord/getPlayerWalletBefore',
      params: { player_id: playerId }
    })
+  },
+
+  /**
+   * 管理员钱包操作（加点/扣点）：更新玩家平台币并创建流水记录
+   * type 3=加点 4=扣点
+   */
+  adminOperate(params: {
+    player_id: number
+    type: 3 | 4
+    coin: number
+    remark?: string
+  }) {
+    return request.post<any>({
+      url: '/dice/player_wallet_record/DicePlayerWalletRecord/adminOperate',
+      data: params
+    })
  }
 }
--- a/saiadmin-artd/src/views/plugin/dice/play_record/index/index.vue
+++ b/saiadmin-artd/src/views/plugin/dice/play_record/index/index.vue
@@ -62,6 +62,18 @@
            {{ row.is_win === 0 ? '无' : row.is_win === 1 ? '中奖' : '-' }}
          </ElTag>
        </template>
+        <!-- 方向 tag -->
+        <template #direction="{ row }">
+          <ElTag size="small" :type="row.direction === 0 ? 'primary' : 'warning'">
+            {{ row.direction === 0 ? '顺时针' : row.direction === 1 ? '逆时针' : '-' }}
+          </ElTag>
+        </template>
+        <!-- 摇取点数 tag -->
+        <template #roll_array="{ row }">
+          <ElTag size="small">
+            {{ formatRollArray(row.roll_array) }}
+          </ElTag>
+        </template>
        <!-- 操作列 -->
        <template #operation="{ row }">
          <div class="flex gap-2">
@@ -106,7 +118,8 @@
    win_coin_min: undefined,
    win_coin_max: undefined,
    reward_ui_text: undefined,
-    reward_tier: undefined
+    reward_tier: undefined,
+    direction: undefined
  })

  // 搜索处理
@@ -122,6 +135,21 @@
  const rewardTierFormatter = (row: Record<string, any>) =>
    row?.diceRewardConfig?.tier ?? row?.reward_config_id ?? '-'

+  /** 摇取点数格式化为 1,3,4,5,6,6 */
+  function formatRollArray(val: unknown): string {
+    if (val == null || val === '') return '-'
+    if (Array.isArray(val)) return val.join(',')
+    if (typeof val === 'string') {
+      try {
+        const arr = JSON.parse(val)
+        return Array.isArray(arr) ? arr.join(',') : val
+      } catch {
+        return val
+      }
+    }
+    return String(val)
+  }
+
  // 表格配置
  const {
    columns,
@@ -156,6 +184,10 @@
        { prop: 'lottery_type', label: '抽奖类型', width: 100, useSlot: true },
        { prop: 'is_win', label: '中奖', width: 80, useSlot: true },
        { prop: 'win_coin', label: '赢取平台币' },
+        { prop: 'direction', label: '方向', width: 90, useSlot: true },
+        { prop: 'start_index', label: '起始索引', width: 90 },
+        { prop: 'target_index', label: '终点索引', width: 90 },
+        { prop: 'roll_array', label: '摇取点数', width: 140, useSlot: true },
        {
          prop: 'reward_config_id',
          label: '奖励配置',
--- a/saiadmin-artd/src/views/plugin/dice/play_record/index/modules/edit-dialog.vue
+++ b/saiadmin-artd/src/views/plugin/dice/play_record/index/modules/edit-dialog.vue
@@ -75,6 +75,53 @@
          :disabled="dialogType === 'edit'"
        />
      </el-form-item>
+      <el-form-item label="方向" prop="direction">
+        <el-select
+          v-model="formData.direction"
+          placeholder="请选择方向"
+          clearable
+          style="width: 100%"
+          :disabled="dialogType === 'edit'"
+        >
+          <el-option label="顺时针" :value="0" />
+          <el-option label="逆时针" :value="1" />
+        </el-select>
+      </el-form-item>
+      <el-form-item label="起始索引" prop="start_index">
+        <el-input-number
+          v-model="formData.start_index"
+          placeholder="起始索引"
+          :min="0"
+          style="width: 100%"
+          :disabled="dialogType === 'edit'"
+        />
+      </el-form-item>
+      <el-form-item label="终点索引" prop="target_index">
+        <el-input-number
+          v-model="formData.target_index"
+          placeholder="终点索引"
+          :min="0"
+          style="width: 100%"
+          :disabled="dialogType === 'edit'"
+        />
+      </el-form-item>
+      <el-form-item label="摇取点数" prop="rollArrayItems">
+        <div class="roll-array-wrap">
+          <el-input-number
+            v-for="(_, i) in 5"
+            :key="i"
+            v-model="formData.rollArrayItems[i]"
+            :min="1"
+            :max="6"
+            :precision="0"
+            controls-position="right"
+            placeholder=""
+            class="roll-array-input"
+            :disabled="dialogType === 'edit'"
+          />
+        </div>
+        <div class="roll-array-hint">固定 5 个数，每个 1～6</div>
+      </el-form-item>
      <el-form-item label="奖励配置" prop="reward_config_id">
        <el-select
          v-model="formData.reward_config_id"
@@ -141,6 +188,23 @@
    lottery_type: [{ required: true, message: '请选择抽奖类型', trigger: 'change' }],
    is_win: [{ required: true, message: '请选择中奖', trigger: 'change' }],
    win_coin: [{ required: true, message: '赢取平台币必填', trigger: 'blur' }],
+    rollArrayItems: [
+      {
+        validator: (_rule: any, value: (number | null)[], callback: (e?: Error) => void) => {
+          if (!value || value.length !== 5) {
+            callback(new Error('摇取点数必须为 5 个数'))
+            return
+          }
+          const ok = value.every((n) => n != null && n >= 1 && n <= 6)
+          if (!ok) {
+            callback(new Error('摇取点数必须填写 5 个数，每个 1～6'))
+            return
+          }
+          callback()
+        },
+        trigger: 'change'
+      }
+    ],
    reward_config_id: [{ required: true, message: '请选择奖励配置', trigger: 'change' }]
  })

@@ -155,10 +219,20 @@
    lottery_type: null as number | null,
    is_win: null as number | null,
    win_coin: null as number | null,
+    direction: null as number | null,
+    start_index: null as number | null,
+    target_index: null as number | null,
+    roll_array: null as string | number[] | null,
    reward_config_id: null as number | null
  }

-  const formData = reactive({ ...initialFormData })
+  /** 摇取点数固定 5 位 [n0..n4]，每项 1～6 */
+  const rollArrayItemsDefault = (): (number | null)[] => [null, null, null, null, null]
+
+  const formData = reactive({
+    ...initialFormData,
+    rollArrayItems: rollArrayItemsDefault() as (number | null)[]
+  })

  watch(
    () => props.modelValue,
@@ -188,7 +262,7 @@
  )

  const initPage = async () => {
-    Object.assign(formData, { ...initialFormData })
+    Object.assign(formData, { ...initialFormData, rollArrayItems: rollArrayItemsDefault() })
    if (props.data) {
      await nextTick()
      initForm()
@@ -204,16 +278,47 @@
      'lottery_type',
      'is_win',
      'win_coin',
+      'direction',
+      'start_index',
+      'target_index',
+      'roll_array',
      'reward_config_id'
    ]
    keys.forEach((key) => {
      const val = props.data![key]
      if (val != null && val !== undefined) {
-        ;(formData as Record<string, unknown>)[key] = val
+        if (key === 'roll_array') {
+          formData.roll_array = val
+          formData.rollArrayItems = parseRollArrayToItems(val)
+        } else {
+          ;(formData as Record<string, unknown>)[key] = val
+        }
      }
    })
  }

+  /** 将接口的 roll_array 转为固定 5 项数组，不足补 null */
+  function parseRollArrayToItems(val: unknown): (number | null)[] {
+    let arr: number[] = []
+    if (Array.isArray(val)) {
+      arr = val.map((n) => (typeof n === 'number' && !Number.isNaN(n) ? n : 0)).slice(0, 5)
+    } else if (typeof val === 'string') {
+      try {
+        const parsed = JSON.parse(val)
+        arr = Array.isArray(parsed) ? parsed.slice(0, 5).map((n: any) => Number(n) || 0) : []
+      } catch {
+        arr = val
+          .split(',')
+          .map((n) => parseInt(n, 10))
+          .filter((n) => !Number.isNaN(n))
+          .slice(0, 5)
+      }
+    }
+    const items: (number | null)[] = [...arr]
+    while (items.length < 5) items.push(null)
+    return items.slice(0, 5)
+  }
+
  const handleClose = () => {
    visible.value = false
    formRef.value?.resetFields()
@@ -223,19 +328,56 @@
    if (!formRef.value) return
    try {
      await formRef.value.validate()
+      const payload = { ...formData } as Record<string, unknown>
+      // 将 5 个输入值拼成 [1,2,3,4,5] 格式，确保每项为 1～6 的整数
+      const items = formData.rollArrayItems
+      payload.roll_array = items.map((n) => {
+        const v = n != null ? Number(n) : 1
+        return Math.min(6, Math.max(1, Number.isNaN(v) ? 1 : Math.floor(v)))
+      })
+      delete payload.rollArrayItems
      if (props.dialogType === 'add') {
-        const rest = { ...formData } as Record<string, unknown>
-        delete rest.id
-        await api.save(rest)
+        delete payload.id
+        await api.save(payload)
        ElMessage.success('新增成功')
      } else {
-        await api.update(formData)
+        await api.update(payload)
        ElMessage.success('修改成功')
      }
      emit('success')
      handleClose()
-    } catch (error) {
-      console.log('表单验证失败:', error)
+    } catch (error: any) {
+      let msg = '表单验证失败，请检查必填项与格式'
+      if (error?.message) {
+        msg = error.message
+      } else if (typeof error === 'string') {
+        msg = error
+      } else if (error && typeof error === 'object') {
+        const first = Object.values(error).find((v: any) => v?.[0]?.message)
+        if (first && Array.isArray(first)) {
+          msg = (first[0] as any).message || msg
+        }
+      }
+      ElMessage.warning(msg)
    }
  }
 </script>
+
+<style lang="scss" scoped>
+  .roll-array-wrap {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 8px;
+    align-items: center;
+  }
+
+  .roll-array-input {
+    width: 72px;
+  }
+
+  .roll-array-hint {
+    margin-top: 6px;
+    font-size: 12px;
+    color: var(--el-text-color-secondary);
+  }
+</style>
--- a/saiadmin-artd/src/views/plugin/dice/play_record/index/modules/table-search.vue
+++ b/saiadmin-artd/src/views/plugin/dice/play_record/index/modules/table-search.vue
@@ -34,6 +34,14 @@
        </el-select>
      </el-form-item>
    </el-col>
+    <el-col v-bind="setSpan(6)">
+      <el-form-item label="方向" prop="direction">
+        <el-select v-model="formData.direction" placeholder="全部" clearable style="width: 100%">
+          <el-option label="顺时针" :value="0" />
+          <el-option label="逆时针" :value="1" />
+        </el-select>
+      </el-form-item>
+    </el-col>
    <el-col v-bind="setSpan(6)">
      <el-form-item label="赢取平台币" prop="win_coin_min">
        <div class="range-wrap">
--- a/saiadmin-artd/src/views/plugin/dice/player/index/index.vue
+++ b/saiadmin-artd/src/views/plugin/dice/player/index/index.vue
@@ -51,9 +51,16 @@
            @change="(v: string | number | boolean) => handleStatusChange(row, v ? 1 : 0)"
          />
        </template>
-        <!-- 平台币：tag 展示 -->
+        <!-- 平台币：tag 可点击打开钱包操作弹窗 -->
        <template #coin="{ row }">
-          <ElTag type="info" size="small">{{ row.coin ?? 0 }}</ElTag>
+          <ElTag
+            type="info"
+            size="small"
+            class="cursor-pointer hover:opacity-80"
+            @click="openWalletOperate(row)"
+          >
+            {{ row.coin ?? 0 }}
+          </ElTag>
        </template>
        <!-- 操作列 -->
        <template #operation="{ row }">
@@ -80,6 +87,13 @@
      :data="dialogData"
      @success="refreshData"
    />
+
+    <!-- 钱包操作弹窗（加点/扣点） -->
+    <WalletOperateDialog
+      v-model="walletDialogVisible"
+      :player="walletOperatePlayer"
+      @success="refreshData"
+    />
  </div>
 </template>

@@ -89,11 +103,13 @@
  import api from '../../api/player/index'
  import TableSearch from './modules/table-search.vue'
  import EditDialog from './modules/edit-dialog.vue'
+  import WalletOperateDialog from './modules/WalletOperateDialog.vue'

  // 搜索表单
  const searchForm = ref({
    username: undefined,
    name: undefined,
+    phone: undefined,
    status: undefined,
    coin: undefined,
    is_up: undefined
@@ -143,6 +159,7 @@
      columnsFactory: () => [
        { type: 'selection' },
        { prop: 'username', label: '用户名' },
+        { prop: 'phone', label: '手机号' },
        { prop: 'name', label: '昵称' },
        { prop: 'status', label: '状态', width: 88, useSlot: true },
        { prop: 'coin', label: '平台币', width: 100, useSlot: true },
@@ -186,4 +203,13 @@
    handleSelectionChange,
    selectedRows
  } = useSaiAdmin()
+
+  // 钱包操作弹窗（从平台币 tag 点击打开）
+  const walletDialogVisible = ref(false)
+  const walletOperatePlayer = ref<Record<string, any> | null>(null)
+
+  function openWalletOperate(row: Record<string, any>) {
+    walletOperatePlayer.value = row
+    walletDialogVisible.value = true
+  }
 </script>
--- a/saiadmin-artd/src/views/plugin/dice/player/index/modules/WalletOperateDialog.vue
+++ b/saiadmin-artd/src/views/plugin/dice/player/index/modules/WalletOperateDialog.vue
@@ -0,0 +1,172 @@
+<template>
+  <el-dialog
+    v-model="visible"
+    title="玩家钱包操作"
+    width="480px"
+    align-center
+    :close-on-click-modal="false"
+    @close="handleClose"
+  >
+    <el-form ref="formRef" :model="formData" :rules="rules" label-width="100px">
+      <el-form-item label="玩家">
+        <el-input :model-value="player?.username" disabled placeholder="-" />
+      </el-form-item>
+      <el-form-item label="钱包余额">
+        <el-input-number
+          :model-value="walletBalance"
+          disabled
+          :precision="2"
+          controls-position="right"
+          style="width: 100%"
+        />
+      </el-form-item>
+      <el-form-item label="操作类型" prop="type">
+        <el-select v-model="formData.type" placeholder="请选择" clearable style="width: 100%">
+          <el-option label="加点" :value="3" />
+          <el-option label="扣点" :value="4" />
+        </el-select>
+      </el-form-item>
+      <el-form-item label="平台币变动" prop="coin">
+        <el-input-number
+          v-model="formData.coin"
+          :min="0.01"
+          :precision="2"
+          placeholder="正数，扣点时不能超过余额"
+          controls-position="right"
+          style="width: 100%"
+        />
+      </el-form-item>
+      <el-form-item label="备注" prop="remark">
+        <el-input
+          v-model="formData.remark"
+          type="textarea"
+          :rows="2"
+          placeholder="选填，不填则按类型自动填写"
+          maxlength="500"
+          show-word-limit
+        />
+      </el-form-item>
+    </el-form>
+    <template #footer>
+      <el-button @click="handleClose">取消</el-button>
+      <el-button type="primary" :loading="submitting" @click="handleSubmit">确定</el-button>
+    </template>
+  </el-dialog>
+</template>
+
+<script setup lang="ts">
+  import walletRecordApi from '../../../api/player_wallet_record/index'
+  import { ElMessage } from 'element-plus'
+  import type { FormInstance, FormRules } from 'element-plus'
+
+  interface PlayerRow {
+    id: number
+    username?: string
+    coin?: number
+  }
+
+  interface Props {
+    modelValue: boolean
+    player: PlayerRow | null
+  }
+
+  interface Emits {
+    (e: 'update:modelValue', value: boolean): void
+    (e: 'success'): void
+  }
+
+  const props = withDefaults(defineProps<Props>(), {
+    modelValue: false,
+    player: null
+  })
+
+  const emit = defineEmits<Emits>()
+
+  const formRef = ref<FormInstance>()
+  const submitting = ref(false)
+
+  const visible = computed({
+    get: () => props.modelValue,
+    set: (v) => emit('update:modelValue', v)
+  })
+
+  const walletBalance = computed(() => {
+    const c = props.player?.coin
+    return c != null && c !== '' ? Number(c) : 0
+  })
+
+  const rules = reactive<FormRules>({
+    type: [{ required: true, message: '请选择操作类型', trigger: 'change' }],
+    coin: [
+      { required: true, message: '请输入平台币变动', trigger: 'blur' },
+      {
+        validator: (_rule, value, callback) => {
+          const n = Number(value)
+          if (Number.isNaN(n) || n <= 0) {
+            callback(new Error('平台币变动必须大于 0'))
+            return
+          }
+          if (formData.type === 4 && n > walletBalance.value) {
+            callback(new Error('扣点不能超过当前余额'))
+            return
+          }
+          callback()
+        },
+        trigger: 'blur'
+      }
+    ]
+  })
+
+  const initialFormData = {
+    type: null as 3 | 4 | null,
+    coin: null as number | null,
+    remark: ''
+  }
+
+  const formData = reactive({ ...initialFormData })
+
+  watch(
+    () => props.modelValue,
+    (open) => {
+      if (open) {
+        Object.assign(formData, initialFormData)
+        formData.type = 3
+      }
+    }
+  )
+
+  const handleClose = () => {
+    visible.value = false
+    formRef.value?.resetFields()
+  }
+
+  const handleSubmit = async () => {
+    if (!formRef.value || !props.player?.id) return
+    try {
+      await formRef.value.validate()
+      const coin = Number(formData.coin) || 0
+      if (coin <= 0) {
+        ElMessage.warning('平台币变动必须大于 0')
+        return
+      }
+      if (formData.type === 4 && coin > walletBalance.value) {
+        ElMessage.warning('扣点不能超过当前余额')
+        return
+      }
+      submitting.value = true
+      await walletRecordApi.adminOperate({
+        player_id: props.player.id,
+        type: formData.type!,
+        coin,
+        remark: formData.remark?.trim() || undefined
+      })
+      ElMessage.success('操作成功')
+      emit('success')
+      handleClose()
+    } catch (e) {
+      if ((e as any)?.message) ElMessage.warning((e as any).message)
+    } finally {
+      submitting.value = false
+    }
+  }
+</script>
--- a/saiadmin-artd/src/views/plugin/dice/player/index/modules/edit-dialog.vue
+++ b/saiadmin-artd/src/views/plugin/dice/player/index/modules/edit-dialog.vue
@@ -14,6 +14,9 @@
      <el-form-item label="昵称" prop="name">
        <el-input v-model="formData.name" placeholder="请输入昵称" />
      </el-form-item>
+      <el-form-item label="手机号" prop="phone">
+        <el-input v-model="formData.phone" placeholder="请输入手机号" clearable maxlength="20" show-word-limit />
+      </el-form-item>
      <el-form-item label="密码" prop="password" :rules="passwordRules">
        <el-input
          v-model="formData.password"
@@ -117,6 +120,7 @@
  const rules = reactive<FormRules>({
    username: [{ required: true, message: '用户名必需填写', trigger: 'blur' }],
    name: [{ required: true, message: '昵称必需填写', trigger: 'blur' }],
+    phone: [{ required: true, message: '手机号必需填写', trigger: 'blur' }],
    status: [{ required: true, message: '状态必需填写', trigger: 'blur' }],
    coin: [{ required: true, message: '平台币必需填写', trigger: 'blur' }]
  })
@@ -125,6 +129,7 @@
    id: null as number | null,
    username: '',
    name: '',
+    phone: '',
    password: '',
    status: 1 as number,
    coin: 0 as number,
--- a/saiadmin-artd/src/views/plugin/dice/player/index/modules/table-search.vue
+++ b/saiadmin-artd/src/views/plugin/dice/player/index/modules/table-search.vue
@@ -18,6 +18,11 @@
        <el-input v-model="formData.name" placeholder="请输入昵称" clearable />
      </el-form-item>
    </el-col>
+    <el-col v-bind="setSpan(6)">
+      <el-form-item label="手机号" prop="phone">
+        <el-input v-model="formData.phone" placeholder="手机号模糊查询" clearable />
+      </el-form-item>
+    </el-col>
    <el-col v-bind="setSpan(6)">
      <el-form-item label="状态" prop="status">
        <el-select v-model="formData.status" placeholder="全部" clearable style="width: 100%">
--- a/saiadmin-artd/src/views/plugin/dice/player_ticket_record/index/index.vue
+++ b/saiadmin-artd/src/views/plugin/dice/player_ticket_record/index/index.vue
@@ -8,14 +8,14 @@
      <ArtTableHeader v-model:columns="columnChecks" :loading="loading" @refresh="refreshData">
        <template #left>
          <ElSpace wrap>
-            <ElButton v-permission="'dice:player_coin_record:index:save'" @click="showDialog('add')" v-ripple>
+            <ElButton v-permission="'dice:player_ticket_record:index:save'" @click="showDialog('add')" v-ripple>
              <template #icon>
                <ArtSvgIcon icon="ri:add-fill" />
              </template>
              新增
            </ElButton>
            <ElButton
-              v-permission="'dice:player_coin_record:index:destroy'"
+              v-permission="'dice:player_ticket_record:index:destroy'"
              :disabled="selectedRows.length === 0"
              @click="deleteSelectedRows(api.delete, refreshData)"
              v-ripple
@@ -46,12 +46,12 @@
        <template #operation="{ row }">
          <div class="flex gap-2">
            <SaButton
-              v-permission="'dice:player_coin_record:index:update'"
+              v-permission="'dice:player_ticket_record:index:update'"
              type="secondary"
              @click="showDialog('edit', row)"
            />
            <SaButton
-              v-permission="'dice:player_coin_record:index:destroy'"
+              v-permission="'dice:player_ticket_record:index:destroy'"
              type="error"
              @click="deleteRow(row, api.delete, refreshData)"
            />
@@ -73,7 +73,7 @@
 <script setup lang="ts">
  import { useTable } from '@/hooks/core/useTable'
  import { useSaiAdmin } from '@/composables/useSaiAdmin'
-  import api from '../../api/player_coin_record/index'
+  import api from '../../api/player_ticket_record/index'
  import TableSearch from './modules/table-search.vue'
  import EditDialog from './modules/edit-dialog.vue'

--- a/saiadmin-artd/src/views/plugin/dice/player_ticket_record/index/modules/edit-dialog.vue
+++ b/saiadmin-artd/src/views/plugin/dice/player_ticket_record/index/modules/edit-dialog.vue
@@ -1,7 +1,7 @@
 <template>
  <el-dialog
    v-model="visible"
-    :title="dialogType === 'add' ? '新增玩家购买抽奖记录' : '编辑玩家购买抽奖记录'"
+    :title="dialogType === 'add' ? '新增抽奖券获取记录' : '编辑抽奖券获取记录'"
    width="600px"
    align-center
    :close-on-click-modal="false"
@@ -71,7 +71,7 @@
 </template>

 <script setup lang="ts">
-  import api from '../../../api/player_coin_record/index'
+  import api from '../../../api/player_ticket_record/index'
  import { ElMessage } from 'element-plus'
  import type { FormInstance, FormRules } from 'element-plus'

--- a/saiadmin-artd/src/views/plugin/dice/player_ticket_record/index/modules/table-search.vue
+++ b/saiadmin-artd/src/views/plugin/dice/player_ticket_record/index/modules/table-search.vue
--- a/saiadmin-artd/src/views/plugin/dice/player_wallet_record/index/index.vue
+++ b/saiadmin-artd/src/views/plugin/dice/player_wallet_record/index/index.vue
@@ -46,6 +46,12 @@
        @pagination:size-change="handleSizeChange"
        @pagination:current-change="handleCurrentChange"
      >
+        <!-- 类型：不同类型不同底色 tag，放大一倍 -->
+        <template #type="{ row }">
+          <ElTag class="wallet-type-tag" size="large" :type="typeTagType(row.type)">
+            {{ typeFormatter(row) }}
+          </ElTag>
+        </template>
        <!-- 操作列 -->
        <template #operation="{ row }">
          <div class="flex gap-2">
@@ -86,18 +92,51 @@
    type: undefined,
    username: undefined,
    coin_min: undefined,
-    coin_max: undefined
+    coin_max: undefined,
+    create_time: undefined as [string, string] | undefined
  })

-  // 搜索处理
+  // 搜索处理：将 create_time 区间转为 create_time_min / create_time_max
  const handleSearch = (params: Record<string, any>) => {
-    Object.assign(searchParams, params)
+    const p = { ...params }
+    if (Array.isArray(p.create_time) && p.create_time.length === 2) {
+      p.create_time_min = p.create_time[0]
+      p.create_time_max = p.create_time[1]
+    }
+    delete p.create_time
+    Object.assign(searchParams, p)
    getData()
  }

-  // 类型展示：0=充值 1=提现 2=购买抽奖次数
-  const typeFormatter = (row: Record<string, unknown>) =>
-    row.type === 0 ? '充值' : row.type === 1 ? '提现' : row.type === 2 ? '购买抽奖次数' : '-'
+  // 类型展示：0=充值 1=提现 2=购买抽奖次数 3=管理员加点 4=管理员扣点 5=抽奖
+  const typeFormatter = (row: Record<string, unknown>) => {
+    const t = row.type
+    if (t === 0) return '充值'
+    if (t === 1) return '提现'
+    if (t === 2) return '购买抽奖次数'
+    if (t === 3) return '管理员加点'
+    if (t === 4) return '管理员扣点'
+    if (t === 5) return '抽奖'
+    return '-'
+  }
+
+  // 类型对应 tag 底色：0 充值 1 提现 2 购买 3 加点 4 扣点
+  const typeTagType = (t: unknown): 'success' | 'warning' | 'danger' | 'info' | 'primary' => {
+    if (t === 0) return 'success'
+    if (t === 1) return 'warning'
+    if (t === 2) return 'primary'
+    if (t === 3) return 'success'
+    if (t === 4) return 'danger'
+    if (t === 5) return 'info'
+    return 'info'
+  }
+
+  // 操作人：关联管理员用户名
+  const operatorFormatter = (row: Record<string, any>) => {
+    const op = row.operator ?? row.operator_id
+    if (op && typeof op === 'object' && op.username) return op.username
+    return row.user_id ?? '-'
+  }

  // 用户列展示为 dicePlayer.username（兼容 dice_player）
  const usernameFormatter = (row: Record<string, any>) => {
@@ -123,23 +162,52 @@
    core: {
      apiFn: api.list,
      columnsFactory: () => [
-        { type: 'selection' },
-        { prop: 'id', label: 'ID', width: 80 },
-        { prop: 'player_id', label: '用户', width: 120, formatter: usernameFormatter },
-        { prop: 'coin', label: '平台币变化', width: 110 },
-        { prop: 'type', label: '类型', width: 120, formatter: typeFormatter },
-        { prop: 'wallet_before', label: '钱包操作前', width: 110 },
-        { prop: 'wallet_after', label: '钱包操作后', width: 110 },
+        { type: 'selection', align: 'center' },
+        { prop: 'id', label: 'ID', width: 80, align: 'center' },
+        {
+          prop: 'player_id',
+          label: '用户',
+          width: 120,
+          align: 'center',
+          formatter: usernameFormatter
+        },
+        { prop: 'coin', label: '平台币变化', width: 110, align: 'center' },
+        {
+          prop: 'type',
+          label: '类型',
+          width: 140,
+          align: 'center',
+          useSlot: true,
+          formatter: typeFormatter
+        },
+        {
+          prop: 'user_id',
+          label: '操作人',
+          width: 100,
+          align: 'center',
+          formatter: operatorFormatter
+        },
+        { prop: 'wallet_before', label: '钱包操作前', width: 110, align: 'center' },
+        { prop: 'wallet_after', label: '钱包操作后', width: 110, align: 'center' },
        {
          prop: 'remark',
          label: '备注',
          width: 100,
+          align: 'center',
          showOverflowTooltip: true
        },
-        { prop: 'total_draw_count', label: '总抽奖次数' },
-        { prop: 'paid_draw_count', label: '购买抽奖次数' },
-        { prop: 'free_draw_count', label: '赠送抽奖次数' },
-        { prop: 'operation', label: '操作', width: 100, fixed: 'right', useSlot: true }
+        { prop: 'total_draw_count', label: '总抽奖次数', align: 'center' },
+        { prop: 'paid_draw_count', label: '购买抽奖次数', align: 'center' },
+        { prop: 'free_draw_count', label: '赠送抽奖次数', align: 'center' },
+        { prop: 'create_time', label: '创建时间', width: 170, align: 'center' },
+        {
+          prop: 'operation',
+          label: '操作',
+          width: 100,
+          align: 'center',
+          fixed: 'right',
+          useSlot: true
+        }
      ]
    }
  })
@@ -156,3 +224,11 @@
    selectedRows
  } = useSaiAdmin()
 </script>
+
+<style lang="scss" scoped>
+  /* 类型 tag 放大一倍（large + scale） */
+  :deep(.wallet-record-type-tag) {
+    transform: scale(0.8);
+    transform-origin: center;
+  }
+</style>
--- a/saiadmin-artd/src/views/plugin/dice/player_wallet_record/index/modules/edit-dialog.vue
+++ b/saiadmin-artd/src/views/plugin/dice/player_wallet_record/index/modules/edit-dialog.vue
@@ -31,6 +31,8 @@
          <el-option label="充值" :value="0" />
          <el-option label="提现" :value="1" />
          <el-option label="购买抽奖次数" :value="2" />
+          <el-option label="管理员加点" :value="3" />
+          <el-option label="管理员扣点" :value="4" />
        </el-select>
      </el-form-item>
      <el-form-item label="平台币变化" prop="coin">
--- a/saiadmin-artd/src/views/plugin/dice/player_wallet_record/index/modules/table-search.vue
+++ b/saiadmin-artd/src/views/plugin/dice/player_wallet_record/index/modules/table-search.vue
@@ -14,6 +14,8 @@
          <el-option label="充值" :value="0" />
          <el-option label="提现" :value="1" />
          <el-option label="购买抽奖次数" :value="2" />
+          <el-option label="管理员加点" :value="3" />
+          <el-option label="管理员扣点" :value="4" />
        </el-select>
      </el-form-item>
    </el-col>
@@ -43,6 +45,19 @@
        </div>
      </el-form-item>
    </el-col>
+    <el-col v-bind="setSpan(8)">
+      <el-form-item label="创建时间" prop="create_time">
+        <el-date-picker
+          v-model="formData.create_time"
+          type="datetimerange"
+          range-separator="至"
+          start-placeholder="开始时间"
+          end-placeholder="结束时间"
+          value-format="YYYY-MM-DD HH:mm:ss"
+          style="width: 100%"
+        />
+      </el-form-item>
+    </el-col>
  </sa-search-bar>
 </template>

--- a/saiadmin-artd/src/views/plugin/dice/reward_config/index/index.vue
+++ b/saiadmin-artd/src/views/plugin/dice/reward_config/index/index.vue
@@ -8,7 +8,11 @@
      <ArtTableHeader v-model:columns="columnChecks" :loading="loading" @refresh="refreshData">
        <template #left>
          <ElSpace wrap>
-            <ElButton v-permission="'dice:reward_config:index:save'" @click="showDialog('add')" v-ripple>
+            <ElButton
+              v-permission="'dice:reward_config:index:save'"
+              @click="showDialog('add')"
+              v-ripple
+            >
              <template #icon>
                <ArtSvgIcon icon="ri:add-fill" />
              </template>
@@ -77,7 +81,6 @@
  import TableSearch from './modules/table-search.vue'
  import EditDialog from './modules/edit-dialog.vue'

-
  // 搜索表单
  const searchForm = ref<Record<string, unknown>>({
    grid_number_min: undefined,
@@ -118,8 +121,8 @@
        { prop: 'grid_number', label: '色子点数' },
        { prop: 'ui_text', label: '前端显示文本' },
        { prop: 'real_ev', label: '真实资金结算' },
-        { prop: 'tier', label: '所属档位' },
-        { prop: 'create_time', label: '创建时间' },
+        { prop: 'tier', label: '所属档位', sortable: true },
+        // { prop: 'create_time', label: '创建时间', sortable: true },
        { prop: 'operation', label: '操作', width: 100, fixed: 'right', useSlot: true }
      ]
    }
@@ -136,5 +139,4 @@
    handleSelectionChange,
    selectedRows
  } = useSaiAdmin()
-
 </script>
--- a/server/.env.example
+++ b/server/.env.example
@@ -7,8 +7,8 @@ DB_USER = root
 DB_PASSWORD = 123456
 DB_PREFIX = 

-# 缓存方式,支持file|redis
-CACHE_MODE = file
+# 缓存方式,支持file|redis（API 用户登录缓存需使用 redis）
+CACHE_MODE = redis

 # Redis配置
 REDIS_HOST = 127.0.0.1
@@ -16,6 +16,12 @@ REDIS_PORT = 6379
 REDIS_PASSWORD = ''
 REDIS_DB = 0

+# API 鉴权与用户（可选，不填则用默认值）
+# API_AUTH_TOKEN_EXP = 86400
+# API_USER_TOKEN_EXP = 604800
+# API_USER_CACHE_EXPIRE = 604800
+# API_USER_ENCRYPT_KEY = dafuweng_api_user_cache_key_32
+
 # 验证码配置,支持cache|session
 CAPTCHA_MODE = cache
 LOGIN_CAPTCHA_ENABLE = false
--- a/server/app/api/cache/UserCache.php
+++ b/server/app/api/cache/UserCache.php
@@ -0,0 +1,134 @@
+<?php
+declare(strict_types=1);
+
+namespace app\api\cache;
+
+use support\think\Cache;
+
+/**
+ * API 用户信息 Redis 缓存
+ * key = base64(user_id)，value = 加密后的用户信息 JSON
+ */
+class UserCache
+{
+    private static function prefix(): string
+    {
+        return config('api.user_cache_prefix', 'api:user:');
+    }
+
+    private static function expire(): int
+    {
+        return (int) config('api.user_cache_expire', 604800);
+    }
+
+    private static function encryptKey(): string
+    {
+        $key = config('api.user_encrypt_key', 'dafuweng_api_user_cache_key_32');
+        return str_pad($key, 32, '0', STR_PAD_RIGHT);
+    }
+
+    /** 加密 */
+    public static function encrypt(string $data): string
+    {
+        $key = self::encryptKey();
+        $iv = substr(md5($key), 0, 16);
+        return base64_encode(openssl_encrypt($data, 'AES-256-CBC', $key, OPENSSL_RAW_DATA, $iv));
+    }
+
+    /** 解密 */
+    public static function decrypt(string $data): string
+    {
+        $key = self::encryptKey();
+        $iv = substr(md5($key), 0, 16);
+        $dec = openssl_decrypt(base64_decode($data, true), 'AES-256-CBC', $key, OPENSSL_RAW_DATA, $iv);
+        return $dec !== false ? $dec : '';
+    }
+
+    /**
+     * 写入用户信息到 Redis
+     * @param int $userId
+     * @param array $userInfo 从数据库读取的用户信息（可含敏感字段，会加密存储）
+     */
+    public static function setUser(int $userId, array $userInfo): bool
+    {
+        $key = self::prefix() . base64_encode((string) $userId);
+        $value = self::encrypt(json_encode($userInfo));
+        return Cache::set($key, $value, self::expire());
+    }
+
+    /**
+     * 从 Redis 读取用户信息
+     * @return array 解密后的用户信息，不存在或失败返回空数组
+     */
+    public static function getUser(int $userId): array
+    {
+        $key = self::prefix() . base64_encode((string) $userId);
+        $value = Cache::get($key);
+        if ($value === null || $value === '') {
+            return [];
+        }
+        $dec = self::decrypt($value);
+        if ($dec === '') {
+            return [];
+        }
+        $data = json_decode($dec, true);
+        return is_array($data) ? $data : [];
+    }
+
+    /**
+     * 仅从缓存读取用户平台币 coin（不查库，低延迟）
+     * @return int|float|null 余额，缓存未命中返回 null（缓存中 coin 可能为字符串，统一转为数值）
+     */
+    public static function getUserCoin(int $userId): int|float|null
+    {
+        $user = self::getUser($userId);
+        if (empty($user) || !array_key_exists('coin', $user)) {
+            return null;
+        }
+        $coin = $user['coin'];
+        if (is_int($coin) || is_float($coin)) {
+            return $coin;
+        }
+        if (is_string($coin) && is_numeric($coin)) {
+            return str_contains($coin, '.') ? (float) $coin : (int) $coin;
+        }
+        return null;
+    }
+
+    /** 删除用户缓存 */
+    public static function deleteUser(int $userId): bool
+    {
+        $key = self::prefix() . base64_encode((string) $userId);
+        return Cache::delete($key);
+    }
+
+    /** user-token 黑名单前缀（退出登录后使 token 失效） */
+    private static function blacklistPrefix(): string
+    {
+        return config('api.user_cache_prefix', 'api:user:') . 'token_blacklist:';
+    }
+
+    /**
+     * 将 user-token 加入黑名单（退出登录）
+     * @param string $token 完整 token 字符串
+     * @param int $ttl 黑名单过期时间（秒），建议为 token 剩余有效期
+     */
+    public static function addTokenToBlacklist(string $token, int $ttl = 86400): bool
+    {
+        if ($ttl <= 0) {
+            return true;
+        }
+        $key = self::blacklistPrefix() . md5($token);
+        return Cache::set($key, '1', $ttl);
+    }
+
+    /**
+     * 检查 user-token 是否在黑名单中（已退出）
+     */
+    public static function isTokenBlacklisted(string $token): bool
+    {
+        $key = self::blacklistPrefix() . md5($token);
+        $val = Cache::get($key);
+        return $val !== null && $val !== '';
+    }
+}
--- a/server/app/api/controller/AuthTokenController.php
+++ b/server/app/api/controller/AuthTokenController.php
@@ -0,0 +1,35 @@
+<?php
+declare(strict_types=1);
+
+namespace app\api\controller;
+
+use support\Request;
+use support\Response;
+use Tinywan\Jwt\JwtToken;
+use plugin\saiadmin\basic\OpenController;
+
+/**
+ * API 鉴权 Token 接口
+ * 后续所有 /api 接口调用均需在请求头携带此接口返回的 auth-token
+ */
+class AuthTokenController extends OpenController
+{
+    /**
+     * 获取 auth-token
+     * GET 或 POST /api/authToken
+     */
+    public function index(Request $request): Response
+    {
+        $exp = config('api.auth_token_exp', 86400);
+        $tokenResult = JwtToken::generateToken([
+            'id' => 0,
+            'plat' => 'api',
+            'access_exp' => $exp,
+        ]);
+
+        return $this->success([
+            'auth-token' => $tokenResult['access_token'],
+            'expires_in' => $tokenResult['expires_in'],
+        ]);
+    }
+}
--- a/server/app/api/controller/GameController.php
+++ b/server/app/api/controller/GameController.php
@@ -0,0 +1,150 @@
+<?php
+declare(strict_types=1);
+
+namespace app\api\controller;
+
+use support\Request;
+use support\Response;
+use app\api\logic\UserLogic;
+use app\api\logic\GameLogic;
+use app\api\logic\PlayStartLogic;
+use app\api\util\ReturnCode;
+use app\dice\model\play_record\DicePlayRecord;
+use app\dice\model\player\DicePlayer;
+use app\dice\model\reward_config\DiceRewardConfig;
+use plugin\saiadmin\basic\OpenController;
+use plugin\saiadmin\exception\ApiException;
+
+/**
+ * 游戏相关接口（购买抽奖券等）
+ */
+class GameController extends OpenController
+{
+    /**
+     * 购买抽奖券
+     * POST /api/game/buyLotteryTickets
+     * header: auth-token, user-token
+     * body: count = 1 | 5 | 10（1次/100coin, 5次/500coin, 10次/1000coin）
+     * 记录钱包流水，并更新缓存中玩家的 total_draw_count、paid_draw_count、free_draw_count、coin
+     */
+    public function buyLotteryTickets(Request $request): Response
+    {
+        $token = $request->header('user-token');
+        if (empty($token)) {
+            $auth = $request->header('authorization');
+            if ($auth && stripos($auth, 'Bearer ') === 0) {
+                $token = trim(substr($auth, 7));
+            }
+        }
+        if (empty($token)) {
+            return $this->fail('请携带 user-token', ReturnCode::MISSING_TOKEN);
+        }
+        $userId = UserLogic::getUserIdFromToken($token);
+        if ($userId === null) {
+            return $this->fail('user-token 无效或已过期', ReturnCode::TOKEN_TIMEOUT);
+        }
+
+        $count = (int) $request->post('count', 0);
+        if (!in_array($count, [1, 5, 10], true)) {
+            return $this->fail('购买抽奖券错误', ReturnCode::EMPTY_PARAMS);
+        }
+
+        try {
+            $logic = new GameLogic();
+            $data = $logic->buyLotteryTickets($userId, $count);
+            return $this->success($data);
+        } catch (ApiException $e) {
+            $msg = $e->getMessage();
+            if ($msg === '平台币不足') {
+                $player = DicePlayer::find($userId);
+                $coin = $player ? (float) $player->coin : 0;
+                return $this->success(['coin' => $coin], $msg);
+            }
+            return $this->fail($msg, ReturnCode::EMPTY_PARAMS);
+        }
+    }
+
+    /**
+     * 获取彩金池（中奖配置表）
+     * GET /api/game/lotteryPool
+     * header: auth-token
+     * 返回 DiceRewardConfig 列表（彩金池/中奖配置）
+     */
+    public function lotteryPool(Request $request): Response
+    {
+        $list = DiceRewardConfig::order('id', 'asc')->select()->toArray();
+        return $this->success($list);
+    }
+
+    /**
+     * 开始游戏（抽奖一局）
+     * POST /api/game/playStart
+     * header: auth-token, user-token
+     * body: rediction 必传，0=无 1=中奖
+     * 余额不足时返回 code=200、message=玩家当前余额不足无法开启对局；超时返回 code=200、message=服务超时，并记录 status=0
+     */
+    public function playStart(Request $request): Response
+    {
+        $token = $request->header('user-token');
+        if (empty($token)) {
+            $auth = $request->header('authorization');
+            if ($auth && stripos($auth, 'Bearer ') === 0) {
+                $token = trim(substr($auth, 7));
+            }
+        }
+        if (empty($token)) {
+            return $this->fail('请携带 user-token', ReturnCode::MISSING_TOKEN);
+        }
+        $userId = UserLogic::getUserIdFromToken($token);
+        if ($userId === null) {
+            return $this->fail('user-token 无效或已过期', ReturnCode::TOKEN_TIMEOUT);
+        }
+
+        $rediction = $request->post('rediction');
+        if ($rediction === '' || $rediction === null) {
+            return $this->fail('请传递 rediction 参数', ReturnCode::EMPTY_PARAMS);
+        }
+        $direction = (int) $rediction;
+        if (!in_array($direction, [0, 1], true)) {
+            return $this->fail('rediction 必须为 0 或 1', ReturnCode::EMPTY_PARAMS);
+        }
+
+        $player = DicePlayer::find($userId);
+        if (!$player) {
+            return $this->fail('用户不存在', ReturnCode::EMPTY_PARAMS);
+        }
+        $minEv = (float) DiceRewardConfig::min('real_ev');
+        $minCoin = abs($minEv + 100);
+        $coin = (float) $player->coin;
+        if ($coin < $minCoin) {
+            return $this->success([], '当前玩家余额小于DiceRewardConfigMin.real_ev+100无法继续游戏');
+        }
+
+        try {
+            $logic = new PlayStartLogic();
+            $data = $logic->run($userId, $direction);
+            return $this->success($data);
+        } catch (ApiException $e) {
+            return $this->fail($e->getMessage(), ReturnCode::EMPTY_PARAMS);
+        } catch (\Throwable $e) {
+            $timeoutRecord = null;
+            try {
+                $timeoutRecord = DicePlayRecord::create([
+                    'player_id'          => $userId,
+                    'lottery_config_id'  => 0,
+                    'lottery_type'       => 0,
+                    'win_coin'           => 0,
+                    'direction'          => $direction,
+                    'reward_config_id'   => 0,
+                    'start_index'        => 0,
+                    'target_index'       => 0,
+                    'roll_array'         => '[]',
+                    'status'             => PlayStartLogic::RECORD_STATUS_TIMEOUT,
+                ]);
+            } catch (\Throwable $_) {
+            }
+            $payload = $timeoutRecord ? ['record' => $timeoutRecord->toArray()] : [];
+            return $this->success($payload, '服务超时');
+        }
+    }
+}
--- a/server/app/api/controller/UserController.php
+++ b/server/app/api/controller/UserController.php
@@ -0,0 +1,272 @@
+<?php
+declare(strict_types=1);
+
+namespace app\api\controller;
+
+use support\Request;
+use support\Response;
+use app\api\cache\UserCache;
+use app\api\logic\UserLogic;
+use app\api\util\ReturnCode;
+use app\dice\model\play_record\DicePlayRecord;
+use app\dice\model\player_wallet_record\DicePlayerWalletRecord;
+use plugin\saiadmin\basic\OpenController;
+
+/**
+ * API 用户登录/注册
+ * 需先携带 auth-token，登录/注册成功后返回 user-token 与用户信息，用户信息已写入 Redis（key=base64(user_id)，value=加密）
+ */
+class UserController extends OpenController
+{
+    /**
+     * 登录
+     * POST /api/user/login
+     * body: phone (+60), password
+     */
+    public function login(Request $request): Response
+    {
+        $phone = $request->post('phone', '');
+        $password = $request->post('password', '');
+        if ($phone === '' || $password === '') {
+            return $this->fail('请填写手机号和密码', ReturnCode::EMPTY_PARAMS);
+        }
+        $logic = new UserLogic();
+        $data = $logic->login($phone, $password);
+        return $this->success([
+            'user' => $data['user'],
+            'user-token' => $data['user-token'],
+            'user_id' => $data['user_id'],
+        ]);
+    }
+
+    /**
+     * 注册
+     * POST /api/user/register
+     * body: phone (+60), password, nickname(可选)
+     */
+    public function register(Request $request): Response
+    {
+        $phone = $request->post('phone', '');
+        $password = $request->post('password', '');
+        $nickname = $request->post('nickname');
+        if ($phone === '' || $password === '') {
+            return $this->fail('请填写手机号和密码', ReturnCode::EMPTY_PARAMS);
+        }
+        $logic = new UserLogic();
+        $data = $logic->register($phone, $password, $nickname ? (string) $nickname : null);
+        return $this->success([
+            'user' => $data['user'],
+            'user-token' => $data['user-token'],
+            'user_id' => $data['user_id'],
+        ]);
+    }
+
+    /**
+     * 退出登录
+     * POST /api/user/logout
+     * header: user-token（或 Authorization: Bearer <user-token>）
+     * 将当前 user-token 加入黑名单，之后该 token 无法再用于获取 user_id
+     */
+    public function logout(Request $request): Response
+    {
+        $token = $request->header('user-token');
+        if (empty($token)) {
+            $auth = $request->header('authorization');
+            if ($auth && stripos($auth, 'Bearer ') === 0) {
+                $token = trim(substr($auth, 7));
+            }
+        }
+        if (empty($token)) {
+            return $this->fail('请携带 user-token', ReturnCode::MISSING_TOKEN);
+        }
+        if (UserLogic::logout($token)) {
+            return $this->success('已退出登录');
+        }
+        return $this->fail('退出失败或 token 已失效', ReturnCode::TOKEN_TIMEOUT);
+    }
+
+    /**
+     * 获取当前用户信息
+     * GET /api/user/info
+     * header: user-token（或 Authorization: Bearer <user-token>）
+     * 返回：id, username, phone, uid, name, coin, total_draw_count
+     */
+    public function info(Request $request): Response
+    {
+        $token = $request->header('user-token');
+        if (empty($token)) {
+            $auth = $request->header('authorization');
+            if ($auth && stripos($auth, 'Bearer ') === 0) {
+                $token = trim(substr($auth, 7));
+            }
+        }
+        if (empty($token)) {
+            return $this->fail('请携带 user-token', ReturnCode::MISSING_TOKEN);
+        }
+        $userId = UserLogic::getUserIdFromToken($token);
+        if ($userId === null) {
+            return $this->fail('user-token 无效或已过期', ReturnCode::TOKEN_TIMEOUT);
+        }
+        $user = UserLogic::getCachedUser($userId);
+        if (empty($user)) {
+            return $this->fail('用户不存在', ReturnCode::EMPTY_PARAMS);
+        }
+        $fields = ['id', 'username', 'phone', 'uid', 'name', 'coin', 'total_draw_count'];
+        $info = [];
+        foreach ($fields as $field) {
+            if (array_key_exists($field, $user)) {
+                $info[$field] = $user[$field];
+            }
+        }
+        return $this->success($info);
+    }
+
+    /**
+     * 获取钱包余额（仅读缓存，不查库，低延迟）
+     * GET /api/user/balance
+     * header: user-token（或 Authorization: Bearer <user-token>）
+     * 返回：coin, phone, username（登录时已写入缓存，本接口只从缓存读取）
+     */
+    public function balance(Request $request): Response
+    {
+        $token = $request->header('user-token');
+        if (empty($token)) {
+            $auth = $request->header('authorization');
+            if ($auth && stripos($auth, 'Bearer ') === 0) {
+                $token = trim(substr($auth, 7));
+            }
+        }
+        if (empty($token)) {
+            return $this->fail('请携带 user-token', ReturnCode::MISSING_TOKEN);
+        }
+        $userId = UserLogic::getUserIdFromToken($token);
+        if ($userId === null) {
+            return $this->fail('user-token 无效或已过期', ReturnCode::TOKEN_TIMEOUT);
+        }
+        $user = UserCache::getUser($userId);
+        if (empty($user)) {
+            return $this->fail('缓存已过期，请重新登录', ReturnCode::TOKEN_TIMEOUT);
+        }
+        $coin = $user['coin'] ?? null;
+        if (is_string($coin) && is_numeric($coin)) {
+            $coin = str_contains($coin, '.') ? (float) $coin : (int) $coin;
+        }
+        return $this->success([
+            'coin' => $coin,
+            'phone' => $user['phone'] ?? '',
+            'username' => $user['username'] ?? '',
+        ]);
+    }
+
+    /**
+     * 玩家钱包流水
+     * GET /api/user/walletRecord
+     * header: user-token（或 Authorization: Bearer <user-token>）
+     * 参数: page 页码（默认1）, limit 每页条数（默认10）, create_time_min/create_time_max 创建时间范围（可选）
+     */
+    public function walletRecord(Request $request): Response
+    {
+        $token = $request->header('user-token');
+        if (empty($token)) {
+            $auth = $request->header('authorization');
+            if ($auth && stripos($auth, 'Bearer ') === 0) {
+                $token = trim(substr($auth, 7));
+            }
+        }
+        if (empty($token)) {
+            return $this->fail('请携带 user-token', ReturnCode::MISSING_TOKEN);
+        }
+        $userId = UserLogic::getUserIdFromToken($token);
+        if ($userId === null) {
+            return $this->fail('user-token 无效或已过期', ReturnCode::TOKEN_TIMEOUT);
+        }
+
+        $page = (int) $request->post('page', 1);
+        $limit = (int) $request->post('limit', 10);
+        if ($page < 1) {
+            $page = 1;
+        }
+        if ($limit < 1) {
+            $limit = 10;
+        }
+
+        $query = DicePlayerWalletRecord::where('player_id', $userId)->order('id', 'desc');
+
+        $createTimeMin = $request->post('create_time_min', '');
+        $createTimeMax = $request->post('create_time_max', '');
+        if ($createTimeMin !== '' && $createTimeMin !== null) {
+            $query->where('create_time', '>=', $createTimeMin);
+        }
+        if ($createTimeMax !== '' && $createTimeMax !== null) {
+            $query->where('create_time', '<=', $createTimeMax);
+        }
+
+        $total = $query->count();
+        $list = $query->page($page, $limit)->select()->toArray();
+        $totalPage = $limit > 0 ? (int) ceil($total / $limit) : 0;
+
+        return $this->success([
+            'list'          => $list,
+            'total_count'  => $total,
+            'total_page'   => $totalPage,
+            'current_page' => $page,
+            'limit'        => $limit,
+        ]);
+    }
+
+    /**
+     * 游玩记录
+     * GET /api/user/playGameRecord
+     * header: user-token（或 Authorization: Bearer <user-token>）
+     * 参数: page 页码（默认1）, limit 每页条数（默认10）, create_time_min/create_time_max 创建时间范围（可选）
+     */
+    public function playGameRecord(Request $request): Response
+    {
+        $token = $request->header('user-token');
+        if (empty($token)) {
+            $auth = $request->header('authorization');
+            if ($auth && stripos($auth, 'Bearer ') === 0) {
+                $token = trim(substr($auth, 7));
+            }
+        }
+        if (empty($token)) {
+            return $this->fail('请携带 user-token', ReturnCode::MISSING_TOKEN);
+        }
+        $userId = UserLogic::getUserIdFromToken($token);
+        if ($userId === null) {
+            return $this->fail('user-token 无效或已过期', ReturnCode::TOKEN_TIMEOUT);
+        }
+
+        $page = (int) $request->post('page', 1);
+        $limit = (int) $request->post('limit', 10);
+        if ($page < 1) {
+            $page = 1;
+        }
+        if ($limit < 1) {
+            $limit = 10;
+        }
+
+        $query = DicePlayRecord::where('player_id', $userId)->order('id', 'desc');
+
+        $createTimeMin = $request->post('create_time_min', '');
+        $createTimeMax = $request->post('create_time_max', '');
+        if ($createTimeMin !== '' && $createTimeMin !== null) {
+            $query->where('create_time', '>=', $createTimeMin);
+        }
+        if ($createTimeMax !== '' && $createTimeMax !== null) {
+            $query->where('create_time', '<=', $createTimeMax);
+        }
+
+        $total = $query->count();
+        $list = $query->page($page, $limit)->select()->toArray();
+        $totalPage = $limit > 0 ? (int) ceil($total / $limit) : 0;
+
+        return $this->success([
+            'list'          => $list,
+            'total_count'  => $total,
+            'total_page'   => $totalPage,
+            'current_page' => $page,
+            'limit'        => $limit,
+        ]);
+    }
+}
--- a/server/app/api/logic/GameLogic.php
+++ b/server/app/api/logic/GameLogic.php
@@ -0,0 +1,113 @@
+<?php
+declare(strict_types=1);
+
+namespace app\api\logic;
+
+use app\api\cache\UserCache;
+use app\dice\model\player\DicePlayer;
+use app\dice\model\player_ticket_record\DicePlayerTicketRecord;
+use app\dice\model\player_wallet_record\DicePlayerWalletRecord;
+use plugin\saiadmin\exception\ApiException;
+use support\think\Db;
+
+/**
+ * 购买抽奖券套餐：次数 => [消耗coin, 购买次数paid, 赠送次数free]
+ * 仅支持 1、5、10 档
+ */
+class GameLogic
+{
+    public const PACKAGES = [
+        1  => ['coin' => 100,  'paid' => 1,  'free' => 0],   // 1次/100coin
+        5  => ['coin' => 500,  'paid' => 5,  'free' => 1],   // 5张/500coin（5购买+1赠送，共6次）
+        10 => ['coin' => 1000, 'paid' => 10, 'free' => 3],   // 10张/1000coin（10购买+3赠送，共13次）
+    ];
+
+    /** 钱包流水类型：购买抽奖次数 */
+    public const WALLET_TYPE_BUY_DRAW = 2;
+
+    /**
+     * 购买抽奖券
+     * @param int $playerId 玩家ID（即 user_id）
+     * @param int $count 购买档位：1 / 5 / 10
+     * @return array 更新后的 coin, total_draw_count, paid_draw_count, free_draw_count
+     */
+    public function buyLotteryTickets(int $playerId, int $count): array
+    {
+        if (!isset(self::PACKAGES[$count])) {
+            throw new ApiException('购买抽奖券错误');
+        }
+        $pack = self::PACKAGES[$count];
+        $cost = $pack['coin'];
+        $addPaid = $pack['paid'];
+        $addFree = $pack['free'];
+        $addTotal = $addPaid + $addFree;
+
+        $player = DicePlayer::find($playerId);
+        if (!$player) {
+            throw new ApiException('用户不存在');
+        }
+        $coinBefore = (float) $player->coin;
+        if ($coinBefore < $cost) {
+            throw new ApiException('平台币不足');
+        }
+
+        $coinAfter = $coinBefore - $cost;
+        $totalBefore = (int) ($player->total_draw_count ?? 0);
+        $paidBefore = (int) ($player->paid_draw_count ?? 0);
+        $freeBefore = (int) ($player->free_draw_count ?? 0);
+
+        Db::transaction(function () use (
+            $player,
+            $playerId,
+            $cost,
+            $coinBefore,
+            $coinAfter,
+            $addTotal,
+            $addPaid,
+            $addFree,
+            $totalBefore,
+            $paidBefore,
+            $freeBefore
+        ) {
+            $player->coin = $coinAfter;
+            $player->total_draw_count = $totalBefore + $addTotal;
+            $player->paid_draw_count = $paidBefore + $addPaid;
+            $player->free_draw_count = $freeBefore + $addFree;
+            $player->save();
+
+            // 钱包流水记录
+            DicePlayerWalletRecord::create([
+                'player_id'         => $playerId,
+                'coin'              => -$cost,
+                'type'              => self::WALLET_TYPE_BUY_DRAW,
+                'wallet_before'     => $coinBefore,
+                'wallet_after'      => $coinAfter,
+                'total_draw_count'  => $addTotal,
+                'paid_draw_count'   => $addPaid,
+                'free_draw_count'   => $addFree,
+                'remark'            => "购买抽奖券{$addTotal}次（付费{$addPaid}次+赠送{$addFree}次）",
+            ]);
+
+            // 抽奖券获取记录
+            DicePlayerTicketRecord::create([
+                'player_id'        => $playerId,
+                'use_coins'        => $cost,
+                'total_draw_count' => $addTotal,
+                'paid_draw_count'  => $addPaid,
+                'free_draw_count'  => $addFree,
+                'remark'           => "购买抽奖券{$addTotal}次（付费{$addPaid}次+赠送{$addFree}次）",
+            ]);
+        });
+
+        $updated = DicePlayer::find($playerId);
+        $userArr = $updated->hidden(['password'])->toArray();
+        UserCache::setUser($playerId, $userArr);
+
+        return [
+            'coin'               => (float) $updated->coin,
+            'total_draw_count'   => (int) $updated->total_draw_count,
+            'paid_draw_count'    => (int) $updated->paid_draw_count,
+            'free_draw_count'    => (int) $updated->free_draw_count,
+        ];
+    }
+}
--- a/server/app/api/logic/PlayStartLogic.php
+++ b/server/app/api/logic/PlayStartLogic.php
@@ -0,0 +1,224 @@
+<?php
+declare(strict_types=1);
+
+namespace app\api\logic;
+
+use app\api\cache\UserCache;
+use app\api\service\LotteryService;
+use app\dice\model\lottery_config\DiceLotteryConfig;
+use app\dice\model\play_record\DicePlayRecord;
+use app\dice\model\player\DicePlayer;
+use app\dice\model\player_ticket_record\DicePlayerTicketRecord;
+use app\dice\model\player_wallet_record\DicePlayerWalletRecord;
+use app\dice\model\reward_config\DiceRewardConfig;
+use plugin\saiadmin\exception\ApiException;
+use support\think\Cache;
+use support\think\Db;
+
+/**
+ * 开始游戏 / 抽奖一局
+ */
+class PlayStartLogic
+{
+    /** 抽奖类型：付费 */
+    public const LOTTERY_TYPE_PAID = 0;
+    /** 抽奖类型：免费 */
+    public const LOTTERY_TYPE_FREE = 1;
+    /** 钱包流水类型：抽奖 */
+    public const WALLET_TYPE_DRAW = 5;
+    /** 对局状态：成功 */
+    public const RECORD_STATUS_SUCCESS = 1;
+    /** 对局状态：超时/失败 */
+    public const RECORD_STATUS_TIMEOUT = 0;
+
+    /** 开启对局最低余额 = |DiceRewardConfig 最小 real_ev + 100| */
+    private const MIN_COIN_EXTRA = 100;
+
+    /**
+     * 执行一局游戏
+     * @param int $playerId 玩家ID
+     * @param int $direction 方向 0=无/顺时针 1=中奖/逆时针（前端 rediction）
+     * @return array 成功返回 DicePlayRecord 数据；余额不足时抛 ApiException，message 为约定文案
+     */
+    public function run(int $playerId, int $direction): array
+    {
+        $player = DicePlayer::find($playerId);
+        if (!$player) {
+            throw new ApiException('用户不存在');
+        }
+
+        $minEv = (float) DiceRewardConfig::min('real_ev');
+        $minCoin = abs($minEv + self::MIN_COIN_EXTRA);
+        $coin = (float) $player->coin;
+        if ($coin < $minCoin) {
+            throw new ApiException('当前玩家余额小于DiceRewardConfigMin.real_ev+100无法继续游戏');
+        }
+
+        $paid = (int) ($player->paid_draw_count ?? 0);
+        $free = (int) ($player->free_draw_count ?? 0);
+        if ($paid + $free <= 0) {
+            throw new ApiException('抽奖券不足');
+        }
+
+        $lotteryService = LotteryService::getOrCreate($playerId);
+        $ticketType = LotteryService::drawTicketType($paid, $free);
+        $config = $ticketType === self::LOTTERY_TYPE_PAID
+            ? ($lotteryService->getConfigType0Id() ? DiceLotteryConfig::find($lotteryService->getConfigType0Id()) : null)
+            : ($lotteryService->getConfigType1Id() ? DiceLotteryConfig::find($lotteryService->getConfigType1Id()) : null);
+        if (!$config) {
+            throw new ApiException('奖池配置不存在');
+        }
+
+        $tier = LotteryService::drawTierByWeights($config);
+        $rewards = DiceRewardConfig::where('tier', $tier)->select();
+        if ($rewards->isEmpty()) {
+            throw new ApiException('该档位暂无奖励配置');
+        }
+        $rewardList = $rewards->all();
+        $reward = $rewardList[array_rand($rewardList)];
+        $realEv = (float) $reward->real_ev;
+        $winCoin = 100 + $realEv; // 赢取平台币 = 100 + DiceRewardConfig.real_ev
+        $gridNumber = (int) $reward->grid_number;
+        $startIndex = (int) Cache::get(LotteryService::getStartIndexKey($playerId), 0);
+        $targetIndex = (int) $reward->id;
+        $rollArray = $this->generateRollArray($gridNumber);
+
+        $record = null;
+        $configId = (int) $config->id;
+        $rewardId = (int) $reward->id;
+        $configName = (string) ($config->name ?? '');
+        $isTierT5 = (string) ($reward->tier ?? '') === 'T5';
+        try {
+            Db::transaction(function () use (
+                $playerId,
+                $configId,
+                $rewardId,
+                $configName,
+                $ticketType,
+                $winCoin,
+                $realEv,
+                $direction,
+                $startIndex,
+                $targetIndex,
+                $rollArray,
+                $isTierT5,
+                &$record
+            ) {
+                $record = DicePlayRecord::create([
+                    'player_id'          => $playerId,
+                    'lottery_config_id'  => $configId,
+                    'lottery_type'       => $ticketType,
+                    'win_coin'           => $winCoin,
+                    'direction'          => $direction,
+                    'reward_config_id'   => $rewardId,
+                    'start_index'        => $startIndex,
+                    'target_index'       => $targetIndex,
+                    'roll_array'         => is_array($rollArray) ? json_encode($rollArray) : $rollArray,
+                    'lottery_name'       => $configName,
+                    'status'             => self::RECORD_STATUS_SUCCESS,
+                ]);
+
+                $p = DicePlayer::find($playerId);
+                if (!$p) {
+                    throw new \RuntimeException('玩家不存在');
+                }
+                $coinBefore = (float) $p->coin;
+                $coinAfter = $coinBefore + $winCoin;
+                $p->coin = $coinAfter;
+                $p->total_draw_count = max(0, (int) $p->total_draw_count - 1);
+                if ($ticketType === self::LOTTERY_TYPE_PAID) {
+                    $p->paid_draw_count = max(0, (int) $p->paid_draw_count - 1);
+                } else {
+                    $p->free_draw_count = max(0, (int) $p->free_draw_count - 1);
+                }
+
+                // 若本局中奖档位为 T5，则额外赠送 1 次免费抽奖次数（总次数也 +1），并记录抽奖券获取记录
+                if ($isTierT5) {
+                    $p->free_draw_count = (int) $p->free_draw_count + 1;
+                    $p->total_draw_count = (int) $p->total_draw_count + 1;
+
+                    DicePlayerTicketRecord::create([
+                        'player_id'       => $playerId,
+                        'free_draw_count' => 1,
+                        'remark'          => '中奖结果为T5',
+                    ]);
+                }
+
+                $p->save();
+
+                // 累加彩金池盈利额度（累加值为 -real_ev）。若 dice_lottery_config 表有 ev 字段则执行
+                try {
+                    DiceLotteryConfig::where('id', $configId)->update([
+                        'ev' => Db::raw('IFNULL(ev,0) - ' . (float) $realEv),
+                    ]);
+                } catch (\Throwable $_) {
+                }
+
+                DicePlayerWalletRecord::create([
+                    'player_id'      => $playerId,
+                    'coin'           => $winCoin,
+                    'type'           => self::WALLET_TYPE_DRAW,
+                    'wallet_before'  => $coinBefore,
+                    'wallet_after'   => $coinAfter,
+                    'remark'         => '抽奖|play_record_id=' . $record->id,
+                ]);
+
+                Cache::set(LotteryService::getStartIndexKey($playerId), $targetIndex, 86400 * 30);
+            });
+        } catch (\Throwable $e) {
+            if ($record === null) {
+                try {
+                    $record = DicePlayRecord::create([
+                        'player_id'          => $playerId,
+                        'lottery_config_id'  => $configId ?? 0,
+                        'lottery_type'       => $ticketType,
+                        'win_coin'           => 0,
+                        'direction'          => $direction,
+                        'reward_config_id'   => 0,
+                        'start_index'        => $startIndex,
+                        'target_index'       => 0,
+                        'roll_array'         => '[]',
+                        'status'             => self::RECORD_STATUS_TIMEOUT,
+                    ]);
+                } catch (\Throwable $_) {
+                    // 表可能无 status 字段时忽略
+                }
+            }
+            throw $e;
+        }
+
+        $updated = DicePlayer::find($playerId);
+        if ($updated) {
+            UserCache::setUser($playerId, $updated->hidden(['password'])->toArray());
+        }
+
+        if (!$record instanceof DicePlayRecord) {
+            throw new \RuntimeException('对局记录创建失败');
+        }
+        $arr = $record->toArray();
+        if (isset($arr['roll_array']) && is_string($arr['roll_array'])) {
+            $arr['roll_array'] = json_decode($arr['roll_array'], true) ?? [];
+        }
+        return $arr;
+    }
+
+    /** 生成 5 个 1-6 的点数，和为 grid_number（5~30），严格不超范围 */
+    private function generateRollArray(int $gridNumber): array
+    {
+        $minSum = 5;
+        $maxSum = 30;
+        $n = max($minSum, min($maxSum, $gridNumber));
+        $dice = [1, 1, 1, 1, 1];
+        $remain = $n - 5;
+        while ($remain > 0) {
+            $i = array_rand($dice);
+            if ($dice[$i] < 6) {
+                $add = min($remain, 6 - $dice[$i]);
+                $dice[$i] += $add;
+                $remain -= $add;
+            }
+        }
+        shuffle($dice);
+        return $dice;
+    }
+}
--- a/server/app/api/logic/UserLogic.php
+++ b/server/app/api/logic/UserLogic.php
@@ -0,0 +1,180 @@
+<?php
+declare(strict_types=1);
+
+namespace app\api\logic;
+
+use app\dice\model\player\DicePlayer;
+use app\api\cache\UserCache;
+use plugin\saiadmin\exception\ApiException;
+use Tinywan\Jwt\JwtToken;
+
+/**
+ * API 用户登录/注册逻辑（基于 DicePlayer 表）
+ * 手机号格式限制：+60（马来西亚）
+ */
+class UserLogic
+{
+    /** 手机号正则：+60 开头，后跟 9–10 位数字（马来西亚） */
+    private const PHONE_REGEX = '/^\+60\d{9,10}$/';
+
+    /** 与 DicePlayerLogic 保持一致的密码盐，用于登录校验与注册写入 */
+    private const PASSWORD_SALT = 'dice_player_salt_2024';
+
+    /** 状态：正常 */
+    private const STATUS_NORMAL = 1;
+
+    /**
+     * 手机号格式校验：+60 开头
+     */
+    public static function validatePhone(string $phone): void
+    {
+        if (!preg_match(self::PHONE_REGEX, $phone)) {
+            throw new ApiException('手机号格式错误，仅支持 +60 开头的马来西亚号码（如 +60123456789）');
+        }
+    }
+
+    /**
+     * 登录：手机号 + 密码，返回用户信息与 user-token，并写入 Redis 缓存
+     */
+    public function login(string $phone, string $password): array
+    {
+        self::validatePhone($phone);
+
+        $user = DicePlayer::where('phone', $phone)->find();
+        if (!$user) {
+            throw new ApiException('手机号未注册');
+        }
+        if ((int) $user->status !== self::STATUS_NORMAL) {
+            throw new ApiException('账号已被禁用');
+        }
+        $hashed = $this->hashPassword($password);
+        if ($user->password !== $hashed) {
+            throw new ApiException('密码错误');
+        }
+
+        $userArr = $user->hidden(['password'])->toArray();
+        UserCache::setUser((int) $user->id, $userArr);
+
+        $userToken = $this->generateUserToken((int) $user->id);
+        return [
+            'user' => $userArr,
+            'user-token' => $userToken,
+            'user_id' => (int) $user->id,
+        ];
+    }
+
+    /**
+     * 注册：手机号 + 密码（+60），创建玩家并返回用户信息与 user-token，写入 Redis
+     */
+    public function register(string $phone, string $password, ?string $nickname = null): array
+    {
+        self::validatePhone($phone);
+
+        if (strlen($password) < 6) {
+            throw new ApiException('密码至少 6 位');
+        }
+
+        $exists = DicePlayer::where('phone', $phone)->find();
+        if ($exists) {
+            throw new ApiException('该手机号已注册');
+        }
+
+        $user = new DicePlayer();
+        $user->phone = $phone;
+        $user->username = $phone;
+        if ($nickname !== null && $nickname !== '') {
+            $user->name = $nickname;
+        }
+        // name 未传时由 DicePlayer::onBeforeInsert 默认设为 uid
+        $user->password = $this->hashPassword($password);
+        $user->status = self::STATUS_NORMAL;
+        $user->save();
+
+        $userArr = $user->hidden(['password'])->toArray();
+        UserCache::setUser((int) $user->id, $userArr);
+
+        $userToken = $this->generateUserToken((int) $user->id);
+        return [
+            'user' => $userArr,
+            'user-token' => $userToken,
+            'user_id' => (int) $user->id,
+        ];
+    }
+
+    /**
+     * 与 DicePlayerLogic 一致的密码加密：md5(salt . password)
+     */
+    private function hashPassword(string $password): string
+    {
+        return md5(self::PASSWORD_SALT . $password);
+    }
+
+    /**
+     * 生成 user-token（JWT，plat=api_user，id=user_id）
+     */
+    private function generateUserToken(int $userId): string
+    {
+        $exp = config('api.user_token_exp', 604800);
+        $result = JwtToken::generateToken([
+            'id' => $userId,
+            'plat' => 'api_user',
+            'access_exp' => $exp,
+        ]);
+        return $result['access_token'];
+    }
+
+    /**
+     * 根据 user-token 获取 user_id（不写缓存，仅解析 JWT）
+     * 若 token 已通过退出接口加入黑名单，返回 null
+     */
+    public static function getUserIdFromToken(string $userToken): ?int
+    {
+        if (UserCache::isTokenBlacklisted($userToken)) {
+            return null;
+        }
+        try {
+            $decoded = JwtToken::verify(1, $userToken);
+            $extend = $decoded['extend'] ?? [];
+            if (($extend['plat'] ?? '') !== 'api_user') {
+                return null;
+            }
+            $id = $extend['id'] ?? null;
+            return $id !== null ? (int) $id : null;
+        } catch (\Throwable $e) {
+            return null;
+        }
+    }
+
+    /**
+     * 退出登录：将当前 user-token 加入黑名单，使该 token 失效
+     */
+    public static function logout(string $userToken): bool
+    {
+        try {
+            $decoded = JwtToken::verify(1, $userToken);
+            $exp = (int) ($decoded['exp'] ?? 0);
+            $ttl = $exp > time() ? $exp - time() : 86400;
+            return UserCache::addTokenToBlacklist($userToken, $ttl);
+        } catch (\Throwable $e) {
+            return false;
+        }
+    }
+
+    /**
+     * 从 Redis 获取用户信息（key = base64(user_id)），未命中则查 DicePlayer 并回写缓存
+     */
+    public static function getCachedUser(int $userId): array
+    {
+        $cached = UserCache::getUser($userId);
+        if (!empty($cached)) {
+            return $cached;
+        }
+        $user = DicePlayer::find($userId);
+        if (!$user) {
+            return [];
+        }
+        $arr = $user->hidden(['password'])->toArray();
+        UserCache::setUser($userId, $arr);
+        return $arr;
+    }
+}
--- a/server/app/api/middleware/CheckApiAuthMiddleware.php
+++ b/server/app/api/middleware/CheckApiAuthMiddleware.php
@@ -0,0 +1,75 @@
+<?php
+declare(strict_types=1);
+
+namespace app\api\middleware;
+
+use support\Log;
+use Webman\Http\Request;
+use Webman\Http\Response;
+use Webman\MiddlewareInterface;
+use Tinywan\Jwt\JwtToken;
+use Tinywan\Jwt\Exception\JwtTokenException;
+use Tinywan\Jwt\Exception\JwtTokenExpiredException;
+use app\api\util\ReturnCode;
+use plugin\saiadmin\exception\ApiException;
+
+/**
+ * API 鉴权中间件
+ * 校验请求头 auth-token（或 Authorization: Bearer xxx），白名单路径不校验
+ */
+class CheckApiAuthMiddleware implements MiddlewareInterface
+{
+    /** 不需要 auth-token 的路径（仅获取 token 的接口） */
+    private const WHITELIST = [
+        'api/authToken',
+    ];
+
+    public function process(Request $request, callable $handler): Response
+    {
+        $path = trim($request->path(), '/');
+        if ($this->isWhitelist($path)) {
+            return $handler($request);
+        }
+
+        $token = $request->header('auth-token');
+        if (empty($token)) {
+            $auth = $request->header('authorization');
+            if ($auth && stripos($auth, 'Bearer ') === 0) {
+                $token = trim(substr($auth, 7));
+            }
+        }
+        if (empty($token)) {
+            throw new ApiException('请携带 auth-token', ReturnCode::MISSING_TOKEN);
+        }
+
+        try {
+            // ACCESS_TOKEN = 1（JwtToken 内部私有常量）
+            $decoded = JwtToken::verify(1, $token);
+            $extend = $decoded['extend'] ?? [];
+            if (($extend['plat'] ?? '') !== 'api') {
+                throw new ApiException('auth-token 无效', ReturnCode::TOKEN_TIMEOUT);
+            }
+        } catch (JwtTokenExpiredException $e) {
+            Log::error('auth-token 已过期, 报错信息'. $e);
+            throw new ApiException('auth-token 已过期', ReturnCode::TOKEN_TIMEOUT);
+        } catch (JwtTokenException $e) {
+            Log::error('auth-token 无效, 报错信息'. $e);
+            throw new ApiException($e->getMessage() ?: 'auth-token 无效', ReturnCode::TOKEN_TIMEOUT);
+        } catch (\Throwable $e) {
+            Log::error('auth-token 校验失败, 报错信息'. $e);
+            throw new ApiException('auth-token 校验失败', ReturnCode::TOKEN_TIMEOUT);
+        }
+
+        return $handler($request);
+    }
+
+    private function isWhitelist(string $path): bool
+    {
+        foreach (self::WHITELIST as $prefix) {
+            if ($path === $prefix || str_starts_with($path, $prefix . '/')) {
+                return true;
+            }
+        }
+        return false;
+    }
+}
--- a/server/app/api/service/LotteryService.php
+++ b/server/app/api/service/LotteryService.php
@@ -0,0 +1,138 @@
+<?php
+declare(strict_types=1);
+
+namespace app\api\service;
+
+use app\dice\model\lottery_config\DiceLotteryConfig;
+use app\dice\model\player\DicePlayer;
+use support\think\Cache;
+
+/**
+ * 彩金池实例，按玩家权重与奖池配置创建，存 Redis 便于增删改查
+ */
+class LotteryService
+{
+    private const REDIS_KEY_PREFIX = 'api:game:lottery_pool:';
+    private const REDIS_KEY_START_INDEX = 'api:game:start_index:';
+    private const EXPIRE = 86400 * 7; // 7天
+
+    private int $playerId;
+    private ?int $configType0Id = null;
+    private ?int $configType1Id = null;
+    /** @var array{t1_wight?:int,t2_wight?:int,t3_wight?:int,t4_wight?:int,t5_wight?:int} */
+    private array $playerWeights = [];
+
+    public function __construct(int $playerId)
+    {
+        $this->playerId = $playerId;
+    }
+
+    public static function getRedisKey(int $playerId): string
+    {
+        return self::REDIS_KEY_PREFIX . $playerId;
+    }
+
+    public static function getStartIndexKey(int $playerId): string
+    {
+        return self::REDIS_KEY_START_INDEX . $playerId;
+    }
+
+    /** 从 Redis 加载或根据玩家与 DiceLotteryConfig 创建并保存 */
+    public static function getOrCreate(int $playerId): self
+    {
+        $key = self::getRedisKey($playerId);
+        $cached = Cache::get($key);
+        if ($cached && is_string($cached)) {
+            $data = json_decode($cached, true);
+            if (is_array($data)) {
+                $s = new self($playerId);
+                $s->configType0Id = (int) ($data['config_type_0_id'] ?? 0);
+                $s->configType1Id = (int) ($data['config_type_1_id'] ?? 0);
+                $s->playerWeights = $data['player_weights'] ?? [];
+                return $s;
+            }
+        }
+        $player = DicePlayer::find($playerId);
+        if (!$player) {
+            throw new \RuntimeException('玩家不存在');
+        }
+        $config0 = DiceLotteryConfig::where('type', 0)->find();
+        $config1 = DiceLotteryConfig::where('type', 1)->find();
+        $s = new self($playerId);
+        $s->configType0Id = $config0 ? (int) $config0->id : null;
+        $s->configType1Id = $config1 ? (int) $config1->id : null;
+        $s->playerWeights = [
+            't1_wight' => (int) ($player->t1_wight ?? 0),
+            't2_wight' => (int) ($player->t2_wight ?? 0),
+            't3_wight' => (int) ($player->t3_wight ?? 0),
+            't4_wight' => (int) ($player->t4_wight ?? 0),
+            't5_wight' => (int) ($player->t5_wight ?? 0),
+        ];
+        $s->save();
+        return $s;
+    }
+
+    public function save(): void
+    {
+        $key = self::getRedisKey($this->playerId);
+        $data = [
+            'config_type_0_id' => $this->configType0Id,
+            'config_type_1_id' => $this->configType1Id,
+            'player_weights'   => $this->playerWeights,
+        ];
+        Cache::set($key, json_encode($data), self::EXPIRE);
+    }
+
+    /** 根据奖池配置的 t1_wight..t5_wight 权重随机抽取档位 T1-T5 */
+    public static function drawTierByWeights(DiceLotteryConfig $config): string
+    {
+        $tiers = ['T1', 'T2', 'T3', 'T4', 'T5'];
+        $weights = [
+            (int) ($config->t1_wight ?? 0),
+            (int) ($config->t2_wight ?? 0),
+            (int) ($config->t3_wight ?? 0),
+            (int) ($config->t4_wight ?? 0),
+            (int) ($config->t5_wight ?? 0),
+        ];
+        $total = array_sum($weights);
+        if ($total <= 0) {
+            return $tiers[array_rand($tiers)];
+        }
+        $r = mt_rand(1, $total);
+        $acc = 0;
+        foreach ($weights as $i => $w) {
+            $acc += $w;
+            if ($r <= $acc) {
+                return $tiers[$i];
+            }
+        }
+        return $tiers[4];
+    }
+
+    /** 按 paid_draw_count 与 free_draw_count 权重随机抽取 0=付费 1=免费 */
+    public static function drawTicketType(int $paid, int $free): int
+    {
+        if ($paid <= 0 && $free <= 0) {
+            throw new \RuntimeException('抽奖券不足');
+        }
+        if ($paid <= 0) {
+            return 1;
+        }
+        if ($free <= 0) {
+            return 0;
+        }
+        $total = $paid + $free;
+        $r = mt_rand(1, $total);
+        return $r <= $paid ? 0 : 1;
+    }
+
+    public function getConfigType0Id(): ?int
+    {
+        return $this->configType0Id;
+    }
+
+    public function getConfigType1Id(): ?int
+    {
+        return $this->configType1Id;
+    }
+}
--- a/server/app/api/util/ReturnCode.php
+++ b/server/app/api/util/ReturnCode.php
@@ -0,0 +1,22 @@
+<?php
+declare(strict_types=1);
+
+namespace app\api\util;
+
+/**
+ * API 状态码统一管理
+ */
+class ReturnCode
+{
+    /** 200 成功 */
+    public const SUCCESS = 200;
+
+    /** 201 请携带 token（auth-token / user-token） */
+    public const MISSING_TOKEN = 201;
+
+    /** 202 缺少参数 / 参数错误 / 业务校验不通过（如余额不足、购买抽奖券错误等） */
+    public const EMPTY_PARAMS = 202;
+
+    /** 203 token 过期或无效（auth-token / user-token 过期、缓存已过期等） */
+    public const TOKEN_TIMEOUT = 203;
+}
--- a/server/app/dice/controller/play_record/DicePlayRecordController.php
+++ b/server/app/dice/controller/play_record/DicePlayRecordController.php
@@ -48,6 +48,7 @@ class DicePlayRecordController extends BaseController
            ['win_coin_max', ''],
            ['reward_ui_text', ''],
            ['reward_tier', ''],
+            ['direction', ''],
        ]);
        $query = $this->logic->search($where);
        $query->with([
--- a/server/app/dice/controller/player/DicePlayerController.php
+++ b/server/app/dice/controller/player/DicePlayerController.php
@@ -39,6 +39,7 @@ class DicePlayerController extends BaseController
        $where = $request->more([
            ['username', ''],
            ['name', ''],
+            ['phone', ''],
            ['status', ''],
            ['coin', ''],
            ['is_up', ''],
--- a/server/app/dice/controller/player_ticket_record/DicePlayerTicketRecordController.php
+++ b/server/app/dice/controller/player_ticket_record/DicePlayerTicketRecordController.php
@@ -4,28 +4,28 @@
 // +----------------------------------------------------------------------
 // | Author: your name
 // +----------------------------------------------------------------------
-namespace app\dice\controller\player_coin_record;
+namespace app\dice\controller\player_ticket_record;

 use plugin\saiadmin\basic\BaseController;
-use app\dice\logic\player_coin_record\DicePlayerCoinRecordLogic;
-use app\dice\validate\player_coin_record\DicePlayerCoinRecordValidate;
+use app\dice\logic\player_ticket_record\DicePlayerTicketRecordLogic;
+use app\dice\validate\player_ticket_record\DicePlayerTicketRecordValidate;
 use app\dice\model\player\DicePlayer;
 use plugin\saiadmin\service\Permission;
 use support\Request;
 use support\Response;

 /**
- * 玩家购买抽奖记录控制器
+ * 抽奖券获取记录控制器
 */
-class DicePlayerCoinRecordController extends BaseController
+class DicePlayerTicketRecordController extends BaseController
 {
    /**
     * 构造函数
     */
    public function __construct()
    {
-        $this->logic = new DicePlayerCoinRecordLogic();
-        $this->validate = new DicePlayerCoinRecordValidate;
+        $this->logic = new DicePlayerTicketRecordLogic();
+        $this->validate = new DicePlayerTicketRecordValidate;
        parent::__construct();
    }

@@ -34,7 +34,7 @@ class DicePlayerCoinRecordController extends BaseController
     * @param Request $request
     * @return Response
     */
-    #[Permission('玩家购买抽奖记录列表', 'dice:player_coin_record:index:index')]
+    #[Permission('抽奖券获取记录列表', 'dice:player_ticket_record:index:index')]
    public function index(Request $request): Response
    {
        $where = $request->more([
@@ -63,7 +63,7 @@ class DicePlayerCoinRecordController extends BaseController
     * @param Request $request
     * @return Response
     */
-    #[Permission('玩家购买抽奖记录列表', 'dice:player_coin_record:index:index')]
+    #[Permission('抽奖券获取记录列表', 'dice:player_ticket_record:index:index')]
    public function getPlayerOptions(Request $request): Response
    {
        $list = DicePlayer::field('id,username')->select();
@@ -78,7 +78,7 @@ class DicePlayerCoinRecordController extends BaseController
     * @param Request $request
     * @return Response
     */
-    #[Permission('玩家购买抽奖记录读取', 'dice:player_coin_record:index:read')]
+    #[Permission('抽奖券获取记录读取', 'dice:player_ticket_record:index:read')]
    public function read(Request $request): Response
    {
        $id = $request->input('id', '');
@@ -96,7 +96,7 @@ class DicePlayerCoinRecordController extends BaseController
     * @param Request $request
     * @return Response
     */
-    #[Permission('玩家购买抽奖记录添加', 'dice:player_coin_record:index:save')]
+    #[Permission('抽奖券获取记录添加', 'dice:player_ticket_record:index:save')]
    public function save(Request $request): Response
    {
        $data = $request->post();
@@ -114,7 +114,7 @@ class DicePlayerCoinRecordController extends BaseController
     * @param Request $request
     * @return Response
     */
-    #[Permission('玩家购买抽奖记录修改', 'dice:player_coin_record:index:update')]
+    #[Permission('抽奖券获取记录修改', 'dice:player_ticket_record:index:update')]
    public function update(Request $request): Response
    {
        $data = $request->post();
@@ -132,7 +132,7 @@ class DicePlayerCoinRecordController extends BaseController
     * @param Request $request
     * @return Response
     */
-    #[Permission('玩家购买抽奖记录删除', 'dice:player_coin_record:index:destroy')]
+    #[Permission('抽奖券获取记录删除', 'dice:player_ticket_record:index:destroy')]
    public function destroy(Request $request): Response
    {
        $ids = $request->post('ids', '');
--- a/server/app/dice/controller/player_wallet_record/DicePlayerWalletRecordController.php
+++ b/server/app/dice/controller/player_wallet_record/DicePlayerWalletRecordController.php
@@ -13,6 +13,7 @@ use app\dice\model\player\DicePlayer;
 use plugin\saiadmin\service\Permission;
 use support\Request;
 use support\Response;
+use Tinywan\Jwt\JwtToken;

 /**
 * 玩家钱包流水控制器
@@ -42,10 +43,13 @@ class DicePlayerWalletRecordController extends BaseController
            ['username', ''],
            ['coin_min', ''],
            ['coin_max', ''],
+            ['create_time_min', ''],
+            ['create_time_max', ''],
        ]);
        $query = $this->logic->search($where);
        $query->with([
            'dicePlayer',
+            'operator',
        ]);
        $data = $this->logic->getList($query);
        return $this->success($data);
@@ -104,6 +108,61 @@ class DicePlayerWalletRecordController extends BaseController
        }
    }

+    /**
+     * 管理员钱包操作（加点/扣点）：更新玩家平台币并创建流水记录
+     * @param Request $request
+     * @return Response
+     */
+    #[Permission('玩家钱包流水添加', 'dice:player_wallet_record:index:save')]
+    public function adminOperate(Request $request): Response
+    {
+        $data = $request->post();
+        $playerId = $data['player_id'] ?? null;
+        $type = isset($data['type']) ? (int) $data['type'] : null;
+        $coin = isset($data['coin']) ? (float) $data['coin'] : null;
+
+        if ($playerId === null || $playerId === '') {
+            return $this->fail('请选择玩家');
+        }
+        if (!in_array($type, [3, 4], true)) {
+            return $this->fail('操作类型必须为 3=加点 或 4=扣点');
+        }
+        if ($coin === null || $coin <= 0) {
+            return $this->fail('平台币变动必须大于 0');
+        }
+
+        $data['player_id'] = $playerId;
+        $data['type'] = $type;
+        $data['coin'] = $coin;
+        $data['remark'] = $data['remark'] ?? '';
+
+        $adminId = null;
+        $checkAdmin = request()->header('check_admin');
+        if (!empty($checkAdmin['id'])) {
+            $adminId = (int) $checkAdmin['id'];
+        }
+        if (($adminId === null || $adminId <= 0)) {
+            try {
+                $token = JwtToken::getExtend();
+                if (!empty($token['id']) && ($token['plat'] ?? '') === 'saiadmin') {
+                    $adminId = (int) $token['id'];
+                }
+            } catch (\Throwable $e) {
+                // JWT 无效或未携带
+            }
+        }
+        if ($adminId === null || $adminId <= 0) {
+            return $this->fail('请先登录');
+        }
+
+        try {
+            $this->logic->adminOperate($data, $adminId);
+            return $this->success('操作成功');
+        } catch (\Throwable $e) {
+            return $this->fail($e->getMessage());
+        }
+    }
+
    /**
     * 保存数据
     * @param Request $request
--- a/server/app/dice/logic/play_record/DicePlayRecordLogic.php
+++ b/server/app/dice/logic/play_record/DicePlayRecordLogic.php
@@ -24,4 +24,36 @@ class DicePlayRecordLogic extends BaseLogic
        $this->model = new DicePlayRecord();
    }

+    /**
+     * 添加前：roll_array 转为 JSON 字符串（数据库为 string 类型）
+     */
+    public function add(array $data): mixed
+    {
+        $data = $this->normalizeRollArray($data);
+        return parent::add($data);
+    }
+
+    /**
+     * 修改前：roll_array 转为 JSON 字符串（数据库为 string 类型）
+     */
+    public function edit($id, array $data): mixed
+    {
+        $data = $this->normalizeRollArray($data);
+        return parent::edit($id, $data);
+    }
+
+    /**
+     * 将 roll_array 从数组转为 JSON 字符串
+     */
+    private function normalizeRollArray(array $data): array
+    {
+        if (!array_key_exists('roll_array', $data)) {
+            return $data;
+        }
+        $val = $data['roll_array'];
+        if (is_array($val)) {
+            $data['roll_array'] = json_encode($val, JSON_UNESCAPED_UNICODE);
+        }
+        return $data;
+    }
 }
--- a/server/app/dice/logic/player_ticket_record/DicePlayerTicketRecordLogic.php
+++ b/server/app/dice/logic/player_ticket_record/DicePlayerTicketRecordLogic.php
@@ -4,24 +4,24 @@
 // +----------------------------------------------------------------------
 // | Author: your name
 // +----------------------------------------------------------------------
-namespace app\dice\logic\player_coin_record;
+namespace app\dice\logic\player_ticket_record;

 use plugin\saiadmin\basic\think\BaseLogic;
 use plugin\saiadmin\exception\ApiException;
 use plugin\saiadmin\utils\Helper;
-use app\dice\model\player_coin_record\DicePlayerCoinRecord;
+use app\dice\model\player_ticket_record\DicePlayerTicketRecord;

 /**
- * 玩家购买抽奖记录逻辑层
+ * 抽奖券获取记录逻辑层
 */
-class DicePlayerCoinRecordLogic extends BaseLogic
+class DicePlayerTicketRecordLogic extends BaseLogic
 {
    /**
     * 构造函数
     */
    public function __construct()
    {
-        $this->model = new DicePlayerCoinRecord();
+        $this->model = new DicePlayerTicketRecord();
    }

    /**
--- a/server/app/dice/logic/player_wallet_record/DicePlayerWalletRecordLogic.php
+++ b/server/app/dice/logic/player_wallet_record/DicePlayerWalletRecordLogic.php
@@ -8,8 +8,8 @@ namespace app\dice\logic\player_wallet_record;

 use plugin\saiadmin\basic\think\BaseLogic;
 use plugin\saiadmin\exception\ApiException;
-use plugin\saiadmin\utils\Helper;
 use app\dice\model\player_wallet_record\DicePlayerWalletRecord;
+use app\dice\model\player\DicePlayer;

 /**
 * 玩家钱包流水逻辑层
@@ -35,4 +35,57 @@ class DicePlayerWalletRecordLogic extends BaseLogic
        return parent::add($data);
    }

+    /**
+     * 管理员钱包操作（加点/扣点）：更新玩家平台币并创建流水记录
+     * @param array $data player_id, type (3=加点 4=扣点), coin (正数), remark (可选)
+     * @param int $adminId 当前管理员 id
+     * @return mixed
+     * @throws ApiException
+     */
+    public function adminOperate(array $data, int $adminId): mixed
+    {
+        $playerId = (int) ($data['player_id'] ?? 0);
+        $type = (int) ($data['type'] ?? 0);
+        $coin = (float) ($data['coin'] ?? 0);
+
+        if ($playerId <= 0 || !in_array($type, [3, 4], true)) {
+            throw new ApiException('参数错误：需要有效的 player_id 和 type（3=加点，4=扣点）');
+        }
+        if ($coin <= 0) {
+            throw new ApiException('平台币变动必须大于 0');
+        }
+
+        $player = DicePlayer::where('id', $playerId)->find();
+        if (!$player) {
+            throw new ApiException('玩家不存在');
+        }
+
+        $walletBefore = (float) ($player['coin'] ?? 0);
+        if ($type === 4 && $walletBefore < $coin) {
+            throw new ApiException('扣点数量不能大于当前余额');
+        }
+
+        $walletAfter = $type === 3 ? $walletBefore + $coin : $walletBefore - $coin;
+        $remark = trim((string) ($data['remark'] ?? ''));
+        if ($remark === '') {
+            $remark = $type === 3 ? '管理员加点' : '管理员扣点';
+        }
+
+        DicePlayer::where('id', $playerId)->update(['coin' => $walletAfter]);
+
+        $record = [
+            'player_id' => $playerId,
+            'coin' => $type === 3 ? $coin : -$coin,
+            'type' => $type,
+            'wallet_before' => $walletBefore,
+            'wallet_after' => $walletAfter,
+            'remark' => $remark,
+            'user_id' => $adminId,
+            'total_draw_count' => 0,
+            'paid_draw_count' => 0,
+            'free_draw_count' => 0,
+        ];
+
+        return $this->model->create($record);
+    }
 }
--- a/server/app/dice/model/play_record/DicePlayRecord.php
+++ b/server/app/dice/model/play_record/DicePlayRecord.php
@@ -23,9 +23,14 @@ use think\model\relation\BelongsTo;
 * @property  $lottery_type 抽奖类型
 * @property  $is_win 中奖
 * @property  $win_coin 赢取平台币
+ * @property  $direction 方向:0=顺时针,1=逆时针
 * @property  $reward_config_id 奖励配置id
 * @property  $lottery_id 奖池
+ * @property  $start_index 起始索引
+ * @property  $target_index 结束索引
+ * @property  $roll_array 摇取点数，格式:[1,2,3,4,5]（5个点数）
 * @property  $lottery_name 奖池名
+ * @property  $status 状态:0=超时/失败 1=成功
 * @property  $create_time 创建时间
 * @property  $update_time 修改时间
 */
@@ -157,4 +162,12 @@ class DicePlayRecord extends BaseModel
            $query->whereRaw('1=0');
        }
    }
+
+    /** 方向 0=顺时针 1=逆时针 */
+    public function searchDirectionAttr($query, $value)
+    {
+        if ($value !== '' && $value !== null) {
+            $query->where('direction', '=', $value);
+        }
+    }
 }
--- a/server/app/dice/model/player/DicePlayer.php
+++ b/server/app/dice/model/player/DicePlayer.php
@@ -7,6 +7,7 @@
 namespace app\dice\model\player;

 use plugin\saiadmin\basic\think\BaseModel;
+use app\dice\model\lottery_config\DiceLotteryConfig;

 /**
 * 大富翁-玩家模型
@@ -15,6 +16,8 @@ use plugin\saiadmin\basic\think\BaseModel;
 *
 * @property  $id ID
 * @property  $username 用户名
+ * @property  $phone 手机
+ * @property  $uid uid
 * @property  $name 昵称
 * @property  $password 密码
 * @property  $status 状态
@@ -46,6 +49,68 @@ class DicePlayer extends BaseModel
     */
    protected $table = 'dice_player';

+    /**
+     * 新增前：生成唯一 uid，昵称 name 默认使用 uid
+     * 用 try-catch 避免表尚未含 uid 时 getAttr/getData 抛 InvalidArgumentException
+     */
+    public static function onBeforeInsert($model): void
+    {
+        parent::onBeforeInsert($model);
+        try {
+            $uid = $model->getAttr('uid');
+        } catch (\Throwable $e) {
+            $uid = null;
+        }
+        if ($uid === null || $uid === '') {
+            $uid = self::generateUid();
+            $model->setAttr('uid', $uid);
+        }
+        try {
+            $name = $model->getAttr('name');
+        } catch (\Throwable $e) {
+            $name = null;
+        }
+        if ($name === null || $name === '') {
+            $model->setAttr('name', $uid);
+        }
+        // 彩金池权重默认取 type=0 的奖池配置
+        self::setDefaultWeightsFromLotteryConfig($model);
+    }
+
+    /**
+     * 从 DiceLotteryConfig type=0 取 t1_wight～t5_wight 作为玩家未设置时的默认值
+     */
+    protected static function setDefaultWeightsFromLotteryConfig(DicePlayer $model): void
+    {
+        $config = DiceLotteryConfig::where('type', 0)->find();
+        if (!$config) {
+            return;
+        }
+        $fields = ['t1_wight', 't2_wight', 't3_wight', 't4_wight', 't5_wight'];
+        foreach ($fields as $field) {
+            try {
+                $val = $model->getAttr($field);
+            } catch (\Throwable $e) {
+                $val = null;
+            }
+            if ($val === null || $val === '') {
+                try {
+                    $model->setAttr($field, $config->getAttr($field));
+                } catch (\Throwable $e) {
+                    // 忽略字段不存在
+                }
+            }
+        }
+    }
+
+    /**
+     * 生成唯一标识 uid（12 位十六进制）
+     */
+    public static function generateUid(): string
+    {
+        return strtoupper(substr(bin2hex(random_bytes(6)), 0, 12));
+    }
+
    /**
     * 用户名 搜索
     */
@@ -62,6 +127,16 @@ class DicePlayer extends BaseModel
        $query->where('name', 'like', '%'.$value.'%');
    }

+    /**
+     * 手机号 模糊搜索
+     */
+    public function searchPhoneAttr($query, $value)
+    {
+        if ($value !== '' && $value !== null) {
+            $query->where('phone', 'like', '%' . $value . '%');
+        }
+    }
+
    /**
     * 状态 搜索
     */
--- a/server/app/dice/model/player_ticket_record/DicePlayerTicketRecord.php
+++ b/server/app/dice/model/player_ticket_record/DicePlayerTicketRecord.php
@@ -4,16 +4,16 @@
 // +----------------------------------------------------------------------
 // | Author: your name
 // +----------------------------------------------------------------------
-namespace app\dice\model\player_coin_record;
+namespace app\dice\model\player_ticket_record;

 use app\dice\model\player\DicePlayer;
 use plugin\saiadmin\basic\think\BaseModel;
 use think\model\relation\BelongsTo;

 /**
- * 玩家购买抽奖记录模型
+ * 抽奖券获取记录模型
 *
- * dice_player_coin_record 玩家购买抽奖记录
+ * dice_player_ticket_record 抽奖券获取记录
 *
 * @property  $id ID
 * @property  $player_id 玩家id
@@ -25,7 +25,7 @@ use think\model\relation\BelongsTo;
 * @property  $create_time 创建时间
 * @property  $update_time 修改时间
 */
-class DicePlayerCoinRecord extends BaseModel
+class DicePlayerTicketRecord extends BaseModel
 {
    /**
     * 数据表主键
@@ -37,7 +37,7 @@ class DicePlayerCoinRecord extends BaseModel
     * 数据库表名称
     * @var string
     */
-    protected $table = 'dice_player_coin_record';
+    protected $table = 'dice_player_ticket_record';

    /**
     * 关联模型 dicePlayer
--- a/server/app/dice/model/player_wallet_record/DicePlayerWalletRecord.php
+++ b/server/app/dice/model/player_wallet_record/DicePlayerWalletRecord.php
@@ -8,6 +8,8 @@ namespace app\dice\model\player_wallet_record;

 use app\dice\model\player\DicePlayer;
 use plugin\saiadmin\basic\think\BaseModel;
+use plugin\saiadmin\app\model\system\SystemUser;
+use think\model\relation\BelongsTo;

 /**
 * 玩家钱包流水模型
@@ -24,6 +26,7 @@ use plugin\saiadmin\basic\think\BaseModel;
 * @property  $paid_draw_count 购买抽奖次数
 * @property  $free_draw_count 赠送抽奖次数
 * @property  $remark 备注
+ * @property  $user_id 操作管理员id（type 3/4 时记录）
 * @property  $create_time 创建时间
 * @property  $update_time 修改时间
 */
@@ -44,11 +47,19 @@ class DicePlayerWalletRecord extends BaseModel
    /**
     * 关联模型 dicePlayer
     */
-    public function dicePlayer(): \think\model\relation\BelongsTo
+    public function dicePlayer(): BelongsTo
    {
        return $this->belongsTo(DicePlayer::class, 'player_id', 'id');
    }

+    /**
+     * 关联操作管理员（type 3/4 时有值）
+     */
+    public function operator(): BelongsTo
+    {
+        return $this->belongsTo(SystemUser::class, 'user_id', 'id');
+    }
+
    /**
     * 类型 搜索
     */
@@ -94,4 +105,24 @@ class DicePlayerWalletRecord extends BaseModel
            $query->where('coin', '<=', $value);
        }
    }
+
+    /**
+     * 创建时间起始 搜索
+     */
+    public function searchCreateTimeMinAttr($query, $value)
+    {
+        if ($value !== '' && $value !== null) {
+            $query->where('create_time', '>=', $value);
+        }
+    }
+
+    /**
+     * 创建时间结束 搜索
+     */
+    public function searchCreateTimeMaxAttr($query, $value)
+    {
+        if ($value !== '' && $value !== null) {
+            $query->where('create_time', '<=', $value);
+        }
+    }
 }
--- a/server/app/dice/validate/play_record/DicePlayRecordValidate.php
+++ b/server/app/dice/validate/play_record/DicePlayRecordValidate.php
@@ -23,6 +23,7 @@ class DicePlayRecordValidate extends BaseValidate
        'is_win' => 'require',
        'win_coin' => 'require',
        'reward_config_id' => 'require',
+        'roll_array' => 'require|checkRollArray',
    ];

    /**
@@ -35,6 +36,7 @@ class DicePlayRecordValidate extends BaseValidate
        'is_win' => '中奖必须填写',
        'win_coin' => '赢取平台币必须填写',
        'reward_config_id' => '奖励配置必须填写',
+        'roll_array.require' => '摇取点数必须填写',
    ];

    /**
@@ -48,6 +50,7 @@ class DicePlayRecordValidate extends BaseValidate
            'is_win',
            'win_coin',
            'reward_config_id',
+            'roll_array',
        ],
        'update' => [
            'player_id',
@@ -56,7 +59,36 @@ class DicePlayRecordValidate extends BaseValidate
            'is_win',
            'win_coin',
            'reward_config_id',
+            'roll_array',
        ],
    ];

+    /**
+     * 验证 roll_array：必须为 5 个元素，每个值在 1～6 之间
+     * @param mixed $value
+     * @param mixed $rule
+     * @param array $data
+     * @param string $field
+     * @return bool|string
+     */
+    protected function checkRollArray($value, $rule = '', array $data = [], string $field = '')
+    {
+        if (is_string($value)) {
+            $decoded = json_decode($value, true);
+            $value = is_array($decoded) ? $decoded : [];
+        }
+        if (!is_array($value)) {
+            return '摇取点数必须为数组';
+        }
+        if (count($value) !== 5) {
+            return '摇取点数必须为 5 个数';
+        }
+        foreach ($value as $i => $n) {
+            $v = is_numeric($n) ? (int) $n : null;
+            if ($v === null || $v < 1 || $v > 6) {
+                return '摇取点数第' . ($i + 1) . '个值必须在 1～6 之间';
+            }
+        }
+        return true;
+    }
 }
--- a/server/app/dice/validate/player/DicePlayerValidate.php
+++ b/server/app/dice/validate/player/DicePlayerValidate.php
@@ -19,6 +19,7 @@ class DicePlayerValidate extends BaseValidate
    protected $rule =   [
        'username' => 'require',
        'name' => 'require',
+        'phone' => 'require',
        'password' => 'require',
        'status' => 'require',
        'coin' => 'require',
@@ -30,6 +31,7 @@ class DicePlayerValidate extends BaseValidate
    protected $message  =   [
        'username' => '用户名必须填写',
        'name' => '昵称必须填写',
+        'phone' => '手机号必须填写',
        'password' => '密码必须填写',
        'status' => '状态必须填写',
        'coin' => '平台币必须填写',
@@ -42,6 +44,7 @@ class DicePlayerValidate extends BaseValidate
        'save' => [
            'username',
            'name',
+            'phone',
            'password',
            'status',
            'coin',
@@ -49,6 +52,7 @@ class DicePlayerValidate extends BaseValidate
        'update' => [
            'username',
            'name',
+            'phone',
            'status',
            'coin',
        ],
--- a/server/app/dice/validate/player_ticket_record/DicePlayerTicketRecordValidate.php
+++ b/server/app/dice/validate/player_ticket_record/DicePlayerTicketRecordValidate.php
@@ -4,14 +4,14 @@
 // +----------------------------------------------------------------------
 // | Author: your name
 // +----------------------------------------------------------------------
-namespace app\dice\validate\player_coin_record;
+namespace app\dice\validate\player_ticket_record;

 use plugin\saiadmin\basic\BaseValidate;

 /**
- * 玩家购买抽奖记录验证器
+ * 抽奖券获取记录验证器
 */
-class DicePlayerCoinRecordValidate extends BaseValidate
+class DicePlayerTicketRecordValidate extends BaseValidate
 {
    /**
     * 定义验证规则
--- a/server/config/api.php
+++ b/server/config/api.php
@@ -0,0 +1,16 @@
+<?php
+/**
+ * API 鉴权与用户相关配置
+ */
+return [
+    // auth-token 有效期（秒），默认 24 小时
+    'auth_token_exp' => (int) env('API_AUTH_TOKEN_EXP', 86400),
+    // user-token 有效期（秒），默认 7 天
+    'user_token_exp' => (int) env('API_USER_TOKEN_EXP', 604800),
+    // 用户信息 Redis 缓存过期时间（秒），默认 7 天
+    'user_cache_expire' => (int) env('API_USER_CACHE_EXPIRE', 604800),
+    // 用户缓存 Redis key 前缀
+    'user_cache_prefix' => env('API_USER_CACHE_PREFIX', 'api:user:'),
+    // 用户信息加密密钥（用于 Redis 中 value 的加密），建议 32 位
+    'user_encrypt_key' => env('API_USER_ENCRYPT_KEY', 'dafuweng_api_user_cache_key_32'),
+];
--- a/server/config/route.php
+++ b/server/config/route.php
@@ -13,9 +13,22 @@
 */

 use Webman\Route;
-
-
-
+use app\api\middleware\CheckApiAuthMiddleware;
+
+// API 路由：需先调用 /api/authToken 获取 auth-token，请求时携带 header: auth-token 或 Authorization: Bearer <token>
+Route::group('/api', function () {
+    Route::any('/authToken', [app\api\controller\AuthTokenController::class, 'index']);
+    Route::post('/user/login', [app\api\controller\UserController::class, 'login']);
+    Route::post('/user/register', [app\api\controller\UserController::class, 'register']);
+    Route::post('/user/logout', [app\api\controller\UserController::class, 'logout']);
+    Route::get('/user/info', [app\api\controller\UserController::class, 'info']);
+    Route::get('/user/balance', [app\api\controller\UserController::class, 'balance']);
+    Route::get('/user/walletRecord', [app\api\controller\UserController::class, 'walletRecord']);
+    Route::get('/user/playGameRecord', [app\api\controller\UserController::class, 'playGameRecord']);
+    Route::post('/game/buyLotteryTickets', [app\api\controller\GameController::class, 'buyLotteryTickets']);
+    Route::get('/game/lotteryPool', [app\api\controller\GameController::class, 'lotteryPool']);
+    Route::post('/game/playStart', [app\api\controller\GameController::class, 'playStart']);
+})->middleware([CheckApiAuthMiddleware::class]);



--- a/server/config/think-cache.php
+++ b/server/config/think-cache.php
@@ -1,7 +1,7 @@
 <?php
 return [
-    // 默认缓存驱动
-    'default' => env('CACHE_MODE', 'file'),
+    // 默认缓存驱动（API 用户缓存依赖 Redis，建议设为 redis 并配置 REDIS_*）
+    'default' => env('CACHE_MODE', 'redis'),
    // 缓存连接方式配置
    'stores'  => [
        // redis缓存
--- a/server/plugin/saiadmin/basic/BaseController.php
+++ b/server/plugin/saiadmin/basic/BaseController.php
@@ -21,14 +21,14 @@ class BaseController extends OpenController
    protected $adminInfo;

    /**
-     * 当前登陆管理员ID
+     * 当前登陆管理员ID（未登录时为 null）
     */
-    protected int $adminId;
+    protected ?int $adminId = null;

    /**
-     * 当前登陆管理员账号
+     * 当前登陆管理员账号（未登录时为空字符串）
     */
-    protected string $adminName;
+    protected string $adminName = '';

    /**
     * 逻辑层注入
--- a/server/plugin/saiadmin/basic/OpenController.php
+++ b/server/plugin/saiadmin/basic/OpenController.php
@@ -42,11 +42,12 @@ class OpenController
    /**
     * 失败返回json内容
     * @param string $msg
+     * @param int $code 201=请携带token 202=缺少参数 203=token过期，默认400
     * @return Response
     */
-    public function fail(string $msg = 'fail'): Response
+    public function fail(string $msg = 'fail', int $code = 400): Response
    {
-        return json(['code' => 400, 'message' => $msg]);
+        return json(['code' => $code, 'message' => $msg]);
    }

    /**
Author	SHA1	Message	Date
zhenhui	85babe3fd4	[接口]新增玩家-钱包记录，玩家-抽奖记录	2026-03-04 20:01:25 +08:00
zhenhui	2dcc9f479a	[接口]优化新增购买抽奖券时记录DicePlayerTicketRecord	2026-03-04 17:36:52 +08:00
zhenhui	bff8ea04e6	[色子游戏]玩家获取抽奖券记录-重构DicePlayerCoinRecord为DicePlayerTicketRecord	2026-03-04 17:25:05 +08:00
zhenhui	0a3af2d422	[接口]新增抽奖接口/api/game/playStart	2026-03-04 17:06:30 +08:00
zhenhui	21c638a231	[色子游戏]奖池配置-优化样式	2026-03-04 17:06:24 +08:00
zhenhui	a6858adf14	统一规范状态码	2026-03-04 16:07:07 +08:00
zhenhui	5d0e2a82ff	[接口]新增获取彩金池，购买游戏次数（购买抽奖券）接口	2026-03-04 15:35:30 +08:00
zhenhui	dead78a5f3	[色子游戏]玩家钱包流水记录-优化样式	2026-03-04 15:24:22 +08:00
zhenhui	0492e08cc7	[色子游戏]玩家-新增玩家钱包操作	2026-03-04 15:04:11 +08:00
zhenhui	00d964ad80	[色子游戏]玩家钱包流水记录-优化样式	2026-03-04 14:34:51 +08:00
zhenhui	33e3603932	[色子游戏]玩家抽奖记录-优化抽奖roll_array记录五个色子	2026-03-04 13:43:56 +08:00
zhenhui	6d2b74a899	[接口]新增获取用户信息接口user/info, 获取钱包余额接口	2026-03-04 11:49:53 +08:00
zhenhui	77a898df22	[接口]鉴权authToken用户登录login-注册register-退出logout, 并将用户信息保存到redis中	2026-03-04 11:39:11 +08:00
zhenhui	ad56d6d4ce	[色子游戏]玩家-新增phone字段	2026-03-04 10:55:31 +08:00
zhenhui	01f5d6c832	[色子游戏]玩家-新增phone字段	2026-03-04 10:55:23 +08:00
zhenhui	894a562eb4	[色子游戏]玩家抽奖记录-新增字段保存中奖详情记录信息	2026-03-04 10:21:05 +08:00