# Geopro 3.0 桌面客户端

地球物理勘探数据可视化桌面客户端（Qt 6 + VTK 9，C++）。复刻 Geopro 3.0 核心「项目分析视图」。

> M1 范围、架构与决策见 **[docs/superpowers/specs/2026-06-07-geopro-desktop-m1-design.md](docs/superpowers/specs/2026-06-07-geopro-desktop-m1-design.md)**。
> 上位技术基线见 **[docs/Geopro3.0_技术选型与架构规约.md](docs/Geopro3.0_技术选型与架构规约.md)**。
> 环境搭建见 **[docs/ENV_SETUP_Windows.md](docs/ENV_SETUP_Windows.md)**。

## 技术栈

Qt 6.8 LTS（QtWidgets）+ VTK 9.3+ · CMake + vcpkg（全量，含 Qt）· MSVC 2022 / C++17 · ADS 停靠 · GDAL/PROJ · OpenSSL · QtKeychain。

## 目录（设计 §3）

```
src/core/        纯业务，零 Qt/VTK
src/data/        Repository + 解析器
src/net/         ApiClient / AuthService / Credential
src/render/      VTK 场景与 actor（单一场景 + 相机预设）
src/view/        QtWidgets 面板
src/controller/  联动编排
src/app/         入口 + 主窗（M1 spike：Qt+VTK 冒烟程序）
tests/           gtest / Qt Test
tools/           离线验证脚本（validate_samples.py）
docs/            规约、API、样本数据、设计文档
```

## 快速开始

前置：VS2022(C++ 桌面开发)、Git、vcpkg（设 `VCPKG_ROOT`）。详见 ENV_SETUP_Windows.md。

```powershell
# x64 Native Tools 命令行，项目根
vcpkg x-update-baseline --add-initial-baseline   # 锁依赖版本
cmake --preset msvc-debug                        # 首次编译 Qt+VTK，较久
cmake --build build/debug
.\build\debug\src\app\geopro_desktop.exe         # spike 冒烟：应显示一个锥体
ctest --test-dir build/debug                      # 运行单测
```

## 当前状态

M1 设计完成（v2，经双专家评审）。进入 **spike 预研**（设计 §15）：① 全 vcpkg 构建/部署 ② ADS + QVTKOpenGLStereoWidget 停靠稳定 ③ 真实样本跑通 banded contour。spike 通过后展开完整实现计划。