居美家房产中介平台 - 项目总览
项目信息
- 项目名称：居美家 JUMEIJIA
- 文档版本：v1.0
- 文档日期：2025年11月3日
- 项目经理：AI助手
- 开发模式：一次性完成（售后服务暂缓）
项目定位
核心目标
基于新需求文档，完整重构居美家房产中介平台，实现房东委托、视频发布、地图找房、多房源类型、短租、爬虫工具、电子合同等核心功能。
服务区域
全国
目标用户
- 房东：发布委托，寻找经纪人代理
- 经纪人：抢单接单，发布管理房源
- 租客/购房者：浏览房源，联系经纪人
技术架构
前端
- 小程序：uni-app（完全重写）+ Vue3 + uni-ui
- 后台管理：vue-next-admin（Element Plus）- 二次开发
后端
- 框架：ThinkPHP 8.0
- 数据库：MySQL 5.7
- 缓存：Redis
- 认证：JWT（保留现有功能）
第三方服务
- 地图：腾讯地图API（Key: PVZBZ-DB46Z-WFEXI-ZCKQA-HZBWS-BLBF2）
- 电子签约：e签宝
- 爬虫目标：贝壳租房、安居客租房
核心功能清单
| 优先级 | 功能模块 | 状态 |
|---|---|---|
| 1 | 房东委托经纪人发布 | 计划中 |
| 2 | 视频发布功能（10个/房源） | 计划中 |
| 3 | 地图找房（商圈+小区） | 计划中 |
| 4 | 多种房源类型（住宅/门头房/车库） | 计划中 |
| 5 | 短租房源 | 计划中 |
| 6 | 爬虫抓取工具 | 计划中 |
| 7 | 电子合同（e签宝） | 计划中 |
| 8 | 售后服务 | 暂缓第二阶段 |
UI设计
主题色（基于logo）
- 主色：#FF7E00（橙色）
- 辅助色：#FF8533、#FF9966
- 成功色：#52C41A
- 警告色：#FAAD14
- 危险色：#F5222D
设计风格
- 参考安居客APP
- 现代简约风格
- 卡片式布局
- 突出价格信息（橙色高亮）
开发时间规划
预计总工期
60-80个工作日（约3-4个月）
关键里程碑
- 30天：完成委托+视频+房源类型
- 45天：完成商圈+地图+爬虫
- 60天：完成电子合同+小程序重写
- 75天：完成后台管理+测试优化
文档结构
docs/20251103开发计划/
├── 00-项目总览.md（本文档）
├── 01-后端数据库设计.md
├── 02-后端接口设计.md
├── 03-后端Service设计.md
├── 04-中间件与权限设计.md
├── 05-小程序页面结构.md
├── 06-小程序组件设计.md
├── 07-小程序UI设计规范.md
├── 08-小程序状态管理.md
├── 09-后台管理功能清单.md
├── 10-后台管理页面设计.md
├── 11-e签宝对接文档.md
├── 12-腾讯地图对接文档.md
├── 13-爬虫实现文档.md
└── 14-API接口文档.md关键决策记录
技术方案
- 房源类型扩展：采用单表+JSON动态字段方案
- 视频存储：前期使用本地存储
- 商圈数据：腾讯地图API搜索+手动录入
- 委托抢单：先到先得机制
- 电子合同：对接e签宝（暂定）
业务规则
- 一个委托只能被一个经纪人接单
- 房东可以发布委托（作为普通用户）
- 经纪人可以接单代发，也可以直接发布房源
- 每个房源最多10个视频，后台可配置
- 单个视频最大50MB、最长30分钟，后台可配置
- 房源可以关联多个商圈
风险提示
技术风险
- 爬虫稳定性问题（反爬虫机制）
- e签宝生产环境费用
- 视频存储空间占用
- MySQL 5.7 JSON兼容性
业务风险
- 委托抢单高并发冲突
- 电子合同法律效力（需企业认证）
- 商圈数据准确性
后续计划
第二阶段功能（暂缓）
- 售后服务模块
- 服务商管理
- 工单系统
潜在扩展
- 房源推荐算法
- 猜你喜欢
- 消息通知
- 在线咨询
- VR看房
注意事项：
- 保留现有JWT认证、图片上传、邮件服务等基础功能
- 数据库需要MySQL 5.7兼容处理
- 项目名称统一使用"居美家 JUMEIJIA"
- 所有文档按编号顺序阅读
联系方式：
- 开发团队：[待填写]
- 项目周期：2025年11月 - 2026年2月