# TradeTracker

**Repository Path**: cathero2001/trade-tracker

## Basic Information

- **Project Name**: TradeTracker
- **Description**: 记录分析展示交易成绩的工具
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2025-05-31
- **Last Updated**: 2025-09-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Trading Analyzer

一个用于分析交易记录的工具，支持从TradingView中的TradeStation账户导出的期货交易记录进行分析和统计。

## 功能特点

1. 导入交易记录
   - 支持从TradingView中的登录的TradeStation账户导出的CSV文件
   - 自动识别新订单并追加到系统

2. 交易对分析
   - 自动配对开仓和平仓订单
   - 计算交易对的关键指标
   - 支持手动补充交易对信息

3. 统计分析
   - 日/周/月/季度/年度统计
   - 胜率、盈亏比等关键指标
   - 可视化统计结果

## 安装说明

1. 确保已安装Python 3.8或更高版本
2. 安装依赖包：
   ```bash
   pip install -r requirements.txt
   ```

## 使用说明

1. 运行程序：
   ```bash
   python main.py
   ```

2. 导入交易记录：
   - 点击"Import Orders"标签页
   - 选择从TradingView->TradeStation导出的CSV文件

3. 查看和编辑交易对：
   - 在"Trades"标签页查看所有交易对
   - 选择交易对并点击"Edit"进行编辑

4. 查看统计信息：
   - 在"Edgewonk统计"标签页查看各类统计指标

## 数据文件

- `data/orders.csv`: 存储原始订单数据
- `data/trades.csv`: 存储交易对数据

## 注意事项

1. 确保导出的CSV文件格式正确，示例csv文件在sample文件中
2. 定期备份数据文件

# 自动化交易记录工具 - 网页端使用说明

本项目包含多个用于交易数据管理和分析的网页，主要包括：

- `import.html`：订单导入页面（已集成到 trades 页面）
- `trades.html`：交易明细管理与导入页面
- `statistics.html`：统计分析与可视化页面

## 1. trades.html —— 交易明细管理与导入

**用途：**  
用于浏览、筛选、导出和管理所有交易明细，并支持直接导入CSV订单。

**主要功能：**
- 以表格形式展示所有交易记录
- 支持自定义显示/隐藏表格列
- 支持按条件筛选、排序
- 支持导出为 CSV 文件
- 支持编辑、删除单笔交易（如有权限）
- **支持直接导入CSV订单文件**

**导入功能说明：**
- 在页面表格上方有"导入CSV"按钮，点击后选择本地CSV文件即可上传。
- 导入完成后会弹窗显示详细结果，包括：
  - 新交易数
  - 重复订单数
  - 重复交易数
- 导入成功后自动刷新表格。

**使用方法：**
1. 打开"交易明细"页面。
2. 可通过表头筛选、排序，或点击"Column Settings"自定义显示字段。
3. 点击"Export CSV"可导出当前筛选结果。
4. 点击"导入CSV"按钮，选择CSV文件，完成导入并查看详细结果。
5. 如需编辑/删除，点击对应操作按钮。

**典型场景：**  
日常交易复盘、数据核查、导出明细给第三方分析、批量导入历史订单等。

---

## 2. statistics.html —— 统计分析

**用途：**  
以 Edgewonk 风格对交易数据进行多维度统计、可视化和深度分析。

**主要功能：**
- 支持按日期区间筛选统计
- 展示总净利润、胜率、盈亏比、最大回撤等核心指标
- RTH/ETH（盘中/盘后）分时段统计
- 资金曲线可视化
- Best & Worst（最大盈利/亏损）交易明细与合计
- 盈利日历、周历、月历可视化
- 支持卡片折叠、拖拽排序、宽度自定义
- 支持模态窗口查看周期内详细交易

**使用方法：**
1. 打开"统计（Edgewonk风格）"页面。
2. 右上角选择时间区间，或点击"全部"查看全量数据。
3. 浏览各卡片统计数据，可点击卡片右上角"-"按钮收起/展开。
4. 在"Profit Calendar"中点击任意日期/周/月，可弹出详细交易明细。
5. 可拖拽卡片调整顺序，右侧手柄调整宽度，布局自动保存。

**典型场景：**  
用于交易复盘、策略评估、周期性表现分析、寻找最佳/最差交易等。

---

## 架构说明

- **前端**：基于 Flask/Jinja2 模板，Bootstrap 5，jQuery，Chart.js，Flatpickr 等。
- **后端**：Flask 提供 RESTful API，支持 CSV/SQLite3 存储，数据过滤、聚合、统计均在后端完成。
- **数据流**：
  - 导入数据 → 存储（CSV/SQLite3） → 查询/统计 → 前端展示/交互
- **交互体验**：
  - 支持响应式布局，适配桌面和移动端
  - 交互友好，支持多种自定义和导出

---

## 快速开始

1. 启动 Flask 后端服务。
2. 访问 `/trades` 管理和查看交易明细，并可直接导入订单数据。
3. 访问 `/statistics` 进行多维度统计分析。

---

如需详细字段格式、API 说明或二次开发接口，请参考源码或联系开发者。