邮轮穿舱件管理系统-小程序端项目文档
项目概述
项目基本信息
- 项目名称: 邮轮穿舱件管理系统-小程序端
- 项目编号: C0726
- 技术栈: 基于UniApp框架的微信小程序
- UI组件库: TDesign MiniProgram (v1.8.6)
- 兼容性要求: UniApp版本需为1.06.2504040
项目目的
本项目是一个专门用于邮轮穿舱件管理的微信小程序系统，主要功能包括：
- 穿舱件任务管理
- 搜索功能
- 用户信息管理
- 消息通知系统
技术架构分析
项目结构
├── api/ # API接口层
├── app.js # 应用入口文件
├── app.json # 应用配置文件
├── app.less # 全局样式文件
├── behaviors/ # 小程序行为模块
├── components/ # 自定义组件库
├── config/ # 配置文件目录
├── custom-tab-bar/ # 自定义底部导航栏
├── pages/ # 页面文件目录
├── static/ # 静态资源目录
├── utils/ # 工具函数库
└── variable.less # 样式变量定义
核心架构特点
1. 多页面分包架构
项目采用微信小程序的分包加载机制，将功能模块按需加载：
flowchart TD
A[主包] --> B[首页]
A --> C[搜索页]
A --> D[任务页]
A --> E[我的页面]
F[分包1: support] --> G[支持页面]
H[分包2: workpieceDetail] --> I[工件详情]
J[分包3: bindUser] --> K[用户绑定]
L[分包4: message] --> M[消息中心]
N[分包5: search] --> O[搜索功能]
P[分包6: login] --> Q[登录相关]
2. 组件化设计
项目基于TDesign组件库进行开发，具有良好的组件复用性：
classDiagram
class App {
+onLaunch()
+globalData
+eventBus
+connect()
+setUnreadNum()
}
class EventBus {
+emit()
+on()
+off()
}
class TDesignComponents {
+t-toast
+其他UI组件
}
App --> EventBus: 使用
App --> TDesignComponents: 集成
3. 事件驱动架构
项目采用事件总线模式实现组件间通信：
sequenceDiagram
participant A as 页面组件
participant B as EventBus
participant C as 全局状态
participant D as 其他组件
A->>B: 触发事件
B->>C: 更新全局数据
B->>D: 通知相关组件
D->>D: 执行相应操作
页面结构分析
主包页面
- 首页 (
pages/home/index) - 应用主界面 - 搜索页 (
pages/searchPage/index) - 搜索功能入口 - 任务页 (
pages/taskPage/index) - 任务管理界面 - 我的页面 (
pages/my/index) - 用户个人中心
分包页面
- 支持模块 (
pages/support) - 技术支持相关 - 工件详情 (
pages/workpieceDetail) - 穿舱件详细信息 - 用户绑定 (
pages/bindUser) - 用户账号绑定 - 消息中心 (
pages/message) - 消息通知管理 - 登录相关 (
pages/login,pages/loginCode) - 用户认证流程 - 设置页面 (
pages/setting) - 系统设置
依赖关系分析
核心依赖
flowchart LR
A[App入口] --> B[EventBus工具]
A --> C[TDesign组件库]
A --> D[API接口层]
A --> E[Utils工具函数]
B --> F[页面通信]
C --> G[UI展示]
D --> H[数据交互]
E --> I[业务逻辑]
技术栈依赖关系
- 基础框架: UniApp + 微信小程序原生API
- UI组件: TDesign MiniProgram v1.8.6
- 开发工具: HBuilderX
- 代码规范: ESLint + Prettier
- 构建工具: 微信开发者工具
启动和运行流程
flowchart TD
A[克隆项目] --> B[HBuilderX打开]
B --> C[配置开发者工具路径]
C --> D[编译到小程序模拟器]
D --> E[微信开发者工具加载]
E --> F[小程序运行]
架构设计特点
1. 模块化设计
- 页面按功能模块分包加载，提升加载性能
- 组件复用度高，维护成本低
- API层与UI层分离，便于测试和维护
2. 状态管理
- 使用全局数据(
globalData)管理用户状态 - 事件总线实现跨组件通信
- 支持WebSocket实时通信
3. 性能优化
- 分包加载减少首屏加载时间
- 自定义TabBar提升用户体验
- 网络请求超时控制(10秒)
4. 安全性考虑
- 用户位置信息权限管理
- 登录认证流程完善
- 密码找回功能支持
开发规范
代码规范
- 使用ESLint进行代码质量检查
- Prettier进行代码格式化
- Husky实现Git提交前检查
目录规范
- 页面文件按功能模块组织
- 组件统一放在components目录
- 工具函数集中管理
兼容性说明
重要: 如遇UniApp相关错误，需将版本回退至1.06.2504040
参考文件
索引
邮轮穿舱件管理系统采用现代化的微信小程序技术栈，具备良好的架构设计和扩展性。项目通过分包加载、组件化设计和事件驱动架构，实现了高效的任务管理和用户交互体验。技术选型合理，代码规范完善，为后续功能扩展和维护提供了良好的基础。