feat: new readme file
This commit is contained in:
257
README.md
257
README.md
@@ -1,109 +1,178 @@
|
|||||||
# 航空物流信息app
|
# AirLogistics - 航空物流信息管理系统
|
||||||
|
|
||||||
Token:
|
一款专业的航空物流管理Android应用，为机场货运站提供全流程数字化解决方案，涵盖国内外货物进出港、仓储管理、车辆调度等核心业务。
|
||||||
|
|
||||||
Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJTWVNURU0iLCJhdXRob3JpdGllcyI6IjM1LDM5LDQyLDQ0LDQ2LDUxLDU2LDU4LDY5LDcxLDczIiwiZXhwIjoxNzAzNzQ1MDAyfQ.abbW8l5XO70zZN5MitbOnXcys4BJf3bYOJV7B5XOqYT7NfT3UTzsjPsDirAvQty-fBTDRI-kgUdkQLfzusttvw
|
## 项目信息
|
||||||
|
|
||||||
### ULD
|
- **版本**: 1.7.9
|
||||||
|
- **最低支持**: Android 7.0 (API 24)
|
||||||
|
- **目标版本**: Android 10 (API 30)
|
||||||
|
- **开发语言**: Kotlin + Java
|
||||||
|
- **架构模式**: MVVM + 组件化
|
||||||
|
|
||||||
PMC55522MU
|
## 核心功能
|
||||||
PMC555612MU
|
|
||||||
PMC12322MU
|
|
||||||
PMC44331MU
|
|
||||||
PMC19304K4
|
|
||||||
PMC5459K4
|
|
||||||
PMC3571K4
|
|
||||||
PMC3930K4
|
|
||||||
PMC6227K4
|
|
||||||
PMC4711K4
|
|
||||||
PAG60007GI
|
|
||||||
PMC18006K4
|
|
||||||
PMC17939K4
|
|
||||||
PMC3457K4
|
|
||||||
PMC6273K4
|
|
||||||
PAG60216GI
|
|
||||||
PMC18430K4
|
|
||||||
PMC35892JG
|
|
||||||
PMC31047JG
|
|
||||||
PMC09846K4
|
|
||||||
PMC22704K4
|
|
||||||
PMC4189K4
|
|
||||||
PMC5830K4
|
|
||||||
PMC50086K4
|
|
||||||
PMC0196K4
|
|
||||||
PMC5605K4
|
|
||||||
PMC0303K4
|
|
||||||
|
|
||||||
### 平板车
|
### 国内出港 (GNC)
|
||||||
|
- 货物收运管理
|
||||||
|
- 复磅称重（地磅集成）
|
||||||
|
- 转运管理
|
||||||
|
- 出库装机
|
||||||
|
- 仓库管理
|
||||||
|
- 数据查询与统计
|
||||||
|
|
||||||
321
|
### 国内进港 (GNJ)
|
||||||
322
|
- 舱单管理
|
||||||
323
|
- 卸机入库
|
||||||
324
|
- 出库提货
|
||||||
325
|
- 移库管理
|
||||||
326
|
- 货物交接
|
||||||
327
|
- 实时查询
|
||||||
329
|
|
||||||
356
|
|
||||||
357
|
|
||||||
358
|
|
||||||
354
|
|
||||||
339
|
|
||||||
367
|
|
||||||
353
|
|
||||||
341
|
|
||||||
342
|
|
||||||
347
|
|
||||||
348
|
|
||||||
336
|
|
||||||
012
|
|
||||||
013
|
|
||||||
009
|
|
||||||
010
|
|
||||||
666
|
|
||||||
008
|
|
||||||
401
|
|
||||||
403
|
|
||||||
407
|
|
||||||
402
|
|
||||||
404
|
|
||||||
405
|
|
||||||
406
|
|
||||||
|
|
||||||
### 运单号
|
### 国际出港 (GJC)
|
||||||
|
- 国际货物收运
|
||||||
|
- 板箱组装
|
||||||
|
- ULD容器管理
|
||||||
|
- 复磅称重
|
||||||
|
- 仓储移库
|
||||||
|
|
||||||
- 00013131333
|
### 国际进港 (GJJ)
|
||||||
- 00013131344
|
- 国际舱单管理
|
||||||
- 00022222211
|
- 报文解析
|
||||||
- 66697979711
|
- 理货管理
|
||||||
- 00014141433
|
- 出库操作
|
||||||
|
- 货物交接
|
||||||
|
|
||||||
### 运单号+件号
|
### 其他功能
|
||||||
|
- 航班查询与管理
|
||||||
|
- 货物状态追踪
|
||||||
|
- 运输日志
|
||||||
|
- 监装监卸管理
|
||||||
|
- 车辆调度与统计
|
||||||
|
- 消息与电报管理
|
||||||
|
- 事故签证处理
|
||||||
|
|
||||||
- 9998989891100001
|
## 技术特性
|
||||||
- 9998989891100002
|
|
||||||
- 9998989892200001
|
|
||||||
- 9998989892200002
|
|
||||||
|
|
||||||
### 航班
|
### 架构设计
|
||||||
```json
|
- **组件化架构**: 模块间解耦，支持独立开发调试
|
||||||
{
|
- **MVVM模式**: 数据驱动，清晰的业务逻辑分层
|
||||||
"fdate": "2023-12-14",
|
- **协程异步**: Kotlin Coroutines + Flow 实现响应式编程
|
||||||
"fno": "CF789"
|
- **模块路由**: 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
|
||||||
```
|
```
|
||||||
|
|
||||||
### 航班信息
|
### 组件化开发
|
||||||
{
|
|
||||||
"fdate": "2023-12-14",
|
|
||||||
"fno": "CF789"
|
|
||||||
}
|
|
||||||
|
|
||||||
20231219CF2002
|
项目支持组件化开发模式，可独立运行各业务模块：
|
||||||
|
|
||||||
### 依赖报错解决办法
|
1. 编辑 `gradle.properties` 文件
|
||||||
1.下载gradle-7.3.3-bin压缩包，
|
2. 修改 `isBuildModule=true`（独立模块）或 `false`（集成模式）
|
||||||
通过网盘分享的文件：gradle-7.3.3-bin.zip
|
3. Sync项目并运行对应模块
|
||||||
链接: https://pan.baidu.com/s/18wsuGRlNxjMYbxLhBH9yeg 提取码: 1029
|
|
||||||
2.打开settings->Build, Execution, Deployment > Build Tools > Gradle
|
## 项目结构
|
||||||
3.打开“Gradle user home”中的目录，解压下载的压缩包，并替换“Gradle user home”中的文件夹。
|
|
||||||
|
```
|
||||||
|
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/*`: 发布分支
|
||||||
|
|
||||||
|
## 许可证
|
||||||
|
|
||||||
|
[根据实际情况添加许可证信息]
|
||||||
|
|
||||||
|
## 联系方式
|
||||||
|
|
||||||
|
[根据实际情况添加联系方式]
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**注意**: 本项目为企业内部系统，包含敏感业务信息和配置，请勿外传。
|
||||||
|
|||||||
109
备忘录.md
Normal file
109
备忘录.md
Normal file
@@ -0,0 +1,109 @@
|
|||||||
|
# 航空物流信息app
|
||||||
|
|
||||||
|
Token:
|
||||||
|
|
||||||
|
Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJTWVNURU0iLCJhdXRob3JpdGllcyI6IjM1LDM5LDQyLDQ0LDQ2LDUxLDU2LDU4LDY5LDcxLDczIiwiZXhwIjoxNzAzNzQ1MDAyfQ.abbW8l5XO70zZN5MitbOnXcys4BJf3bYOJV7B5XOqYT7NfT3UTzsjPsDirAvQty-fBTDRI-kgUdkQLfzusttvw
|
||||||
|
|
||||||
|
### ULD
|
||||||
|
|
||||||
|
PMC55522MU
|
||||||
|
PMC555612MU
|
||||||
|
PMC12322MU
|
||||||
|
PMC44331MU
|
||||||
|
PMC19304K4
|
||||||
|
PMC5459K4
|
||||||
|
PMC3571K4
|
||||||
|
PMC3930K4
|
||||||
|
PMC6227K4
|
||||||
|
PMC4711K4
|
||||||
|
PAG60007GI
|
||||||
|
PMC18006K4
|
||||||
|
PMC17939K4
|
||||||
|
PMC3457K4
|
||||||
|
PMC6273K4
|
||||||
|
PAG60216GI
|
||||||
|
PMC18430K4
|
||||||
|
PMC35892JG
|
||||||
|
PMC31047JG
|
||||||
|
PMC09846K4
|
||||||
|
PMC22704K4
|
||||||
|
PMC4189K4
|
||||||
|
PMC5830K4
|
||||||
|
PMC50086K4
|
||||||
|
PMC0196K4
|
||||||
|
PMC5605K4
|
||||||
|
PMC0303K4
|
||||||
|
|
||||||
|
### 平板车
|
||||||
|
|
||||||
|
321
|
||||||
|
322
|
||||||
|
323
|
||||||
|
324
|
||||||
|
325
|
||||||
|
326
|
||||||
|
327
|
||||||
|
329
|
||||||
|
356
|
||||||
|
357
|
||||||
|
358
|
||||||
|
354
|
||||||
|
339
|
||||||
|
367
|
||||||
|
353
|
||||||
|
341
|
||||||
|
342
|
||||||
|
347
|
||||||
|
348
|
||||||
|
336
|
||||||
|
012
|
||||||
|
013
|
||||||
|
009
|
||||||
|
010
|
||||||
|
666
|
||||||
|
008
|
||||||
|
401
|
||||||
|
403
|
||||||
|
407
|
||||||
|
402
|
||||||
|
404
|
||||||
|
405
|
||||||
|
406
|
||||||
|
|
||||||
|
### 运单号
|
||||||
|
|
||||||
|
- 00013131333
|
||||||
|
- 00013131344
|
||||||
|
- 00022222211
|
||||||
|
- 66697979711
|
||||||
|
- 00014141433
|
||||||
|
|
||||||
|
### 运单号+件号
|
||||||
|
|
||||||
|
- 9998989891100001
|
||||||
|
- 9998989891100002
|
||||||
|
- 9998989892200001
|
||||||
|
- 9998989892200002
|
||||||
|
|
||||||
|
### 航班
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"fdate": "2023-12-14",
|
||||||
|
"fno": "CF789"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 航班信息
|
||||||
|
{
|
||||||
|
"fdate": "2023-12-14",
|
||||||
|
"fno": "CF789"
|
||||||
|
}
|
||||||
|
|
||||||
|
20231219CF2002
|
||||||
|
|
||||||
|
### 依赖报错解决办法
|
||||||
|
1.下载gradle-7.3.3-bin压缩包，
|
||||||
|
通过网盘分享的文件：gradle-7.3.3-bin.zip
|
||||||
|
链接: https://pan.baidu.com/s/18wsuGRlNxjMYbxLhBH9yeg 提取码: 1029
|
||||||
|
2.打开settings->Build, Execution, Deployment > Build Tools > Gradle
|
||||||
|
3.打开“Gradle user home”中的目录，解压下载的压缩包，并替换“Gradle user home”中的文件夹。
|
||||||
Reference in New Issue
Block a user