YANG JIANKUAN
bbc29ca2e1
- 按 api-doc 接口文档修正交接状态入参 hoState → handoverState（原参数被后端 静默忽略，两个 Tab 返回同一批数据）；内网实机验证 0/1 过滤与 App 端到端链路 均生效，平板端回归无影响 - 新增《后端接口对接问题清单.xlsx》：按模块/页面/接口定义/接口地址索引的后端 对接文档，含 5 项待处理缺口（移库缺航班字段/操作人姓名/数据不回填、交接缺 交接人入参、pageQueryTotal 出参恒 0）+ 1 项已验证归档 - phone-adapt skill 新增 references/api-doc.md（api-doc MCP 核对流程 + 内网 直调验证技巧），阶段 2 改为「先查接口文档再问用户」，修正 verification.md 中「后端不认 hoState」的过时误判结论 - CLAUDE.md / CHANGELOG.md 同步走查与验证结论 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
139 lines
5.5 KiB
Markdown
139 lines
5.5 KiB
Markdown
# 版本变更日志 (Changelog)
|
||
|
||
本文档记录 AirLogistics 项目的所有重要变更。
|
||
|
||
格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/),
|
||
版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
|
||
|
||
## [Unreleased]
|
||
|
||
### 修复 (Fixed)
|
||
- 出库交接手机版「待/已交接」Tab 与角标计数的过滤参数名修正：`hoState` → `handoverState`
|
||
（以 api-doc 接口文档为准；此前误传 `hoState` 被后端静默忽略，两个 Tab 返回同一批数据）。
|
||
2026-07-29 内网实机验证通过：fdate=2026-07-16 下待交接/已交接 Tab 分别精确返回对应板箱，与后端直调结果一致。
|
||
验证中发现 `IntExpOutHandover/pageQueryTotal` 出参恒 0（后端缺陷，致 Tab 角标与平板底部统计为 0，已记录问题清单 #6）
|
||
|
||
### 新增 (Added)
|
||
- 新增《后端接口对接问题清单》（`documents/后端接口对接问题清单.xlsx`）：手机端适配走查发现的接口缺口
|
||
（移库列表缺航班字段、缺操作人姓名、`opId/opdate/businessType` 不回填、出库交接查询缺「交接人」入参），
|
||
按模块/页面/接口定义/接口地址索引，作为与后端对接的持续维护文档
|
||
- phone-adapt skill 新增 `references/api-doc.md`：api-doc MCP 连接与逐接口核对流程，接口对齐从「问用户」升级为「先查接口文档」
|
||
|
||
---
|
||
|
||
## [1.9.0] - 2026-07-29
|
||
|
||
### 新增 (Added)
|
||
- 5.5 寸手持端双形态适配框架：同名布局 + 资源限定符（`layout/` 手机、`layout-sw600dp/` 平板）自动切换，业务逻辑（ViewModel/ViewHolder）零改动
|
||
- 新增 `DeviceUtil` 设备形态判定工具，及手机版公共组件库（`PhoneSearchBar`、`PhoneStatusTab`、`PhoneDataLayout`、`PhoneFilterPanel`、`PhoneBottomBar`、`PhoneStatBox`、`PhoneKvItem`）
|
||
- 完成「国际出港移库」「国际出港出库交接」两个页面的手机端适配，含各自的详情页（`IntExpMoveDetailActivity`、`IntExpOutHandoverDetailActivity`）
|
||
- 手机端首页菜单接入「出港移库」「出库交接」入口
|
||
|
||
### 修复 (Fixed)
|
||
- 修复手机端进入页面时「先横屏、约 1 秒后转竖屏」的闪屏问题：Manifest 统一改为 `android:screenOrientation="unspecified"`（全项目 192 处），由 `BaseActivity.applyDeviceOrientation()` 按设备形态在运行时锁定方向，避免系统建窗口时用错误方向
|
||
- 修复平板端因中间方案（`@integer/screen_orientation` 资源限定符）引入的回归：先竖屏再转横屏，且交互后 UI 整体放大约 1.6 倍（AutoSize 误选平板竖屏基准所致）；验证系统解析 Manifest 属性不套用设备限定符，恢复为 `unspecified` 方案后两端方向与缩放均恢复正常
|
||
- AutoSize 增加手机竖屏专用设计基准 390×844dp，避免手机端沿用平板竖屏 720dp 基准导致 UI 压缩
|
||
|
||
### 技术栈
|
||
- Kotlin 1.6.21
|
||
- Android Gradle Plugin 7.2.0
|
||
- Gradle 7.3.3
|
||
- minSdk 24, targetSdk 30, compileSdk 31
|
||
|
||
---
|
||
|
||
## [1.8.4] - 2024-12-02
|
||
|
||
### 新增 (Added)
|
||
- 完善 Claude Code 配置,添加 Android 开发权限
|
||
- 创建 8 个快捷命令 (/build-debug, /install, /logs 等)
|
||
- 定制 CLAUDE.md 为 Android 项目专用开发指南
|
||
- 添加 CONTRIBUTING.md 贡献指南文档
|
||
- 添加 CHANGELOG.md 版本变更日志
|
||
|
||
### 改进 (Changed)
|
||
- 优化首页菜单交互体验
|
||
- 改进 UI 界面显示效果
|
||
|
||
### 技术栈
|
||
- Kotlin 1.6.21
|
||
- Android Gradle Plugin 7.2.0
|
||
- Gradle 7.3.3
|
||
- minSdk 24, targetSdk 30, compileSdk 31
|
||
|
||
---
|
||
|
||
## [1.8.x] - 之前版本
|
||
|
||
### 主要功能
|
||
- 国内出港业务模块 (货物收运、复磅称重、转运管理、出库装机)
|
||
- 国内进港业务模块 (舱单管理、卸机入库、出库提货、移库管理)
|
||
- 国际出港业务模块 (国际货物收运、板箱组装、ULD容器管理)
|
||
- 国际进港业务模块 (国际舱单管理、报文解析、理货管理)
|
||
- 航班管理模块 (航班查询、航班统计)
|
||
- 货物追踪模块 (货物状态追踪、运输日志)
|
||
- 监装监卸模块 (监装监卸管理)
|
||
- PDA功能模块 (PDA专用功能)
|
||
- 蓝牙打印模块 (佳博打印机集成)
|
||
|
||
### 核心架构
|
||
- MVVM 架构模式
|
||
- 组件化模块设计 (11个业务模块 + 1个基础库)
|
||
- DataBinding 双向绑定
|
||
- Kotlin Coroutines + Flow 异步处理
|
||
- ARouter 模块间通信
|
||
- Retrofit + OkHttp 网络请求
|
||
- Glide 图片加载
|
||
- MPAndroidChart 图表展示
|
||
|
||
### 开发基础设施
|
||
- BaseActivity/BaseBindingActivity 基类
|
||
- BaseViewModel/BasePageViewModel 基类
|
||
- CommonAdapter + BaseViewHolder 列表适配
|
||
- PadSearchLayout/PadDataLayout 自定义组件
|
||
- 完整的 Kotlin 扩展函数库
|
||
- DataBinding 适配器集合
|
||
|
||
---
|
||
|
||
## 版本说明
|
||
|
||
### 版本号规则
|
||
- **Major.Minor.Patch** (例: 1.8.4)
|
||
- **Major**: 重大架构变更或不兼容的 API 修改
|
||
- **Minor**: 新功能添加,向下兼容
|
||
- **Patch**: Bug 修复和小的改进
|
||
|
||
### 变更类型
|
||
- **Added**: 新增功能
|
||
- **Changed**: 功能改进或变更
|
||
- **Deprecated**: 即将废弃的功能
|
||
- **Removed**: 已移除的功能
|
||
- **Fixed**: Bug 修复
|
||
- **Security**: 安全性修复
|
||
|
||
---
|
||
|
||
## 未来计划
|
||
|
||
### 待开发功能
|
||
- [ ] 优化数据同步机制
|
||
- [ ] 增强离线模式支持
|
||
- [ ] 改进用户权限管理
|
||
- [ ] 优化蓝牙打印稳定性
|
||
- [ ] 添加数据导出功能
|
||
- [ ] 性能监控和分析
|
||
|
||
### 技术改进
|
||
- [ ] 升级到 Kotlin 2.0
|
||
- [ ] 迁移到 Jetpack Compose
|
||
- [ ] 优化构建速度
|
||
- [ ] 完善单元测试覆盖
|
||
- [ ] 添加 UI 自动化测试
|
||
|
||
---
|
||
|
||
**维护**: 本文档应在每次版本发布时更新。
|
||
**负责人**: 项目维护团队
|
||
**最后更新**: 2026-07-29
|