# OneProductOneCode

**Repository Path**: sunhunk/one-product-one-code

## Basic Information

- **Project Name**: OneProductOneCode
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-02
- **Last Updated**: 2026-03-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 一物一码管理系统 (OneProductOneCode)

## 项目简介

一物一码营销与管理系统，包含：
- 管理后台（批次/生码任务/活动/扫码记录等）
- 手机端 H5（扫码入口及活动页面）
- 后端 API（含队列生码、扫码日志、权限认证等）

## 技术栈

- 后端：ThinkPHP 6 + MySQL + Redis（队列默认 Redis）
- 管理后台：Vue 3 + Vite + TypeScript + Pinia + Vue Router
- 手机端：UniApp（Vue3）+ Vite（主要用于 H5 构建）

## 目录结构

```text
.
├── 1-需求明细/                # 需求说明
├── 2-model/                   # 数据表模型说明
├── 2-sql/                     # SQL 初始化与更新脚本
├── 3-接口文档/                 # API 文档（自动生成）
├── 5-backend/                 # 后端服务（ThinkPHP 6）
│   ├── app/
│   │   ├── controller/        # 控制器（admin/api）
│   │   ├── model/             # 数据模型
│   │   ├── service/           # 业务服务
│   │   └── job/               # 队列任务（如生码）
│   ├── config/                # 配置（database/redis/queue/oss/jwt 等）
│   ├── public/                # Web 入口
│   ├── route/                 # 路由
│   └── think                  # ThinkPHP 命令入口
├── 6-frontend/                # 管理后台（Vue3 + Vite）
└── 8-uniapp/                  # 手机端（UniApp，含 H5 构建）
```

## 访问地址

以下为手机端用户页面（H5）访问地址：
- 预发布环境：`https://m.zhangyuma.cn/m_dev/index.html`
- 正式环境：`https://m.zhangyuma.cn/m/index.html`

以下为管理后台（PC）访问地址：
- 预发布环境：`https://m.zhangyuma.cn/admin_dev/index.html`
- 正式环境：`https://m.zhangyuma.cn/admin/index.html`

## 快速开始

### 1) 后端（5-backend）

环境要求：PHP 7.2+（建议 8.x）、Composer、MySQL、Redis。

```bash
cd 5-backend

# 安装依赖
composer install

# 复制环境配置（按项目内实际示例文件）
cp .example.env .env

# 启动开发服务（两种任选其一）
php think run
# 或
php -S 0.0.0.0:8000 -t public
```

队列（生码任务）需要单独启动消费者进程：

```bash
cd 5-backend
php think queue:listen --queue code_generate
```

Linux 宝塔部署队列守护（Supervisor）参考：[SUPERVISOR.md](file:///d:/66_Runinng/21-%E4%B8%80%E7%89%A9%E4%B8%80%E7%A0%81/5-backend/SUPERVISOR.md)

### 2) 管理后台（6-frontend）

环境要求：Node.js >= 20.19（项目已在 `package.json` 声明）

```bash
cd 6-frontend

pnpm install
pnpm dev
```

构建：

```bash
pnpm build          # 正式
pnpm build:staging  # 预发布（用于 OSS 子目录场景）
```

### 3) 手机端（8-uniapp，H5）

```bash
cd 8-uniapp

pnpm install
pnpm dev:h5
```

构建：

```bash
pnpm build:h5
pnpm build:h5:staging
```

## API 文档

后端支持按控制器生成 Markdown 文档，输出在 `3-接口文档/`。

```bash
cd 5-backend
php think apidoc:generate
```