1、立项原因：本地电脑维修、打印机外保，以及小微企业与门店的 IT 运维，长期处在"微信群接单 + 电话催单 + 纸质单据"的原始状态：客户报修只有一句话描述，师傅上门前拿不到故障详情与设备信息；报价、维修进度、取件时间全靠人工记忆，客户只能反复打电话问"修到哪一步了"；服务商自己也沉淀不下客户与设备档案，回款与工作量统计全靠 Excel 手抄。
2、项目背景：随着小微商户数字化和"上门服务"需求增长，谁能把这条链路线上化、可查询、可追溯，谁就能把一次性维修做成长期运维服务。本项目面向这一典型场景，为 2–5 人的小型运维/维修团队提供一套低成本、零外部数据库依赖、三端（官网 / 管理后台 / 微信小程序）打通的工单与运维管理系统。
系统分四层。
① 客户端：微信小程序 + 官网在线报修，客户填写设备类型、故障现象、照片与联系方式即可拿到工单号，凭单号随时自助查询进度；小程序用 openid 静默登录（code2Session），无需注册即可自动归集"我的报修"。
② 工单流转：待确认 → 已确认 → 已报价 → 维修中 → 待取件 → 已完成 / 已取消 共七态流转，支持报价、实收、维修备注、完工时间与图片附件。
③ 管理后台（智微助手）：RuoYi 风格布局 + RBAC 角色分级（查看 / 编辑 / 超管）+ 菜单树数据库化，含工单看板（7 日趋势与状态分布图表）、咨询（线索）管理、客户列表、商品与服务目录、订单与发票、用户与角色、登录日志、密码策略、公众号菜单配置、AI 生图等共 20 个页面。
④ 官网与数据：官网整站静态化，首页运行时读接口，商品与服务、工具下载、资讯中心全部后台可控；并接入访问统计（PV/UV/来源/设备/访客明细）与流量周报，访客明细落库可长期分析。
**我负责**：单人全栈交付——需求梳理（PRD）→ 数据模型 → 后端接口 → 管理后台 20 个页面 → 微信小程序 → 服务器部署与运维，并主导安全加固与性能优化。
**技术栈**：后端 Node.js + Express 4（helmet / CORS 白名单 / compression / multer / nodemailer）；数据库 SQLite（better-sqlite3 v12，WAL 模式，自研 db_compat_shim 兼容层保留 db.run/get/all 语义）；管理后台为原生 HTML/CSS/JS（不引框架，体积更小、首屏更快）；小程序原生开发 + 云函数（CloudBase）；部署为腾讯云轻量 + Nginx 反代 + PM2 守护，官网静态站部署在阿里云虚机，两端通过跨域接口与 CORS 白名单协作；测试采用 Playwright 端到端 + Jest/supertest。
**亮点与难点**：① 官网整站静态化（预渲染 + 定时构建），关键内容烘焙进静态 HTML 以保证搜索引擎收录，同时页面运行时读接口做到"后台改完即生效"，解决了 SEO 与实时性不可兼得的矛盾；② 单文件 SQLite 承载工单 / 目录 / 统计三类数据，零外部数据库依赖，一台轻量服务器即可跑起来，小型团队成本可控；③ 客户与设备数据全部落在自有服务器，不依赖第三方 SaaS；④ 安全加固：RBAC 三级权限、密码策略、登录日志、Helmet、CORS 白名单、XSS 过滤、SQL 参数绑定；⑤ 工程化：自建发布管线（构建 → FTP/SCP → 逐文件 md5 校验）+ 静态资源指纹，杜绝"改了不生效"。
评论