# 采集地址 索引

> 版本：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_enabled：1(启用)/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) |

---