# labsop_scientific_h5 移动端 温岭项目

基于 Vue 3 + Vite + Pinia + UniApp 框架研发的科研实验系统（钉钉小程序/移动端）。

## 技术栈

- **前端框架**: [Vue 3](https://vuejs.org/)
- **构建工具**: [Vite](https://vitejs.dev/)
- **状态管理**: [Pinia](https://pinia.vuejs.org/)
- **跨端框架**: [UniApp](https://uniapp.dcloud.net.cn/)
- **网络请求**: axios
- **时间处理**: dayjs
- **其他**: crypto-js, sm-crypto 等安全加密工具

## 项目结构

```text
├── api            # 后端接口统一定义
├── components     # 业务相关的公共组件
├── constants      # 全局常量、枚举值定义
├── hooks          # 组合式 (Composition API) 逻辑抽离
├── pages          # 各业务功能页面
├── static         # 静态图片等资源存放目录
├── store          # Pinia 状态管理仓库
├── styles         # 全局 SCSS/CSS 样式定义
├── types          # TypeScript 全局接口与类型声明
├── uni_modules    # UniApp 第三方及自定义插件包
├── utils          # 本项目通用的工具类函数
├── .env.*         # 多环境保护配置（开发、生产等）
└── package.json   # 依赖清单及脚本
```

## 开发运行指南

推荐使用 [HBuilderX](https://www.dcloud.io/hbuilderx.html) 进行开发调试，以获得最好的 UniApp 开发体验：

1. **导入项目**：打开 HBuilderX，选择引入本项目（文件 -> 导入 -> 从本地目录导入）。
2. **下载依赖**：在项目根目录打开终端执行 `npm install`。
3. **运行模式**：
   - 点击 HBuilderX 顶部菜单栏 `运行` -> `运行到内置浏览器` 或对应的 **钉钉小程序开发者工具** 进行预览和联调。
4. **发行编译**：
   - 点击 HBuilderX 顶部菜单栏 `发行` -> 对应的平台生成最终代码。

## 注意事项

- **接口地址**：请在相应的 `.env.development` (或其它 `.env` 文件) 中配置接口请求服务端的地址等环境变量。
- **模块规范**：新增业务或页面时，建议在 `pages/` 下按模块分子目录，如涉及多模块复用的功能抽离至 `components/` 或 `hooks/` 中。
- **状态管理**：推荐所有跨页面共享的状态统一放入 `store/` 内并通过 Pinia 获取。
