管道检测视频判读报告软件产品系统Vibe Coding

城镇排水管网 CCTV 检测是管网普查、竣工验收与日常运维的法定环节，执行《CJJ 181-2012 城镇排水管道检测与评估技术规程》：检测单位先现场录制管道内窥视频，再由判读人员逐帧判读缺陷、评定管段等级，最终出具合规检测报告。实际作业中一个中等项目就有几十段视频、上百处缺陷，判读员要在视频播放器、规程评分表、图纸和 Word 报告之间反复切换：截图靠手工截取、等级靠翻表查、报告靠人工誊写，一份报告常需 1～2 天，还容易出现漏记、评分口径不一致、图文对不上等问题。本作品面向「视频判读—缺陷标注—等级评定—报告出具」这条链路，把它做成一条自动化流水线，让判读员在同一工作台上完成从原始视频到成品报告的全部动作。

软件为 Windows 桌面客户端，含九个功能模块：①工程管理——工程建档、工程/报告/缺陷编号自动生成与唯一性保障、进度与状态跟踪；②视频与管段管理——本地/移动硬盘/手机 MTP 导入、自动探帧与转码、管段属性与分组维护；③判读工作台——逐帧播放与倍速、缺陷框选/画线/文字标注、距离与长度标定、检查井录入与井缺陷登记；④截图与标注渲染——一键生成带标注截图并回写帧号，按标注指纹判断是否需要重绘；⑤地图可视化——缺陷与检查井按经纬度落到百度地图，支持坐标拾取与管线样式切换；⑥报告编制——参数确认、缺陷汇总、管段评估、照片挑选、导出五步向导，按 CJJ 181-2012 自动计算结构性/功能性缺陷等级与管段评估结论；⑦报告输出——内置国标及上海/广州/深圳/北京等地 Word 模板一键生成、HTML 在线预览、PDF 导出；⑧数据导入导出——工程包 .pcmproj 导出与导入、Excel/CSV/PDF 台账导出、分类备份与恢复、数据维护与孤立文件清理；⑨系统设置——字典与缺陷评分表维护、报告模板与报告图片质量、检测单位信息、用户与权限、授权激活。界面支持中文、英文、俄文。

技术架构：Electron 22 桌面壳 + Vue 3.4/TypeScript 前端（axios 直连本地服务）+ 自研 C# 服务 PCM.Server.exe（.NET Framework 4.6.2 / x86，SqlSugar + SQLite，HttpListener 仅绑 127.0.0.1，Bearer 令牌鉴权）+ 报告渲染库 PCM.Reporting（双引擎：OpenXML 生成 DOCX、HTML 渲染器出预览）+ SM2/SM4 国密授权模块，代码约 16 万行。前端按工程/判读/报告/地图/导入导出/统计/设置等 9 个业务模块组织；管段评估算法在前后端共用同一份 TypeScript 实现（前端计算、后端只渲染），保证预览与导出结果逐字一致。
关键难点与亮点：①大工程报告性能——800 处缺陷、约 2.6GB 原图曾导致 32 位服务进程内存溢出（报告预览直接 500 失败），通过「照片改走带宽度参数的缩略图 URL + 报告内嵌图归一化（默认最大边 1280px、JPEG 质量 85，带磁盘缓存可复用）」把报告生成从 334 秒降到 114 秒、DOCX 从 420MB 降到 50MB、预览从失败变为 1.3 秒打开；②视频处理——自研 HTTP Range 流式播放与 ffmpeg 抽帧、转码，支撑几十 GB 级项目素材；③数据一致性——缺陷编号全局唯一索引、导入导出冲突自动改号、管段「正常」状态与其它缺陷互斥双端校验、写库统一走服务端；④工程化——2800+ 自动化用例（前端 vitest 1522 例、后端 xUnit 1340 例）、中英俄三语界面与报告、兼容 Windows 7（锁定 Electron 22 与 net462/x86）、NSIS 中英文双安装包。