# 小商户订单管理系统

**Repository Path**: dm_team/Small-Merchant-Order-Management-System

## Basic Information

- **Project Name**: 小商户订单管理系统
- **Description**: 小商户订单管理系统面向社区便利店、校园周边小店、社区团购门店等轻量经营场景，提供商品库存、客户运营、订单履约、配送跟踪、补货入库、用户权限和分类字典维护功能。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-09
- **Last Updated**: 2026-09-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 小商户订单管理系统

小商户订单管理系统面向社区便利店、校园周边小店、社区团购门店等轻量经营场景，提供商品库存、客户运营、订单履约、配送跟踪、补货入库、用户权限和分类字典维护功能。

## 本次扩充说明

业务系统常见理解处理为“系统内可维护的业务分类/类别字典”，不是代码里的 `class` 关键字。系统已新增独立的分类字典能力：

- 新增 `category_items` 分类字典表。
- 预置 20 个分类分组、188 个分类项。
- 管理员可在前端“分类管理”页面新增、编辑、停用、删除分类。
- 商品分类、商品单位、会员等级、客户状态、销售渠道、订单类型、支付方式、收款状态、订单状态、预约时段、配送状态、配送线路、补货状态、紧急程度等下拉项已接入分类字典。
- 后端保留默认值兜底，避免分类数据异常时影响原功能运行。

## 功能模块

- 经营驾驶舱：查看今日收款、待拣货订单、低库存商品、在途补货和近期经营日志。
- 商品工作台：查看商品库存、分类分布、库存价值、动销情况，并生成补货单。
- 订单履约台：创建订单、确认收款、备货、门店自提完成、取消订单。
- 客户运营：维护客户档案、会员等级、累计消费、沉睡客户唤醒线索。
- 配送履约：配送发车、异常登记、签收完成，并联动订单状态。
- 补货调度：补货下单、在途跟踪、入库恢复库存。
- 分类管理：维护系统业务分类，新增后进入对应业务下拉框。
- 用户总览：管理员维护账号角色、班次、启停状态。

## 技术栈

- 前端：React 18、Vite 6、Ant Design 5、Recharts、Axios
- 后端：Python 3.10+、FastAPI 0.115、Uvicorn 0.32
- 数据库：SQLite 3，Python 自带 `sqlite3` 模块，不需要单独安装数据库服务

## 默认端口

- 后端接口：`http://localhost:9016`
- 前端页面：`http://localhost:5178`

运行到这里后，浏览器会打开登录页。可直接使用下面账号登录：

- 管理员: `merchant_admin` / `Pass@123`
- 普通用户: `merchant_user` / `Pass@123`

建议第一次演示或检查时先使用管理员账号，因为管理员可以看到类别管理、用户管理和完整业务功能。
## 演示账号

- 管理员：`merchant_admin` / `Pass@123`
- 普通用户：`merchant_user` / `Pass@123`

## 新手运行步骤

### 1. 安装基础环境

1. 安装 Python 3.10 或更高版本，安装时勾选 `Add Python to PATH`。
2. 安装 Node.js 18 或更高版本，npm 会随 Node.js 一起安装。
3. 安装完成后打开命令行，检查版本：

```bash
python --version
node --version
npm --version
```

### 2. 启动后端

进入项目后端目录：

```bash
cd D:\Ten-Projects\06-small-merchant-order-management-system\backend
python -m pip install -r requirements.txt
python -m uvicorn main:app --host 127.0.0.1 --port 9016 --reload
```

看到 `Uvicorn running on http://127.0.0.1:9016` 表示后端启动成功。首次启动会自动生成 SQLite 数据库文件：

```text
backend\data\small-merchant-order-management-system.db
```

### 3. 启动前端

重新打开一个命令行窗口，进入前端目录：

```bash
cd D:\Ten-Projects\06-small-merchant-order-management-system\frontend
npm install
npm run dev
```

浏览器访问：

```text
http://localhost:5178
```

### 4. 恢复初始演示数据

如果演示时把数据改乱了，可以关闭后端服务，删除数据库文件后重新启动后端：

```text
backend\data\small-merchant-order-management-system.db
```

后端会重新执行 `database/init.sql` 和 `database/sample_data.sql` 初始化样例数据，并重新写入 188 个分类项。

## 上传 Gitee 建议

建议上传：

- `backend/`
- `frontend/src/`
- `frontend/index.html`
- `frontend/package.json`
- `frontend/package-lock.json`
- `frontend/vite.config.mjs`
- `database/`
- `docs/`
- `README.md`

不建议上传：

- `frontend/node_modules/`
- `frontend/dist/`
- `backend/data/*.db`
- `backend/__pycache__/`

这些目录可以通过安装依赖、重新构建或首次启动自动生成。

## 验证命令

后端测试：

```bash
cd backend
python -m unittest test_category_service.py
python -m py_compile main.py category_service.py category_seed.py
```

前端构建：

```bash
cd frontend
npm run build
```

## 文档目录

- `docs/01_项目简介.md`
- `docs/02_需求分析.md`
- `docs/03_系统设计.md`
- `docs/04_数据库设计.md`
- `docs/05_接口文档.md`
- `docs/06_部署说明.md`
- `docs/07_使用手册.md`
- `docs/08_测试说明.md`
- `docs/09_论文写作参考.md`
- `docs/10_答辩演示说明.md`