ChainlessChain 文档

主题

厂家管理系统概述 ​

U盾/SIMKey厂家管理系统是一个功能完整的设备厂家管理平台，提供设备全生命周期管理、多平台APP发布、数据备份恢复等核心功能。

系统定位 ​

本系统主要面向U盾和SIMKey硬件设备的生产厂家、经销商和服务提供商，帮助他们高效管理设备、用户和应用程序版本。

核心功能 ​

📱 设备全生命周期管理 ​

完整的设备管理流程，从注册到注销：

  • 批量注册: 支持单个和批量注册设备，提供CSV模板导入
  • 设备激活: 通过激活码激活设备并绑定用户
  • 状态管理: 实时监控设备状态（未激活、已激活、已锁定、已注销）
  • 锁定/解锁: 对异常设备进行锁定，解除后可恢复使用
  • 设备注销: 永久注销报废设备

详细了解设备管理 →

💻 多平台APP版本管理 ​

统一管理PC端和移动端应用程序：

  • 5平台支持: Windows、macOS、Linux、Android、iOS
  • 版本发布: 完整的版本发布流程（草稿→测试→发布→废弃）
  • 自动更新: 客户端自动检查更新和下载
  • 下载统计: 实时统计各版本下载量
  • 强制更新: 支持设置强制更新版本
  • 文件管理: 安装包文件的上传、存储和下载

详细了解APP管理 →

💾 数据备份与恢复 ​

安全的数据备份和恢复机制：

  • 加密备份: 使用AES-256-GCM加密设备数据
  • 备份类型: 支持完整备份和增量备份
  • 数据恢复: 将备份数据恢复到新设备
  • 密码验证: 恢复操作需要管理员密码验证
  • 备份管理: 查看、删除过期备份
  • 有效期管理: 可设置备份有效期（默认2年）

详细了解数据备份 →

👥 用户权限管理 ​

灵活的用户和权限管理系统：

  • 三级角色: 管理员、经销商、普通用户
  • 权限控制: 基于角色的访问控制（RBAC）
  • 用户状态: 正常、锁定、停用
  • 账号管理: 添加、编辑、锁定、删除用户
  • 操作审计: 记录所有用户操作

详细了解用户管理 →

📊 统计与监控 ​

实时的数据统计和可视化：

  • Dashboard: 核心指标一目了然
    • 设备总数和激活率
    • 用户增长趋势
    • APP下载统计
    • 最近操作记录
  • 图表分析: ECharts可视化图表
    • 激活趋势折线图
    • 设备类型分布饼图
    • APP下载量柱状图
  • 实时监控: 设备在线状态监控

📝 操作日志审计 ​

完整的操作审计和日志记录：

  • 日志记录: 记录所有关键操作
    • 设备操作（注册、激活、锁定等）
    • 用户操作（登录、修改等）
    • 数据操作（备份、恢复等）
    • APP操作（上传、发布等）
  • 日志查询: 强大的筛选和搜索功能
  • 详情查看: 查看操作的完整详情
  • 日志导出: 导出日志用于合规审计

详细了解日志系统 →

技术架构 ​

后端技术栈 ​

  • 框架: Spring Boot 3.2.1
  • 数据库: MySQL 8.0
  • 缓存: Redis 7.0
  • ORM: MyBatis Plus 3.5.5
  • 安全: Spring Security + JWT
  • API文档: Swagger/OpenAPI 3.0

前端技术栈 ​

  • 框架: Vue 3 + Composition API
  • UI库: Element Plus
  • 构建工具: Vite 5
  • 状态管理: Pinia
  • HTTP客户端: Axios
  • 图表库: ECharts 5

部署方案 ​

  • 容器化: Docker + Docker Compose
  • Web服务器: Nginx
  • 反向代理: Nginx
  • 一键部署: 提供Windows/Linux启动脚本

详细架构设计 →

系统特点 ​

🚀 快速部署 ​

  • 一键启动: 使用Docker Compose一键部署所有服务
  • 开箱即用: 预配置的数据库和默认管理员账号
  • 零依赖: 不需要手动安装Java、Node.js等环境

🔒 安全可靠 ​

  • JWT认证: 基于令牌的身份验证
  • 权限控制: 细粒度的角色权限管理
  • 操作审计: 完整的操作日志记录
  • 数据加密: 敏感数据加密存储

📱 界面友好 ​

  • 现代化UI: 基于Element Plus的美观界面
  • 响应式设计: 适配各种屏幕尺寸
  • 操作便捷: 简洁直观的操作流程
  • 数据可视化: ECharts图表展示

🔧 易于扩展 ​

  • RESTful API: 标准的REST API设计
  • 模块化: 清晰的模块划分
  • 文档完善: 完整的API文档和代码注释
  • 开源友好: MIT许可证，支持二次开发

应用场景 ​

设备厂家 ​

  • 生产厂家批量注册出厂设备
  • 管理设备的分发和激活
  • 提供售后数据恢复服务
  • 统计设备激活和使用情况

经销商 ​

  • 管理从厂家获得的设备配额
  • 激活和分发设备给终端用户
  • 处理用户的设备问题
  • 查看销售统计数据

服务提供商 ​

  • 为用户提供应用程序更新服务
  • 管理多平台应用版本
  • 收集用户反馈和统计数据
  • 提供数据备份和恢复服务

企业IT部门 ​

  • 管理企业内部U盾/SIMKey设备
  • 统一分发和回收设备
  • 监控设备使用情况
  • 确保数据安全和合规

核心优势 ​

vs 手工管理 ​

特性厂家管理系统手工管理
效率批量操作，自动化手工录入，耗时
准确性系统验证，无错误易出错
可追溯完整日志难以追溯
统计分析实时图表手工统计
扩展性可扩展难以扩展

vs 自建系统 ​

特性本系统自建系统
开发成本免费开源数月开发
部署时间5分钟数周
维护成本社区支持持续投入
功能完整性开箱即用逐步完善
文档支持完善文档需自行编写

系统截图 ​

Dashboard 控制台 ​

显示核心指标和统计图表，一目了然：

  • 设备总数、激活率统计
  • 用户和下载量统计
  • 激活趋势图、设备分布图
  • 最近操作记录

设备管理 ​

功能完整的设备列表和操作界面：

  • 设备筛选和搜索
  • 批量操作支持
  • 设备详情查看
  • 激活、锁定、解锁、注销操作

注册设备 ​

支持单个和批量注册：

  • 单个设备注册表单
  • CSV批量导入
  • 手动添加批量设备
  • 注册结果统计

APP版本管理 ​

完整的应用版本管理：

  • 5平台版本列表
  • 版本状态管理
  • 发布和废弃操作
  • 下载统计

上传APP版本 ​

友好的4步上传向导：

  1. 选择平台
  2. 上传文件（拖拽支持）
  3. 填写版本信息
  4. 确认和提交

快速开始 ​

5分钟部署 ​

bash
# Windows
cd manufacturer-system
start.bat

# Linux/Mac
cd manufacturer-system
chmod +x start.sh
./start.sh

访问系统 ​

查看完整部署指南 →

数据库设计 ​

系统包含8个核心数据表：

  1. devices - 设备表
  2. users - 用户表
  3. device_logs - 操作日志表
  4. key_backups - 数据备份表
  5. activation_codes - 激活码表
  6. app_versions - APP版本表
  7. app_downloads - 下载记录表
  8. password_recovery - 密码恢复表

查看详细数据库设计 →

API接口 ​

系统提供35+个RESTful API接口：

  • 设备管理API: 10个接口
  • APP版本API: 8个接口
  • 备份管理API: 6个接口
  • 用户管理API: 7个接口
  • 日志查询API: 4个接口

查看完整API文档 →

下一步 ​

获取帮助 ​

功能完整 · 易于使用 · 安全可靠

附录：规范章节补全（v5.0.3.108） ​

为对齐项目用户文档标准结构，下列章节补齐若干未在正文中单独列出的视角。已在正文覆盖的章节在此段仅作简述并标注 见上文 指引。

1. 概述 ​

见正文开篇与「系统定位」。U盾 / SIMKey 厂家管理系统是面向硬件设备厂家 / 经销商 / 服务商的一体化平台，提供设备全生命周期、多平台 APP 版本、数据备份恢复、用户权限、统计监控与操作审计。

2. 核心特性 ​

见正文「核心功能」与「系统特点」：6 大功能模块、快速部署、安全可靠（JWT + RBAC + 审计 + 加密）、界面友好（Element Plus + ECharts）、易于扩展（RESTful + 模块化 + MIT）。

3. 系统架构 ​

见正文「技术架构」：

前端 Vue3 + Element Plus + Vite5 + Pinia + ECharts
   │  REST（35+ 接口）
后端 Spring Boot 3.2.1 + Spring Security/JWT + MyBatis Plus
   │
MySQL 8.0（8 张核心表）+ Redis 7.0      部署：Docker Compose + Nginx

4. 系统定位 ​

见正文「系统定位」。面向 U盾 / SIMKey 硬件设备的生产厂家、经销商、服务提供商与企业 IT 部门。

5. 核心功能 ​

见正文「核心功能」6 模块：设备全生命周期 / 多平台 APP 版本 / 数据备份恢复 / 用户权限 / 统计监控 / 操作日志审计。

6. 技术架构 ​

见正文「技术架构」。后端 Spring Boot 3.2.1 + MySQL 8.0 + Redis 7.0 + MyBatis Plus + Spring Security + JWT + Swagger；前端 Vue 3 + Element Plus + Vite 5 + Pinia + Axios + ECharts 5。

7. 系统特点 ​

见正文「系统特点」：快速部署 / 安全可靠 / 界面友好 / 易于扩展。

8. 应用场景 ​

见正文「应用场景」：设备厂家 / 经销商 / 服务提供商 / 企业 IT 部门。

9. 竞品对比 ​

见正文「核心优势」：vs 手工管理（效率 / 准确性 / 可追溯 / 统计 / 扩展性）、vs 自建系统（开发成本 / 部署时间 / 维护 / 完整性 / 文档）。

10. 配置参考 ​

默认前端 http://localhost、API 文档 http://localhost:8080/api/swagger-ui.html、账号 admin / admin123456；自定义配置见 安装部署。

11. 性能指标 ​

一键部署 5 分钟可用；列表分页 + 索引查询 + Redis 缓存；统计图表 ECharts 渲染。35+ REST 接口（设备 10 / APP 8 / 备份 6 / 用户 7 / 日志 4）。

12. 测试覆盖 ​

后端各模块 Controller / Service 由单测 + 集成测试覆盖；API 经 Swagger 契约描述。各模块详细测试见对应子文档附录。

13. 安全考虑 ​

见正文「系统特点 — 安全可靠」：JWT 认证、RBAC 细粒度权限、完整操作审计、敏感数据加密（备份 AES-256-GCM）。生产部署改默认密码 / JWT_SECRET。

14. 故障排除 ​

症状可能原因处理
服务起不来端口冲突 / Docker 未运行见 安装部署 排查
登录失败默认账号 / 数据库未初始化admin / admin123456，确认 initdb
图表空白无数据先注册设备 / 产生操作

15. 关键文件 ​

见正文「数据库设计」（8 表：devices / users / device_logs / key_backups / activation_codes / app_versions / app_downloads / password_recovery）与「API 接口」（35+ 接口）。部署文件见 安装部署。

16. 使用示例 ​

见正文「快速开始 — 5 分钟部署」（start.bat / start.sh）与「访问系统」。

17. 相关文档 ​

见正文「下一步」：快速开始 · 安装部署 · 设备管理 · APP 管理。

基于 MIT 许可发布

Copyright © 2024-2026 ChainlessChain Team