CncWebApi

Web API 路由和过滤器配置 在 Global.asax Application_Start 中调用

注册Web API配置

HTTP配置对象

告警中心控制器

构造函数

告警列表（分页） GET /api/admin/alert

告警统计 GET /api/admin/alert/statistics

处理单条告警 PUT /api/admin/alert/{id}/resolve

批量处理告警 POST /api/admin/alert/batch-resolve

登录认证控制器

构造函数

管理员登录 POST /api/admin/login

品牌模板控制器

构造函数

品牌列表 GET /api/admin/brand

品牌详情（含字段映射） GET /api/admin/brand/{id}

新增品牌 POST /api/admin/brand

编辑品牌 PUT /api/admin/brand/{id}

删除品牌 DELETE /api/admin/brand/{id}

复制品牌 POST /api/admin/brand/{id}/copy

启停品牌 PUT /api/admin/brand/{id}/toggle

标准字段列表 GET /api/admin/brand/standard-fields

采集地址控制器

构造函数

地址列表（分页） GET /api/admin/collect-address

地址详情 GET /api/admin/collect-address/{id}

新增地址 POST /api/admin/collect-address

编辑地址 PUT /api/admin/collect-address/{id}

删除地址 DELETE /api/admin/collect-address/{id}

批量删除采集地址 POST /api/admin/collect-address/batch-delete

启停地址 PUT /api/admin/collect-address/{id}/toggle

地址下关联机床列表 GET /api/admin/collect-address/{id}/machines

地址近期采集记录 GET /api/admin/collect-address/{id}/collect-records

地址最新原始JSON GET /api/admin/collect-address/{id}/raw-json

采集日志管理控制器

分页查询采集分析记录

获取采集分析详情

根据原始日志ID查询关联的分析记录

分页查询采集周期

查询原始采集日志

获取原始采集日志详情

仪表盘控制器

构造函数

8个统计卡片数据 GET /api/admin/dashboard/summary

车间平均单机产量 GET /api/admin/dashboard/workshop-production

机床产量排行 GET /api/admin/dashboard/machine-rank

工人产量排行 GET /api/admin/dashboard/worker-rank

产量趋势（近7天） GET /api/admin/dashboard/trend

机床状态分布 GET /api/admin/dashboard/machine-status-distribution

最新5条告警 GET /api/admin/dashboard/recent-alerts

NC程序产量排行TOP N GET /api/admin/dashboard/program-rank

NC程序产量分布（饼图数据） GET /api/admin/dashboard/program-distribution

采集服务状态 GET /api/admin/collector/status

启动采集服务（转发到CncCollector的5800端口） POST /api/admin/collector/start

停止采集服务 POST /api/admin/collector/stop

刷新采集服务配置 POST /api/admin/collector/refresh

手动触发日终汇总 POST /api/admin/collector/daily-summary

转发请求到采集服务

健康检查控制器 用于验证API服务是否正常运行

健康检查端点 GET /api/health

操作日志控制器

构造函数

系统运行日志（分页） GET /api/admin/log/system

产量修正日志（分页） GET /api/admin/log/adjustment

导出修正日志（占位，暂返回提示） GET /api/admin/log/adjustment/export

设备管理控制器

构造函数

机床列表（分页） GET /api/admin/machine

机床详情 GET /api/admin/machine/{id}

新增机床 POST /api/admin/machine

编辑机床 PUT /api/admin/machine/{id}

删除机床 DELETE /api/admin/machine/{id}

批量删除机床 POST /api/admin/machine/batch-delete

启停机床 PUT /api/admin/machine/{id}/toggle

机床实时采集状态 GET /api/admin/machine/{id}/status

机床今日产量明细 GET /api/admin/machine/{id}/production/today

机床7天产量趋势 GET /api/admin/machine/{id}/production/trend

机床近期采集记录 GET /api/admin/machine/{id}/collect-records

获取设备最新Tag数据（6个指标各带独立采集时间） GET /api/admin/machine/{id}/latest-tags

公共下拉选项控制器

构造函数

车间下拉 GET /api/admin/workshop/list

品牌下拉 GET /api/admin/brand/list

机床下拉 GET /api/admin/machine/list

工人下拉 GET /api/admin/worker/list

采集地址下拉 GET /api/admin/collect-address/list

产量报表控制器

构造函数

日产量列表（分页） GET /api/admin/production/daily

日汇总统计 GET /api/admin/production/daily-summary

修正产量 POST /api/admin/production/adjust

修正历史 GET /api/admin/production/{recordId}/adjustment-history

导出报表（占位，暂返回空结果） GET /api/admin/production/export

机床维度统计卡片 GET /api/admin/production/machine/summary

机床维度明细列表 GET /api/admin/production/machine/list

员工维度统计卡片 GET /api/admin/production/worker/summary

员工维度明细列表 GET /api/admin/production/worker/list

程序维度统计卡片 GET /api/admin/production/program/summary

程序维度明细列表 GET /api/admin/production/program/list

数据回放控制器

预览回放影响范围

执行回放

大屏配置控制器

构造函数

卡片配置列表 GET /api/admin/screen-config

编辑卡片 PUT /api/admin/screen-config/{id}

删除卡片 DELETE /api/admin/screen-config/{id}

启停卡片 PUT /api/admin/screen-config/{id}/toggle

筛选配置列表 GET /api/admin/screen-filter

新增筛选项 POST /api/admin/screen-filter

编辑筛选项 PUT /api/admin/screen-filter/{id}

删除筛选项 DELETE /api/admin/screen-filter/{id}

大屏看板控制器（无需认证）

构造函数

大屏汇总统计 GET /api/screen/summary

采集服务状态 GET /api/screen/collector-status

各车间产量 GET /api/screen/workshop-production

7天产量趋势 GET /api/screen/production-trend

机床产量排行 GET /api/screen/machine-rank

工人产量排行 GET /api/screen/worker-rank

机床状态总览 GET /api/screen/machine-status

大屏筛选条件 GET /api/screen/filters

刷新间隔配置 GET /api/screen/refresh-interval

系统设置控制器

构造函数

配置项列表 GET /api/admin/sys-config

编辑配置项 PUT /api/admin/sys-config/{id}

修改密码 POST /api/admin/change-password

车间列表 GET /api/admin/workshop

新增车间 POST /api/admin/workshop

编辑车间 PUT /api/admin/workshop/{id}

删除车间 DELETE /api/admin/workshop/{id}

启停车间 PUT /api/admin/workshop/{id}/toggle

模拟采集服务控制器。 将所有请求转发到 CncSimulator（localhost:9000网关 + 动态端口单地址）。

探测模拟器是否运行 GET /api/admin/simulator/ping

获取数据库采集地址列表 GET /api/admin/simulator/addresses

获取所有模拟状态汇总 GET /api/admin/simulator/status

启动指定地址的模拟 POST /api/admin/simulator/start

停止指定地址的模拟 POST /api/admin/simulator/stop

启动所有地址的模拟 POST /api/admin/simulator/start-all

停止所有地址的模拟 POST /api/admin/simulator/stop-all

重新加载数据库配置 POST /api/admin/simulator/reload

获取单地址状态 GET /api/admin/simulator/address/{port}/status

启动单地址数据模拟 POST /api/admin/simulator/address/{port}/start

停止单地址数据模拟 POST /api/admin/simulator/address/{port}/stop

触发设备事件 POST /api/admin/simulator/address/{port}/event

修改数据变化频率 POST /api/admin/simulator/address/{port}/interval

设置网络异常类型 POST /api/admin/simulator/address/{port}/network

切换剧本模式 POST /api/admin/simulator/address/{port}/mode

获取请求日志 GET /api/admin/simulator/address/{port}/logs

获取零件统计 GET /api/admin/simulator/address/{port}/stats

添加设备 POST /api/admin/simulator/address/{port}/add-device

移除设备 POST /api/admin/simulator/address/{port}/remove-device

获取事件历史 GET /api/admin/simulator/address/{port}/event-history

获取完整汇总 GET /api/admin/simulator/address/{port}/full-summary

获取异常日志 GET /api/admin/simulator/address/{port}/error-log

GET转发到网关（9000端口）

POST转发到网关（9000端口），透传请求体

GET转发到单地址（动态端口）

POST转发到单地址（动态端口），透传请求体

员工管理控制器

构造函数

工人列表（分页） GET /api/admin/worker

工人详情 GET /api/admin/worker/{id}

新增工人 POST /api/admin/worker

编辑工人 PUT /api/admin/worker/{id}

删除工人 DELETE /api/admin/worker/{id}

批量删除工人 POST /api/admin/worker/batch-delete

启停工人 PUT /api/admin/worker/{id}/toggle

绑定机床 POST /api/admin/worker/{id}/bind

解绑机床 POST /api/admin/worker/{id}/unbind

绑定机床列表 GET /api/admin/worker/{id}/machines

工人今日产量明细 GET /api/admin/worker/{id}/production/today

工人7天产量趋势 GET /api/admin/worker/{id}/production/trend

可绑定机床列表（未绑定其他工人的） GET /api/admin/worker/available-machines

绑定/解绑机床请求

机床ID

全局异常过滤器 统一捕获所有未处理异常，转换为标准ApiResponse格式 Controller层不需要 try-catch，异常会自动被此过滤器捕获

异常发生时自动调用

异常上下文

Web API 应用程序入口 IIS 启动时自动调用 Application_Start

应用启动时执行，注册路由和全局配置

SPA 路由回退：/admin/ 下的非文件请求重写到 index.html 用于支持前端 Vue Router 的 HTML5 History 模式

JWT 认证过滤器 验证请求 Header 中的 Bearer Token 管理 /api/admin/** 接口需要认证，大屏 /api/screen/** 不需要

简单的依赖注入解析器 手动注册 Repository 和 Service 的映射关系