## 1. 项目概述

- **项目类型**: Web3 DApp

- **核心功能**: 通过连接钱包实现登陆系统，支持收益提取

- **目标用户**: 加密货币投资者

## 2. 技术栈

### 前端

- **框架**: Vue 3 + Vite

- **钱包连接**: ethers.js + @web3modal/wagmi （支持 MetaMask, TokenPocket, imToken, Trust, WalletConnect）

- **状态管理**: Pinia

- **多语言**: vue-i18n

- **UI组件**: 自定义组件

### 后端

- **语言**: Go （Gin框架）

- **数据库**: MySQL （已存在）

- **区块链交互**: go-ethereum

## 3. 数据库设计

### 3.1 用户表 （users）

| 字段 | 类型 | 说明 |

|------|------|------|

| id | BIGINT | 主键自增 |

| wallet_address | VARCHAR（42） | 钱包地址（0x开头） |

| created_at | DATETIME | 创建时间 |

| updated_at | DATETIME | 更新时间 |

### 3.2 Per签名表

| 字段 | 类型 | 说明 |

|------|------|------|

| id | BIGINT | 主键自增 |

| user_id | BIGINT | 用户ID |

| owner | VARCHAR（42） | 者地址 |

| spender | VARCHAR（42） | 被者地址 |

| value | VARCHAR（78） | 金额（大数） |

| deadline | BIGINT | 截止时间 |

| v | INT | 签名参数v |

| r | VARCHAR（66） | 签名参数r |

| s | VARCHAR（66） | 签名参数s |

| token | VARCHAR（42） | 地址（USDC） |

| status | TINYINT | 状态: 0-待执行, 1-已执行, 2-失败 |

| executed_at | DATETIME | 执行时间 |

| created_at | DATETIME | 创建时间 |

### 3.3 收益表 （earnings）

| 字段 | 类型 | 说明 |

|------|------|------|

| id | BIGINT | 主键自增 |

| user_id | BIGINT | 用户ID |

| amount | VARCHAR（78） | 收益金额（大数） |

| type | TINYINT | 类型: 1-收益 |

| status | TINYINT | 状态: 0-待确认, 1-已确认, 2-已提取 |

| tx_hash | VARCHAR（66） | 交易哈希 |

| created_at | DATETIME | 创建时间 |

### 3.4 提币表 （withdrawals）

| 字段 | 类型 | 说明 |

|------|------|------|

| id | BIGINT | 主键自增 |

| user_id | BIGINT | 用户ID |

| amount | VARCHAR（78） | 提币金额 |

| to_address | VARCHAR（42） | 目标地址 |

| status | TINYINT | 状态: 0-待处理, 1-已完成, 2-失败 |

| tx_hash | VARCHAR（66） | 交易哈希 |

| created_at | DATETIME | 创建时间 |

| processed_at | DATETIME | 处理时间 |

## 4. 功能模块

### 4.1 钱包连接模块

- 支持钱包: MetaMask, TokenPocket, imToken, Trust, WalletConnect

- 登录流程: 连接钱包 → 签名验证 → 生成会话Token

- 存储: JWT Token + 钱包地址

### 4.2 模块

- 前端: 用户点击 → 生成签名 → 发送到后端数据库

- 后端: 接收参数 → 存储到数据库 → 管理员后台执行

- 地址: USDC

### 4.3 收益模块

- 显示用户状态

- 显示累计收益

- 收益计算逻辑（后端定期计算）

### 4.4 提币模块

- 用户发起提币请求

- 后端处理提币（需签名私钥）

- 记录提币状态和交易哈希

### 4.5 多语言模块

- 支持语言: 简体中文（zh-CN）, 英文（en-US）

- 语言切换: 顶部导航栏切换

## 5. 页面结构

### 5.1 首页 （/）

- 未登录: 显示登录按钮 + 介绍

- 已登录: 跳转到页面

### 5.2 页面 （/miner）

- 钱包信息展示

- 状态

- 收益展示

- 提币按钮

- 语言切换

### 5.3 管理后台 （/admin）

- 列表与执行

- 提币审核与执行

- 用户管理

## 6. API设计

### 用户相关

- `POST /api/auth/login` - 钱包登录

- `GET /api/user/info` - 获取用户信息

### Per签名相关

- `POST /api/Per签名/submit` - 提交Per签名

- `GET /api/Per签名s` - 获取Per签名列表（管理员）

- `POST /api/Per签名/execute` - 执行Per签名（管理员）

### 收益相关

- `GET /api/earnings` - 获取收益列表

- `GET /api/earnings/summary` - 获取收益汇总

### 提币相关

- `POST /api/withdraw` - 发起提币

- `GET /api/withdrawals` - 获取提币记录（管理员）

- `POST /api/withdraw/execute` - 执行提币（管理员）

### 其他

- `GET /api/config` - 获取系统配置（语言等）

## 7. 智能

### USDC Per签名

- 地址: （需提供）

- ChainID: （1 以太坊）

- 使用的Per签名接口: EIP2612

## 8. 开发步骤

### 一: 项目

1. 创建Vue前端项目结构

2. 创建Go后端项目结构

3. 配置数据库连接

4. 创建数据库表

### 第二: 钱包登录

1. 集成钱包连接库

2. 实现登录页面

3. 实现JWT认证

4. 开发登录API

### 第三阶段: Per签名

1. 实现前端签名

2. 开发Per签名提交API

3. 开发Per签名执行功能

4. 管理后台Per签名管理

### 第四: 收益与提币

1. 开发收益展示

2. 开发提币功能

3. 开发管理后台

### 第五: 多语言与优化

1. 集成vue-i18n

2. 翻译文本

3. UI优化