Kamixitong/README.md

# 软件授权管理系统 (KaMiXiTong)

一款基于Python Flask的软件授权管理系统，支持卡密生成、设备绑定、在线验证等功能。

## 功能特性

- 🎯 **卡密管理**: 支持批量生成、导入导出卡密
- 🔐 **设备绑定**: 防止账号共享，支持解绑操作
- 🔄 **在线验证**: 实时验证卡密有效性
- 📊 **数据统计**: 可视化展示激活趋势和统计数据
- 🛡️ **安全防护**: AES加密传输，防抓包破解
- 🌐 **多产品支持**: 一个系统管理多个软件产品
- 📱 **响应式界面**: 支持PC和移动设备访问

## 目录结构

```
KaMiXiTong/
├── app/                     # Web管理后台
│   ├── models/              # 数据模型
│   ├── api/                 # API接口
│   ├── web/                 # Web界面
│   └── utils/               # 工具函数
├── tests/                   # 测试文件
│   ├── __init__.py
│   ├── test_validator.py    # 验证器测试
│   ├── test_api.py          # API测试
│   └── test_models.py       # 模型测试
├── docs/                    # 文档
│   ├── API.md               # API文档
│   ├── INTEGRATION.md       # 集成文档
│   ├── EXAMPLES.md          # 使用示例
│   └── FASTAPI.md           # FastAPI接口文档
├── migrations/              # 数据库迁移文件
│   └── init.sql
└── static/                  # 静态文件
```

## 使用方式

### 快速开始

```bash
# 克隆项目
git clone https://github.com/yourusername/kamaxitong.git

# 进入项目目录
cd kamaxitong

# 安装依赖
pip install -r requirements.txt

# 初始化数据库
python init_db_sqlite.py

# 启动服务
python run.py
```

访问地址: http://localhost:5000
默认账号: admin / admin123

### FastAPI接口

系统还提供了现代化的FastAPI接口，具有自动生成的交互式文档：

```bash
# 安装FastAPI依赖
pip install -r requirements-fastapi.txt

# 启动FastAPI服务
python fastapi_app.py
```

FastAPI文档地址: http://localhost:8000/docs

## 部署说明

### 开发环境

```bash
python start.py
```

### 生产环境

```bash
# 使用Gunicorn
pip install gunicorn
gunicorn -w 4 -b 0.0.0.0:5000 run:app

# 使用Nginx反向代理
# 配置SSL证书
# 设置防火墙规则
```

## 技术栈

- 后端: Flask + SQLAlchemy
- 前端: Bootstrap 5 + jQuery
- 数据库: SQLite/MySQL
- 部署: Gunicorn + Nginx

## 文档

- [API文档](docs/API.md)
- [集成指南](docs/INTEGRATION.md)
- [使用示例](docs/EXAMPLES.md)
- [FastAPI接口文档](docs/FASTAPI.md)

## 许可证

MIT License