项目介绍
# 乡邻市集 — 项目介绍
## 一句话简介
> 帮乡村农人跳出农药化肥的恶性循环,用本地拼团把生态农产品直接送到新村民餐桌——农人、买家、环境,三赢。
---
## 一、我们发现了什么问题
我是住在福建屏南县墘头村的一个新村民。
搬来乡村之后,我遇到一个很实际的困扰:**买新鲜蔬菜不方便**。我们主要靠拼多多拼团,但经常一周都拼不了一次。
后来我产生了疑问:本地明明有种菜的农人,为什么我们住在隔壁反而买不到?
带着这个问题,我走访了几位本地农人,发现了一个让人触动的现实:
### 一个恶性循环
本地农人的菜,主要走批发。以花菜为例:
- **批发价**:1 元/斤
- **超市零售价**:3.5 元/斤
中间的差价,农人几乎拿不到。
1 块钱一斤怎么赚钱?农人只有一个办法:**拼命提高产量**。大量打农药、大量施化肥,把亩产拉到 8000 斤。只有这样,才能在 1 块钱的单价下勉强有利润——扣除农药、化肥、农资的成本,一亩地到手也就四千块。**辛苦一整季,赚的只是个辛苦钱。**
更大的代价是:蔬菜有农药残留,土壤年复一年退化,农人自己的健康也在透支。
**价格越低,越要打药;越打药,品质越差;品质越差,越卖不上价。人被困在里面,地也被困在里面。**
---
## 二、我们想怎么解决
### 破局:本地零售替代批发
如果能帮农人把一部分产品直接在本地以零售价卖掉,这个循环可以打破。
换一种方式种——不打农药、少施化肥:
| | 批发模式 | 生态种植 + 本地零售 |
|---|---|---|
| 亩产 | ~8000 斤 | 3000~4000 斤 |
| 单价 | 1 元/斤 | 2.5 元/斤 |
| 农资成本 | 高(农药+化肥) | 大幅降低 |
| 亩利润 | ~4000 元 | ~10000 元 |
产量减半,收入翻倍。人没那么累了,种出来的菜自己敢吃,别人也敢买。
### 三赢
| 角色 | 收益 |
|------|------|
| **农人** | 赚得更多,劳动强度降低,种得安心 |
| **新村民** | 吃到新鲜、无公害的本地蔬菜 |
| **环境** | 减少农药化肥,土地更可持续 |
---
## 三、我们做了什么
基于这个想法,我们开发了**乡邻市集**——一个乡村在地版的熟人社区拼团 + 线上农贸市集。
### 3.1 信任机制
乡村交易的基础是信任。平台主打**实名制 + 熟人社区**:
- 所有用户实名登记,绑定手机号和村组
- 农人需提交实名资料、田间照片,经后台审核认证后方可售卖
- 核实田地与在售产品,确保供给真实可信
- 交易评价公开可查,形成口碑沉淀
### 3.2 帮农人低门槛上手
很多农人不熟悉手机操作,我们把上手路径做到最短:
1. **首次手把手**:农人注册后,协助建个人主页、整理产品档案、完成第一次上架
2. **模板化复用**:系统记住品类和规格,后续相似产品一键上架,手机上点几下就完成
3. **农户公开主页**:展示海报、基地照片、产品档案、评价,积累信任资产
### 3.3 供应与求购双向撮合
**供应侧**:农人发布供应单,设置品类、数量、价格、截止时间、交付方式。考虑到农产品运输特点,农人可设起售量(比如一筐 30 斤),买家通过**拼团**凑够起售量下单,统一配送。
**需求侧**:买家也可以主动发布求购单(比如「我想买 5 斤土鸡蛋」),其他买家可加入拼团,农人看到后直接应供,系统自动生成订单。
### 3.4 完整的订单与评价体系
- 订单状态流转:下单 → 确认 → 配送 → 完成
- 双方互评:5 星 + 快捷标签(新鲜、足斤足两、人很好、准时交付、品质如一)
- 评价聚合展示在农人主页和供应详情,形成信用积累
### 3.5 管理后台
完整的 PC Web 管理后台,覆盖:
- **数据看板**:用户数、供应单数、订单数、交易额概览
- **用户管理**:搜索筛选、农人认证审核、封禁/解封
- **农户主页装修**:海报、基地图、联系方式、产品档案维护
- **供应单管理**:状态筛选、强制截团/取消
- **求购单管理**:状态筛选、强制关闭
- **订单管理**:状态筛选、状态流转
- **评价管理**:查看与删除违规评价
- **消息管理**:消息列表、群发系统通知
- **村组管理**:树形结构维护、新增/删除村组
- **供应网点管理**:自提点/取货点 CRUD、经纬度、联系人
---
## 四、技术实现
### 4.1 技术栈
| 层级 | 技术 |
|------|------|
| H5 前端 | React 18 + TypeScript + Vite + Tailwind CSS + Zustand + TanStack Query |
| Admin 后台 | React 18 + TypeScript + Vite + shadcn/ui + lucide-react |
| 后端 | Node.js + Express + TypeScript + Prisma |
| 数据库 | PostgreSQL 15 + Redis 7 |
| 包管理 | pnpm workspace (monorepo) |
| 共享类型 | packages/shared(前后端共用类型定义) |
### 4.2 架构特点
- **全栈 TypeScript**:前后端类型安全,共享 API 类型定义
- **分层架构**:Route → Controller → Service → Prisma,职责清晰
- **Monorepo**:H5、Admin、Server 统一管理,共享类型和工具
- **RESTful API**:统一响应格式 `{ success, data, message }`
### 4.3 已完成的核心能力
| 模块 | 已实现 |
|------|--------|
| 认证 | 手机号 + 验证码登录,Dev 一键测试账号 |
| 用户 | 资料编辑、农人认证、农户公开主页、封禁机制 |
| 供应单 | 发布/编辑/截团/取消/复制发布,支持网点自提 |
| 求购单 | 发布/拼团加入退出/农人应供 |
| 订单 | 创建/确认/配送/完成/取消,状态流转 |
| 评价 | 双方互评、星级+标签、聚合展示 |
| 收藏 | 收藏/取消/列表/状态查询 |
| 消息 | 站内消息、未读角标、订单通知、后台群发 |
| 村组 | 树形层级结构,按村组筛选供应 |
| 供应网点 | 按镇查询,多选关联供应单 |
| 管理后台 | 10+ 管理模块,完整运营能力 |
---
## 五、当前进展
- 已完成完整的全栈 MVP,H5 + Admin + Server 均可运行
- 支持从农人上架 → 买家拼团下单 → 订单流转 → 评价的完整交易闭环
- 下一步:跑通熙岭乡小循环,验证模式
---
## 六、价值展望
乡邻市集想做的,不是简单地把菜从 A 搬到 B。
我们想证明一件事:**数字化工具可以让农人换一种方式种地**——从被迫打药追产量,转向生态种植、品质溢价、本地消化。这不是一个纯商业项目,而是一次乡村经济协作方式的探索。
如果墘头村的小循环能跑通,熙岭乡十几个村子都能复制。到那时,农人少打药也能多赚钱,新村民在家门口吃到放心菜,土地也得到了喘息。
**农人、买家、环境,三赢。**
---
**项目名称**:乡邻市集
**项目类型**:乡村数字化 / 本地供需撮合 / 社交电商
**技术栈**:React + TypeScript + Node.js + PostgreSQL
**仓库结构**:pnpm monorepo(H5 + Admin + Server + Shared)
评论 (0)
链接
团队
W
@wayne
队长
提交于 2026 年 5 月 24 日 03:34:31