更新开发者平台：代理商管理、版本管理、UI优化

2026-04-29 15:19:17 +08:00
parent afe67d704e
commit 5c63882e71
139 changed files with 26533 additions and 365 deletions
@@ -1,306 +1,71 @@
-# 开发者部署平台 (Developer Platform)
+# 网络验证平台

-## 项目简介
+一个功能完整的软件授权验证管理平台，支持多应用管理、用户授权、卡密销售、代理分销等功能。

-开发者部署平台是一个面向开发者的软件授权和验证管理平台，提供开发者官网展示、产品功能介绍、产品定价方案、开发者后台管理系统以及代理商后台管理系统。
+## 功能特性

-## 功能模块
+- **应用管理** - 创建和管理多个应用，支持独立的验证配置
+- **用户系统** - 用户注册、登录、设备绑定、试用功能
+- **卡密系统** - 生成、销售、管理卡密，支持多种卡类型
+- **代理系统** - 多级代理分销，佣金结算
+- **云端变量** - 单值模式和流水模式，支持应用端写入
+- **版本管理** - ZIP包上传，文件索引，自动更新
+- **扩展API** - Webhook推送，API Key认证
+- **邮件系统** - 邮箱验证、密码重置、通知邮件

-### 1. 开发者官网展示
- 平台介绍页面
- 功能特性展示
- 快速入门指南
- 开发者社区入口
-
-### 2. 产品功能介绍
- 授权验证功能
- 用户管理功能
- 数据统计功能
- API 接口说明
-
-### 3. 产品定价方案
- 套餐价格展示
- 功能对比表
- 免费试用入口
- 在线购买流程
-
-### 4. 开发者后台管理系统
- 应用管理
- 卡密管理
- 用户管理
- 设备管理
- 版本管理
- 云端数据管理
- 风控管理
- 财务管理
- 工单系统
- 日志记录
-
-### 5. 代理商后台管理系统
- 代理授权管理
- 卡密权限配置
- 余额充值
- 佣金管理
- 数据统计
-
-## 技术架构
-
-### 前端
- **框架**: Vue 3 + TypeScript
- **构建工具**: Vite
- **UI 组件库**: shadcn-vue
- **样式**: Tailwind CSS
- **状态管理**: Pinia
- **路由**: Vue Router
+## 技术栈

 ### 后端
- **语言**: Go 1.21+
- **Web 框架**: Gin
- **数据库**: MySQL 8.0
- **缓存**: Redis
- **ORM**: GORM
+- Go 1.21+
+- Gin Web Framework
+- GORM ORM
+- SQLite/MySQL/PostgreSQL

-## 项目结构
-
-```
-developer-platform/
-├── frontend/              # 前端项目
-│   ├── src/
-│   │   ├── pages/        # 页面组件
-│   │   │   ├── developer/ # 开发者后台页面
-│   │   │   │   ├── applications/     # 应用管理
-│   │   │   │   ├── cards/            # 卡密管理
-│   │   │   │   ├── users/            # 用户管理
-│   │   │   │   ├── devices/          # 设备管理
-│   │   │   │   ├── versions/         # 版本管理
-│   │   │   │   ├── cloud-constants/  # 云端常量
-│   │   │   │   ├── cloud-variables/  # 云端变量
-│   │   │   │   ├── dynamic-code/     # 云端函数
-│   │   │   │   ├── risk-control/     # 风控管理
-│   │   │   │   ├── agent-apps/       # 代理授权
-│   │   │   │   ├── finance/          # 财务管理
-│   │   │   │   ├── tickets/          # 工单系统
-│   │   │   │   └── logs/             # 日志记录
-│   │   │   └── index.vue  # 官网首页
-│   │   ├── components/   # 公共组件
-│   │   ├── router/       # 路由配置
-│   │   ├── stores/       # 状态管理
-│   │   └── services/     # API 服务
-│   └── package.json
-├── backend/               # 后端项目
-│   ├── cmd/              # 应用入口
-│   ├── internal/
-│   │   ├── router/       # 路由配置
-│   │   │   ├── developer/ # 开发者路由
-│   │   │   ├── app/      # 应用 API 路由
-│   │   │   └── extension/ # 扩展路由
-│   │   ├── middleware/   # 中间件
-│   │   ├── model/        # 数据模型
-│   │   ├── service/      # 业务逻辑
-│   │   └── config/       # 配置管理
-│   └── go.mod
-├── database/              # 数据库文件
-│   ├── schema.sql        # 数据库结构
-│   └── seeds.sql         # 初始数据
-└── docker-compose.yml     # Docker 编排文件
-```
+### 前端
+- Vue 3 + TypeScript
+- Vite
+- Tailwind CSS
+- Shadcn/UI

 ## 快速开始

-### 环境要求
-
- Node.js >= 22.15
- pnpm >= 10
- Go >= 1.21
- MySQL >= 8.0
- Redis >= 7.0
-
-### 本地开发
-
-#### 1. 克隆项目
-
-```bash
-git clone <repository-url>
-cd developer-platform
-```
-
-#### 2. 启动后端服务
+### 后端启动

 ```bash
 cd backend
-cp config.yaml.example config.yaml
-# 修改 config.yaml 中的数据库和 Redis 配置
-go mod download
+go mod tidy
 go run cmd/main.go
 ```

-#### 3. 启动前端服务
+### 前端启动

 ```bash
 cd frontend
-pnpm install
-pnpm dev
+npm install
+npm run dev
 ```

-#### 4. 访问应用
+## 目录结构

- 前端地址: http://localhost:5173
- 后端 API: http://localhost:8080
-
-### Docker 部署
-
-```bash
-# 构建并启动所有服务
-docker-compose up -d
-
-# 查看服务状态
-docker-compose ps
-
-# 查看日志
-docker-compose logs -f
-
-# 停止服务
-docker-compose down
 ```
-
-## 数据库配置
-
-### 创建数据库
-
-```sql
-CREATE DATABASE developer_platform DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
+developer-platform/
+├── backend/           # Go 后端服务
+│   ├── cmd/          # 入口文件
+│   ├── internal/     # 内部代码
+│   │   ├── database/ # 数据库
+│   │   ├── model/    # 数据模型
+│   │   ├── router/   # API路由
+│   │   └── service/  # 业务逻辑
+│   └── uploads/      # 上传文件
+├── frontend/          # Vue 前端
+│   ├── src/
+│   │   ├── pages/    # 页面
+│   │   ├── services/ # API服务
+│   │   └── components/ # 组件
+│   └── public/
+└── README.md
 ```

-### 导入数据结构
-
-```bash
-mysql -u root -p developer_platform < database/schema.sql
-mysql -u root -p developer_platform < database/seeds.sql
-```
-
-## 环境变量
-
-### 后端环境变量
-
-| 变量名 | 说明 | 默认值 |
-|--------|------|--------|
-| APP_ENV | 运行环境 | development |
-| DATABASE_HOST | 数据库地址 | localhost |
-| DATABASE_PORT | 数据库端口 | 3306 |
-| DATABASE_NAME | 数据库名称 | developer_platform |
-| DATABASE_USERNAME | 数据库用户名 | root |
-| DATABASE_PASSWORD | 数据库密码 | - |
-| REDIS_HOST | Redis 地址 | localhost |
-| REDIS_PORT | Redis 端口 | 6379 |
-
-## 部署文档
-
-### 传统部署
-
-1. **准备服务器**
-   - 操作系统: Ubuntu 20.04+ / CentOS 7+
-   - 内存: 最低 2GB，推荐 4GB+
-   - CPU: 最低 2 核，推荐 4 核+
-   - 存储: 最低 20GB，推荐 50GB+
-
-2. **安装依赖**
-   ```bash
-   # 安装 Node.js
-   curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
-   sudo apt-get install -y nodejs
-   
-   # 安装 pnpm
-   npm install -g pnpm
-   
-   # 安装 Go
-   wget https://go.dev/dl/go1.21.0.linux-amd64.tar.gz
-   sudo tar -C /usr/local -xzf go1.21.0.linux-amd64.tar.gz
-   export PATH=$PATH:/usr/local/go/bin
-   
-   # 安装 MySQL
-   sudo apt-get install mysql-server
-   
-   # 安装 Redis
-   sudo apt-get install redis-server
-   ```
-
-3. **部署后端**
-   ```bash
-   cd backend
-   go build -o developer-platform cmd/main.go
-   ./developer-platform
-   ```
-
-4. **部署前端**
-   ```bash
-   cd frontend
-   pnpm install
-   pnpm build
-   # 使用 Nginx 托管 dist 目录
-   ```
-
-### Docker 部署
-
-```bash
-# 构建镜像
-docker build -t developer-platform-frontend ./frontend
-docker build -t developer-platform-backend ./backend
-
-# 运行容器
-docker-compose up -d
-```
-
-### Kubernetes 部署
-
-提供完整的 Kubernetes 部署配置文件，支持：
- Deployment 配置
- Service 配置
- Ingress 配置
- ConfigMap 和 Secret 配置
- 持久化存储配置
-
-## 数据隔离说明
-
-本平台与企业官网平台完全独立：
- 独立的数据库实例
- 独立的 Redis 缓存
- 独立的后端服务
- 独立的前端应用
- 无数据共享和依赖
-
-## 安全性保障
-
-1. **数据加密**: 敏感数据采用 AES 加密存储
-2. **身份认证**: JWT Token 认证机制
-3. **权限控制**: 基于角色的访问控制 (RBAC)
-4. **SQL 注入防护**: 使用 ORM 框架防止 SQL 注入
-5. **XSS 防护**: 前端输入输出过滤
-6. **CSRF 防护**: Token 验证机制
-7. **API 密钥管理**: 安全的 API 密钥生成和管理
-
-## 开发者工具
-
-### SDK 支持
-
-提供多语言 SDK：
- JavaScript/TypeScript SDK
- Python SDK
- Go SDK
- Java SDK
-
-### API 文档
-
-完整的 RESTful API 文档，支持：
- OpenAPI 3.0 规范
- Swagger UI 在线文档
- Postman 集合
-
 ## 许可证

 MIT License
-
-## 联系方式
-
- 作者: viaeon
- 邮箱: support@example.com
- 文档: https://docs.example.com