QSL Manager 是一个现代化的业余无线电 QSL 卡片管理系统，从 Python/PyQt5 版本完全迁移到 Web 应用程序。
- Node.js 18+
- npm
- 现代浏览器（Chrome、Firefox、Safari、Edge）
# 1. 克隆项目
git clone <repository-url>
cd QSL-Manager
# 2. 安装依赖
npm install
# 3. 启动应用（零配置）
npm run dev
# 或使用 PM2 部署（生产环境推荐）
npm run pm2:start- 前端应用: http://localhost:7054
- 后端API: http://localhost:7055/api
- 健康检查: http://localhost:7055/api/health
- 完整日志管理: 支持所有 ADIF 标准字段的 QSO 记录
- 智能卡片系统: 自动生成 QSL 卡片编号和状态跟踪
- 专业打印系统: 70mm×50mm 标签打印，支持批量操作
- 出入库管理: 扫码式 QSL 卡片状态管理
- 地址簿集成: 完整的联系人地址管理
- ADIF 兼容: 完整的导入导出支持
- 零配置启动: 自动创建数据库和必要文件
- 纯 JavaScript: 无需预编译，直接运行
- 响应式设计: 支持各种屏幕尺寸
- 数据兼容: 支持从 Python 版本无缝迁移
- 实时同步: 前后端数据实时同步
| 模块 | 功能描述 | 主要特性 |
|---|---|---|
| 📊 仪表板 | 系统概览和统计 | 实时数据、活动记录 |
| 📝 日志管理 | QSO 记录管理 | CRUD、过滤、批量操作 |
| 🏷️ QSL 卡片 | 卡片生成和管理 | 智能编号、状态跟踪 |
| �️ 打印系统 | 标签打印管理 | 批量打印、队列管理 |
| 📦 出入库 | 扫码状态管理 | QR 扫码、状态更新 |
| 📇 地址簿 | 联系人管理 | 地址管理、标签生成 |
| 🔍 手动查询 | QSL ID 查询 | 详细信息查询 |
| ⚙️ 系统设置 | 配置管理 | 个性化设置 |
- React 18 - 现代化用户界面框架
- Ant Design 5 - 企业级 UI 组件库
- Vite - 快速构建工具
- Axios - HTTP 客户端
- Node.js - 服务器运行时
- Express - Web 应用框架
- SQL.js - 客户端 SQLite 数据库
- Multer - 文件上传处理
直接在设置界面中导入原数据库db文件即可
| 功能 | Python 版本 | Web 版本 | 状态 |
|---|---|---|---|
| 日志管理 | ✅ | ✅ | 完全兼容 |
| QSL 卡片 | ✅ | ✅ | 功能增强 |
| 打印系统 | ✅ | ✅ | 布局精确 |
| ADIF 支持 | ✅ | ✅ | 完全兼容 |
| 地址管理 | ✅ | ✅ | 功能增强 |
| 出入库 | ✅ | ✅ | 体验优化 |
- 现代化设计: 简洁直观的用户界面
- 响应式布局: 适配各种设备屏幕
- 暗色模式: 支持明暗主题切换
- 中文界面: 完整的中文本地化
# 使用 npm
npm install
npm run dev# 启动应用
npm run pm2:start
# 查看状态
npm run pm2:status
# 查看日志
npm run pm2:logs
# 重启应用
npm run pm2:restart
# 停止应用
npm run pm2:stop
# 删除应用
npm run pm2:delete- 双进程管理: 同时管理前端（Vite）和后端（Express）服务
- 自动重启: 应用崩溃时自动重启
- 日志管理: 自动记录应用日志到
./logs/目录 - 内存监控: 内存超过 500MB 自动重启
- 进程守护: 后台运行，系统重启后自动恢复
PM2 会启动两个进程：
qsl-backend: 后端 API 服务器 (端口 7055)qsl-frontend: 前端开发服务器 (端口 7054)
# 保存当前 PM2 进程列表
pm2 save
# 生成开机启动脚本
pm2 startupQSL-Manager/
├── src/ # 前端源码
├── server/ # 后端源码
├── database/ # 数据库文件
├── docs/ # 项目文档
└── temp/ # 临时文件
npm run dev # 启动开发服务器（前端+后端）
npm run server # 仅启动后端服务器
npm run client # 仅启动前端开发服务器
npm run build # 构建生产版本
npm run migrate # 运行数据库迁移
# PM2 生产环境命令
npm run pm2:start # 使用 PM2 启动应用
npm run pm2:stop # 停止 PM2 应用
npm run pm2:restart # 重启 PM2 应用
npm run pm2:logs # 查看 PM2 日志
npm run pm2:status # 查看 PM2 状态- Fork 项目
- 创建功能分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 打开 Pull Request
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情
如果您在使用过程中遇到问题：
🎯 项目目标: 为业余无线电爱好者提供现代化、易用的 QSL 卡片管理解决方案
📈 版本: 2.0.0 (Web 版本)
🔄 更新: 持续维护和功能增强