QR商店 · 商家二维码管理 App

客户背景

QR商店（QR Shop Maker）是一款面向中小商家与个体店主的移动端 QR Code 工具。典型使用场景包括：门店收款码、WhatsApp 联络码、Wi-Fi 连网码、Google 评价跳转码，以及活动推广短链。

客户在立项时遇到三类痛点：

1. 换链成本高：印刷后的二维码无法修改跳转地址，每次活动都要重印物料。
2. 缺少数据闭环：只能「发码」，看不到扫码次数、时段分布与转化效果。
3. 多端交付压力：需要同时上架 iOS App Store 与 Android，并计划兼容鸿蒙，自研双端成本过高。

团队最终选用 uni-app + Vue 3 做客户端，服务端基于 XYGo Admin（GoFrame） 搭建二维码业务中台，会员认证、订阅套餐、消息推送与开放 API 统一由后台治理。

解决方案概览

┌─────────────┐     REST API      ┌──────────────────────────────┐
│  QR商店 App  │ ◄──────────────► │  XYGo Admin 后端              │
│ uni-app 跨端 │   /qrapp/*        │  · 码管理 / 模板 / 统计        │
│ iOS/Android │   /member/*       │  · 会员登录 / 订阅 / 消息      │
│  HarmonyOS  │                   │  · 短链跳转 / 扫描日志         │
└─────────────┘                   └──────────────────────────────┘

• App 端：负责扫码、建码、预览、导出与订阅购买体验。
• 中台端：负责码生命周期、动态跳转、扫描埋点、套餐权限与运营配置。
• 访客模式：未登录用户可本地建码；登录后通过 guestUuid 合并云端数据，降低首次使用门槛。

核心功能

📷 安全扫码

• 相机实时扫描 + 相册导入识别
• 安全预览：先展示链接域名与类型，用户确认后再打开，降低钓鱼风险
• 支持网页、Wi-Fi、联系人、纯文本等多种 QR 内容解析
• 扫描记录本地与云端同步，可按类型筛选检索

🎨 静态码与商家模板

• 向导式创建流程：选类型 → 填资料 → 预览 → 保存/分享
• 商家模板库：WhatsApp、网址、Wi-Fi、Google 评价等高频场景开箱即用
• 支持保存到相册、PDF 导出与多尺寸分享

🔗 动态码（核心差异化）

• 二维码图案固定，目标 URL 可随时修改，印刷物料无需更换
• 动态码列表支持启用/停用、改链、删除
• 每次扫描写入日志，首页展示「今日扫描 / 本周扫描」及环比趋势

💎 订阅与会员体系

• 对接 Apple In-App Purchase，支持 Pro 商家版套餐购买与恢复购买
• 免费版 / Pro 版配额差异化（可用码数量、高级统计等）
• 订阅状态与服务端校验联动，防止客户端伪造权限

🔔 消息与推送

• 集成 UniPush，绑定设备 CID 接收扫描周报、订阅提醒
• App 内消息中心，未读角标与已读状态同步

🌐 国际化

• 界面以繁体中文为主，English 辅助
• 模板与套餐文案按 locale 下发，便于港澳台及海外商家使用

技术架构

关键 API 设计（节选）

App 通过 /qrapp/* 命名空间与中台通信，与 XYGo 原生 /member/* 会员接口解耦：

• POST /qrapp/code/create — 创建静/动态码
• POST /qrapp/code/update-target — 动态码改链
• GET /qrapp/stats/overview — 扫描统计概览
• GET /qrapp/template/list — 商家模板（多语言）
• POST /qrapp/subscription/verify — IAP 验单

为什么选择 XYGo Admin

1. 会员体系开箱即用：登录注册、Token 刷新、头像上传、账号注销等无需从零开发。
2. Addon 扩展边界清晰：二维码业务以扩展模块交付，不污染内核升级路径。
3. 后台运营一体化：模板配置、套餐管理、扫描日志、用户列表在同一管理台完成。
4. 双库兼容：PostgreSQL / MySQL 均可部署，适配不同客户基础设施。
5. 持续迭代：跟随 XYGo 开源版在线升级，安全补丁与通用能力同步受益。

项目成果