简一智能体项目产品系统Vibe Coding

建材工程渠道（瓷砖/工程项目销售）存在项目周期长、单据类型多、线下台账与财务票据并行的特点。销售侧需完成区域报备、合同履约、备货发货；财务侧需管理增值税电子发票、银行回款回执及冲返结算，信息分散在 Excel、PDF、截图中，人工录入易错、对账效率低。为此建设企业 CRM 后台，在标准客户/合同/审批能力之上，补齐发票管理、备货台账、冲返发票、报备通知函等行业模块，打通「报备—备货—开票—回款—冲返」数据链路，降低重复录入与票据核对成本，支撑多项目、多批次、多主体协同管理。

系统包含客户/联系人、线索商机、合同回款、审批流等经典 CRM 模块，并扩展四类行业能力：①发票管理：PDF 电子发票解析建账、手动录入、按项目查询与报表导出；回款回执 OCR 预览与多笔明细提交、删除后自动汇总主表。②备货管理：台账 Excel 导入导出、三键判重（报备编号+入库单号+产品编码）、金额/冲返差额规则计算。③冲返发票：基于备货行批量开票、发票 PDF 识别预览、发票号唯一校验。④报备通知函：通知函图片 OCR 预览、工程地址等字段维护、分页筛选与 Excel 导出。另含订单模板、文件附件、操作日志等配套能力，统一通过管理端 REST API 对外服务。

我负责：发票管理、备货台账、冲返发票、报备通知函等 CRM 子域后端接口设计与实现；OpenAPI/Apifox 文档维护；核心 Parser/OCR 规则与单测编写。

技术栈与架构：Java 17 + Spring Boot 3 多模块 Maven；Controller–Service–Mapper 分层；MyBatis-Plus + MySQL；Redis 缓存；infra 文件服务存附件；PDFBox 解析电子发票、Tesseract OCR 识别回执/报备函；EasyExcel/POI 处理导出与复杂台账导入；统一 CommonResult 与 /admin-api 前缀。

亮点与难点：采用「OCR/解析预览与提交分离」，避免重复识别并支持人工纠错；备货导入针对 WPS 表头错位用 POI 自动定位表头行；回款多明细子表增删后重算主表汇总；冲返批量开票事务内刷新 update_time、发票号唯一校验。难点在于版式不一的 PDF/截图识别准确率与性能（如 remittance-submit 含大附件上传时耗在 FileApi 存储），需前端预览+手填兜底并优化上传链路。