量潮数据云

项目结构

qtcloud-data/
├── src/
│ ├── provider/ # 后端服务（FastAPI）
│ ├── cli/ # 命令行工具
│ └── studio/ # 前端 Flutter 应用
├── tests/ # 测试fixtures和数据
├── docs/ # 文档
└── scripts/ # 项目初始化脚本

快速开始

前置要求

• Python >= 3.9
• UV - Python 包管理器（推荐）
• Flutter >= 3.0（仅 Studio）

安装 UV

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"# 或使用 pip
pip install uv

项目初始化

使用顶层的初始化脚本来设置开发环境：

# 初始化所有项目
./scripts/setup.sh all
# 或者单独初始化某个项目
./scripts/setup.sh provider
./scripts/setup.sh studio

常用命令

Provider（后端服务）

cd src/provider
# 安装依赖
uv sync --dev
# 运行测试
uv run pytest
uv run pytest -v # 详细输出# 启动开发服务器
uv run uvicorn app.main:app --reload
# 添加依赖
uv add <package>
uv add --dev <package>

Studio（前端应用）

cd src/studio
# 安装依赖
flutter pub get
# 运行应用
flutter run
# 运行测试
flutter test# 添加依赖
flutter pub add <package>

开发工作流

1. 克隆仓库

   git clone <repository-url>cd qtcloud-data

2. 初始化环境

   ./scripts/setup.sh all

3. 启动开发服务器

   # Providercd src/provider
   uv run uvicorn app.main:app --reload
   # Studiocd src/studio
   flutter run

4. 运行测试

   # Provider & Python SDK
   uv run pytest
   # Studio
   flutter test

License

Apache 2.0