立项原因： 新西兰华人家庭在寻找家教时，普遍面临信息分散、供需匹配效率低的问题。家长难以快速找到符合学科需求、授课区域和语言偏好的家教，而家教也缺乏高效展示自身资质和获取生源的渠道。传统的社交媒体群组和口碑推荐方式存在信息不透明、筛选成本高、缺乏标准化评价体系等痛点。
行业场景与业务背景： TutorMatch 定位于新西兰本地家教服务撮合平台，面向华人家长和家教群体，提供结构化的家教信息发布、多维度搜索匹配、收藏对比及订阅增值服务。平台通过审核机制保障家教信息质量，结合地理位置和学科标签实现精准匹配，帮助家长高效找到合适的家教资源，同时为家教提供稳定的展示和获客渠道。
1. 用户注册与认证模块： 支持邮箱注册、Google 第三方登录，区分家长和家教两种角色，JWT 令牌实现身份认证与会话管理。
2. 家教信息管理模块：家教用户可发布个人资料，包括学科专长、授课区域、教学经验、收费标准等结构化信息，支持头像上传和资料编辑。
3. 搜索与匹配模块： 家长可按学科、地区、关键词等多维度筛选家教，支持分页浏览和排序，快速定位符合需求的家教资源。
4. 收藏与对比模块： 家长可收藏感兴趣的家教，便于后续对比和查看，提升决策效率。
5. 订阅增值服务模块： 提供付费订阅功能，订阅用户可解锁家教联系方式等增值内容，通过 Stripe 支付网关完成交易。
6. 审核管理模块： 后台审核员对家教发布的信息进行审核，确保平台内容质量和信息真实性。
7. 后台管理模块： 管理员可管理用户、审核内容、配置角色权限（RBAC），支持积分管理和数据统计。
8. 合规与安全模块： 包含免责声明、隐私政策、用户举报、账户注销、数据导出等功能，符合新西兰本地法律要求。
我负责的具体任务： 作为项目唯一开发者，独立完成了从需求分析、架构设计、前后端开发、数据库设计到部署上线的全流程工作。
技术栈与架构：
- 前端： React 18 + TypeScript + Vite，响应式布局适配移动端
- 数据库： PostgreSQL，使用 Flyway 管理 64 个版本的数据库迁移脚本，确保生产环境 schema 变更可追溯
- 支付： 集成 Stripe 支付网关，实现订阅制付费功能
- 部署： 前后端分离部署
实现亮点：
- 自研 RBAC 权限系统：基于三表结构（角色、权限、角色-权限关联），通过自定义 @RequirePermission 注解 + AOP切面实现细粒度权限控制，配合 Caffeine缓存降低数据库查询压力
- 完善的测试体系：后端 500+ 单元测试与集成测试，使用 Testcontainers 启动真实 PostgreSQL 实例，JaCoCo 覆盖率检测
- 前后端双重输入校验：前端 maxLength 限制 + 后端 Jakarta Validation 注解，同步保障数据完整性
实现难点：
- 多角色权限体系的灵活设计，需兼顾家长、家教、审核员、管理员等不同角色的访问控制
- Stripe 支付回调的幂等处理和订阅状态同步，确保支付流程的可靠性
评论