frequencyday的值约定

2026-10-10 14:16:32 +08:00
parent 833990b2b5
commit 6f6509f97d
7 changed files with 213 additions and 23 deletions
@@ -706,3 +706,35 @@
 ### 5. 验证与测试

 - `npm run dev`：终端出现 Network URL；同网段可打开页面。
+
+---
+
+## 补充：frequencyDay 与后端约定对齐（2026-10-10）
+
+### 1. 改动概览
+
+- **背景与目标**：后端 `WEEKLY` 支持 `1`–`7`（ISO 周一=1）、英文全名/三字码；`MONTHLY` 支持 `1`–`31`（可带前导零）；`DAILY` 不传 `frequencyDay`。前端提交已用 `MON`…`SUN` 与 `1`…`31`，需兼容接口回显。
+- **涉及模块**：`src/utils/frequencyDay.ts`（新增）、`scheduleInvestmentPlanMapper.ts`、`RecurringInvestmentView.vue`。
+- **改动类型**：缺陷修复 / 行为对齐。
+
+### 2. 方法级改动分析
+
+| 位置 | 差异 |
+|------|------|
+| `frequencyDay.ts` | `normalizeWeeklyDayToCode`、`normalizeMonthlyDay`、`formatFrequencyDayLabel`。 |
+| `scheduleInvestmentPlanMapper.ts` | 列表映射时将 `frequencyDay` 规范为表单/i18n 可用值。 |
+| `RecurringInvestmentView.vue` | 计划列表、详情频率、确认预览统一走 `formatFrequencyDayLabel`。 |
+
+### 3. 调用方与影响范围
+
+- 创建/预览请求体：`DAILY` 不传 `frequencyDay`；`WEEKLY`/`MONTHLY` 经 `frequencyDayForApi` 仅提交数字字符串（周 `1`–`7`，月 `1`–`31`）。
+- **破坏性变更**：否。
+
+### 4. 风险与回滚
+
+- **风险级别**：低。
+- **回滚方式是否简单**：是。
+
+### 5. 验证与测试
+
+- `npm run build`。