# 平台架构
谷雨G2rain智能体平台通过智能体与知识服务连接模型和业务工具，并以企业身份、权限、微服务和微前端承载实际应用。
智能体执行、知识状态、模型访问、工具代理与企业业务各有责任服务，配置与任务记录由对应模块管理。
从工程形态看，平台以后端 Java 微服务承载平台核心与业务域，以 Vue3 微前端承载主壳和业务子应用；从治理形态看，应用、功能权限、业务能力、多租户和审计共同决定一次访问或交付的边界。
# 架构分层
# 智能体、知识与工具协作层
这一层直接承载智能体场景：Runtime 组织执行，Studio 提供 Agent 和 Skill 资料，Agent App 展示配置与执行记录，Model Nexus 接入模型，MCP Registry 组织工具发现和调用。知识服务维护文件、FAQ、审核发布和活动版本，向问答或智能体提供检索证据。
智能体通过业务接口获取知识和调用工具，用户身份、组织上下文及数据权限仍由入口与领域服务校验。完整业务集成须结合具体部署核对；知识证据是内容依据，能力绑定是执行配置，两者各有职责。
代表模块：g2rain-agent-runtime、g2rain-agent-studio、g2rain-agent-app、g2rain-model-nexus、g2rain-mcp-registry、g2rain-knowledge。
# 边缘入口层
边缘入口层负责平台统一入口能力，当前以网关能力为核心。
这一层主要解决：
- 平台统一访问入口
- 请求路由与入口控制
- 与身份认证链路的前置协同
对应代表模块：
g2rain-gateway-webfluxg2rain-gateway-webmvc
# 交互接入层
交互接入层负责前端应用接入、应用身份协同与交互链路承载。
这一层强调“真正的应用化”能力，即每个应用具备独立身份，并通过平台统一管理应用信息、公钥与接入边界。
这一层主要解决：
- 前端主壳与子应用协同
- 应用独立身份管理
- 前端与 API 接口的统一安全链路
- OpenResty + Lua 与平台身份体系协同
对应代表模块：
g2rain-main-shellg2rain-manager-appg2rain-infra-appg2rain-cms-appg2rain-department-appg2rain-knowledge-app
# 平台核心层
平台核心层为企业智能体应用提供身份、权限、应用与公共运行能力，也是多租户场景的治理基础。
这一层主要解决：
- 统一认证与 IAM
- 应用管理、角色管理、资源管理
- 功能权限与业务能力管理
- 审计、安全、网关协同
- 应用开通与能力交付控制
- AI 平台基础能力承载
对应代表模块：
g2rain-basisg2rain-iamg2rain-infra
# 业务域扩展层
业务域扩展层负责围绕具体业务场景扩展平台能力，并支持根据不同场景组合业务领域接口，独立提供子应用。
这一层强调：
- 基于 DDD 的业务域拆分
- 业务能力与平台核心能力解耦
- 业务域前后端协同扩展
对应代表模块：
g2rain-cmsg2rain-departmentg2rain-knowledge
# 工程支撑层
工程支撑层负责为平台核心层与业务域扩展层提供统一的工程化、代码生成与部署交付能力。
这一层主要解决：
- 公共库与基础能力复用
- Starter 与持久化扩展
- 代码生成与工程模板
- 应用初始化与前端模板
- 部署交付与持续更新
对应代表模块：
g2rain-commong2rain-spring-boot-starterg2rain-mybatis-extensionsg2rain-generator-maven-pluging2rain-crafterg2rain-app-clig2rain-app-templateg2rain-deploy
# 关键架构关系
# 功能权限、应用与业务能力
- 功能权限是平台侧最小控制单元
- 应用是功能权限和业务能力的承载单元
- 业务能力可聚合为租户侧最小交付单元
# 应用化接入
平台支持每个应用具备独立身份。
应用在平台中维护应用信息，并注册公钥；应用自身保存私钥，并在需要为客户构建 Token 时参与签名。对于前端应用，平台通过 OpenResty + Lua 脚本协同实现私钥使用与身份链路打通。
# 智能体任务与业务能力
DDD 接口提供明确的业务动作，知识服务提供证据，模型参与理解与生成，工具承接已授权的业务操作，Runtime 组织任务执行与结果返回。企业专属流程、外部工具和授权传递按目标场景联调，具体组成见Agent 模块导览。