SNAPSCOPE 视功能检查与视觉训练一体化项目产品系统

1. 立项原因与产品问题
传统视功能检查和视觉训练通常依赖多台设备、人工设置参数和纸质记录。不同检查项目之间缺少统一流程，训练方案的执行质量依赖操作人员经验，训练过程也不容易量化和追踪。

本项目立项旨在解决以下产品问题：
检查设备与训练设备相互独立，操作流程割裂。
用户资料、检查结果和训练处方分散，难以形成连续档案。
操作人员需要反复手工配置训练参数，效率和一致性不足。
传统训练形式较单一，用户尤其是儿童和青少年不易长期配合。
机构难以远程管理设备激活、功能授权和软件版本。
检查与训练过程缺少标准化数据，难以支持复盘和方案调整。
专业硬件控制复杂，普通 Android 应用难以直接完成可靠接入。

因此，项目将专用硬件、数字处方、视功能检查、视觉训练和后台管理整合为一体化产品，降低设备操作复杂度，提高业务流程的标准化和数字化水平。

2. 行业场景
视光中心与眼健康机构
用于执行视功能检查、双眼视觉评估及处方训练。专业人员在后台维护用户和方案，用户通过扫码在设备上完成检查或训练。
眼科及视光门诊辅助场景
作为专业人员的辅助检查和训练终端，对部分视功能项目进行标准化执行和结果记录。系统提供过程数据，但不替代医生诊断和临床决策。
儿童青少年视觉训练机构
通过动画、故事、迷宫、捕鱼、串珠和红绿互动等形式改善传统训练枯燥的问题，帮助机构按照处方组织阶段性训练并记录完成情况。
校园视力健康服务
可用于学校或区域视力健康服务中的视功能辅助筛查、复查和转介支持。检查数据可作为专业人员进一步评估的参考，而不直接形成医疗诊断。
连锁机构与设备运营
通过设备身份、激活状态、模块授权、版本检测和数据接口，对不同门店的专用设备进行统一管理，支持训练版、检查版及一体化版本等产品组合。

1. 具体功能模块
- 设备管理与系统入口
获取设备 MAC、EMMC 等身份信息，完成设备入库、激活状态和产品类型校验；根据后台授权开放视觉训练、视功能检查模块；支持二维码激活、版本检测、应用升级以及日期、亮度、音量、蓝牙、Wi-Fi 等设置，并提供设备老化测试、硬件测试和异常提示。
- 用户与处方管理
通过二维码识别训练或检查用户，获取用户资料、训练处方和检查方案；校验二维码业务类型，保存登录状态和训练记录，并根据处方动态生成检查或训练流程。
- 视功能检查
支持视力、眼位、调节反应、调节灵活度、正负相对调节、融像、Worth 4 Dot、近水平聚散度、AC/A、立体视及 Titmus 等检查。检查过程包含语音引导、倒计时、限时作答、暂停恢复、跳过和异常退出，完成后生成结构化结果并提交后台。
- 视觉训练与记录
支持调节幅度、调节灵活度、镜片阅读、静动态融像、眼肌运动、引导与自主追随、迷宫、捕鱼、串珠、脱抑制、扫视、反差阅读、红闪及光栅等训练。系统可根据处方配置眼别、时长、视标、速度和难度，并结合动画、音频、摇杆和电子镜片进行交互；同时展示训练进度，记录正确率、错误次数和完成时长，将结果保存至本地并上传业务系统。
2. 主要功能描述
项目将设备、用户、处方、检查、训练和数据管理形成完整闭环。用户扫码后，系统自动获取处方并转换为可执行流程；执行过程中协同控制画面、电子镜片和外部设备；结束后生成标准化记录并上传。系统既是专用硬件控制终端，也是机构业务执行终端，可减少人工配置、纸质记录和设备切换，提高业务流程的一致性、可追踪性与管理效率。

我一人独立完成整个项目的开发，主要任务如下：
1. 应用基础建设。搭建 Android 多模块工程。建立应用层、核心业务层和公共 UI 资源层。实现横屏、全屏和沉浸式专用设备界面。适配不同屏幕尺寸、分辨率和物理显示尺寸。
2. 设备初始化与权限控制。在应用启动阶段初始化底层硬件桥接、串口、推送和屏幕参数。获取设备身份，并完成入库、激活和模块授权校验。根据设备状态切换未入库、未激活、网络异常和正常使用界面。处理专用设备所需的 USB、蓝牙、串口和系统级权限。
3. 用户及处方业务。实现二维码生成、扫码事件接收和用户信息解析。对训练、检查二维码进行业务类型校验。调用后台接口获取训练处方和检查方案。将处方数据解析为具体项目、参数和执行顺序。
4. 检查流程开发。开发不同检查项目的 Activity、参数模型和服务实现。建立语音引导、准备阶段、正式作答、计时和结果提交机制。实现项目间跳转、检查中断、暂停恢复和汇总流程。处理电子镜片状态切换、棱镜控制和检查结果计算。
5. 训练流程开发。将处方参数映射为训练模块和训练难度。实现训练地图、项目调度、训练计时和进度管理。开发视标、动画、红绿分视、光栅、阅读、迷宫等训练界面。采集训练过程中的正确率、错误次数、反应和完成时长。处理训练结束、异常退出和设备状态复位。
6. 数据与后台接入。对接设备、用户、处方、版本、训练记录和检查记录接口。使用本地数据库保存用户和训练记录。保存设备激活状态、模块权限和运行配置。接入推送、崩溃监控、统计分析。
7. 系统设置与运维。开发应用内 Wi-Fi、蓝牙、亮度和音量设置。实现版本检测、APK 更新及开机启动相关逻辑。提供设备测试、老化测试和错误提示页面。

技术栈：
Android 原生开发。Java 与 Kotlin 混合开发。Gradle 多模块。JNI 串口库、USB Host、蓝牙和摇杆控制。