乡邻市集
# 乡邻市集 — 项目介绍
## 一句话简介
> 帮乡村农人跳出农药化肥的恶性循环，用本地拼团把生态农产品直接送到新村民餐桌——农人、买家、环境，三赢。
---
## 一、我们发现了什么问题
我是住在福建屏南县墘头村的一个新村民。
搬来乡村之后，我遇到一个很实际的困扰：**买新鲜蔬菜不方便**。我们主要靠拼多多拼团，但经常一周都拼不了一次。
后来我产生了疑问：本地明明有种菜的农人，为什么我们住在隔壁反而买不到？
带着这个问题，我走访了几位本地农人，发现了一个让人触动的现实：
### 一个恶性循环
本地农人的菜，主要走批发。以花菜为例：
- **批发价**：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）