鸿爪派 (HongZaoPai) — Connect Web

├── package.json                  # 根 monorepo 配置
├── README.md                     # 本文件
├── .cnb.yml                      # CI/CD 流水线配置
│
├── h5/                           # 前端（React 18 + TypeScript + Vite）
│   ├── package.json
│   ├── vite.config.ts            # Vite 配置（含 BFF 代理）
│   ├── index.html
│   └── src/
│       ├── api/
│       │   ├── index.ts          # API 层（对接 BFF 后端）
│       │   └── mock.ts           # Mock 数据（BFF 开发模式使用）
│       ├── components/           # 公共组件
│       ├── pages/                # 页面
│       │   ├── home/             # 首页（动态流）
│       │   ├── supply/           # 供需列表 & 详情
│       │   ├── square/           # 资源广场（活动列表）
│       │   ├── discover/         # 发现（推荐圈子、动态、推广）
│       │   ├── login/            # 登录
│       │   └── profile/          # 个人中心
│       ├── stores/               # Zustand 状态管理
│       ├── types/                # TypeScript 类型定义
│       └── styles/               # 全局样式
│
├── server/                       # BFF 代理层（Express）
│   ├── package.json
│   └── index.js                  # BFF Server（代理前端请求到 CloudBase）
│
├── cloudbase-functions/          # 后端（CloudBase 云函数）
│   ├── package.json
│   ├── common/
│   │   ├── response.js           # 统一响应格式 { code, data, message }
│   │   └── database.js           # 数据库操作封装
│   ├── supply/index.js           # 供需模块（列表、详情、创建）
│   ├── activity/index.js         # 活动模块（列表、详情）
│   ├── discover/index.js         # 发现模块（推荐接口）
│   ├── circle/index.js           # 圈子模块（列表、详情）
│   ├── user/index.js             # 用户模块（登录、注册、个人信息）
│   └── init-db/index.js          # 数据库初始化脚本
│
├── design-system/                # 设计系统
│   ├── MASTER.md
│   └── design-system-preview.html
│
├── docs/                         # 文档
│   └── PRD.md
│
└── prototypes/                   # 原型页面（纯 HTML）
    └── *.html

# 一键安装所有子项目依赖
npm run install:all

# 或分别安装
cd h5 && npm install
cd server && npm install
cd cloudbase-functions && npm install

# 方式一：一键启动（推荐）
npm run dev

# 方式二：分别启动
# 终端 1：启动 BFF Server（端口 3001）
npm run dev:server

# 终端 2：启动前端开发服务器（端口 3000）
npm run dev:h5

npm run build:h5

┌─────────┐       Vite Proxy       ┌──────────┐      SDK / HTTP     ┌────────────────┐
│  H5 前端 │ ──── /api/* ──────▶  │ BFF 代理层 │ ──────────────▶  │ CloudBase 云函数 │
│ (Port 3000)│                      │ (Port 3001)│                   │               │
└─────────┘                       └──────────┘                   └───────┬───────┘
                                                                        │
                                                                  ┌─────▼─────┐
                                                                  │  数据库    │
                                                                  │ (CloudBase)│
                                                                  └───────────┘

{
  "code": 0,
  "data": {},
  "message": ""
}

cd h5 && npm run build
# 将 h5/dist/ 部署到 CDN 或静态托管

cd cloudbase-functions
# 通过 CloudBase CLI 或控制台部署各云函数
# 首次部署需初始化数据库：
npm run init-db