1、立项原因：游戏点卡、会员充值卡、软件激活码等虚拟商品交易量大，但很多小商家仍靠人工发卡，效率低、容易出错，卡密明文保存也有泄露风险，订单和余额对账困难。本项目旨在提供一套可独立部署的虚拟卡密商城，实现下单、支付、自动发卡的全流程自动化。
2、业务背景：面向虚拟商品卖家和代理分销商。商家可从卡卡云、卡易信等第三方货源平台对接商品并自动同步，也可手动导入卡密库存；买家注册或免登录游客下单，支付成功后系统即时发放卡密。平台同时支持会员等级差价、余额充值提现、工单售后，满足中小商家开店的完整需求。
1、商城前台：首页轮播与公告、商品分类与搜索、商品详情、购物车、在线下单、支付宝支付、游客订单查询、文章资讯、在线客服入口，支持 PC 端和移动端。
2、用户中心：注册登录、找回密码（邮箱验证码）、第三方快捷登录绑定、个人资料、我的订单与卡密查看、余额充值、余额明细、提现申请、售后工单。
3、商品与卡密管理：商品分类、商品上下架、批量导入卡密、库存自动统计、卡密加密存储、卡密状态管理（未售/已售/作废）。
4、订单与支付：订单管理、支付订单与回调日志、支付渠道配置、余额支付、自动发卡、发货邮件通知。
5、会员体系：用户管理、用户等级与等级价格、余额调整、充值与提现审核。
6、第三方货源对接：对接多家卡密货源平台，配置同步任务，定时自动同步商品与价格，查看同步日志，自动下架失效商品。
7、系统设置：站点设置、轮播图、公告、客服配置、邮件通知配置、快捷登录配置、管理员操作日志、数据看板（销售额、订单量等统计图表）。
1、本人负责：独立完成项目的需求分析、数据库设计、后端全部接口开发、前端页面开发和服务器部署上线。
2、技术架构：前后端分离。后端基于 JDK17 + Spring Boot 3 + MyBatis-Plus + MySQL + Redis，Spring Security + JWT 做认证和权限控制；前端基于 Vue3 + TypeScript + Vite + Element Plus + Pinia，ECharts 实现数据看板。项目通过宝塔面板部署在 Linux 服务器上。
3、实现亮点与难点：
（1）资金与库存一致性：下单扣库存、余额扣减、充值入账都放在数据库事务中，使用条件原子更新（如 balance = balance - x 且校验余额充足），避免并发下出现超卖和余额扣成负数；每笔余额变动都写入流水，方便对账。
（2）支付安全：对接支付宝支付，异步回调时验签并做幂等处理，防止重复发货，所有回调都记录日志以便排查。
（3）卡密安全：卡密使用 AES 加密后入库，只有订单所属用户能解密查看；数据库、JWT、AES、支付等密钥都通过环境变量配置，不写入代码仓库。
（4）第三方货源同步：抽象统一的货源客户端接口，接入卡卡云、卡易信、小储云等多个平台，通过定时任务扫描执行同步任务，失败自动记录日志并下架失效商品。
（5）其他：Redis 存储验证码并限制发送频率，登录失败次数限制防暴力破解；邮件通知使用异步线程池发送，不阻塞下单主流程；后台针对移动端单独适配，手机上也能管理订单。
评论