## 项目概述

提货卡系统是一个基于微信生态的在线提货和代理商分佣平台，主要用于管理和使用提货卡，支持代理商通过推荐获得佣金，实现了从卡密生成、验证、提货到结算的完整闭环。

## 前端 H5 功能

### 1. 首页

- **卡密验证**：用户输入卡号和密码，验证卡密有效性

- **轮播图**：展示活动或产品信息，支持自动轮播

- **公告区域**：显示后台配置的公告内容

- **客服入口**：右侧悬浮客服按钮，方便用户咨询

### 2. 提货流程

- **提货详情页**：展示卡信息、商品详情、规格选择和安装须知

- **收货信息页**：填写收货人信息、选择配送方式（一次性/周期配送）、上传安装环境照片

- **支付页**：调用微信支付，完成安装费用支付

- **订单生成**：支付成功后自动生成订单，跳转至订单详情页

### 3. 订单管理

- **订单列表**：显示用户所有订单，包括待支付、待发货、已发货、已完成、已取消等状态

- **订单详情**：查看订单详情，包括物流信息和安装图片

### 4. 代理商功能（仅代理商可见）

- **卡密状态**：展示已生成卡密的使用情况（已使用/未使用/已过期）

- **佣金管理**：查看可提现佣金、佣金明细，提交提现申请

- **专属推荐码**：生成w一推荐二维码，他人通过此码提货可获得佣金

## 后台管理系统

### 1. 商品管理

- **商品 CRUD**：添加、编辑、删除商品，设置商品名称、图片、价格、规格等

- **配送设置**：设置商品是否支持周期配送

- **安装费设置**：配置商品的安装费用

### 2. 提货卡管理

- **批量生成**：批量生成提货卡，绑定商品、设置可提货次数和有效期

- **代理商绑定**：将卡密绑定给指定代理商，用于分佣锁定

- **状态监控**：实时监控卡密状态（未使用/已使用/已过期/已冻结）

- **使用记录**：查看每张卡的详细使用记录

- **导出功能**：支持将卡密导出为Excel文件

### 3. 订单管理

- **订单列表**：查看所有用户订单，支持按状态筛选

- **发货管理**：手动发货，填写物流单号

- **图片查看**：查看用户上传的安装环境照片

### 4. 代理商管理

- **代理商设置**：在用户列表中手动将普通用户设为代理商

- **佣金设置**：配置全局或商品级别的佣金比例

- **佣金明细**：查看每笔分佣的来源、金额和状态

- **提现管理**：审核代理商的提现申请，修改提现状态

### 5. 系统设置

- **微信配置**：设置公众号AppID、AppSecret、支付密钥等

- **公告管理**：配置首页公告内容

- **z低提现金额**：设置代理商提现的z低金额限制

## 核心业务逻辑

1. **卡密绑定**：一张卡密绑定一个商品和多次提货机会

2. **配送逻辑**：

   - 提货次数=1：仅支持一次性配送

   - 提货次数>1：支持一次性配送或周期配送

3. **分佣触发**：用户使用代理商绑定的卡密成功支付安装费后，自动记录分佣

4. **佣金结算**：代理商可申请提现，后台审核后完成结算

5. **关系锁定**：分佣关系以卡密生成时绑定的代理商为准

## 技术特点

- **微信生态集成**：支持微信登录、微信支付、微信地址导入

- **响应式设计**：适配各种移动设备

- **模块化架构**：前后端分离，便于维护和扩展

- **安全可靠**：使用PHP PDO进行数据库操作，防止SQL注入

- **可视化管理**：直观的后台管理界面，操作简单

## 应用场景

- **产品提货**：用户通过卡密兑换商品，如家电、家具等需要安装的产品

- **代理商分销**：通过代理商推荐，扩大产品销售范围

- **活动营销**：通过发放提货卡，吸引新用户，提高用户粘性

- **企业f利**：企业采购提货卡作为员工f利或客户礼品

提货卡系统实现了从卡密生成、验证到提货结算的完整流程，为企业提供了一个高效、可控的提货和分销管理平台。

定制看需求，一般几小时内完成，也不贵。