You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
haoliang-net/docs/02-功能清单/管理后台/05-采集地址/00-采集地址-索引.md

53 lines
2.3 KiB
Markdown

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 采集地址 索引
> 版本v1.0
> 最后更新2026-04-25
---
## 模块概述
管理HTTP采集地址每个地址关联品牌和机床列表。地址数量少列表无分页无筛选。新增/编辑通过弹窗完成弹窗内含品牌联动加载机床的checkbox选择区域。支持查看采集地址详情关联机床+采集历史+原始JSON
## 页面清单
| 页面编号 | 页面名称 | 路由 | 功能概述 |
|---------|---------|------|---------|
| 05-01 | 采集地址页面 | /collect-address | 采集地址列表+新增/编辑弹窗+启停 |
| 05-02 | 采集地址详情页面 | /collect-address/:id | 基本信息+关联机床+采集记录+原始JSON查看 |
## 页面功能详情
### 05-01 采集地址页面
**路由**`/collect-address`
**功能概述**采集地址列表显示URL/品牌/间隔/状态/上次采集/连续失败,新增/编辑/启停操作
**功能列表**
| 功能编号 | 功能名称 | 触发条件 | 交互行为 | 涉及API |
|---------|---------|---------|---------|---------|
| F01 | 加载地址列表 | 页面挂载 | 请求列表API | GET /api/admin/collect-address |
| F02 | 新增地址 | 点击新增 | 弹窗->选品牌(加载机床)->勾选机床->保存 | POST /api/admin/collect-address |
| F03 | 编辑地址 | 点击编辑 | 弹窗(回填+已选机床)->修改->保存 | PUT /api/admin/collect-address/{id} |
| F04 | 启停地址 | 点击启用/停用 | 确认->切换 | PUT /api/admin/collect-address/{id}/toggle |
**状态机**采集地址is_enabled1(启用)/0(停用)
**路由跳转**
- 地址名称链接 -> 采集地址详情页(/collect-address/:id)
### 05-02 采集地址详情页面
**路由**`/collect-address/:id`
**功能概述**:查看采集地址基本信息、关联机床列表、最近采集记录(含成功/失败/耗时、查看原始JSON入口、采集失败趋势图
**路由跳转**
- 机床名称 -> 设备详情页(/machine/:id)
## 子目录/文件
| 编号 | 名称 | 类型 | 索引 |
|------|------|------|------|
| 05-01 | 采集地址页面 | 页面文件 | [05-01-采集地址页面.md](./05-01-采集地址页面.md) |
| 05-02 | 采集地址详情页面 | 页面文件 | [05-02-采集地址详情页面.md](./05-02-采集地址详情页面.md) |
---