# SVT 项目功能和技术文档
## 📋 项目概述
SVT (Smart Value Token) 是一个基于区块链的 DeFi 质押平台，提供多种数字资产的质押服务和收益分配机制。项目采用前后端分离的架构，支持多端访问。
## 🏗️ 技术架构
### 前端技术栈
#### 核心框架
– **React 18** – 现代化的用户界面库
– **TypeScript** – 类型安全的JavaScript超集
– **React Hooks** – useState, useEffect, useCallback 等状态管理
#### 样式和UI
– **Tailwind CSS 3.4.17** – 实用优先的CSS框架
– **PostCSS** – CSS 后处理器
– **自定义动画** – 地球旋转、三角闪烁、缓慢旋转等动画效果
– **响应式设计** – 移动端优先，支持多种屏幕尺寸
#### 3D和图形库
– **Three.js 0.169.0** – 3D图形渲染库
– **@react-three/fiber 8.16.0** – React Three.js 集成
– **@react-three/drei 9.88.0** – Three.js 实用工具库
#### 工具库
– **qrcode 1.5.4** – 二维码生成库（本地生成，解决移动端兼容性）
– **ajv 8.17.1** – JSON Schema验证库
– **web-vitals** – 性能监控
#### 开发工具
– **Create React App** – 项目脚手架
– **ESLint** – 代码质量检查
– **Jest** – 单元测试框架
– **TypeScript 4.9.5** – 类型检查
### 后端技术栈
#### 核心框架
– **ThinkPHP 5.0** – PHP MVC框架
– **PHP 7.x+** – 服务器端脚本语言
– **MySQL** – 关系型数据库
#### 数据库和缓存
– **MySQL 数据库** – 主要数据存储
– **Think Cache** – 缓存系统（支持Redis配置）
– **PDO** – 数据库抽象层
#### API和路由
– **RESTful API** – 标准化API接口
– **CORS 支持** – 跨域资源共享
– **路由系统** – ThinkPHP路由配置
## 🔧 项目结构
### 前端结构
“`
svt-react/
├── public/
│ ├── index.html # 主HTML文件，包含移动端兼容性配置
│ └── manifest.json # PWA配置
├── src/
│ ├── components/ # React组件目录
│ │ ├── AccountPage.tsx # 账户页面
│ │ ├── WalletPage.tsx # 钱包管理
│ │ ├── StakingNodePage.tsx # 质押节点页面
│ │ ├── StakingOrdersPage.tsx # 质押订单管理
│ │ ├── TransferPage.tsx # 转账功能
│ │ ├── WithdrawPage.tsx # 提现功能
│ │ ├── DepositPage.tsx # 充值功能
│ │ ├── GoogleAuthPage.tsx # 谷歌验证器
│ │ ├── TeamPage.tsx # 团队管理
│ │ ├── ProfilePage.tsx # 个人资料
│ │ ├── ReferralPage.tsx # 推荐系统
│ │ └── … # 其他组件
│ ├── hooks/
│ │ └── useUserData.ts # 用户数据管理Hook
│ ├── services/
│ │ └── api.ts # API服务封装
│ ├── App.tsx # 主应用组件
│ ├── index.tsx # 应用入口
│ └── index.css # 全局样式
├── package.json # 依赖配置
├── tailwind.config.js # Tailwind配置
└── tsconfig.json # TypeScript配置
“`
### 后端结构
“`
后端/
├── application/
│ ├── api/controller/ # API控制器
│ │ ├── Common.php # 公共控制器
│ │ ├── Login.php # 登录相关
│ │ ├── User.php # 用户管理
│ │ ├── Wallet.php # 钱包操作
│ │ ├── Shop.php # 质押商店
│ │ └── Index.php # 首页数据
│ ├── gfa/controller/ # 后台管理控制器
│ │ ├── User.php # 用户管理
│ │ ├── Wallet.php # 钱包管理
│ │ ├── Everyday.php # 每日结算
│ │ └── … # 其他管理功能
│ ├── config.php # 配置文件
│ ├── database.php # 数据库配置
│ └── route.php # 路由配置
├── public/
│ ├── index.php # 应用入口
│ └── … # 静态资源
└── think # ThinkPHP命令行工具
“`
## 🚀 核心功能模块
### 1. 用户系统
#### 功能特性
– **钱包连接登录** – 支持Web3钱包（MetaMask、TP钱包等）
– **用户注册** – 新用户自动注册机制
– **推荐人系统** – 多级推荐关系管理
– **用户资料管理** – 头像、个人信息设置
– **谷歌验证器** – 双因子身份认证
#### 技术实现
– 前端：React Hooks状态管理（useUserData）
– 后端：ThinkPHP用户认证、Token机制
– 数据库表：`mini_users`, `user_tokens`
### 2. 钱包系统
#### 功能特性
– **多币种支持** – SVT、USDT等代币管理
– **余额查询** – 实时余额显示
– **转账功能** – 用户间代币转账
– **交易记录** – 完整的交易历史
– **充值提现** – 链上资产充值和提现
#### 技术实现
– 前端：钱包状态管理、二维码生成
– 后端：区块链交互、交易验证
– 数据库表：`wallet`, `wallet_history`, `wallet_token`
### 3. 质押系统
#### 功能特性
– **质押产品** – 多种质押套餐选择
– **订单管理** – 质押订单状态跟踪
– **收益计算** – 自动收益结算
– **临时订单** – 支付前订单预创建
– **余额支付** – 使用账户余额直接购买
#### 技术实现
– 前端：质押产品展示、订单状态管理
– 后端：订单处理、收益计算算法
– 数据库表：`shop_order`, `temp_orders`, `shop_products`
### 4. 团队系统
#### 功能特性
– **团队层级** – 多级团队结构
– **推荐奖励** – 直推和团队奖励
– **业绩统计** – 团队业绩数据分析
– **节点管理** – 节点等级和权益
#### 技术实现
– 前端：团队数据可视化
– 后端：层级关系计算、奖励分配
– 数据库表：`team_income`, `user_relations`
### 5. 收益系统
#### 功能特性
– **每日结算** – 自动化收益计算
– **多重奖励** – 质押收益、推荐奖励、团队奖励
– **收益历史** – 详细的收益记录
– **实时统计** – 今日收益、总收益展示
#### 技术实现
– 前端：收益数据展示
– 后端：定时任务、收益计算引擎
– 数据库表：`bill`, `team_income`, `adm_thelog`
### 6. 管理后台
#### 功能特性
– **用户管理** – 用户信息管理、余额调整
– **订单管理** – 质押订单审核和管理
– **财务管理** – 充值提现审核
– **系统配置** – 参数配置和系统设置
– **数据统计** – 平台运营数据分析
#### 技术实现
– 前端：Layui管理界面
– 后端：管理员权限控制
– 数据库表：完整的业务数据管理
## 📱 移动端兼容性
### 钱包浏览器支持
– **TP钱包** – TokenPocket浏览器
– **MetaMask** – MetaMask移动端
– **Trust Wallet** – Trust钱包浏览器
– **SafePal** – SafePal钱包浏览器
### 移动端优化
– **响应式设计** – 自适应不同屏幕尺寸
– **触摸优化** – 优化滑动和点击体验
– **性能优化** – 移除重型3D模型，提升加载速度
– **兼容性处理** – 解决不同钱包浏览器的兼容性问题
## 🔐 安全特性
### 身份认证
– **钱包签名验证** – Web3钱包签名验证
– **双因子认证** – 谷歌验证器支持
– **Token机制** – 安全的用户会话管理
### 交易安全
– **交易确认** – 多重交易确认机制
– **金额验证** – 余额和限额检查
– **防重放攻击** – 交易哈希验证
### 数据安全
– **输入验证** – 严格的参数验证
– **SQL注入防护** – 使用PDO参数化查询
– **XSS防护** – 输出内容转义
## 🗄️ 数据库设计
### 核心数据表
#### 用户相关
– `mini_users` – 用户基本信息
– `user_tokens` – 用户认证令牌
– `user_google_auth` – 谷歌验证器设置
#### 钱包相关
– `wallet` – 用户钱包余额
– `wallet_token` – 代币配置信息
– `wallet_history` – 钱包交易记录
– `wallet_recharge` – 充值记录
#### 交易相关
– `shop_order` – 正式质押订单
– `temp_orders` – 临时订单
– `bill` – 账单记录
– `team_income` – 团队收益记录
#### 系统配置
– `config` – 系统配置参数
– `new` – 公告新闻
– `article` – 文章内容
## 🔄 API接口文档
### 用户认证接口
“`
POST /api/Login/login # 用户登录
POST /api/Login/register # 用户注册
POST /api/Login/check_user # 检查用户是否存在
“`
### 钱包接口
“`
POST /api/Wallet/wallet_list # 获取钱包列表
POST /api/Wallet/transfer # 转账
POST /api/Wallet/withdraw # 提现
POST /api/Wallet/history # 交易记录
“`
### 质押接口
“`
POST /api/Shop/shop_list # 获取质押产品
POST /api/Shop/buy_shop # 购买质押产品
POST /api/Shop/order_list # 获取订单列表
POST /api/Shop/purchaseWithBalance # 余额支付购买
“`
### 用户信息接口
“`
POST /api/User/account # 获取账户信息
POST /api/User/Team # 获取团队信息
POST /api/User/detailed # 获取用户详情
POST /api/User/binding_refer # 绑定推荐人
“`
## 🛠️ 部署和运维
### 开发环境
“`bash
# 前端开发
cd svt-react
npm install
npm start
# 后端开发
cd 后端
composer install
php think serve
“`
### 生产环境
– **前端部署** – 静态文件CDN分发
– **后端部署** – PHP-FPM + Nginx
– **数据库** – MySQL主从复制
– **缓存** – Redis集群
### 监控和日志
– **错误监控** – 前端错误边界，后端异常捕获
– **性能监控** – Web Vitals性能指标
– **访问日志** – Nginx访问日志分析
– **业务日志** – ThinkPHP日志系统
## 📈 性能优化
### 前端优化
– **代码分割** – React.lazy动态导入
– **缓存策略** – LocalStorage状态缓存
– **图片优化** – WebP格式，懒加载
– **网络优化** – API请求合并
### 后端优化
– **数据库优化** – 索引优化，查询优化
– **缓存策略** – Redis缓存热点数据
– **接口优化** – 批量操作，减少查询次数
## 🔮 未来规划
### 功能扩展
– **多链支持** – 支持更多区块链网络
– **DeFi集成** – 集成更多DeFi协议
– **移动App** – 原生移动应用开发
– **社交功能** – 用户社区和互动
### 技术升级
– **微服务架构** – 服务拆分和解耦
– **区块链优化** – 链上合约优化
– **AI集成** – 智能推荐和风控
– **大数据分析** – 用户行为分析
## 📞 联系信息
项目维护团队负责SVT平台的持续开发和优化，确保平台的稳定性和安全性。
声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。