devops-platform-web/AGENTS.md

@RTK.md

DevOps 运维平台前端 Agent 入口

项目规则

• 使用当前 Vue 3 + Vite + TypeScript 结构，不引入无关框架。
• 页面内容、计划文档和交付说明优先使用中文。
• UI 风格保持安静、工具型、信息密度合理的运维后台，不做营销页。
• 只在 devops-platform-web/** 内修改前端文件，不修改 devops-platform-api/** 和 devops-platform-docs/**。
• 改动可运行入口、目录或重要文件时，同步更新 README.md。

技术约束

• UI 组件优先使用 Element Plus。
• 状态管理使用 Pinia。
• 路由使用 Vue Router。
• 请求封装使用 Axios，并集中在 src/services/**。
• BPMN 展示使用 bpmn-js，不手写替代渲染器。
• mock 数据集中在 src/mocks/**，后续以后端 OpenAPI/Swagger 替换。

API 与安全边界

• 前端不得保存 Jenkins token、Gitea token、通知 webhook、LLM API key/baseURL/model。
• 前端不得直接调用 Jenkins、Gitea、企微、飞书或模型供应商；统一通过后端 API。
• API 契约以 /Users/mac033/Desktop/my-project/devops-platform-docs/devops-platform-implementation-tracker.md 和后端 OpenAPI 为准。

BPMN 与 Agent 边界

• BPMN 组件只展示流程图、节点状态和节点详情，不推进状态机。
• step.bpmnNodeId 必须与 BPMN XML 节点 id 一致。
• Agent 只能作为全局右侧抽屉工具存在，不作为独立侧边栏路由；能力只允许 DevOps 场景：发布风险摘要、失败诊断、Runbook 问答、发布说明草稿。
• 禁止在前端新增泛聊天入口。