距离 618 不远了。

对开发者来说，这段时间往往会收到同一类需求：

• 做个查券/导购工具，能不能快一点上线？

• H5 页面先跑起来，后端 API 后续慢慢扩展行不行？

• 先做 MVP，后面再二开成自己的私域返利助手。

如果每次都从零手撸，最痛苦的不是页面，而是底层这几件事：

• 接口组织和模块扩展没边界，越写越乱

• API 复用性差，后期迭代容易牵一发而动全身

• 一开始就被基础设施拖住节奏，错过业务窗口期

项目定位：xc-union 是什么？

xc-union 是一个面向私域场景的开源导购平台基础工程，聚焦三件事：

1. 快速搭建

2. 开箱即用

3. 可持续二开

仓库当前采用前后端分层结构：

• xc-union-backend/：Maven 后端聚合工程

  • xc-union-client-service（核心服务）

  • xc-union-admin-service（管理端服务骨架）

  • xc-union-job-service（任务服务骨架）

• xc-union-ui/：前端聚合目录

  • xc-union-client-ui（已实现多业务页面）

  • xc-union-admin-ui（占位，便于后续扩展）

2.0 阶段做了什么（基于当前代码真实状态）

这次升级的重点，不是“堆功能”，而是把工程底座拉齐：

1) 工程结构标准化

• 后端/前端分组清晰（xc-union-backend + xc-union-ui）

• 子模块 README 已补齐，开源协作可读性明显提升

2) 后端核心服务可运行

xc-union-client-service 已具备可启动的服务骨架，基于：

• JFinal + Undertow

• lite-api-core

• 动态 API 路由机制

并接入了大淘客模块（dtk）作为实际业务调用示例。

3) 前端场景页面已落地

H5 侧已经有完整业务页面素材和实现，包括：

• 首页、品牌特卖、天猫国际、天猫超市、秒杀、好价

• 足迹、活动奖励、订单、商品详情、口令拷贝、登录

这意味着你可以直接拿它做 UI 基线，然后专注改业务和运营策略

H5 页面预览

为什么它适合“618 前快速起盘”？

1) 能先跑起来，再按业务演进

相比“大而全系统”，xc-union 的价值是： 先把主链路跑通，再按你自己的私域模型扩展。

2) API 底座已经预留

系统已预留完整底层 API 扩展思路，适合做：

• 自定义返利逻辑

• 多渠道分发

• 二次封装成你自己的业务接口层

快速体验

http://demoeg.com:28090/ui/index.html

写在最后

在 618 备战窗口，把工具提前准备好，往往比临时补火更关键。

如果你正在找一个可以快速落地、又保留二开空间的返利底座，xc-union 可以作为一个很务实的起点。欢迎你直接拉代码试跑，按自己的业务模型继续扩展。

项目与交流

• 项目地址：https://gitee.com/xc_java/xc-union

• 技术答疑： https://gitee.com/xc_java/xc-union/issues