演示数据
演示数据让用户打开系统就能看到一个跨境卖家的完整业务。代码在 modules/ecom/demo,各功能的组成部分分布在自己的包中(如 fba/demo、owh/demo、dev/demo)。新功能上线时应同时补充演示数据。
框架
| 类 | 作用 |
|---|---|
DemoContributor | 一个组成部分(Spring Bean):order() 执行顺序、key() 日志与进度标识、generate(DemoContext) |
DemoContext | 固定种子的随机数(random()、between、chance、pick)、基准日 today()、历史天数 days()(120)、组成部分之间的共享值 put / get |
DemoKeys | 共享值的键:STORE_IDS、STORE_BY_CODE、MATERIAL_IDS、MATERIAL_BY_CODE、LISTING_IDS、LOCAL_WAREHOUSE_ID、PLATFORM_WAREHOUSE_IDS、DEFECT_WAREHOUSE_ID、CHANNEL_BY_CODE、SUPPLIER_IDS、OPERATOR_USER_IDS、ORDER_IDS;店铺编码前缀 DEMO-、物料编码前缀 DM- |
DemoDataService | 收集全部 DemoContributor,按 order 依次执行,每个在自己的事务中执行,失败只记录日志和进度、继续后面的部分;当前租户已有 DEMO- 店铺或正在生成时拒绝 |
DemoTx | 逐条处理、一条失败不影响其他的作业(审核、打单发货、退货、结算确认、回款)在独立的新事务中执行 |
DemoDataJob | 以发起人身份异步执行(@Async 传递租户),启动时自动生成也走这里 |
DemoImages | 用 Java2D 画商品示意图(渐变底 + 品类图标 + 首字母 + 品牌),走物料图片上传 |
现有组成部分
| order | key | 内容 |
|---|---|---|
| 0 | setup | 汇率、品牌与站点字典、仓库、物流渠道与费率、税率 |
| 5 | users | 3 个电商运营演示账号 |
| 10 | catalog | 物料分类、品牌、40 个商品与示意图 |
| 20 / 25 | stores / listings | 10 个店铺、在线商品与组合商品 |
| 30 / 35 / 40 | plan / purchase / inbound | 备货计划、供应商与采购、头程货件 |
| 50 / 55 | orders / order-ops | 近 120 天订单(批量写入 + 近期经规则写入)、审单打单发货各环节 |
| 60 / 65 | returns / settlements | 退货退款、结算报告与回款 |
| 70 / 80 / 90 | planning / ads / cs | 补货与预测、SP 广告、客服消息与评价 |
| 110 – 171 | publish、fba、owh、order-enhance、oper-*、productDev、adsSbSd、stockout | 刊登、FBA 运营、海外仓、订单增强、运营监控、产品开发与 1688、SB / SD 广告、断货日 |
0–99 为基础数据,由 demo 包内的基础组成部分生成;各业务功能的组成部分使用 100 及以上的 order,需要的基础数据从 DemoContext 读取或按店铺编码 DEMO- 查询,不再自己造店铺和物料。
编写一个组成部分
java
@Component
@RequiredArgsConstructor
public class FooDemoContributor implements DemoContributor {
private final FooService fooService;
@Override public int order() { return 180; }
@Override public String key() { return "foo"; }
@Override
public void generate(DemoContext ctx) {
Map<String, Long> stores = ctx.get(DemoKeys.STORE_BY_CODE);
LocalDate today = ctx.today();
for (int i = 0; i < 20; i++) {
LocalDate day = today.minusDays(ctx.between(1, ctx.days()));
// 经过所属 Service 写入,历史日期通过业务日期字段体现
fooService.create(...);
}
}
}约定:
- 业务数据尽量经过所属 Service 写入,保证库存、凭证、状态一致;历史日期用业务日期字段体现。
- 随机数一律用
ctx.random()(固定种子),保证每次生成的数据一致。 - 不调用外部接口:演示店铺、海外仓账号、1688 账号都是占位授权,海外仓账号关闭自动同步;不要生成会被定时任务外呼的「待发布」「待推送」记录。
- 数据规模参考店铺同期的订单量校准,避免比例失真(如广告销售额占比、ACOS)。
- 生成时间受测试约束:
EcomDemoDataTests在新租户中生成并检查各组成部分都没有失败、库存不为负、各页面接口都有数据,要求耗时在 6 分钟以内。
触发方式
| 方式 | 说明 |
|---|---|
./gradlew bootTestRun | 默认自动生成(LEMON_ECOM_DEMO_DATA=false 关闭) |
环境变量 LEMON_ECOM_DEMO_DATA=true | 应用启动完成后以平台租户管理员身份生成一次,已有则跳过 |
POST /ecom/demo/generate | 电商看板没有数据时的「生成演示数据」入口(ecom:demo:generate),GET /ecom/demo/status 查询进度 |