Ghostfolio项目：扩展Watchlist端点以支持名称和性能数据

背景介绍

Ghostfolio是一个开源的财富管理平台，近期社区提出了一个功能增强需求，旨在改进其Watchlist（观察列表）功能。当前实现中，Watchlist端点返回的数据结构较为简单，仅包含资产标识信息，而用户期望能够直接获取资产的名称和性能表现数据。

技术实现方案

接口结构调整

原WatchlistResponse接口定义较为基础：

interface WatchlistResponse {
  watchlist: AssetProfileIdentifier[];
}

改进后的接口将扩展为：

interface WatchlistResponse {
  watchlist: (AssetProfileIdentifier & {
    performances: Benchmark['performances'];
  })[];
}

这一变更将资产标识信息与性能数据合并返回，使前端可以一次性获取完整数据，减少后续请求。

性能数据集成

系统将重用现有的BenchmarkService业务逻辑来计算和返回性能数据。这一设计体现了DRY（Don't Repeat Yourself）原则，避免了重复实现相同的性能计算逻辑。

排序优化

响应结果将按照资产名称进行排序，这可以提升用户体验，使观察列表中的资产呈现更加有序。

前端集成

在客户端实现中，需要修改HomeWatchlistComponent组件来适配新的API响应结构。前端将能够直接显示：

• 资产名称
• 各类性能指标（如日/周/月/年收益率等）

技术价值

这一改进带来了多重技术优势：

1. 减少API调用：合并请求降低了网络开销
2. 数据一致性：性能计算逻辑集中维护，避免前后端不一致
3. 用户体验提升：排序功能使列表更易浏览
4. 架构合理性：充分利用现有服务，保持代码简洁

实现建议

对于开发者而言，实现时应注意：

1. 性能计算可能需要考虑缓存机制，特别是对于大量观察项的情况
2. 前端应处理可能的性能数据缺失情况
3. 排序功能应支持本地化，考虑不同语言的排序规则
4. 可考虑添加分页支持，应对观察列表过大的情况

这一改进显著增强了Ghostfolio观察列表功能的实用性和用户体验，同时保持了代码的整洁和可维护性。