# Nexus-App

**Repository Path**: NexusERP/nexus-app

## Basic Information

- **Project Name**: Nexus-App
- **Description**: 覆盖ERP、MES传统功能的APP，实现销售、采购、仓库、生产、报工、OCR识别等功能，含有内部聊天通信、审批流、打卡定位等基本功能。加入AI模块，通过AI决策辅助办公。
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: https://gitee.com/NexusERP/nexus-erp
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 6
- **Created**: 2026-05-08
- **Last Updated**: 2026-09-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: uni-app, ERP, MES, AI

## README

<p align="center">
	<img alt="logo" src="static/logo.png" width="120"/>
</p>
<h1 align="center" style="margin: 30px 0 10px; font-weight: bold;">NexusERP 移动端</h1>
<h4 align="center" style="margin-bottom: 20px;">基于 UniApp 构建的 ERP 企业级移动端应用</h4>

<p align="center">
	<a href="https://gitee.com/y_project/RuoYi-Vue-Plus"><img src="https://img.shields.io/badge/RuoYi--Plus-v5.6.0-brightgreen.svg"/></a>
	<a href="https://uniapp.dcloud.net.cn/"><img src="https://img.shields.io/badge/UniApp-多端适配-blue.svg"/></a>
	<a href="https://pinia.vuejs.org/"><img src="https://img.shields.io/badge/Pinia-状态管理-yellow.svg"/></a>
	<a href="https://gitee.com/y_project/RuoYi-Vue-Plus/blob/master/LICENSE"><img src="https://img.shields.io/badge/MIT-开源-green.svg"/></a>
</p>

## 项目简介

NexusERP 移动端是 [Nexus-ERP](https://gitee.com/your-org/nexus-erp) 系统的移动端客户端，采用 **uni-app** 框架（Vue 3 + Pinia）构建，支持 Android、iOS、H5 及微信小程序多端发布。

后端项目基于 **RuoYi-Vue-Plus v5.6.0** 深度定制，覆盖 ERP 核心业务领域（销售、采购、生产、仓储、考勤、审批、即时通讯等），采用 Spring Boot 3.5 + Flowable 工作流 + MyBatis-Plus 多租户架构。

## 功能特性

### 核心业务模块

| 模块           | 功能说明                                                   |
| -------------- | ---------------------------------------------------------- |
| **首页驾驶舱** | 权限驱动的动态首页，数据概览卡片、快捷入口                 |
| **工作台**     | 待办提醒、功能入口网格、公告通知                           |
| **通知中心**   | 系统通知实时推送，WebSocket 实时接收，分类跳转             |
| **考勤打卡**   | GPS 定位打卡、排班查询、考勤统计、补卡申请、外出打卡       |
| **即时通讯**   | 私聊/群聊、好友管理、群组管理、消息已读回执、撤回/删除     |
| **审批中心**   | 待办审批、已办审批、我发起的审批、审批详情操作             |
| **仓储管理**   | 库存查询、入库管理、出库管理、库存调拨、库存盘点、库存预警 |
| **生产管理**   | 工单管理、生产报工、返工单管理、生产效率统计               |
| **供应商管理** | 供应商增删改查、列表筛选                                   |
| **客户订单**   | 销售订单增删改查、列表筛选                                 |

### 技术特性

- **多端适配**：一份代码同时发布至 Android、iOS、H5、微信小程序
- **工程化**：ESLint 9 + Prettier + useRequest 组合式函数 + 完整类型定义
- **状态管理**：Pinia 模块化仓库，每个业务域独立 store
- **实时通信**：WebSocket 心跳检测 + 自动重连 + 离线消息队列
- **权限控制**：动态权限路由 + 首页模块级权限渲染
- **统一设计**：60+ SCSS 变量 + 共享工具类，Ant Design Mobile 视觉语言
- **地理定位**：Haversine 距离计算 + 服务端双重校验

## 技术栈

### 前端

| 技术         | 说明                                            |
| ------------ | ----------------------------------------------- |
| **uni-app**  | 跨平台应用框架，基于 Vue 3 `createSSRApp`       |
| **Vue 3**    | Composition API，全部页面 `<script setup>` 语法 |
| **Pinia**    | 状态管理，12 个业务模块 store                   |
| **uni-ui**   | DCloud 官方 UI 组件库                           |
| **SCSS**     | 全局设计变量 + 共享工具类                       |
| **Flowable** | 工作流审批引擎对接                              |

### 后端

| 技术                 | 说明                             |
| -------------------- | -------------------------------- |
| **Spring Boot 3.5**  | 微服务基础框架                   |
| **RuoYi-Vue-Plus**   | 权限框架基础（多租户、Sa-Token） |
| **MyBatis-Plus 3.5** | ORM 框架，支持多租户、分页、加密 |
| **Flowable 7.0**     | 工作流引擎                       |
| **Redis**            | 缓存 + WebSocket 广播            |
| **MinIO**            | 文件存储                         |
| **MySQL**            | 主数据库                         |

## 项目结构

```
├── api/                        # API 服务模块（按业务域划分）
│   ├── login.js                #   认证：登录、注册、短信验证码
│   ├── notification.js         #   通知中心
│   ├── sch/attendance.js       #   考勤：打卡、排班、规则、补卡
│   ├── im/                     #   即时通讯：消息、会话、好友、群组
│   ├── wm/                     #   仓储：库存、入库、出库、调拨、盘点
│   ├── prd/                    #   生产：工单、报工、返工
│   ├── wf/                     #   审批：流程任务、流程定义
│   ├── bd/vendor.js            #   供应商管理
│   └── so/customerOrder.js     #   销售订单
├── pages/                      # 页面（53 个注册路由）
│   ├── index                   #   首页
│   ├── work/index              #   工作台
│   ├── sch/attendance/         #   考勤模块（4 页）
│   ├── im/                     #   即时通讯（8 页）
│   ├── wm/                     #   仓储管理（8 页）
│   ├── prd/                    #   生产管理（8 页）
│   ├── wf/                     #   审批中心（5 页）
│   ├── notification/           #   通知中心
│   ├── bd/vendor/              #   供应商（4 页）
│   ├── so/customerOrder/       #   销售订单（4 页）
│   └── mine/                   #   个人中心
├── store/modules/              # Pinia 状态仓库（12 个模块）
├── components/                 # 共享/业务组件
│   ├── im/                     #   IM 组件（消息气泡、输入框等）
│   ├── wf/approval-action.vue  #   审批操作按钮
│   └── ...
├── utils/                      # 工具模块
│   ├── request.js              #   HTTP 客户端
│   ├── websocket.js            #   WebSocket 客户端
│   ├── location.js             #   地理定位 & 打卡校验
│   └── ...
├── composables/                # Vue 组合式函数
│   └── useRequest.js           #   通用数据请求 composable
├── static/                     # 静态资源
│   └── scss/                   #   全局样式
├── config.js                   # 应用配置（baseUrl、appInfo）
├── permission.js               # 页面路由权限拦截
├── pages.json                  # 路由 & TabBar 配置
├── manifest.json               # uni-app 应用清单
├── uni.scss                    # 全局 SCSS 变量
└── docs/                       # 项目文档
```

## 后端项目

配套后端项目 [Nexus-ERP](https://gitee.com/NexusERP/nexus-erp) 位于 `https://gitee.com/NexusERP/nexus-erp`，基于 RuoYi-Vue-Plus 构建，包含以下业务模块：

- **ruoyi-system** — 系统管理（用户、角色、菜单、租户、字典）
- **ruoyi-erp** — ERP 核心业务（物料、BOM、销售订单、采购、生产、仓储、排班）
- **ruoyi-mes** — MES 制造执行（生产执行、数据采集、设备、质量）
- **ruoyi-im** — 即时通讯
- **ruoyi-ai** — AI 智能助手（LangChain4j + MCP 协议）
- **ruoyi-flowable** — 工作流引擎
- **ruoyi-pay** — 支付管理
- **ruoyi-iot** — IoT 设备管理

## 快速开始

### 环境要求

- [HBuilderX](https://www.dcloud.io/hbuilderx.html)（推荐）或 uni-app CLI
- Node.js >= 16
- 后端 [Nexus-ERP](https://gitee.com/NexusERP/nexus-erp) 已启动（默认端口 8080）

### 运行步骤

1. **克隆项目**

```bash
git clone https://gitee.com/your-org/nexus-app.git
cd nexus-app
```

2. **配置后端地址**

编辑 [config.js](config.js) 中的 `baseUrl`：

```js
// 开发环境
baseUrl: 'http://localhost:8080'

// 生产环境
baseUrl: 'http://xxxx/prod-api'
```

环境判定基于构建模式自动切换（HBuilderX「运行」/ `npm run dev:*` 为开发环境，「发行」/ `npm run build:*` 为生产环境），开发调试时无需手动改动 `baseUrl`。

3. **使用 HBuilderX 运行**

- 打开 HBuilderX → 文件 → 导入项目 → 选择 `nexus-app` 目录
- 点击工具栏「运行」→ 选择目标平台（Android / iOS / H5 / 微信小程序）

4. **H5 开发模式**

```bash
npm install
npm run dev:h5
```

H5 开发服务器默认运行在 `http://localhost:9090`

### 权限说明

- 安卓端需要 **定位权限**（用于考勤打卡 GPS 校验）
- 微信小程序需要 **位置信息** 权限

## 开发文档

更多文档请参考 [docs/](docs/) 目录：

- [开发路线图](docs/开发路线图.md) — 功能迭代计划与里程碑
- [UI 设计规范](docs/UI设计规范.md) — 统一设计系统与视觉规范
- [UI 重构总结](docs/UI重构总结.md) — 界面重构变更记录
- [接口状态清单](docs/接口状态清单.md) — 前后端接口对接状态
- [后端接口需求](docs/后端接口需求.md) — 新接口需求定义
- [架构分析报告](docs/架构分析报告.md) — 技术架构分析与升级建议
- [考勤接口文档](docs/考勤接口文档.md) — 考勤模块 API 详细说明
- [阶段一_工程化变更总结](docs/阶段一_工程化变更总结.md) — 工程化基础建设记录
- [阶段一_代码审查报告](docs/阶段一_代码审查报告.md) — 代码审查与修复记录
- [阶段二_IM模块重构总结](docs/阶段二_IM模块重构总结.md) — IM 架构重构记录
- [IM界面重写总结](docs/IM界面重写总结.md) — IM 界面样式重写记录

## 贡献指南

欢迎提交 Issue 和 Pull Request。

## 开源协议

[MIT License](LICENSE) Copyright (c) 2022 [若依](https://gitee.com/y_project/RuoYi-Vue)

NexusERP 二次开发：Copyright (c) 2026 NexusERP