乡镇人居环境整治考核的现场取证 → 集中评分 → 归档上报全过程：
巡查员下村拍照（微信/相机随手拍，文件名不规范、同一问题多张照片混在一起）
回到办公室分类归档：按"垃圾乱倒、旱厕、危房、违规棚舍、绿化缺失…"等几十项考核指标，把照片批量改名归类，一次几百张
按村记分：系统按各村标准自动统计扣分、排名，问题没对上模板的会标"未匹配"
生成考核文档：每村自动出一份 Word「人居环境整治实地考察问题清单」，照片原图内嵌、按两栏排版、带考察备注，供上报与存档
版本与权限管控：外出人员装的是旧版本？客户端启动自动补齐缺失组件并提示升级；账号绑定机器码，管理员审核后放行
本地分类任务 模板驱动按钮组，照片只改名不移动（保留现场目录结构）；"多个问题"自动复制副本供继续分类；无问题/证明材料/同一处/回头看自动归入子目录；村庄备注写入 info.txt；记住上次模板
智能记分 37 套计分模板（2162 条指标）；条目级 + 基准级两级封顶、比例回摊到每一行明细；计数计分/分数规则两种口径；小数扣分不丢精度；模板冲突自动识别并弹窗提示；明细列出"哪条指标几处、扣加几分"
一村一档文档生成 每村一份 .docx：标题居中、原图 嵌入文档（非链接）、一行两张 226.8×184.275 磅、考察备注取自 info.txt、文案自动"发现了几处XX"
报表导出 真 Excel（.xlsx）六张表：总表 / 类别扣分 / 类别问题数 / 标准扣分 / 标准问题数 / 行政村排名（自然村均值取整到两位）
服务端与管控 6 类业务表（用户/权限/模板/点位/机器码/发布版本）；机器码申请-审核绑定；九宫格工作台权限；登录失败防爆破锁定（5 次/60 秒 + 倒计时）
热更新与运行库 客户端版本与服务端发布版本自动对齐（防"装完仍提示更新"死循环）；上传 exe 时同目录组件按 MD5 差异增量同步；客户端启动登录前自动补齐缺失/版本不符的组件并校验 MD5；发布包 MD5 全链校验
系统原为易语言实现（TCP + INI/EDB 文件存储）。2026 年 10 月全量重写迁移到新架构
架构与关键技术
三层解耦：客户端（HTTP/JSON）→ 自建 API 服务（HP_HTTP/HPSocket）→ 数据库中间件（TCP）→ MySQL 8.0。
解决了旧版"库连接串写死在服务端、FastServer 的 MySQL 组件连不上现场8.x"的长期顽疾 —— 改用中间件执行 SQL，兼容 8.0.4。
计分引擎：把"指标 → 条目 → 基准"两级封顶抽象成 行最终分 单一口径，总表与分项表共用同一结果，杜绝同一次记分出现两套数字；封顶后按比例回摊到行，保证 明细 == 汇总 守恒。
SQL 注入面收口：确认 HTTP 进程内无参数化查询入口后，改为"值全部转义 + 标识符白名单枚举 + 统一转义助手收口"，杜绝各处手拼转义。
客户端自动补齐组件：热更新脚本只替换 exe 不换组件，因此组件判定从"文件存在且非空"升级为缺失或 MD5 不符即重下，并解决"组件清单被开发目录残留污染、所有客户端被迫下载 40MB 冗余文件"的问题。
质量验证闭环：建立"静态自检（7 条规则，秒级）→ 命令行真实编译（唯一权威）→ 产物校验"三道关卡。期间发现并修复 11 处错误、多个业务级静默丢数据缺陷（按名查列头不一致导致整列消失、汇总数组未分配长度导致报表恒为空）。
成果
旧易语言系统平稳下线，新系统成为唯一生产系统- 37 套计分模板、22 套点位数据（点位约 1.4 万行、拍照点约 1.5 万行）全部迁移托管
数百张量级照片的批量分类与自动评分，从"人工翻表核对"变为"打开即出结果"
评论