monsqlize 1.0.8 → 1.1.0

package/CHANGELOG.md

@@ -1,7 +1,7 @@
 # 变更日志 (CHANGELOG)
 
 > **说明**: 版本概览摘要，详细变更见 [changelogs/](./changelogs/) 目录  
-> **最后更新**: 2026-01-17
+> **最后更新**: 2026-01-21
 
 ---
 
@@ -9,6 +9,8 @@
 
 | 版本 | 日期 | 变更摘要 | 详细 |
 |------|------|---------|------|
+| [v1.1.0](./changelogs/v1.1.0.md) | 2026-01-21 | 🎉 重大更新：新增49个操作符，实现100% MongoDB操作符支持（122/122）| [查看](./changelogs/v1.1.0.md) |
+| [v1.0.9](./changelogs/v1.0.9.md) | 2026-01-19 | 🎉 重大功能：统一表达式系统 - 67个操作符 + 107个测试 (100%通过) | [查看](./changelogs/v1.0.9.md) |
 | [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) |
@@ -25,12 +27,36 @@
 
 | 版本系列 | 版本数 | 主要改进方向 |
 |---------|-------|------------|
-| v1.0.x | 9 | 企业级功能、分布式支持、Model 层完善、Schema 验证、依赖更新 |
+| v1.0.x | 10 | 企业级功能、分布式支持、Model 层完善、Schema 验证、**统一表达式系统** 🆕 |
 
 ---
 
 ## 里程碑版本
 
+### v1.0.9 - 统一表达式系统 🎉
+
+**发布日期**: 2026-01-19  
+**重要性**: ⭐⭐⭐⭐⭐
+
+**核心功能**:
+- ✅ **67个统一表达式操作符**: 完整实现阶段1 (43个) + 阶段2 (24个)
+- ✅ **上下文感知编译**: 自动检测 $match/$project/$group 上下文
+- ✅ **递归函数调用**: 支持任意深度的函数嵌套
+- ✅ **Lambda表达式**: FILTER/MAP 完整支持
+- ✅ **高性能缓存**: LRU缓存，>90%命中率
+- ✅ **100%向后兼容**: 无破坏性变更
+
+**测试覆盖**:
+- 🏆 **测试数量**: 107个测试用例 (新增19个边界测试)
+- 🏆 **通过率**: 100% (107/107通过)
+- 🏆 **边界覆盖**: 95%+ 边界情况覆盖
+- 🏆 **质量评级**: A+ (98.8%完成度)
+
+**文档更新**:
+- 📚 **聚合文档更新**: aggregate.md 新增统一表达式章节
+- 📚 **完整实施报告**: 15+份详细报告
+- 📚 **质量分析**: 全面质量检查和验证
+
 ### v1.0.8 - 企业级功能升级 🎉
 
 **发布日期**: 2026-01-16  

package/README.md

@@ -20,7 +20,7 @@
 npm install monsqlize
 ```
 
-[快速开始](#-快速开始) · [项目愿景](#-项目愿景) · [核心特性](#-核心特性) · [完整文档](./docs/INDEX.md)
+[快速开始](#-快速开始) · [项目愿景](#-项目愿景) · [核心特性](#-核心特性) · [完整文档](./docs/INDEX.md) · [错误码参考](./docs/error-codes.md)
 
 </div>
 
@@ -34,6 +34,7 @@ npm install monsqlize
 - [🎯 何时使用 monSQLize？](#-何时使用-monsqlize)
 - [🚀 快速开始](#-快速开始)
 - [🌟 核心特性](#-核心特性)
+  - [0. 🎯 统一表达式系统 🆕](#0--统一表达式系统--v109---让聚合查询像sql一样简单)
   - [1. ⚡ 智能缓存系统](#1--智能缓存系统---性能提升-10100-倍)
   - [2. 🏢 企业级特性](#2--企业级特性)
   - [3. 📦 便利方法](#3--便利方法---减少-6080-代码)
@@ -464,6 +465,119 @@ const user = await users.findOne({ email: 'test@example.com' });
 
 ## 🌟 核心特性
 
+### 0. 🎯 统一表达式系统 🆕 v1.1.0 - 让聚合查询像SQL一样简单
+
+**122个操作符（100% MongoDB支持！新增49个函数）**，让MongoDB聚合查询**像写SQL一样简单**！
+
+<table>
+<tr>
+<td width="50%">
+
+**🆕 统一表达式语法**
+
+```javascript
+const { expr } = require('monsqlize');
+
+// ❌ MongoDB原生（繁琐）
+await users.aggregate([
+  {
+    $project: {
+      fullName: {
+        $concat: ['$firstName', ' ', '$lastName']
+      },
+      age: {
+        $subtract: [
+          { $year: new Date() },
+          { $year: '$birthDate' }
+        ]
+      }
+    }
+  }
+]);
+
+// ✅ 统一表达式（简洁）
+await users.aggregate([
+  {
+    $project: {
+      fullName: expr("CONCAT(firstName, ' ', lastName)"),
+      age: expr("YEAR(CURRENT_DATE) - YEAR(birthDate)")
+    }
+  }
+]);
+```
+
+</td>
+<td width="50%">
+
+**核心优势**
+
+- ✅ **67个操作符** - 覆盖95%使用场景
+- ✅ **类SQL语法** - 易读易写，降低学习成本
+- ✅ **上下文感知** - 自动适配$match/$project/$group
+- ✅ **Lambda表达式** - FILTER/MAP完整支持
+- ✅ **高性能** - LRU缓存，>90%命中率
+- ✅ **100%兼容** - 可与原生语法混用
+
+**支持的操作符分类**:
+- 🔹 条件判断 (三元、SWITCH)
+- 🔹 数学计算 (ABS、ROUND、POW等)
+- 🔹 字符串处理 (CONCAT、SPLIT、REPLACE等)
+- 🔹 数组操作 (FILTER、MAP、SIZE等)
+- 🔹 日期处理 (YEAR、MONTH、DAY等)
+- 🔹 类型转换 (TO_INT、TO_STRING等)
+
+</td>
+</tr>
+</table>
+
+**更多示例**：
+
+```javascript
+// 条件判断 - 三元运算符
+expr("score >= 90 ? 'A' : 'B'")
+
+// 多分支条件 - SWITCH
+expr("SWITCH(score >= 90, 'A', score >= 80, 'B', score >= 60, 'C', 'F')")
+
+// 字符串处理
+expr("UPPER(TRIM(email))")
+expr("SPLIT(tags, ',')")
+
+// 数组过滤（Lambda表达式）
+expr("FILTER(items, item, item.price > 100)")
+
+// 日期计算
+expr("YEAR(createdAt) === 2024 && MONTH(createdAt) === 12")
+
+// 完整聚合查询示例
+await orders.aggregate([
+  {
+    $project: {
+      // 价格计算
+      finalPrice: expr("price * (1 - discount / 100)"),
+      
+      // 日期提取
+      year: expr("YEAR(createdAt)"),
+      month: expr("MONTH(createdAt)"),
+      
+      // 状态分类
+      statusLabel: expr("SWITCH(status === 'paid', 'Paid', status === 'pending', 'Pending', 'Cancelled')")
+    }
+  },
+  {
+    $group: {
+      _id: { year: '$year', month: '$month' },
+      totalOrders: expr("COUNT()"),
+      totalRevenue: expr("SUM(finalPrice)")
+    }
+  }
+]);
+```
+
+📖 **完整文档**：[统一表达式系统](./docs/aggregate.md#统一表达式系统) | [67个操作符列表](./docs/aggregate.md#支持的操作符-67个)
+
+---
+
 ### 1. ⚡ 智能缓存系统 - 性能提升 10~100 倍
 
 <table>