# smart-data-captor

**Repository Path**: elfbobo_admin_admin/smart-data-captor

## Basic Information

- **Project Name**: smart-data-captor
- **Description**: 智能数据捕手，通过自然语言对话方式获取指定数据库数据。主要通过将数据实例分化成多个数据中心，通过LLM路由到具体的数据中心，利用其业务知识、元数据等信息生成SQL来从数据库抽取数据。提供定义数据源，设置LLM等系统配置功能。可通过修改数据路由，装配式的定义数据中心来达成扩展数据访问能力。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-12-03
- **Last Updated**: 2025-12-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# smart-data-captor

## 1 介绍
智能数据捕手，通过自然语言对话方式获取指定数据库数据。主要通过将数据实例分化成多个数据中心，通过LLM路由到具体的数据中心，利用其业务知识、元数据等信息生成SQL来从数据库抽取数据。提供定义数据源，设置LLM等系统配置功能。可通过修改数据路由，装配式的定义数据中心来达成扩展数据访问能力。

## 2 软件架构
1. BS架构（前端浏览器+中间应用+后端PostgreSQL）

## 3 安装教程

1. 安装PostgreSQL，搭建数据库模式 database/init.sql

2. 下载源码，安装依赖组件 pip install -r requirments.txt

3. 修改后端服务环境变量 backend/.env

   ```
   DATABASE_URL=postgresql://postgres:XX@localhost:5432/smart_data_captor #后端服务访问连接
   DEFAULT_USER_PASSWORD=SmartDBcaptor@1 #新增用户默认密码
   ENCRYPTION_KEY=BzCbdnMNUjwqKdjHFrldHel3G4ZTV9 #数据连接帐号对应的密码、LLM访问的令牌用于可逆加密存储的密钥
   ```

4. 

## 4 使用说明

1. 启动后端

   ```
   cd backend
   uvicorn main:app
   ```

2. 启动前端

   ```
   cd frontend
   npm run dev
   ```

3. 登录应用

   ```
   http://localhost:5173
   ```

# 5 相关视频

1. [20251120_121351智能问数简版运维分析使用](https://www.bilibili.com/video/BV1tM2vBoEJx/?vd_source=e359e7a37437c6a4806a069952c6fb7e)
2. [20251130_205414智能问数平台简介](https://www.bilibili.com/video/BV1UT2vBtEC5/?vd_source=e359e7a37437c6a4806a069952c6fb7e)
3. [20251130_232820智能问数场景的成功发布操作](https://www.bilibili.com/video/BV1MT2vBbEah/?vd_source=e359e7a37437c6a4806a069952c6fb7e)
4. [20251201_152719智能问数场景管理及应用发布](https://www.bilibili.com/video/BV1k72vBDEQg/?vd_source=e359e7a37437c6a4806a069952c6fb7e)
5. [20251202_113955智能问数平台的初始化全程介绍](https://www.bilibili.com/video/BV1VL2eBPEaW/?vd_source=e359e7a37437c6a4806a069952c6fb7e)
6. [20251202_150034智能问数装配式数据查询场景配置过程介绍](https://www.bilibili.com/video/BV19L2eBAEBM/?vd_source=e359e7a37437c6a4806a069952c6fb7e)
7. [20251207_143237工程镜像制作与调测过程记录](https://www.bilibili.com/video/BV1Mb2fBhER9/?vd_source=e359e7a37437c6a4806a069952c6fb7e)

# 6 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)