Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

家教连接平台

一个完整的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 install

环境配置

后端环境变量 (api/.env)

SUPABASE_URL=https://your-project.supabase.co
SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_KEY=your-service-key
JWT_SECRET=your-jwt-secret

前端环境变量 (.env)

VITE_API_BASE=http://localhost:3000/api

启动服务

# 启动后端 (端口: 3000)
cd api
npm run dev

# 启动前端 (端口: 5173)
npm run dev

访问 http://localhost:5173 查看应用

📋 API接口文档

认证接口

  • 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安全头

💳 支付流程

  1. 订单创建: 家长选择老师并创建订单
  2. 费用托管: 家长支付,费用托管在平台
  3. 课程进行: 老师完成授课
  4. T+1结算: 次日自动结算给老师
  5. 评价反馈: 家长对老师进行评价

📞 即时通讯

  • 基于会话的消息系统
  • 支持文字、语音、图片、文件消息
  • 7天消息缓存
  • 消息导出功能
  • 已读未读状态

🎯 核心功能演示

1. 老师筛选

  • 按科目、年级、价格筛选
  • 查看老师详情和评价
  • 在线预约功能

2. 订单管理

  • 完整的订单生命周期
  • 托管支付保障
  • 退款处理机制

3. 即时通讯

  • 实时消息收发
  • 多媒体消息支持
  • 消息记录导出

4. 备课中心

  • 教学资料管理
  • 试卷生成工具
  • 课程安排管理

🚀 部署

生产环境部署

  1. 配置生产环境Supabase
  2. 设置环境变量
  3. 构建前端: npm run build
  4. 部署后端API
  5. 部署前端静态文件

Vercel部署

支持一键部署到Vercel,自动配置前后端。

📞 支持与联系

如有问题或建议,欢迎提交Issue或联系开发团队。

📄 许可证

MIT License - 详见LICENSE文件

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages