---
title: 框架发展规划（Roadmap）
description: WWJCloud 框架的总体愿景、中心理念、阶段性目标与当前进度
---

# 框架发展规划（Roadmap）

## 愿景
- 打造“单体内核 + 插件化扩展”的企业级后端框架，开箱即用、可持续演进。
- 社区版专注简单可用与二次开发体验；企业版在此基础上提供可选的微服务化能力与运维套件。

## 中心理念（设计原则）
- 边界清晰：按领域拆模块，仅通过公开接口/事件通讯，避免跨模块直依内部实现。
- 事件优先：统一事件总线接口（先内存/Redis，未来可切 NATS/Kafka），降低耦合。
- 无状态化：会话/文件/缓存外部化，便于横向扩展与独立部署。
- 配置与多租户：集中配置管理，预留租户与数据隔离模型，便于拆分与限流。
- 网关前置：所有 API 走统一入口（内置或可替换网关），便于安全与治理。
- 可插拔扩展：`app/*`、`addons/*` 动态加载，扩展可注册路由/权限/实体/迁移。
- 观测基线：统一日志/指标/追踪接口，便于对接 Prometheus/Jaeger。
- 版本与兼容：扩展声明 `engines.wwjcloud` 范围，核心严格校验，避免破坏性变更。

## 阶段规划（里程碑）
### M1 社区内核（当前阶段）
- 单体内核稳定化（Auth、RBAC、Settings、Upload、Schedule 等基础能力）
- 统一 Swagger 文档（`/docs` + `/docs-json`），文档站分组展示（frontend/adminapi）
- 插件机制 MVP：运行时加载 `app/*`、`addons/*`，支持路由/实体/迁移注册
- CLI&模板：初始化扩展脚手架与最佳实践文档

### M2 扩展生态与治理
- 扩展生命周期与 Hook：`onInit/onDestroy`、领域事件（如 `onUserCreated`）
- 权限与菜单注册：扩展可自定义权限点与菜单，核心统一聚合
- 配置命名空间：`addons.<name>.*` 校验与默认值机制
- 观测接入：标准日志/指标/追踪适配层

### M3 可选微服务化（企业版）
- 领域解耦与服务化试点（1-2 个高压力模块外置）
- 网关/注册中心/链路追踪/灰度与压测方案
- 统一事件总线切换为 NATS/Kafka（可配置）
- 多环境/多区域发布与运维面板

## 当前进度
- 后端：
  - Auth/JWT、RBAC、Settings、Upload、Schedule 等模块可用
  - 循环依赖处理与 `JwtGlobalModule` 全局化
  - 统一 Swagger：`/docs` 与 `/docs-json`
  - 配置中心：`ConfigCenterService` 统一配置管理，支持动态配置 CRUD、配置验证、元数据管理和统计监控
- 文档：
  - 站点结构优化，`/vben/guide` 调整
  - `openapi/api/frontend` 与 `openapi/api/adminapi` 分组文档（从统一 JSON 按前缀生成）
  - 网关文档目录与概览/计划/架构文档

## 已完成功能（摘要）
- 基础设施：日志（Winston）、验证（Pipe/DTO）、队列（Bull，预留）、静态/上传
- 安全与权限：JWT 鉴权、RBAC 角色/菜单、守卫与拦截器基线
- 配置与多语言：集中配置、国际化（多语言）修正
- 配置中心系统：统一配置管理、动态配置、环境适配、类型安全、缓存机制、元数据管理
- 文档与工具：Swagger 统一、脚本生成 API 文档、VitePress 站点导航

## 近期计划（Next）
- 扩展装载器增强：
  - 扫描与校验扩展清单（`addon.json`/`package.json`）
  - 实体/迁移聚合加载与执行
  - 扩展路由前缀与 Swagger Tag 自动化
- CLI：`npx wwjcloud new addon <name>` 生成标准骨架
- 观测接口：统一暴露日志/指标/追踪 Hook，接入示例

## 如何参与
- 提交 Issue/PR：提出功能建议或改进点
- 扩展开发：基于模板创建 addon，遵循扩展 API 与示例
- 反馈文档与 Roadmap：帮助完善优先级与排期