From fe30bcf52c8b6cb7da87599d45ed327c6abce03f Mon Sep 17 00:00:00 2001 From: Huawei Date: Thu, 16 Jul 2026 02:53:14 +0000 Subject: [PATCH] fix: correct backend module descriptions - workflow.py does not execute nodes, param_resolver uses params_mapping --- suites-help/系统使用手册/平台架构文档.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/suites-help/系统使用手册/平台架构文档.md b/suites-help/系统使用手册/平台架构文档.md index d28fbb0..b00a102 100644 --- a/suites-help/系统使用手册/平台架构文档.md +++ b/suites-help/系统使用手册/平台架构文档.md @@ -143,12 +143,14 @@ suite_file_type_mappings — 文件类型映射 | 模块 | 文件 | 功能 | |------|------|------| -| Workflow 引擎 | `services/workflow.py` | DAG 拓扑排序，`$steps.xxx.yyy` / `$inputs.xxx` 参数解析，节点执行 | -| 合规检测 | `services/compliance.py` + `routers/compliance.py` | 仅基础格式检查（params_schema/steps/exists），无代码安全审计 | -| 参数解析 | `services/param_resolver.py` | 参数引用解析（`$steps.xxx` / `$inputs.xxx`） | -| ~~任务队列~~ | ~~`services/queue.py`~~ | **已废弃** — 仅存内存空壳字典，无实际功能 | -| 角色守卫 | `services/role_guard.py` | 角色权限控制 | -| 认证守卫 | `auth_guard.py` | JWT / API Key 认证中间件 | +| 模块 | 文件 | 实际功能 | +|------|------|---------| +| Workflow 引擎 | `services/workflow.py` | DAG 拓扑排序 + `$inputs.xxx` / `$steps.xxx.yyy` 参数引用解析。**不执行节点**，仅套件发布时预处理用，实际执行在 GIS Actions 本地完成| +| 参数解析 | `services/param_resolver.py` | 根据 `params_mapping` 解析 `$inputs.xxx` / `$steps.xxx.yyy` 引用，用于任务下发前预处理 | +| 合规检测 | `services/compliance.py` + `routers/compliance.py` | `POST /api/v1/compliance/check` — 仅基础格式检查（params_schema 有无 properties、steps 有无、type 合法性），**不扫代码、不验引用** | +| ~~任务队列~~ | ~~`services/queue.py`~~ | **已废弃** — 仅存内存空壳字典（`_tasks: dict = {}`），无实际功能 | +| 角色守卫 | `services/role_guard.py` | 角色等级校验（user → developer → admin），支持 JWT roles 回退 | +| 认证守卫 | `auth_guard.py` | JWT / API Key 统一认证中间件 | **关于 Skills 层：** 架构文档中规划的独立 Skills 微服务已被移除。旧表 `suite_skills` 和 `scripts` 已在迁移中删除。技能注册在发布流程中自动完成，不独立暴露 API。