feat: new readme file

2025-11-10 18:24:01 +08:00
parent b65b28ec9e
commit c1d4f5a74f
2 changed files with 272 additions and 94 deletions
--- a/README.md
+++ b/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
-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
+### 国内进港 (GNJ)
+- 舱单管理
+- 卸机入库
+- 出库提货
+- 移库管理
+- 货物交接
+- 实时查询

-### 运单号
+### 国际出港 (GJC)
+- 国际货物收运
+- 板箱组装
+- ULD容器管理
+- 复磅称重
+- 仓储移库

- 00013131333
- 00013131344
- 00022222211
- 66697979711
- 00014141433
+### 国际进港 (GJJ)
+- 国际舱单管理
+- 报文解析
+- 理货管理
+- 出库操作
+- 货物交接

-### 运单号+件号
+### 其他功能
+- 航班查询与管理
+- 货物状态追踪
+- 运输日志
+- 监装监卸管理
+- 车辆调度与统计
+- 消息与电报管理
+- 事故签证处理

- 9998989891100001
- 9998989891100002
- 9998989892200001
- 9998989892200002
+## 技术特性

-### 航班 
-```json
-{
-  "fdate": "2023-12-14",
-  "fno": "CF789"
-}
+### 架构设计
+- **组件化架构**: 模块间解耦，支持独立开发调试
+- **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
 ```

-### 航班信息
-{
-"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”中的文件夹。
+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/*`: 发布分支
+
+## 许可证
+
+[根据实际情况添加许可证信息]
+
+## 联系方式
+
+[根据实际情况添加联系方式]
+
+---
+
+**注意**: 本项目为企业内部系统，包含敏感业务信息和配置，请勿外传。
--- a/备忘录.md
+++ b/备忘录.md
@@ -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”中的文件夹。