# 平台配置系统使用说明

## 系统概述

平台配置系统是一个基于FastAdmin框架的多平台电商配置管理系统，支持以下平台：

- 微信小程序 (WechatMiniProgram)
- 抖音小程序 (DouyinMiniProgram)
- QQ小程序 (QQMiniProgram)
- 支付宝小程序 (AlipayMiniProgram)
- 微信公众号 (WechatOfficialAccount)
- 手机H5 (H5)
- PC商城 (PC)
- 移动APP (App)

## 功能特性

### 1. 平台状态管理
- 开启/关闭平台功能
- 实时状态显示
- 平台状态统计

### 2. 支付配置
- 支持多种支付方式：微信支付、支付宝、余额支付、货到付款
- 支付方式选择器（selectpage）
- 支付配置管理

### 3. 平台基本设置
- AppID/AppSecret配置
- 平台特定配置项
- 配置验证

### 4. 登录设置
- 自动登录开关
- 手机号绑定设置
- 平台差异化登录配置

### 5. 分享设置
- 分享方式选择：直接转发、分享海报、复制链接
- 分享内容配置
- 海报背景设置

### 6. APP特殊配置
- Android/iOS下载地址
- 本地下载地址

## 文件结构

```
application/
├── admin/
│   ├── controller/shop/
│   │   └── Platform.php                    # 平台配置控制器
│   └── view/shop/platform/
│       ├── index.html                      # 平台列表页面
│       └── config.html                     # 平台配置页面
├── common/
│   ├── model/
│   │   └── ShopConfig.php                  # 配置模型
│   └── Service/
│       └── ShopConfigService.php           # 配置服务类
public/assets/js/backend/shop/
└── platform.js                            # 前端JS逻辑
```

## 使用方法

### 1. 访问平台管理页面
在FastAdmin后台导航至：`商城管理` -> `平台配置`

### 2. 配置平台
1. 在平台列表中点击相应平台的"管理"按钮
2. 在弹出的配置页面中填写相应配置信息
3. 点击"保存配置"按钮保存设置

### 3. 配置项说明

#### 基本状态
- **开启状态**: 控制平台是否启用

#### 支付配置
- **支付方式**: 选择支持的支付方式
- **微信支付**: 选择微信支付配置（需要先在支付配置中添加）
- **支付宝**: 选择支付宝配置（需要先在支付配置中添加）

#### 平台设置
- **AppID**: 平台应用ID（必填）
- **AppSecret**: 平台应用密钥（除H5外必填）

#### 登录设置
- **自动登录**: 是否开启自动登录
- **绑定手机号**: 是否强制绑定手机号

#### 分享设置
- **分享方式**: 选择支持的分享方式
- **分享内容**: 配置分享标题、副标题、图片等
- **分享链接**: 配置分享域名

## 技术特性

### 1. 动态显示控制
使用FastAdmin的动态显示功能，根据选择的配置项自动显示/隐藏相关配置。

### 2. 数据缓存
- 自动缓存配置数据
- 配置更新时自动刷新缓存

### 3. 表单验证
- 必填项验证
- 数据格式验证
- 平台特定验证

### 4. 图片上传
- 集成FastAdmin图片选择器
- 支持分享图片、海报背景等上传

## API接口

### 1. 获取平台状态
```
GET /admin/shop/platform/index
```

### 2. 获取平台配置
```
GET /admin/shop/platform/platform/{platform}
```

### 3. 保存平台配置
```
POST /admin/shop/platform/platform/{platform}
```

## 配置数据结构

配置数据以JSON格式存储，主要包含：

```json
{
    "status": "1",
    "app_id": "your_app_id",
    "secret": "your_app_secret",
    "auto_login": "1",
    "bind_mobile": "1",
    "payment": {
        "methods": ["wechat", "alipay", "money"],
        "wechat": "1",
        "alipay": "2"
    },
    "share": {
        "methods": ["poster", "link"],
        "linkAddress": "https://your-domain.com",
        "forwardInfo": {
            "title": "分享标题",
            "subtitle": "分享副标题",
            "image": "/uploads/share.png"
        },
        "posterInfo": {
            "user_bg": "/uploads/user_bg.png",
            "goods_bg": "/uploads/goods_bg.png",
            "groupon_bg": "/uploads/groupon_bg.png"
        }
    },
    "download": {
        "android": "https://download.com/app.apk",
        "ios": "https://apps.apple.com/app/id123456",
        "local": "https://your-domain.com/download"
    }
}
```

## 注意事项

1. **数据库依赖**: 系统依赖`fa_shop_config`表，请确保已正确创建
2. **缓存管理**: 配置更新后会自动清理相关缓存
3. **权限控制**: 需要相应的后台权限才能访问配置页面
4. **平台验证**: 系统会验证平台代码的有效性
5. **必填项检查**: 各平台的必填项需要正确填写

## 扩展开发

### 1. 添加新平台
1. 在`$supportedPlatforms`数组中添加新平台代码
2. 在`config.html`中添加平台特定的配置项
3. 在`platform.js`中添加相应的逻辑处理

### 2. 添加新配置项
1. 在`config.html`中添加表单项
2. 在`platform.js`中添加相应的显示/隐藏逻辑
3. 在服务类中添加相应的验证逻辑

### 3. 自定义验证
在`Platform.php`控制器中添加自定义验证逻辑。

## 故障排除

### 1. 配置无法保存
- 检查数据库连接
- 检查表结构是否正确
- 检查权限设置

### 2. 页面无法加载
- 检查路由配置
- 检查JS文件是否正确加载
- 检查浏览器控制台错误

### 3. 图片上传失败
- 检查上传目录权限
- 检查文件大小限制
- 检查文件类型限制

## 更新日志

### v1.0.0
- 初始版本发布
- 支持8个主流平台
- 完整的配置管理功能
- 动态表单控制
- 缓存机制