fastadmin_tailored/docs/channel/平台配置系统使用说明.md

平台配置系统使用说明

系统概述

平台配置系统是一个基于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格式存储，主要包含：

{
    "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个主流平台
• 完整的配置管理功能
• 动态表单控制
• 缓存机制