# data_visual

**Repository Path**: michael940517/data_

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-17
- **Last Updated**: 2026-07-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FinQueryGuard

FinQueryGuard 是一个证券业务智能问数最小原型。当前阶段只验证：用户能否在有限问题域内，通过自然语言稳定获得正确、可解释、可追溯的查询结果。

## 当前范围

- 8 张版本化 CSV 数据表；
- 9 个固定 `query_type`；
- 9 个受控 SQL 模板 T01～T09 与只读查询；
- 1 个 Streamlit 单页；
- 12 条小型验收用例，其中 10 条可执行、2 条拒答；
- 4 名开发者分别使用独立开发 Agent 并行协作。

当前不建设通用 NL2SQL 平台、任意数据库适配、运行时多 Agent 编排或企业级权限平台。

## 数据包

- `data/source/`：8 张业务 CSV，是原型唯一可查询的数据表；
- `data/reference/questions.xlsx`：基准问题与人工校验 SQL；
- `data/reference/schema.sql`：UTF-8 编码的表结构和注释说明。

后两项是辅助说明和人工校验材料，不计入 8 张业务数据表。当前数据不支持服务经理分析、营销转化分析或行情预测。

## 仓库入口

1. 阅读 [PROJECT.md](PROJECT.md) 了解项目目标、技术边界和验证方式。
2. 阅读 [specs/mvp.md](specs/mvp.md) 了解产品规格。
3. 阅读 [AGENTS.md](AGENTS.md) 了解 Agent 工作规则和分支所有权。
4. 阅读 [docs/collaboration/four-agent-ownership.md](docs/collaboration/four-agent-ownership.md) 了解四人并行方式。
5. 运行 `python3 scripts/verify.py` 验证仓库结构和数据完整性。

## 当前状态

仓库已完成 Day 0 规格、契约、数据说明和验收用例对齐，业务代码尚未开始实现。