haoliang-net/docs/02-功能清单/管理后台/05-采集地址/00-采集地址-索引.md

采集地址 索引

版本：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-02	采集地址详情页面	页面文件	05-02-采集地址详情页面.md

---