2025 年 9 月
- 核心框架全面升级：应用从 Rails 7.0.8 升至 7.1.5（同步启用 Action Cable）、部署 Ruby 3.2.8，并将 Shakapacker 依次提升至 8.4.0，配套更新 Bundler、Rack Session 等基础依赖。
- 运行环境优化：Puma 升级至 6.6.0，Capistrano 配置同步调整，新引入 benchmark 兼容 Ruby 3.5，tzinfo-data 平台声明更新以修复 Windows/CI运行。
- 依赖治理强化：固定 net-http、net-imap、zeitwerk、selenium-webdriver、nokogiri 等关键 Gem 版本，引入 RorVsWild 监控、移除 Honeybadger，并通过 WeChat SDK 切换至 httpx 与若干 npm 包（cookie、mime-db 等）锁定策略降低风险。
- 数据层扩展：数据库结构刷新新增 analytic_materials 与 inventory_* 系列表、sample_borrows 借阅记录，并调整多处字段类型与注释，为材料库存、样品借阅和统计分析提供支撑。
- 业务与界面细节：材料视图和导航增加空值保护及链路补充，首页新增“切换到室内材料库”入口，确保 UI 交互在数据缺失场景下更健壮。
- 持续交付稳定性：多次回调 concurrent-ruby、css-what、rdoc、securerandom 等版本，精简自定义 bin/rails hack，完善 tzinfo-data 与 Gem 平台声明，使 CI/CD 流水线恢复绿色。
- 前后端构建：多轮 Yarn/Gem 综合升级伴随 Shakapacker 更新（8.1→8.4），并对 cookie 解析、mime-db、浏览器兼容数据库等前端工具链实施精细化锁定。
- 开发协作规范：新增 AGENTS.md 仓库指南及 .cursor 规则集，统一项目结构、API/Jbuilder 约定、Stimulus 前端规范与路由鉴权策略，提升协作一致性。