装修有数 · 业主装修核对与施工管理助手产品系统Vibe Coding

装修行业报价水分大、口头承诺多，业主普遍面临"看不懂报价、记不住约定、算不清付款"的痛点：装修公司在报价单、合同附件、施工变更中层层加码，业主缺乏工具逐条核对，容易超支且维权无据。本项目立足家庭装修这一高频大额消费场景，为业主提供一套从报价核对、合同锁定、施工记录到付款结算的数字化管理工具，让"每笔钱有依据，每项施工有记录"，填补业主侧装修过程管理的空白。

项目包含九大功能模块：①首页总览，汇总预算、已付净额、到期应付、待确认增减项与延期/待验收问题；②房屋档案，管理房屋信息、分类预算、空间与联系人；③报价核对，支持多版本管理、原件留存、手工录入与 Excel 模板导入，行金额自动核对合计，疑问逐条闭环，并可做版本差异比较；④合同管理，档案留存、锁定报价基准（锁定后只读）、付款节点设置与合计校验；⑤施工台账，原计划/确认计划/实际日期分开记录，自动标记开工与完工延误，支持日志、照片并关联报价条目；⑥增减项管理，坚持"先确认后施工"，待确认与约定金额隔离，已确认不可篡改；⑦材料管理，约定与实际品牌型号数量对照、到货检查与替换说明；⑧验收整改，检查项登记、问题→整改→复验→通过才关闭的状态机；⑨付款与结算，付款/退款凭证管理、分配到节点并超付提示，固定总价不改价、按实结算生成差额。此外提供 Excel 报表导出与完整数据备份（数据库+附件 zip）。

我负责从需求分析、数据模型设计到前后端实现的全部开发工作。技术栈为 Python + FastAPI + SQLAlchemy + SQLite + Jinja2 + Tailwind CSS，采用单体无状态架构，手机与电脑响应式一套模板。实现亮点与难点：1）金额全程以"分"（整数）存储避免浮点误差，页面层格式化展示；2）核心业务规则（约定金额、节点余额、延期判定、结算差额、净付款）抽离为独立的 rules 服务层，配 20+ 规则场景单元测试；3）报价、增减项等关键数据设计状态机（如已确认不可改、更正走关联记录），从模型层保证账目不可篡改；4）生产化加固：可选密码登录（hmac 签名 Cookie 会话）、安全响应头、上传类型与大小限制、404/500 友好错误页、WCAG AA 对比度与键盘可达性；5）openpyxl 实现 Excel 模板导入与多报表导出、完整备份打包；6）配独立临时库的回归测试覆盖认证、上传、状态机与退款流程，共约 3300 行代码、440 行测试。