Skip to content

Commit 344f7c6

Browse files
Gemini CLIclaude
andcommitted
docs: update roadmap to v8.0 with user self-service extension plan
- Rewrite roadmap_v5.0.md: v7.1 (MCP UI + WorkflowEditor fix), v7.5 (security + skill bundles), v8.0 (custom Skills + DAG workflow), v9.0 (collaboration + edge) - Add three-tier extension architecture (MCP → Skills → Visual Workflow) - Add user-self-service-extension-plan.md (original proposal) - Update API count 30 → 31 across README, README_en, CLAUDE.md - Sync version roadmap tables in all READMEs Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent f11f814 commit 344f7c6

5 files changed

Lines changed: 311 additions & 250 deletions

File tree

CLAUDE.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,7 @@ Custom React SPA replacing Chainlit's default UI. Three-panel layout: Chat (320p
8282
- **UserSettings**: Account info + self-deletion modal (danger zone)
8383
- **App.tsx**: Auth state, map/data state, layer control, user menu dropdown
8484

85-
### Frontend API (30 REST endpoints in `frontend_api.py`)
85+
### Frontend API (31 REST endpoints in `frontend_api.py`)
8686
All endpoints use JWT cookie auth. Routes mounted before Chainlit catch-all via `mount_frontend_api()`.
8787

8888
| Method | Path | Purpose |
@@ -108,7 +108,7 @@ All endpoints use JWT cookie auth. Routes mounted before Chainlit catch-all via
108108
|---|---|
109109
| `agent.py` | Agent definitions, pipeline assembly, tool functions |
110110
| `app.py` | Chainlit UI, auth, semantic router, RBAC, file uploads, layer control |
111-
| `frontend_api.py` | 30 REST API endpoints for React frontend |
111+
| `frontend_api.py` | 31 REST API endpoints for React frontend |
112112
| `auth.py` | Password hashing, registration, account deletion, Chainlit auth callbacks |
113113
| `user_context.py` | `ContextVar` for user_id/session_id/role propagation; `get_user_upload_dir()` |
114114
| `db_engine.py` | Singleton SQLAlchemy engine with connection pooling |
@@ -161,7 +161,7 @@ The DRL model uses `MaskablePPO` (from `sb3_contrib`) with a custom `ParcelScori
161161
- **Framework**: Google ADK v1.21 (`google.adk.agents`, `google.adk.runners`)
162162
- **LLM**: Gemini 2.5 Flash / 2.5 Pro (agents), Gemini 2.0 Flash (router)
163163
- **Frontend**: React 18 + TypeScript + Vite + Leaflet.js + @chainlit/react-client v0.3.1
164-
- **Backend**: Chainlit + Starlette (30 REST API endpoints)
164+
- **Backend**: Chainlit + Starlette (31 REST API endpoints)
165165
- **Database**: PostgreSQL 16 + PostGIS 3.4
166166
- **GIS**: GeoPandas, Shapely, Rasterio, PySAL, Folium, mapclassify, branca
167167
- **ML**: PyTorch, Stable Baselines 3, Gymnasium

README.md

Lines changed: 19 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
# GIS Data Agent (ADK Edition) v7.0
44

5-
基于 **Google Agent Developer Kit (ADK)** 构建的 AI 驱动地理空间分析平台。通过自然语言语义路由,自动调度四大专业管道完成空间数据治理、用地优化、多源数据融合和商业智能分析。前端为 React 三面板 SPA,后端集成 30 个 REST API,支持多模态输入、3D 可视化、工作流编排和知识图谱推理。
5+
基于 **Google Agent Developer Kit (ADK)** 构建的 AI 驱动地理空间分析平台。通过自然语言语义路由,自动调度四大专业管道完成空间数据治理、用地优化、多源数据融合和商业智能分析。前端为 React 三面板 SPA,后端集成 31 个 REST API,支持多模态输入、3D 可视化、工作流编排和知识图谱推理。
66

77
## 核心能力
88

@@ -226,7 +226,7 @@ cd frontend && npm install && npm run dev
226226
| **框架** | Google ADK v1.21 (`google.adk.agents`, `google.adk.runners`) |
227227
| **LLM** | Gemini 2.5 Flash / 2.5 Pro(Agent),Gemini 2.0 Flash(路由) |
228228
| **前端** | React 18 + TypeScript + Vite + Leaflet.js + deck.gl + React Flow |
229-
| **后端** | Chainlit + Starlette(30 个 REST API 端点) |
229+
| **后端** | Chainlit + Starlette(31 个 REST API 端点) |
230230
| **数据库** | PostgreSQL 16 + PostGIS 3.4 |
231231
| **GIS** | GeoPandas, Shapely, Rasterio, PySAL, Folium, mapclassify |
232232
| **ML** | PyTorch, Stable Baselines 3 (MaskablePPO), Gymnasium |
@@ -242,7 +242,7 @@ cd frontend && npm install && npm run dev
242242
data_agent/
243243
├── app.py # Chainlit UI、语义路由、认证、RBAC
244244
├── agent.py # Agent 定义、管道组装
245-
├── frontend_api.py # 30 个 REST API 端点
245+
├── frontend_api.py # 31 个 REST API 端点
246246
├── workflow_engine.py # 工作流引擎:CRUD、执行、Webhook、Cron 调度
247247
├── multimodal.py # 多模态输入:图片/PDF 分类、Gemini Part 构建
248248
├── mcp_hub.py # MCP Hub Manager:配置驱动的 MCP 服务器管理
@@ -305,7 +305,7 @@ docs/ # 文档
305305
└───────────────────┴──────────────────────────┴──────────────────────┘
306306
```
307307

308-
## REST API 端点(30 条路由)
308+
## REST API 端点(31 条路由)
309309

310310
| 方法 | 路径 | 描述 |
311311
|---|---|---|
@@ -334,6 +334,7 @@ docs/ # 文档
334334
| GET/PUT/DELETE | `/api/workflows/{id}` | 工作流详情/更新/删除 |
335335
| POST | `/api/workflows/{id}/execute` | 执行工作流 |
336336
| GET | `/api/workflows/{id}/runs` | 执行历史 |
337+
| GET | `/api/map/pending` | 待处理地图更新(前端轮询) |
337338

338339
## 运行测试
339340

@@ -360,23 +361,21 @@ GitHub Actions 工作流(`.github/workflows/ci.yml`)在 push 到 `main`/`dev
360361

361362
| 版本 | 功能集 | 状态 |
362363
|---|---|---|
363-
| v1.0 | 本地文件、基础 DRL | 完成 |
364-
| v2.0 | Excel 地理编码、报告生成 | 完成 |
365-
| v3.0 | PostGIS、硬路由 | 完成 |
366-
| v3.1 | 多管道架构 | 完成 |
367-
| v3.2 | 语义层、商业套件 | 完成 |
368-
| v4.0 | 前端集成、可观测性、CI、技能包 | 完成 |
369-
| v4.1 | 会话持久化、管道进度、错误恢复、数据预览、i18n | 完成 |
370-
| v5.1 | MCP 工具市场 | 完成 |
371-
| v5.2 | 多模态输入/输出 | 完成 |
372-
| v5.3 | 3D 空间可视化 | 完成 |
373-
| v5.4 | 工作流编排(引擎 + 编辑器 + Cron + Webhook) | 完成 |
374-
| v5.5 | 多模态数据融合引擎 MMFE(5 模态、10 策略、语义匹配) | 完成 |
375-
| v5.6 | MGIM 启发增强(模糊匹配、单位转换、数据感知策略、多源编排) | 完成 |
376-
| v6.0 | 融合引擎不足修复(栅格重投影、点云高度、流数据时态、语义增强、质量验证) | 完成 |
377-
| v6.1 | 高级分析引擎(时空预测、场景模拟、网络分析) | 计划中 |
364+
| v1.0–v3.2 | 基础 GIS、PostGIS、语义层、多管道架构 | ✅ 完成 |
365+
| v4.0 | 前端三面板 SPA、可观测性、CI/CD、技能包、协作标注 | ✅ 完成 |
366+
| v4.1 | 会话持久化、管道进度可视化、错误恢复、数据预览、i18n | ✅ 完成 |
367+
| v5.1 | MCP 工具市场(引擎 + 前端展示 + 管线过滤) | ✅ 完成 |
368+
| v5.2 | 多模态输入(图片理解 + PDF 解析 + 语音输入) | ✅ 完成 |
369+
| v5.3 | 3D 空间可视化(deck.gl + MapLibre + 2D/3D 切换) | ✅ 完成 |
370+
| v5.4 | 工作流编排(引擎 + Cron + Webhook) | ✅ 完成 |
371+
| v5.5 | 多模态数据融合引擎 MMFE(5 模态、10 策略、语义匹配) | ✅ 完成 |
372+
| v5.6 | MGIM 启发增强(模糊匹配、单位转换、数据感知策略、多源编排) | ✅ 完成 |
373+
| v6.0 | 融合增强(栅格重投影、点云、流数据、语义增强、质量验证) | ✅ 完成 |
378374
| v7.0 | 向量嵌入匹配、LLM 策略路由、地理知识图谱、分布式计算 | **当前** |
379-
| v8.0 | 实时协作、边缘部署、数据连接器生态 | 规划中 |
375+
| v7.1 | MCP 管理 UI、WorkflowEditor 修复、用户分析视角注入 | 计划中 |
376+
| v7.5 | MCP 安全加固 + per-User 隔离、自定义技能包组合 | 计划中 |
377+
| v8.0 | DB 驱动自定义 Skills、RAG 知识库、DAG 工作流、高级分析引擎 | 规划中 |
378+
| v9.0 | 实时协同编辑、边缘部署、数据连接器生态、多 Agent 并行 | 远期 |
380379

381380
## 许可证
382381

README_en.md

Lines changed: 18 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -170,7 +170,7 @@ Default login: `admin` / `admin123` (seeded on first run). In-app self-registrat
170170
| **Framework** | Google ADK v1.21 (`google.adk.agents`, `google.adk.runners`) |
171171
| **LLM** | Gemini 2.5 Flash / 2.5 Pro (agents), Gemini 2.0 Flash (router) |
172172
| **Frontend** | React 18 + TypeScript + Vite + Leaflet.js + deck.gl + React Flow |
173-
| **Backend** | Chainlit + Starlette (30 REST API endpoints) |
173+
| **Backend** | Chainlit + Starlette (31 REST API endpoints) |
174174
| **Database** | PostgreSQL 16 + PostGIS 3.4 |
175175
| **GIS** | GeoPandas, Shapely, Rasterio, PySAL, Folium, mapclassify |
176176
| **ML** | PyTorch, Stable Baselines 3 (MaskablePPO), Gymnasium |
@@ -186,7 +186,7 @@ Default login: `admin` / `admin123` (seeded on first run). In-app self-registrat
186186
data_agent/
187187
├── app.py # Chainlit UI, semantic router, auth, RBAC
188188
├── agent.py # Agent definitions, pipeline assembly
189-
├── frontend_api.py # 30 REST API endpoints
189+
├── frontend_api.py # 31 REST API endpoints
190190
├── workflow_engine.py # Workflow engine: CRUD, execution, webhook, cron
191191
├── multimodal.py # Multimodal input: image/PDF classification, Gemini Parts
192192
├── mcp_hub.py # MCP Hub Manager: config-driven MCP server management
@@ -279,6 +279,7 @@ Custom React SPA replacing Chainlit's default UI:
279279
| GET/PUT/DELETE | `/api/workflows/{id}` | Workflow detail / update / delete |
280280
| POST | `/api/workflows/{id}/execute` | Execute workflow |
281281
| GET | `/api/workflows/{id}/runs` | Workflow execution history |
282+
| GET | `/api/map/pending` | Pending map updates (frontend polling) |
282283

283284
## Running Tests
284285

@@ -305,23 +306,21 @@ GitHub Actions workflow (`.github/workflows/ci.yml`) runs on push to `main`/`dev
305306

306307
| Version | Feature Set | Status |
307308
|---|---|---|
308-
| v1.0 | Local Files, Basic DRL | Done |
309-
| v2.0 | Excel Geocoding, Report Generation | Done |
310-
| v3.0 | PostGIS, Hard Routing | Done |
311-
| v3.1 | Multi-Pipeline Architecture | Done |
312-
| v3.2 | Semantic Layer, Business Suite | Done |
313-
| v4.0 | Frontend Integration, Observability, CI, Skill Bundles | Done |
314-
| v4.1 | Session Persistence, Pipeline Progress, Error Recovery, i18n | Done |
315-
| v5.1 | MCP Tool Market | Done |
316-
| v5.2 | Multimodal Input/Output | Done |
317-
| v5.3 | 3D Spatial Visualization | Done |
318-
| v5.4 | Workflow Builder (Engine + Editor + Cron + Webhook) | Done |
319-
| v5.5 | Multi-Modal Data Fusion Engine MMFE (5 modalities, 10 strategies, semantic matching) | Done |
320-
| v5.6 | MGIM-Inspired Enhancements (fuzzy matching, unit conversion, data-aware scoring, multi-source) | Done |
321-
| v6.0 | Fusion Engine Improvements (raster reprojection, point cloud, stream temporal, semantic+quality) | Done |
322-
| v6.1 | Advanced Analytics Engine (spatiotemporal prediction, scenario simulation, network analysis) | Planned |
323-
| v7.0 | Vector Embedding Matching, LLM Strategy Routing, Knowledge Graph, Distributed Computing | **Current** |
324-
| v8.0 | Real-time Collaboration, Edge Deployment, Data Connector Ecosystem | Future |
309+
| v1.0–v3.2 | Core GIS, PostGIS, Semantic Layer, Multi-Pipeline Architecture | ✅ Done |
310+
| v4.0 | Frontend Three-Panel SPA, Observability, CI/CD, Skill Bundles | ✅ Done |
311+
| v4.1 | Session Persistence, Pipeline Progress, Error Recovery, i18n | ✅ Done |
312+
| v5.1 | MCP Tool Market (Engine + Frontend + Pipeline Filtering) | ✅ Done |
313+
| v5.2 | Multimodal Input (Image + PDF + Voice) | ✅ Done |
314+
| v5.3 | 3D Spatial Visualization (deck.gl + MapLibre) | ✅ Done |
315+
| v5.4 | Workflow Builder (Engine + Cron + Webhook) | ✅ Done |
316+
| v5.5 | Multi-Modal Data Fusion Engine MMFE (5 modalities, 10 strategies) | ✅ Done |
317+
| v5.6 | MGIM-Inspired Enhancements (fuzzy matching, unit conversion, multi-source) | ✅ Done |
318+
| v6.0 | Fusion Improvements (raster reprojection, point cloud, stream, quality) | ✅ Done |
319+
| v7.0 | Vector Embedding, LLM Strategy Routing, Knowledge Graph, Distributed Computing | **Current** |
320+
| v7.1 | MCP Management UI, WorkflowEditor Fix, User Analysis Perspective | Planned |
321+
| v7.5 | MCP Security + per-User Isolation, Custom Skill Bundle Composition | Planned |
322+
| v8.0 | DB-Driven Custom Skills, RAG Knowledge Base, DAG Workflow, Advanced Analytics | Future |
323+
| v9.0 | Real-time Collaboration, Edge Deployment, Data Connectors, Multi-Agent Parallel | Long-term |
325324

326325
## License
327326

0 commit comments

Comments
 (0)