# 铂林青少年视力筛查系统技术文档

## 项目介绍

铂林青少年视力筛查系统(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)