路线图

本页是 Atomo 的唯一权威路线图，汇总实施状态与接下来要做的工作。长期愿景与架构请参见“愿景与架构”。

• 愿景：/zh/vision

状态总览

• CLI 与开发运行时：已实现（init、migrate、codegen、dev、dev --workspace）
• Schema → Rust/GraphQL/代码生成：已实现，支持热重载
• GraphQL API：已实现，并与平台查询合并
• Admin UI：动态渲染核心已实现；工作区模式下代理
• 认证（JWT + RBAC）：已实现；密码哈希为开发占位（见说明）
• 审计日志：已实现（REST 端点 + 平台 GraphQL）
• TypeScript SDK：已实现（类型与 React hooks）
• Actions 与 Workers：事件触发自动化（v1 架构）已实现；TypeScript Worker SDK 已发布
• 计量命令原语：已实现 atomo_server::metered —— 过期一次性令牌存储 + 整数单位预算账本 + 事务性 JobStore::enqueue_tx，将"预留预算 · 消费令牌 · 入队任务"组合为一个全有或全无的计量命令。通用、仅库 API（无 HTTP 接口、无业务策略）；已用 Postgres 测试（单次使用、窗口限额、并发不超额、事务回滚）。指南：/guide/advanced/metered-command-primitives
• 实时协作：基础已具备；WebSocket/CRDT 集成待完成

已交付亮点

• 开发运行时
  • 生成 .atomo/runtime、增量编译与热重载
  • 工作区模式监听核心 crate 与服务 schema；代理 Admin UI 到 /admin
• GraphQL 与元数据
  • 合并服务与平台 schema（用户、会话、审计）
  • 提供 /meta/schema 与开发时 GET /schema.ts
• GraphQL IDE：服务下 /graphql；工作区模式 /playground
• 认证与会话
  • JWT 签发/校验；会话存储于 Postgres
  • 角色模型（Admin/Manager/Sales/Support/Viewer）与 RBAC 校验
  • REST：/auth/login、/auth/logout、/auth/me
• 审计
  • REST：/audit/logs、/audit/user/:id/activity、/audit/entity/:type/:id/audit、/audit/statistics
  • 平台 GraphQL 查询：用户与会话
• SDK
  • 在 packages/atomo-client-sdk 生成类型与 React hooks 脚手架

近期已完成

• Actions & Workers（v1）：事件触发的 action dispatcher、外部 worker SDK、worker CRUD API
• 生产级密码哈希（argon2id，兼容验证旧的 bcrypt 哈希）
• 实时 GraphQL 订阅（WebSocket，按模型过滤）
• AI 集成（pgvector EmbeddingStore，相似度搜索）
• 多租户隔离（TenantCtx 行级作用域）
• GraphQL 解析器中基于 schema access 规则的 RBAC 强制
• 事件溯源：event_log 持久化与回放；CQRS 读投影
• 工作流引擎：触发器、条件、重试策略、cron 调度
• OAuth2/OIDC SSO（Google、GitHub、Microsoft、Okta）
• 限流中间件（按 IP 令牌桶）
• 结构化追踪与请求 ID 传播
• 输入校验（required、email、min、max、numeric）
• 软删除与自动查询过滤
• 启动时从 ADMIN_EMAIL/ADMIN_PASSWORD 引导管理员用户

文档 vs 代码（真实状态）

• 密码哈希：默认 argon2id；兼容验证旧的 bcrypt 哈希
• 限流：按 IP 令牌桶中间件，通过 RATE_LIMIT_RPS / RATE_LIMIT_WINDOW_SECS 配置
• Actions & Workers：v1 架构，含事件触发 dispatcher 与外部 worker SDK
• 订阅：通过 /graphql/ws 工作，支持按模型过滤
• 验证：CRUD → 事件存储 → 订阅链路已对 PostgreSQL 做集成测试

阶段（高层级）

第 1 阶段 — 开发者体验核心（4–6 个月）

• P0 核心基础设施（大部分完成）
  • CLI 工具链（init、generate、migrate、dev、codegen、dev --workspace）
  • 双模定义（TS → Rust/GraphQL），支持热重载
  • 事件友好数据层与审计日志
• P1 动态 API 与 Admin UI（基本完成）
  • 动态 GraphQL API（schema 合并、CRUD 解析器）
  • 认证与授权（JWT + RBAC）、元数据 API
  • 基于 Schema 的动态渲染引擎
• P2 可扩展性与 AI 基础（部分）
  • Hook/Access DSL 与 action 接口
  • Actions & Workers 框架（事件触发自动化、外部 worker SDK）
  • 无需 fork 的扩展能力：可声明的 schema 约束 （@unique/@index/@@unique/@@index/@@check，含带 WHERE 的部分索引）， 以及 worker 提供的自定义集成；事务型路由处理器已完成设计（第 3 阶段）
  • AI 基础（pgvector、内容 API）

第 2 阶段 — 认知与边缘（6–9 个月）

• ES/CQRS 成熟度（回放、可观测、运维预案）
• 本地优先同步（SDK alpha）、实时订阅
• Actions & Workers：事件触发自动化与外部 worker SDK
• 边缘投影（Workers/Vercel KV）、相似度检索

第 3 阶段 — 生态与解决方案（8–12 个月）

• 可视化流程编排，内置 AI 节点
• “解决方案即代码”市场与官方模板
• 企业级特性（RBAC/ABAC、SSO、多租户）与 Atomo Cloud 发布

成功指标与质量门槛

• 测试：覆盖率 > 85%；关键路径 100%
• 性能：核心路径较常见 Node.js 方案快 3–5×
• 安全：通过独立安全审计
• 可靠性：≥ 99.9% 服务可用性
• 社区：GitHub 影响与模板采用率

里程碑时间线（建议）

• 2024 Q4 — 第 1 阶段启动；首个完整 CRM 演示
• 2025 Q1–Q2 — 第 1 阶段完成；开源发布与社区建设
• 2025 Q3–Q4 — 第 2 阶段执行；Atomo Cloud 私测
• 2026 Q1+ — 第 3 阶段扩展；解决方案市场成熟

下一步里程碑

• 协作
  • CRDT 支撑的模型，实现无冲突的实时编辑
• Actions & Workers
  • Worker → Rust CRUD API（第 2 阶段）：让 worker 通过引擎读写数据
  • 可视化工作流设计器 UI；定时（cron）触发执行
• 生态
  • Worker 注册中心与发现机制改进
  • Atomo Cloud 托管平台
• 加固
  • 集中化权限检查；扩展服务启动路径的集成测试覆盖

若评估 Atomo，可先阅读“指南”中的开发流程；若需平台理念与架构，请参阅“愿景与架构”。