v6ole/H3ConuMS-v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

初始化

Browse Source
This commit is contained in:
v6ole
2026-04-02 23:40:04 +08:00
commit 381ea7085d
107 changed files with 11858 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
项目总结.md
+318
View File
@@ -0,0 +1,318 @@
# H3C ONU设备管理系统 - 项目总结
## 项目概述
基于Python FastAPI + Vue 3的H3C OLT设备监控管理系统，用于监控和管理4000+ ONU设备的在线状态。系统通过SSH连接H3C OLT设备，查询ONU设备状态，提供Web界面进行设备管理、状态监控、数据导入和权限管理。
## 设计讨论要点总结
### 1. 核心需求确认
- **设备状态监控**: 通过SSH连接H3C OLT设备，使用`display onu slot`命令查询ONU状态
- **数据规模**: 4000+设备MAC地址和物理位置信息管理
- **数据源**: Excel表格导入，PostgreSQL数据库存储
- **更新频率**: 自动每30分钟更新，手动刷新5分钟冷却限制
- **历史记录**: 保存90天状态历史
- **权限管理**: Casdoor统一认证，RBAC权限控制，区域/学校级别数据隔离
- **部署要求**: Docker Compose编排，外部数据库支持，环境变量配置
### 2. 技术架构决策
- **后端**: Python FastAPI + PostgreSQL + Celery + Redis
- **前端**: Vue 3 + Element Plus + Pinia
- **认证**: Casdoor统一认证集成
- **部署**: Docker容器化，Nginx反向代理
- **监控**: 健康检查，性能监控，日志收集
### 3. 权限系统设计
- **角色层级**: 超级管理员 → 管理员 → 区域管理员 → 学校管理员 → 操作员 → 查看员
- **权限控制**: 基于RBAC，支持数据级权限过滤
- **变更审核**: 设备信息变更需要管理员审核
- **Casdoor集成**: 统一认证，用户信息同步
### 4. 功能模块规划
1. **基础框架**: 项目结构，环境配置，Docker化
2. **认证系统**: Casdoor集成，JWT管理，权限中间件
3. **设备管理**: Excel导入，设备CRUD，状态检查
4. **SSH连接**: 连接池管理，命令执行，结果解析
5. **任务调度**: 定时检查，手动刷新，异步处理
6. **权限系统**: 角色管理，权限分配，数据过滤
7. **统计图表**: 仪表板，趋势分析，报表导出
8. **系统设置**: OLT配置，任务配置，审核流程
## 系统架构设计
### 整体架构
```
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ 用户浏览器 │ │ Nginx反向代理 │ │ FastAPI后端 │
│ │◄──►│ │◄──►│ │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │
▼ ▼
┌─────────────────┐ ┌─────────────────┐
│ Vue前端应用 │ │ Celery Worker │
│ │ │ │
└─────────────────┘ └─────────────────┘
│ │
▼ ▼
┌─────────────────┐ ┌─────────────────┐
│ PostgreSQL数据库 │ │ Redis │
│ (外部) │ │ (外部) │
└─────────────────┘ └─────────────────┘
│
▼
┌─────────────────┐
│ Casdoor │
│ 认证服务器 │
└─────────────────┘
```
### 数据库设计核心表
1. **olt_devices**: OLT设备信息（IP、SSH凭证、插槽命令）
2. **onu_devices**: ONU设备信息（MAC、位置、关联OLT）
3. **device_status_history**: 设备状态历史记录
4. **users**: 用户信息（Casdoor集成）
5. **roles/permissions**: 角色和权限管理
6. **device_change_requests**: 设备变更审核记录
### API设计原则
- RESTful风格，版本控制（/api/v1/）
- JWT认证，权限中间件
- 数据验证（Pydantic）
- 异步处理耗时操作
- 完善的错误处理和日志
## 关键技术实现
### 1. SSH连接管理
- **连接池**: 复用SSH连接，提高性能
- **超时重试**: 网络波动容错
- **命令解析**: 解析`display onu slot`命令输出
- **批量处理**: 分批查询，避免阻塞
### 2. 异步任务处理
- **Celery**: 异步任务队列
- **Redis**: 消息代理和结果存储
- **定时任务**: Celery Beat调度
- **进度跟踪**: 任务状态监控
### 3. 数据导入处理
- **Pandas**: Excel文件解析
- **数据验证**: 格式检查，重复检测
- **批量插入**: 性能优化
- **进度反馈**: 实时导入进度
### 4. 权限系统实现
- **RBAC模型**: 角色-权限关联
- **数据过滤**: SQL级别权限控制
- **中间件**: 请求级别权限检查
- **Casdoor同步**: 用户信息自动同步
### 5. 前端架构
- **组件化**: 可复用组件设计
- **状态管理**: Pinia集中状态
- **路由守卫**: 页面访问控制
- **响应式设计**: 移动端适配
## 部署方案
### 环境要求
- Docker 20.10+
- Docker Compose 2.0+
- 外部PostgreSQL数据库
- 外部Redis服务
- Casdoor认证服务器
### 配置文件
- **.env**: 环境变量配置
- **docker-compose.yml**: 服务编排
- **nginx.conf**: 反向代理配置
- **部署脚本**: 自动化部署和监控
### 监控和运维
- **健康检查**: /health端点
- **性能监控**: /metrics端点（Prometheus格式）
- **日志收集**: 结构化日志，日志轮转
- **备份策略**: 数据库定期备份
## 开发计划
### 第一阶段（2周）：项目基础
- 环境搭建，基础框架
- Casdoor集成，基础API
- 前端框架搭建
### 第二阶段（4周）：核心功能
- 数据库设计，设备管理
- SSH连接，状态检查
- Excel导入，数据管理
- 权限系统实现
### 第三阶段（3周）：高级功能
- 统计图表，仪表板
- 系统设置，审核流程
- 性能优化，测试完善
### 第四阶段（1-2周）：部署上线
- 生产环境部署
- 监控配置
- 用户培训
## 风险评估和应对
### 技术风险
1. **SSH连接稳定性**
- 风险：网络问题导致连接失败
- 应对：连接池、重试机制、超时设置
2. **性能问题**
- 风险：4000+设备查询性能
- 应对：异步处理、缓存优化、分批查询
3. **安全性**
- 风险：SSH凭证存储安全
- 应对：加密存储、访问控制、审计日志
### 项目风险
1. **需求变更**
- 风险：开发进度延迟
- 应对：敏捷开发、定期沟通
2. **集成问题**
- 风险：Casdoor集成问题
- 应对：早期测试、备用方案
## 扩展性考虑
### 水平扩展
- 无状态API服务，支持多实例
- 数据库读写分离
- Redis集群支持
- 负载均衡配置
### 功能扩展
1. **库存管理模块**（计划中）
- 设备库存管理
- 出入库记录
- 库存预警
2. **告警通知模块**（计划中）
- 设备离线告警
- 多通道通知
- 告警规则配置
3. **报表导出模块**（计划中）
- 自定义报表
- 数据导出
- 统计图表
4. **移动端适配**（计划中）
- 响应式移动端
- PWA支持
- 离线功能
## 成功标准
### 功能完成度
- 核心功能100%实现
- 高级功能80%实现
- 用户体验满意度≥90%
### 性能指标
- 页面加载时间<3秒
- API响应时间<500ms
- 系统可用性≥99.5%
### 质量指标
- 测试覆盖率≥80%
- 缺陷密度<0.5/千行代码
- 用户反馈满意度≥85%
### 项目指标
- 按时交付率≥90%
- 预算控制率≥95%
- 团队满意度≥85%
## 项目文档清单
### 已创建文档
1. **系统设计文档.md** - 详细系统设计说明
2. **README.md** - 项目概述和快速开始
3. **PROJECT_STRUCTURE.md** - 项目结构说明
4. **开发计划.md** - 详细开发计划
5. **项目总结.md** - 本项目总结文档
### 部署配置
1. **deploy/docker-compose.yml** - Docker编排配置
2. **deploy/.env.example** - 环境变量示例
3. **deploy/nginx/** - Nginx配置
4. **deploy/scripts/** - 部署和运维脚本
### 待创建文档
1. **API文档** - 详细API接口说明
2. **用户手册** - 最终用户使用指南
3. **部署指南** - 生产环境部署步骤
4. **开发指南** - 开发者贡献指南
## 后续步骤建议
### 短期（1-2周）
1. 搭建开发环境
2. 创建基础项目结构
3. 配置Casdoor集成
4. 实现基础认证功能
### 中期（1-2月）
1. 完成核心功能开发
2. 进行系统测试
3. 准备生产环境部署
4. 用户培训材料准备
### 长期（2-3月）
1. 系统上线运行
2. 收集用户反馈
3. 优化系统性能
4. 规划扩展功能开发
## 技术选型理由
### 后端技术选型
- **FastAPI**: 高性能，异步支持好，自动API文档
- **PostgreSQL**: 关系型数据库，事务支持，JSONB扩展
- **Celery**: 成熟的异步任务框架，社区支持好
- **Paramiko**: Python SSH库，功能完善，文档齐全
### 前端技术选型
- **Vue 3**: 渐进式框架，学习曲线平缓，生态丰富
- **Element Plus**: 企业级UI组件，设计规范，功能全面
- **Pinia**: Vue 3官方推荐状态管理，TypeScript支持好
### 部署技术选型
- **Docker**: 容器化标准，环境一致性，易于部署
- **Nginx**: 高性能Web服务器，反向代理成熟方案
- **Casdoor**: 开源统一认证，支持OAuth 2.0，易于集成
## 项目价值
### 业务价值
1. **效率提升**: 自动化设备状态监控，减少人工检查
2. **数据集中**: 统一管理4000+设备信息，便于查询统计
3. **实时监控**: 及时发现设备离线，快速响应
4. **权限控制**: 多级权限管理，数据安全有保障
### 技术价值
1. **现代化架构**: 采用最新技术栈，易于维护扩展
2. **容器化部署**: 环境一致，部署简单，易于运维
3. **开源集成**: 利用成熟开源方案，降低开发成本
4. **良好扩展性**: 模块化设计，便于功能扩展
## 总结
本项目是一个完整的设备监控管理系统，从需求分析、架构设计到部署方案都进行了详细规划。系统采用现代化的技术栈，具备良好的扩展性和维护性。通过分阶段实施，可以确保项目稳步推进，最终交付一个稳定、高效、易用的系统。
项目已经完成了详细的设计和规划，具备了开始实施的所有必要条件。建议按照开发计划分阶段实施，定期进行进度评审和调整，确保项目成功交付。
---
**文档版本**: v1.0
**创建日期**: 2026年4月1日
**最后更新**: 2026年4月1日
**项目状态**: 设计完成，准备实施