行业背景：麻阳是典型的县域农业产区，水果大宗交易（如冰糖橙）长期依赖线下熟人撮合，供需信息分散、真实性无核验、对接后无人跟进，成交结果和余量难以追踪；县城本地的水果零售和盒饭即时配送也缺少统一的线上化履约平台，商家、骑手、消费者之间缺乏可追踪的订单链路。
立项原因：为县域市场搭建一个轻量、可信、可运营的本地供需与履约平台——麻阳通，把「水果大单撮合」和「零售/盒饭即时配送」两条业务搬到线上，用标准化流程替代微信群和口口相传。
旨在解决的产品问题：
供需信息不对称——果农、合作社、采购商通过平台发布供需（品种、数量、价格、乡镇），经审核后公开展示，允许多人申请对接；
撮合无服务标准——平台设撮合专员负责核验信息、对接双方、限时回访、确认成交，服务过程留痕、结果可追踪，改变“拉个群就没人管”的现状；
本地履约链路缺失——商家上架商品、用户下单、骑手取送、平台核款，订单、配送、支付、售后四个环节状态独立可查，异常和退款有处理出口；
平台角色清晰——撮合只提供服务不担保交易，配送只登记资金往来不代收货款，权责边界明确，符合县域小规模试运营的成本与信任基础。
1、功能模块（一览）
用户端（小程序/H5）：首页 · 水果大单 · 报价下单 · 订单 · 配送 · 登录/我的
商家端：商品上架 · 接单备货 · 核款
骑手端：接单 · 取货 · 送达
运营后台：案件管理 · 审核 · 撮合调度 · 订单干预 · 财务对账
后端支撑：账号认证（含 MFA）· 图片上传 · 消息通知 · 定时任务（超时处理）
2、主要功能描述（精简版）
麻阳通是面向麻阳县域的本地供需与履约平台，两条业务主线：
① 水果大单撮合：果农、合作社、采购商发布供需，平台审核后展示，允许多人申请；撮合专员核验信息、对接双方并回访，成交后确认余量、按约定收取服务费。
② 零售与盒饭配送：商家上架商品，用户在线下单，服务端报价、商家备货、骑手配送、平台核款，异常订单和退款售后全程可追踪。
两条主线共用统一账号体系、运营后台与财务审计，隐私信息加密存储、操作留痕。
我主要负责整个项目的构建，通过 vibecoding 协助开发，自己本人审核完成项目的开发。因为自身有 java 基础，sql 基础，以及 10 多年的前端开发经验。
技术栈：前端 uni-app（Vue 3）一份源码产出微信小程序 + H5；Web 端 Vue 3 + TypeScript + Vite + Pinia；后端 NestJS + TypeScript 模块化单体；数据库 PostgreSQL（标准 SQL 事务）；异步任务用独立 Worker + Outbox 兜底；文件走 S3 兼容存储；测试用 Vitest + Playwright；部署为 Docker 镜像跑在腾讯云云托管。
架构：用户、商家、骑手、运营后台四端共用一个 NestJS 单体后端，按 auth、fruit、commerce、matching、finance 等模块划分，分层清晰；API、H5、后台同容器同源部署，消除跨域；撮合与零售两条业务线解耦，仅共享账号、审计、通知。状态转换只认服务端。
实现亮点：① 状态机严谨，订单与撮合案件各拆四个独立状态维度；② 并发正确性全部由数据库行锁/条件更新保证（接单竞争、库存预留、收款防重复）；③ Outbox 模式，通知失败不回滚业务；④ 隐私安全：手机号加密存储、HMAC 查重、受限签名上传、操作留审计；⑤ 测试分层覆盖权限、并发、幂等。
实现难点：① 撮合案件状态组合复杂，回访、延期、重开等规则须逐条服务端校验；② 接单竞争、库存幂等释放等并发一致性要求高；③ 平台不代收款只登记往来，核款匹配与结算冲正逻辑易错；④ 多端平台差异需 PlatformAdapter 统一抽象；⑤ 云托管对数据库连接、Worker 常驻有限制，部署需迁就现实约束。
评论