yswee.common 是平台所有业务系统共用的基础能力库，不含具体业务逻辑，专门提供支付收款、微信对接、OTA 渠道、文件存储、场馆管理、幂等防重等横切关注点的统一实现，避免重复造轮子。
微信 / 支付宝 /
工行 · 分账 · 退款
小程序 + 公众号
OpenID · 订阅消息
携程 · 抖音 · 美团
核销 + 退款联通
| 1.1 支付通道 | 说明 | 适用场景 |
|---|---|---|
| 微信支付 | 原生直连，小程序支付 / 扫码支付 / 退款 | 微信小程序订单 |
| 支付宝 | 预创建（当面付/扫码付）+ 退款 | 现场 POS 扫码 |
| 聚合支付 | 统一发起收款/查询/退款，底层对接微/支/银联 | 多通道聚合 |
| 工商银行（ICBC） | 聚合支付 API、二维码、B2C 免密代扣签约 | 与工行合作的场馆 |
所有通道实现同一套接口（发起/查询/退款），业务代码无感知底层渠道
统一接收异步通知，自动更新订单状态
各通道原路退回到游客付款账户
订单金额在主商户与服务商之间按比例分配
支付证书统一托管，自动刷新，各场馆独立证书
每个场馆独立配置商户号 / 应用 ID / 商户密钥
可按场馆独立启用 / 停用任一支付通道
图形化配置：应用 ID/商户号/密钥/证书；按模块绑商户号实现分账
| 2.1 微信基础层 | 说明 |
|---|---|
| AccessToken 管理 | 自动获取并缓存，到期前自动刷新，避免限流 |
| 消息处理框架 | 责任链模式统一分发消息/事件 |
| 密码学工具 | AES 消息加解密符合微信规范 |
| OpenID 获取 | code 换 OpenID，识别游客身份基础 |
| 签名验证 | 防止消息伪造 |
| 2.2 小程序对接 | |
|---|---|
| 登录 code 换 OpenID | 自动识别游客，无需注册 |
| 获取手机号 | 一键授权微信绑定手机号 |
| 生成小程序码 | 带参数的普通码 / 无限量码 |
| 消息订阅推送 | 订单/退款/开课通知 |
| 2.3 公众号对接 | |
|---|---|
| 消息接收 | 文本/图片消息自动回复 |
| 事件处理 | 关注/取关/扫码/菜单点击 |
| 企业微信对接 | 企业级稳定方案 |
| 设置管理 | 后台页面配置参数 |
2.4 微信设置管理界面：小程序 AppID/Secret · 公众号 AppID/Secret/Token/EncodingAESKey · 消息加密方式（明文/兼容/安全）· 回调服务器地址。
| 3.1 已对接渠道 | 对接能力 |
|---|---|
| 携程旅行 | 订单验证/创建/取消/查询 · 消费核销通知 · 行程发送 |
| 抳音生活服务 | 授权凭证缓存 · 订单创建/核销/退款 · 合作商接口 · 服务管理 |
| 美团/大众点评 | 订单消费核销请求响应处理 |
| 分销商平台 | 退款事件处理（事件总线异步） |
携程 AES + 签名验证；抖音 AES 加解密；框架层统一处理
抳音授权凭证有效期管理，过期前自动续签，订单同步不中断
抳音支持调试模式，对接测试期使用固定凭证
携程/抳音 门店 ID 关联门店，配置后接收订单推送
各渠道后台设置，无需改代码切环境
A 场馆和 B 场馆的携程账号完全隔离
3.3 设置管理界面：携程账号 ID / 签名密钥 / 加密密钥 · 抳音应用 ID/密钥/门店/调试开关/乐冰雪联动 · 美团商户参数 · 分销商密钥。
3.4 功能开关：可按场馆独立启用 / 停用各 OTA 渠道。
| 4.1 身份认证（Yswee.Aliyun） | 说明 |
|---|---|
| AccessKey 直接认证 | RAM 账号 AK + SK 直接调用 |
| STS 临时凭证 | 带时效，比固定 AK 安全 |
| RAM 角色扮演（AssumeRole） | 最小权限原则，符合安全最佳实践 |
购票成功/退款/开课提醒，统一短信接口自动走阿里云，各场馆独立签名/模板
统一存取接口，各场馆独立存储空间隔离，存储介质可平滑切换
图形化配置阿里云访问密钥、存储空间，无需修改配置文件
| 5.2 文件管理功能 | 说明 |
|---|---|
| 文件上传 | 单文件/批量，文件名去重，租户隔离路径 |
| 文件下载 | 带签名临时 URL，防止直接泄露 |
| 文件删除 | 单/批量，同步清理存储和数据库 |
| 目录（容器）管理 | 按模块/租户分目录 |
| 图片处理 | 压缩、缩略图、格式转换 |
| 亿思维集成 | 松耦合业务代码 |
| 多租户隔离 | 不同场馆文件物理隔离 |
5.1 多存储后端：阿里云云存储（生产推荐，全国加速分发）/ 本地文件系统（私有化部署或开发测试）。后端配置切换，业务代码完全透明。
5.3 开放接口：上传 / 获取地址 / 删除 / 目录列表 四套统一接口，供外部系统集成调用。
| 6.1 基本信息 | 具体字段 |
|---|---|
| 基础信息 | 名称 · 电话 · 详细地址 · 城市/城市代码 |
| 地理位置 | 经度 / 纬度（地图展示与导航） |
| 营业时段 | 雪季起止 · 白天场次（起止）· 夜场（起止） |
| 内容信息 | SEO 关键词 · 简介 · 富文本详细描述 |
| 服务条款 | 用户协议文本，购票时勾选同意 |
| 内部备注 | 管理员可见 |
运营自行定义额外属性（雪道数量/最大长度/海拔），名称/类型/必填/排序
场馆指定管理员/员工；从场馆/用户双维度查询
不同业务模块（票务/租赁/教练）绑定不同商户号，自动分账
东门/西门/停车场服务中心，独立营业参数，POS 按站点统计
场馆列表 + 用户关系 Excel 导出
InventoryService 库存缓存| 价值维度 | 说明 |
|---|---|
| 多渠道收款 | 微/支//工行一套覆盖，游客用哪个付都行 |
| OTA 自动化 | 携程/抖音/美团订单自动推送，减少漏单 |
| 微信生态深度整合 | 登录 + 手机号 + 订阅消息 + 无限量码 |
| 文件统一管理 | 产品图/教练照/合同统一上传，云端 OSS |
| 防重复操作 | 幂等性保护下单/付款/退款，不会多扣款 |
| 弹性扩展 | 支付/OTA/存储按需开关，按场馆精细配置 |
| 高性能缓存 | 权限/库存走缓存，旺季不卡顿 |
| 短信通知 | 阿里云通道，购票/退款/开课自动触达 |