🔄 Barter Zone — 以物换物平台

基于 OpenClaw Agent 的智能以物换物社区。发布闲置物品，AI 自动分析特征、匹配交换需求、撮合交易。

📐 架构概览

┌─────────────────────────────────────────────────────────────────┐
│                        EdgeOne Pages                            │
│  ┌──────────────────────┐  ┌──────────────────────────────┐    │
│  │  client/ (用户端 H5)  │  │  admin/ (管理后台 SPA)        │    │
│  │  React 18 + Vite     │  │  React 18 + Vite             │    │
│  │  Ant Design Mobile   │  │  Ant Design Pro              │    │
│  │  base: /             │  │  base: /admin/               │    │
│  └──────────┬───────────┘  └──────────────┬───────────────┘    │
│             │                             │                     │
│             └──────────┬──────────────────┘                     │
└────────────────────────┼────────────────────────────────────────┘
                         │  /api/*
┌────────────────────────┼────────────────────────────────────────┐
│                  CloudBase 云函数                                │
│  ┌──────────────────────────────────────────────────────────┐  │
│  │  server/functions/                                        │  │
│  │  ├── items/    物品 CRUD                                   │  │
│  │  ├── swaps/    交换管理                                    │  │
│  │  ├── auth/     微信登录                                    │  │
│  │  ├── users/    用户管理                                    │  │
│  │  ├── reviews/  评价系统                                    │  │
│  │  └── agent/    AI Agent (图像分析/智能匹配)                 │  │
│  └──────────────────────────────────────────────────────────┘  │
│             │          CloudBase NoSQL                          │
│  ┌──────────┴─────────────────────────────────────────────────┐ │
│  │  items │ swaps │ users │ reviews │ matches │ notifications│ │
│  └────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
                         │
┌────────────────────────┼────────────────────────────────────────┐
│             OpenClaw Agent API                                  │
│  ┌──────────────────────────────────────────────────────────┐  │
│  │  图像识别 │ 语义匹配 │ 多跳交换链 │ 智能估值 │ 安全风控     │  │
│  └──────────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────────┘

🛠 技术栈

层级	技术
用户端	React 18 + TypeScript + Vite + Ant Design Mobile 5 + Zustand + TanStack Query
管理后台	React 18 + TypeScript + Vite + Ant Design 5 + Pro Components + Recharts
后端	CloudBase 云函数 (Node.js 18) + @cloudbase/node-sdk
数据库	CloudBase NoSQL
AI	OpenClaw Agent API (图像识别 / 语义匹配 / 多跳推荐)
部署	EdgeOne Pages (前端) + CloudBase (后端)

🚀 快速开始

环境要求

• Node.js >= 18
• npm >= 9

安装依赖

# 用户端
cd client && npm install

# 管理后台
cd admin && npm install

# 后端（云函数）
cd server && npm install

本地开发

# 用户端 (端口 3000)
cd client && npm run dev

# 管理后台 (端口 3001)
cd admin && npm run dev

后端云函数需要部署到 CloudBase 环境，本地开发时 client/admin 的 API 层会自动 fallback 到 mock 数据。

构建

# 分别构建三个子项目
cd client && npm run build
cd admin && npm run build
cd server && npm run lint   # server 无 build，仅 lint

📁 项目结构

barter-zone/
├── client/                 # 用户端 H5 应用
│   ├── src/
│   │   ├── components/     # 通用组件
│   │   ├── pages/          # 页面组件
│   │   ├── services/       # API 层 + Mock 数据
│   │   ├── hooks/          # 自定义 Hooks
│   │   ├── store/          # Zustand 状态管理
│   │   ├── types/          # TypeScript 类型定义
│   │   └── utils/          # 工具函数
│   ├── public/
│   │   └── _routes.json    # SPA fallback 配置 (EdgeOne Pages)
│   └── vite.config.ts
│
├── admin/                  # 管理后台 SPA
│   ├── src/
│   │   ├── pages/          # 看板/审核/用户/仲裁/设置
│   │   ├── services/       # Admin API 层 + Mock 数据
│   │   └── types/          # TypeScript 类型定义
│   ├── public/
│   │   └── _routes.json    # SPA fallback 配置
│   └── vite.config.ts      # base: /admin/
│
├── server/                 # CloudBase 云函数
│   ├── functions/
│   │   ├── _shared/router.js   # 统一路由中间件
│   │   ├── items/               # 物品 CRUD
│   │   ├── swaps/               # 交换管理
│   │   ├── auth/                # 微信登录
│   │   ├── users/               # 用户管理
│   │   ├── reviews/             # 评价系统
│   │   └── agent/               # AI Agent 转发
│   ├── cloudbaserc.json         # CloudBase 部署配置
│   └── package.json
│
├── cloudbaserc.json        # 根级 CloudBase 配置（合并 server/ 配置）
├── .cnb.yml                # CNB 流水线配置
├── PRD.md                  # 产品需求文档
└── docs/                   # 设计文档
    ├── agent-protocol.md   # Agent 交互协议
    └── ui-requirements.md  # UI 设计需求

🌐 部署

项目	平台	路径
用户端	EdgeOne Pages	/
管理后台	EdgeOne Pages	/admin/
云函数	CloudBase	/api/*

详见 PRD.md 了解完整产品规划。

📄 License

MIT