aiotagro/nxxmdata
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
e64866f2cc810b429657f6e6a09def2ad16c1385
nxxmdata/docs/CHANGELOG.md
ylweng 6b4e0c227f 修改文件结构，统一文档格式
2025-09-02 23:22:10 +08:00

5.9 KiB
Raw Blame History

更新日志

所有项目的重要变更都将记录在此文件中。

本项目遵循 语义化版本 规范。

[未发布]

新增

  • 完善项目文档体系
  • 创建故障排除指南
  • 添加开发指南和API文档

变更

  • 优化项目目录结构
  • 更新README文档

修复

  • 修复经纬度数据同步问题
  • 解决地图组件显示异常

[1.2.0] - 2025-01-18

新增

  • 性能监控系统: 全新的系统性能监控功能
    • 实时监控 CPU、内存、磁盘使用情况
    • 数据库性能监控和慢查询分析
    • API 响应时间统计和错误率监控
    • 可配置的警报阈值系统
  • 虚拟滚动组件: 优化大数据量列表显示性能
  • 图表性能监控: 基于 ECharts 的性能指标可视化
  • 地图缩放演示: 多级缩放功能展示

变更

  • 前端架构升级:
    • Vue 3.4+ 升级，提升响应性能
    • Ant Design Vue 4.0+ 组件库更新
    • Pinia 2.0+ 状态管理重构
  • 后端优化:
    • 数据库连接池优化
    • API 响应时间提升 30%
    • 新增查询优化器

修复

  • 修复百度地图 API 密钥配置问题
  • 解决设备状态更新延迟问题
  • 修复用户权限验证逻辑错误
  • 优化内存泄漏问题

安全

  • 加强 JWT Token 验证机制
  • 更新密码加密算法强度
  • 添加 API 请求频率限制

[1.1.0] - 2024-12-15

新增

  • 农场管理功能:
    • 农场信息 CRUD 操作
    • 地理位置管理和地图展示
    • 农场状态监控
  • 动物健康管理:
    • 动物信息记录和追踪
    • 健康状态监控
    • 检查记录管理
  • 设备监控系统:
    • 设备状态实时监控
    • 设备指标数据收集
    • 设备维护记录
  • 预警管理:
    • 多级别预警系统
    • 预警处理流程
    • 预警统计分析

变更

  • 数据库架构优化，支持更复杂的业务关系
  • API 接口标准化，统一响应格式
  • 前端路由结构重构

修复

  • 修复数据库外键约束问题
  • 解决前端路由跳转异常
  • 优化 API 错误处理机制

[1.0.0] - 2024-11-01

新增

  • 核心系统架构:
    • Node.js + Express 后端服务
    • Vue 3 + Vite 前端框架
    • MySQL 数据库支持
    • Sequelize ORM 集成
  • 用户认证系统:
    • JWT 基础认证
    • 角色权限管理
    • 用户注册和登录
  • 基础 CRUD 功能:
    • 用户管理
    • 产品管理
    • 订单管理
  • 系统基础设施:
    • 日志系统 (Winston)
    • API 文档 (Swagger)
    • 数据库迁移和种子数据
    • 环境配置管理

技术栈

  • 后端: Node.js 18+, Express 4.18+, Sequelize 6.30+
  • 前端: Vue 3.4+, Ant Design Vue 4.0+, Vite 5.0+
  • 数据库: MySQL 8.0+
  • 工具: ESLint, Prettier, PM2

版本命名规范

我们采用语义化版本控制 (SemVer) 格式：主版本号.次版本号.修订号

  • 主版本号: 不兼容的 API 修改
  • 次版本号: 向下兼容的功能性新增
  • 修订号: 向下兼容的问题修正

变更类型说明

  • 新增 - 新增功能
  • 变更 - 对现有功能的变更
  • 废弃 - 即将移除的功能
  • 移除 - 已移除的功能
  • 修复 - 问题修复
  • 安全 - 安全相关的修复

升级指南

从 1.1.0 升级到 1.2.0

数据库更新

-- 添加性能监控相关表
-- 运行迁移脚本
npm run db:migrate

配置更新

# 添加新的环境变量
ENABLE_PERFORMANCE_MONITORING=true
PERFORMANCE_LOG_LEVEL=info

依赖更新

# 更新前端依赖
cd admin-system/frontend
npm update vue@^3.4.0
npm update ant-design-vue@^4.0.0

# 更新后端依赖
cd ../../backend
npm update

从 1.0.0 升级到 1.1.0

数据库迁移

-- 添加农场管理相关表
CREATE TABLE farms (...);
CREATE TABLE animals (...);
CREATE TABLE devices (...);
CREATE TABLE alerts (...);

配置变更

# 添加百度地图 API 配置
BAIDU_MAP_API_KEY=your_api_key_here

已知问题

v1.2.0

  • 性能监控在高并发情况下可能影响系统性能
  • 某些旧版本浏览器可能不支持新的前端特性

v1.1.0

  • 百度地图在某些网络环境下加载较慢
  • 大数据量查询时可能出现超时

v1.0.0

  • 初始版本，功能相对基础
  • 部分边界情况处理不够完善

兼容性支持

浏览器支持

  • Chrome 90+
  • Firefox 88+
  • Safari 14+
  • Edge 90+

Node.js 版本支持

  • Node.js 18.x (推荐)
  • Node.js 16.x (最低要求)

数据库版本支持

  • MySQL 8.0+ (推荐)
  • MySQL 5.7+ (最低要求)

贡献指南

我们欢迎社区贡献！请查看 CONTRIBUTING.md 了解如何参与项目开发。

报告问题

如果您发现问题，请在 GitHub Issues 中创建新的问题报告，并包含：

  • 问题描述
  • 复现步骤
  • 预期行为
  • 实际行为
  • 环境信息

提交代码

  1. Fork 项目仓库
  2. 创建功能分支 (git checkout -b feature/amazing-feature)
  3. 提交变更 (git commit -m 'Add some amazing feature')
  4. 推送到分支 (git push origin feature/amazing-feature)
  5. 创建 Pull Request

技术路线图

v1.3.0 (计划中)

  • 微服务架构重构
  • 实时数据推送 (WebSocket)
  • 移动端适配优化
  • 多语言支持

v1.4.0 (规划中)

  • 人工智能预警系统
  • 大数据分析平台
  • 第三方系统集成
  • 高可用架构升级

v2.0.0 (远期规划)

  • 云原生架构
  • 容器化部署
  • 多租户支持
  • 国际化部署

致谢

感谢所有为项目做出贡献的开发者和用户！

主要贡献者

  • 项目架构设计团队
  • 前端开发团队
  • 后端开发团队
  • 测试团队
  • 文档团队

特别感谢

  • 宁夏农业部门的需求指导
  • 养殖户的实际使用反馈
  • 技术社区的开源支持

如需查看完整的提交历史，请访问项目的 Git 日志: git log --oneline

最后更新: 2025年1月