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                # 全局样式变量

功能模块

  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 版本分支完全独立,互不合并
    • 两个版本根据不同的业务需求进行开发和维护

环境说明

测试环境

生产环境

相关文档

  • 业务文档(BUSINESS.md)
  • 注意事项(NOTES.md)