飞鱼小铺 

飞鱼小铺 是一个专为独立开发者、小团队及数字产品创作者设计的开源交易与自动化交付平台。它不仅仅是一个电商前台，更是一套完整的后端基础设施，涵盖了从商品展示、多币种定价、支付接入到 Git 仓库权限开通、数字文件分发的全链路自动化流程。

该系统基于 Spring Boot 和 Vue 3 构建，支持 Docker 一键部署，并提供了独立的认证服务以实现登录态共享，是构建“代码即商品”或“服务即订阅”商业模式的理想基石。

核心功能模块

🛒 商品与营销管理

• 灵活的商品模型：支持商品分组、搜索、推荐、置顶及排序，适配复杂的数字产品结构。
• 多语言与多币种：原生支持人民币 (CNY) 和美元 (USD) 定价展示，内置多语言内容管理，方便全球化销售。
• 营销工具：内置 SKU 管理、优惠券系统、合同确认流程以及“打赏”功能，增强用户互动与转化。

💳 订单与支付集成

• 主流支付接入：深度集成 Stripe Checkout（国际信用卡）和 H5 支付（国内移动支付），支持回调验签与幂等处理，确保交易安全。
• 完整订单流：涵盖下单、试算、合同签署、支付状态同步及失败重试机制。

🚀 自动化交付引擎

这是飞鱼小铺的核心竞争力，旨在解决数字产品交付的“最后一公里”问题：

• Git 仓库自动开通：支持与 GitHub、Gitea、Gitee 对接，用户支付成功后自动邀请其加入私有仓库或授予访问权限。
• 数字文件分发：支持加密链接下载、通用授权扩展生成。
• 任务重试机制：针对网络波动或 API 限流导致的交付失败，提供任务级原因分析与自动重试续跑能力。

🔐 统一认证与安全

• 独立 Auth 服务：采用独立的认证微服务，通过 JWT 实现飞鱼小铺与飞鱼低代码平台之间的登录态共享。
• 多渠道登录：支持邮箱 Magic Link、GitHub/Gitee/Gitea OAuth、Google、Microsoft 以及微信公众号授权登录。

🛠️ 运营与客服工作台

• 全能管理后台：集成商品管理、订单查询、合同存档、仓库权限管理及工单系统。
• 实时客服：基于 WebSocket 的在线客服系统，支持通知推送与公众号动态同步。

技术架构与工程交付

• 后端：Spring Boot 多模块架构，支持 GraalVM Native 编译以提升启动速度和降低内存占用。
• 前端：Vue 3 单页应用 (SPA)，响应式设计。
• 数据库：支持 MySQL（生产环境）和 H2（开发/测试环境）。
• 部署：提供标准的 Docker Compose 编排文件及 Nginx 配置示例，实现快速落地。

开源边界与安全说明

飞鱼小铺遵循严格的开源边界审计原则，确保核心业务逻辑公开透明的同时，保护商业敏感信息：

1. 包含内容：完整的商品、订单、支付接入、合同、客服、仓库交付及任务重试业务代码；飞鱼低代码平台的最小运行实例。
2. 不包含内容：商业授权签发算法、根密钥材料、专有签发协议、生产环境配置及内部运维数据。
3. 安全配置：所有外部依赖（如 Git 平台、支付网关、邮件服务、公众号）默认处于关闭或未配置状态，必须通过环境变量显式启用，防止误操作泄露密钥。
4. 扩展性：若需接入自有授权系统，开发者可在私有模块中实现 ExternalLicenseIssuer 接口并通过 Spring Bean 注入，无需修改核心源码，确保密钥安全隔离。

适用场景

• 独立开发者：销售源码、插件、电子书或 SaaS 订阅服务。
• 开源项目商业化：为开源软件提供企业版授权、私有仓库访问权或高级技术支持的自动化售卖。
• 数字内容创作者：分发课程资料、设计素材或专属社群资格。
• 小型技术团队：构建内部工具市场或对外提供 API 服务的计费与交付平台。