Artemis-Eapil/apps/showcase_ui/AGENTS.md

前端协作指南

Local Purpose

本目录维护简体中文 Angular 网页，包括设备与任务操作、模型配置、报告、批量导入和历史检索。

Inherits

继承仓库根目录 AGENTS.md；本文件仅补充前端规则，当前用户指令优先。

Local Commands

在本目录执行，包管理器使用 npm 和现有 package-lock.json：

npm ci
npm start

完成前端改动后执行以下检查；无头测试需要已安装 Chrome：

npm test -- --watch=false --browsers=ChromeHeadless
npm run build

开发服务器通过 proxy.conf.json 连接本地后端；需要联调时同时启动根目录的网页服务。

Local Conventions

• 页面组件在 src/app/components，服务在 src/app/services；先复用已有组件、样式及 API 服务。
• 保持现有简体中文文案、颜色、间距和控件样式，菜单、弹窗和表单必须清晰可读。
• 修改任务或配置交互时覆盖加载、保存、失败和空状态；不要将执行中误标成录屏中或把完成误标成验证通过。
• 使用相邻的 .spec.ts 测试交互和请求数据；不要只测试实现细节。
• 后端字段调整需同时核对类型、请求和响应；设备序列号、报告格式、批次编号等不能在前端猜测。
• UI 有明显变化时在浏览器验证实际布局和关键操作，构建通过不能代替可读性检查。

Local Risks

• 不读取或展示已保存密钥；模型配置的空密钥表示保留原值，测试连接与保存配置保持分离。
• 不为查看历史而启动真实任务，不自动重试业务用例，不恢复已移除的设备动作回放。
• 不编辑 dist 或 node_modules；提交源码及必要锁文件。源码包不携带编译后的网页。