更新：1、新增数据记录功能，将过程数据录入数据库；

2、增加输入点迹数据、凝聚后点迹数据记录；

Signed-off-by: waiwaylee <waiwaylee@foxmail.com>

CHANGELOG.md

@@ -29,10 +29,21 @@
 - 输入/输出结构新增「归一化幅度」与「速度维 FFT 点数」相关字段（e8c56f9）：`DataRev` 增加 `amp_asv`（目标归一化幅度 dB）与 `prn_fftn`（速度维 FFT 点数）；`Track` 增加 `amp_asv_point` / `prn_fftn_point`；内部 `PointRecv`、`Trust_Track` 同步增加对应字段，`track_asso.cpp` 在关联实点时写入航迹、TWS 输出航迹时写回输出结构。⚠ 输入侧未打通：`data_preprocess()` 未把 `DataRev.amp_asv` / `DataRev.prn_fftn` 拷入内部 `PointRecv`，TAS 通道也未涉及这两个字段，当前这两个输出字段尚无有效数据来源（详见 README 11.2）。
 - 更新 README.md（本次文档更新）：2 节补充重点目标/外推上限/输出门控与结构体字段扩展；3 节把 `requirements.md` 移回仓库根目录；5.2、6.1、6.2、7.1、8.1、8.2、9.6、9.9、10.1、11.1、11.2、12、13 节按源码同步 `Flag_Direction` 新判据、外推圈数上限、消亡圈数（普通 6 / 重点 10 / TAS 相扫 10、机扫 96）、`Track_Update_Flag` 输出门控、新增字段与结构体布局变更提示；12 节版本历史补充 50e0b5c、fc49707、42b598e、e8c56f9 四条记录。
 - 同步 `docs/data_process_flow_report.md` 与 `docs/track_init_readme.md`（本次文档更新）：前者更新总体数据流表（⑥ 外推/消亡）、4.7 外推、6.1 消亡条件、7.2 TAS 外推门控、9.1 参数表与第 10 节观察；后者更新第 14 节 `Flag_Direction` 判据并补充 `amp_asv_point` / `prn_fftn_point` 两个未赋值字段。
+- **新增数据记录调试功能（可选编译）**：新增 `rdp_record.h`（`rdp_record::Init()/Shutdown()/db_path()` 与 `RDP_RECORD`/`RDP_RECORD_BATCH` 记录点宏；功能关闭时宏展开为 `((void)0)`、实参不求值，头文件不含任何第三方依赖）、`rdp_record_entity.h`（记录实体=数据表定义区，含 2 个示例实体与 `RDP_RECORD_DECLARE` 实例化声明宏）、`rdp_record.cpp`（实体注册区：`YLT_REFL` + `RDP_RECORD_DEFINE`；pimpl 隔离 ormpp/SQLite；首次写入自动 `CREATE TABLE IF NOT EXISTS`；单条写入与 `std::vector` 批量事务写入；建表/插入失败每个实体只提示一次并降级为空操作；内部互斥锁串行化单连接）。`data_process_class_dll.cpp` 的 `Data_Process_Factory::GetB()/Destroy()` 分别调用 `rdp_record::Init()/Shutdown()`（关闭时为空实现），`parameters.h` 新增记录目录宏 `RDP_RECORD_DB_DIR`（`.\rdp_records\`），`.gitignore` 增加 `rdp_records/`。
+- 新增 2 个示例记录点（`data_process.cpp`，字段为示例可按需增删）：① `data_preprocess()` 的 TWS 分支逐点写入表 `RdpRecPointTws`（输入点迹 18 个字段：CPI/GNSS 时间 ms、方位/俯仰波位、PRF/频点、点迹号/总数、距离/方位/俯仰/速度/幅度/SNR/RCS 等）；② `track_process()` 的 TWS/TAS 处理帧结束后批量写入表 `RdpRecTrackOut`（输出航迹 20 个字段，两种模式共用一张表并用 `track_mode` 区分；每行取输出数组 `[i][0]`，行数超过 `MAX_TRACK_NUM` 时钳位）。
+- 内置第三方源码 `third_party/ormpp/`（按上游原样保存，含 `UPSTREAM.md` 记录来源与升级方式）：ormpp 0.2.0（commit `acf23989…`，Apache-2.0）+ 随其内置的 iguana 1.0.5、frozen 与 SQLite 3.49.1 amalgamation（公有领域），并保留两份 LICENSE 文件（与上游 git blob 逐字节一致）。
+- 新增 `docs/data_record_debug.md`（数据记录调试功能专项说明）：开关与构建（`RDP_DATA_RECORD` 取值、`configure.bat` 第 4 参数、记录模块以 C++20 独立编译与 C 编译器要求、关闭时零代码保证）、运行期行为（记录库目录与文件名、`synchronous=OFF` 取舍、`Init`/`Shutdown` 时机、失败降级、单连接 + 互斥锁与线程模型）、记录实体（表）约定（全局命名空间、结构体名即表名、首列 `int64_t id` 自增主键、类型映射表、**禁止数组字段**及原因）、**新增记录点四步配方**（含 `RDP_RECORD_DECLARE` → `YLT_REFL` + `RDP_RECORD_DEFINE` → 记录点写法 → 自动建表，以及「忘记注册报 LNK2019」自检点）、现有 2 个示例记录点、Python/DB Browser 查询示例与已知限制。
+- 更新 README.md（本次文档更新）：2 节新增「数据记录调试功能（可选编译）」特性条目；3 节目录结构补充 `third_party/ormpp/`、`rdp_record.h/.cpp`、`rdp_record_entity.h`、`docs/data_record_debug.md`、`rdp_records/` 并更新 `requirements.md` 说明；4.1 节环境要求补充内置依赖与 C 编译器；4.3 节补充 `RDP_DATA_RECORD` 与 `configure.bat` 第 4 参数用法；4.4 节产物补充 `rdp_record.lib`；4.5 节新增「第三方库告警例外（仅记录功能启用时）」；5.2 节模块职责新增 `rdp_record` 行；10.1 节编译期宏新增 `RDP_RECORD_ENABLE` / `RDP_RECORD_DB_DIR`；11.3 节补充「记录功能默认只在 Debug 启用」；12 节版本历史新增本次工作区条目；13 节参考文档新增 `docs/data_record_debug.md` 与 `third_party/ormpp/UPSTREAM.md`、更新 `requirements.md` 行。
 
 ### Changed
 
 - TAS 波束控制改为按固定数据率调度：`Beam_Ctrl()` 仅当目标满足 `1 / DATA_RATE_TAS` 秒的数据率间隔（相对航迹时间 `T_track` 与上次波束输出 `last_track_time`）时才输出 TAS 跟踪波束，使 TAS 目标数据率不再随波束时间（Beam_Ctrl 调用频率）变化。
+- `CMakeLists.txt` 新增缓存变量 `RDP_DATA_RECORD`（`AUTO`/`ON`/`OFF`，AUTO = Debug 启用 / Release 关闭；多配置生成器下 AUTO 直接 `FATAL_ERROR` 要求显式取值）与可选静态库 `rdp_record`：该目标以 `CXX_STANDARD 20` 独立编译（ormpp 要求 `CMAKE_CXX_STANDARD 20`，而内置 Eigen 3.3.7 在 `/std:c++20` 下会因 `std::result_of` 被 MSVC 移除而编译失败，故**雷达处理代码保持 C++17**）、经 `enable_language(C)` 编译内置 sqlite3 amalgamation（`sqlite3.c` 以源文件级 `/w` 单独降级第三方告警）、`RDP_RECORD_ENABLE` 与 `ORMPP_ENABLE_SQLITE3` 经 `PUBLIC` 传递给 DLL 并将静态库链接进 DLL；关闭时不添加任何目标、`SOURCES` 列表保持不变（Release 零痕迹的关键）。配置阶段打印启用/关闭状态。
+- `parameters.h` 新增记录库目录宏 `RDP_RECORD_DB_DIR`（`.\rdp_records\`，相对宿主进程当前工作目录，目录不存在时自动创建）与开关说明注释：记录开关由构建系统定义 `RDP_RECORD_ENABLE`，**不提供手工开关宏**（避免 Release 误开）。
+- `configure.bat` 新增可选第 4 参数 `AUTO|ON|OFF`（缺省 `AUTO`，即 CMake 侧默认值）并作为 `-DRDP_DATA_RECORD` 传入，回显新增 `record` 行；脚本仍保持纯 ASCII 编码。
+- `.gitignore` 增加 `rdp_records/`（数据记录库输出目录）。
+- `requirements.md` 内容更新为数据记录调试功能需求（结构体经 ormpp 映射写入 SQLite、Release 版可屏蔽、数据分类入不同表、宏记录点、便于快速新增结构体、不使用异步写入），本功能框架已按该说明实现。
+- 本次改动的编译与运行验证：X256_PS/X256_MS × Release（记录关闭）/Debug（记录启用）四种配置均 **0 warning、0 error**；Release 产物的导出表与依赖表与改动前**逐行一致**、DLL 体积不变（PS 178,688 / MS 178,176 字节）、构建树中无记录模块目标文件、二进制内无 `sqlite` 字样；Debug（AUTO→启用）下 DLL 产物为 3,611,648 字节并额外生成 `rdp_record.lib`；运行时用临时校验程序（不提交）配合 Python `sqlite3` 验证：建库成功、一实体一表、单条与批量（事务）写入行数与取值正确、`id` 自增、`PRAGMA integrity_check` = ok、无 `-journal`/`-wal` 残留；记录目录无法创建时 DLL 接口照常返回、仅打印一次错误、后续写入静默忽略。
 - TAS 波束输出目标改为队列内调度：不再固定取队首，而是遍历 TAS 队列，选择满足数据率门控且 CPI 时间最早的目标输出；原每次 Beam_Ctrl 末尾的整队循环移位（队列轮转）已停用（代码注释保留）。
 - 数据率门控统一使用运行时参数 `Work_Parameter.DATA_RATE_TAS`（由 DLL 调用者经 `track_process_parameters_initial()` 输入，需为 >0 的有效值）；`parameters.h` 中 `DATA_RATE_TAS` 编译期宏（相扫 0.3 / 机扫 0.0625）已注释停用，引导跟踪外推同步改用运行时参数。
 - 编译时以 `#pragma message` 提示当前启用的扫描体制宏（MECHANICAL_SCANNING / PHASE_SCANNING）。