monsqlize 1.0.5 → 1.0.8

package/CHANGELOG.md

@@ -1,7 +1,7 @@
 # 变更日志 (CHANGELOG)
 
-> **说明**: 版本摘要，详细需求见 [STATUS.md](STATUS.md)  
-> **最后更新**: 2025-12-31
+> **说明**: 版本概览摘要，详细变更见 [changelogs/](./changelogs/) 目录  
+> **最后更新**: 2026-01-17
 
 ---
 
@@ -9,163 +9,160 @@
 
 | 版本 | 日期 | 变更摘要 | 详细 |
 |------|------|---------|------|
+| [v1.0.8](./changelogs/v1.0.8.md) | 2026-01-17 | 🎉 重大功能：多连接池 + Update 聚合管道 + Saga 事务 + Change Stream 同步 | [查看](./changelogs/v1.0.8.md) |
+| [v1.0.7](./changelogs/v1.0.7.md) | 2026-01-09 | 🔧 依赖更新：schema-dsl@1.1.3 修复类型错误消息 + 测试用例 Schema 语法修复 | [查看](./changelogs/v1.0.7.md) |
+| [v1.0.6](./changelogs/v1.0.6.md) | 2026-01-08 | 文档完善：新增 ObjectId 自动转换文档 + 验证所有 v1.3.0+ 功能文档 | [查看](./changelogs/v1.0.6.md) |
+| [v1.0.5](./changelogs/v1.0.5.md) | 2026-01-08 | Schema 验证默认启用 + Model 自动加载机制 + 类型定义完善 | [查看](./changelogs/v1.0.5.md) |
+| [v1.0.4](./changelogs/v1.0.4.md) | 2026-01-07 | 新功能：虚拟字段、默认值 + Bug 修复：嵌套 Populate + 测试改进 | [查看](./changelogs/v1.0.4.md) |
 | [v1.0.3](STATUS.md#v103) | 2025-12-31 | 新增 Model 层（Schema 验证、自定义方法、生命周期钩子、自动时间戳） | [查看](STATUS.md#v103) |
 | [v1.0.2](STATUS.md#v102) | 2025-12-30 | 新增批量操作方法（deleteBatch/updateBatch） | [查看](STATUS.md#v102) |
 | [v1.0.1](STATUS.md#v101) | 2025-12-29 | 稳定版本，生产就绪 | [查看](STATUS.md#v101) |
-| [v1.0.0](STATUS.md#v100) | 2025-12-03 | 正式发布，生产就绪，已发布到 npm | [查看](STATUS.md#v100) |
+| [v1.0.0](./changelogs/v1.0.0.md) | 2025-12-03 | 正式发布，生产就绪，已发布到 npm | [查看](./changelogs/v1.0.0.md) |
 
 ---
 
-## 🆕 v1.0.3 变更详情（2025-12-31）
-
-### 新增功能 ✨
-
-**Model 层** - ORM 式的数据模型功能
-- ✅ **Schema 验证** - 集成 schema-dsl，自动验证数据格式
-- ✅ **自定义方法** - instance 方法注入到文档，static 方法挂载到 Model
-- ✅ **生命周期钩子** - before/after 钩子支持（find/insert/update/delete）
-- ✅ **索引自动创建** - 初始化时自动创建索引
-- ✅ **枚举配置** - 可在 schema 中引用的枚举定义
-- ✅ **自动时间戳** - 自动管理 createdAt/updatedAt，支持自定义字段名
-
-### 核心 API 🔧
-
-```javascript
-// 定义 Model
-Model.define('users', {
-    schema: (dsl) => dsl({ username: 'string!', email: 'email!' }),
-    methods: (model) => ({
-        instance: { checkPassword(pwd) { return this.password === pwd; } },
-        static: { async findByUsername(name) { return await model.findOne({ username: name }); } }
-    }),
-    hooks: (model) => ({
-        insert: { before: async (ctx, docs) => ({ ...docs, createdAt: new Date() }) }
-    }),
-    indexes: [{ key: { username: 1 }, unique: true }]
-});
-
-// 使用 Model
-const User = msq.model('users');
-const user = await User.findByUsername('admin');
-if (user.checkPassword('secret')) console.log('登录成功');
-```
+## 变更统计
 
-### 测试覆盖 ✅
+| 版本系列 | 版本数 | 主要改进方向 |
+|---------|-------|------------|
+| v1.0.x | 9 | 企业级功能、分布式支持、Model 层完善、Schema 验证、依赖更新 |
 
-- 新增 45 个单元测试
-  - Model 基础功能：16个（100%通过）
-  - ModelInstance：23个
-  - Hooks：6个
-- 测试覆盖率：~90%
+---
 
-### 文档完善 📖
+## 里程碑版本
 
-- 新增 `docs/model.md` - 完整 API 文档（495行，精简版）
-- 新增 `docs/model-methods-design.md` - 设计文档（295行）
-- 新增 `examples/model/basic.js` - 基础使用示例
-- 新增 `examples/model/advanced.js` - 高级功能示例
-- 新增 TypeScript 类型定义（+300行）
-- 更新 `README.md`、`docs/INDEX.md`
+### v1.0.8 - 企业级功能升级 🎉
 
-### 设计亮点 💡
+**发布日期**: 2026-01-16  
+**重要性**: ⭐⭐⭐⭐⭐
 
-- ✅ **业界标准** - 参考 Mongoose、Sequelize，降低学习成本
-- ✅ **Schema 缓存** - 编译一次，重复使用，性能优化
-- ✅ **方法注入** - 自动注入到查询结果，使用自然
-- ✅ **TypeScript 支持** - 完整的泛型类型定义
-- ✅ **灵活配置** - 所有选项都可选，渐进式采用
+**核心功能**:
+- ✅ **企业级多连接池管理**: 支持 primary、secondary、analytics、custom 角色
+- ✅ **智能选择策略**: auto、roundRobin、weighted、leastConnections、manual
+- ✅ **健康检查机制**: 自动故障检测和恢复，支持自定义检查间隔和重试次数
+- ✅ **Update 聚合管道**: updateOne/updateMany 支持聚合管道语法
+- ✅ **Saga 分布式事务**: 完整的补偿机制，支持跨服务事务
+
+**质量提升**:
+- 🏆 **测试覆盖率**: 90.77% (从 37.8% 提升，+53%)
+- 🏆 **测试数量**: 400+个测试用例 (增长 4000%)
+- 🏆 **函数覆盖率**: 95.23%
+- 🏆 **核心功能**: 100% 测试覆盖
+- 🏆 **行业领先**: 超过 85% 的开源项目
+
+**重大改进**:
+1. **多连接池架构**:
+   - ConnectionPoolManager: 统一管理多个连接池
+   - HealthChecker: 实时健康监控
+   - PoolSelector: 5种智能选择策略
+   - PoolStats: 完整的统计收集
+
+2. **Update 聚合管道**:
+   - 支持字段间计算 (`$add`、`$multiply`、`$subtract`)
+   - 条件赋值 (`$cond`、`$ifNull`)
+   - 多阶段转换 (`$concat`、`$toLower`、`$toUpper`)
+   - 完全兼容 MongoDB 4.2+ 语法
+
+3. **Saga 分布式事务**:
+   - 自动补偿机制
+   - 事务状态跟踪
+   - 支持超时和重试
+   - 完整的错误处理
+
+**详细信息**: [查看 changelogs/v1.0.8.md](./changelogs/v1.0.8.md)
 
-### 使用场景 🎯
+---
 
-- ✅ 需要数据验证的场景
-- ✅ 需要扩展文档方法的场景
-- ✅ 需要生命周期控制的场景
-- ✅ 需要类 ORM 体验的场景
+### v1.0.7 - 依赖更新与测试修复 🔧
 
----
+**发布日期**: 2026-01-09  
+**重要性**: ⭐⭐⭐
 
-## 🆕 v1.0.2 变更详情（2025-12-30）
+**核心改进**:
+- ✅ 升级 schema-dsl 到 v1.1.3（修复类型错误消息模板变量未替换 bug）
+- ✅ 修复测试用例中错误的 Schema 语法（17处）
+- ✅ 所有测试通过（38/38 测试套件，100%）
+- ✅ 将 schema-dsl 从 devDependencies 移至 dependencies（Model 层运行时依赖）
 
-### 新增功能 ✨
+**详细信息**: [查看 changelogs/v1.0.7.md](./changelogs/v1.0.7.md)
 
-**批量操作方法** - 支持大数据量场景
-- ✅ **deleteBatch** - 批量删除方法
-  - 流式查询，恒定内存占用（12KB）
-  - 支持进度监控（实时百分比）
-  - 4种错误处理策略（stop/skip/collect/retry）
-  - 自动重试机制
-  - 性能：36,385 条/秒（100万条数据实测）
-  
-- ✅ **updateBatch** - 批量更新方法
-  - 流式查询，恒定内存占用（12KB）
-  - 支持进度监控（实时百分比）
-  - 支持所有 MongoDB 更新操作符
-  - 4种错误处理策略 + 自动重试
-  - 性能：35,365 条/秒（100万条数据实测）
+---
 
-### 性能数据 📊
+### v1.0.6 - 文档完善 📚
 
-```
-批量操作性能（100万条数据测试）:
-- insertBatch: 49,493 条/秒
-- deleteBatch: 36,385 条/秒
-- updateBatch: 35,365 条/秒
-- 内存占用: 恒定 12KB
-```
+**发布日期**: 2026-01-08  
+**重要性**: ⭐⭐⭐
 
-### 测试覆盖 ✅
+**核心成就**:
+- ✅ 文档完整性达到 100%
+- ✅ 新增 ObjectId 自动转换完整文档（600行）
+- ✅ 验证所有 v1.3.0+ 功能都有文档
 
-- 新增 31 个单元测试（deleteBatch: 14个，updateBatch: 17个）
-- 性能测试通过（100万条数据）
-- 测试覆盖率 > 90%
+**详细信息**: [查看 changelogs/v1.0.6.md](./changelogs/v1.0.6.md)
+
+---
 
-### 文档完善 📖
+### v1.0.5 - Model 层易用性提升 🚀
 
-- 新增 `docs/deleteBatch.md` - 完整 API 文档（650行）
-- 新增 `docs/updateBatch.md` - 完整 API 文档（600行）
-- 新增 `examples/batch-operations.examples.js` - 8个真实业务场景
-- 更新 `README.md` 和 `docs/INDEX.md`
+**发布日期**: 2026-01-08  
+**重要性**: ⭐⭐⭐⭐
 
-### 技术亮点 💡
+**核心特性**:
+- ✅ Schema 验证默认启用（提升数据质量）
+- ✅ Model 自动加载机制（减少样板代码）
+- ✅ 类型定义完善
 
-- ✅ **完全复用 find 方法** - 0行重复代码，自动获得流式查询、慢查询日志等功能
-- ✅ **架构最简** - 单一流式查询实现，数据一致性有保证
-- ✅ **内存优化** - 流式查询，无论处理多少数据，内存占用恒定 12KB
-- ✅ **错误处理完善** - 4种策略 + 自动重试，适应不同业务场景
+**详细信息**: [查看 changelogs/v1.0.5.md](./changelogs/v1.0.5.md)
 
 ---
 
-## 🆕 v1.0.1 变更详情（2025-12-29）
+### v1.0.4 - 虚拟字段与 Bug 修复 ✨
 
-### 版本说明
+**发布日期**: 2026-01-07  
+**重要性**: ⭐⭐⭐⭐
 
-- 稳定版本，生产就绪
-- 包含完整的 CRUD 功能
-- 多级缓存系统
-- 事务支持
-- 分布式部署支持
-- Change Streams 实时监听
-- 慢查询日志
-- 业务级分布式锁
-- SSH 隧道支持
+**核心特性**:
+- ✅ 虚拟字段（计算属性）
+- ✅ 默认值（插入时自动填充）
+- ✅ 嵌套 Populate Bug 修复
+
+**详细信息**: [查看 changelogs/v1.0.4.md](./changelogs/v1.0.4.md)
 
 ---
 
-## 🆕 v1.0.0 变更详情（2025-12-03）
+### v1.0.0 - 正式发布 🎉
 
-### 版本说明
+**发布日期**: 2025-12-03  
+**重要性**: ⭐⭐⭐⭐⭐
 
-- 正式版发布，生产就绪
-- 企业级质量标准（96/100 A+）
-- 已发布到 npm
+**核心成就**:
+- ✅ 已发布到 npm
+- ✅ 生产就绪
+- ✅ 企业级质量（96/100 A+）
+- ✅ 1000+ 测试用例
+- ✅ 77%+ 测试覆盖率
+
+**详细信息**: [查看 changelogs/v1.0.0.md](./changelogs/v1.0.0.md)
 
 ---
 
-## 变更统计
+## 详细变更文档
 
-| 版本系列 | 版本数 | 主要改进方向 |
-|---------|-------|------------|
-| v1.0.x | 3 | 稳定运行、生产就绪、批量操作优化 |
+> **说明**: 详细变更文档位于 `changelogs/` 目录
+
+```
+changelogs/
+├── README.md          # 变更文档说明
+├── TEMPLATE.md        # 变更文档模板
+├── v1.0.0.md         # v1.0.0 详细变更
+├── v1.0.4.md         # v1.0.4 详细变更
+└── v1.0.5.md         # v1.0.5 详细变更
+```
+
+**注意**: 
+- `changelogs/` 目录包含所有版本的详细变更文档
+- 本文件（CHANGELOG.md）仅提供版本概览和里程碑摘要
+- 需求状态追踪见 [STATUS.md](./STATUS.md)
 
 ---
 
@@ -173,25 +170,22 @@ if (user.checkPassword('secret')) console.log('登录成功');
 
 ### 添加新版本的步骤
 
-1. **创建需求文档**（如需要）
+1. **创建详细变更文档**
    ```bash
-   cp plans/TEMPLATE.md plans/req-your-feature.md
-   # 填充需求详细信息
+   cp changelogs/TEMPLATE.md changelogs/vX.Y.Z.md
+   # 填充详细变更信息
    ```
 
-2. **更新 STATUS.md**
-   - 在"发布计划"表格添加新版本行
-   - 添加版本章节（### vX.Y.Z）
-   - 在版本表格添加需求行
-   - 链接到 plans/ 文档（如有）
-
-3. **更新 CHANGELOG.md**
+2. **更新 CHANGELOG.md**（本文件）
    - 在"版本概览"表格最上方添加新行
-   - 格式：`| [vX.Y.Z](STATUS.md#vxyz) | 日期 | 摘要 | [查看](STATUS.md#vxyz) |`
+   - 格式：`| [vX.Y.Z](./changelogs/vX.Y.Z.md) | 日期 | 摘要 | [查看](./changelogs/vX.Y.Z.md) |`
+
+3. **更新 STATUS.md**（如需要）
+   - 添加版本章节和需求状态
 
 4. **提交变更**
    ```bash
-   git add STATUS.md CHANGELOG.md plans/
+   git add CHANGELOG.md changelogs/vX.Y.Z.md STATUS.md
    git commit -m "docs: 发布 vX.Y.Z"
    ```
 
@@ -210,58 +204,14 @@ if (user.checkPassword('secret')) console.log('登录成功');
 
 ---
 
-## 快速导航
-
-### 当前版本
-
-- **v1.0.1**: [查看详情](STATUS.md#v101)
-- **v1.0.0**: [查看详情](STATUS.md#v100)
-
----
-
-## 里程碑版本
-
-### v1.0.0 - 正式发布 🎉
-
-**发布日期**: 2025-12-03  
-**重要性**: ⭐⭐⭐⭐⭐
-
-**核心成就**:
-- ✅ 已发布到 npm
-- ✅ 生产就绪
-- ✅ 企业级质量（96/100 A+）
-- ✅ 1000+ 测试用例
-- ✅ 77%+ 测试覆盖率
-
-**详细信息**: [查看 STATUS.md](STATUS.md#v100)
-
----
-
-## 详细变更文档
-
-> **说明**: 详细变更文档位于 `changelogs/` 目录
-
-```
-changelogs/
-├── TEMPLATE.md          # 变更文档模板
-└── v1.0.0.md           # v1.0.0 详细变更
-```
-
-**注意**: 
-- changelogs/ 目录包含历史详细变更文档
-- 新版本应优先使用 plans/ 目录存储需求文档
-- STATUS.md 是主要的需求状态追踪文档
-
----
-
 ## 相关文档
 
 - [STATUS.md](./STATUS.md) - 需求状态追踪
-- [plans/](./plans/README.md) - 需求详细文档
+- [changelogs/](./changelogs/README.md) - 详细变更文档目录
 - [README.md](./README.md) - 项目说明
-- [changelogs/](./changelogs/README.md) - 历史详细变更（供参考）
+- [docs/](./docs/INDEX.md) - API 文档
 
 ---
 
-**最后更新**: 2025-12-29
+**最后更新**: 2026-01-08