从零打造防水修缮行业ERP：三端一体 + AI贯穿全系统

本文以防水、堵漏、修缮、保温防渗工程行业为业务蓝本，从零实现一套三端一体防水修缮ERP系统：PC管理后台、员工移动端、客户移动端。覆盖现场勘察、修缮方案、报价合同、派工施工、材料进销存、财务结算、质保售后全流程，40+张数据库表、80+个REST接口、10个业务模块AI智能介入全部落地可用，并已完成云上部署。

---

一、项目背景：防水修缮行业的核心痛点

防水修缮不同于通用进销存 ERP，它的业务有很强的行业特殊性：

• 项目零散：屋面、外墙、地下室、厨卫各种渗漏，项目台账混乱
• 方案无存档：每次修缮都是"打补丁"，没有标准化方案可复用
• 材料库存不准：防水涂料、卷材、堵漏材料保质期短、损耗大，库存经常对不上
• 施工无管控：工序偷工减料、材料以次充好，渗漏反复返工
• 质保售后无追溯：质保期多长？谁修的？用什么材料？修完就失联
• 成本核算模糊：材料+人工+杂费怎么算？这个项目到底赚不赚钱？
• 对账结算繁琐：甲方多、节点多（预付款/进度款/尾款/质保金），催收靠人肉

这套系统就是要把这些行业痛点一次解决。

二、总体架构：一套后端，三端跑

┌──────────────┐  ┌──────────────┐  ┌──────────────┐
│  PC管理后台    │  │  员工移动端    │  │  客户移动端    │
│  玻璃拟态深蓝  │  │  深色手机模型  │  │  浅色手机模型  │
└──────┬───────┘  └──────┬───────┘  └──────┬───────┘
       └─────────────────┼─────────────────┘
                         │ 同一套 REST API（JWT鉴权 + 角色隔离）
               ┌─────────┴─────────┐
               │   Express 路由层    │
               │  通用CRUD引擎+业务流 │
               ├───────────────────┤
               │  sql.js(SQLite/WASM)│ ← 零安装单文件数据库
               │  内存库+定时落盘     │
               └───────────────────┘

三端各自独立前端，共用一个后端和数据库，数据天然互通。客户端在手机上报修漏水，管理员在 PC 后台立即收到消息通知，派工后员工端收到任务，进度实时同步回客户端——形成完整业务闭环。

三、技术选型：为什么是 Node.js + SQLite

3.1 后端：Node.js + Express

• 生态成熟：Express 是最流行的 Node 框架，中间件丰富
• 前后端同语言：一套 JavaScript 全栈，开发效率高
• 轻量高性能：单进程事件驱动，适配中小企业的低并发
• 部署简单：node server.js 一条命令启动，无编译打包

3.2 数据库：sql.js（SQLite 编译进 WebAssembly）

这是最关键的选型决策。为什么用 SQLite 而不是 MySQL/PostgreSQL？

维度	SQLite	MySQL/PostgreSQL
安装运维	零安装零运维，单文件	需要安装服务、配置、备份
并发	单写多读，WAL 下毫秒写入	高并发强
备份	单文件拷走即备份	需要 mysqldump
部署成本	无额外进程	独立数据库服务

防水修缮公司是中小团队（3-5人同时操作），SQLite 的并发完全够用。WAL 模式下写入毫秒级完成，零安装零运维，单文件备份——对中小企业是最优解而非临时方案。将来要切 PostgreSQL，改一行 DATABASE_URL 即可，业务代码零改动。

3.3 认证：JWT + pbkdf2

• JWT：无状态 token，三端共用，Bearer token 鉴权
• pbkdf2：密码哈希（10万次迭代），安全存库
• 角色隔离：管理员/销售/设计师/施工队长/采购/财务/客户，后端强制数据隔离（客户只能看自己的项目/报修/质保）

四、数据库设计：40+张表覆盖全流程

按防水修缮行业六大主线设计：

① 客户项目管理  → projects / surveys / contracts
② 修缮方案设计  → schemes / scheme_materials / scheme_standards
③ 材料进销存    → materials / purchases / stock_io / stock_checks
④ 施工现场管控  → processes / workhours / rectifications / acceptances
⑤ 财务结算      → quotes / receipts / payments / project_costs / expenses
⑥ 质保售后      → warranties / repairs / visits

行业专属字典：渗漏病害类型（屋面渗水/外墙裂缝/地下室潮渗/管口渗漏/伸缩缝漏水）、施工部位、修缮工艺、防水材料类型。这些是防水行业特有的基础数据。

五、核心功能模块

5.1 现场勘察 → 报价 → 合同 → 派工 全流程闭环

系统把行业标准业务流数字化：

客户咨询 → 现场勘察（病害诊断+拍照+三套方案）
  → 修缮方案设计（材料构成+综合单价核算）
  → 报价（材料价+人辅管费+税金3.59%+利润10%）
  → 合同签订 → 派工施工 → 闭水试验 → 验收 → 收款 → 质保

5.2 专业报价体系（参考农发行模板）

防水行业报价核心公式：

综合单价 = 材料价 + 人辅管费 + 税金(3.59%) + 利润(10%)

系统内置 60+ 种真实防水材料的4级价格（对外报价/零星价/经销价/底价），5 套专业施工方案（非固化+SBS、涂卷结合、三道设防等），选方案+输入面积自动核算总价，含辅助工程项（铲除旧层/裂缝注浆/保护层/垃圾清运）和毛利分析。

5.3 费用/成本/利润完整分析（参考千年虫财务系统）

经营报表不是空洞的数字，而是完整的财务分析：

• 财务健康度评分：基于净利率/毛利率/成本占比/回款率多维评分
• 收入/成本/利润趋势：月度柱+线组合图
• 费用构成：管理费用/销售费用/财务费用燃尽图
• 帕累托图：成本构成（材料/人工/其他）+累计占比
• 单项目利润表：每个项目合同额/成本/已收/利润/利润率

六、AI 智能决策：贯穿整个系统

这不是"AI 驾驶舱"一个页面，而是 AI 贯穿 10 个核心业务模块：

模块	AI 介入内容
现场勘察	AI 诊断 + 高风险病害（地下室/伸缩缝）识别
报价管理	报价转化率评分 + 待确认报价跟进提醒
修缮方案	方案覆盖度 + 屋面方案性价比优选
项目台账	项目健康度 + 施工超期预警
材料库存	库存告急 + 采购补料建议
客户管理	客户结构 + 欠款风险
施工工序	工序完成率 + 进度推进建议
工程验收	验收合格率 + 闭水试验规范判定
质保台账	质保到期预警
售后返修	返修主因分析（材料/施工/基层/外力）

每个模块页面顶部都有 AI 智能分析卡片，带健康度评分 + 等级标签 + 带优先级的智能建议。

七、移动端：站在客户角度设计

7.1 客户移动端（漏水报修是核心）

站在客户角度，客户能想到的都有：

• 漏水报修：选择漏水部位（屋顶/外墙/卫生间...9种）、描述漏水情况、上传漏水图片（最多6张）、选紧急程度、填联系电话
• 报修记录：进度查询、状态跟踪、原因判定、处理结果
• 在线付款：待付工程款、项目收款进度条、付款记录
• AI 智能客服：漏水咨询问答（"屋顶漏水怎么办""卫生间渗水原因"）
• 质保查询：查看名下项目质保信息

7.2 员工移动端

• 工作台：KPI 统计、我关注的项目
• 施工任务：项目明细、状态推进、登记工序、记工时
• 施工留痕：拍照记录施工过程，杜绝偷工减料
• AI 助手：业务智能查询

7.3 三端消息互通

客户端报修 → 自动通知管理员 → 管理员派工发消息给客户 → 客户端实时收到

每个端都有消息铃铛 + 未读数红点 + 消息中心，8秒轮询 + SSE 实时推送。

八、数据可视化：甘特图 + 折线柱状图 + 数字标注

图表设计参考千年虫财务系统，弃用大饼图，改用：

• 甘特图：项目施工进度（各项目时间轴进度条 + 完成率数字）
• 折线/柱状组合图：收入/成本/利润趋势
• 帕累托图：成本构成 + 累计占比
• 燃尽图：费用累计消耗 vs 剩余额度
• 所有图表都带数字标注，不做"看不懂"的纯图形

九、云上部署

已通过腾讯云 Lighthouse 部署到 111.229.25.16，nginx 反向代理 /fangshui/ 到 3010 端口，systemd 服务自启：

PC管理后台: https://www.y2ksoft.cn/fangshui/admin/
员工移动端: https://www.y2ksoft.cn/fangshui/app/
客户移动端: https://www.y2ksoft.cn/fangshui/wx/

部署后修复了一个关键问题：前端 API 路径在子目录下会丢失前缀，通过 API_BASE 动态判断解决。

十、系统完整度评估

维度	完整度
业务模块	10大模块全覆盖（基础档案/勘察/方案/报价/合同/派工/施工/材料/财务/质保/报表）
数据库	40+张表，行业专属字典，完整种子数据
三端	PC后台 + 员工移动端 + 客户移动端
AI	全局驾驶舱 + 10模块AI介入 + 问答 + 报价估算 + 风险模型
消息	三端实时消息互通
图表	甘特图/折线/柱状/帕累托/燃尽图，全数字标注
部署	云上部署完成，systemd自启

十一、技术优点总结

1. 零安装零运维：SQLite 单文件数据库，node server.js 即可运行，中小企业零门槛
2. 开发效率高：通用 CRUD 引擎，40+ 模块一套代码；前后端同语言
3. 三端一体：一个后端三端前端，数据天然共享，业务闭环完整
4. AI 贯穿全系统：不是噱头，每个业务模块都有可落地的智能建议
5. 行业深度：防水修缮行业专属方案库、材料体系、病害字典、质保流程
6. 部署简单：Lighthouse 一键上传 + systemd 自启，环境要求极低

十二、局限与展望

• 并发上限：SQLite 适合中小团队（3-5人），大规模并发需切换 PostgreSQL（改一行配置）
• AI 是规则引擎：当前 AI 是基于业务规则的智能建议，非大模型；未来可接入大模型实现更智能的渗漏诊断
• 照片本地存储：漏水图片 base64 存库，量大后可接对象存储（OSS）

完整代码已在私有仓库，欢迎交流防水修缮行业数字化解决方案。