docs: 完善数据模型设计

- 重命名 log_file 为 test_scenario(测试场景)
- 拆分维度表:tx_panel、tx_hardware、tx_software、rx_type
- 采用星型模型设计,消除数据冗余
- 为所有表添加软删除字段 is_deleted
- 更新关系说明,包含全局查询过滤器配置
- 更新 ER 图和查询示例

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
ssss
2026-07-02 15:53:30 +08:00
commit 28cb2533a7
23 changed files with 2919 additions and 0 deletions

61
docs/README.md Normal file
View File

@@ -0,0 +1,61 @@
# WCTDataMiner 文档中心
> 无线充电 FOD异物检测日志数据采集系统
---
## 文档目录
### 架构设计
| 文档 | 说明 |
|------|------|
| [架构概览](./architecture/概览.md) | 系统架构总览、设计原则 |
| [技术选型](./architecture/技术选型.md) | .NET 8.0 + EF Core 8.0 技术栈 |
| [模块划分](./architecture/模块划分.md) | 分层架构、依赖关系 |
| [安全架构](./architecture/安全架构.md) | 认证方案、数据安全 |
| [解析器设计](./architecture/parser/概览.md) | Qfod/Ploss 解析器 |
| [数据处理流程](./architecture/数据处理流程.md) | 解析流程、批量写入 |
| [配置管理](./architecture/配置管理.md) | appsettings.json 配置 |
| [CLI 命令设计](./architecture/CLI命令设计.md) | 命令行接口 |
| [数据库切换](./architecture/database/概览.md) | SQLite/PostgreSQL 切换 |
### 数据模型
| 文档 | 说明 |
|------|------|
| [数据模型概览](./data-model/概览.md) | ER 图、实体列表 |
| [日志文件](./data-model/entities/日志文件.md) | log_file 实体 |
| [Qfod 记录](./data-model/entities/Qfod记录.md) | qfod_record 实体 |
| [Ploss 记录](./data-model/entities/Ploss记录.md) | ploss_record 实体 |
| [解析错误](./data-model/entities/解析错误.md) | parse_error 实体 |
| [关系说明](./data-model/关系说明.md) | 实体间关系 |
### 需求文档
| 文档 | 说明 |
|------|------|
| [小电机数据需求分析](../小电机数据需求分析.md) | 日志格式、数据分析方法 |
---
## 技术栈概览
| 层级 | 技术 | 版本 |
|------|------|------|
| 运行时 | .NET | 8.0 LTS |
| 语言 | C# | 12.0 |
| ORM | Entity Framework Core | 8.0 |
| 数据库 | SQLite / PostgreSQL | - |
| CLI | System.CommandLine | 2.0-beta4 |
---
## 待确认问题
| # | 问题 | 来源 |
|---|------|------|
| 1 | 增量解析策略 | 日志是否持续追加? |
| 2 | 重复解析处理 | 多次解析同一文件如何处理? |
| 3 | FOD Type 编码含义 | 需求文档 QA 3.2 |
| 4 | Ploss 日志格式对应 | 需求文档 QA 3.3 |