本地县域的生活信息长期散落在微信群、朋友圈和街边小广告里：信息真假难辨、很快过期，商家发出去没人看到，居民想找维修、家政、二手转让等服务又没有统一入口，双方只能靠熟人介绍或反复加微信沟通，撮合成本很高。
本项目面向县域本地生活场景，把同城服务、需求发布、二手信息、商家展示等分散信息集中到一个微信小程序里，提供手机号实名登录、内容发布与检索、站内私聊、在线支付、内容先发后审与举报处置等机制，让居民和商家在同一个平台内完成「找信息 — 沟通 — 成交」的闭环，降低本地生活服务的信息获取成本。
项目由 C 端微信小程序和管理后台两部分组成。
C 端功能：手机号验证码登录与微信手机号快捷登录、首页三频道（发现 / 推荐 / 关注）、同城服务列表与详情、服务与需求发布（支持多图、服务地点、分类）、我的发布、搜索与全部分类、站内私聊（会话列表、消息收发、已读、置顶 / 免打扰）、关注与收藏、商品与订单、微信支付、收货地址簿、站内通知与未读提醒、举报、账号与安全（换绑手机号、修改密码、设备管理）、意见反馈与帮助中心。
管理后台功能：数据仪表盘、管理员与角色权限管理（接口级 RBAC 权限码）、C 端用户管理（启用禁用、重置密码、强制下线）、同城服务与需求的内容管理、商品与订单管理、举报处理、站内通知、系统配置、操作审计日志、知识库、数据库只读运维、功能架构图等模块。
两端通过统一 API 与 WebSocket 实时通道联动，后台的下架、恢复、删除等处置会实时推送给受影响用户。
我在项目中担任全栈开发，独立承担需求梳理、数据库设计、后端接口开发、小程序端开发、管理后台开发以及服务器部署与日常运维的全部工作。
技术栈与架构：后端为 PHP 8.1 + webman 常驻内存框架，MySQL 5.7 + Redis，按 controller / service / validation / model 分层；管理后台为 Vue 3 + TypeScript + Vite + Naive UI；C 端为 uni-app X（.uvue / uts）微信小程序；实时消息基于 GatewayWorker WebSocket 长连接。
亮点与难点：
1. 接口级 RBAC 权限控制——路由即权限码，权限集合带 Redis 缓存，角色变更后实时推送前端刷新菜单与按钮；
2. 双套 JWT 令牌体系——后台双令牌 + 前端无感自动刷新，C 端独立密钥与令牌版本号，换绑手机号、修改密码、账号禁用后旧令牌立即失效；
3. 发布类接口双层防重——前端提交锁 + 服务端幂等键（处理中返回 409、重复请求回放首次响应），解决弱网重试与重复点击产生的脏数据；
4. 私聊消息链路——WebSocket 下行 + 未读总数推送 + 页面 onShow 拉取兜底，覆盖小程序切后台断连丢消息的场景；
5. 内容治理闭环——先发后审 + 举报 + 处置 + 站内通知，处置与通知分事务执行、提交后再推送，避免产生「幽灵通知」；
6. 接入微信支付 APIv3（下单、查单、退款、回调验签）与微信手机号快速登录。
评论