开发路线图与版本策略

项目: foundry
组织: foundkit

• 待开始 (Pending)
• [/] 进行中 (In Progress)
• 已完成 (Completed)

• 1.1 平台框架与业务应用完全解耦

  • 创建高层门面 crate foundry，提供 FoundryApp::builder() 与统一 prelude。
  • 彻底隔离框架运行时与独立用户业务工程。
  • 通过 Cargo dependency (foundry = "0.1") 声明式引入。

• 1.2 子系统标准与动态路由体系

  • SubsystemModule 特征用于注册业务模块、自定义路由与 Admin 运营大屏。
  • 静态编译与动态外部子系统发现引擎。
  • 专题隔离 RBAC 校验与 SystemContext 租户上下文注入。

• 1.3 存储与 Admin 控制台

  • PostgreSQL Zero-DDL 动态数据模型存储引擎。
  • 自动生成高可用 RESTful CRUD 接口 (/api/v1/s/{system_slug}/{model_slug})。
  • 内嵌 React Admin SPA 外壳与沙箱通信 Bridge (FoundryBridge)。

• 1.4 开发者 CLI 工具 (foundry-cli)

  • foundry new <project>: 脚手架独立用户业务工程。
  • foundry system new <slug>: 快速创建业务子系统。
  • foundry migrate: 执行数据库初始化迁移。
  • foundry validate / system list: 工程规范校验与子系统发现工具。

• 1.5 完整参考示例与自动化测试

  • examples/blog_platform: 真实场景独立业务应用范例。
  • CI 端到端集成测试与 CLI Smoke 自动化验证。

• [/] 2.1 WebAssembly (Wasmtime) 沙箱插件运行时

  • 支持动态热加载 WASM 子系统扩展。
  • 为多租户自定义逻辑提供内存安全隔离。

• [/] 2.2 OpenAPI 3.0 与 Swagger UI 深度集成

  • 自动聚合动态数据模型与子系统接口的 OpenAPI Schema。
  • Admin 外壳内嵌实时交互式 API 文档。

• 2.3 多数据库驱动扩展与插件化存储架构 (PostgreSQL、MySQL、MariaDB、MongoDB)

  • 详细设计与实施路线图参见：存储引擎架构与多数据库规划。
  • 存储引擎 SPI 机制与智能探测：抽象 StorageDriverProvider 与 StorageRegistry 注册中心，支持通过 DATABASE_URL 协议前缀自动路由或单一环境变量 DATABASE_TYPE 灵活切换。
  • 方法调用解耦与驱动零泄露：开发者与业务层只调用 db.records() 等统一方法，底层驱动全面内聚。
  • 分阶段落地优先级与进度：
    • 阶段 0 (第一接入 - [x] 已完成)：核心 SPI 架构解耦，抽离现有 PostgreSQL 为 PostgresProvider，确保既有系统 100% 行为兼容。
    • 阶段 1 (第二接入 - [x] 已完成)：MySQL 8.0+ / 8.4+ 单表通用策略，适配自增主键、DATETIME(6)、延迟关联深度分页优化与事务原子重查。
    • 阶段 2 (第三接入 - [x] 已完成)：MariaDB 10.5+ 独立方言与特化驱动适配，专用迁移脚本与高性能覆盖复合索引方案。
    • 阶段 3 (第四接入 - [x] 已完成)：MongoDB 6.0+ 原生文档策略，BSON 文档与 _counters 原子序列 i64 主键映射，Wildcard (data.$**) 全量动态索引加速。
    • 阶段 4 (生产就绪与生态发布 - [x] 已完成)：升级 foundry migrate 自动化感知多数据库方言迁移，多数据库端到端集成测试套件验证，发布多数据库使用指南。(注：Oracle DB 因生态与依赖过重已移除)

• 3.1 集群编排与分布式 Pub/Sub

  • 实时 WebSocket 事件广播。
  • 基于 Redis Pub/Sub 的多节点缓存同步。

• 3.2 动态 Webhook 事件分发器

  • 在模型写操作时触发自定义 Webhook。
  • 支持指数退避重试队列。

Foundry 严格遵循 语义化版本规范 (SemVer)：

• 主版本 (1.x.x): 公共 API 的重大重构与 Breaking Changes，附带自动化迁移指引。
• 次版本 (0.x.x, 1.x.0): 新功能发布、构造器选项扩充、向后兼容的特征默认实现。
• 补丁版本 (0.1.x): 向后兼容的缺陷修复与性能提升。

在用户工程中升级：

cargo update -p foundry