# dataiq

**Repository Path**: fscww/dataiq

## Basic Information

- **Project Name**: dataiq
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-04
- **Last Updated**: 2026-08-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DataIQ — AI 原生 BI 平台

以 Datart 的核心使用体验为需求基础，从零自研的 AI 原生 BI 平台。目标不是「传统 BI + 能生成 SQL 的聊天框」，而是让 AI 与人工共用同一套配置模型，AI 生成的结构化配置草稿可直接回填编辑器、可预览、可逐项修改、可撤销，最终由用户确认后发布。

## 核心特点

- **双路径创建**：人工路径与 AI 路径共用同一配置模型、校验规则和发布流程。
- **AI 只操作 Draft**：AI 生成数据准备方案、数据集、图表和仪表板草稿，所有生产发布必须由用户确认，AI 不能绕过权限。
- **跨系统数据汇聚**：支持同源直连分析，跨源与复杂加工通过数据准备任务物化到独立 BI 数据仓库。
- **语义层优先**：维度、指标、层次、业务口径和权限进入版本化语义模型，AI 优先复用已验证指标。
- **全链路安全可审计**：默认拒绝、行列权限、字段脱敏、统一 Query Guard、SQL 只读单语句、AI 全程记录。

## 仓库结构

```
dataiq/
├── docs/
│   ├── PRODUCT_REQUIREMENTS.md   # 产品需求文档（v0.3，原型对齐需求稿）
│   └── TECH_STACK.md             # 技术栈与架构基线（选型建议稿）
└── prototype/                    # React 操作级原型（React 19 + Vite + Ant Design + ECharts）
    ├── src/                      # 页面与组件（数据集、图表、仪表板、权限治理等）
    ├── worker/                   # Sites 部署 worker
    ├── scripts/                  # 构建与 QA 对比图生成脚本
    ├── tests/                    # worker 测试
    └── audit*/                   # 现状审计截图与 QA 记录
```

## 技术栈基线（详见 docs/TECH_STACK.md）

- 前端：React 19 + TypeScript + Vite + Ant Design 5 + ECharts 6 + TanStack Query
- 后端：Java 21 + Spring Boot 4.1.x 模块化单体（api / worker 分进程复用领域模块）
- 平台库：PostgreSQL 17 + pgvector（混合元数据检索，一期不引入独立向量库/ES）
- 数据访问：平台库用 jOOQ；外部数据源用 JDBC + Connector/Dialect SPI，严格只读
- SQL 安全：Apache Calcite 解析 + 自有 Query Guard / SQL 编译器，模型不直接生成可执行 SQL
- AI：自有 Provider SPI（不硬编码单一模型，区分 planner / fast / embedding 角色），多步 AI 任务用 Temporal 编排
- 暂不引入：Kafka、Kubernetes、微服务、专用向量数据库、自由多智能体

## 原型开发

```bash
cd prototype
npm install
npm run dev        # 启动本地开发服务器
npm run build      # 构建（含 Sites 部署产物）
npm run test:sites # 运行 worker 测试
```

## 文档

- [产品需求文档](docs/PRODUCT_REQUIREMENTS.md)：产品范围、核心流程、功能需求、AI 行为边界与验收标准
- [技术栈与架构基线](docs/TECH_STACK.md)：选型结论、总体架构、AI 能力设计、查询安全与分阶段实施

## 当前状态

- 需求：原型对齐需求稿 v0.3（2026-08-03）
- 技术栈：选型建议稿，开工前需确认数据源、数据规模、同步时效、部署与合规要求