Justin/g3fo-recurring-investment
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
b73db1b1935b731af456e15e2177bb9efcd7c42d
g3fo-recurring-investment/IMPACT_ANALYSIS.md
T
justin b73db1b193 Enhance recurring investment plan details and API integration: 
- Introduce `productCode` for API submissions, differentiating it from `productCodeUnique`.
- Remove `actualTradeDate` and `orderStatus` from the execution records table, adding `filledQty`, `filledAmount`, and `avgFilledPrice` instead.
- Implement responsive design adjustments for the execution records display across devices.
- Update internationalization files to reflect new column names and hints for table navigation.
- Document changes in `IMPACT_ANALYSIS.md` and `TASK_SUMMARY.md` for clarity on the updates.
2026-10-13 11:25:10 +08:00

1020 lines
41 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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. 验证与测试
- 移动宽：执行记录为卡片，无横向挤压。
- 平板 / 窄桌面：表格可横滑，见提示文案；首列固定。
- 宽桌面：弹窗加宽后六列表格可读。
Reference in New Issue View Git Blame Copy Permalink