GSL 是一个基于 Berachain 的 DeFi 生态系统，核心围绕 HIVE 代币的质押挖矿、流动性提供、代币兑换和 FOMO3D 博弈游戏。
- [[项目总览]] — 系统架构、代码库组成、核心业务模块、合约地址
- [[API接口文档]] — 全部 HTTP API + 链上合约接口
- [[智能合约文档]] — Solidity 合约清单、数据结构、部署配置、安全特性
- [[数据库模型文档]] — MySQL 表结构、字段说明、枚举值、定时任务
- [[权限与角色文档]] — 三层权限体系（链上/后端/前端）、敏感操作、用户等级
- [[业务逻辑与部署配置]] — 奖励计算公式、环境配置、构建指南、外部依赖
- [[codebase-技术栈]] — 语言、框架、依赖
- [[codebase-系统架构]] — 架构模式、层次、数据流
- [[codebase-目录结构]] — 文件组织、关键位置
- [[codebase-代码规范]] — 编码风格、命名约定
- [[codebase-测试]] — 测试框架与实践
- [[codebase-外部集成]] — 第三方服务、区块链集成
- [[codebase-技术关注点]] — 技术债务、安全问题
| 代码库 | 技术栈 | 说明 |
|---|---|---|
| gsl-contracts | Solidity 0.8.25 / Foundry | 链上智能合约 |
| hive-gls-java | Spring Boot 2.7 / MyBatis Plus / Web3j | Java 后端服务 |
| gsl-web-admin | Vue 3 / TypeScript / Element Plus | 运营管理后台 |
| gsl-dapp | Vue 3 / Web3.js / Ethers.js / Vant | 用户端 DApp |
┌─────────────┐ ┌──────────────┐
│ gsl-dapp │ │ gsl-web-admin│
│ (用户DApp) │ │ (管理后台) │
└──────┬──────┘ └──────┬───────┘
│ │
│ HTTP/API │ HTTP/API
▼ ▼
┌──────────────────────────────────┐
│ hive-gls-java │
│ (Spring Boot 后端服务) │
│ ┌─────────┐ ┌───────────────┐ │
│ │ 事件监听 │ │ 奖励结算Job │ │
│ └────┬────┘ └───────┬───────┘ │
│ │ │ │
│ ┌────▼────────────────▼──────┐ │
│ │ MySQL + Redis │ │
│ └────────────────────────────┘ │
└──────────────┬───────────────────┘
│ Web3j
▼
┌──────────────────────────────────┐
│ gsl-contracts │
│ (Berachain 智能合约) │
│ StakeCore | LPStake | HiveSwap │
│ FOMO3D | UserRelation | Queue │
└──────────────────────────────────┘
文档生成日期：2026-03-25