禧铺 ERPNext 迁移 · 状态刷新中

禧铺迁移追踪

正在把囍铺黄金(xipu)从 xylferp_php 迁移到 ERPNext + Frappe Custom App。这份 HTML 每步完成会实时更新,你 6 小时后回来一眼看清哪些通了、哪些卡了、哪些等你决定。

目标模块
4
销售 · 会员 · 库存 · 成品
完成度
0/4
初始化中
禧铺数据量级
122
业务表 · 库存 20 万条 · 会员 2.1 万
ERPNext 版本
v16.14.0
升级 v16.28.0 后台 pull 中
正在做

初始化禧铺 site

bench new-site xipu.erpnext.local 完成 · 中文包 + 中国会计科目应用中

STEP 2 / 5 · RUNNING
§ 00 · ACCESS

访问入口

你 6 小时后来直接点这些链接。用户名 / 密码在右边。

§ 01 · MODULES

4 核心模块 · 迁移进度

每个模块含:老版子菜单数、匹配 DocType、字段对齐率、Custom App 页面完成度。差异控制在 30-40% 以内。

待启动
销售管理
7 老菜单 → ERPNext Sales
销售订单 · 商品销售 · 商品预售 · 商品回收 · 商品退货 · 线上订单 · 货品退货单
页面完成
待启动
会员管理
2 老菜单 → Customer + Call Log
会员列表 · 会员回访
页面完成
待启动
库存管理
6 老菜单 → Stock Entry + Ledger
批次查询 · 序列查询 · 调拨单 · 其它入库单 · 其它出库单 · 报表
页面完成
待启动
成品管理
15 老菜单 → Item + Purchase
采购订单 · 手动入库 · 商品管理 · 编码列表 · 简易入库 · 批量入库 · 入库订单表 · 商品调拨 · 商品分类 · 商品退库 · 工厂管理 等
页面完成
§ 02 · DATA

禧铺真实数据规模(从 xipu-mysql 直读)

初期迁移策略:主数据全量 · 交易表按 500-1000 条样本先跑通字段映射。全量待 Phase 3。

老表 (xipunum_*)业务含义行数ERPNext 目标本轮迁移
erp_shop_kucun店铺库存201,407Bin (Stock Ledger)样本 1000
erp_outbound / _order出库单 + 明细162,900 / 70,447Delivery Note样本 500
erp_shop店铺库存流水169,169Stock Ledger Entry不迁 (依生成)
erp_shoukuan收款单69,630Payment Entry样本 500
erp_retreat / _order回收单 + 明细50,943 / 40,678Purchase Receipt (旧料)样本 200
erp_stocktaking盘点单37,583Stock Reconciliation样本 100
erp_member会员~21,683Customer样本 500
erp_category商品分类全量Item Group全量
erp_lsshop店铺列表全量Warehouse全量
erp_goods (推测)商品主档~几千Item样本 1000
§ 03 · TIMELINE

执行时间线(自动刷新)

每步落 status.json · HTML 定时重生。绿点 = 完成 · 黄点 = 进行中 · 灰点 = 待做 · 红点 = 阻塞。

23:44
确认 235 现装 ERPNext v16.14.0 + Frappe v16.15.0
9 容器 up 9 days · 零业务数据
00:08
备份 mariadb + 改 compose 为 v16.28.0
/home/claw/backups/erpnext-dev/mariadb-all-20260719-0008.sql.gz · 2.1MB
00:10
docker compose pull v16.28.0 (后台)
进度 ~24MB · 网速慢 · 后台守望 · 拉完自动迁移
00:15
从 xipu-mysql 抓真实结构 · 摸清 122 表 · 206 web 菜单 · 30 手机菜单
11 顶级模块:首页/账户/成品/销售/会员/库存/资产/资金/报表/系统参数/系统配置
01:15
bench new-site xipu.erpnext.local · 中国科目 + 中文包应用中
Administrator / Xipu@2026 · 独立库 _xipu_erpnext_local
01:25
后台脚本 driver.sh 启动 · 导入主数据
分类 → Item Group · 店铺 → Warehouse · 会员样本 → Customer · 商品样本 → Item
TBD
建 Frappe Custom App · Vue 3 + Frappe UI
4 核心模块页面 · 观感对齐老 xylferp
TBD
生成新老界面对比 HTML · 交付截图
4 模块并排 · 差异 <30%
§ 04 · WAIT

待你决定(不阻塞我继续)

下面这些我先按合理默认做,你回来看不同意直接说。

  • 禧铺公司名:用「囍铺黄金」注册 ERPNext Company · 简称 XIPU · 币种 CNY · 财年 2026-01-01 → 2026-12-31 · 会计科目采用 ERPNext Standard(非中国专用会计科目,因为 China COA 需 addon 且当前 v16 支持不稳)
  • 会员迁移范围:先跑 500 条最新会员样本,验证字段映射 · 全量 2.1 万条等你拍板
  • 商品字段:金重、纯度(karat)、以旧换新价 等珠宝字段暂用 ERPNext Item Custom Field,不新建 DocType(省升级冲突)
  • Custom App 命名:xipu_desk(禧铺工作台)· 布局参考老 xylferp(左菜单树 + 顶部标签页)
  • 差异控制方式:保留老菜单 4 大顶级模块的名称和顺序 · 表单字段 80% 对齐(老有 20 字段,新有 16-24 字段都算过)