================================================================================
BSPHP — bsphp.app.demo.card（iOS 卡模式演示 App）
================================================================================

【项目简介】
演示 BSPHP 充值卡 / 卡密登录与相关接口的 iOS 应用（SwiftUI）。与后台「当前应用」的
AppEn 地址、mutualKey、RSA 密钥须一致。

--------------------------------------------------------------------------------
一、目录结构（树状，工程根即本文件所在文件夹）
--------------------------------------------------------------------------------

bsphp.app.demo.card/
├── bsphp.app.demo.card.xcodeproj/     Xcode 工程
├── bsphp.app.demo.card/               主 Target 源码
│   ├── bsphp_app_demo_cardApp.swift   App 入口
│   ├── ContentView.swift              主界面、本地 BSPHP 配置枚举 BSPHPCardConfig
│   ├── CardMainControlPanelView.swift 登录后控制台（续费/购卡链接等）
│   ├── bsphp_api_http/                HTTP 与加密封装（BSPHPClient、BSPHPCrypto）
│   ├── Assets.xcassets/               图标与颜色
│   └── Preview Content/               SwiftUI 预览资源
├── bsphp.app.demo.cardTests/          单元测试
├── bsphp.app.demo.cardUITests/        UI 测试
├── 效果图-配置说明/                   后台与界面配置示意截图（非编译资源）
├── 说明中文.txt / 说明繁体.txt / 说明英文.txt
└── （构建产物默认在 DerivedData，不在工程目录内）

--------------------------------------------------------------------------------
二、主要目录与文件说明
--------------------------------------------------------------------------------

bsphp.app.demo.card.xcodeproj/   用 Xcode 打开此工程。
bsphp.app.demo.card/             卡模式界面与 BSPHPCardConfig 配置所在。
bsphp_api_http/                  与 AppEn.php 通讯、加密协议实现。
效果图-配置说明/                 按文件名顺序查看可与后台配置步骤对照。

--------------------------------------------------------------------------------
三、配置说明
--------------------------------------------------------------------------------

1. 打开 bsphp.app.demo.card/ContentView.swift，修改私有枚举 BSPHPCardConfig：
   - url（AppEn 完整 URL）
   - mutualKey
   - serverPrivateKey、clientPublicKey（与后台同一应用配套）
2. 若涉及售卡/续费网页链接，检查 CardMainControlPanelView.swift 中 BSPHPCardSaleWeb
   的 daihao 等参数是否与后台「软件代号」一致。
3. 用 Xcode 选择主 App Scheme，运行目标为 iOS 模拟器或已签名真机。

--------------------------------------------------------------------------------
四、配置说明截图（如何「显示」图片）
--------------------------------------------------------------------------------

纯文本 .txt 无法内嵌图片。请在访达中打开本工程文件夹，按下列「相对本文件所在目录」
的路径双击 PNG，即可用「预览」或系统看图工具显示：

  效果图-配置说明/1.png
  效果图-配置说明/2.png
  效果图-配置说明/3.png
  效果图-配置说明/4.png
  效果图-配置说明/5.png
  效果图-配置说明/6.png
  效果图-配置说明/7.png
  效果图-配置说明/8.png

提示：在访达中打开「效果图-配置说明」文件夹后，可使用画廊视图逐张查看。

--------------------------------------------------------------------------------
五、构建产物位置
--------------------------------------------------------------------------------

Xcode：菜单 Product → Show Build Folder in Finder，在对应 Configuration 目录下查找 .app。

================================================================================
