Skip to content

演示数据 ​

演示数据让用户打开系统就能看到一个跨境卖家的完整业务。代码在 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 画商品示意图(渐变底 + 品类图标 + 首字母 + 品牌),走物料图片上传

现有组成部分 ​

orderkey内容
0setup汇率、品牌与站点字典、仓库、物流渠道与费率、税率
5users3 个电商运营演示账号
10catalog物料分类、品牌、40 个商品与示意图
20 / 25stores / listings10 个店铺、在线商品与组合商品
30 / 35 / 40plan / purchase / inbound备货计划、供应商与采购、头程货件
50 / 55orders / order-ops近 120 天订单(批量写入 + 近期经规则写入)、审单打单发货各环节
60 / 65returns / settlements退货退款、结算报告与回款
70 / 80 / 90planning / ads / cs补货与预测、SP 广告、客服消息与评价
110 – 171publish、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 查询进度

面向跨境电商卖家的开源 ERP · 基于 GPL-3.0 协议
联系我们:电话 17701123202 · 微信 BG7LIF · 邮箱 zmissu@163.com