179 lines
4.2 KiB
Markdown
179 lines
4.2 KiB
Markdown
# AirLogistics - 航空物流信息管理系统
|
||
|
||
一款专业的航空物流管理Android应用，为机场货运站提供全流程数字化解决方案，涵盖国内外货物进出港、仓储管理、车辆调度等核心业务。
|
||
|
||
## 项目信息
|
||
|
||
- **版本**: 1.7.9
|
||
- **最低支持**: Android 7.0 (API 24)
|
||
- **目标版本**: Android 10 (API 30)
|
||
- **开发语言**: Kotlin + Java
|
||
- **架构模式**: MVVM + 组件化
|
||
|
||
## 核心功能
|
||
|
||
### 国内出港 (GNC)
|
||
- 货物收运管理
|
||
- 复磅称重（地磅集成）
|
||
- 转运管理
|
||
- 出库装机
|
||
- 仓库管理
|
||
- 数据查询与统计
|
||
|
||
### 国内进港 (GNJ)
|
||
- 舱单管理
|
||
- 卸机入库
|
||
- 出库提货
|
||
- 移库管理
|
||
- 货物交接
|
||
- 实时查询
|
||
|
||
### 国际出港 (GJC)
|
||
- 国际货物收运
|
||
- 板箱组装
|
||
- ULD容器管理
|
||
- 复磅称重
|
||
- 仓储移库
|
||
|
||
### 国际进港 (GJJ)
|
||
- 国际舱单管理
|
||
- 报文解析
|
||
- 理货管理
|
||
- 出库操作
|
||
- 货物交接
|
||
|
||
### 其他功能
|
||
- 航班查询与管理
|
||
- 货物状态追踪
|
||
- 运输日志
|
||
- 监装监卸管理
|
||
- 车辆调度与统计
|
||
- 消息与电报管理
|
||
- 事故签证处理
|
||
|
||
## 技术特性
|
||
|
||
### 架构设计
|
||
- **组件化架构**: 模块间解耦，支持独立开发调试
|
||
- **MVVM模式**: 数据驱动，清晰的业务逻辑分层
|
||
- **协程异步**: Kotlin Coroutines + Flow 实现响应式编程
|
||
- **模块路由**: ARouter实现模块间通信
|
||
|
||
### 核心技术
|
||
- **网络框架**: Retrofit + OkHttp
|
||
- **数据解析**: FastJSON + Gson
|
||
- **UI框架**: Material Design + DataBinding
|
||
- **图表展示**: MPAndroidChart定制版
|
||
- **蓝牙打印**: 佳博打印SDK集成
|
||
- **扫码功能**: ZXing条码扫描
|
||
- **屏幕适配**: AutoSize横屏适配方案
|
||
|
||
## 快速开始
|
||
|
||
### 环境要求
|
||
|
||
- Android Studio Arctic Fox (2020.3.1) 或更高版本
|
||
- JDK 1.8
|
||
- Gradle 7.3.3
|
||
- Kotlin 1.6.21
|
||
|
||
### 依赖配置
|
||
|
||
如遇依赖下载问题，请参考以下步骤：
|
||
|
||
1. 下载 gradle-7.3.3-bin.zip
|
||
- 百度网盘: https://pan.baidu.com/s/18wsuGRlNxjMYbxLhBH9yeg
|
||
- 提取码: 1029
|
||
|
||
2. 在 Android Studio 中打开设置:
|
||
- Settings → Build, Execution, Deployment → Build Tools → Gradle
|
||
- 解压下载的文件并替换 "Gradle user home" 目录中的对应文件夹
|
||
|
||
### 构建项目
|
||
|
||
```bash
|
||
# 克隆项目
|
||
git clone [repository-url]
|
||
cd aerologic-app
|
||
|
||
# 构建Debug版本
|
||
./gradlew assembleDebug
|
||
|
||
# 构建Release版本
|
||
./gradlew assembleRelease
|
||
|
||
# 安装到设备
|
||
./gradlew installDebug
|
||
```
|
||
|
||
### 组件化开发
|
||
|
||
项目支持组件化开发模式，可独立运行各业务模块：
|
||
|
||
1. 编辑 `gradle.properties` 文件
|
||
2. 修改 `isBuildModule=true`（独立模块）或 `false`（集成模式）
|
||
3. Sync项目并运行对应模块
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
aerologic-app/
|
||
├── app/ # 应用主模块
|
||
├── module_base/ # 基础库模块（核心）
|
||
├── module_gnc/ # 国内出港
|
||
├── module_gnj/ # 国内进港
|
||
├── module_gjc/ # 国际出港
|
||
├── module_gjj/ # 国际进港
|
||
├── module_hangban/ # 航班管理
|
||
├── module_cargo/ # 货物追踪
|
||
├── module_mit/ # 监装监卸
|
||
├── module_p/ # PDA功能
|
||
├── Printer/ # 蓝牙打印
|
||
├── MPChartLib/ # 图表库
|
||
└── CLAUDE.md # 开发指南
|
||
```
|
||
|
||
## 开发文档
|
||
|
||
详细的开发指南请参考 [CLAUDE.md](./CLAUDE.md)，包含：
|
||
|
||
- 完整的架构说明
|
||
- API调用规范
|
||
- 开发模板代码
|
||
- 常见业务场景实现
|
||
- 技术栈使用指南
|
||
|
||
## 配置说明
|
||
|
||
### 网络配置
|
||
|
||
内网服务器地址配置位置：
|
||
- `module_base/src/main/res/values/strings.xml`
|
||
- `system_url_inner`: 主服务器地址
|
||
- `weight_url`: 地磅服务器地址
|
||
|
||
### 签名配置
|
||
|
||
Release版本签名信息：
|
||
- KeyStore: `key.jks`
|
||
- 密码: `123321`
|
||
- 别名: `key`
|
||
|
||
## 分支管理
|
||
|
||
- `develop`: 主开发分支
|
||
- `feature/*`: 功能开发分支
|
||
- `release/*`: 发布分支
|
||
|
||
## 许可证
|
||
|
||
[根据实际情况添加许可证信息]
|
||
|
||
## 联系方式
|
||
|
||
[根据实际情况添加联系方式]
|
||
|
||
---
|
||
|
||
**注意**: 本项目为企业内部系统，包含敏感业务信息和配置，请勿外传。
|