junny_dev_kit 1.1.1+1

junny_dev_kit: ^1.1.1+1 copied to clipboard

🔧 文件下载优化与依赖更新 #

🏗️ 文件下载功能优化

• ♻️ OSS 文件下载请求头优化 • 修改 FileDataExtension.downloadSingleFile() 方法的请求头配置 • 将 Content-Type: application/octet-stream 改为 Accept: application/octet-stream • 添加 Cache-Control: no-cache 禁用缓存，确保获取最新文件 • 为 OSS 签名请求添加 dateTime: DateTime.now().toUtc() 参数 • 提升文件下载的可靠性和时效性

📦 依赖更新

• ⬆️ mailer 依赖升级 • 将 mailer 从 6.4.1 升级到 6.5.0 • 获得最新的邮件发送功能和安全性改进

---

🔧 数据库清理架构优化 #

✨ 新增功能

• 🆕 LocaleDBUtils 工具类 • 新增独立的语种数据库操作工具类 • 提供完整的语种数据 CRUD 操作 • 支持语种代码查询和存在性检查

🏗️ 架构重构

• ♻️ 数据库清理逻辑重构 • 修复 clearCacheAndToLogin() 方法逻辑漏洞 • 解决清理用户缓存时意外清除 account 数据库的问题 • 实现精确的按类型清理逻辑，避免重复清理

• 🔄 DatabaseUtils 架构优化 • 将 getUserMenu() 和 setSubSystemMenu() 业务逻辑迁移到 MenuDBUtils • DatabaseUtils 改为纯粹的中间层委托，不包含具体业务实现 • 提升代码架构的一致性和可维护性

📏 命名规范统一

• 🎯 清理方法命名标准化 • 单一数据类型工具类统一使用 clear() 方法 • InitStatusDBUtils、LocaleDBUtils、DictDBUtils、AccountDBUtils、UserInfoDBUtils • 多种数据类型工具类保留具体命名（如 MenuDBUtils 的 clearUserMenus 等） • 提升 API 设计一致性和简洁性

🐛 问题修复

• 🔧 缓存清理逻辑修复 • 修复 BusinessUtils._clearDatabaseCache() 中的重复清理问题 • 采用互斥清理策略：精确清理 vs 批量清理 • 优化 DatabaseUtils 批量清理方法，统一调用专业工具类

🚀 性能优化

• ⚡ 清理操作优化 • 使用并行清理提升性能（Future.wait） • 避免不必要的重复数据库操作 • 优化翻译数据库的复杂清理流程

---

🎉 重大功能发布 - 通用菜单系统与地址数据库架构升级 #

✨ 新增功能 #

• 🆕 通用菜单模块 - 完全配置化的工作台和子系统菜单组件 • 新增 UniversalMenuWidget 通用菜单组件 • 新增 UniversalWorkbenchPage 工作台页面组件 • 新增 UniversalSubSystemPage 子系统页面组件 • 支持完全配置化的字段映射和显示控制

🏗️ 架构重构 #

• ♻️ 地址数据库架构重构：从JSON文件迁移到预置ObjectBox数据库 • 删除 assets/others/address.json，新增预置数据库文件 • 实现独立的地址数据库管理系统 AddressDBUtils • 支持预置数据库文件的自动复制和初始化机制 • 提供完整的地址查询API（按ID、父级ID、层级、地名搜索等）

🔧 配置系统 #

• 📋 菜单配置系统 • MenuFieldConfig: 自定义数据字段名映射 • MenuDisplayConfig: 控制布局样式和显示策略 • MenuRouteConfig: 管理导航行为 • MenuIconProvider: 自定义图标映射逻辑 • 新增配置组类简化参数传递

🗃️ 数据处理优化 #

• 📊 菜单数据处理器 • MenuDataSource: 抽象数据源接口 • UniversalMenuProcessor: 菜单数据处理器 • WorkbenchDataProcessor: 工作台数据处理器 • MultiLevelMenuProcessor: 多层级菜单处理器 • 支持多层级菜单结构和权限验证

• 📊 JunnyAddress模型结构简化 • 字段名统一：parentBusinessId → parentId • 移除不必要的索引注解和Relations注释代码 • 简化模型结构，提升查询性能

🎨 UI组件 #

• 🖼️ 统一菜单UI组件 • UnifiedMenuCard: 统一菜单卡片组件 • MenuTabView: 分组标签视图 • MenuDataLoader: 菜单数据加载器 • MenuDataService: 菜单数据服务 • 支持工作台和子系统两种显示模式

🔌 提供者接口 #

• 🔗 菜单服务提供者 • MenuStorageProvider: 菜单存储提供者 • MenuTranslationProvider: 菜单翻译提供者 • 支持缓存机制和国际化

🗑️ 废弃标记 #

• ⚠️ 标记setAddresses方法为废弃 • 预置地址数据库为只读，不支持写入操作 • 提供迁移指南，建议使用独立的用户地址数据库

🔧 代码优化 #

• 🧹 DatabaseUtils架构调整 • 移除地址相关的直接管理，委托给AddressDBUtils • 删除setAddressesJson方法，简化初始化流程 • 新增initAddressData委托方法

• 💻 翻译模型优化 • 简化 JunnyLocale 模型结构 • 移除冗余的 localDbId 字段 • 使用 assignable ID 优化数据库存储

• 🧹 菜单数据库工具优化 • 简化 MenuDBUtils.setSubsystemMenusFromObjects 方法签名 • 移除重复的方法实现，统一菜单对象存储逻辑 • 优化异常处理，使用 rethrow 保持错误堆栈

📦 资源配置更新 #

• 🔧 pubspec.yaml资源路径调整 • 从 assets/others/ 更新为 assets/address_db/ • 自动生成文件同步更新（ObjectBox模型、Assets生成代码）

📚 文档完善 #

• 📖 新增详细的菜单模块文档 • 新增详细的 README 文档和使用指南 • 包含完整的API参考和最佳实践 • 更新实际API参数和配置示例

� 架构优化 #

• ♻️ 用户信息监听系统重构：从ValueNotifier迁移到ObjectBox Stream响应式方案 • 新增 userInfoStream 方法，基于 ObjectBox 原生响应式查询 • 使用 box.query().watch(triggerImmediately: true) 实现自动监听 • 自动解析 JSON 数据并提供 broadcast stream 支持

🗑️ 代码清理 #

• 🧹 移除废弃的ValueNotifier相关代码 • 删除 getUserInfoNotifier、_notifyUserInfoChanged、disposeAllNotifiers 方法 • 移除手动通知逻辑和 ValueNotifier 相关代码 • 清理不再需要的 import 依赖

🔧 使用方更新 #

• 💻 更新相关组件使用新的Stream API • DatabaseUtils 新增 userInfoStream 方法 • 更新 junnysoft_app.dart 水印监听使用 StreamBuilder • 更新 business_utils.dart 移除手动清理逻辑 • 更新示例文件使用 StreamBuilder 替代 ValueListenableBuilder

⚡ 性能优化 #

• 🚀 基于ObjectBox原生响应式查询的性能提升 • 基于 ObjectBox 原生响应式查询，性能更优 • 无需手动通知和清理，减少内存泄漏风险 • 与 ObjectBox 官方推荐的数据观察者模式保持一致 • 代码更简洁，维护成本更低

📦 依赖更新 #

• 🔧 新增依赖包 • 新增 flat_buffers: ^23.5.26 依赖，支持高性能序列化 • 优化 .pubignore 配置，改进包发布流程

🎉 重大版本发布 - 数据库架构全面升级 #

🏗️ 架构重构 #

• ♻️ 数据库引擎完全迁移：从 Isar 4.0.0-dev.14 迁移到 ObjectBox • 完全替换底层数据库引擎，提升性能和稳定性 • 保持所有业务API完全兼容，零业务代码变更 • 支持更高效的数据存储和查询操作 • 优化内存使用和磁盘空间占用

🗃️ 数据模型重构 #

• 📊 核心数据模型全面升级 • JunnyAccount - 用户账户信息模型 • JunnyAddress - 地址信息模型 • JunnyDict - 字典数据模型 • JunnyInitStatus - 初始化状态模型 • JunnyLocale - 本地化配置模型 • JunnyQuickMenu - 快捷菜单模型 • JunnySubsystemMenu - 子系统菜单模型 • JunnyUserInfo - 用户信息模型 • JunnyUserMenu - 用户菜单模型 • JunnyLanguage - 翻译语言模型 • JunnyLanguageLog - 翻译日志模型

🔧 数据库工具类重构 #

• 🛠️ 专业化数据库操作工具 • AccountDBUtils - 账户数据操作工具 • AddressDBUtils - 地址数据操作工具 • DictDBUtils - 字典数据操作工具 • InitStatusDBUtils - 初始化状态操作工具 • MenuDBUtils - 菜单数据操作工具 • UserInfoDBUtils - 用户信息操作工具 • DatabaseCleanupManager - 数据库清理管理器 • 移除 DbAsyncManager，优化异步操作架构

🚀 性能优化 #

• ⚡ 用户信息变更监听优化 • 使用 ValueNotifier 替代 Stream 实现 • 降低内存占用，提升响应速度 • 支持智能更新判断，避免不必要的通知 • 新增 getAllUserInfo 方法支持批量数据获取

🌐 翻译系统优化 #

• 🔄 翻译缓存架构升级 • 新增 QueryCache 查询缓存层 • 优化翻译数据库连接管理 • 改进翻译数据持久化机制 • 支持翻译数据库重连和故障恢复

🧹 代码清理 #

• 🗑️ 移除过时文件和依赖 • 删除所有 Isar 相关生成文件 (*.g.dart) • 移除数据库相关文档文件 • 清理过时的配置和工具类 • 优化项目结构和依赖关系

📦 依赖更新 #

• 📋 核心依赖升级 • 移除 isar 和 isar_flutter_libs 依赖 • 新增 objectbox 和 objectbox_flutter_libs 依赖 • 更新相关开发工具依赖 • 优化构建配置文件

🔒 稳定性提升 #

• 🛡️ 数据安全和一致性保障 • 完善数据库操作异常处理机制 • 支持数据库连接故障自动恢复 • 优化并发操作安全性 • 提供完整的数据迁移和回滚支持

📝 开发体验 #

• 💻 开发工具和示例完善 • 新增 UserInfoListenerExample 用户信息监听示例 • 完善数据库操作文档和注释 • 优化代码生成和构建流程 • 提供详细的迁移指南和最佳实践

---

🐛 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.