# 2026-04-29 日期替代逻辑迁移与 BarcodeEditor 联动工作日报

## 工作背景

- `DateReplaceEditor` 是从 `DateVarSet` 中拆分出来的“代替”选项卡编辑器。
- 当前 UI 已经拆分完成，但原先 `DateVarSet` 中“代替”页签对应的逻辑、默认数据、以及与 `BarcodeEditor` 的联动尚未完整迁移。
- 目标是让 `DateReplaceEditor`、`DateFormatEditor` 在 `BarcodeEditor` 中成对工作，并补齐默认替换列表初始化能力。

---

## 本次完成内容

### 1. 为 DateReplaceEditor 补齐替代页数据模型接口

在 `scene/DateReplaceEditor.h/.cpp` 中补充并实现：

- `DateItemModel DateReplaceEditor::dateModel()`
- `void DateReplaceEditor::setDateModel(const DateItemModel &model)`

实现效果：

- `dateModel()`：把当前编辑器中的替代数据回收成 `DateItemModel`
  - `dataMap`
  - `weeksMap`
  - `hoursMap`
  - `monthsMap`
  - `daysMap`
  - `yearsMap`
- `setDateModel()`：将 `DateItemModel` 回填到编辑器内部列表，并依据当前替代类型刷新界面显示。

这样 `DateReplaceEditor` 就具备了和外部视图模型双向交换数据的能力。

---

### 2. 复刻 DateVarSet 中“代替”页默认数据初始化逻辑

在 `DateReplaceEditor` 中补齐了与 `DateVarSet::initReplaceValue()` 对应的默认初始化逻辑，包含以下替代列表：

- `dataList`：`0-9`、`A-F`
- `weekList`：`MON-SUN`
- `monthList`：`01-12`
- `dayList`：`01-31`
- `hourList`：`00-23`
- `yearList/yearInitList`：从当前年份开始连续 16 年

同时实现/整理了以下行为：

- 根据替代类型切换不同分页展示：
  - 数据
  - 星期
  - 月
  - 年
  - 日
  - 时
- 分页上下翻页逻辑
- 每页 4 项内容展示
- `lineEdit_Replace1~4` 文本变化实时写回对应列表
- “预设值”按钮按类型写入对应替换映射

这部分逻辑与原 `DateVarSet` 的替代页行为保持一致。

---

### 3. 在 BarcodeEditor 中补充 DateReplaceEditor 的成对增删逻辑

在 `scene/BarcodeEditor.h/.cpp` 中新增并接入：

- 成员：`DateReplaceEditor *m_dateReplaceEditor = nullptr;`
- 构造函数中实例化 `m_dateReplaceEditor`
- 析构函数中移除对应 tab 并释放对象

联动行为实现如下：

#### 当内容模板包含 `{t}` 时

动态添加两个页签：

- `DateFormatEditor` -> 标题：`日期/时间`
- `DateReplaceEditor` -> 标题：`代替`

并设置尺寸与数据同步。

#### 当内容模板不包含 `{t}` 时

动态移除上述两个页签，确保 `DateFormatEditor` 与 `DateReplaceEditor` 成对出现、成对消失。

#### 在 `bindViewModel()` 中

- 将 `m_vm->dateViewModel()` 转成 `DateFormatEditorVM` 后回填给 `DateFormatEditor`
- 将 `m_vm->dateViewModel()` 直接回填给 `DateReplaceEditor`

从而保证条码编辑器在绑定数据后，两个日期相关页签都能正确显示已有配置。

---

### 4. 打通 BarcodeEditor 中“代替”页的数据回写

在 `BarcodeEditor` 的格式确认逻辑处理中，补充了 `DateReplaceEditor` 到 `BarcodeViewModel` 的数据回写：

- 从 `m_dateReplaceEditor->dateModel()` 取出当前替代配置
- 回写到 `m_vm->dateViewModel()` 的以下字段：
  - `dataMap`
  - `daysMap`
  - `monthsMap`
  - `yearsMap`
  - `weeksMap`
  - `hoursMap`

同时保留 `DateFormatEditor` 对以下日期字段的同步：

- `datetimePattern`
- `daysOffset`
- `monthsOffset`

这样 `BarcodeEditor` 内部对日期格式页和日期替代页的数据已经形成完整闭环。

> 备注：后续如果 `onBtnFormatClicked()` 的业务逻辑再次调整，需要确保上述日期格式和替代数据的回写逻辑继续保留。

---

### 5. 为 DateItemModel 增加默认替代数据构造函数

在 `scene/ViewModels.h` 中为 `DateItemModel` 增加：

- `static DateItemModel createDefaultReplaceModel()`

该函数用于统一构造默认“替代”数据，初始化内容如下：

- `dataMap`：`0-9/A-F`
- `monthsMap`：`01-12`
- `daysMap`：`01-31`
- `weeksMap`：`MON-SUN`
- `hoursMap`：`00-23`
- `yearsMap`：当前年份起连续 16 年，键和值均为年份文本

其默认规则严格参考 `DateVarSet::initReplaceValue()` 的实现，作为公共默认数据来源。

---

### 6. 在 BarcodeEditor 中接入默认替代列表初始化

在 `scene/BarcodeEditor.cpp` 中，使用 `DateItemModel::createDefaultReplaceModel()` 进行了两处接入：

#### 构造函数中

- 为新创建的 `m_vm` 直接设置默认 `dateViewModel`
- 再同步给 `m_dateReplaceEditor`

目的：

- 即便外部还未绑定真实数据，`DateReplaceEditor` 也能拥有完整默认替换列表，不会出现空白替代项。

#### `bindViewModel()` 中

- 对传入的 `dateViewModel` 做兜底检查
- 若以下任意替代字段为空，则仅补齐缺失字段，而不覆盖已有数据：
  - `dataMap`
  - `daysMap`
  - `monthsMap`
  - `yearsMap`
  - `weeksMap`
  - `hoursMap`

目的：

- 保证已有业务数据优先
- 缺失时自动回填默认替代列表
- 避免出现部分字段为空导致编辑器显示异常的问题

---

## 涉及文件

本次涉及的主要文件：

- `scene/DateReplaceEditor.h`
- `scene/DateReplaceEditor.cpp`
- `scene/BarcodeEditor.h`
- `scene/BarcodeEditor.cpp`
- `scene/ViewModels.h`

---

## 当前结果

目前已实现：

- `DateReplaceEditor` 具备独立替代逻辑与数据模型读写能力
- `DateReplaceEditor` 与 `DateFormatEditor` 在 `BarcodeEditor` 中成对出现/删除
- `BarcodeEditor` 可同步和回写替代数据
- `DateItemModel` 可统一生成默认替代列表
- `BarcodeEditor` 已接入默认替代列表初始化和缺失字段兜底

## 后续建议

- 在真正的“确定/保存”入口统一调用 `DateFormatEditor` 与 `DateReplaceEditor` 的回写逻辑，避免后续格式按钮语义变更带来数据遗漏。
- 若后续还有其他编辑器需要复用日期默认替代列表，统一使用 `DateItemModel::createDefaultReplaceModel()`，避免重复维护多份初始化代码。
- 后续如需联调，请先修复 Qt 工程生成链路（`qmake` / `ui_*.h` / includePath / Makefile）后再进行完整编译验证。