# m.member 会员管理系统 H5 多租户版

**Repository Path**: huhuanan/m.member

## Basic Information

- **Project Name**: m.member 会员管理系统 H5 多租户版
- **Description**: 轻量级会员管理系统 — 开箱即用，手机浏览器即可操作。

支持会员订单与充值管理、员工薪资计算、会员扫码自助查询，助力商家打造私域流量。

单机部署，支持多租户，每个租户独立运行，互不干扰。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: http://test.ostudio.cc/
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2025-04-21
- **Last Updated**: 2026-05-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# m.member 会员管理系统 H5 多租户版

> 轻量级会员管理系统 — 开箱即用，手机浏览器即可操作。
> 
> 支持会员订单与充值管理、员工薪资计算、会员扫码自助查询，助力商家打造私域流量。
> 
> 单机部署，支持多租户，每个租户独立运行，互不干扰。

---

## 功能概览

| 模块 | 说明 |
|------|------|
| 会员管理 | 信息录入、级别设置、自动升级规则、余额与积分 |
| 订单管理 | 订单登记、商品明细、多付款方式、店长审核 |
| 充值管理 | 会员充值、赠送金额/积分、店长审核 |
| 员工管理 | 员工信息、权限分级（员工/店长）、薪资计算 |
| 会员自助 | 扫码查看余额、订单与充值记录 |
| 店铺管理 | 多店铺、店铺计划、会员日与优惠规则 |

## 技术栈

- **语言** Java 1.8
- **数据库** MySQL 5.7+
- **Web 框架** [m-server](https://gitee.com/huhuanan/m-server)（自研轻量级框架，无需 Web 容器）
- **二维码** ZXing 3.5.3

## 项目结构

```
src/main/java/
├── Start.java                  # 启动入口
└── member/
    ├── base/                   # 基础模块
    │   ├── action/             # 控制器（商家/店铺/员工/商品/级别）
    │   ├── model/              # 数据模型
    │   ├── service/            # 业务逻辑
    │   └── util/               # 工具类（权限/图片）
    ├── member/                 # 会员端（扫码自助）
    │   └── action/             # 会员操作入口
    └── order/                  # 订单/充值/薪资模块
        ├── action/             # 订单/充值/审核/薪资操作
        ├── model/              # 订单/充值/薪资模型
        ├── service/            # 业务逻辑
        └── util/               # 工具类（流水号/对账/汇总）
```

## 快速开始

### 环境要求

- JDK 1.8
- MySQL 5.7+

### 安装步骤

1. 确保 MySQL 已启动，创建数据库
2. 拷贝 `m.member-1.0-SNAPSHOT.jar`、`lib/` 目录及配置文件到目标路径
3. 修改数据库连接参数
4. 启动服务：

```bash
java -jar m.member-1.0-SNAPSHOT.jar 9999
```

5. 浏览器访问 `http://127.0.0.1:9999`

![安装教程](readme/11.png)

### 二次开发

```bash
# 1. 安装依赖框架到本地 Maven 仓库
git clone https://gitee.com/huhuanan/m-server.git
cd m-server && mvn install

# 2. 构建本项目
cd ../m.member && mvn package
```

## 功能截图

### 注册登录

| 登录界面 | 商家申请 | 首页 |
|----------|----------|------|
| <img src="readme/21.jpg" width=240> | <img src="readme/22.jpg" width=240> | <img src="readme/23.jpg" width=240> |

新商家点击「立即申请」注册，填写手机号和密码用于登录。

### 新商户设置

首次注册后需依次完成以下配置：

<div align="center">
<img src="readme/24.jpg" width=200>
<img src="readme/25.jpg" width=200>
<img src="readme/26.jpg" width=200>
</div>

- **功能总览** — 点击首页下方中间按钮展示全部功能
- **商家设置** — 配置会员日规则和优惠比例
- **店铺设置** — 开启店长审核后，订单和充值需二次审核

<div align="center">
<img src="readme/27.jpg" width=200>
<img src="readme/28.jpg" width=200>
<img src="readme/29.jpg" width=200>
</div>

- **员工设置** — 设置员工登录账号和权限
- **商品设置** — 配置商品与服务套餐，所有店铺共享
- **会员级别** — 设置各级别优惠比例

<div align="center">
<img src="readme/30.jpg" width=200>
<img src="readme/31.jpg" width=200>
</div>

- **升级规则** — 根据消费金额和订单数自动调节级别
- **会员管理** — 录入和维护会员信息

### 登记查询

<div align="center">
<img src="readme/32.jpg" width=200>
<img src="readme/33.jpg" width=200>
<img src="readme/34.jpg" width=200>
</div>

- **基础菜单** — 订单登记、充值登记、会员与商品查询
- **登记订单** — 选择会员、添加明细、选择付款方式（可多选）、输入附加金额
- **会员充值** — 选择会员、付款方式、金额，可赠送金额和积分

<div align="center">
<img src="readme/35.jpg" width=200>
<img src="readme/36.jpg" width=200>
<img src="readme/37.jpg" width=200>
</div>

- **我的订单** — 查看个人登记的所有订单
- **我的充值** — 查看个人登记的所有充值
- **会员查询** — 查看店铺所有会员，支持新增

<div align="center">
<img src="readme/38.jpg" width=200>
<img src="readme/39.jpg" width=200>
</div>

- **员工查询** — 查询商家下所有同事
- **商品查询** — 查询商家下所有商品服务信息

### 店长功能

<div align="center">
<img src="readme/40.jpg" width=200>
<img src="readme/41.jpg" width=200>
<img src="readme/42.jpg" width=200>
</div>

- **订单审核** — 查看员工提交的订单，核对收款后审核通过
- **充值审核** — 查看员工提交的充值，确认后审核通过

<div align="center">
<img src="readme/43.jpg" width=200>
<img src="readme/44.jpg" width=200>
</div>

- **充值详情** — 逐笔核对充值明细
- **店铺计划** — 登记店铺每月销售目标

### 会员自助

<div align="center">
<img src="readme/46.jpg" width=200>
<img src="readme/47.jpg" width=200>
<img src="readme/48.jpg" width=200>
</div>

会员通过扫描二维码进入自助页面（从订单/充值下方获取，或向店员索取）：

- 扫码后补全信息即可查看个人数据
- 查看余额、订单记录、充值记录

<div align="center">
<img src="readme/49.jpg" width=200>
</div>

### 薪资管理

<div align="center">
<img src="readme/45.jpg" width=200>
</div>

自动计算员工工资（需先确认员工月工资和提成配置）。

## 开发计划

- [ ] 简易应用配置页面
- [ ] 完善员工首页内容
- [ ] 月度利润统计

## 联系作者

有好的想法和需求，欢迎微信联系：**moyuan8**（开发者）