一个完整的B/S架构家教连接系统,支持老师注册、家长筛选、即时通讯、订单管理等功能。
- 对接模块: 老师注册认证、家长筛选匹配、即时通讯
- 备课模块: 教学资料管理、试卷生成、课程安排
- 交易模块: 订单创建、托管支付、T+1结算、退款处理
- ⚡ 前后端分离架构
- 🔐 JWT身份认证 + 生物识别支持
- 💬 即时通讯(IM) + 7天消息缓存
- 💰 托管支付系统 + T+1自动结算
- 📱 响应式设计,支持PC和移动端
- 🛡️ Row Level Security (RLS) 数据安全
- React 19 + TypeScript
- React Router DOM
- Zustand (状态管理)
- Tailwind CSS
- Axios
- Lucide React (图标)
- Express.js + TypeScript
- Supabase (PostgreSQL + Auth + Storage)
- JWT认证
- Zod (数据验证)
- Multer (文件上传)
- PostgreSQL (通过Supabase)
- 9张核心表:用户、老师档案、订单、支付、消息等
- Row Level Security (RLS) 权限控制
- Node.js 18+
- npm 或 pnpm
- Supabase账号 (可选,用于生产环境)
# 安装后端依赖
cd api
npm install
# 安装前端依赖
cd ../
npm installSUPABASE_URL=https://your-project.supabase.co
SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_KEY=your-service-key
JWT_SECRET=your-jwt-secretVITE_API_BASE=http://localhost:3000/api# 启动后端 (端口: 3000)
cd api
npm run dev
# 启动前端 (端口: 5173)
npm run dev访问 http://localhost:5173 查看应用
POST /api/auth/register- 用户注册POST /api/auth/login- 用户登录POST /api/auth/send-otp- 发送验证码
GET /api/teachers- 获取老师列表 (支持筛选)GET /api/teacher/:id- 获取老师详情POST /api/teacher/profile- 创建老师档案PUT /api/teacher/profile- 更新老师档案
POST /api/orders- 创建订单GET /api/orders- 获取订单列表GET /api/orders/:id- 获取订单详情POST /api/orders/:id/pay- 订单支付POST /api/order-flow/:id/confirm- 确认订单POST /api/order-flow/:id/complete- 完成订单POST /api/order-flow/:id/review- 评价订单POST /api/order-flow/:id/refund- 申请退款
POST /api/im/conversations- 创建会话POST /api/im/messages- 发送消息GET /api/im/conversations/:id/messages- 获取消息列表POST /api/im/messages/:id/read- 标记已读POST /api/im/conversations/:id/export- 导出消息
# 测试IM消息系统
node test-im.mjs
# 测试完整API
node api/test-api.mjs- 家长账号: 13800138000 / 123456
- 老师账号: 13800138001 / 123456
.
├── api/ # 后端API
│ ├── src/
│ │ ├── routes/ # API路由
│ │ ├── lib/ # 工具库
│ │ ├── services/ # 业务服务
│ │ └── index.ts # 入口文件
│ └── package.json
├── src/ # 前端应用
│ ├── pages/ # 页面组件
│ ├── components/ # 通用组件
│ ├── api.ts # API客户端
│ ├── store.ts # 状态管理
│ └── types.ts # 类型定义
├── supabase/ # 数据库配置
│ └── migrations/ # SQL迁移文件
└── README.md
- JWT token认证
- 密码哈希加密
- Row Level Security (RLS)
- API输入验证
- CORS保护
- Helmet安全头
- 订单创建: 家长选择老师并创建订单
- 费用托管: 家长支付,费用托管在平台
- 课程进行: 老师完成授课
- T+1结算: 次日自动结算给老师
- 评价反馈: 家长对老师进行评价
- 基于会话的消息系统
- 支持文字、语音、图片、文件消息
- 7天消息缓存
- 消息导出功能
- 已读未读状态
- 按科目、年级、价格筛选
- 查看老师详情和评价
- 在线预约功能
- 完整的订单生命周期
- 托管支付保障
- 退款处理机制
- 实时消息收发
- 多媒体消息支持
- 消息记录导出
- 教学资料管理
- 试卷生成工具
- 课程安排管理
- 配置生产环境Supabase
- 设置环境变量
- 构建前端:
npm run build - 部署后端API
- 部署前端静态文件
支持一键部署到Vercel,自动配置前后端。
如有问题或建议,欢迎提交Issue或联系开发团队。
MIT License - 详见LICENSE文件