|
|
@@ -0,0 +1,94 @@
|
|
|
+# 铂林青少年视力筛查系统技术文档
|
|
|
+
|
|
|
+## 项目介绍
|
|
|
+
|
|
|
+铂林青少年视力筛查系统(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 # 全局样式变量
|
|
|
+```
|
|
|
+
|
|
|
+## 功能模块
|
|
|
+
|
|
|
+1. **筛查报告(index)** - 展示学生的视力筛查结果
|
|
|
+2. **个人中心(my)** - 用户个人信息及操作入口
|
|
|
+3. **添加学生(addPatient)** - 录入新的学生信息
|
|
|
+4. **健康分析(chart)** - 对视力数据进行统计分析并可视化展示
|
|
|
+5. **个人设置(setting)** - 用户个性化设置
|
|
|
+6. **登录(login)** - 用户身份验证入口
|
|
|
+7. **WebView(webview)** - 内嵌网页展示
|
|
|
+
|
|
|
+## 技术栈
|
|
|
+
|
|
|
+- **框架**: UniApp + Vue2/Vue3（兼容）
|
|
|
+- **语言**: JavaScript/HTML/CSS
|
|
|
+- **UI框架**: uni-ui + 自定义组件
|
|
|
+- **状态管理**: Vuex
|
|
|
+- **图表库**: uCharts + ECharts
|
|
|
+- **网络请求**: 自定义HTTP封装
|
|
|
+- **构建工具**: HBuilderX
|
|
|
+- **目标平台**: 微信小程序为主，支持多端发布
|
|
|
+
|
|
|
+## Git分支说明
|
|
|
+
|
|
|
+### 分支模型
|
|
|
+
|
|
|
+1. **1.0U 版本分支**
|
|
|
+ - 生产环境分支：`master`
|
|
|
+ - 测试环境分支：`develop`
|
|
|
+ - 合并规则：只允许从 `develop` 分支合并到 `master`，禁止反向合并
|
|
|
+
|
|
|
+2. **1.0S 版本分支**
|
|
|
+ - 生产环境分支：`eye`
|
|
|
+ - 测试环境分支：`eye-dev`
|
|
|
+ - 合并规则：只允许从 `eye-dev` 分支合并到 `eye`，禁止反向合并
|
|
|
+
|
|
|
+3. **版本隔离**
|
|
|
+ - 1.0U 和 1.0S 版本分支完全独立，互不合并
|
|
|
+ - 两个版本根据不同的业务需求进行开发和维护
|
|
|
+
|
|
|
+## 环境说明
|
|
|
+
|
|
|
+### 测试环境
|
|
|
+- API地址: https://tstscreen.bolineyecare.com
|
|
|
+- 配置方式: 在[env.js](file:///d:/work/bolinscreening/env.js)中将`BASE_ENV`设为`development`
|
|
|
+- 用途: 开发和测试阶段使用
|
|
|
+
|
|
|
+### 生产环境
|
|
|
+- API地址: https://screen.bolineyecare.com
|
|
|
+- 配置方式: 在[env.js](file:///d:/work/bolinscreening/env.js)中将`BASE_ENV`设为`production`
|
|
|
+- 用途: 正式上线环境
|
|
|
+
|
|
|
+## 相关文档
|
|
|
+
|
|
|
+- [业务文档(BUSINESS.md)](file:///d%3A/work/bolinscreening/BUSINESS.md)
|
|
|
+- [注意事项(NOTES.md)](file:///d%3A/work/bolinscreening/NOTES.md)
|
jilei