# 码森防伪溯源一物一码系统

**Repository Path**: softideas/masen

## Basic Information

- **Project Name**: 码森防伪溯源一物一码系统
- **Description**: 码森防伪溯源一物一码系统，提供高效可靠的防伪溯源解决方案，支持一物一码管理，确保产品安全与透明。支持积分商城、红包营销活动、出入库管理、经销商管理。支持批量生成二维码。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 10
- **Forks**: 3
- **Created**: 2026-04-02
- **Last Updated**: 2026-07-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <img src="docs/images/logo.png" width="100%" alt="码森防伪溯源一物一码系统"/>
</p>

<h1 align="center">码森防伪溯源 · 一物一码追溯系统（开源简单版）</h1>

<p align="center">
  <strong>mstraceSimple</strong> — 防伪验真 · 全链路溯源 · 一物一码管理
</p>

<p align="center">
  作者 masen · 微信号 masen8901 · 合肥码森未来科技有限公司
</p>

<p align="center">
  <a href="https://saas.mstraceai.com/">🚀 SaaS 完整版体验：https://saas.mstraceai.com/</a>
</p>

---

## 简介

本仓库为 **mstraceSimple 开源简单版**，提供一物一码生成、扫码查询、防伪验证与溯源节点展示，适合学习、二次开发与本地私有化部署。

如需**消费者运营、仓储渠道、红包营销、积分商城、数据看板**等完整企业级能力，请使用码森 **SaaS 完整版**：

<p align="center">
  <a href="https://saas.mstraceai.com/"><strong>👉 码森防伪溯源 SaaS 完整版：https://saas.mstraceai.com/</strong></a>
</p>

| 版本 | 说明 |
|------|------|
| **开源简单版**（本仓库） | 溯源码生成、扫码验真、产品/批次/节点管理，可本地部署 |
| **[SaaS 完整版](https://saas.mstraceai.com/)** | 全链路溯源 + 消费者运营 + 仓储渠道 + 营销商城 + 数据看板，开箱即用 |

### 本仓库三端架构

| 端 | 目录 | 技术栈 | 说明 |
|----|------|--------|------|
| 消费者端 | `front-wxp` | uni-app | 微信小程序 / H5 / App 扫码查询 |
| 管理后台 | `admin-web` | Vue3 + Element Plus | 产品、批次、溯源码、企业管理 |
| 后端 API | `backend` | Django 5 + DRF + MySQL | REST 接口与业务逻辑 |

## 项目结构

```
masen/
├── backend/          # Django 后端
├── admin-web/        # Vue3 管理后台
├── front-wxp/        # uni-app 消费者端
├── docs/images/      # README 展示图片（英文路径，各平台兼容）
├── 效果图/           # 原始宣传素材（可选）
├── README.md
└── LICENSE
```

## 快速开始

### 环境要求

- Python **3.10+**
- Node.js **16+**
- MySQL **5.7+ / 8.0**
- Redis（推荐，用于缓存；未安装时部分功能受限）

### 1. 后端

```bash
cd backend
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/
# 编辑 config.py 配置 MySQL / Redis
python manage.py migrate
python manage.py init -y    # 系统数据 + 演示数据
python manage.py runserver 127.0.0.1:8000
```

### 2. 管理后台

```bash
cd admin-web
npm install
npm run dev    # http://127.0.0.1:8080
```

默认账号：`superadmin` / `admin` / `test`，密码均为 `123456`

### 3. 消费者端

使用 HBuilderX 打开 `front-wxp`，运行到浏览器（H5，端口 **8080**）或微信开发者工具。

> 微信小程序需在 `front-wxp/manifest.json` 中填写自己的 `mp-weixin.appid`。

### 演示数据

执行 `python manage.py init -y` 后内置演示溯源码，可直接查询：

| 溯源码 | 防伪码 |
|--------|--------|
| DEMO2024ABC001 | 123456 |
| DEMO2024ABC002 | 234567 |
| DEMO2024ABC003 | 345678 |

## 配置说明

| 文件 | 说明 |
|------|------|
| `backend/config.py` | 数据库、Redis、域名、H5 查询链接 |
| `admin-web/src/config/index.js` | 管理后台 API 地址（默认 `127.0.0.1:8000`） |
| `front-wxp/utils/env.js` | 消费者端 API 地址 |

生产部署前请修改以上地址为实际域名，并更换 `backend/application/settings.py` 中的 `SECRET_KEY`。

## 开源简单版核心功能

- 批次生成溯源码，导出 CSV（含 H5 完整查询链接）
- 消费者扫码 / 手动输入查询（支持小程序、H5、App）
- 防伪码二次验证
- 产品、企业、溯源节点信息展示
- 扫码记录统计

## SaaS 完整版功能（引流）

[SaaS 完整版](https://saas.mstraceai.com/) 在简单版基础上，还提供：

| 模块 | 功能 |
|------|------|
| **消费者运营** | 消费者管理、扫码记录、积分记录 |
| **溯源与生产** | 批次管理、二维码列表、商品管理、溯源节点绑定、模板管理 |
| **仓储与渠道** | 仓库管理、供应商管理、经销商管理、出入库记录 |
| **营销增长** | 红包活动、积分体系 |
| **商城交易** | 商城相关功能 |
| **数据与账户** | 数据看板、个人账户 |

> 体验完整能力请访问：**[https://saas.mstraceai.com/](https://saas.mstraceai.com/)**  
> 定制开发 / 私有化部署请联系微信：**masen8901**

## 效果图

### 一、用户端效果（开源简单版 · `front-wxp`）

<p align="center">
  <img src="docs/images/img9.png" width="100%" alt="用户端-扫码查询"/>
</p>

<p align="center">
  <img src="docs/images/img10.png" width="100%" alt="用户端-查询结果"/>
</p>

<p align="center">
  <img src="docs/images/img11.png" width="100%" alt="用户端-溯源展示"/>
</p>

### 二、管理后台效果（开源简单版 · `admin-web`）

<p align="center">
  <img src="docs/images/img6.png" width="100%" alt="管理后台-批次管理"/>
</p>

<p align="center">
  <img src="docs/images/img7.png" width="100%" alt="管理后台-溯源配置"/>
</p>

<p align="center">
  <img src="docs/images/img8.png" width="100%" alt="管理后台-数据管理"/>
</p>

### 三、SaaS 完整版效果

<p align="center">
  <a href="https://saas.mstraceai.com/"><strong>码森防伪溯源 SaaS → saas.mstraceai.com</strong></a>
</p>

<p align="center">
  <img src="docs/images/img1.png" width="100%" alt="SaaS-数据看板"/>
</p>

<p align="center">
  <img src="docs/images/img2.png" width="100%" alt="SaaS-营销功能"/>
</p>

<p align="center">
  <img src="docs/images/img3.png" width="100%" alt="SaaS-仓储渠道"/>
</p>

<p align="center">
  <img src="docs/images/img4.png" width="100%" alt="SaaS-消费者运营"/>
</p>

<p align="center">
  <img src="docs/images/img5.png" width="100%" alt="SaaS-商城功能"/>
</p>

## 作者与联系

- **作者**：masen
- **微信**：masen8901
- **版权**：合肥码森未来科技有限公司
- **定制开发**：欢迎通过微信联系

## License

本项目采用 [Apache License 2.0](LICENSE) 开源协议。