游戏数据管理与玩家服务 Web 平台产品系统Vibe Coding

针对音乐游戏玩家数据分散、成绩查询不便、收藏品和虚拟道具缺少统一管理入口等问题，独立开发了一套玩家数据综合管理平台。系统连接账户库与游戏业务库，将玩家资料、游玩成绩、乐曲数据、排行榜、好友、商店、兑换码及成绩图等能力集中到统一的Web端，降低玩家查询和维护游戏数据的操作成本，并为局域网内其他服务提供标准化数据接口。

项目主要包括以下功能模块：
账户与身份认证：支持用户注册、登录、退出、Session会话管理、游戏卡号绑定与验证，并对未登录或未绑定游戏卡的用户进行路由拦截。
玩家资料管理：展示玩家名称、rating、游玩次数、首次及最近游玩时间、账号、封禁状态、会员卡和跑图票等信息，并支持修改玩家名称。
游玩记录管理：查询玩家历史游玩记录，对重复成绩进行处理，支持分页展示、成绩详情、达成率、评级及Combo状态等数据查看。
乐曲与排行榜：提供乐曲列表、名称或ID搜索、乐谱筛选、分页、不同难度详情及单曲排行榜查询。
成绩导入：根据官服二维码数据调用成绩服务，将成绩增量导入数据库；对已有记录按达成率、DX分数、Combo和同步状态进行择优更新，并过滤异常成绩。
成绩图生成：根据玩家成绩计算Rating，分别生成Best50图片，完成封面、难度、成绩、评级和玩家信息的图像合成，并提供缓存、刷新、归档和图片下载功能。
收藏品管理：管理头像、姓名框、称号、搭档和背景框等收藏品，解析XML资源获取名称，并支持查询已拥有物品及切换当前装备。
好友管理：支持通过用户ID或访问码添加好友、查看好友列表、删除好友，并可配置好友申请及成绩展示状态。
虚拟商店：展示道具、乐曲、收藏品和会员卡，校验用户积分及持有上限，完成积分扣减、道具发放、会员卡续期和失败补偿。
兑换码系统：支持兑换码有效期、总使用次数、单用户使用次数校验，可兑换普通道具或会员卡，并记录兑换结果和操作日志。
开放接口：提供B50图片和兑换码接口，通过局域网IP白名单及可选Token进行访问控制。
响应式页面：针对桌面端和移动端设计自适应导航栏、列表、表单、弹窗及图片展示页面。

该项目由我独立完成需求分析、数据库对接、前后端开发、业务逻辑实现、接口联调、静态资源整理及运行维护。后端使用Python和Flask开发，通过应用工厂模式创建应用，并利用Blueprint将账户、玩家资料、好友、收藏品、商店、兑换、乐曲、B50和API等业务拆分为独立模块；前端使用HTML、CSS、JavaScript、Jinja2和Bootstrap实现服务端渲染与Fetch异步交互，同时完成移动端响应式适配。

数据层同时连接账户数据库和游戏数据库，通过MySQL Connector与PyMySQL封装查询及更新操作，并使用JSON管理商品和兑换码配置、使用XML维护乐曲版本和收藏品资源映射。项目还对接了独立账户服务与成绩数据服务，实现账号认证、游戏卡绑定和成绩导入。

实现亮点包括：根据乐曲定数和达成率自主实现Rating计算及B50筛选，使用Pillow完成多层图片合成并加入缓存和历史归档；成绩导入采用增量更新机制，针对达成率、DX分数、Combo和同步状态分别择优合并，避免较差数据覆盖历史最佳成绩；商店购买过程中实现余额校验、持有上限判断、失败退还积分及操作日志；兑换码核心逻辑同时复用于网页端和API端，并支持有效期、总次数和单用户次数限制；对外接口增加局域网地址校验和可选Token验证，提高内部服务调用的安全性。

项目的主要难点是账户库与游戏业务库之间的数据关联和一致性维护、复杂成绩规则的归一化处理、Best50图像生成时大量静态资源的匹配与排版，以及商店和兑换业务中积分、道具、会员卡等多类数据的可靠更新。我通过模块化封装、数据库事务与失败补偿、资源回退、缓存机制和文件日志解决了这些问题。