业务基础信息管理库

业务基础信息管理库：构建企业主数据的统一底座

在信息化建设中，企业最头疼的不是系统太少，而是系统之间各说各话——同一位客户在 CRM 里叫"张伟"，在订单系统里却叫"Zhang Wei"，部门编码更是五花八门。这些散落在各业务系统的"基础信息"，正是主数据（Master Data）的范畴。业务基础信息管理库（下称"基础库"）的作用，就是把客户、供应商、物料、部门、员工等核心主数据统一建模、集中存储、标准下发，让全公司用同一套"底数"说话。

一、基础库要解决的核心问题

1. 数据口径不一：同名不同义、同义不同名，跨系统对账困难；
2. 重复与孤岛：同一主体被多次录入，缺乏唯一标识；
3. 变更失控：部门调整、物料停用后无法追溯历史版本；
4. 权限模糊：谁能改、谁能看、改了谁负责，没有落点。

二、整体架构设计

基础库采用"单一权威源 + 版本化 + 订阅下发"的架构：

• 建模层：用元数据定义对象（客户、物料、组织等），支持扩展字段；
• 存储层：主数据表 + 变更日志表 + 版本快照表；
• 服务层：提供查询、校验、审批、同步四个核心 API；
• 消费层：通过消息或 API 向下游系统下发标准数据。

三、核心代码演示

1. 数据模型定义（Python + SQLAlchemy）

from sqlalchemy import Column, String, Integer, DateTime, JSON
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

class MasterData(Base):
    __tablename__ = "master_data"

    id = Column(Integer, primary_key=True)
    data_type = Column(String(32), nullable=False)   # 客户/物料/部门等
    code = Column(String(64), unique=True, index=True)  # 全局唯一编码
    name = Column(String(128))
    attrs = Column(JSON, default={})                 # 扩展属性
    status = Column(String(16), default="active")    # active/disabled
    version = Column(Integer, default=1)
    created_at = Column(DateTime)
    updated_at = Column(DateTime)

2. 唯一编码生成与去重校验

import hashlib

def gen_code(data_type: str, key: str) -> str:
    """基于类型+业务键生成稳定唯一编码，保证幂等录入。"""
    raw = f"{data_type}:{key}".encode("utf-8")
    digest = hashlib.sha1(raw).hexdigest()[:12]
    return f"{data_type[:3].upper()}-{digest}"

def upsert_record(session, data_type, key, attrs):
    code = gen_code(data_type, key)
    rec = session.query(MasterData).filter_by(code=code).first()
    if rec:
        rec.attrs = attrs
        rec.version += 1
    else:
        rec = MasterData(data_type=data_type, code=code,
                         name=key, attrs=attrs)
        session.add(rec)
    return rec

3. 变更审批与版本快照

def apply_change(session, rec, new_attrs, operator):
    """写入待审批变更，审批通过后更新主数据并留快照。"""
    from datetime import datetime
    # 快照旧值
    session.execute(
        "INSERT INTO master_snapshot(code, version, attrs) "
        "VALUES (:c, :v, :a)",
        {"c": rec.code, "v": rec.version,
         "a": str(rec.attrs)}
    )
    rec.attrs = new_attrs
    rec.version += 1
    rec.updated_at = datetime.now()
    # 记录操作人，满足可审计要求
    rec.attrs["last_operator"] = operator
    return rec

4. 标准下发订阅（伪代码）

def publish(session, data_type):
    changed = session.query(MasterData).filter(
        MasterData.data_type == data_type,
        MasterData.updated_at >= last_sync_time
    ).all()
    for rec in changed:
        mq.publish(topic=f"md.{data_type}", payload={
            "code": rec.code, "name": rec.name,
            "attrs": rec.attrs, "version": rec.version
        })

四、落地要点与收益

• 明确单一权威源：每条主数据只有一个"定义方"（Owner），避免多头管理；
• 建立编码规范：编码全局唯一且不可变，作为跨系统关联的主键；
• 版本与审计：任何变更留痕、可回溯，配合审批流控制质量；
• 统一下发：下游系统只消费标准数据，彻底消除口径混乱。

落地基础库后，企业通常能显著提升对账效率、减少重复录入，并为后续的 BI 报表、合规审计提供一致的数据底座。技术选型上建议轻量起步：元数据用 JSON 弹性扩展，同步优先走消息队列，审批与版本策略按对象分级配置，避免过度设计。

海量精选技术文档和实战案例持续更新，敬请关注【风骏时光少年】