TECHNICAL.md 3.7 KB
铂林青少年视力筛查系统技术文档
项目介绍
铂林青少年视力筛查系统(bolinscreening)是一款专注于青少年视力健康管理的小程序应用，旨在为学校、家长和医疗机构提供便捷的视力筛查和跟踪服务。该系统可以帮助用户记录和追踪学生的视力变化情况，并提供相关的数据分析和可视化图表展示。
目录结构
.
├── common # 公共资源目录
│ ├── apis # 接口封装
│ ├── style # 公共样式
│ └── utils # 工具函数
├── components # 组件目录
│ ├── qiun-data-charts # 图表组件
│ ├── qiun-error # 错误处理组件
│ ├── qiun-loading # 加载动画组件
│ ├── u-charts # uCharts图表库
│ ├── uni-popup # 弹出层组件
│ └── uni-transition # 动画过渡组件
├── pages # 页面目录
│ ├── addPatient # 添加学生页面
│ ├── chart # 健康分析图表页面
│ ├── index # 首页/筛查报告页面
│ ├── login # 登录页面
│ ├── my # 个人中心页面
│ ├── setting # 设置页面
│ └── webview # WebView页面
├── static # 静态资源目录
├── store # Vuex状态管理
├── App.vue # 应用入口文件
├── env.js # 环境配置文件
├── main.js # 主入口文件
├── manifest.json # 项目配置文件
├── pages.json # 页面路由配置文件
└── uni.scss # 全局样式变量
功能模块
- 筛查报告(index) - 展示学生的视力筛查结果
- 个人中心(my) - 用户个人信息及操作入口
- 添加学生(addPatient) - 录入新的学生信息
- 健康分析(chart) - 对视力数据进行统计分析并可视化展示
- 个人设置(setting) - 用户个性化设置
- 登录(login) - 用户身份验证入口
- WebView(webview) - 内嵌网页展示
技术栈
- 框架: UniApp + Vue2/Vue3（兼容）
- 语言: JavaScript/HTML/CSS
- UI框架: uni-ui + 自定义组件
- 状态管理: Vuex
- 图表库: uCharts + ECharts
- 网络请求: 自定义HTTP封装
- 构建工具: HBuilderX
- 目标平台: 微信小程序为主，支持多端发布
Git分支说明
分支模型
1.0U 版本分支
- 生产环境分支：
master - 测试环境分支：
develop - 合并规则：只允许从
master分支合并到develop，禁止反向合并
- 生产环境分支：
1.0S 版本分支
- 生产环境分支：
eye - 测试环境分支：
eye-dev - 合并规则：只允许从
eye分支合并到eye-dev，禁止反向合并
- 生产环境分支：
版本隔离
- 1.0U 和 1.0S 版本分支完全独立，互不合并
- 两个版本根据不同的业务需求进行开发和维护
环境说明
测试环境
- API地址: https://tstscreen.bolineyecare.com
- 配置方式: 在env.js中将
BASE_ENV设为development - 用途: 开发和测试阶段使用
生产环境
- API地址: https://screen.bolineyecare.com
- 配置方式: 在env.js中将
BASE_ENV设为production - 用途: 正式上线环境
相关文档
- 业务文档(BUSINESS.md)
- 注意事项(NOTES.md)