junny_dev_kit 0.13.5-dev

junny_dev_kit: ^0.13.5-dev copied to clipboard

🐛 Bug修复 #

• 🔧 修复FormControlMixin子表禁用逻辑缺陷 • 修复 isSubtableDisabled 方法缺少页面类型判断的问题 • 确保普通编辑页面（add/modify）正确调用 _isEditDisabled 逻辑 • 确保流程页面正确调用 _isWorkflowDisabled 逻辑 • 统一返回值类型为 bool，保持API一致性 • 解决普通编辑页面子表禁用状态判断错误的问题

🐛 Bug修复 #

• 🔧 修复组织机构树页面用户数据字段映射问题 • 修复用户数据的 id 和 userId 字段双向赋值逻辑 • 确保无论数据源格式如何都能正确处理用户数据 • 避免因缺少 userId 字段导致的数据处理错误

🏗️ 架构重构 #

• ♻️ 列表Mixin架构重构，支持分页和非分页两种模式 • 重构 ListPageMixin，保持原有分页功能完全不变 • 新增 ListDataMixin，支持非分页全量数据获取 • 重命名 list_page_mixin.dart 为 list_mixin.dart 统一管理 • 抽取通用的删除逻辑，实现代码复用

✨ 新功能 #

• 🚀 非分页列表支持 • 新增 ListDataMixin 支持一次性获取所有数据 • 适用于数据量较小的简单列表场景 • 支持客户端筛选和排序 • 只支持下拉刷新，不支持上拉加载

📚 文档更新 #

• 📖 完善详细的文档注释和使用示例 • 为 ListPageMixin 和 ListDataMixin 添加完整的类级别文档 • 每个公开方法都有详细的参数说明和返回值描述 • 提供丰富的代码使用示例 • 新增 docs/list_mixins_guide.md 详细使用指南 • 创建 lib/src/examples/list_mixins_example.dart 完整示例代码

🔧 开发体验优化 #

• 💡 智能提示增强 • 通过详细的文档注释，IDE 可以提供更好的智能提示 • 清晰的方法分类：必须实现 vs 可选重写 • 统一的文档格式和 emoji 图标，提升可读性

🏗️ 架构重构 #

• ♻️ Tree组件迁移修复和优化 • 完成组织机构页面的Tree组件重构迁移 • 将 JunnyTreeNode<T> 迁移到 TreeViewNode<T> • 更新数据访问方式：node.data → node.content • 适配新的TreeController API：findNodes → searchNodes

✨ 新功能 #

• 🚀 Tree组件性能优化 • 配置JunnyTreeController的titleProvider和childrenProvider • 实现智能筛选策略：单字段用searchNodes，多字段用filterNodes • 支持多字段筛选：组织名称、组织代码、组织层级 • 提供不同匹配策略：模糊匹配和精确匹配

🐛 Bug 修复 #

• 🔧 修复Tree组件类型错误 • 解决 JunnyTreeNode 未定义的编译错误 • 修复 findNodes 方法不存在的问题 • 清理未使用的筛选条件检查方法

📚 文档更新 #

• 📖 完善Tree组件迁移指南 • 更新迁移步骤和注意事项 • 添加性能优化建议 • 提供完整的代码示例

🏗️ 架构重构 #

• ♻️ 重构操作 Mixin 架构，提升代码复用性和可维护性 • 拆分 FlowOperationMixin 为 ListOperationMixin 和 FlowOperationMixin • ListOperationMixin 提供基础操作功能（查看、编辑、删除） • FlowOperationMixin 继承基础功能并添加流程特性（启动流程、流程监控） • 解决方法签名冲突问题，支持同时混入两个 mixin

✨ 新功能 #

• ✨ 新增细粒度按钮构建方法 • buildInfoButton() - 构建查看详情按钮 • buildEditButton() - 构建编辑按钮 • buildDeleteButton() - 构建删除按钮 • 支持自定义按钮顺序和灵活组合
• ✨ 优化统计功能 • 添加 analyticsSource 参数，支持区分不同模块的按钮点击统计 • 基础操作统计来源：list_operation • 流程操作统计来源：flow_operation

🐛 Bug 修复 #

• 🔧 修复 title 参数类型问题 • createActionButton 方法的 title 参数改为可空 String? • 内部自动处理空值，避免类型错误
• 🔧 解决 mixin 方法签名冲突 • 通过参数化设计避免方法重写导致的签名不一致问题 • 保持 on 语法的继承约束，确保正确的依赖关系

🗑️ 代码清理 #

• 🧹 移除冗余代码和无用抽象 • 删除 processFlowData 方法和 ProcessData 类 • 简化数据处理逻辑，直接使用原始数据 • 更新文档，移除过时的示例代码

📝 文档优化 #

• 📝 完善 Mixin 使用文档 • 更新 README.md，提供详细的使用示例 • 添加细粒度方法的使用指南 • 更新最佳实践和注意事项

🐛 Bug 修复 #

• 🔧 修复组织机构树页面Controller dispose遗漏问题 • 确保 treeController.dispose() 在页面销毁时正确调用 • 防止内存泄漏和资源未释放问题 • 完善资源管理生命周期

📦 依赖更新 #

• 🔧 更新调试工具依赖版本 • ispect: ^4.1.9 → ^4.2.0 • ispectify_dio: ^4.1.9 → ^4.2.0

🛠️ 开发工具优化 #

• 🔧 配置Git忽略寸止记忆系统元数据文件 • 添加 .cunzhi-memory/metadata.json 到 .gitignore • 从Git跟踪中移除元数据文件，避免时间戳变更导致的无意义提交 • 保留 .md 记忆内容文件的版本控制

🏗️ 架构重构（Breaking Changes） #

• ♻️ TreeView组件架构全面重构 • 从 flutter_fancy_tree_view 迁移到 junny_widget 的 JunnyTreeView 组件 • 移除 two_dimensional_scrollables 依赖，简化依赖结构 • 升级 junny_widget 从 v0.2.7+1 到 v0.3.0，获得更好的性能和功能 • 重构树形控制器架构，提供完全解耦的筛选能力

✨ 新功能 #

• 🔧 组织机构树Logic类重构优化 • 重构数据转换和权限检查逻辑，提升处理效率 • 优化筛选功能架构，支持内部数据筛选和外部数据筛选 • 简化代码结构，抽取公共逻辑，提升可维护性 • 改进节点选择和权限控制机制
• ✨ 完全解耦的筛选架构设计 • TreeView保持简洁，不添加筛选参数 • 通过扩展JunnyTreeController实现筛选功能 • 支持findNodes、refreshWithFilteredData、resetToOriginalData等核心API • 筛选组件直接操作Controller，实现高度解耦

🗑️ 代码清理 #

• 🧹 清理冗余文件和代码 • 删除 tree_extension.dart 冗余扩展文件 • 移除 README_FILTER.md 和 custom_selectability_examples.dart • 清理 widgets.dart 中未使用的导出 • 重命名和整理示例文件，提升代码组织结构

📦 依赖更新 #

• 🔧 核心依赖包版本升级 • dart_aliyun_oss: ^1.1.0 → ^1.2.0 • flutter_svg: ^2.1.0 → ^2.2.0 • ispect: ^4.1.7 → ^4.1.9 • ispectify_dio: ^4.1.7 → ^4.1.9 • junny_widget: ^0.2.7+1 → ^0.3.0
• 🛠️ 开发工具依赖更新 • build_runner: ^2.4.15 → ^2.5.3 • flutter_lints: ^5.0.0 → ^6.0.0

📝 文档和规范 #

• 📝 完善组织机构树文档 • 新增详细的README.md文档，包含功能特性和使用示例 • 更新筛选功能使用指南和最佳实践 • 完善节点可选性判断器示例代码
• 📝 优化代码文档注释 • 改进函数和类的文档注释格式 • 添加详细的参数说明和使用示例 • 统一代码注释风格和规范

✨ 新功能 #

• 🎉 新增Analytics日志统计工具系统 • 完整的事件统计和追踪系统，支持应用生命周期、用户行为、网络请求等多维度统计 • 多格式数据导出功能（JSON/CSV/报告），支持批量上报和异步处理 • 网络请求自动统计拦截器，集成ISpect Console和日志分类 • 性能监控和用户行为分析，支持数据库操作、业务功能、异常错误统计 • 动态配置管理和测试工具，模块化架构设计
• ✨ 附件页面全面重构与优化 • 新增fileName的originalName fallback支持，兼容新版接口 • 重构代码架构，抽取AttachmentListItem、FilePreviewWidget、AttachmentEmptyState组件 • 优化downloadSingleFile方法，返回修改后的item并自动刷新 • 统一OSS处理逻辑，消除重复代码，提升可维护性 • 优化文件名显示，去掉后缀显示更简洁美观

🐛 Bug 修复 #

• 🔧 修复附件页面代码冗余和架构问题 • 消除重复的OSS处理逻辑，统一使用getDownloadInfo方法 • 优化方法职责分离，UI逻辑与业务逻辑清晰分离 • 修复类型安全问题，移除dynamic类型使用 • 清理注释代码和不必要的导入

📝 文档和规范 #

• 📝 调整文档目录结构，优化项目文档组织 • 完善Analytics系统完整文档，包含API参考、最佳实践、部署检查清单 • 新增性能指南、安全指南、故障排除等专业文档 • 提供丰富的使用示例和集成指南
• 📝 完善附件系统代码文档 • 添加详细的方法文档和分组注释 • 优化组件设计文档和使用示例

🏗️ 架构重构（Breaking Changes） #

• ♻️ 重构数据库模型和配置系统 • 重新组织数据库文件结构，将模型文件移动到 models/ 目录，生成文件移动到 generated/ 目录 • 优化配置系统，添加 base_repository_config.dart 和 repository_config_v3.dart • 完善配置文档 README.md，更新项目结构
• ✨ 翻译系统重构与多模块优化 • 重构本地化系统架构，提升多模块支持能力 • 优化翻译数据库管理和性能监控 • 改进翻译缓存机制和错误处理

✨ 新功能 #

• ✨ 新增组织机构树筛选功能 • 支持接口筛选和本地筛选的自动回退机制 • 支持自定义筛选组件和筛选条件 • 提供完整的筛选参数格式和使用文档
• ✨ 新增组织机构节点可选性判断器 • 提供多种预定义判断实现适配不同项目需求 • 支持自定义组合判断器和权限数据提取
• ✨ 数据库初始化优化与翻译日志精简 • 改进数据库连接管理和异步处理 • 优化翻译系统日志记录机制 • 增强数据库性能监控功能
• ✨ 新增流程操作 Mixin • 提供可复用的流程状态管理和操作按钮逻辑 • 支持权限控制和数据处理的统一封装

🐛 Bug 修复 #

• 🔧 修复应用重启后数据库连接丢失问题 • 改进数据库连接管理机制 • 增强连接状态检测和自动重连功能
• 🐛 修复数据库初始化中的 Isolate 传递问题 • 解决多线程环境下的数据库初始化异常 • 优化 Isolate 间的数据传递机制
• 🐛 修复资源上传对话框代码规范问题 • 优化函数文档注释格式和内容 • 改进代码结构和可读性，统一错误处理
• 🐛 修复文件选择字段命名不一致问题 • 统一文件选择相关字段的命名规范 • 更新相关依赖库版本

📝 文档和工具 #

• 📝 新增详细的功能文档和使用示例 • 组织机构筛选功能使用指南 • 自定义可选性判断器示例代码 • Mixin 使用指南和最佳实践
• 📝 完善配置系统文档 • 更新配置系统架构说明 • 添加迁移指南和兼容性说明

📦 依赖更新 #

• 🔧 更新相关配置文件和页面逻辑
• 📦 更新多个依赖库版本以提升稳定性和性能

• 优化图片加载机制，添加 EnhancedImageLoader 类，提高图片加载成功率
• 增强网络请求容错性，支持带/不带请求头的自动降级请求
• 改进图片预览页面，提升用户体验和性能
• 支持TIF格式图片自动转换为PNG格式显示
• 更新依赖版本： • dart_aliyun_oss: ^1.0.2 → ^1.0.4 • file_picker: ^10.1.2 → ^10.1.9 • junny_utils: ^0.0.9 → ^0.0.10 • webview_flutter: ^4.11.0 → ^4.12.0 • background_downloader: ^9.2.1 → ^9.2.2

• 重构 DioUtils 类，提高代码可维护性和可读性
• 添加 JunnyRequestOptions 类，优化请求参数管理
• 实现智能 contentType 设置逻辑，根据请求数据类型自动选择合适的内容类型
• 优化请求头设置，添加默认 Accept 头
• 更新依赖版本：background_downloader、provider

• 重命名 JunnyOssConfig 为 JunnyOSSConfig，保持命名一致性
• 将 OSS 签名 URL 的默认过期时间从 1 小时延长到 3 小时
• 移除未使用的 download_type.dart 文件
• 修复 dio_utils.dart 中的 contentType 默认值设置

• 重构文件存储访问系统，支持多种访问方式（ID、OSS、Server）
• 添加阿里云OSS集成，支持OSS文件的上传和下载
• 优化图片预览功能，支持自定义HTTP请求头
• 添加OSS文件信息获取功能，包括签名URL和headers
• 改进文件下载机制，支持在不同访问方式之间回退
• 优化文件预览体验，提高安全性和可靠性

• 升级dio image依赖库
• dio``GET请求时移除所有为null的参数

• 降级hive到v2.2.3以解决v4版本数据库初始化因同步加载过大数据时导致的ui卡顿问题

• 为App添加全局provider提供方式
• 调整JunnyStorageConfig，去掉ossBucketName/ossAccessKeyId/ossAccessKeySecret ，云存储的路径统一由fileOssUri获取
• 暴露time_range_field.dart
• 暴露party_b_field.dart

• 修复EditMixin tabs数量对应不上的异常

• 修改Hive为v4版本
• 修改user info数据库存储获取方式

• 修改文件预览和下载公共方法

• 修改hive_utils为database_utils

• 修改route_config方法定义，可以返回null

• 修改repo_config方法定义

• 添加mixins

• First release.