# Snowy-Mobile

**Repository Path**: amHonglin/snowy-mobile

## Basic Information

- **Project Name**: Snowy-Mobile
- **Description**: 💖引领国产化软件新潮流，国内首个国密前后分离快速开发平台SnowyAdmin的移动端，现以全新面貌亮相！采用前沿技术栈 uni-app开发，完美适配后台管理。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://xiaonuo.vip
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 279
- **Created**: 2026-02-25
- **Last Updated**: 2026-02-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Snowy-Mobile

## 介绍

Snowy-Mobile 是 Snowy 生态体系中的移动端框架，基于 uni-app 开发。Snowy 谐音"小诺"，寓意"下雪的、纯洁的"，代表框架追求简洁至上、大道至简的设计理念。

这是一个功能完善的移动端应用开发框架，提供了丰富的业务组件和工具函数，适用于企业级移动应用开发。

## 技术栈

- **前端框架**：uni-app (Vue 2)
- **状态管理**：Vuex
- **UI 组件**：uni-ui + ThorUI + 自定义组件
- **工具库**：xe-utils
- **样式**：SCSS + ColorUI

## 项目结构

```
├── api/                    # API 接口模块
│   ├── auth/              # 认证相关接口
│   ├── biz/               # 业务接口
│   ├── dev/               # 开发工具接口（配置、字典、文件）
│   ├── sys/               # 系统接口
│   └── ten/               # 第三方接口
├── components/            # 自定义组件
│   ├── snowy/             # Snowy 系列组件
│   │   ├── snowy-crumb         # 面包屑
│   │   ├── snowy-dyna-field    # 动态字段
│   │   ├── snowy-empty         # 空状态
│   │   ├── snowy-file-picker   # 文件选择器
│   │   ├── snowy-file-view     # 文件预览
│   │   ├── snowy-float-btn     # 悬浮按钮
│   │   ├── snowy-icon          # 图标
│   │   ├── snowy-search        # 搜索
│   │   ├── snowy-sel-picker    # 选择器
│   │   ├── snowy-transfer      # 穿梭框
│   │   ├── snowy-tree-picker   # 树选择器
│   │   ├── snowy-user-picker   # 用户选择器
│   │   └── ...
│   └── thorui/            # ThorUI 组件库
├── enum/                  # 枚举定义
├── pages/                 # 页面文件
│   ├── home/              # 首页相关
│   ├── mine/              # 我的（个人中心）
│   ├── msg/               # 消息中心
│   ├── config/            # 配置管理
│   ├── auth/              # 登录注册
│   └── agreement/         # 协议页面
├── pkgs/                  # 业务包
│   └── hr/                # 人力资源模块
├── plugins/               # 插件
│   ├── snowy/             # Snowy 插件
│   │   ├── modal.js       # 模态框
│   │   ├── permission.js  # 权限控制
│   │   ├── tab.js         # 标签页
│   │   └── tool.js        # 工具函数
│   └── xe-utils/          # xe-utils 工具库
├── static/                # 静态资源
│   ├── icon/              # 图标资源
│   ├── images/            # 图片资源
│   ├── scss/              # 样式文件
│   └── svg/               # SVG 图标
├── store/                 # Vuex 状态管理
│   └── modules/           # 状态模块
├── uni_modules/           # uni-app 官方组件
└── utils/                 # 工具函数
    ├── api-adaptive.js    # API 适配
    ├── auth.js            # 认证工具
    ├── common.js          # 通用工具
    ├── error-code.js      # 错误码
    ├── file-download.js   # 文件下载
    ├── file-upload.js     # 文件上传
    ├── request.js         # 请求封装
    ├── sm-crypto.js       # 国密算法
    └── storage.js         # 存储工具
```

## 功能特性

### 认证授权
- token 管理
- 登录/登出
- 权限控制
- 用户信息管理

### 业务模块
- 首页（轮播、菜单、公告、日程）
- 个人中心（信息编辑、密码修改、配置管理）
- 消息中心
- 配置管理

### HR 人力资源模块
- 通知公告
- 组织架构
- 职位管理
- 用户管理

### 组件库
- 表单组件（动态字段、文件上传、选择器等）
- 列表组件（树形选择、用户选择、穿梭框）
- 展示组件（文件预览、图片查看、视频播放）
- 布局组件（面包屑、悬浮按钮）

### 基础设施
- 请求拦截器
- 响应处理
- 错误码映射
- 国密算法支持（SM2/SM3/SM4）
- 多环境配置

## 快速开始

### 环境要求

- Node.js >= 14.x
- HBuilderX 或 VS Code + uni-app 插件

### 安装依赖

```bash
# 使用 HBuilderX 时无需手动安装
# 如使用命令行：
npm install
```

### 运行项目

```bash
# 运行到 H5
npm run dev:h5

# 运行到微信小程序
npm run dev:mp-weixin

# 运行到 App
npm run dev:app
```

### 构建项目

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

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

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

## 配置说明

### 环境配置

在 `env.js` 中配置不同环境的 API 地址：

```javascript
const defaultAllEnv = {
  development: {
    baseUrl: '开发环境地址'
  },
  production: {
    baseUrl: '生产环境地址'
  }
}
```

### 全局配置

在 `config.js` 中配置：

- `noTokenBackUrl` - 无 token 时跳转地址
- `hasTokenBackUrl` - 有 token 时跳转地址

## 页面路由

| 路径 | 说明 |
|------|------|
| /pages/home/index | 首页 |
| /pages/mine/index | 个人中心 |
| /pages/msg/index | 消息列表 |
| /pages/auth/login | 登录 |
| /pages/config/index | 配置管理 |

## 团队成员

| 成员 | 技术 | 昵称 |
|:----:|:----:|:-----:|
| 俞宝山 | 全栈 | 俞宝山 |
| 徐玉祥 | 全栈 | 就是那个锅 |
| 董夏雨 | 全栈 | 阿董 |
| 王鹏 | 全栈 | 每天一点 |

## 演示地址

[https://snowymobile.xiaonuo.vip/](https://snowymobile.xiaonuo.vip/)

## 视频教程

[https://www.bilibili.com/video/BV1pX4y1E7YZ/](https://www.bilibili.com/video/BV1pX4y1E7YZ/)

## 文档地址

[https://xiaonuo.vip/doc?catalogueId=1624454420570423298&menuId=1699990545204101122&lineIndex=1](https://xiaonuo.vip/doc?catalogueId=1624454420570423298&menuId=1699990545204101122&lineIndex=1)

## 联系方式

- QQ：1253070437
- 微信：xiaonuobase

## 版权说明

- Snowy 生态技术框架全系版本采用 Apache License 2.0 协议
- 代码可用于个人项目等接私活或企业项目脚手架使用，Snowy 全系开源版完全免费
- 二次开发如用于开源竞品请先联系群主沟通，未经审核视为侵权
- 请不要删除和修改 Snowy 源码头部的版权与作者声明及出处