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)

数据库兼容性：IN (0, 1) 语法在 SQLite、PostgreSQL、MySQL 中均可使用。若使用其他数据库，需验证 CHECK 约束语法兼容性。

---

6. EF Core 模型

实体类

// Models/QfodRecord.cs
namespace WCTDataMiner.Models;

public class QfodRecord
{
    public Guid Id { get; set; } = Guid.NewGuid();
    public Guid ScenarioId { get; set; }
    public byte ChargerIndex { get; set; }
    public byte CoilIndex { get; set; }
    public int DeltaQ { get; set; }
    public float CurrentQ { get; set; }
    public float RawQ { get; set; }
    public byte FodType { get; set; }
    public bool IsDeleted { get; set; } = false;
    public DateTime CreatedAt { get; set; } = DateTime.UtcNow;

    // Navigation Properties
    public TestScenario Scenario { get; set; } = null!;
}

配置类

// Data/Configurations/QfodRecordConfiguration.cs
using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Metadata.Builders;
using WCTDataMiner.Models;

namespace WCTDataMiner.Data.Configurations;

public class QfodRecordConfiguration : IEntityTypeConfiguration<QfodRecord>
{
    public void Configure(EntityTypeBuilder<QfodRecord> builder)
    {
        builder.ToTable("qfod_record");

        builder.HasKey(e => e.Id);
        builder.Property(e => e.Id).HasColumnName("id");

        builder.Property(e => e.ScenarioId)
            .IsRequired()
            .HasColumnName("scenario_id");

        builder.Property(e => e.ChargerIndex)
            .IsRequired()
            .HasColumnName("charger_index");

        builder.Property(e => e.CoilIndex)
            .IsRequired()
            .HasColumnName("coil_index");

        builder.Property(e => e.DeltaQ)
            .IsRequired()
            .HasColumnName("delta_q");

        builder.Property(e => e.CurrentQ)
            .IsRequired()
            .HasColumnName("current_q");

        builder.Property(e => e.RawQ)
            .IsRequired()
            .HasColumnName("raw_q");

        builder.Property(e => e.FodType)
            .IsRequired()
            .HasColumnName("fod_type");

        builder.Property(e => e.IsDeleted)
            .IsRequired()
            .HasDefaultValue(false)
            .HasColumnName("is_deleted");

        builder.Property(e => e.CreatedAt)
            .IsRequired()
            .HasDefaultValueSql("NOW()")
            .HasColumnName("created_at");

        // 索引
        builder.HasIndex(e => e.ScenarioId).HasDatabaseName("idx_qfod_scenario");
        builder.HasIndex(e => new { e.ChargerIndex, e.CoilIndex }).HasDatabaseName("idx_qfod_charger_coil");
        builder.HasIndex(e => e.FodType).HasDatabaseName("idx_qfod_fod_type");
        builder.HasIndex(e => e.DeltaQ).HasDatabaseName("idx_qfod_delta_q");

        // CHECK 约束
        builder.HasCheckConstraint("chk_qfod_charger", "charger_index IN (0, 1)");
        builder.HasCheckConstraint("chk_qfod_coil", "coil_index IN (0, 1, 2)");

        // 关系配置
        builder.HasOne(e => e.Scenario)
            .WithMany(e => e.QfodRecords)
            .HasForeignKey(e => e.ScenarioId)
            .IsRequired();
    }
}

---

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