XplorePlane/README.md

XplorePlane 平面CT软件

系统目标

XplorePlane 系统用于控制平面 CT 设备的各个子系统（射线源、探测器、运动控制）并完成采集图像的处理与分析，为研发与调试提供统一的软件平台。

总体架构风格

• 客户端框架: WPF + Prism MVVM（项目 XplorePlane，目标框架 net8.0-windows）
• 图像处理内核: 独立类库 ImageProcessing.Core（算子基类与参数模型）和 ImageProcessing.Processors（具体算子实现），基于 EmguCV
• 基础设施: 日志使用 Serilog，序列化使用 Newtonsoft.Json，资源统一通过 WPF 资源系统管理

开发目标

在现有图像处理与 UI 基础上，引入并集成：

• 射线源子系统（X-Ray Source）
• 探测器子系统（Detector）
• 运动控制子系统（Motion Control）
• 通过统一的 CT 扫描工作流，在 UI 中实现一键式扫描、实时状态监控与图像后处理

项目框架

XplorePlane/
├── XplorePlane.csproj           # .NET 8 WPF project file
│
├── App.xaml                       # Application + global ResourceDictionary
├── App.xaml.cs
│
├── Views/
│   └── MainWindow.xaml            # Main window (Grid + StackPanel layout)
│   └── MainWindow.xaml.cs         # Code-behind (minimal – only TreeView event)
│
├── ViewModels/
│   └── MainViewModel.cs           # Root VM: navigation, callouts, props, commands
│   └── NavGroupNode.cs            # Tree group node VM
│   └── NavLeafNode.cs             # Tree leaf node VM
│   └── InspectionCalloutVM.cs     # Overlay callout card VM
│   └── CalloutRowVM.cs            # Single callout data row VM
│   └── RelayCommand.cs            # ICommand implementation
│
├── Models/
│   └── FeatureProperties.cs       # Bindable domain model for right panel
│
└── Assets/
    └── Icons/                     # 28×28 toolbar icon PNGs
      

XplorePlane.Hardware（硬件库）

XplorePlane.ImageProcessing （图像库）

日志系统

项目已集成 Serilog 日志框架，提供统一的日志服务：

• 日志框架: Serilog 4.3.1
• 日志输出: 控制台、文件（按天滚动）、调试输出
• 日志路径: logs/xploreplane-YYYYMMDD.log
• 配置文件: App.config
• 服务接口: ILoggerService

使用示例:

public class MyService
{
    private readonly ILoggerService _logger;

    public MyService(ILoggerService logger)
    {
        // 使用泛型自动推断模块名
        _logger = logger?.ForModule<MyService>() ?? throw new ArgumentNullException(nameof(logger));
    }

    public void DoSomething()
    {
        _logger.Info("执行操作");
        _logger.Debug("调试信息：参数={Value}", someValue);
    }
}

详细使用指南请参考：Doc/Logging.README.md

TO-DO List

• 软件基于 WPF + Prism 基础的框架
• 日志库的引用
• 界面的布局
• 打通与硬件层的调用流程
• 打通与图像层的调用流程