Skip to content

About

币安alpha积分管理系统,支持多账户积分、磨损管理

Resources

Stars

4 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Alpha Helper - 币安Alpha交易记录管理系统

用于记录和管理交易磨损、积分收入、空投收益等投资数据。

🚀 核心功能

📊 数据总览

  • 统计卡片 - 直观展示总天数、总投入、总磨损、总空投、总净利润
  • 数据表格 - 详细的交易记录表格,支持排序和筛选
  • 最近15天突出显示 - 自动识别并突出显示最近15天的记录

📅 日历管理

  • 可视化日历 - 直观显示每日盈亏和积分情况
  • 月度汇总 - 自动计算并显示当月净盈亏
  • 颜色编码 - 盈利(绿色)、亏损(红色)、今日(蓝色)

💼 账户管理

  • 多账户支持 - 创建和管理多个交易账户
  • 数据隔离 - 每个账户独立存储数据
  • 软删除 - 删除账户时保留历史数据

🔢 自动计算

  • 本金计算 - 自动跟踪和计算每日本金
  • 磨损统计 - 精确计算交易磨损(结余 - 本金 - 空投)
  • 积分管理 - 积分收入、支出、滚动积分(最近15天)统计
  • 空投收益 - 单独记录空投纯利润

🛠️ 技术特点

  • 轻量级架构 - 基于Flask + Vanilla JavaScript
  • 文件存储 - JSON格式,无需数据库
  • 响应式设计 - 支持桌面和移动设备
  • 实时计算 - 数据变更时自动重新计算所有相关指标

🚀 快速开始

环境要求

  • Python 3.7+
  • Flask 2.0+

安装运行

  1. 安装依赖:
pip install flask
  1. 启动应用:
python app.py
  1. 访问应用: 打开浏览器访问 http://localhost:5005

默认设置

  • 端口:5005
  • 主机:0.0.0.0(可外部访问)
  • 调试模式:开启

📖 使用指南

💼 账户管理

  1. 选择账户 - 点击左上角账户按钮,从下拉菜单选择要操作的账户
  2. 添加账户 - 点击"+ 添加账户"创建新的交易账户
  3. 编辑账户 - 点击账户右侧的✏️图标编辑账户信息
  4. 删除账户 - 点击×图标软删除账户(保留历史数据)

📝 数据录入

  1. 选择日期 - 点击日历上的任意日期打开数据录入表单
  2. 填写数据:
    • 结余资金 - 当日账户结余金额
    • 出入金 - 资金进出(正数入金,负数出金)
    • 当日积分收入 - 获得的积分数量
    • 当日积分支出 - 花费的积分数量
    • 空投收入 - 空投获得的纯利润收入
  3. 保存记录 - 点击保存按钮,系统自动计算相关指标

🔢 计算逻辑

资金相关

  • 本金 = 前一日结余 + 当日出入金
  • 磨损 = 当日结余 - 本金 - 空投
  • 净盈亏 = 磨损 + 空投

积分相关

  • 积分净收入 = 积分收入 - 积分支出
  • 滚动积分 = 最近15天积分净收入总和
  • 总计积分 = 累计积分净收入

特殊规则

  • 空投:纯利润,不影响本金计算,从磨损中扣除
  • 重算机制:每次保存记录时重新计算所有后续日期的本金和磨损

👁️ 数据显示

日历视图

  • 三行显示:
    • 日期数字
    • 净盈亏(绿色盈利/红色亏损)
    • 积分净收入(蓝色正数/紫色负数,"P"标识)
  • 背景颜色:
    • 绿色:净盈亏为正
    • 红色:净盈亏为负
    • 浅绿色:有记录但无盈亏数据
    • 蓝色:今天

数据总览

  • 统计卡片:总天数、总投入、总磨损、总空投、总净利润
  • 数据表格:详细交易记录,按日期倒序排列
  • 最近15天:自动突出显示最近15天的记录

🗂️ 项目结构

alpha_helper/
├── app.py                           # Flask应用主文件
├── README.md                        # 项目文档
├── templates/
│   └── index.html                  # 主页面模板
├── static/
│   ├── css/
│   │   └── style.css               # 样式文件(响应式设计)
│   └── js/
│       └── app.js                  # 前端交互逻辑
└── data/                           # 数据目录(自动创建)
    ├── accounts.json               # 账户管理文件
    └── trading_records_{id}.json   # 各账户交易记录

💾 数据存储

账户文件 (accounts.json)

[
  {
    "id": "uuid-string",
    "name": "账户名称",
    "description": "账户描述",
    "created_at": "2024-01-01 12:00:00",
    "is_deleted": false
  }
]

交易记录文件 (trading_records_{account_id}.json)

{
  "account_id": "uuid-string",
  "last_updated": "2024-01-01 12:00:00",
  "records": [
    {
      "date": "2024-01-01",
      "principal": 1000.0,
      "balance": 995.0,
      "deposit_withdraw": 0,
      "airdrop": 10.0,
      "wear": -15.0,
      "daily_points": 10,
      "daily_points_expense": 0,
      "rolling_points": 150,
      "total_points": 1500
    }
  ]
}

存储特点

  • 文件分离 - 每个账户独立存储,数据隔离安全
  • 软删除 - 删除账户时保留历史数据
  • JSON格式 - 便于备份、迁移和人工查看
  • 无数据库 - 轻量级,无需额外依赖

🔧 开发说明

技术栈

  • 后端:Flask (Python)
  • 前端:Vanilla JavaScript + CSS3
  • 存储:JSON文件
  • 样式:响应式CSS Grid/Flexbox

核心特性

  • 实时计算 - 数据变更自动重新计算所有指标
  • 响应式设计 - 完美适配桌面和移动设备
  • 无状态前端 - 纯JavaScript实现,无框架依赖
  • 模块化架构 - 清晰的代码分离和职责划分

📈 使用场景

投资交易记录

  • 跟踪每日交易磨损和盈亏
  • 管理多个交易账户
  • 分析投资表现和趋势

积分系统管理

  • 记录积分收入和支出
  • 监控滚动积分(最近15天)
  • 统计累计积分收益

空投收益追踪

  • 单独记录空投纯利润
  • 区分交易磨损和空投收益
  • 分析整体投资回报

🎯 优势特点

  • 简单易用 - 直观的界面设计,无需复杂配置
  • 数据安全 - 本地文件存储,数据完全可控
  • 灵活扩展 - 模块化设计便于功能扩展
  • 开源免费 - 完全开源,可自由定制

🤝 贡献

欢迎提交Issue和Pull Request来改进这个项目!

📄 许可证

MIT License

About

币安alpha积分管理系统,支持多账户积分、磨损管理

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages