# 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/*`: 发布分支

## 许可证

[根据实际情况添加许可证信息]

## 联系方式

[根据实际情况添加联系方式]

---

**注意**: 本项目为企业内部系统，包含敏感业务信息和配置，请勿外传。