# uniapp_jian_template

**Repository Path**: code1014/uniapp_jian_template

## Basic Information

- **Project Name**: uniapp_jian_template
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-03-09
- **Last Updated**: 2026-03-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 地面储运煤火灾监测系统（前端）

本项目基于 uni-app，当前统一使用 **Vuex** 作为唯一状态管理方案（不使用 Pinia）。

## 1. 技术栈

- uni-app（Vue2 兼容工程）
- Vuex（统一状态管理）
- uv-ui

## 2. 目录说明（关键）

```text
x_1/
├─ src/
│  ├─ api/                 # 业务 API 封装
│  ├─ store/               # Vuex 业务模块（user、message 等）
│  ├─ views/               # 页面
│  ├─ components/          # 通用组件
│  ├─ utils/               # 工具函数
│  └─ config/              # 项目配置
├─ store/index.js          # Vuex 根实例（唯一状态入口）
├─ pages.json              # 页面路由配置
└─ manifest.json           # uni-app 平台配置
```

## 3. 开发环境要求

- Node.js：建议 16+
- npm：建议 8+
- HBuilderX：建议 3.1+

## 4. 安装依赖

```bash
npm install
```

## 5. 启动

### 5.1 使用 HBuilderX（推荐）

1. 使用 HBuilderX 打开 `x_1` 目录
2. 运行到目标平台（App/H5/小程序）

### 5.2 使用 CLI（如已配置 uni-app CLI）

```bash
# H5 开发
npm run dev:h5

# 微信小程序开发
npm run dev:mp-weixin

# App 开发
npm run dev:app
```

> 实际可用命令与本地 uni-app CLI 配置有关，如脚本缺失请以 HBuilderX 运行为准。

## 6. 构建

```bash
# H5 构建
npm run build:h5

# 微信小程序构建
npm run build:mp-weixin

# App 构建
npm run build:app
```

## 7. 发布

### 7.1 H5 发布

1. 执行构建后生成 H5 产物
2. 将产物部署到 Nginx / 静态资源服务器
3. 配置反向代理到后端 API

### 7.2 App 发布

1. 在 HBuilderX 中云打包（Android/iOS）
2. 使用正式签名证书
3. 灰度验证后上架

### 7.3 小程序发布

1. 构建对应小程序产物
2. 上传到平台开发者工具
3. 提交审核并发布

## 8. 环境变量规范

建议通过不同环境文件区分配置（示例）：

- `.env.development`
- `.env.test`
- `.env.production`

推荐变量：

```env
# API 基础地址
VUE_APP_BASE_URL=https://api.xxx.com

# 是否开启调试日志
VUE_APP_ENABLE_DEBUG=true

# WebSocket 地址（可选）
VUE_APP_WS_URL=wss://ws.xxx.com
```

建议在 `src/config` 中统一读取环境变量，不要在业务代码中硬编码域名。

## 9. 状态管理约束（强制）

- 项目只允许使用 **Vuex**。
- 所有全局状态必须定义在 `store/index.js` 或 `src/store/*` Vuex 模块中。
- 禁止引入 Pinia、MobX、Redux 等其他状态库。
- 页面禁止直接维护可复用的全局状态副本。

## 10. 文档索引

- API 契约文档：`docs/API_CONTRACT.md`
- 代码规范与提交规范：`docs/CODE_AND_COMMIT_STANDARD.md`