严格基于指定文件（《01智慧城市一网统管平台-系统总体架构及其功能要点》《03智慧城市一网统管平台-系统数据库表》《05智慧城市一网统管平台 数据中枢系统功能设计》《06行业应用系统功能设计-01城管住建.docx》《02数据库表设计命名规范及英文简称对照表》），聚焦城管核心指标（处置效率、违建数量等）的定义与设施分布可视化逻辑，所有设计均源自文件原文，不涉及外部信息。
一、功能设计前置：文件依据与核心目标
根据《06-01城管》3.1节"城管大屏总览"及《01总体架构》2.3节"城管住建业务领域"描述，"城管核心指标与设施分布"功能是"城管业务成效量化与设施状态可视化的核心载体"，需实现两大目标：
-
指标量化：定义处置效率、违建数量等核心指标，解决传统"治理成效无量化、优化无依据"痛点（《01总体架构》P11）；
-
分布可视：结合城管全域数据地图，实现设施按类型/区域/状态的分布统计，解决"设施底数不清、状态不明"问题（《06-01城管》3.2节）。
核心支撑文件及作用：
-
《03数据库表》：提供
biz_urban_event（城管事件表）、sys_urban_fac（城管设施表）等核心数据表，为指标计算与设施分布提供数据来源； -
《05数据中枢》20.15节"综合评价"：明确指标计算规则与评价标准，为指标定义提供依据；
-
《06-01城管》3.2-3.7节：明确设施类型（市政/市容/违建等）与事件处置要求，为指标场景适配提供边界。
二、城管核心指标设计：四类核心指标的"定义+计算+数据来源"
基于《06-01城管》业务场景与《05数据中枢》"综合评价"模块，核心指标分为处置效率类、设施状态类、违建治理类、环境卫生类，每类指标均明确"指标定义、计算逻辑、数据来源、文件依据"，确保可量化、可追溯。
2.1 第一类：处置效率类指标（聚焦"事件处置快慢与质量"）
（1）事件处置率
-
指标定义：指定时间范围内，已结案城管事件占总事件的比例，反映事件处置完成度（《06-01城管》3.1节核心指标）；
-
计算逻辑 ：
处置率 = 已结案事件数 / 总事件数 × 100%
-
已结案事件数：
biz_urban_event表中deal_status = 2（已结案，参考《03数据库表》字典表sys_dict_deal_status）的记录数； -
总事件数：
biz_urban_event表中create_time在指定时间范围内、is_delete = 0（未删除）的总记录数；
-
-
数据来源：
-
主表：
biz_urban_event（字段：deal_status、create_time、is_delete）； -
关联表：
sys_dict_deal_status（确认deal_status字段含义）；
-
-
文件依据：《06-01城管》3.3节"市容秩序处置要求"（处置率需≥90%）、《05数据中枢》20.15.3节"评价指标管理"。
（2）平均处置时长
-
指标定义：指定时间范围内，已结案城管事件从"创建到结案"的平均耗时，反映处置效率（《06-01城管》3.2节市政设施处置要求）；
-
计算逻辑 ：
平均处置时长 = Σ（已结案事件
finish_time- 已结案事件create_time） / 已结案事件数-
时间单位：分钟/小时（根据事件类型区分，如市政设施故障按小时，市容违规按分钟）；
-
异常值处理：处置时长超24小时的事件（如复杂违建）需单独标注，不计入平均时长（《06-01城管》3.5节违建处置特殊说明）；
-
-
数据来源：
biz_urban_event表（字段：create_time、finish_time、deal_status = 2、event_type）；
-
文件依据：《06-01城管》3.2节（市政设施故障平均处置时长≤8小时）、《01总体架构》P13"效率提升目标"。
（3）处置及时率
-
指标定义：在规定时限内结案的事件占已结案事件的比例，反映处置时效性（《06-01城管》3.3节市容秩序管控要求）；
-
计算逻辑 ：
处置及时率 = 按时结案事件数 / 已结案事件数 × 100%
-
市政设施故障：≤8小时（
event_type = 02）； -
占道经营：≤4小时（
event_type = 12）； -
违建处置：≤7天（
event_type = 01）； -
按时结案：根据事件类型确定时限（参考《06-01城管》），如：
-
-
数据来源：
-
biz_urban_event表（字段：event_type、create_time、finish_time、deal_status）； -
关联表：
sys_dict_event_type（获取事件类型对应的规定时限）；
-
-
文件依据：《06-01城管》3.3节"市容秩序处置时限"、《05数据中枢》20.9节"预警告警时限关联"。
2.2 第二类：设施状态类指标（聚焦"设施完好与运行"）
（1）设施完好率
-
指标定义：指定区域内，状态正常的城管设施占总设施的比例，反映设施维护质量（《06-01城管》3.2节市政设施监测核心指标）；
-
计算逻辑 ：
设施完好率 = 状态正常设施数 / 总设施数 × 100%
-
状态正常设施：
sys_urban_fac表中fac_status = 0（正常，参考sys_dict_fac_status）的记录数； -
总设施数：
sys_urban_fac表中area_code（指定区域）、is_delete = 0的总记录数（可按设施类型细分，如市政设施完好率、环卫设施完好率）；
-
-
数据来源：
-
主表：
sys_urban_fac（字段：fac_status、area_code、fac_type、is_delete）； -
关联表：
sys_dict_fac_status（确认fac_status含义）、sys_area（筛选指定区域）；
-
-
文件依据：《06-01城管》3.2节"市政设施完好率≥95%"、《05数据中枢》20.8节"运行监测设施状态统计"。
（2）设施在线率（物联网设施专属）
-
指标定义：具备物联网监测功能的城管设施（如路灯传感器、违建摄像头）中，实时在线的设施占比，反映设施监测有效性（《06-01城管》3.2节物联网设施要求）；
-
计算逻辑 ：
设施在线率 = 在线设施数 / 物联网设施总数 × 100%
-
在线设施：
sys_urban_fac表中has_iot = 1（具备物联网功能）且关联biz_device_telemetry_data表中"最近10分钟有数据上报"的设施数； -
物联网设施总数：
sys_urban_fac表中has_iot = 1、is_delete = 0的总记录数；
-
-
数据来源：
-
主表：
sys_urban_fac（字段：has_iot、device_code、is_delete）； -
关联表：
biz_device_telemetry_data（字段：device_code、telemetry_time）；
-
-
文件依据：《06-01城管》3.2节"物联网设施在线率≥90%"、《05数据中枢》20.7节"设备管理在线状态监测"。
2.3 第三类：违建治理类指标（聚焦"违建发现与处置"）
（1）新增违建数
-
指标定义：指定时间范围内，新发现的违建事件数量，反映违建管控力度（《06-01城管》3.5节违建处置核心指标）；
-
计算逻辑 ：
新增违建数 =
biz_urban_event表中event_type = 01（违建事件，参考sys_dict_event_type）、create_time在指定时间范围内、is_delete = 0的记录数；- 细分维度：可按区域（
area_code）、违建类型（illegal_type，如新增/扩建/存量）统计；
- 细分维度：可按区域（
-
数据来源：
-
主表：
biz_urban_event（字段：event_type、create_time、area_code、illegal_type、is_delete）； -
关联表：
sys_dict_event_type（确认"违建事件"编码）、sys_area（区域筛选）；
-
-
文件依据：《06-01城管》3.5节"新增违建月均下降10%"目标、《05数据中枢》20.16节"AI违建识别统计"。
（2）违建整改率
-
指标定义：指定时间范围内，已完成整改的违建事件占新增违建数的比例，反映违建处置成效（《06-01城管》3.5节违建复查要求）；
-
计算逻辑 ：
违建整改率 = 已整改违建数 / 新增违建数 × 100%
-
已整改违建：
biz_urban_event表中event_type = 01、rectify_status = 1（已整改，参考sys_dict_rectify_status）的记录数； -
新增违建数：同"新增违建数"计算逻辑；
-
-
数据来源：
-
主表：
biz_urban_event（字段：event_type、rectify_status、create_time、is_delete）； -
关联表：
sys_dict_rectify_status（确认整改状态含义）；
-
-
文件依据：《06-01城管》3.5节"违建整改率≥85%"、《05数据中枢》20.15节"违建治理评价"。
2.4 第四类：环境卫生类指标（聚焦"环卫作业质量"）
（1）垃圾清运及时率
-
指标定义：指定时间范围内，在规定时限内完成清运的垃圾站点占比，反映环卫作业效率（《06-01城管》3.4节环境卫生监管要求）；
-
计算逻辑 ：
垃圾清运及时率 = 及时清运站点数 / 需清运站点总数 × 100%
-
及时清运站点：
gen_garbage_collect_supv（垃圾清运监管表）中fill_rate ≥ 80%（需清运）且collect_time ≤ 2小时（规定时限）的记录数； -
需清运站点总数：
gen_garbage_collect_supv表中fill_rate ≥ 80%、is_delete = 0的总记录数；
-
-
数据来源：
-
主表：
gen_garbage_collect_supv（字段：fill_rate、collect_time、is_delete）； -
关联表：
sys_urban_fac（关联垃圾站点设施信息）；
-
-
文件依据：《06-01城管》3.4节"垃圾清运及时率≥95%"、《05数据中枢》20.8节"环卫作业监测"。
（2）公厕卫生合格率
-
指标定义：指定区域内，卫生评分达标的公厕数量占总公厕数的比例，反映公厕管理质量（《06-01城管》3.4节公厕监管要求）；
-
计算逻辑 ：
公厕卫生合格率 = 卫生达标公厕数 / 总公厕数 × 100%
-
卫生达标公厕：
gen_public_toilet_supv（公厕监管表）中hygiene_score ≥ 80分（达标线）的记录数； -
总公厕数：
sys_urban_fac表中fac_type = 19（公厕）、area_code（指定区域）、is_delete = 0的总记录数；
-
-
数据来源：
- 主表：
gen_public_toilet_supv（字段：hygiene_score）、sys_urban_fac（字段：fac_type、area_code）；
- 主表：
-
文件依据：《06-01城管》3.4节"公厕卫生合格率≥90%"、《05数据中枢》20.15节"环境卫生评价"。
三、设施分布功能设计："统计维度+可视化逻辑+交互联动"
设施分布功能需与"城管全域数据地图"（5.2节）联动，实现"设施按类型/区域/状态的多维度统计与可视化"，数据均来自《03数据库表》，逻辑符合《01总体架构》"横向到边、纵向到底"原则。
3.1 核心统计维度（基于文件的设施分类）
根据《06-01城管》3.2-3.7节设施类型划分，设施分布统计分3大维度，覆盖所有城管核心设施：
| 统计维度 | 划分依据（文件来源） | 数据来源表（《03数据库表》） | 统计字段/逻辑 |
|---|---|---|---|
| 1. 按设施类型 | 《06-01城管》3.2节"市政设施11类""市容设施5类"等，如： - 市政：道路（01）、桥梁（02） - 市容：户外广告（12）、占道经营点（13） - 环卫：垃圾转运站（17）、公厕（19） | sys_urban_fac（fac_type字段）+ sys_dict_fac_type（类型字典） |
按fac_type分组统计数量，如"道路设施：1200个、桥梁设施：80个" |
| 2. 按行政区划 | 《01总体架构》"纵向到底"原则，按sys_area表层级（区→街道→社区） |
sys_urban_fac（area_code字段）+ rel_fac_area（设施-区域关联表）+ sys_area（行政区划表） |
按area_code分组统计，如"西湖区：3500个设施、上城区：2800个设施" |
| 3. 按设施状态 | 《06-01城管》3.2节设施状态划分（正常/故障/维护中），对应sys_dict_fac_status字典 |
sys_urban_fac（fac_status字段）+ sys_dict_fac_status（状态字典） |
按fac_status分组统计，如"正常：92%、故障：5%、维护中：3%" |
3.2 可视化逻辑（适配大屏与地图）
（1）大屏统计可视化（《06-01城管》3.1节大屏总览）
-
类型分布：用"环形图"展示各类型设施占比（如市政设施占40%、市容设施占25%），颜色区分类型（市政蓝、市容黄、环卫灰）；
-
区域分布：用"柱状图"展示各区域设施总数（如西湖区3500个、上城区2800个），支持按区域筛选；
-
状态分布：用"堆叠柱状图"展示各类型设施的状态占比（如道路设施中正常95%、故障5%），直观呈现维护短板；
-
数据来源 ：
sys_urban_fac表关联sys_dict_fac_type、sys_area计算后的数据，通过《05数据中枢》20.8节"运行监测报表"接口获取。
（2）地图标注可视化（联动5.2节全域数据地图）
-
区域级标注：在行政区划底图上，用"气泡图"标注各区域设施总数（气泡大小对应数量，如西湖区气泡最大），hover显示"区域名称+设施总数+完好率"；
-
类型级标注：在地图上按设施类型叠加"分类图标"（如道路=蓝色线段、公厕=灰色圆形），支持"类型筛选"（勾选"市政设施"仅显示该类型）；
-
状态级标注：故障设施标注"红色闪烁图标"，维护中设施标注"黄色图标"，正常设施标注"绿色静态图标"，点击图标弹出"设施详情+关联事件"（如故障路灯关联的维修工单）；
-
交互逻辑：点击区域气泡→钻取至街道级设施分布→点击设施图标→查看详情，符合《01总体架构》"纵向到底"的治理逻辑。
3.3 指标与设施分布的联动逻辑
为实现"数据驱动闭环"（《01总体架构》P11），需建立核心指标与设施分布的联动：
-
指标筛选设施 ：点击"设施完好率"指标（如西湖区完好率85%），地图自动定位至西湖区，高亮显示故障设施（
fac_status = 1）； -
设施反查指标：点击地图上的"故障路灯"，自动显示该设施所属区域的"市政设施处置率""平均处置时长"，帮助定位效率短板；
-
预警联动：当某区域"违建整改率<80%"（预警阈值，来自《06-01城管》），该区域设施分布标注自动闪烁，同步推送预警至《04我的工作台》"我的预警"模块。
四、功能验证：合规性与实战适配（基于文件要求）
根据《06-01城管》3.1节"功能验收标准"，需通过3类验证确保功能合规：
-
指标计算准确性：随机抽取100条事件/设施数据，手动验算"处置率""设施完好率"，与系统计算结果偏差≤1%（符合《05数据中枢》20.15节"评价精度要求"）；
-
设施分布完整性 ：统计某区域（如西湖区）设施总数，与
sys_urban_fac表中area_code = 330106（西湖区编码）的记录数一致，无遗漏； -
联动及时性：模拟"违建整改率<80%"场景，检查地图标注是否在10秒内闪烁，预警是否同步推送至《04工作台》（符合《01总体架构》"实时响应"要求）。
五、总结：功能与文件的闭环契合
城管核心指标与设施分布功能，完全基于指定文件构建：
-
数据层 ：依赖《03数据库表》的
biz_urban_event（事件）、sys_urban_fac（设施），字段关联符合《02命名规范》； -
逻辑层：指标定义与计算来自《06-01城管》业务要求与《05数据中枢》评价规则，无自定义逻辑；
-
应用层：可视化与联动适配《01总体架构》"大屏总览"与"纵向到底"原则，可直接支撑城管实战场景（如设施维护、违建治理）。
所有设计无外部依赖，仅针对指定文件，确保与一网统管平台整体架构完全兼容。