# marketing-system

**Repository Path**: elfbobo_admin_admin/marketing-system

## Basic Information

- **Project Name**: marketing-system
- **Description**: 本项目是一套线上线下一体化的私域营销系统，主打3 倍储值免单 + 共享搭档分销裂变，支持微信登录、三账户资金管理、订单退款与佣金自动回滚。包含商家 PC 后台、用户 H5 及小程序，极简操作、一键活动配置，数据大屏实时统计，兼顾门店收银与私域引流。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-04-24
- **Last Updated**: 2026-05-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Marketing System（本地运行与冒烟测试）

本仓库包含：
- `01-server-backend`：Spring Boot 后端（默认 `dev` 配置）
- `02-web-admin`：管理后台（Vite）
- `03-web-h5`：H5 用户端（Vite）

## 快速开始（本地一键冒烟）

> 目标：自动启动后端 → 等端口就绪 → 运行“免单储值”全链路冒烟（登录→免单下单→校验订单/余额/流水）。

在项目根目录执行：

```bash
PORT=18080 WAIT_SECONDS=80 ./scripts/run-smoke.sh
```

路演/联调建议用“安全模式”（不误杀端口、且保留后端进程）：

```bash
PORT=18080 KILL_PORT=0 KEEP_BACKEND=1 WAIT_SECONDS=80 ./scripts/run-smoke.sh
```

跑完看到 `PASS` 即代表链路成功。

更详细的参数、故障排查与手工验证步骤见：
- `doc/本地启动与冒烟测试使用指南.md`

## 支付回调对接（paySuccess）

后端接口：`POST /api/v1/order/paySuccess?orderNo=<订单号>`

为避免被恶意调用，回调需要 **HMAC-SHA256 签名**（无需用户 token，也不依赖管理员 token）。

- **环境变量**：
  - `PAY_CALLBACK_SECRET`：回调密钥（线上务必配置一个强密钥）
  - `PAY_CALLBACK_MAX_SKEW_SECONDS`：允许的时间偏差秒数（默认 300）

- **请求 Header**：
  - `X-Pay-Timestamp`：秒级时间戳
  - `X-Pay-Signature`：`hex(hmacSha256(secret, orderNo + "|" + timestamp))`

示例（伪代码）：

```text
timestamp = now_seconds()
sig = HMAC_SHA256_HEX(secret, orderNo + "|" + timestamp)
POST /api/v1/order/paySuccess?orderNo=ORDxxxx
  X-Pay-Timestamp: timestamp
  X-Pay-Signature: sig
```