📅 Phase 4 · 数据就绪 & 模板

让集群智能起来

Phase 4 让集群具备真正的"智能化"能力——通过源码分析自动发现依赖关系、提供 6 个内置模板覆盖主流架构场景、支持用户从空白自定义模板。

📅 Phase 4 开始 ⏱️ 3-4 周（24 工作日） 📋 30 个任务 🎯 6 张线框图

核心目标

💡 Phase 4 的核心交付

源码分析引擎（支持任意仓库 + Java/Node.js/Python）、7 条自动依赖检测规则（高置信自动 + 低置信确认）、6 个内置集群模板、自定义模板创建（从空白）。

🔍 源码分析引擎

支持任意本地/远程仓库，解析 Java/Spring、Node.js、Python 项目代码，提取 API、数据模型、依赖关系。

🤖 自动依赖检测

7 条检测规则（共享实体引用、API调用、ref字段、表名、导入语句、页面流、配置解析），按置信度分级处理。

📋 集群模板

6 个内置模板（微服务/数据中台/全栈/移动端/电商中台/AI平台），用户可从空白自定义模板。

明确边界：本阶段不做

⚠️ 范围控制

不做的事	原因	推迟到
数据迁移工具	不需要，现有项目数据保留	-
引导用户声明 sharedEntityRefs	已在 Phase 3 自由引用	Phase 3
跨集群关系	单集群尚未稳定	Phase 5+
模板市场	用户社区未建立	远期

源码分析引擎

支持语言

优先级	语言	典型框架	分析能力
P0	Java	Spring Boot / Spring Cloud	API 路由、Entity、Repository、Service 调用
P0	JavaScript / TypeScript	Express / NestJS / Koa	API 路由、Model、Import 关系
P0	Python	Django / Flask / FastAPI	API 路由、Model、Import 关系
P0	PHP	Laravel / ThinkPHP / Yii	API 路由、Model、Use 语句
P1	Go	Gin / Echo	API 路由、Struct、Import
P2	Rust	Actix / Rocket	API 路由、Struct

仓库接入

支持任意类型的仓库源：

类型	示例	接入方式
本地目录	./src, /Users/me/project	直接读取文件系统
Git 仓库	git@github.com:org/repo.git	git clone 后读取
SVN 仓库	svn://server/repo	svn checkout 后读取
压缩包	project.zip, project.tar.gz	解压后读取
远程 URL	https://github.com/org/repo	下载后读取

分析规则

从源码中提取的信息：

Java / Spring Boot

// 检测到的信息
{
  type: 'spring-boot',
  endpoints: [
    {method: 'GET', path: '/api/users', file: 'UserController.java:23'},
    {method: 'POST', path: '/api/users', file: 'UserController.java:31'}
  ],
  entities: [
    {name: 'User', table: 't_user', file: 'User.java'}
  ],
  services: [
    {name: 'UserService', dependencies: ['UserRepository', 'EmailService']}
  ],
  dependencies: [
    {from: 'OrderController', to: 'UserService', type: 'invoke'}
  ]
}

Node.js / Express

// 检测到的信息
{
  type: 'express',
  endpoints: [
    {method: 'GET', path: '/api/users', file: 'routes/users.js:12'}
  ],
  models: [
    {name: 'User', schema: 'models/User.js'}
  ],
  imports: [
    {from: 'routes/users.js', import: '../models/User'}
  ]
}

Python / FastAPI

// 检测到的信息
{
  type: 'fastapi',
  endpoints: [
    {method: 'GET', path: '/users/{id}', file: 'routers/users.py:15'}
  ],
  models: [
    {name: 'User', schema: 'schemas/user.py'}
  ]
}

自动依赖检测

7 条检测规则

优先级	规则	说明	数据源
P0	共享实体引用	项目 A 引用 sharedEntityRefs → A 依赖使用这些实体的能力	Phase 3 数据
P0	API 端点调用	源码中检测到的 HTTP/gRPC 调用关系	源码分析
P1	数据模型 ref	实体字段 ref:Entity 引用	数据模型
P1	数据库表名	从 @Table、@Entity 推断数据模型	源码分析
P2	导入语句分析	import / require 语句推断模块依赖	源码分析
P2	页面数据流	页面 HTML 中的 data-goto 和 API 调用	页面 HTML
P3	配置文件解析	docker-compose、application.yml 等	配置文件

置信度分级

📐 与 Phase 2 的衔接

能力的手动创建入口在 Phase 2 能力注册面板 已建立。Phase 4 的自动检测引擎会复用该入口，将检测到的能力直接导入到能力注册表中。用户也可在 Phase 2 手动补充 Phase 4 未检测到的能力。

置信度	含义	处理方式
高 0.9-1.0	直接引用、明确 API 调用	自动确认，可手动修改
中 0.7-0.9	数据模型推断、数据库表名	默认建议，用户确认
低 0.5-0.7	导入语句、页面数据流、配置文件	仅展示，用户手动添加

检测流程

// 检测流程
用户接入仓库（本地路径或 Git URL）
触发自动检测引擎
引擎扫描所有规则
生成依赖建议列表（含置信度）
建议进入 pendingReview 队列
用户在「检测结果」面板看到建议
高置信度自动确认，中低置信度需用户操作
用户采纳/忽略/修改后采纳
确认后创建正式依赖关系

集群模板

6 个内置模板

基于阿里双中台架构、DDD 分层、微服务分层等业界最佳实践，设计的 6 个内置模板：

模板	层数	层结构	适用场景
微服务标准架构	4 层	L1 基础设施 / L2 中间件 / L3 微服务 / L4 应用	通用后端微服务
数据中台架构	4 层	L1 基础设施 / L2 数据存储 / L3 数据服务 / L4 数据应用	数据平台 / BI 系统
全栈应用架构	3 层	L1 基础设施 / L2 后端 / L3 前端	中小型 Web 应用
移动端架构	5 层	L1 基础设施 / L2 中间件 / L3 后端 / L4 BFF / L5 移动端	移动 App
电商中台架构	6 层	L1-L2 + L3 数据中台 + L4 业务中台 + L5 应用 + L6 前端	大型电商（阿里模式）
AI 平台架构	5 层	L1 基础设施 / L2 数据 / L3 训练 / L4 模型 / L5 应用	AI/ML 平台

自定义模板（从空白）

用户可以从空白开始，完全自定义模板：

可配置项	说明
层结构	自定义层数 + 每层名称
建议项目	每层推荐创建的项目
默认能力	预定义的能力（类型 + 版本）
共享实体	预定义的共享实体（字段 + 关系）
模板描述	说明模板适用场景

线框图（6 张）

1️⃣ 仓库接入

用户接入本地目录或 Git 仓库以进行源码分析。

接入项目仓库

任务 1.1-1.2Day 1-2

2️⃣ 检测结果面板

展示自动检测到的依赖建议，按规则和置信度分类。

自动依赖检测结果

任务 2.1-2.3Day 6-12

扫描完成：检测到 12 条 可能的依赖关系，其中高置信 5 条、中置信 4 条、低置信 3 条

🔵 高置信度（自动确认）

高 95% 订单系统 → 用户中心服务

规则：API 端点调用 · OrderController.java:45 调用 UserService.getById()

高 92% 订单系统 → 共享实体 User

规则：共享实体引用 · sharedEntityRefs: ['User', 'Product']

🟡 中置信度（待确认）

中 85% 订单系统 → MySQL

规则：数据库表名 · @Table(name="t_order") 对应 t_order 表

🟢 低置信度（仅供参考）

低 60% 订单系统 → 用户中心服务

规则：导入语句分析 · import com.example.user.dto

3️⃣ 模板选择

从 6 个内置模板中选择，或从空白创建。

选择集群模板

任务 3.1-3.2Day 13-14

🏗️ 微服务标准架构

4 层 · 通用后端微服务

📊 数据中台架构

4 层 · 数据平台 / BI

🌐 全栈应用架构

3 层 · 中小型应用

📱 移动端架构

5 层 · App + BFF + 后端

🛒 电商中台架构

6 层 · 阿里双中台模式

🤖 AI 平台架构

5 层 · AI/ML 平台

➕ 从空白创建

完全自定义层结构

4️⃣ 模板预览

预览模板生成的集群结构。

模板预览 · 电商中台架构

任务 3.3Day 15

📦 集群结构（6 层）：

└ L1 基础设施层（K8s、CDN、对象存储）

└ L2 中间件层（MySQL、Redis、Kafka、ES）

└ L3 数据中台层（用户画像、数据仓库）

└ L4 业务中台层（商品中心、订单中心、用户中心）

└ L5 应用系统层（商城、营销、客服）

└ L6 前端应用层（PC Web、移动 App）

🎯 默认能力：

· 用户认证（api_service）· 商品查询（api_service）

· 订单创建（api_service）· 支付能力（api_service）

📊 默认共享实体：

· User · Product · Order · Payment

5️⃣ 自定义模板（从空白）

用户完全自定义集群模板。

自定义集群模板

任务 3.4-3.5Day 16-17

6️⃣ 模板保存与管理

查看和管理所有自定义模板。

我的模板

任务 3.6Day 18

我的自定义模板（2 个）

📋 我的电商架构

5 层 · 基于 cluster-xxx 创建 · 最后修改 2026-09-04

📋 IoT 平台架构

4 层 · 物联网场景 · 最后修改 2026-08-28

任务清单（30 项）

📅 Week 1 · 源码分析引擎（Day 1-5）

#	任务	Day	工作	依赖
1.1	仓库接入器（本地/Git/SVN/压缩包）	D1-2	2 天	-
1.2	项目语言/框架自动识别	D3	1 天	1.1
1.3	Java Spring Boot 分析器	D4-5	2 天	1.2

📅 Week 2 · 更多语言 + 检测规则（Day 6-10）

#	任务	Day	工作	依赖
2.1	Node.js/Express 分析器	D6-7	2 天	1.3
2.2	Python/Django/FastAPI 分析器	D8-9	2 天	2.1
2.3	检测规则引擎（7 条规则）	D10	1 天	2.2

📅 Week 3 · 自动依赖检测 UI + 模板（Day 11-15）

#	任务	Day	工作	依赖
3.1	检测结果面板 UI	D11-12	2 天	2.3
3.2	采纳/忽略/修改 UI	D13	1 天	3.1
3.3	模板选择 UI（6 个内置）	D14-15	2 天	3.2

📅 Week 4 · 自定义模板 + 联调（Day 16-20）

#	任务	Day	工作	依赖
4.1	自定义模板创建 UI	D16-17	2 天	3.3
4.2	模板预览 + 保存	D18	1 天	4.1
4.3	端到端测试	D19	1 天	4.2
4.4	文档 & 演示	D20	1 天	4.3

完成标准（Definition of Done）

✅ Phase 4 完成时，以下必须全部满足

#	验收项	验证方式
1	仓库接入支持本地/Git/SVN/压缩包	测试各类仓库
2	Java Spring Boot 项目代码可分析	接入测试项目
3	Node.js 项目代码可分析	接入测试项目
4	Python 项目代码可分析	接入测试项目
5	7 条检测规则全部实现	逐一验证
6	检测结果按置信度分级展示	UI 检查
7	高置信自动确认，中低置信需用户操作	流程测试
8	6 个内置模板可选择并创建集群	逐一验证
9	自定义模板可从空白创建	UI 测试
10	自定义模板可保存、编辑、删除	UI 测试
11	模板包含层结构 + 默认能力 + 共享实体	UI 测试
12	文档完成	docs/
13	无 P0/P1 Bug 残留	端到端测试

风险与缓解

风险	概率	影响	缓解措施
源码分析误报率高	高	中	置信度分级 + 人工确认机制
大型仓库分析慢	中	中	异步分析 + 进度提示
不同框架的代码风格差异	高	中	支持主流约定 + 用户手动调整
模板适用性差	中	低	模板仅作为起点，用户可完全自定义