44 lines
1.9 KiB
Markdown
44 lines
1.9 KiB
Markdown
# 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 通过后展开完整实现计划。
|