舞萌查分系统-maimaiCheck
2026-03-28 18:36:35
行业：游戏/电竞
载体：安卓APP
技术：Kotlin、Gradle、Microsoft Cognitive Toolkit (CNTK)
业务和功能介绍
1. 立项背景和目标
背景：舞萌DX官方无成绩查询系统，现有网页查分器操作繁琐、体验不佳。
目标：开发原生Android查分器，让玩家快速查询成绩，清晰展示Rating和Best 50数据。
2. 核心功能模块
模块 功能
玩家查询 输入玩家名，调用水鱼API获取数据
状态管理 管理空闲/加载/成功/错误四种UI状态
信息展示 展示玩家Rating、额外Rating
成绩列表 展示DX/SD谱面Best 50，含评级、达成率、定数等
错误处理 网络异常、玩家不存在等友好提示
3. 业务流程
text
启动 → 输入玩家名 → 点击查询
↓
加载中...
↓
├─ 成功 → 显示玩家信息 + 成绩列表
└─ 失败 → 显示错误提示 → 重新查询
项目实现
1. 整体架构和设计思路
采用 MVVM架构，分为三层：
View层：Jetpack Compose + Material 3，负责UI渲染和用户交互
ViewModel层：AndroidX ViewModel + 协程，负责状态管理和业务逻辑
网络层：Retrofit + Gson，负责API调用和JSON解析
使用密封类定义空闲、加载中、成功、错误四种UI状态，实现单向数据流。成绩列表使用LazyColumn懒加载优化性能。
2.我的负责模块和结果
本人独立完成全部开发工作：
数据模型：定义PlayerData、Charts、ScoreRecord三个数据类，覆盖14个字段
网络请求：配置Retrofit客户端，实现API接口，设置30秒超时
状态管理：实现UiState密封类和ViewModel，管理四种状态切换
UI构建：开发搜索框、玩家卡片、成绩列表、加载动画、错误提示等6个界面组件
错误处理：封装HTTP异常、网络断开、超时等5种错误类型的统一处理
单元测试：编写4个测试用例，全部通过
项目成果：完成功能完整的Android查分器，代码约400行，运行稳定。
3.我遇到的难点和解决方案
协程测试失败：在编写单元测试时，网络请求是异步执行的，断言执行时协程还未完成，导致测试总是失败。解决方案是使用协程测试库中的 runTest 配合 advanceUntilIdle 方法，等待所有协程执行完毕后再进行断言，确保测试结果正确。
@Composable注解编译错误：定义颜色函数时内部使用了 MaterialTheme，但函数本身未标记 @Composable 注解，导致编译报错。考虑到这些函数只需要返回固定颜色值，不需要依赖Compose上下文，因此将函数改为普通函数，直接返回十六进制颜色值，问题解决。
HTTP 400错误排查：查询玩家名时始终返回400错误，最初以为是代码问题，排查了请求头、请求体格式等多个方面。后来发现是因为该玩家名未在水鱼查分器官网绑定账号，API返回的400实际上是“玩家不存在”的含义。解决方案是在错误处理中增加对400状态码的特殊处理，给出“未找到玩家，请确认玩家名是否正确或是否已绑定”的友好提示。
包名不一致导致编译失败：测试文件和主代码文件的包名不一致，导致编译时找不到相关类。解决方案是统一所有文件的包名为 com.example.mamaicheck，确保代码能够正确引用。
成绩列表滚动卡顿：最初使用Column垂直排列所有成绩条目，当成绩数量较多时界面滚动出现明显卡顿。改用LazyColumn懒加载列表后，只渲染可见区域的条目，滚动流畅度大幅提升。
采用 MVVM架构，分为三层：
View层：Jetpack Compose + Material 3，负责UI渲染和用户交互
ViewModel层：AndroidX ViewModel + 协程，负责状态管理和业务逻辑
网络层：Retrofit + Gson，负责API调用和JSON解析
使用密封类定义空闲、加载中、成功、错误四种UI状态，实现单向数据流。成绩列表使用LazyColumn懒加载优化性能。
2.我的负责模块和结果
本人独立完成全部开发工作：
数据模型：定义PlayerData、Charts、ScoreRecord三个数据类，覆盖14个字段
网络请求：配置Retrofit客户端，实现API接口，设置30秒超时
状态管理：实现UiState密封类和ViewModel，管理四种状态切换
UI构建：开发搜索框、玩家卡片、成绩列表、加载动画、错误提示等6个界面组件
错误处理：封装HTTP异常、网络断开、超时等5种错误类型的统一处理
单元测试：编写4个测试用例，全部通过
项目成果：完成功能完整的Android查分器，代码约400行，运行稳定。
3.我遇到的难点和解决方案
协程测试失败：在编写单元测试时，网络请求是异步执行的，断言执行时协程还未完成，导致测试总是失败。解决方案是使用协程测试库中的 runTest 配合 advanceUntilIdle 方法，等待所有协程执行完毕后再进行断言，确保测试结果正确。
@Composable注解编译错误：定义颜色函数时内部使用了 MaterialTheme，但函数本身未标记 @Composable 注解，导致编译报错。考虑到这些函数只需要返回固定颜色值，不需要依赖Compose上下文，因此将函数改为普通函数，直接返回十六进制颜色值，问题解决。
HTTP 400错误排查：查询玩家名时始终返回400错误，最初以为是代码问题，排查了请求头、请求体格式等多个方面。后来发现是因为该玩家名未在水鱼查分器官网绑定账号，API返回的400实际上是“玩家不存在”的含义。解决方案是在错误处理中增加对400状态码的特殊处理，给出“未找到玩家，请确认玩家名是否正确或是否已绑定”的友好提示。
包名不一致导致编译失败：测试文件和主代码文件的包名不一致，导致编译时找不到相关类。解决方案是统一所有文件的包名为 com.example.mamaicheck，确保代码能够正确引用。
成绩列表滚动卡顿：最初使用Column垂直排列所有成绩条目，当成绩数量较多时界面滚动出现明显卡顿。改用LazyColumn懒加载列表后，只渲染可见区域的条目，滚动流畅度大幅提升。
示例图片视频
相似推荐
某信托公司标的中心系统
本项目通过构建全新的标的中心平台，采用分布式实时数据计算架构，打造公司级标准化数据模型体系，实现多源异构标的信息的
智能化聚合与清洗，建立统一的标的数据服务门户，有效解决了各业务条线在标的数据应用中存在的准确性不足、统计口径差异、
编码规则不统一等核心痛点问题。
桃园天下金融股票数据分析网站
搭建在Web端上的，可以供广大股民用来进行公司股票数据分析和股票买卖策略生成的全能性网站。目前该网站在我们内部已经开发的非常成熟，完善，以下是它的主要功能介绍:
1.首先是最基本的用户登陆注册功能，注册成功进入首页之前由于我们这个软件是一个付费软件，所以会先进入一个套餐选择界面，首次注册使用网站会为您提供一个5天免费使用权限。
2.网站首页分为侧边栏，中间页面展示部分。侧边栏包含个股，新闻等一些工具，其中最主要的个股模块，该模块中会显示一个非常关键的图表，这个图表显示当前股市上自开盘以来的所有股票走势图表还有相关的指标展示。
3.还有一些工具栏例如：股票收益率分析，股票实时买卖操作，股票限时限买限卖操作，股票收益率回测这些工具栏，属于我们内部自己使用的工具，也是我自己负责的关键功能。
天津银行文书生成
业务介绍
本项目为天津银行文书生成系统，面向金融银行业务场景，旨在为天津银行内部提供高效、规范的自动化文书处理能力。依托金融行业合规要求与业务流程，通过技术手段实现银行各类文书（如合同、协议、告知函、审批文件等）的标准化生成与管理，提升业务办理效率，降低人工撰写与校对成本，保障文书内容的合规性与一致性。
功能介绍
多技术栈支撑的核心业务能力
基于 Java + MyBatis 构建稳定可靠的后端服务，实现业务逻辑、数据持久化与权限管控，保障金融数据的安全性与事务一致性。
结合 Python + Django 实现灵活的业务扩展与快速迭代，支持文书模板配置、内容生成、规则校验等核心功能的高效开发，适配银行复杂的业务场景与合规要求。
网站端可视化操作与管理
以网站为主要载体，为银行员工提供便捷的 Web 操作界面，支持文书模板的创建、编辑与版本管理，可根据业务场景动态调整文书内容与格式。
提供文书生成预览、在线审批、版本追溯等功能，实现从模板配置到最终文书输出的全流程可视化管理。
金融场景专属合规保障
贴合金融行业监管规范与银行内部风控要求，内置合规校验规则，自动检查文书内容的合法性、完整性与风险点，避免人为疏漏导致的合规问题。
支持按业务类型（如信贷、理财、对公业务等）分类管理文书模板，满足天津银行不同业务线的个性化需求。
信息披露平台
1. 本系统面向“信息披露/受托报告”业务的端到端流转：从计划清单与数据准备开始，经由数据同步/数据处理、受托/通知等文件的生成与审核、文件盖章、邮件发送（含凭证上传与发送记录追溯），最终进入接口报送。同时需要对执行过程进行可追溯（日志、历史查询）与可管控（任务待办/流程状态/统计维度）。整体目标是把跨环节的人工操作标准化、流程化与自动化，提升执行效率与质量，并为后续运营/监管/对账提供数据支撑。2. 从系统路由与页面能力可归纳为以下核心模块（以 src/router/routes/* 为入口）：工作流与任务中心：支持“我的事宜/待办/已办”，并以流程状态驱动页面操作（任务列表、查看/处理入口在 src/views/sirmapp/components/ManagerTaskList/ManagerTaskList.vue，路由在 src/router/routes/sirmapp.js）。受托报告模板工作流：文件生成、文件调整、初审/复审审核、盖章、邮件发送、批量发送、邮件详情/查看，以及报告接口报送等（路由示例：/reportTemplate/workflow/* 在 src/router/routes/workflow.js）。数据处理与数据同步：围绕“数据同步方案执行、重新执行、执行日志查看、提交工作流下一步”等；页面例子为 src/views/dataManage/dataArrange/workflow/dataSynchronization.vue（对应路由在 src/router/routes/workflow.js）。报告清单与通知单流程：清单/通知的调整、确认、审核、分中心处理、批量处理、邮件发送、盖章等（路由示例：/reportList/workflow/*、/notice/workflow/*）。统计与日志查询：管理人质量/时效统计与明细、省中心统计与明细、报告归档与明细；同时提供数据处理日志、报告/通知/个性化记录与历史回溯（路由在 src/router/routes/dataManage.js 与 src/router/routes/managerStatistic.js）。系统配置：发送邮箱配置、登录白名单、附件密码配置、数据同步配置、SQL配置、自动邮件匹配、时效频率配置、接口报送配置等（路由在 src/router/routes/system.js、src/router/routes/dataConfig.js、src/router/routes/interface.js）。3.典型业务链路可以概括为“概览-发现-同步-生成审核-盖章-发送-回溯”：首页概览：从清单总览进入业务范围，查看报告/通知/解析/数据处理/发送等聚合状态（示例页：src/views/dashboard/index.vue，路由由模块装配完成）。
跨市场（美股/港股）自动化交易与资产管理系统
本系统旨在解决个人及小微机构在港股与美股跨市场交易中，行情获取滞后、下单手动操作繁琐以及多币种资产统计不便的痛点。软件集成了行情监控、交易执行与资产管理三大核心模块：利用 Webull/Futu API 实现亚秒级实时行情同步，确保决策及时性 ；深度定制开发交易 UI，支持百分比快捷下单与动态资金滑动分配，极大优化了盘中博弈的执行效率 ；系统支持多账户持仓数据的自动化对账，实时计算盈亏分布并生成可视化报表，实现全自动的资产风险管理闭环。
帮助文档
Copyright @ 2021-2024 程聚宝 | 浙ICP备2021014372号
人工客服