# 软件授权管理平台需求规格说明书

## 1. 项目概述

### 1.1 项目背景
为了保护软件知识产权，规范软件使用权限，需要开发一个独立的软件授权管理平台，为IoT平台等软件系统提供授权码生成、分发、验证和管理服务。

### 1.2 项目目标
- 建立统一的软件授权管理系统
- 实现基于硬件绑定的授权机制
- 提供在线和离线两种授权模式
- 支持授权状态实时监控和管理
- 提供完整的客户管理功能

### 1.3 系统定位
本系统作为独立的授权管理平台，通过Web管理界面和RESTful API为其他软件系统提供授权服务。

## 2. 系统功能需求

### 2.1 客户管理模块
- 支持客户基本信息的增删改查（姓名、公司、联系人、邮箱、电话、地址、状态、描述）
- 支持客户状态管理（激活/停用）
- 提供客户列表查看、详情查看和JSON API接口

### 2.2 授权生成模块

#### 2.2.1 授权类型支持
- **在线授权码模式**：生成授权码，客户端激活时绑定硬件信息
- **离线许可证模式**：直接生成绑定硬件信息的软件许可证

#### 2.2.2 授权生成功能
- 支持为指定客户生成授权码或软件许可证
- 硬件指纹基于机器序列号、MAC地址、CPU ID生成
- 支持自定义有效期（1-36500天，预设选项：30天、90天、365天、永久）
- 支持功能列表配置和部署模式选择（在线/离线）
- 使用HMAC-SHA256签名和Base64编码保证安全性
- 可扩展额外功能，软件系统可以从生成的license里解析出来，比如{"device_number":20}

### 2.3 授权管理模块
- 显示所有授权记录列表，支持按客户筛选
- 授权状态监控（激活、过期、吊销），支持手动吊销和删除
- 提供授权详细信息查看（客户信息、硬件信息、过期时间、最后心跳时间）
- 实时显示授权过期和激活状态

### 2.4 部署包生成模块
- 为每个授权自动生成ZIP格式部署包
- 包含配置文件（config.yaml）、安装脚本（install.sh）、部署文档等
- 根据客户和授权信息自动命名

### 2.5 在线验证模块
- **授权验证API**：验证授权码和软件许可证，支持硬件指纹验证
- **授权激活API**：支持授权码激活为软件许可证，防止重复激活
- **心跳监控API**：记录客户端活跃时间，提供在线状态统计
- **授权信息查询API**：返回脱敏的授权信息，支持状态和过期检查

### 2.6 系统管理模块
- **用户认证**：管理员登录、状态保持、安全退出
- **权限控制**：Web界面需要认证，API接口独立于管理界面
- **系统监控**：运行状态仪表盘、授权统计信息、资源监控

### 2.7 工具支持模块
- 提供Windows和Linux平台的硬件信息获取工具
- 支持获取机器序列号、MAC地址、CPU ID
- 提供工具下载接口

## 3. 系统非功能性需求

### 3.1 性能需求
- 支持并发用户数不少于100个
- API响应时间不超过2秒
- 数据库连接池管理和查询性能优化

### 3.2 安全需求
- 授权码和软件许可证使用HMAC-SHA256签名
- 硬件指纹绑定防止盗用
- 敏感信息保护和HTTPS传输加密

### 3.3 可靠性需求
- 系统可用性达到99.9%
- 数据备份恢复、异常优雅降级
- 完善的错误处理和日志记录

### 3.4 可扩展性需求
- 支持水平扩展和模块化设计
- 支持多种数据库（当前使用PostgreSQL）
- RESTful API设计便于集成

### 3.5 兼容性需求
- 支持Windows、Linux、macOS操作系统
- 支持主流浏览器和跨平台客户端工具

## 4. 系统架构需求

### 4.1 技术架构
- **架构模式**：B/S架构
- **后端技术**：Go 1.23+，Gorilla Mux路由，Logrus日志
- **数据库**：PostgreSQL 12+,mysql12+
- **前端**：Vue.js 3+ 配合Vite，响应式UI组件
- **配置**：YAML格式配置文件

### 4.2 部署要求
- 支持单机部署、Docker容器化部署
- 支持系统服务形式运行
- 提供启动脚本和配置模板

## 5. 数据需求

### 5.1 数据模型
- **客户数据表**：基本信息、状态、创建时间，支持软删除和审计
- **授权数据表**：授权码/许可证信息、客户关联、硬件信息、状态时间、功能列表

### 5.2 数据管理
- 支持定期数据备份和导入导出功能
- 提供数据迁移工具

## 6. 接口需求

### 6.1 Web管理界面
- 客户管理、授权生成、授权列表和详情页面
- 系统仪表盘、用户登录页面