WCTDataMiner/docs/architecture/模块划分.md

模块划分

所属模块：架构概览

---

1. 模块总览

┌─────────────────────────────────────────────────────────────┐
│                        CLI Entry Point                       │
│                    (Program.cs / System.CommandLine)         │
├─────────────────────────────────────────────────────────────┤
│                      Service Layer                           │
├─────────────────────────────────────────────────────────────┤
│  ParseService  │  ErrorHandlingService  │  ThresholdCalc    │
├─────────────────────────────────────────────────────────────┤
│                      Parser Layer                            │
├─────────────────────────────────────────────────────────────┤
│  QfodParser  │  PlossParser  │  LogFileReader               │
├─────────────────────────────────────────────────────────────┤
│                       Data Layer                             │
├─────────────────────────────────────────────────────────────┤
│  Models  │  WctMinerDbContext  │  IDbContextFactory         │
├─────────────────────────────────────────────────────────────┤
│                      Infrastructure                          │
├─────────────────────────────────────────────────────────────┤
│  Configuration  │  Serilog  │  AppSettings                  │
└─────────────────────────────────────────────────────────────┘

---

2. 模块职责

模块名	职责	依赖模块
CLI Entry	接收命令行参数、调度解析流程	ParseService, Infrastructure
ParseService	协调解析流程、批量写入、统计更新	Parser Layer, DbContext, Infrastructure
LogFileReader	读取日志文件、行过滤、文件遍历	无
QfodParser	解析 Qfod 格式日志，返回 Record	LogFileReader
PlossParser	解析 Ploss 格式日志，返回 Record	LogFileReader
Models	定义数据实体结构	无
WctMinerDbContext	EF Core 数据库上下文	Models
Configuration	加载配置文件	无
Serilog	结构化日志输出	无
ErrorHandlingService	解析错误记录、错误统计	无

---

3. 分层架构

3.1 分层定义

层级	职责	允许调用
CLI Entry	接收参数、流程调度、结果输出	Service, Infrastructure
Service	协调解析流程、批量写入、统计管理	Parser, Data, Infrastructure
Parser	日志解析、数据提取、返回 Record	无
Data	数据持久化、DbContext 管理	Infrastructure
Infrastructure	配置、日志、错误处理	无

3.2 依赖规则

• 上层可调用下层
• 下层不可调用上层
• Parser 之间不可互相调用（独立解析器）
• Service 层协调 Parser 和 Data 层

---

4. 模块依赖图

graph TD
    CLI[CLI Entry] --> PS[ParseService]
    CLI --> Serilog
    CLI --> EHS[ErrorHandlingService]

    PS --> QP[QfodParser]
    PS --> PP[PlossParser]
    PS --> DBM[WctMinerDbContext]
    PS --> EHS
    PS --> Serilog
    PS --> Config[Configuration]

    QP --> LFR[LogFileReader]
    PP --> LFR

    DBM --> Models[Models]

    subgraph Parser Layer
        QP
        PP
        LFR
    end

    subgraph Data Layer
        DBM
        Models
    end

    subgraph Infrastructure
        Config
        Serilog
        EHS
    end

---

5. 目录结构

src/WCTDataMiner/
├── Parsers/
│   ├── IParser.cs
│   ├── QfodParser.cs
│   ├── PlossParser.cs
│   └── LogFileReader.cs
├── Models/
│   ├── LogFile.cs
│   ├── QfodRecord.cs
│   ├── PlossRecord.cs
│   ├── ParseError.cs
│   └── ParseStatus.cs
├── Data/
│   ├── WctMinerDbContext.cs
│   └── IDbContextFactory.cs
├── Services/
│   ├── ParseService.cs
│   ├── ThresholdCalculator.cs
│   └── ErrorHandlingService.cs
├── Configuration/
│   ├── AppSettings.cs
│   └── appsettings.json
├── Commands/
│   ├── ParseCommand.cs
│   ├── StatsCommand.cs
│   ├── ExportCommand.cs
│   └── CleanCommand.cs
└── Program.cs