工程费用智能统计助手

01 / PROJECT OVERVIEW

让问题、实现与交付连成一条线

这次交付的核心不是“自动识别一切”，而是让零散的工程费用可录入、可保存、可对照凭证，并形成离开原软件也能查看的 Excel。

业务场景

装修工程材料与费用整理

当前交付

五列手工录入 Windows 版

技术探索

独立 OCR 辅助核对原型

设计重点

金额正确、保存可靠、凭证可携带

02 / BACKGROUND

项目背景

父亲从事装修工程承包，施工期间通过微信群保存材料采购的文字和图片。工程结束时，这些信息需要整理成费用明细和 Excel。

项目先探索了 OCR 与规则提取，也形成了以手工录入为主的独立交付入口。本案例将“实际交付的手工版”和“OCR 原型”分开，避免把两个入口合成一个不存在的自动化产品。

03 / MY ROLE

个人职责

根据父亲的工程材料记录需求开发工具，整理字段、复用已有思路并完善核对与导出流程。

• 根据工程费用整理需求确定表格字段和人工操作流程。
• 在 AI 辅助下迭代保存、校验、图片关联与导出，关注误操作和失败时的输入保留。
• 复用此前项目的输入—核对—输出思路，但按费用业务重新组织数据和交付方式。

项目在 AI 辅助下完成迭代。这里展示实际参与的需求、业务判断、实现与验收，不把辅助生成等同于独立精通。

MY DECISIONS / 个人贡献与取舍

我的取舍：先保留可核对的费用记录，再探索自动提取

父亲的工程材料记录散落在微信群文字和图片中。最终需要的不是一段识别文本，而是一份能说明费用从哪里来的清单。我围绕录入、保存、凭证关联和 Excel 输出整理需求，把交付范围优先放在可检查的人工流程上。

已交付手工版是序号、费用支出项目、金额、日期、备注五列，不具备独立的数量、单位和单价字段。金额经 Decimal 校验后转为整数分存储，费用读取带工程 ID，图片与费用关联，导出可内嵌来源图片。材料名称归一、数量×单价核对和自动分类不能写成手工版既有能力。

另有 OCR 辅助核对原型，探索图片文字、规则解析、分类和疑似重复提示。ManualEntry 打包入口明确排除 PaddleOCR，说明手工交付程序不依赖该原型。未来若整合，应先生成可编辑草稿并评估错误回退，再决定是否进入实际交付。

这次实践使我更重视标准化输入和来源可追踪。复用的是输入—核对—输出的思路；是否直接复用了哪一个模块、哪一版源码，仍需补齐版本对比，不把相似结构当成已经证明的代码复用。

依据：manual_store.py:6–34；expense_core.py:9–14；ManualEntry.spec:3；现有 manual_exporter 与原型审计。

04 / TECH STACK

技术选择，要能解释用途

Python + PySide6

五列表格、Tab 粘贴、Ctrl+S、延迟自动保存和图片操作。

SQLite + Decimal

按工程组织数据，金额校验后以整数分保存；事务控制批量写入。

openpyxl

五列费用明细、SUM 合计、数字格式和工作簿内部来源链接。

Pillow

验证并保留来源图片，计算 Excel 图片显示尺寸与行高。

PaddleOCR / PP-OCRv5

仅用于另一条 OCR 原型链路；手工版打包入口明确排除 OCR 依赖。

05 / SYSTEM ARCHITECTURE

系统架构

06 / CORE FEATURES

核心功能

07 / TECHNICAL CHALLENGES

技术难点：把业务例外放进设计

真实可用的费用工具需要先保证输入、保存和证据链。面对含糊的原始材料，保留人工判断比宣称全自动更重要。

• 不能让金额输入悄悄变成错误 ↓
• 用户正在编辑时，保存还没拿到新值 ↓
• Excel 离开软件后仍要看得懂 ↓
• 同价不是重复，识别结果也不是事实 ↓

08 / SOLUTIONS

解决方案

SOURCE EXCERPT

代码节选：从实现看取舍

这是手工保存复用的金额校验函数。它把金额处理落实为明确的输入约束，而不是依靠浮点数或界面格式来保证正确性。

def cents(value):
    try: d=Decimal(str(value).replace(',',''))
    except InvalidOperation: raise ValueError('金额格式无效')
    if not d.is_finite() or d<=0 or d>Decimal('999999999.99') or d*100!=(d*100).to_integral_value():
        raise ValueError('金额必须为正数，最多两位小数，且小于十亿元')
    return int(d*100)

DEVELOPMENT PROCESS

开发过程

按现有实现与版本资料整理阶段，不推断未经确认的具体开发日期。

1. 01

   围绕原始记录设计字段

   先明确需要交付的费用明细和凭证对应关系，保留不确定的日期原文，不推断缺失年份。

2. 02

   探索 OCR，再明确手工交付边界

   保留文字/图像解析原型，同时提供可直接编辑、核对和导出的手工版入口，不把原型包装成已集成能力。

3. 03

   打磨输入与最终文件

   完善活动编辑器提交、自动保存、失败保护、多图关联、迁移和内嵌图片 Excel 的结构与排版。

09 / TESTING & VALIDATION

测试与验收

当前仓库有手工存储、界面、导出、排版和原型规则等测试定义。历史报告同时记录了剪贴板复核及原生 Excel/WPS 尚未验收的限制。

• ↳

  保存、重开与工程隔离

  重开能读回保存值，日期原文保留；跨工程修改被拒绝。

  tests/test_manual.py:test_save_and_reopen / test_isolation
• ↳

  错误金额与草稿导出

  非法金额不改变旧数据；草稿可暂存，但正式导出缺项会被拦截。

  tests/test_manual.py:test_invalid_amount_rolls_back / test_draft_allowed_export_blocked
• ↳

  活动编辑器与失败保护

  Ctrl+S 读到编辑中的新值；自动保存和失败后输入保留有对应场景。

  tests/test_manual_ui.py:test_ctrl_s_commits_active_editor / test_failed_save_keeps_input_and_previous_data
• ↳

  图片真正在工作簿内

  合成图片检查费用行关联、来源页、xlsx 媒体结构及行高/居中偏移。

  tests/test_manual.py:test_images_embedded_and_associated · tests/test_manual_layout.py
• ↳

  迁移和失败文件清理

  重复迁移与删除后不复活；模拟导出错误不留下被误认为成品的文件。

  tests/test_manual.py:test_deleted_legacy_not_resurrected / test_failed_export_leaves_no_final_file

以上为业务项目源码中的验证设计与测试依据。本轮验证的是作品集网站，没有重新运行这些业务项目的完整测试，也没有对线上系统做操作。

11 / FUTURE IMPROVEMENTS

未来规划

以下是后续改进方向，不是已完成能力。

• 规划将 OCR 原型整理成可选“生成草稿”入口，先评估错误与回退再考虑集成。
• 规划按实际需求新增独立数量、单位、单价字段和数量×单价一致性提示。
• 规划改进材料名称归一化及分类规则，避免把自由文本视作标准材料库。
• 规划在干净 Windows 和原生 Excel/WPS 中补充打开、公式重算、排版和打印验收。

PROJECT GALLERY

项目截图与输出示例

真实手工版界面展示五列费用表、当前工程、来源图片区、保存/备份和 Excel 导出。空白金额不构成工程成果数据；数量、单价与 OCR 自动提取不属于这张界面的已交付功能。

已展示使用者提供的真实界面。脱敏报表和更多业务场景待补充；不以空数据截图证明识别准确率、运营规模或完整验收。