# qData-mdm
**Repository Path**: qiantongtech/qData-mdm
## Basic Information
- **Project Name**: qData-mdm
- **Description**: qData-mdm 主数据平台是一套集主数据建模、主数据维护、主数据采集、主数据分发与主数据质量治理于一体的企业级主数据管理平台，致力于帮助企业建立统一的主数据标准、规范主数据维护流程、打通主数据上下游链路，并实现主数据的集中管理、可靠共享与持续治理。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: develop
- **Homepage**: https://qdata.qiantong.tech
- **GVP Project**: No
## Statistics
- **Stars**: 18
- **Forks**: 8
- **Created**: 2026-04-14
- **Last Updated**: 2026-04-21
## Categories & Tags
**Categories**: Uncategorized
**Tags**: 主数据平台, 数据治理, 数据中台, qData, 主数据管理
## README
📖简体中文 | 📖English
## 🌈 平台简介
**qData-mdm 主数据平台**是一套聚焦**主数据建模**、**主数据维护**、**主数据采集**、**主数据分发**与**主数据质量治理**的主数据管理平台，致力于帮助企业建立统一的主数据标准、维护流程和数据共享机制。包含系统管理、基础建模、维护、采集、分发和质量治理等功能。
✨✨✨**在线文档**✨✨✨ https://qdata.qiantong.tech
> 如果 qData-mdm 对您有帮助，请点个 **Star ⭐️**，这是我们持续更新的动力！ 🚀
## 🍱 使用场景
适用于需要统一主数据标准、规范主数据维护流程、建立主数据共享机制的企业、集团与政企组织。
| 场景 | 描述 | 典型客户类型 |
| ----------- | ----------------------------- | ------------------ |
| **主数据标准建模** | 需要统一定义组织、客户、供应商、物料、产品等主数据模型，形成标准化的数据结构。 | 集团企业、制造企业、国企平台 |
| **主数据集中维护** | 需要建立主数据新建、变更、冻结、解冻、失效等统一维护机制，避免多系统各自维护。 | 中大型企业、共享服务中心 |
| **主数据采集同步** | 需要从业务系统采集主数据，进行基础同步、入库和核查，形成统一主数据底座。 | 制造企业、政务平台、信息化项目 |
| **主数据分发共享** | 需要将统一主数据分发到 ERP、HR、财务、门户等下游系统，减少口径不一致问题。 | 集团企业、政企单位、行业平台 |
| **主数据质量治理** | 需要对主数据进行基础规则校验、任务执行和结果追踪，提升主数据准确性与可用性。 | 数据治理团队、信息中心、运维团队 |
## 💡 优势
| 优势点 | 描述 |
| ------------- | ------------------------------ |
| **主数据功能覆盖完整** | 围绕“建模、维护、采集、分发、质量”提供主数据平台基础功能，满足常见主数据管理场景。 |
| **基础能力清晰** | 覆盖系统管理、主数据建模、维护、采集、分发和质量治理等主要模块，能力边界清晰。 |
| **建模维护一体化** | 主数据建模与主数据维护能力协同设计，便于模型定义直接服务后续维护与共享使用。 |
| **分类、实体、字典协同** | 支持主题管理、实体模型、分类模型、数据字典等主数据基础建模能力，满足常见主数据设计场景。 |
| **采集与分发能力** | 提供基础采集任务、采集实例、手动全量分发和分发监控能力，便于打通主数据上下游链路。 |
| **质量治理能力** | 提供基础质量规则、简单质量任务、任务实例和质量日志能力，支持常见主数据质量检查场景。 |
| **支持多种部署方式** | 支持源码启动和 Docker 方式部署，便于不同环境下安装、联调和使用。 |
## 📋 功能清单
| 模块 | 描述 |
|------|------|
| 主题管理 | 提供主数据模型主题目录树维护能力，支持按业务域、项目或组织维度挂载与调整主题节点，便于对模型资产分层归类、统一检索入口与权限边界。适用于多业务线并行建模时，**先定主题再挂模型**，避免模型散落、难以治理的问题。 |
| 实体模型 | 覆盖实体模型的创建与维护、字段定义与约束、实体间基础关联配置，以及版本管理与发布流程；可基于模型生成物理表结构，并配套基础查询/维护类接口能力，支持按业务规则配置主数据编码生成策略。适用于客户、供应商、物料、组织等主数据的**统一建模与对外服务**。 |
| 分类模型 | 在分类模型下维护层级结构（如品类树、组织树），内置系统保留字段并支持扩展自定义字段；支持单表方式维护层级数据、版本发布及基础接口输出，并可配置分类侧编码规则。适用于需要**树形主数据**、且要与实体主数据关联分类维度的场景。 |
| 数据字典 | 提供字典类型与字典项的维护、字段级配置、发布与修订记录，支持字典数据的批量维护、导入与导出，便于与实体/分类模型中的下拉、枚举类字段联动。适用于行业码表、内部标准码、状态码等通用参照数据的**集中管理**。 |
| 主数据查询 | 按已发布模型提供列表检索、条件过滤与明细查看，分类模型场景下支持左侧分类树与右侧数据**联动检索**，快速定位已生效主数据。适用于业务人员日常查数、核对口径及跨部门协同前的数据确认。 |
| 主数据新建 | 基于模型动态表单发起新增，支持必填校验、字段联动展示及**暂存—提交**流程，提交后进入平台既定的新建与生效链路。适用于一线录入、补录入口统一收口，减少各业务系统重复建数、口径不一致的问题。 |
| 主数据变更 | 支持对已有主数据的修改，以及**冻结、解冻、失效**等状态类操作，覆盖主数据在生命周期内的常见状态流转，变更过程可追溯。适用于主数据纠错、业务暂停/恢复、下线清理等运维与业务协同场景。 |
| 数据源管理 | 维护异构数据源连接信息，支持连接参数配置、连通性测试及数据源级挂载路径或目录管理，为后续采集任务提供**统一来源台账**。适用于梳理「数据从哪来」、降低采集配置时的重复录入与连接错误。 |
| 采集任务 | 支持配置来源库表/映射关系与执行策略，可发起**全量与简单增量**同步，将外部系统主数据拉取并落入平台模型。适用于从 ERP、CRM、自建库等系统批量同步主数据，形成统一主数据底座。 |
| 采集实例 | 每次任务运行生成独立采集实例，记录起止时间、执行状态、数据量与异常摘要等信息，支持**按实例回溯**一次完整同步过程。适用于运维排障、对账核对及确认某次同步是否成功完成。 |
| 采集日志 | 提供采集过程与结果的**日志查询**能力，可查看错误明细、重试建议等相关信息，支撑日常监控与问题定位。适用于采集链路不稳定时的快速诊断与审计留痕。 |
| 应用管理 | 维护主数据**分发目标应用**档案，登记地址、认证或连接参数，并支持可用性检测，形成下游系统台账。适用于管理，为分发配置与监控提供统一主数据消费方视图。 |
| 分发配置 | 按模型或数据范围配置向目标应用的分发任务，支持**手动触发全量分发**，将平台侧主数据按需推送到下游。适用于项目上线割接、下游系统重建库表或定期全量对齐等场景。 |
| 分发监控 | 查看分发批次/明细的执行结果，支持失败记录查看与**失败重发**等操作，形成「发现异常—处理—再验证」的闭环。适用于保障主数据出口链路稳定、减少静默失败。 |
| 质量规则 | 维护面向主数据的基础质量规则（如非空、格式、取值范围、与字典一致性等），为后续校验提供**可复用规则资产**。适用于在入库或定期巡检前统一约定数据合格标准。 |
| 质量任务 | 将规则组合为可执行的质量任务，支持按模型或数据范围配置并**手动/周期触发**执行，用于批量校验主数据。适用于定期质量巡检、大促/月结前的数据摸底。 |
| 质量任务实例 | 每次质量任务运行对应一个实例，展示执行进度、**通过/失败统计**及结果概要，便于对比多次运行效果。适用于跟踪一次质量检查是否跑完、结果是否可发布给业务方。 |
| 质量日志 | 提供质量校验**明细日志**查询，支持按规则、对象、时间等维度筛选，定位不合格记录与原因。适用于治理团队审计、业务整改清单输出及与责任系统对账。 |
👉 qData-mdm 开源版围绕主数据场景提供能力，功能将持续迭代完善。
💡 如您有好的建议或功能需求，欢迎 [提交Issue](https://gitee.com/qiantongtech/qData/issues)，与我们共同完善主数据平台功能。
[//]: # (## 🧩 架构图)
[//]: # ()
## 🛠️ 技术栈
qData-mdm 平台采用前后端分离架构，后端基于 Spring Boot，前端基于 Vue 3，并整合了主流的认证、数据库访问、缓存与前端组件能力。
| 分类 | 技术 | 描述 |
| 后端技术栈 | Spring Boot | 提供快速开发能力与统一服务启动入口 |
| Spring Security | 实现用户认证、授权与安全控制 |
| MySQL、达梦8 | 持久化存储与数据源配置管理 |
| MyBatis-Plus | 简化数据库操作与多数据源访问 |
| Redis | 支持缓存、登录态与基础中间件能力 |
| Knife4j / OpenAPI | 提供接口文档展示与联调支持 |
| 前端技术栈 | Vue 3 | 现代化响应式前端框架 |
| Element Plus | 常用 UI 组件支持与后台管理界面构建 |
| Vite | 快速开发与构建工具 |
| 第三方插件 | AntV X6 | 支撑流程、图形化设计与可视化交互场景 |
| ECharts | 支撑统计图表与可视化展示能力 |
## 🏗️ 部署要求
在部署 qData-mdm 之前，请确保以下环境和工具已正确安装：
| 环境 | 项目 | 推荐版本 | 说明 |
| 后端 | JDK | 1.8 或以上 | 建议使用 OpenJDK 8 |
| Maven | 3.6+ | 项目构建与依赖管理 |
| 达梦8 / MySQL | 8.0+ | 关系型数据库环境，开发配置默认偏向达梦8 |
| Redis | 5.0+ | 缓存与登录态等基础能力支持 |
| Docker / Docker Compose | 可选 | 用于快速体验和测试环境部署 |
| 操作系统 | Windows / Linux / Mac | 通用环境均可运行 |
| 前端 | Node.js | 16+ | 前端构建工具依赖 |
| npm | 8+ | 包管理器 |
| Chrome / Edge | 最新版 | 推荐用于本地调试与系统访问 |
[//]: # (## 🚨 商用授权)
[//]: # ()
[//]: # (qData-mdm 提供 **专业版** 与 **开源版** 两种形态，满足不同规模与场景下的用户需求。开源版提供系统管理、主数据建模、维护、采集、分发和质量治理等基础功能；专业版则面向更复杂的企业级场景，提供组合模型、订阅体系、实时分发、整改处理、复杂审批与更完整的治理保障。)
[//]: # ()
[//]: # (👉 如需 **开源版品牌授权** 或 **咨询专业版**，请点击按钮查看详情：[💼 了解授权详情](https://qdata.qiantong.tech/business/policy.html))
[//]: # (## 🚀 快速开始)
[//]: # ()
[//]: # (| 部署方式 | 说明 | 适用场景 |)
[//]: # (| ----------------------- | --------------------------------------------------------------- | ------------------ |)
[//]: # (| Docker Compose 体验部署 | 通过 `docker/` 目录中的编排文件快速启动数据库、Redis、Nginx 与后端服务，适合先体验主数据平台开源版功能。 | **初学者快速上手**、功能演示、测试环境 |)
[//]: # (| 使用源代码本地启动 | 后端可通过 `mvn -pl qData-mdm-server -am spring-boot:run` 启动，前端在 `qData-mdm-ui` 下执行 `npm install` 和 `npm run dev`。 | **日常开发**、功能联调 |)
[//]: # (| 自主部署（纯手工安装） | 根据 `application-dev.yml` / `application-prod.yml`、数据库初始化脚本和前端构建产物，手工完成部署与参数配置。 | **生产环境**、大规模部署、个性化定制场景 |)
[//]: # ()
[//]: # (👉 查看完整的安装与部署资料时，建议结合 `docker/`、`qData-mdm-server/src/main/resources/`、`sql/` 目录与官方文档一并使用。)
## 👥 QQ交流群
欢迎加入 qData 官方 QQ 交流群，获取最新动态、技术支持与使用交流。
👉 点击加入 QQ 交流群
## 🖼️ 系统配图
