# Impact Analysis Report

## 1. 改动概览

- **背景与目标**：按 V5 demo `hkex-trade/recurring-investment.html` 落地「定期投资」页面（计划列表、创建表单、确认弹窗、终止计划），作为应用首页。
- **涉及模块**：路由首页、顶栏导航、i18n、全局主题色、定期投资视图/组件/Store。
- **改动类型**：功能新增 + 视觉令牌对齐。

## 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `src/router/index.ts` | `/` 由 `HomeView` 改为 `RecurringInvestmentView`；`meta.titleKey` 改为 `recurring.title`。 |
| `src/stores/recurringPlans.ts` | 新增 `addPlan` / `cancelPlan` / `runningCount`；内存示例数据，无接口。 |
| `src/views/RecurringInvestmentView.vue` | 新增列表、表单校验、确认弹窗、移动端卡片。 |
| `src/components/recurring/AssetChipPicker.vue` | 新增资产晶片多选与搜索下拉。 |
| `src/composables` / `useUrlPreferences` | 未改；语言主题仍仅走 URL query。 |
| `src/styles/main.scss` / `variables.scss` | 主色与语义色对齐 demo（`--color-primary` 等）；新增 `--color-up/down/warn` 等令牌。 |
| `src/i18n/locales/*` | 新增 `recurring.*` 文案（繁/简/英）。 |
| `src/components/AppHeader.vue` | 已自 `App.vue` 移除引用并删除组件文件；壳层不再展示顶栏标题与导航。 |
| `src/App.vue` | 去掉 `<AppHeader />`，页面内容由 `RouterView` 直接渲染。 |
| `src/styles/element-plus-theme.scss` | 新增：对齐 `--el-*` 输入/选择框 hover、focus 与 `--color-*` 令牌（含 `html.dark` 下 primary RGB）。 |

与原逻辑差异：首页不再展示 ECharts 示例（`HomeView.vue` 仍保留，未挂路由）。表单提交仅写入 Pinia 内存，不调用后端。

## 3. 调用方与影响范围分析

- **路由 `/`**：所有默认入口进入定期投资页。
- **顶栏**：`common.home` 不再作为首页标签；关于页路由不变。
- **主题变量**：`--color-bg` / `--color-muted` / `--color-primary` 变化会影响顶栏与关于页观感（非接口行为）。
- **破坏性变更**：否（无对外 API；旧首页组件文件仍在仓库中）。

## 4. 风险与回滚

- **风险级别**：低。纯前端示例页，计划数据刷新即丢失。
- **主要风险**：移动端表格改为卡片，与 demo 桌面表有布局差异（符合本仓库响应式规范）。
- **回滚**：将 `/` 指回 `HomeView.vue`，并还原主题变量与顶栏文案。
- **回滚方式是否简单**：是。

## 5. 验证与测试

- `npm run build`（vue-tsc + Vite）通过。
- 浏览器冒烟：列表展示、资产搜索选择、校验、确认建立、终止计划、语言/主题 URL 切换、移动端卡片。

## 配置变更

无环境变量或配置中心变更。

---

## 补充：Token、开发代理与服务端多语言（2025-10-08）

### 1. 改动概览

- **背景与目标**：与 Order-H5 一致，支持 URL `token` 写入请求头；本地开发代理到 `192.168.3.233`；通过 `getAllList` 加载服务端多语言。
- **涉及模块**：`vite.config.ts`、`src/api/http.ts`、`src/stores/auth.ts`、`src/stores/serviceI18n.ts`、`src/api/base.ts`、`src/api/scheduleInvestment.ts`、`src/main.ts`、`src/App.vue`。
- **改动类型**：配置变更 + 基础设施。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `vite.config.ts` | `/base`、`/trade` 代理至 `VITE_API_PROXY_TARGET`（默认 `https://192.168.3.233`）。 |
| `.env.development` | `VITE_API_BASE_URL` 置空；新增 `VITE_API_PROXY_TARGET`。 |
| `src/api/http.ts` | 请求头 `token`、`Accept-Language`；统一 `code === '0'` 成功处理。 |
| `src/utils/token.ts` / `stores/auth.ts` | URL 优先解析 token 并持久化（localStorage）。 |
| `stores/serviceI18n.ts` | 拉取 `/base/systemI18n/getAllList` 并按 zh-CN/zh-TW/en-US 映射。 |
| `src/api/scheduleInvestment.ts` | 封装 `POST /trade/schedule-investment/exchanges`。 |
| `src/main.ts` / `App.vue` | 启动与 query 变化时加载服务端 i18n（有 token 时）。 |

语言/主题仍仅 URL 控制，未使用 localStorage。

### 3. 调用方与影响范围

- 所有经 `http` 的请求需有效 token（与后端约定一致）。
- `useServiceI18n().si18n(id)` 供后续对接接口返回的 `*I18nId` 字段。
- **破坏性变更**：否（定期投资页仍用本地 vue-i18n 文案）。

### 4. 风险与回滚

- **风险级别**：低；无 token 时多语言接口可能失败，前端仍可用本地 messages。
- **回滚**：还原 `vite.config.ts`、`.env.development` 与 `http.ts` 拦截器。

### 5. 验证与测试

- `npm run build` 通过。

### 配置变更（本节）

| 配置项 | 含义 | Dev 默认 |
|--------|------|----------|
| `VITE_API_PROXY_TARGET` | Vite 代理目标主机 | `https://192.168.3.233` |
| `VITE_API_BASE_URL` | Axios baseURL，空则同源 | 空 |

---

## 补充：URL accountId / clientId

- **模块**：`src/config/urlContext.ts`、`stores/auth.ts`、`api/http.ts`、`composables/useAccountContext.ts`、`App.vue`
- **行为**：从 query 解析 `clientId`、`accountId`；POST 体自动附带；仅 URL 来源，不持久化 localStorage
- **破坏性变更**：否

---

## 补充：创建表单交易所下拉（2025-10-08）

### 1. 改动概览

- **背景与目标**：在「创建定期投资」表单中，于「資產」字段上方增加交易所代码下拉，数据来自 `POST /api/admin/exchange/getSelectItemList`。
- **涉及模块**：`src/api/exchange.ts`、`src/views/RecurringInvestmentView.vue`、`src/components/recurring/AssetChipPicker.vue`、`vite.config.ts`、i18n。
- **改动类型**：功能新增。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `src/api/exchange.ts` | 新增 `getExchangeSelectItemList()`。 |
| `vite.config.ts` | 开发代理增加 `/api` → `VITE_API_PROXY_TARGET`。 |
| `RecurringInvestmentView.vue` | 挂载时拉取交易所列表；`isEnabled === false` 的项不展示；必填校验；切换交易所清空已选资产；未选交易所时禁用资产选择器。 |
| `AssetChipPicker.vue` | 支持 `disabled` 属性。 |
| `src/i18n/locales/*` | 新增 `recurring.exchange`。 |

### 3. 调用方与影响范围

- 创建表单提交仍写 Pinia 内存，`exchangeCode` 暂未写入 `RecurringPlanDraft`（待对接创建 API 时扩展）。
- **破坏性变更**：否。

### 4. 风险与回滚

- **风险级别**：低；接口需登录 token，失败时下拉为空且表单校验拦截。
- **回滚**：移除交易所字段与 `exchange.ts`，还原 `vite.config.ts` 代理项。

### 5. 验证与测试

- `npm run build` 通过。

### 配置变更（本节）

| 配置项 | 含义 |
|--------|------|
| Vite `server.proxy['/api']` | 转发 admin 等 `/api/*` 接口至后端 |

---

## 补充：资产列表对接 getSimpleStockPage（2025-10-08）

### 1. 改动概览

- **背景与目标**：创建表单在选定交易所后，从 `POST /product/product/getSimpleStockPage` 拉取可投标的，请求体 `exchangeCodes` 为交易所下拉选中值；支持 `searchName`。
- **涉及模块**：`src/api/product.ts`、`vite.config.ts`（`/product` 代理）、`RecurringInvestmentView.vue`、`AssetChipPicker.vue`、`InvestAsset` 类型、i18n。
- **改动类型**：功能新增。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `src/api/product.ts` | 新增 `getSimpleStockPage`、`extractSimpleStockRecords`。 |
| `vite.config.ts` | 开发代理增加 `/product`。 |
| `RecurringInvestmentView.vue` | 交易所变更时请求标的列表；搜索框防抖 300ms 带 `searchName` 重查；映射 `productCode`/`localName`/`productKey` 等到 `InvestAsset`。 |
| `AssetChipPicker.vue` | `loading`、`search` 事件。 |
| `investAssets.ts` | 不再作为创建表单数据源（文件保留）。 |

### 3. 调用方与影响范围

- 资产选择依赖 token 与产品服务可用性；失败时列表为空。
- **破坏性变更**：否。

### 4. 风险与回滚

- **风险级别**：低；`size: 100000` 单次体量较大，需关注后端与网络耗时。
- **回滚**：恢复 `INVEST_ASSETS` 与旧 `AssetChipPicker` 用法，移除 `/product` 代理。

### 5. 验证与测试

- `npm run build` 通过。

---

## 补充：交易所与资产并排布局（2025-10-08）

- **模块**：`RecurringInvestmentView.vue` 表单栅格与 `.field--exchange` / `.field--asset` 样式。
- **行为**：`md+` 同一行各 `12` 列平分；`xs` 仍为两行堆叠。交易所下拉在该行内 `max-width: none` 铺满列宽。
- **破坏性变更**：否。

---

## 补充：资产选择器单选与控件样式对齐（2025-10-08）

- **模块**：`AssetChipPicker.vue`。
- **行为**：资产仅能选一项（新选替换旧选）；未选交易所时展示与 `el-select` 一致的「請選擇」占位文案与 `--color-muted` 色；控件高度与边框/背景对齐 Element Plus 默认输入框（32px、`--color-control-*`）。
- **调用方**：`RecurringInvestmentView.vue` 仍使用 `InvestAsset[]`，最多一项。
- **破坏性变更**：否（原多选 UI 改为单选，业务表单语义仍为单资产创建）。

---

## 补充：定期投资页标题/标签字号加大（2026-10-08）

### 1. 改动概览

- **背景与目标**：表头「資產」、表单标题「創建定期投資」、字段标签「交易所 *」、结束方式切换「期數」等文字偏小，提升可读性。
- **涉及模块**：`src/views/RecurringInvestmentView.vue` 样式。
- **改动类型**：视觉调整（无逻辑变更）。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `.panel-head h2` / `.panel-head--notes h2` | `13px` → `16px`（含「創建定期投資」「我的計劃」等区块标题）。 |
| `.plan-table th` | `10px` → `13px`，字距略收（`0.12em` → `0.08em`）。 |
| `.field label` | `10.5px` → `13px`，字距略收（`0.1em` → `0.06em`）。 |
| `.end-toggle button` | `13px` → `15px`。 |

### 3. 调用方与影响范围

- 仅本页 scoped 样式；表格表头、表单标签、区块标题、结束方式按钮同步变大。
- **破坏性变更**：否。

### 4. 风险与回滚

- **风险级别**：低。
- **回滚方式是否简单**：是（还原上述字号即可）。

### 5. 验证与测试

- 浏览器核对桌面列表表头、创建表单标题/标签/期数切换按钮字号。

---

## 补充：创建表单对齐 schedule-investment 入参（2026-10-08）

### 1. 改动概览

- **背景与目标**：创建定期投资表单字段与交易接口入参一致（投资类型、价格类型、定投周期/执行日、结束类型、交易时间偏移等）；`clientId`/`accountId` 仍由 `http` 拦截器从 Pinia 合并。
- **涉及模块**：`RecurringInvestmentView.vue`、`src/types/scheduleInvestment.ts`、`src/utils/scheduleInvestmentPayload.ts`、`src/api/scheduleInvestment.ts`、`src/types/recurringInvestment.ts`、i18n。
- **改动类型**：功能新增。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| 表单 | 新增 `investmentType`、`orderPriceType`、`frequencyType`、`frequencyDay`、`ctOffsetMinutes`；按金额/数量切换输入；周期仅 DAILY/WEEKLY/MONTHLY。 |
| `buildScheduleInvestmentCreateBody` | 将表单映射为 `ScheduleInvestmentCreateBody`（含 `endType` DATE/COUNT/NONE、`totalExecutionCount`、`productCode`）。 |
| `createScheduleInvestmentPlan` | `POST /trade/schedule-investment/plan/create`；确认建立时调用，成功后仍写入本地示例列表。 |

### 3. 调用方与影响范围

- 创建流程依赖 URL `token`、`clientId`、`accountId` 及后端 create 接口可用。
- **破坏性变更**：否（列表仍用本地 Pinia；表单原「间隔」细粒度选项改为与接口一致的三种周期）。

### 4. 风险与回滚

- **风险级别**：中（create 路径或字段名若与后端不一致需调整 API 封装）。
- **回滚方式是否简单**：是。

### 5. 验证与测试

- `npm run build`；表单校验与确认弹窗预览。

---

## 补充：创建表单控件宽度统一（≥768px 为 70%）

### 1. 改动概览

- **背景与目标**：宽屏下 `el-select` 被 `max-width: 340px` 限制，而 `el-input`、资产选择框为 100% 列宽，视觉不一致；统一为平板及以上宽度占字段区域 70%，移动端仍为 100%。
- **涉及模块**：`RecurringInvestmentView.vue`（`.form-body` 样式）。
- **改动类型**：缺陷修复 / UI。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `.form-body` | 新增 CSS 变量 `--form-control-width`：`100%`（默认）、`respond-up(md)` 时为 `70%`。 |
| `.control-*` / `.end-toggle` / `.asset-wrap` | 移除 `max-width: 340px`，统一使用 `--form-control-width`。 |

### 3. 调用方与影响范围

- 仅定期投资创建表单面板内控件宽度；无脚本与 API 变更。
- **破坏性变更**：否。

### 4. 风险与回滚

- **风险级别**：低。
- **回滚方式是否简单**：是（还原样式块即可）。

### 5. 验证与测试

- 宽屏（≥768px）下交易所、资产、金额/数量、下拉、日期、结束方式切换条宽度一致为 70%；窄屏仍为全宽。

---

## 补充：创建定投接口路径更正

### 1. 改动概览

- **背景与目标**：后端创建计划路径为 `POST /trade/schedule-investment/plan/create`，与前端原 `/trade/schedule-investment/create` 不一致导致 404。
- **涉及模块**：`src/api/scheduleInvestment.ts`。
- **改动类型**：缺陷修复。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `createScheduleInvestmentPlan` | URL 改为 `/trade/schedule-investment/plan/create`；入参 `ScheduleInvestmentCreateBody` 不变。 |

### 3. 调用方与影响范围

- 调用方：`RecurringInvestmentView.vue` 确认建立流程。
- **破坏性变更**：否（仅修正路径）。

### 4. 风险与回滚

- **风险级别**：低。
- **回滚方式是否简单**：是。

### 5. 验证与测试

- 带 `token`、`clientId`、`accountId` 提交创建；确认网络请求路径与响应 `code === 0`。

---

## 补充：交易所下拉改用 schedule-investment/exchanges

### 1. 改动概览

- **背景与目标**：创建表单交易所选项改为 `POST /trade/schedule-investment/exchanges`，不再调用 `/base/exchange/getAllExchanges`。
- **涉及模块**：`scheduleInvestment.ts`、`scheduleInvestment.ts`（类型）、`RecurringInvestmentView.vue`；删除 `src/api/exchange.ts`。
- **改动类型**：缺陷修复 / 接口对齐。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `getScheduleInvestmentExchanges` | 返回类型 `ScheduleInvestmentExchangeItem[]`（`exchangeCode`、`nameI18nId`、`tradeDate`）。 |
| `loadExchangeOptions` | 调用上述接口；展示文案仍经 `si18n(nameI18nId)`。 |
| `exchange.ts` | 已删除。 |

### 3. 调用方与影响范围

- 仅定期投资页交易所下拉；资产搜索仍用 `getSimpleStockPage` + `exchangeCodes`。
- **破坏性变更**：否。

### 4. 风险与回滚

- **风险级别**：低（若 `data` 非数组需再适配分页结构）。
- **回滚方式是否简单**：是。

### 5. 验证与测试

- 打开创建表单，交易所下拉有数据且标签为 i18n 名称；切换后资产列表正常加载。

---

## 补充：我的计划列表对接 plan/page

### 1. 改动概览

- **背景与目标**：「我的定期投資計劃」由 `POST /trade/schedule-investment/plan/page` 拉取，仅传分页 `current`/`size`，其余筛选项传空字符串；移除 Pinia 内存示例数据。
- **涉及模块**：`scheduleInvestment.ts`（API/类型）、`scheduleInvestmentPlanMapper.ts`、`recurringPlans.ts`、`RecurringInvestmentView.vue`、i18n。
- **改动类型**：功能新增。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `getScheduleInvestmentPlanPage` | `current`+`size` 及空筛选字段请求；映射 `records` → `RecurringPlan`。 |
| `loadPlans` | 挂载与创建成功后刷新列表；`runningCount` 按非终止状态统计。 |
| `recurringPlans` store | 去掉 `addPlan` 与种子数据，改为 `setPlans`。 |

### 3. 调用方与影响范围

- 列表展示金额/数量、周期+执行日、结束日期/期数/无结束；终止按钮仍为本地状态（待对接终止 API）。
- **破坏性变更**：否。

### 4. 风险与回滚

- **风险级别**：低（分页暂取第一页 `size=50`；若 `current` 须从 0 起需再对齐）。
- **回滚方式是否简单**：是。

### 5. 验证与测试

- 进入页面请求 `plan/page`；创建成功后列表刷新；`ACTIVE` 计入进行中数量。

---

## 补充：创建入参字段 qtyPerExecution

- **改动**：`ScheduleInvestmentCreateBody` 与 `buildScheduleInvestmentCreateBody` 中按数量定投字段由 `quantityPerExecution` 改为 `qtyPerExecution`，与接口及列表 `records` 一致。
- **破坏性变更**：否（仅请求 JSON 字段名）。
- **风险**：低。

---

## 补充：限价单 limitPrice

- **改动**：`orderPriceType === 'LIMIT'` 时表单展示「限价」输入，校验 `> 0`，创建请求体附带 `limitPrice`；市价单不传该字段。
- **涉及**：`RecurringInvestmentView.vue`、`scheduleInvestmentPayload.ts`、`ScheduleInvestmentCreateBody`、i18n。
- **破坏性变更**：否。
- **风险**：低。

---

## 补充：创建计划 productEngName / productLocalName

- **改动**：`getSimpleStockPage` 映射保留 `engName`、`localName`；`buildScheduleInvestmentCreateBody` 写入 `productEngName`、`productLocalName`。
- **破坏性变更**：否。
- **风险**：低。

---

## 补充：计划列表「详情」弹窗（2026-10-09）

### 1. 改动概览

- **背景与目标**：我的计划列表「操作」列增加「详情」，调用 `POST /trade/schedule-investment/plan/detail`（`planNo`）弹窗展示计划要点与最近执行记录。
- **涉及模块**：`src/api/scheduleInvestment.ts`、`src/types/scheduleInvestment.ts`、`RecurringInvestmentView.vue`、i18n（zh-TW / zh-CN / en-US）。
- **改动类型**：功能新增。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `getScheduleInvestmentPlanDetail` | 新增详情接口封装。 |
| 类型 `ScheduleInvestmentPlanDetailData` 等 | 描述 `plan` + `recentExecutions` 响应结构。 |
| `openPlanDetail` / 详情 `el-dialog` | 加载详情、格式化周期/结束/投资方式等字段；执行记录表格或空态。 |
| 列表操作列 / 移动卡片 | 「详情」与「终止」并列。 |

### 3. 调用方与影响范围

- 依赖列表项 `planNo`（来自 `plan/page` 映射）；无 `planNo` 时前端提示，不发起请求。
- **破坏性变更**：否。

### 4. 风险与回滚

- **风险级别**：低（只读查询；失败由 http 拦截器提示）。
- **回滚方式是否简单**：是（移除按钮与 API 封装即可）。

### 5. 验证与测试

- `npm run build`；列表点击详情，核对弹窗字段与空执行记录文案。

### 补充（2026-10-09）

- 详情弹窗不再展示「渠道」；「交易所」通过 `getScheduleInvestmentExchanges` 缓存与创建表单相同逻辑（`si18n(nameI18nId)`）反显文案，无匹配时回退 `exchangeCode`。
- 产品行 `productLocalName` / `productEngName`：`en-US` 优先英文，简繁优先本地名（`investAssetDisplay.ts`）；列表映射保留双语字段，切换 URL `lang` 后名称随语言更新。
- 计划「終止」：`el-dialog` 二次确认 + 选填 `terminateReason`，调用 `POST /trade/schedule-investment/plan/terminate`（`planNo`），成功后 `loadPlans` 刷新列表。

---

## 补充：创建表单「预览下次执行」（2026-10-09）

### 1. 改动概览

- **背景与目标**：创建计划表单底部增加「预览下次执行」，调用 `POST /trade/schedule-investment/plan/next-execution`，在弹窗展示节假日调整后的执行日与时点。
- **涉及模块**：`src/api/scheduleInvestment.ts`、`src/types/scheduleInvestment.ts`、`RecurringInvestmentView.vue`、i18n（zh-TW / zh-CN / en-US）。
- **改动类型**：功能新增。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `previewScheduleInvestmentNextExecution` | 新增 next-execution 接口封装。 |
| `ScheduleInvestmentNextExecutionRequest` / `Data` | 描述请求与响应字段。 |
| `validateNextExecutionPreview` / `openNextExecutionPreview` | 校验交易所、周期、执行日（周/月）、CT 偏移；`startDate` 选填传入。 |
| 创建表单 `form-actions` | 增加按钮与预览 `el-dialog`（`ri-preview` 样式）。 |

### 3. 调用方与影响范围

- 仅创建表单使用；不改动「继续」全流程校验（仍要求标的、金额等）。
- **破坏性变更**：否。

### 4. 风险与回滚

- **风险级别**：低（只读预览；失败由 http 拦截器提示）。
- **回滚方式是否简单**：是。

### 5. 验证与测试

- `npm run build`；填写交易所与周期后点击预览，核对弹窗字段与 `deferred` 文案。

---

## 补充：创建表单 CT 偏移选项接口（2026-10-10）

### 1. 改动概览

- **背景与目标**：「交易時間偏移」由 `POST /trade/schedule-investment/options/ct-time`（`exchangeCode`、`productCode`）拉取选项，下拉展示 `displayName`，取值 `offsetMinutes`。
- **涉及模块**：`src/api/scheduleInvestment.ts`、`src/types/scheduleInvestment.ts`、`RecurringInvestmentView.vue`、i18n（zh-TW / zh-CN / en-US）。
- **改动类型**：功能新增。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `getScheduleInvestmentCtTimeOptions` | 新增 ct-time 接口封装。 |
| `ScheduleInvestmentCtTimeOptionsRequest` / `Data` / `Option` | 描述请求与 `options` 列表结构。 |
| `loadCtOffsetOptions` / `watch` | 交易所与标的变更时请求；当前偏移不在列表时回退首项。 |
| 创建表单 CT 字段 | `el-input-number` 改为可筛选 `el-select`；未选标的时禁用。 |
| `isCtOffsetValid` | 有选项时校验是否在列表内；无选项时保留 0–240 兜底。 |

### 3. 调用方与影响范围

- 仅创建计划表单；创建/预览请求体仍传 `ctOffsetMinutes` 数值。
- **破坏性变更**：否（交互由手输改为下拉，选项由后端决定）。

### 4. 风险与回滚

- **风险级别**：低（依赖交易所+产品；失败时选项为空、字段禁用，提交校验不通过）。
- **回滚方式是否简单**：是。

### 5. 验证与测试

- `npm run build`；选择交易所与资产后确认下拉加载与提交偏移值正确。

---

## 补充：计划列表金额/数量展示（2026-10-09）

### 1. 改动概览

- **背景与目标**：移动卡片按 `investmentType` 区分「金额」「数量」标签；桌面列表表头统一为「金额/数量」。
- **涉及模块**：`RecurringInvestmentView.vue`、`src/i18n/locales/*`（`recurring.colAmount`）。
- **改动类型**：缺陷修复 / 文案对齐。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `planInvestmentLabel` | 新增：`QUANTITY` → `recurring.quantity`，否则 `recurring.amount`；用于移动卡片 meta 的 `<dt>`。 |
| `recurring.colAmount`（三语） | 由单一「金额」改为「金额/数量」（与 `planDetail.colAmount` 一致），用于计划列表表头。 |

### 3. 调用方与影响范围

- 计划列表移动卡片与桌面表头文案；单元格数值仍由 `planInvestmentDisplay` 输出。
- **破坏性变更**：否。

### 4. 风险与回滚

- **风险级别**：低。
- **回滚方式是否简单**：是。

### 5. 验证与测试

- `npm run build`；列表含 AMOUNT / QUANTITY 计划时核对卡片标签与表头。

---

## 补充：计划列表资产列省略与 Tooltip（2026-10-09）

### 1. 改动概览

- **背景与目标**：桌面计划表「资产」列限制宽度，长名称单行省略，悬停 `el-tooltip` 展示全文。
- **涉及模块**：`RecurringInvestmentView.vue`（`planAssetCellText`、表样式 `plan-table__asset-*`）。
- **改动类型**：体验优化。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `planAssetCellText` | 拼接代码、名称与 `+N` 多标的后缀，供 tooltip 与展示一致。 |
| `plan-table` | `table-layout: fixed`；资产列宽约 220px；内层 `text-overflow: ellipsis`。 |

### 3. 调用方与影响范围

- 仅「我的计划」桌面表格首列；移动卡片不变。
- **破坏性变更**：否。

### 4. 风险与回滚

- **风险级别**：低。
- **回滚方式是否简单**：是。

### 5. 验证与测试

- `npm run build`；长产品名悬停可见完整 tooltip。

---

## 补充：移动计划卡片操作按钮样式（2026-10-09）

### 1. 改动概览

- **背景与目标**：移动卡片「详情 / 终止」与桌面表一致，纯文字链接、无边框。
- **涉及模块**：`RecurringInvestmentView.vue`（复用 `detail-link` / `cancel-link`）。
- **改动类型**：体验优化。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| 计划卡片 `plan-card__actions` | 按钮类名改为 `detail-link`、`cancel-link`；移除 `plan-card__detail` / `plan-card__cancel` 边框样式。 |

### 3. 调用方与影响范围

- 仅移动端计划卡片底部操作区。
- **破坏性变更**：否。

### 4. 风险与回滚

- **风险级别**：低。
- **回滚方式是否简单**：是。

### 5. 验证与测试

- 移动断点下核对详情（主色）、终止（跌色）文字与悬停下划线。

---

## 补充：清理脚手架示例（2026-10-09）

### 1. 改动概览

- **背景与目标**：接口已全部对接，移除未使用的 ECharts 示例、关于页、静态资产列表与相关依赖/文案。
- **涉及模块**：路由、视图/组件删除、`i18n`、`main.scss`、`package.json`、文档。
- **改动类型**：重构 / 清理。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| 删除 `SampleChart.vue`、`HomeView.vue`、`AboutView.vue` | 不再保留未挂路由或纯技术栈展示的页面。 |
| 删除 `constants/investAssets.ts` | 创建表单资产已由 `getSimpleStockPage` 提供，静态列表无引用。 |
| `router/index.ts` | 移除 `/about`；首页路由名改为 `recurring-investment`。 |
| `package.json` | 移除 `echarts` 依赖。 |
| `main.scss` | 移除仅示例图表使用的 `--chart-height`、`--color-chart-*`。 |
| `i18n` | 移除 `home.*`、`common.home`/`common.about`；新增 `recurring.amountPlaceholder`。 |
| `RecurringInvestmentView.vue` | 金额输入 placeholder 改为 i18n。 |

### 3. 调用方与影响范围

- 无对外 API；用户若曾收藏 `/about` 将 404（本应用此前无入口链至该页）。
- **破坏性变更**：否（功能面仅删除未使用示例）。

### 4. 风险与回滚

- **风险级别**：低。
- **回滚方式是否简单**：是（自 Git 恢复删除文件与依赖）。

### 5. 验证与测试

- `npm run build`。
- 冒烟：定期投资列表/创建/详情/终止、语言切换。

---

## 补充：URL `lang` 短码与 README（2026-10-10）

### 1. 改动概览

- **背景与目标**：文档与地址栏统一使用 `zh` / `tw` / `en` 作为 `lang` 查询参数；完善 README。
- **涉及模块**：`src/config/appLocale.ts`、`src/config/urlPreferences.ts`、`README.md`、`.cursor/rules/project-core.mdc`。
- **改动类型**：配置/文档 + 行为小幅调整。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `appLocale.ts` | 新增 `URL_LANG_CODES`、`resolveLocaleFromLangParam`、`localeToUrlLang`；短码映射到内部 `zh-CN` / `zh-TW` / `en-US`。 |
| `urlPreferences.ts` | 读入经 `resolveLocaleFromLangParam`；写出 `preferencesToQuery` 使用短码。 |
| `README.md` | 补充环境、目录、URL 参数表与示例（`lang=zh|tw|en`）。 |

仍接受旧 URL `lang=zh-TW` 等；切换或写入 query 时地址栏为 `tw` 等短码。

### 3. 调用方与影响范围

- **调用方**：`parsePreferencesFromSearch` / `parsePreferencesFromQuery` / `preferencesToQuery`（`main.ts`、`app` store、`useUrlPreferences`）。
- 内部 `AppLocale` 与 vue-i18n 键名不变；仅 URL 展示与解析规则扩展。
- **破坏性变更**：否（旧长格式仍可读；书签若依赖写出为长格式，首次 replace 后会变为短码）。

### 4. 风险与回滚

- **风险级别**：低。
- **回滚方式是否简单**：是（还原 `appLocale` / `urlPreferences` 与文档）。

### 5. 验证与测试

- `npm run build`：通过。
- 建议手工：`?lang=zh`、`?lang=tw`、`?lang=en` 及 `?lang=zh-TW` 兼容读取。

---

## 补充：Vite 开发服局域网 / 隧道访问（2026-10-10）

### 1. 改动概览

- **背景与目标**：`npm run dev` / `preview` 可通过本机 IP 或穿透域名访问，不限于 localhost。
- **涉及模块**：`vite.config.ts`、`README.md`。
- **改动类型**：配置变更。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `vite.config.ts` | `server.host: true`、`server.allowedHosts: true`；`preview` 同步 `host` / `allowedHosts`。 |

### 3. 调用方与影响范围

- 仅本地/内网开发体验；生产构建产物不变。
- **破坏性变更**：否。

### 4. 风险与回滚

- **风险级别**：低（开发机需自行注意防火墙与勿暴露敏感环境）。
- **回滚方式是否简单**：是。

### 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`。

---

## 补充：VITE_BASE_URL 接入 Vite base（2026-10-10）

### 1. 改动概览

- **背景与目标**：`.env.development` 已配置 `VITE_BASE_URL=/recurring-investment`，需写入 Vite `base`，使静态资源与 Vue Router 子路径部署一致。
- **涉及模块**：`vite.config.ts`、`src/env.d.ts`、`.env.production`、`README.md`。
- **改动类型**：配置变更。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `vite.config.ts` | `loadEnv` 读取 `VITE_BASE_URL`，经 `resolveViteBase` 设置 `base`（子路径末尾补 `/`）。 |
| `.env.production` | 新增，与开发环境一致的 `VITE_BASE_URL` / `VITE_API_BASE_URL`。 |
| `src/router/index.ts` | 无改；已使用 `createWebHistory(import.meta.env.BASE_URL)`。 |

### 3. 调用方与影响范围

- 开发与生产入口 URL 为 `/recurring-investment/`（非根路径 `/`）。
- 网关/Nginx 需将应用挂载到同子路径或做等价转发。
- **破坏性变更**：是（若此前按根路径 `/` 访问或部署，需改为带子路径）。

### 4. 风险与回滚

- **风险级别**：低。
- **回滚**：删除或清空 `VITE_BASE_URL`，移除 `vite.config.ts` 的 `base` 绑定。
- **回滚方式是否简单**：是。

### 5. 验证与测试

- `npm run build`；本地 `npm run dev` 访问 `http://localhost:5173/recurring-investment/`。

---

## 补充：仅创建计划请求体携带 clientId / accountId（2026-10-10）

### 1. 改动概览

- **背景与目标**：除「新建定投计划」外，其余交易/产品/基础接口不应在请求体中附带 URL 解析的 `clientId`、`accountId`。
- **涉及模块**：`src/api/http.ts`。
- **改动类型**：缺陷修复。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `src/api/http.ts` | 移除请求拦截器对 POST `data` 的全局合并 `clientId`/`accountId`。 |
| `src/utils/scheduleInvestmentPayload.ts` / `RecurringInvestmentView.vue` | 无改；创建计划仍通过 `buildScheduleInvestmentCreateBody` 显式写入两字段。 |

### 3. 调用方与影响范围

- 经 `http` 的列表、详情、终止、CT 选项、下次执行预览、`getSimpleStockPage`、`getAllList` 等不再自动附带账户上下文。
- **破坏性变更**：否（与后端契约对齐；创建接口行为不变）。

### 4. 风险与回滚

- **风险级别**：低。
- **回滚**：恢复 `http.ts` 拦截器中的合并逻辑。
- **回滚方式是否简单**：是。

### 5. 验证与测试

- `npm run build`；创建计划请求体仍含 `clientId`/`accountId`；其它 POST 仅含业务字段。

---

## 补充：资产下拉分页与滚动加载（2026-10-10）

### 1. 改动概览

- **背景与目标**：创建表单资产搜索不再单次请求 `size: 100000`；改为每页 50 条，下拉滚动触底追加加载。
- **涉及模块**：`RecurringInvestmentView.vue`、`AssetChipPicker.vue`、i18n。
- **改动类型**：性能优化 / 体验改进。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `RecurringInvestmentView.vue` | `loadExchangeAssets` 支持 `current` 递增与 `append`；维护 `assetHasMore` / `assetPage` / `assetSearchKeyword`；`onAssetLoadMore` 处理触底。 |
| `AssetChipPicker.vue` | `.asset-drop` 滚动监听，触发 `loadMore`；展示 `hasMore` / `loadingMore` 底部提示。 |
| i18n | 新增 `recurring.assetScrollHint`。 |

### 3. 调用方与影响范围

- 仅定期投资创建表单资产晶片；搜索防抖仍传 `searchName` 并重置为第一页。
- **破坏性变更**：否。

### 4. 风险与回滚

- **风险级别**：低；若后端 `current` 为 1 起始需与现用 0 起始对齐（与原实现一致）。
- **回滚**：恢复单次大 `size` 请求并移除 `loadMore` 链路。
- **回滚方式是否简单**：是。

### 5. 验证与测试

- `npm run build`；交易所切换、搜索、下拉滚动加载更多。

---

## 补充：下次执行预览移除执行时间行（2026-10-10）

### 1. 改动概览

- **背景与目标**：预览弹窗不再展示 `executionDateTime`（`recurring.previewExecutionDateTime`）。
- **涉及模块**：`RecurringInvestmentView.vue`。
- **改动类型**：界面调整。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| 下次执行预览 `<dl>` | 删除 `executionDateTime` 的 `<dt>`/`<dd>`；接口数据仍可能返回该字段，仅不展示。 |

### 3. 调用方与影响范围

- 仅预览弹窗展示；**破坏性变更**：否。

### 4. 风险与回滚

- **风险级别**：低；**回滚方式是否简单**：是（恢复两行模板）。

### 5. 验证与测试

- 打开「下次执行」预览，确认无「执行时间」行，其余字段正常。

---

## 补充：下次执行预览接口字段与加载态（2026-10-12）

### 1. 改动概览

- **背景与目标**：`POST /trade/schedule-investment/plan/next-execution` 响应 `data` 调整为 `nextExecutionDate`、`nextExecutionTime`；预览弹窗同步展示；请求较慢时按钮与弹窗内展示 loading。
- **涉及模块**：`src/types/scheduleInvestment.ts`、`RecurringInvestmentView.vue`。
- **改动类型**：缺陷修复 / 界面调整。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `ScheduleInvestmentNextExecutionData` | 移除 `scheduledDate`、`executionDate`、`executionDateTime`、`deferred`、`ctOffsetMinutes`；改为 `nextExecutionDate`、`nextExecutionTime`。 |
| `openNextExecutionPreview` | 请求期间按钮 loading；数据返回后再打开弹窗。 |
| 预览弹窗模板 | 仅展示下次执行日、执行时间。 |
| 「预览下次执行」按钮 | `:loading="nextExecutionPreviewLoading"`。 |

### 3. 调用方与影响范围

- 仅创建表单预览流程；**破坏性变更**：是（依赖旧响应字段的前端逻辑已移除，与当前后端契约一致）。

### 4. 风险与回滚

- **风险级别**：低；**回滚方式是否简单**：是（恢复类型与模板）。

### 5. 验证与测试

- 填妥交易所与周期后点「预览下次执行」：按钮 loading、弹窗内 loading，成功后显示日期与时间；接口失败时弹窗关闭且已有错误提示。

---

## 补充：创建计划 productCode 入参（2026-10-12）

### 1. 改动概览

- **背景与目标**：创建定投计划（及 CT 时间选项）应提交接口字段 `productCode`（如 `1`），不得使用展示用 `productCodeUnique`（如 `1.HK`）。
- **涉及模块**：`InvestAsset`、`mapSimpleStockToAsset`、`buildScheduleInvestmentCreateBody`、`resolvePickedProductCode`、`scheduleInvestmentPlanMapper`。
- **改动类型**：缺陷修复。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `InvestAsset` | 新增 `productCode`（接口用），与 `productCodeUnique`（展示用）区分。 |
| `mapSimpleStockToAsset` | 从 `getSimpleStockPage` 写入 `productCode`；`code` 仍为 `productCodeUnique` 优先。 |
| `buildScheduleInvestmentCreateBody` | `productCode` 仅取自 `asset.productCode`。 |
| `resolvePickedProductCode` | CT 选项请求与创建计划一致，仅用 `asset.productCode`。 |

### 3. 调用方与影响范围

- 创建计划、`options/ct-time`；**破坏性变更**：否（修正错误入参）。

### 4. 风险与回滚

- **风险级别**：低；**回滚方式是否简单**：是。

### 5. 验证与测试

- 选择 SEHK `1.HK` 资产创建计划，请求体 `productCode` 为 `1`；CT 偏移选项请求同上。

---

## 补充：计划详情执行记录移除委托状态列（2026-10-12）

### 1. 改动概览

- **背景与目标**：计划详情「最近执行」表格不再展示委托状态。
- **涉及模块**：`RecurringInvestmentView.vue`、三语言 `planDetail.colOrderStatus`。
- **改动类型**：界面调整。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `detail-exec-table` | 删除 `colOrderStatus` 表头与 `row.orderStatus` 单元格。 |

### 3. 调用方与影响范围

- 仅详情弹窗执行记录表；**破坏性变更**：否（接口仍可能返回 `orderStatus`，前端不展示）。

### 4. 风险与回滚

- **风险级别**：低；**回滚方式是否简单**：是。

### 5. 验证与测试

- 打开计划详情，确认执行记录表为四列：计划执行日、实际交易日、金额/数量、执行状态。

---

## 补充：计划详情执行记录成交字段列（2026-10-13）

### 1. 改动概览

- **背景与目标**：详情「最近执行」表去掉「实际交易日」，展示关联委托成交的 `filledQty`、`filledAmount`、`avgFilledPrice`。
- **涉及模块**：`ScheduleInvestmentPlanExecutionRecord`、`RecurringInvestmentView.vue`、三语言 `planDetail` 列文案。
- **改动类型**：界面调整 + 类型扩展。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `ScheduleInvestmentPlanExecutionRecord` | 新增可选字段 `filledQty`、`filledAmount`、`avgFilledPrice`。 |
| `detail-exec-table` | 移除 `actualTradeDate` 列；新增三列及 `formatExecutionFilledQty/Amount/AvgFilledPrice` 格式化。 |
| i18n | 删除 `colActualDate`；新增 `colFilledQty`、`colFilledAmount`、`colAvgFilledPrice`。 |

### 3. 调用方与影响范围

- 仅计划详情弹窗执行记录表；数据来自 `recentExecutions`，无额外请求。**破坏性变更**：否（列展示调整，接口字段向后兼容）。

### 4. 风险与回滚

- **风险级别**：低；**回滚方式是否简单**：是。

### 5. 验证与测试

- 打开计划详情，确认列为：计划执行日、金额/数量、成交数量、成交金额、成交均价、执行状态；无成交数据时三列显示 `0` 或 `—`（字段缺失为 `—`，数值 `0` 正常格式化）。

---

## 补充：计划详情「最近执行」响应式布局（2026-10-13）

### 1. 改动概览

- **背景与目标**：执行记录列增多后，加宽详情弹窗、移动端卡片化、平板横滑提示与表头首列 sticky。
- **涉及模块**：`RecurringInvestmentView.vue`、三语言 `executionTableScrollHint`。
- **改动类型**：界面 / 响应式。

### 2. 方法级改动分析

| 位置 | 差异 |
|------|------|
| `detailDialogWidth` | 移动 `520px`、平板 `720px`、桌面 `920px`（均 `96vw` 上限）。 |
| `detail-exec-block` | `<768px` 每条执行为卡片；否则表格 + `.app-table-scroll`。 |
| `.detail-exec-table` | 紧凑 padding、表头可换行、计划执行日列 sticky。 |

### 3. 调用方与影响范围

- 仅计划详情弹窗；**破坏性变更**：否。

### 4. 风险与回滚

- **风险级别**：低；**回滚方式是否简单**：是。

### 5. 验证与测试

- 移动宽：执行记录为卡片，无横向挤压。
- 平板 / 窄桌面：表格可横滑，见提示文案；首列固定。
- 宽桌面：弹窗加宽后六列表格可读。