Skip to Content
金蝶与旺店通协同方案配置动态调整

概述

管理后台为 6 大配置类型提供统一的在线 CRUD 管理界面。配置变更经审批后即时生效，无需重新部署服务，同步引擎自动加载最新配置。

管理后台架构

系统架构

Rendering diagram…

技术栈

层级技术选型说明
前端Next.js + Tailwind CSS基于 shadcn/ui 组件库的管理界面
后端 APINext.js API RoutesRESTful 接口，Zod 校验
数据库SQLite + Drizzle ORM轻量级文件数据库，单机部署零运维
认证Better AuthSession-based 认证，RBAC 角色控制
表格组件TanStack Table v8排序、筛选、分页、搜索

管理后台与同步引擎共享同一个配置数据库。管理后台是配置的 CRUD 入口，同步引擎是配置的消费者。两者解耦，管理后台的变更通过缓存刷新机制传递给同步引擎。

配置管理界面

统一 CRUD 界面设计

6 大配置类型共用同一套界面模式，降低学习成本：

视图功能说明
列表视图排序 / 筛选 / 分页 / 搜索TanStack Table 组件，每页 20 条，支持列排序和模糊搜索
详情弹窗JSON 预览 + 结构化表单双视图切换：技术视图（原始 JSON）和业务视图（友好表单）
创建/编辑表单 + 实时校验React Hook Form + Zod，字段级错误提示
删除确认弹窗 + 影响提示显示该配置被引用的业务流数量，防止误删

界面结构

Rendering diagram…

6 大配置类型管理界面

组织配置

操作界面要素
列表组织编码、名称、金蝶账套、旺店通店铺 ID、状态（启用/停用/暂停）
新增组织编码（不可重复）、名称、金蝶账套编码、金蝶凭证（加密输入）、旺店通店铺 ID
编辑除组织编码外均可修改；修改凭证需二次确认
停用显示该组织下所有关联配置（路由、表单、映射），确认后批量停用

路由配置

操作界面要素
列表路由 ID、客户主体值、目标组织、优先级、状态
新增客户主体值、目标组织（下拉选择已有组织）、优先级
排序拖拽调整优先级顺序，或手动输入数字

表单配置

操作界面要素
列表组织编码、业务类型、源系统、formId、操作类型、状态
新增选择组织 → 选择业务类型 → 选择源系统 → 填写 formId → 选择操作类型
复制从已有组织复制全部表单配置到新组织，支持逐条微调

字段映射配置

操作界面要素
列表映射规则 ID、业务类型、源字段路径、目标字段路径、转换规则
新增选择业务类型 → 填写源字段路径 → 填写目标字段路径 → 选择转换规则 → 填写转换参数
测试内置字段映射测试器：输入源数据 JSON，实时预览转换结果

状态映射配置

操作界面要素
列表系统（金蝶/旺店通）、状态码、业务含义、是否触发回传
新增选择系统 → 填写状态码 → 填写业务含义 → 设置是否触发回传

仓库货品映射

操作界面要素
列表映射类型（仓库/货品）、金蝶编码、旺店通编码、状态
批量导入CSV 文件上传，格式：mapping_type,kingdee_code,kingdee_name,wdt_code,wdt_name
批量导出导出当前映射表为 CSV 或 JSON 文件

变更审批流

三级审批策略

根据配置变更的风险等级，系统采用不同的审批策略：

风险等级变更类型审批要求操作者
低风险新增映射条目、修改常量值操作员直接生效，无需审批operator 及以上
中风险修改字段映射、调整路由规则、修改状态码映射需管理员审批operator 发起，admin 审批
高风险停用组织、删除配置、修改金蝶凭证管理员操作 + 二次密码确认仅 admin

停用组织会立即暂停该组织下所有业务流。建议在业务低峰期（夜间或周末）执行，并在操作前检查同步日志确认无正在处理的单据。

审批状态机

Rendering diagram…

审批流程说明

  1. 操作员发起变更：编辑配置后提交，系统根据变更类型自动判定风险等级
  2. 低风险直接生效：变更写入数据库，触发缓存刷新，同步引擎加载新配置
  3. 中风险等待审批：变更进入「待审批」状态，管理员在审批列表中查看变更详情（含修改前后对比），批准或拒绝
  4. 高风险二次确认：管理员操作时弹出确认框，需输入当前密码后方可执行

即时生效机制

配置刷新流程

Rendering diagram…

关键指标

指标目标值说明
缓存刷新延迟< 5 秒从配置写入到同步引擎加载新配置的时间
业务中断0刷新期间使用旧配置继续处理，不中断正在执行的业务流
回滚时间< 10 秒通过审计日志回滚到任意历史版本

批量操作与导入导出

批量操作

在列表视图中勾选多条记录后，可执行以下批量操作：

操作适用配置类型说明
批量启用全部将选中的配置状态改为 active
批量停用全部将选中的配置状态改为 inactive
批量删除路由、映射批量删除选中的配置（高风险，需审批）

CSV 导入导出

导出格式示例（仓库映射）：

mapping_type,kingdee_code,kingdee_name,wdt_code,wdt_name,status
warehouse,CK001,华东总仓,WH_EAST_01,华东总仓,active
warehouse,CK002,华南总仓,WH_SOUTH_01,华南总仓,active
product,MAT001,巧克力礼盒 A,SKU_CHOC_001,巧克力礼盒 A,active
product,MAT002,坚果礼盒 B,SKU_NUT_002,坚果礼盒 B,active

导入规则：

  • 按 mapping_type + kingdee_code + wdt_code 去重，已存在的记录自动更新
  • 导入前预览变更数量（新增 N 条、更新 M 条、跳过 K 条）
  • 导入失败时事务回滚，不会产生部分更新的中间状态

配置模板复制

新增目标组织时，可从已有组织复制配置模板：

01
选择模板组织

在「组织配置」页面点击「从模板复制」，选择一个已有组织作为模板来源。

02
选择复制范围

勾选需要复制的配置类型：表单配置、字段映射、状态映射、仓库货品映射。路由配置不复制（因路由规则与客户主体绑定）。

03
预览并确认

系统展示即将复制的配置条目列表，逐条检查后确认。复制后的配置默认为「草稿」状态，需逐条审核后启用。

最后更新
权限与角色管理监控与日志看板