# Easy-Admin-uniapp

**Repository Path**: suddenlyyo/Easy-Admin-uniapp

## Basic Information

- **Project Name**: Easy-Admin-uniapp
- **Description**: 资产管理移动端app
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-23
- **Last Updated**: 2026-10-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

= Easy Admin UniApp

Easy-Admin 的**移动端应用**——基于 UniApp + Vue 3 开发，一套代码支持 H5、微信小程序、App（Android/iOS）多端运行，与后端服务配套使用。

后端提供两个对等实现，接口路径与数据模型保持一致，可独立部署、无需区分使用：

* Java 后端：link:https://gitee.com/suddenlyyo/Easy-Admin[Easy-Admin]（Spring Cloud 微服务）
* Rust 后端：link:https://gitee.com/suddenlyyo/Easy-Admin-Rust[Easy-Admin-Rust]（axum + tokio 移植版）

== 技术栈

|===
|类别 |技术 |版本

|跨端框架
|UniApp
|3.0.0-4010520240507001

|前端框架
|Vue
|3.4.21

|开发语言
|TypeScript
|5.4.5

|构建工具
|Vite
|5.2.8

|状态管理
|Pinia
|2.1.7

|UI 组件库
|uni-ui
|1.5.7

|加密
|node-forge / sm-crypto
|1.3.1 / 0.4.0
|===

== 功能模块

基于 `pages/` 目录划分：

* 登录（login）/ 首页（index）/ 协议（agreement）
* 资产（asset）/ 盘点（inventory）/ 巡检（inspection、inspection-task）
* 预警（alert）/ 维护（maintenance、maintenance-task）
* 处置（disposal）/ 转移（transfer）/ 审批（approval）
* 统计（statistics）/ 打印（print）/ 位置选择（location）
* 通知（notify）/ 个人中心（mine）

== 项目结构

UniApp HBuilderX 可视化项目结构：

```
Easy-Admin-uniapp/
├── pages/                  # 页面组件
├── api/                    # API 接口定义
├── common/                 # 公共类型定义（枚举/模型/参数/VO）
├── components/             # 公共组件
├── composables/            # 组合式函数
├── config/                 # 项目配置（API 基础地址等）
├── directives/             # 自定义指令
├── nativePlugins/          # 原生插件（DCloud-Crypto 等）
├── stores/                 # Pinia 状态管理
├── static/                 # 静态资源（tabbar 图标等）
├── uni_modules/            # uni-app 插件模块
├── utils/                  # 工具函数
├── pages.json              # 页面路由与 tabBar 配置
├── manifest.json           # 应用配置（appid、模块权限等）
├── App.vue / main.js       # 应用入口
└── DEVELOPMENT_GUIDE.adoc  # 开发指南
```

== 快速开始

项目为 HBuilderX 可视化结构，命令行负责依赖管理与开发编译，运行调试与打包在 HBuilderX 中进行：

```sh
npm install     # 安装依赖
npm run dev     # 启动 Vite 开发编译
```

随后在 HBuilderX 中将项目运行到浏览器、小程序模拟器或手机基座；App 打包使用 HBuilderX 在线打包，自定义基座需包含 DCloud-Crypto 原生插件（提供密码学安全随机数）。

== 开发指南

详细的开发指南请参考 link:DEVELOPMENT_GUIDE.adoc[DEVELOPMENT_GUIDE.adoc]，其中包含：

- 核心开发规范（API 定义/响应处理/状态管理/页面开发）
- 类型定义规范与枚举使用方式
- 网关配置与 API 基础地址
- 生产就绪标准

== 提交规范

项目启用 commitizen + commitlint（husky 钩子校验）：

```sh
npm run commit    # 交互式生成符合规范的提交信息
npm run format    # Prettier 格式化代码
```

== 许可证

MIT