# SmartSys

**Repository Path**: m40/SmartSys

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-22
- **Last Updated**: 2026-07-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SmartSys 智慧店铺管理平台

SmartSys 是一套面向线下实体门店的数字化经营管理平台，提供店铺管理、员工管理、顾客互动（评价 / 投诉 / 问卷 / 优惠券）、数据统计等能力，支持多角色（商家、店长、员工、顾客）协同使用。

## 功能特性

- **多角色支持**：商家（老板）、店长、员工、顾客，按角色动态授权功能与工具
- **多店铺管理**：一个商家可管理多家店铺，数据按商家 / 店铺隔离
- **顾客互动**：评价、投诉建议、问卷调查、优惠券发放与核销
- **员工协同**：员工绑定、任务分派、工单处理、客户服务
- **数据统计**：店铺经营数据可视化看板
- **三端协同**：管理后台（Web）+ 微信小程序（顾客 / 员工 / 商家）+ 后端 API

## 技术架构

| 模块 | 技术栈 | 目录 |
| --- | --- | --- |
| 后端 API | Spring Boot 3 / MyBatis-Plus / Sa-Token / Knife4j / MySQL | `adminBackend/` |
| 管理前端 | Vue 3 / TypeScript / Vite | `adminFrontend/` |
| 微信小程序 | 原生小程序（WXML / WXSS / JS） | `wxapp/` |

## 目录结构

```
SmartSys/
├── adminBackend/        # 后端服务（Spring Boot）
│   └── src/main/resources/db/   # 数据库 SQL
├── adminFrontend/       # 管理后台前端（Vue 3）
├── wxapp/               # 微信小程序
│   ├── pages/           # 页面（auth/index/shop/feedback/...）
│   └── utils/           # 工具类（api / navigator / util）
├── uploads/             # 上传资源目录
├── 设计说明书            # 系统设计文档
├── 需求说明书            # 业务需求文档
└── LICENSE
```

## 环境要求

- JDK 17+
- Node.js 18+
- MySQL 8.0+
- 微信开发者工具（小程序调试）

## 快速开始

### 1. 后端（adminBackend）

```bash
cd adminBackend
# 修改 src/main/resources 下的数据库连接配置
mvn spring-boot:run
# API 文档: http://localhost:8080/doc.html  (Knife4j)
```

### 2. 管理前端（adminFrontend）

```bash
cd adminFrontend
npm install
npm run dev
```

### 3. 微信小程序（wxapp）

1. 用微信开发者工具导入 `wxapp/` 目录
2. 修改 `project.config.json` 中的 `appid`
3. 修改 `utils/api.js` 中的 `BASE_URL` 指向你的后端地址
4. 编译预览

## 数据模型概览

- **商家** `sys_user`：企业管理账号，一个商家对应一个管理账号
- **店铺** `fb_shop`：归属商家（`createBy` / `managerId` → `sys_user.id`）
- **微信用户** `wx_user`：顾客 / 员工身份，登录时自动归属当前店铺的商家（`sysUserId` → `sys_user.id`）
- 业务数据（评价、投诉、问卷、优惠券等）通过 `shopId` 实现商家隔离

## 许可证

[MIT](./LICENSE) © 2026 m40