fix(tongji): 修复小游戏平台同步与并发问题

2026-07-17 21:21:43 +08:00
parent 7192c4db8c
commit fd7e6071a8
8 changed files with 262 additions and 50 deletions
@@ -4,11 +4,12 @@

 - 复用主小程序 `token` 与微信小程序登录，不创建第二套游戏账号。
 - 按周一日期、性别自动分配最多 7 人的同行组。
+- 首次入组使用数据库分配锁，多个用户同时进入也不会重复分组或超过 7 人。
 - 以真实平台昵称、头像、认糖数和本周最高分排序。
 - 每局用 `session_key` 上报绝对进度，断网重试不会重复加分。
 - 待同步成绩最多本地保留 8 局，重新联网后自动补传。
 - 微信好友与朋友圈分享使用随机分享码，不在链接中暴露用户 ID。
- 受邀进入只记录一次轻量分享访问，不自动建立家庭或好友绑定。
+- 每张周分享卡对同一受邀人只记录一次轻量访问，不自动建立家庭或好友绑定。

 ## 接口

@@ -25,6 +26,9 @@
 2. 发布 `server/app/api/logic/tcm/GamePlatformLogic.php` 和 `TcmController.php`。
 3. 重新构建并上传小程序前端。

+如果数据库已经执行过本功能的旧版建表脚本，再执行一次
+`server/sql/1.9.20260717/upgrade_tcm_endless_game_platform_20260717.sql`，用于补充分组锁并把分享去重范围修正为“每张周分享卡”。
+
 如果后端或数据表尚未发布，游戏仍可离线游玩，榜单会显示“离线记录中”；联网且接口可用后自动补传。

 ## 上线前检查
@@ -7,6 +7,8 @@
 - `index.vue`：页面、棋盘算法、关卡主题、任务、道具、三/四/五连奖励和适老化交互。
 - `game-endless.scss`：完整页面与动画样式。
 - `components/TongjiIcon.vue`：本功能包使用的图标组件。
+- `composables/useGameAuth.js`：复用主小程序账号并处理 token 过期重登。
+- `composables/useGamePlatform.js`：周榜、成绩补传与微信分享的平台连接层。
 - `composables/useGameSfx.js`：滑动、掉落、消除、连击和大奖音效。
 - `utils/svgDataUrl.js`：图标编码工具。
 - `assets/food/`：本游戏使用的全部食品与驼乳粉图片。
@@ -37,7 +39,9 @@ build: {
    "navigationStyle": "custom",
    "navigationBarTitleText": "控糖消消乐",
    "backgroundColor": "#eefbf4",
-    "disableScroll": false
+    "disableScroll": false,
+    "enableShareAppMessage": true,
+    "enableShareTimeline": true
  }
 }
 ```
@@ -51,6 +55,6 @@ build: {
 - 当前项目原来的“糖分突袭”源码保存在 `tongji/legacy-game/game.vue`，没有注册为页面，不参与打包。
 - 连消小目标按“连消×2”累计 2 次；连续 6 次普通消除没有连消时，下一次掉落会提供连消机会。“连消×3”保留为额外积分、驼乳粉与撒花惊喜，不阻挡主线任务。
 - 横向 3 个与竖向 3 个相交形成 L/T 形五消时，会在交点生成带高对比 L 标记的范围爆破棋子；该棋子再次被消除时清除周围九格。
- 进入游戏时展示“本周 7 人同行榜”界面原型，包含前后名次、差距提示和可切换的同行/亲友鼓励；顶部“本周同行”可再次打开。当前榜单明确标注为预览数据，正式用户关系和周榜成绩需要后端接口接入。
+- 进入游戏时展示“本周 7 人同行榜”，包含真实平台昵称、前后名次、差距提示和可切换的同行/亲友鼓励；顶部“本周同行”可再次打开。后端部署方式见 `PLATFORM_INTEGRATION.md`。
 - 本功能包依赖 uni-app Vue 3 和 `@dcloudio/uni-app`，不依赖当前项目其他业务组件。
 - 食物风险等级和科普文案集中在 `index.vue` 的 `FOODS` 配置中，正式上线前仍需由医院医生审核。
@@ -0,0 +1,71 @@
+/**
+ * 控糖消消乐独立登录适配层。复用主小程序账号，但不依赖 tongji 其他页面代码。
+ */
+export function useGameAuth(proxy) {
+    let loginPromise = null
+
+    function hasToken() {
+        return !!String(uni.getStorageSync('token') || '').trim()
+    }
+
+    function clearToken() {
+        uni.removeStorageSync('token')
+    }
+
+    function wxLoginCode() {
+        return new Promise((resolve, reject) => {
+            uni.login({
+                provider: 'weixin',
+                success: (res) => res?.code ? resolve(res.code) : reject(new Error('微信登录未返回 code')),
+                fail: reject
+            })
+        })
+    }
+
+    async function loginWithCode(code) {
+        const res = await proxy.apiUrl({
+            url: '/api/login/mnpLogin',
+            method: 'POST',
+            data: { code }
+        }, false)
+        if (res?.code !== 1 || !res.data?.token) {
+            clearToken()
+            throw new Error(res?.msg || '登录失败')
+        }
+        uni.setStorageSync('token', res.data.token)
+        uni.setStorageSync('userData', res.data)
+        return true
+    }
+
+    async function verifyOrLogin() {
+        if (hasToken()) {
+            try {
+                const res = await proxy.apiUrl({ url: '/api/user/info', method: 'POST' }, false)
+                if (res?.code === 1 && res.data) {
+                    uni.setStorageSync('userData', res.data)
+                    return true
+                }
+                // 只有明确的登录失效才重新换取 token；其他业务错误先保留原登录。
+                if (res?.code !== -1) return true
+            } catch (_) {
+                // 断网不清除仍可能有效的 token，成绩由离线队列稍后补传。
+                return true
+            }
+            clearToken()
+        }
+        const code = await wxLoginCode()
+        return loginWithCode(code)
+    }
+
+    async function ensureLoggedIn() {
+        if (loginPromise) return loginPromise
+        loginPromise = verifyOrLogin()
+            .then(ok => !!ok)
+            .catch(() => false)
+            // 只合并同时发生的登录；成功结果不能永久缓存，否则 token 过期后无法恢复。
+            .finally(() => { loginPromise = null })
+        return loginPromise
+    }
+
+    return { ensureLoggedIn }
+}
@@ -182,7 +182,14 @@ export function useGamePlatform(proxy, ensureLoggedIn) {
                throw new Error(res?.msg || '成绩保存失败')
            }
            applyLeaderboard(res.data, payload.session_key)
-            queuedPayloads = queuedPayloads.filter(item => item.session_key !== payload.session_key)
+            // 请求发出后玩家可能又完成了消除。只移除已经被本次请求覆盖的进度，
+            // 不能按 session_key 整局删除，否则会丢失请求进行期间产生的新进度。
+            queuedPayloads = queuedPayloads.filter(item => (
+                item.session_key !== payload.session_key
+                || Number(item.learned_count) > Number(payload.learned_count)
+                || Number(item.score) > Number(payload.score)
+                || Number(item.ended) > Number(payload.ended)
+            ))
            persistPendingPayloads()
        } catch (_) {
            connected.value = false
@@ -302,7 +302,7 @@ import { onLoad, onShareAppMessage, onShareTimeline, onShow, onUnload } from '@d
 import TongjiIcon from './components/TongjiIcon.vue'
 import { useGameSfx } from './composables/useGameSfx.js'
 import { useGamePlatform } from './composables/useGamePlatform.js'
-import { useTongjiAuth } from '../composables/useTongjiAuth.js'
+import { useGameAuth } from './composables/useGameAuth.js'

 const FOOD_IMAGE_MODULES = import.meta.glob('./assets/food/*.jpg', {
    eager: true,
@@ -398,7 +398,7 @@ const {
 } = useGameSfx()

 const { proxy } = getCurrentInstance()
-const { ensureLoggedIn } = useTongjiAuth(proxy)
+const { ensureLoggedIn } = useGameAuth(proxy)
 const {
    connected: platformConnected,
    loading: platformLoading,
@@ -953,7 +953,11 @@ async function resolveMatches(initialGroups, movedIndex) {
        const camelMatchCount = Math.max(bentCamelCount, camelGroup?.indices.length || 0)
        if (camelMatchCount >= 3) applyCamelJackpot(camelMatchCount, remove)
        const removedTiles = [...remove].map(i => board.value[i]).filter(Boolean)
-        const removedNormal = removedTiles.filter(tile => !foodOf(tile.key).high)
+        // 排名统计的是正确认识并消除的普通食物；驼乳是道具，不计入认糖数。
+        const removedNormal = removedTiles.filter(tile => {
+            const food = foodOf(tile.key)
+            return !food.high && !food.product
+        })
        const fireRemovedHigh = fireClearingIndices.value.some(index => foodOf(board.value[index]?.key).high)
        const largestMatch = Math.max(
            ...groups.map(group => group.indices.length),