案例

社区互助服务平台

面向社区上门代办场景的私有全栈项目,包含微信小程序居民端/服务者端、Vue 管理后台、Node.js 后端 API、支付、通知、聊天、结算、部署与 CI。

Case Index

背景、角色、约束、决策、过程和结果按案例结构展开,便于快速判断交付边界。

图文说明

私有项目说明

该项目为私有全栈产品项目,代码仓库不公开;当前页面仅展示脱敏后的架构、流程和工程交付说明。

系统边界

小程序居民端/服务者端、Vue 管理后台、Node.js API、MySQL、Redis、微信支付、订阅消息、COS、WebSocket、Nginx 和 Docker Compose 共同组成交付范围。

背景

社区内取快递、丢垃圾等上门代办服务,需要同时覆盖居民下单、服务者接单、物业管理、支付订阅、通知沟通和后台运营。这个项目的目标不是单点 Demo,而是把多角色、多状态、多系统依赖的服务流程做成可运行的闭环。

角色

独立推进小程序、管理后台、后端 API、数据模型、订单状态机、支付回调、WebSocket 聊天、定时任务、Docker Compose 部署、生产检查和测试覆盖。

约束

  • 项目涉及用户、订单、支付、服务者结算等敏感信息,代码仓库不公开,作品集只展示脱敏架构和交付说明。
  • 业务链路横跨居民端、服务者端、后台和后端服务,必须保持订单状态、通知、结算和审计记录一致。
  • 微信生态依赖较多:微信登录、支付 V3、订阅消息、小程序合法域名、COS 上传和 WebSocket 都需要独立处理上线约束。

关键决策

  • 采用月卡订阅制和固定班次服务,降低零散订单定价复杂度,也便于后台做排班和派单。
  • 派单策略设计为物业服务者优先、邻里服务者抢单兜底,让服务可控性和供给弹性兼顾。
  • 用订单状态机约束创建、派单、接单、服务中、完成、确认和评价,避免状态散落在多个接口里。
  • 管理后台覆盖看板、排班、审核、订单、评价、月卡、提现、审计和系统配置,保证运营侧能闭环处理异常。
  • 部署侧使用 Docker Compose 编排 MySQL、Redis、server、admin、nginx 和备份任务,并补充生产配置检查。

过程

  • 搭建微信小程序居民端和服务者端,覆盖下单、订单列表、订单详情、评价、聊天、服务者任务池、完工上传和提现。
  • 搭建 Vue 3 + Element Plus 管理后台,实现运营看板、排班管理、服务者审核、订单管理、评价管理、月卡管理、提现管理和审计日志。
  • 设计 Node.js + Express API 分层,按 controller、service、model、route、middleware、job 拆分业务边界。
  • 实现微信登录、JWT 鉴权、Token 吊销、微信支付 V3 回调、腾讯云 COS 上传、订阅消息通知和 WebSocket 实时聊天。
  • 补齐定时任务、健康检查、Swagger 文档、Docker Compose、Nginx 配置、备份脚本、CI 和生产就绪检查。

结果

  • 形成居民端、服务者端、管理后台、后端 API、数据库、缓存、部署和监控文档组成的完整全栈交付链路。
  • 后端测试覆盖订单、支付、聊天、通知、结算、审核、权限、限流、配置、WebSocket 和定时任务等核心模块。
  • 生产检查覆盖安全头、弱密钥检测、CORS 白名单、接口限流、X-Request-ID、迁移、健康检查、备份和 CI。
  • 已在现有下单链路中接入 AI 下单助手,把自然语言需求解析为结构化订单草稿,用户确认后仍走原有订单创建流程。
  • AI 辅助下单会写入脱敏订单事件,记录置信度、是否需要确认和关键字段存在性,便于说明 AI 能力的业务边界和可追踪性。

审计痕迹

  • 订单事件覆盖创建、派单、接单、服务中、完成、确认和评价,便于追踪多角色状态流转。
  • 支付与结算链路记录支付回调、提现申请、结算状态和异常处理结果,页面只展示脱敏后的流程证据。
  • AI 下单草稿只把自然语言需求解析为结构化订单草稿,用户确认后才进入原有订单创建流程。
  • AI 辅助事件记录置信度、关键字段存在性和是否需要人工确认,用来证明 AI 能力边界而不是绕过业务审核。
  • 生产检查覆盖安全头、CORS 白名单、限流、X-Request-ID、健康检查、备份和 CI,作为私有项目的交付质量证据。