邮轮穿舱件管理系统后台 - 系统介绍文档
概述
邮轮穿舱件管理系统是一个专门为邮轮制造行业设计的后台管理系统，旨在优化和标准化穿舱件的全生命周期管理流程。该系统基于FastAPI框架构建，采用现代化的微服务架构，为邮轮制造企业提供高效、可靠的穿舱件管理解决方案。
业务背景
邮轮制造行业特点
邮轮制造是高度复杂的系统工程，涉及大量穿舱件的安装和管理。穿舱件是指穿过船体舱壁的各种管道、电缆、通风管等部件，其管理质量直接影响船舶的安全性和可靠性。
管理挑战
- 数量庞大：一艘大型邮轮包含数千个穿舱件
- 技术规范复杂：涉及防火等级、水密性、材料规格等多重技术标准
- 生命周期长：从设计、制造、安装到维护的全过程管理
- 质量追溯要求高：需要完整的质量记录和追溯体系
目标用户群体
主要用户角色
-
设计工程师
- 负责穿舱件的技术规格定义
- 制定安装标准和验收规范
- 管理技术图纸和文档
-
生产管理人员
- 监控穿舱件的生产进度
- 协调安装作业计划
- 管理质量检验流程
-
质量检验人员
- 执行穿舱件的质量检验
- 记录检验结果和问题
- 管理不合格品处理
-
维护工程师
- 负责穿舱件的日常维护
- 处理故障和维修工单
- 管理备件库存
用户价值
- 标准化作业：统一的管理标准和流程
- 效率提升：自动化的数据处理和流转
- 质量保障：完整的质量追溯体系
- 决策支持：实时的数据分析和报表
核心价值
业务流程优化
flowchart TD
A[穿舱件设计] --> B[技术规格定义]
B --> C[生产计划制定]
C --> D[安装作业执行]
D --> E[质量检验]
E --> F[验收交付]
F --> G[维护管理]
G --> H[生命周期结束]
技术架构价值
- 模块化设计：清晰的业务边界和职责分离
- 可扩展性：支持业务功能的灵活扩展
- 高可用性：稳定的系统性能和容错机制
- 安全性：完善的身份认证和权限控制
系统架构分析
整体架构图
flowchart TD
subgraph 前端层
A[Web管理界面]
B[微信小程序]
C[移动端APP]
end
subgraph API网关层
D[FastAPI应用]
end
subgraph 业务逻辑层
E[工件管理服务]
F[工单管理服务]
G[图片管理服务]
H[用户管理服务]
end
subgraph 数据访问层
I[PostgreSQL]
J[MongoDB]
K[文件存储]
end
A --> D
B --> D
C --> D
D --> E
D --> F
D --> G
D --> H
E --> I
F --> I
G --> K
H --> I
E --> J
核心模块分析
1. 工件管理模块
功能职责：
- 穿舱件基本信息管理
- 状态跟踪和生命周期管理
- 技术规格数据存储
数据模型：
classDiagram
class Workpiece {
+workpiece_id: IntField
+workpiece_status: IntField
+inspect_reference: IntField
+maintainance_reference: IntField
+created_by: IntField
+updated_by: IntField
+created_at: DatetimeField
+updated_at: DatetimeField
}
参考文件：
2. 工件信息模块（MongoDB）
功能职责：
- 存储穿舱件的详细技术信息
- 支持灵活的数据结构扩展
- 提供全文搜索能力
数据模型：
classDiagram
class WorkpieceInfo {
+wp_id: str
+wp_firestop_code: str
+wp_matrial: str
+wp_size: str
+wp_fire_rating: str
+wp_watertightness: str
+wp_main_vertical_zone: str
+wp_installation_location: str
+wp_z_coordinate: str
+wp_frame_station: str
+wp_longitudinal_stiffener: str
+wp_sap1: str
+wp_sap2: str
+wp_standard_drawing_catalogue: str
+wp_extra: str
}
参考文件：
3. 工单管理模块
功能职责：
- 管理穿舱件的各类工单
- 跟踪工单执行状态
- 记录工单历史
数据模型：
classDiagram
class Ticket {
+ticket_id: IntField
+ticket_type: CharField
+ticket_status: CharField
+target_workpiece: IntField
+ticket_from: CharField
+ticket_tos: CharField
+ticket_content: TextField
+ticket_title: CharField
+feedback_text: TextField
+image_list: CharField
+reference_list: CharField
+created_by: IntField
+updated_by: IntField
+created_at: DatetimeField
+updated_at: DatetimeField
}
参考文件：
穿舱件管理流程支持
1. 设计阶段支持
- 技术规格管理：存储和管理穿舱件的技术参数
- 图纸管理：关联技术图纸和文档
- 标准符合性检查：验证设计符合行业标准
2. 生产阶段支持
- 进度跟踪：实时监控生产进度
- 质量检验：记录检验结果和问题
- 批次管理：管理生产批次和追溯信息
3. 安装阶段支持
- 安装计划：制定和跟踪安装计划
- 现场管理：支持移动端现场作业
- 验收管理：管理验收流程和记录
4. 维护阶段支持
- 维护计划：制定预防性维护计划
- 故障处理：管理故障报告和维修
- 备件管理：管理备件库存和使用
技术特色
双数据库架构
flowchart LR
A[关系型数据] --> B[PostgreSQL]
C[文档型数据] --> D[MongoDB]
E[文件数据] --> F[对象存储]
subgraph 数据访问层
G[统一数据接口]
end
B --> G
D --> G
F --> G
G --> H[业务逻辑层]
微服务架构
- 服务分离：每个业务模块独立部署
- API网关：统一的API入口和管理
- 服务发现：动态的服务注册和发现
安全机制
- JWT认证：基于令牌的身份验证
- 权限控制：细粒度的访问权限管理
- 审计日志：完整的操作日志记录
部署和运维
数据库迁移管理
系统支持两种数据库迁移场景：
- 空数据库初始化
aerich init-db
- 模型更新
aerich migrate
aerich upgrade
多环境支持
系统支持开发、测试、生产多环境部署，通过环境配置文件管理不同环境的参数。
参考文件：
索引
邮轮穿舱件管理系统通过现代化的技术架构和专业的业务设计，为邮轮制造企业提供了完整的穿舱件管理解决方案。系统不仅提升了管理效率，更重要的是建立了标准化的质量管理体系，为邮轮的安全运营提供了可靠保障。
系统的核心价值体现在：
- 业务流程标准化：统一的管理标准和流程
- 数据完整性：完整的数据记录和追溯
- 操作便捷性：友好的用户界面和操作体验
- 系统可靠性：稳定的系统性能和容错能力
通过持续的技术迭代和业务优化，该系统将成为邮轮制造行业数字化转型的重要支撑平台。
主要参考文件：