WCTDataMiner/docs/data-model/entities/Qfod记录.md

qfod_record 实体

所属模块：数据模型概览

---

1. 表定义

表名：qfod_record

描述：存储 Qfod 格式解析数据，对应日志格式 X#:Q A->B C D E

---

2. 字段定义

列名	类型	约束	说明
id	UUID	PK, NOT NULL	主键
scenario_id	UUID	FK, NOT NULL	关联测试场景
charger_index	TINYINT	NOT NULL	充电器索引（0 或 1）
coil_index	TINYINT	NOT NULL	线圈索引（0、1、2）
delta_q	INT	NOT NULL	Q值变化量（ΔQ = current_q - raw_q）
current_q	FLOAT	NOT NULL	当前实时 Q值
raw_q	FLOAT	NOT NULL	原始 Q值
fod_type	TINYINT	NOT NULL	异物类型编码
is_deleted	BOOLEAN	NOT NULL, DEFAULT FALSE	软删除标记
created_at	TIMESTAMP	NOT NULL, DEFAULT NOW()	创建时间

---

3. 外键

外键	引用表	说明
scenario_id	test_scenario.id	关联测试场景（必需）

---

4. 索引

索引名	字段	用途
idx_qfod_scenario	scenario_id	按测试场景查询
idx_qfod_charger_coil	(charger_index, coil_index)	按检测通道查询
idx_qfod_fod_type	fod_type	按异物类型统计
idx_qfod_delta_q	delta_q	阈值分析

---

5. 约束

约束名	类型	定义
chk_qfod_charger	CHECK	charger_index IN (0, 1)
chk_qfod_coil	CHECK	coil_index IN (0, 1, 2)

---

6. EF Core 模型

// Models/QfodRecord.cs
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace WCTDataMiner.Models;

[Table("qfod_record")]
[Index(nameof(ScenarioId), Name = "idx_qfod_scenario")]
[Index(nameof(ChargerIndex), nameof(CoilIndex), Name = "idx_qfod_charger_coil")]
[Index(nameof(FodType), Name = "idx_qfod_fod_type")]
[Index(nameof(DeltaQ), Name = "idx_qfod_delta_q")]
public class QfodRecord
{
    [Key]
    [Column("id")]
    public Guid Id { get; set; } = Guid.NewGuid();

    [Required]
    [Column("scenario_id")]
    public Guid ScenarioId { get; set; }

    [Required]
    [Column("charger_index")]
    public byte ChargerIndex { get; set; }

    [Required]
    [Column("coil_index")]
    public byte CoilIndex { get; set; }

    [Required]
    [Column("delta_q")]
    public int DeltaQ { get; set; }

    [Required]
    [Column("current_q")]
    public float CurrentQ { get; set; }

    [Required]
    [Column("raw_q")]
    public float RawQ { get; set; }

    [Required]
    [Column("fod_type")]
    public byte FodType { get; set; }

    [Required]
    [Column("is_deleted")]
    public bool IsDeleted { get; set; } = false;

    [Required]
    [Column("created_at")]
    public DateTime CreatedAt { get; set; } = DateTime.UtcNow;

    [ForeignKey(nameof(ScenarioId))]
    public TestScenario Scenario { get; set; } = null!;
}

---

7. 检测通道组合

ChargerIndex	CoilIndex	检测通道
0	0	充电器0-线圈0
0	1	充电器0-线圈1
0	2	充电器0-线圈2
1	0	充电器1-线圈0
1	1	充电器1-线圈1
1	2	充电器1-线圈2