43 lines
1.7 KiB
Markdown
43 lines
1.7 KiB
Markdown
# 前端协作指南
|
||
|
||
## Local Purpose
|
||
|
||
本目录维护简体中文 Angular 网页，包括设备与任务操作、模型配置、报告、批量导入和历史检索。
|
||
|
||
## Inherits
|
||
|
||
继承仓库根目录 AGENTS.md；本文件仅补充前端规则，当前用户指令优先。
|
||
|
||
## Local Commands
|
||
|
||
在本目录执行，包管理器使用 npm 和现有 package-lock.json：
|
||
|
||
```sh
|
||
npm ci
|
||
npm start
|
||
```
|
||
|
||
完成前端改动后执行以下检查；无头测试需要已安装 Chrome：
|
||
|
||
```sh
|
||
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；提交源码及必要锁文件。源码包不携带编译后的网页。
|