verify/README.md

开发者部署平台 (Developer Platform)

项目简介

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

功能模块

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

项目结构

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 编排文件

快速开始

环境要求

• Node.js >= 22.15
• pnpm >= 10
• Go >= 1.21
• MySQL >= 8.0
• Redis >= 7.0

本地开发

1. 克隆项目

git clone <repository-url>
cd developer-platform

2. 启动后端服务

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

3. 启动前端服务

cd frontend
pnpm install
pnpm dev

4. 访问应用

• 前端地址: http://localhost:5173
• 后端 API: http://localhost:8080

Docker 部署

# 构建并启动所有服务
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看日志
docker-compose logs -f

# 停止服务
docker-compose down

数据库配置

创建数据库

CREATE DATABASE developer_platform DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

导入数据结构

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. 安装依赖

   # 安装 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. 部署后端

   cd backend
   go build -o developer-platform cmd/main.go
   ./developer-platform
   

4. 部署前端

   cd frontend
   pnpm install
   pnpm build
   # 使用 Nginx 托管 dist 目录
   

Docker 部署

# 构建镜像
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