# AssetManager 项目进度追踪

---

## 🎯 项目核心定位（重要）

1. **底层是记账本**：每个组合 = 一个独立账本，记录买入卖出，跟普通记账一样
2. **中间层是价格引擎**：对接市场数据，实时获取资产价格
3. **上层是策略信号**：基于价格走势和策略配置，给出交易建议

---


## ✅ 已完成

### P0（核心功能）
- [x] P0-1: 实时价格/盈亏计算 - GetPortfolioById 对接 MarketDataService，计算当前市值、持仓盈亏、组合收益率
- [x] P0-2: 汇率服务接口预留 - 定义 IExchangeRateService 接口，支持币种换算（Mock 实现）
- [x] P0-3: 前端对齐 API - 前端 api.js 对齐后端路径，修正 typo

### 其他已完成
- 记账核心：组合 CRUD、持仓管理、交易流水记录
- 策略引擎骨架：策略引擎接口、计算器接口、依赖注入
- 技术指标库：SMA、EMA、ATR、TR、滚动最高/最低价
- 策略实现：吊灯止损、双均线（金叉/死叉）、风险平价（半实现）
- Mock 市场数据：MockMarketDataService，生成模拟 K 线
- 策略信号 API：GET /api/v1/portfolio/{id}/signal
- 多币种支持：CNY/USD/HKD 枚举、用户默认本位币、API 入参校验
- API 注释：PortfolioController 已加完整 XML 注释

---

## 📋 待办

### P1（重要功能，优先做）
- [x] P1-1: 今日盈亏逻辑 - 基于上一交易日收盘价计算今日盈亏，无需每日快照
- [x] P1-3: 风险平价策略补全 - 使用实时市值计算权重，阈值判断更精细
- [x] P1-4: Swagger 完整注释 - 给 StrategyController、AuthController、UserController 也加完整注释

### 已修复的问题
- [x] 微信登录路径：保持现状 `/api/auth/wechat-login`，已更新 API 设计文档
- [x] GetTotalAssets 实现优化：使用汇率服务统一换算到用户默认本位币，计算总收益率
- [x] CreateTransaction 更新组合总价值：使用实时市值而不是成本价


### P2（优化功能，有空做）
- [ ] P2-1: 真实市场数据接入 - 接入 Alpaca/OKX/Yahoo Finance 等真实数据源（替代 Mock）
- [ ] P2-2: 策略回测框架 - 支持用历史数据回测策略表现
- [ ] P2-3: 信号推送通知 - 信号触发时给用户发通知（微信模板消息/邮件等）
- [ ] P2-4: 批量计算信号 - 支持定时任务批量计算所有用户的策略信号