📖简体中文 | 📖English
## 🌈 平台简介 **qData 数据资产管理平台**提供**系统管理**、**资产目录与标签**、**元数据采集与管理**、**数据服务（API）开放**以及**资源门户相关能力**，围绕库表类数据资产支持登记、分类、检索、服务封装与对外发布等基础能力。完成元数据侧连通与采集闭环。 ✨✨✨**在线文档**✨✨✨ https://qdata.qiantong.tech > 如果 qData 数据资产管理平台对您有帮助，请点个 **Star ⭐️**，这是我们持续更新的动力！ 🚀 ## 🍱 使用场景 适用于需要集中维护库表类数据资产、完成元数据采集与服务封装，并在管理后台内使用资源门户相关能力的场景。 | 场景 | 描述 | 典型客户类型 | | ----------- | ----------------------------- | ------------------ | | **库表资产纳管** | 以数据库表类型资产为重点，维护清单、类目、标签与业务术语，支持检索与日常维护。 | 制造、政务、集团型组织的数据团队 | | **元数据采集与浏览** | 按任务做全量或常规增量采集，查看实例与日志；支持库表元数据浏览、字段查看与版本比对（不含表级血缘）。 | 金融、运营商、大型互联网等研发侧 | | **数据服务化** | 将数据封装为 API，配置类目、参数、限流与测试，并通过应用与授权对外开放。 | 后端研发、系统集成、数据开放实施 | | **资源门户基础能力** | 专题与资产发布，管理后台内的数据集市与资产详情浏览，资产访问申请与状态查看。 | 政企信息中心、行业云/园区类平台 | ## 💡 优势 | 优势点 | 描述 | |---------------| ------------------------------ | | **资产编目能力** | 资产类目、业务术语与标签体系统一维护，提升检索效率与业务语义一致性。 | | **元数据能力** | 覆盖库表元数据、版本管理与比对；不含表级血缘与实时采集，能力范围清晰、易于上手。 | | **数据服务能力** | 支持 API 配置、类目、限流、在线调试、应用与授权及调用日志，便于数据安全开放与复用。 | | **门户能力后台一体化** | 专题、发布、集市与详情以管理后台模块形式提供，非独立门户站点，降低部署与运维复杂度。 | ## 📋 功能清单 | 模块 | 描述 | |------|------| | 资产概览 | 以仪表盘形式汇总资产规模、类型构成与近期变化等；通过折线、饼图或柱状图等展示近一段时间的新增趋势与结构分布；提供进入常用列表或功能的快捷入口。 | | 资产清单 | 提供以**库表类资产**的列表与检索，支持新增、编辑、删除及按名称、类型、类目等筛选；详情可查看基础属性、字段清单、字段与业务术语的映射。 | | 资产标签 | 维护标签分类树与标签条目；支持将标签挂接到资产上，在列表中查看单标签关联的资产数量并下钻到明细。 | | 业务术语 | 维护术语分类与术语，可配置近义词、反义词、说明及启用状态；术语可与表字段建立映射（单字段单术语），并查看引用该术语的字段列表。 | | 数据资产类目 | 维护资产类目的层级结构，用于资产归档、按类目浏览与筛选。 | | 数据源管理 | 维护数据源的连接地址、账号等配置并保存。用于连通数据库并作为元数据采集的前置条件。 | | 元数据清单 | 在已注册数据源下浏览**库表**维度的元对象，查看表注释、字段类型、可空与默认值等；支持元数据版本记录及与历史版本的字段级差异对比。 | | 元数据采集 | 创建采集任务并配置范围、策略与调度方式，支持**手动执行**与**定时执行**；同步模式以**全量**与**常规增量**为主，可查看任务实例、执行结果与日志。 | | 通用配置 | 维护来源系统、数据连接类目、业务域等基础配置，为数据源、资产归类与门户专题等提供统一的检索与组织维度。 | | API 管理 | 通过单表向导或 SQL 脚本等方式生成数据 API；可配置路径、HTTP 方法、请求与返回字段、版本号及限流策略；在管理端可发起简单联调以核对参数与返回结构。 | | 调用日志 | 按服务类目、接口名称、时间、状态等条件查询调用记录；单次记录可展开查看请求参数、耗时与异常摘要等；可按策略清理历史日志。 | | API 在线调试 | 在页面中填写查询参数并调用已配置接口，查看请求与响应正文，用于配置校验与问题排查。 | | 应用管理 | 维护消费 API 的应用档案，生成或重置访问密钥，配置应用与接口之间的授权关系及是否对外可见等属性。 | | 数据服务类目 | 以树形结构维护 API 所属类目，支持多级目录、排序与检索；可查看类目下接口数量等汇总信息。 | | 专题管理 | 维护门户专题（主题）的层级与展示顺序，将资产挂接到专题下，支持按专题浏览及查看关联资源规模。 | | 资产发布 | 从资产清单选取对象进入发布流程，补充对外展示所需的标题、描述、类目或专题等字段；支持待发布、已发布、未通过、下架等状态，可单条或批量提交，并对已上线记录做更新或下架。 | | 数据集市 | 在**管理后台**内按主题树浏览资产，支持多条件组合筛选与卡片列表分页；**非独立对外门户站点**，交互与字段以当前版本页面为准。 | | 资产详情 | 在**管理后台**集中展示单条资产的基础信息、类目与标签、字段及术语绑定；在环境允许时提供样例数据预览、附件列表与 API 说明等；是否展示收藏等操作以实际页面为准。**非独立对外门户站点**。 | | 资产申请 | 对目标资产发起访问申请并填写用途、期望访问方式等说明；可查看处理状态与说明，按产品能力查看访问配置、申请续期或再次提交。 | | 在线文档 | 提供部署、配置、接口与常见问题等文档入口，内容与结构随版本更新。 | | 版本更新 | 通过发布说明、变更摘要等方式同步版本升级要点与注意事项（以仓库或官网实际发布为准）。 | 👉 qData 数据资产管理平台当前版本功能范围以上表为准，功能将持续迭代完善。 💡 如您有好的建议或功能需求，欢迎 [提交Issue](https://gitee.com/qiantongtech/qData/issues)，与我们共同完善数据资产管理平台功能。 [//]: # (## 🧩 架构图) [//]: # () ## 🛠️ 技术栈 qData 数据资产管理平台采用前后端分离架构，后端基于 Spring Boot，前端基于 Vue 3，并整合了主流的认证、数据库访问、缓存与前端组件能力。| 分类 | 技术 | 描述 |
|---|---|---|
| 后端技术栈 | Spring Boot | 提供快速开发能力与统一服务启动入口 |
| Spring Security | 实现用户认证、授权与安全控制 | |
| MySQL、达梦8 | 业务数据持久化可选用 MySQL、达梦 8 等；**当前开源版本**元数据采集侧**以 MySQL 接入为主** | |
| MyBatis-Plus | 简化数据库操作与多数据源访问 | |
| Redis | 支持缓存、登录态与基础中间件能力 | |
| Knife4j / OpenAPI | 提供接口文档展示与联调支持 | |
| 前端技术栈 | Vue 3 | 现代化响应式前端框架 |
| Element Plus | 常用 UI 组件支持与后台管理界面构建 | |
| Vite | 快速开发与构建工具 | |
| 第三方插件 | AntV X6 | 支撑流程、图形化设计与可视化交互场景 |
| ECharts | 支撑统计图表与可视化展示能力 |
| 环境 | 项目 | 推荐版本 | 说明 |
|---|---|---|---|
| 后端 | JDK | 1.8 或以上 | 建议使用 OpenJDK 8 |
| Maven | 3.6+ | 项目构建与依赖管理 | |
| 达梦8 / MySQL | 8.0+ | 关系型数据库环境；**当前开源版本**元数据采集侧**以 MySQL 接入为主** | |
| Redis | 5.0+ | 缓存与登录态等基础能力支持 | |
| Docker / Docker Compose | 可选 | 用于快速体验和测试环境部署 | |
| 操作系统 | Windows / Linux / Mac | 通用环境均可运行 | |
| 前端 | Node.js | 16+ | 前端构建工具依赖 |
| npm | 8+ | 包管理器 | |
| Chrome / Edge | 最新版 | 推荐用于本地调试与系统访问 |
 |
 |
 |
 |
 |
 |