Nexora · ERPNext Clean-room Blueprint
GreenfieldERPNext 16.282026-07-19
Greenfield product design · Legacy-aware migration

旧系统不定义新系统

从 ERPNext 和业务本质出发，重新设计一套标准核心 + 两个领域 App的产品。旧系统只负责提供数据、业务规则和审计证据，不再决定页面、仓库、组织和技术边界。
ERPNext 16.28.0 · Frappe 16.27.0 · current isolated pilot runtime verified
01

标准优先

采购、销售、库存、会计、付款、权限和工作流先用 ERPNext 原生能力。

02

领域独立

珠宝定价与原料金属结算分别进入 Jewelry App 和 Metal App。

03

旧系统降级

旧菜单、旧页面、旧仓库和旧表名只作证据，不作目标架构输入。

从头开始，不等于忘掉过去。

新系统的流程、数据模型、页面和权限从零设计；旧系统里的当前库存、余额、未完成单据、公式、状态和审计记录仍必须被识别、迁移或归档。

主方案只回答一个问题

如果今天第一次为珠宝和贵金属企业建设 ERP，基于 ERPNext，最少而正确的产品应该是什么？

SECTION 01

“从头开始”的准确边界

Clean-room 的目标不是做一个没有历史负担的演示系统，而是让未来产品不再被旧代码结构绑架。新蓝图主动忽略旧组织；迁移阶段再让真实数据和业务义务进入。

默认不继承

旧系统不能决定这些

  • 旧仓库、旧前端和 PHP/Vue/Kotlin 的代码边界。
  • Store、Customer Service、Metal 当前页面如何拆分。
  • 旧菜单数量、页面路由和“一个接口一个页面”的习惯。
  • 旧表前缀、字段拼写、aid（共享库租户标识）过滤和兼容层。
  • 现有 Platform、商城、手机与 ERP 的技术耦合方式。
  • 按客户复制代码、手工菜单和一次性数据补丁。
必须继承的事实

业务义务不能被忽略

  • 客户、供应商、商品、仓库、账户等主数据。
  • 当前库存、序列号、重量和期初余额。
  • 未完成采购、销售、退货、结算和付款单据。
  • 金价、克重、成色、工费、折足和损耗公式。
  • 应收应付、资金余额、总账和必要审计记录。
  • 用户真正依赖的审批、打印、报表与外部合同。
Clean-room 定义

先独立设计“正确的新产品”，再把旧系统逐项放到新模型旁边做 Gap Audit。旧系统只能提出约束、数据迁移和遗漏提醒，不能反向要求新系统复制它的页面、表名和组织结构。

SECTION 02

先搭标准 ERP，再分两个领域

所有企业 ERP 都先需要同一套经营骨架。珠宝和原料的差别从库存价值和结算模型开始，而不是从前端菜单开始。

CORE主数据

企业、门店、仓库、账户、客户、供应商、商品、单位与价格。

CORE采购

询价、采购订单、收货、退货、供应商应付和成本。

CORE库存

入库、出库、调拨、盘点、批次/序列号、库存估值和台账。

CORE销售

报价、销售订单、交付、发票、退货、客户应收和收款。

CORE会计与控制

总账、付款、成本中心、权限、审批、报表和审计轨迹。

标准业务核心
DOMAIN A

珠宝成品

库存围绕单件成品、款号、序列号、克重和零售价值展开。

售价 = 克重 × 金价快照 + 工费 + 石料/配件 + 附加费 - 合法抵扣
一物一码单件编码、条码/RFID、库存位置和生命周期。
珠宝计价金价、重量、纯度、工费、石料和优惠。
旧料与换新旧料验收、折价、抵扣和新旧单据关联。
服务型业务维修、定制、加工、证书和交付跟踪。
DOMAIN B

原料与贵金属

库存围绕批次、实际重量、成色、折足重量、工厂和结算展开。

折足重量 = 实际重量 × 成色；工厂结算 = 应结金额 - 已结金额 - 合法抵扣
收料与验色批次、来源、重量、成色、折足和检测结果。
提纯与损耗送厂、提纯、产出、损耗和工厂库存。
结价与结算价格锁定、应结、已结、付款和冲销。
双子账金属重量台账与资金台账必须同时守恒。
SECTION 03

新产品的最小架构

第一天只保留 ERPNext、两个领域 App 和租户 Site。任何外围系统都必须证明自身价值后才能进入；不会因为旧系统已经存在就自动被带入。

L0 · ACCESS

登录与租户入口

ERPNext 用户与角色第一阶段直接使用标准认证、Role 与 Permission。
每租户独立 Site独立数据库与用户边界，共享代码、版本和发布链。
可选 SSO只有跨产品统一入口成为明确需求时，再增加身份桥。
L1 · STANDARD

ERPNext 标准核心

主数据企业、客户、供应商、商品、仓库、账户
采购订单、收货、退货、应付
库存Stock Entry、Ledger、Serial/Batch
销售订单、交付、发票、退货、应收
会计与控制Payment、GL、成本、权限、财务报表
L2 · DOMAIN

行业能力

nexora_jewelry珠宝字段、计价、一物一码、旧料、维修定制和珠宝 POS。
nexora_metal收料、验色、折足、提纯、金属子账、结价和工厂结算。
租户配置Feature Flag、Workflow、Print Format、Role 和 Workspace；不复制 App。
L3 · OPTIONAL

后续渠道与服务

员工 App核心 Web 稳定后再评估
商城 / 小程序通过稳定 API 合同接入
客服工作台不建立第二套库存与资金账
AI 客服只做协作与工单
外部服务打印、金价、支付、物流、图片
KEY DECISION 核心决策：同一 Bench 和 App 版本管理多个独立 Site。租户差异放配置，行业差异放 App，渠道差异放 API；不再使用共享业务库里的 aid 过滤作为长期租户隔离方式。
SECTION 04

两个领域 App 应该做什么

以下是建议的领域对象，不是旧表一对一改名。每个新 DocType 必须能回答：它创造了什么新的业务事实，为什么标准 ERPNext 单据无法表达。

NEXORA_JEWELRY

珠宝领域 App

建立在 Item、Serial No、Stock Entry、Sales Invoice、POS 和 Payment Entry 之上，只补珠宝行业差异。

Metal Rate Snapshot保存生效时间、金属类型、价格来源和不可变价格快照。
Jewelry Specification克重、纯度、材质、工费、石料、证书和单件属性。
Jewelry Valuation根据价格快照与单件属性生成可审计的定价明细。
Trade-In Intake旧料验收、重量、成色、折价与新销售单抵扣关系。
Repair / Custom Order维修、定制、工序、物料、费用、预计交付和客户确认。
Jewelry POS Extension零售扫码、单件选择、珠宝定价、会员、收款与小票。
NEXORA_METAL

原料与贵金属 App

建立在 Customer/Supplier、Warehouse、Stock Entry、Payment Entry 和 GL 之上，增加金属重量与工厂结算。

Material Lot来源、批次、实际重量、成色、折足重量、当前地点与状态。
Assay Result检测方式、样品、成色、复核记录和最终采用值。
Refining Batch送厂、投入重量、产出重量、损耗、费用和工厂库存变化。
Metal Ledger Entry独立记录金属类别、实际重量和折足重量的借贷变化。
Price Fixing Contract锁价数量、价格、时点、已结与未结重量。
Factory Settlement工厂应结、抵扣、已付、未付、冲销与会计凭证关联。
单件唯一

一个序列号在任一时点只能处于一个库存位置和一个有效状态。

价格可追溯

销售金额必须能还原当时的金价、重量、工费和调整项。

重量守恒

期初 + 收入 - 发出 ± 损耗/调整 = 期末金属余额。

账务一致

业务单据、付款、应收应付、库存估值和 GL 必须可对账。

SECTION 05

第一阶段明确做什么、不做什么

Clean-room 项目最容易失败的原因，是“既然要重写，就顺便把所有外围系统一起重写”。第一阶段只验证标准 ERP 与珠宝核心是否成立。

IN SCOPE

第一阶段必须完成

形成一个能真实记账、真实扣库存、真实收款的珠宝 Web ERP，而不是菜单和原型。

独立 ERPNext SiteCompany、Fiscal Year、Currency、Warehouse、Account、Role 和权限基线。
标准采购、库存、销售和会计只做 ERPNext 原生配置，不先自建重复 DocType。
Jewelry App 最小闭环金价快照、珠宝属性、一物一码、克重计价、销售、收款、退货和旧料。
真实数据样本迁移少量主数据、库存、未完成单据和余额，用于验证模型，不追求全量。
业务与会计双重验收库存、价格、应收、收款和 GL 同时通过才算可用。
OUT OF SCOPE

第一阶段主动不做

这些能力不是永久放弃，而是不能抢在 ERP 核心之前进入热路径。

Nexora Platform 与跨产品 SSO先使用 ERPNext 用户、Site 和权限；后续确有跨产品需求再桥接。
员工 App、H5、商城和小程序Web 核心稳定后再依据正式 API 合同接入。
Customer Service 与 AI 客服不建立第二套订单、库存或资金真相。
所有旧页面逐页复刻只按业务能力和角色重建 Workspace、List、Form、Report。
全量历史数据导入先验证模型和迁移工具，再决定哪些历史进入 ERPNext、哪些只读归档。
第一阶段出口

一个隔离 Site 上，使用真实关联样本完成“商品/单件 › 入库 › 库存 › 销售 › 收款 › 会计 › 退货/旧料”的完整闭环；库存和总账可对账，且不依赖旧系统接口才能完成日常操作。

SECTION 06

从零实施路线

每阶段都先证明业务模型成立，再扩范围。工期在 Phase 0 的 Capability Register 和 Gap Matrix 完成前不承诺，避免用旧菜单数量估算新系统。

PHASE 0

第一性业务定义

不看旧页面，先定义角色、主数据、单据、状态、库存影响、资金影响、审批和报表。Hermes 负责业务模型，Hold X 只用源码/数据库核对遗漏和真实规则。

门禁每项能力有业务定义；旧系统只出现在证据栏。
PHASE 1

ERPNext 标准基线

建立 Site、Company、会计科目、仓库、商品、客户、供应商、采购、销售、库存、付款、角色和 Workflow；优先用 Desk、Workspace、List、Form 和标准报表。

门禁无自定义领域代码也能完成标准采购销售库存会计闭环。
PHASE 2

Jewelry MVP

实现金价快照、珠宝规格、单件序列号、克重定价、珠宝 POS 扩展、退货和旧料抵扣。高频操作可用 Frappe UI 做专用页面，其余继续复用 Desk。

门禁价格可回算、单件不串码、库存与 GL 对账。
PHASE 3

Jewelry 产品化

把 MVP 收敛成同一 App 的租户配置；增加维修、定制、证书、标签打印、专业报表和 Feature Flag。不同租户只配置，不建 fork。

门禁多个 Site 同一版本运行，租户差异不进入条件分叉代码。
PHASE 4

原料标准经营核心

先用标准 ERPNext 承接客户、供应商、采购、库存、销售、付款和会计；不预设旧 Store/Customer Service 页面结构。只有标准能力无法表达的差异才进入 Metal App。

门禁不写 Metal 专业代码也能完成普通经营闭环。
PHASE 5

Metal 专业域

实现 Material Lot、Assay、Refining Batch、Metal Ledger、Price Fixing 和 Factory Settlement；建立实际重量、折足重量、库存和资金四类不变量。

门禁重量、库存、应结和总账全部守恒，任一失败立即停止。
PHASE 6

迁移工具与并行对账

按主数据、余额、库存、未完单、必要历史分批迁移；所有导入幂等、可回滚、保留来源主键。新旧系统对同一业务日并行计算并解释差异。

门禁迁移可重复，差异可定位，不使用黑箱全量 dump。
PHASE 7

可选渠道与旧系统归档

ERP 核心稳定后，分别评估 SSO、员工端、商城、小程序、客服和外部服务。每条活跃调用先接到新合同，再将旧系统改为只读归档。

门禁所有新目标有真实 E2E；先接后删。
SECTION 07

旧系统只在迁移阶段出现

主蓝图完成后，旧系统才以三种身份进入：需要迁移的业务事实、需要只读保留的历史、以及确认无价值后淘汰的技术残留。

MIGRATE

进入 ERPNext

迁移后仍要参与日常经营和财务核算的数据。

  • 客户、供应商、商品、仓库、账户
  • 当前库存、序列号、批次和重量余额
  • 期初余额、应收应付和资金余额
  • 未完成采购、销售、退货、结价和结算
  • 必要的审批、状态和来源主键
ARCHIVE

只读历史库

需要查询或审计，但不值得重建业务行为的数据。

  • 已完成且不再反向影响余额的历史单据
  • 旧打印记录、操作日志和原始附件
  • 旧系统页面快照与原始接口响应证据
  • 迁移前数据库快照与字段映射
  • 新旧主键映射和差异说明
DROP

不迁移

没有真实业务价值，只会把技术债复制到新系统的内容。

  • 重复菜单、死页面和无调用接口
  • 旧前端和后端的兼容分支
  • 租户硬编码、临时表和空壳 schema
  • 测试数据、假成功合同和一次性修补脚本
  • 无法说明业务用途的孤儿字段
业务可用

真实角色能完成完整业务流，不依赖旧系统。

库存正确

数量、序列号、重量、位置和估值可对账。

资金正确

单据、付款、应收应付、余额与 GL 一致。

租户隔离

Site、用户、数据、文件和备份互不串用。

可回滚

导入、部署和配置都有可验证的恢复路径。

最终推荐

把当前“资产迁移方案”降级为旧系统附录；以本 Clean-room 蓝图作为主方案。先建立 ERPNext 标准核心和 Jewelry MVP，再验证 Metal 专业域。Platform、手机、商城、客服和其他外围系统不再默认继承，只有在核心 ERP 稳定后，经过独立价值判断才接入。

已验证起点：235 当前运行 ERPNext 16.28.0 与 Frappe 16.27.0，可作为隔离试点底座。ERPNext 标准能力参考：Item · Serial/Batch · Workflow · Quality Inspection · Subcontracting · Frappe REST API。本文不包含未经 Phase 0 验证的工期估算，也不代表任何旧系统已经迁移。