monSQLize 文档入口

这份文档从常见应用路径开始:连接 MongoDB,完成集合读写,需要时再加入 Model 校验,并按需开启缓存、事务、连接池、同步与运维能力。

主要文档路径

目标入口说明
安装、连接、完成第一次查询getting-started.md安装与最小连接验证
快速上手常用集合操作basic-operations.md日常 CRUD、分页、缓存 TTL 与 Model 入口选择
配置 new MonSQLize(options)configuration.md构造函数完整参数、默认值、缓存、Redis、Model、同步、连接池与日志
对照文档与可运行源码examples.md每个主题都链接到 GitHub 示例源码
添加数据库缓存cache.md集合查询缓存、Redis 二级缓存、分布式失效
控制 collection 与 Model 写入路径write-path-policy.md需要某些命名空间必须经过 Model 写入时使用
准备生产发布production-rollout.md数据任务发布、Change Stream CDC、索引预检与切流检查
按场景迁移生产数据production-data-migration.mdA 实例到生产的筛选数据、索引、字段调整与恢复流程
查询数据任务参数data-tasks.md唯一 Job 配置、四个方法、全部参数与 CLI 命令
查看场景指南recipes.md连接、缓存、Redis、SSH、连接池、Model 的场景指南
浏览完整 APIapi-index.md低层 API 与兼容 API 的参考入口
查看运行时边界capability-index.md能力总览与深入页面入口

推荐阅读顺序

  1. 根入口说明:仓库 README
  2. 安装:getting-started.md
  3. 快速上手:basic-operations.md
  4. 构造配置:configuration.md
  5. 可执行示例:
  6. 缓存专题:cache.md
  7. 写路径策略:write-path-policy.md
  8. 生产发布:production-rollout.md
  9. 生产数据迁移:production-data-migration.md
  10. 数据任务 API:data-tasks.md
  11. 场景指南:recipes.md
  12. API 与运行时参考:

源码与验证

  • 文档站由 docs/endocs/zh 生成。
  • 可运行示例位于 examples
  • 公开行为应与包根导出、公开类型和可运行示例保持一致。

示例运行方式

在仓库根目录执行:

npm run build
npm run test:examples

npm run test:examples 会通过仓库示例 runner 启动临时 MongoDB 测试服务,编译 TypeScript 示例,执行示例,并在结束时清理临时数据目录。