# AssetManager UniApp TypeScript 迁移计划

## 项目现状

| 类型 | 文件数 | 代码量 |
|-----|-------|--------|
| Vue 页面 | 6 | ~3,768 行 |
| JS 工具 | 2 | ~350 行 |
| 配置文件 | 3 | ~100 行 |

**迁移目标：** JavaScript → TypeScript，获得类型安全 + IDE 智能提示

---

## Phase 0：基础设施（0.5 天）

### 0.1 安装依赖
```bash
npm install -D typescript @types/node
npm install -D @uni-helper/vite-plugin-uni-types
```

### 0.2 配置文件
- [ ] 创建 `tsconfig.json`
- [ ] 创建 `src/types/` 目录结构
- [ ] 修改 `vite.config.js` → `vite.config.ts`
- [ ] 修改 `main.js` → `main.ts`

### 0.3 目录结构
```
src/
├── types/
│   ├── api.ts          # API 响应类型
│   ├── portfolio.ts    # 组合/持仓类型
│   ├── strategy.ts     # 策略类型
│   └── global.d.ts     # 全局类型声明
├── utils/
│   ├── api.ts          # 迁移自 api.js
│   └── currency.ts     # 迁移自 currency.js
└── pages/
    └── ...
```

---

## Phase 1：类型定义（1 天）

### 1.1 核心类型（与后端 DTO 对齐）

```typescript
// types/portfolio.ts
export interface Portfolio {
  id: string;
  name: string;
  currency: string;
  strategyId?: string;
  status: 'active' | 'archived';
  totalValue: number;
  totalCost: number;
  returnRate: number;
  createdAt: string;
  updatedAt: string;
}

export interface Position {
  id: string;
  portfolioId: string;
  stockCode: string;
  stockName: string;
  assetType: 'Stock' | 'Crypto' | 'Fund';
  shares: number;
  averageCost: number;
  currentPrice: number;
  marketValue: number;
  profitLoss: number;
  profitLossRate: number;
}

export interface Transaction {
  id: string;
  portfolioId: string;
  type: 'buy' | 'sell' | 'dividend';
  stockCode: string;
  stockName: string;
  shares: number;
  price: number;
  amount: number;
  currency: string;
  transactionAt: string;
}

// types/api.ts
export interface ApiResponse<T> {
  code: number;
  message: string;
  data: T;
}

export interface AssetData {
  totalValue: number;
  todayProfit: number;
  todayProfitCurrency: string;
  totalReturnRate: number;
}

// types/strategy.ts
export interface Strategy {
  id: string;
  name: string;
  type: 'RiskParity' | 'MaTrend' | 'ChandelierExit';
  config: RiskParityConfig | MaTrendConfig | ChandelierExitConfig;
  status: 'active' | 'paused';
}

export interface StrategySignal {
  strategyType: string;
  signal: 'BUY' | 'SELL' | 'HOLD' | 'REBALANCE';
  reason: string;
  positionSignals?: PositionSignal[];
  generatedAt: string;
}
```

### 1.2 API 类型定义
- [ ] `types/api.ts` — 请求/响应类型
- [ ] `types/portfolio.ts` — 组合、持仓、交易
- [ ] `types/strategy.ts` — 策略配置、信号
- [ ] `types/user.ts` — 用户信息
- [ ] `types/global.d.ts` — uni-app 全局类型扩展

---

## Phase 2：工具函数迁移（0.5 天）

### 2.1 currency.js → currency.ts
```typescript
// utils/currency.ts
export type CurrencyCode = 'CNY' | 'USD' | 'HKD' | 'EUR' | 'GBP' | 'JPY' | 'SGD' | 'AUD';

export function getCurrencySymbol(currency?: string): string { ... }
export function formatAmount(amount: number, currency?: CurrencyCode, decimals?: number): string { ... }
export function formatAmountWithSign(amount: number, currency?: CurrencyCode, decimals?: number): string { ... }
```

### 2.2 api.js → api.ts
- [ ] 定义请求配置类型
- [ ] 泛型化 `get<T>()`、`post<T>()`、`put<T>()`、`del<T>()`
- [ ] API 返回类型标注
- [ ] 移除 console.log（或改为可配置日志级别）

### 2.3 迁移顺序
1. `currency.js` → `currency.ts`（简单，无依赖）
2. `api.js` → `api.ts`（依赖 Phase 1 的类型定义）

---

## Phase 3：页面组件迁移（2-3 天）

### 迁移优先级

| 优先级 | 页面 | 行数 | 原因 |
|-------|------|------|------|
| 1 | `me.vue` | 259 | 最简单，练手 |
| 2 | `strategies/strategies.vue` | 315 | 结构简单 |
| 3 | `strategies/edit/edit.vue` | 997 | 表单，类型收益大 |
| 4 | `config/config.vue` | 775 | 表单，类型收益大 |
| 5 | `detail/detail.vue` | 1731 | 最复杂，逻辑最多 |
| 6 | `index/index.vue` | 688 | 主页，依赖最多 |

### 迁移步骤（每个页面）
1. 添加 `lang="ts"` 到 `<script>`
2. 定义 `interface` 替代 `data()` 中的隐式类型
3. Props 定义 → `defineProps<T>()`
4. Emits 定义 → `defineEmits<T>()`
5. 函数参数/返回值类型标注
6. 修复类型错误
7. 运行验证

### 3.1 示例：me.vue 迁移
```vue
<script setup lang="ts">
import { ref, onMounted } from 'vue';
import { api } from '@/utils/api';
import type { UserStats } from '@/types/user';

const loading = ref(true);
const userStats = ref<UserStats | null>(null);

onMounted(async () => {
  try {
    const res = await api.user.getUserStats();
    userStats.value = res.data;
  } finally {
    loading.value = false;
  }
});
</script>
```

---

## Phase 4：清理与验证（0.5 天）

- [ ] 删除原 `.js` 文件
- [ ] 更新 `manifest.json` 配置
- [ ] 微信开发者工具验证
- [ ] 真机调试验证
- [ ] 更新 `todo.md` 和 `OPTIMIZATION.md`

---

## 时间估算

| Phase | 内容 | 工时 |
|-------|------|------|
| 0 | 基础设施 | 0.5 天 |
| 1 | 类型定义 | 1 天 |
| 2 | 工具函数 | 0.5 天 |
| 3 | 页面迁移 | 2-3 天 |
| 4 | 清理验证 | 0.5 天 |
| **总计** | | **4-5 天** |

---

## 风险点

| 风险 | 缓解措施 |
|-----|---------|
| uview-plus 类型不全 | 遇到缺失时手写 `.d.ts` 补充 |
| uni-app API 类型 | 使用 `@types/uni-app` 或手写扩展 |
| 微信小程序兼容性 | 每个页面迁移后立即验证 |
| 后端 API 字段变更 | 类型定义与后端 DTO 保持同步 |

---

## 执行顺序建议

```
Day 1: Phase 0 + Phase 1（基础设施 + 类型定义）
Day 2: Phase 2 + Phase 3.1-3.2（工具函数 + 简单页面）
Day 3: Phase 3.3-3.4（中等复杂页面）
Day 4: Phase 3.5-3.6（复杂页面）
Day 5: Phase 4（清理验证 + buffer）
```

---

## 验收标准

- [ ] 所有 `.js` 文件迁移为 `.ts`
- [ ] 所有 Vue 页面添加 `lang="ts"`
- [ ] `tsc --noEmit` 无错误
- [ ] 微信小程序真机运行正常
- [ ] IDE 类型提示正常工作

---

*创建时间：2026-03-24*