居美家房产中介平台现代化房源租售管理系统

📖 项目简介 ​

居美家房产中介平台是为居美家房产中介公司量身打造的一站式房源管理系统，服务于全国房产租售业务。系统支持微信小程序和 H5 双端，提供完整的房源发布、浏览、搜索和管理功能。

项目背景 ​

• 客户方：居美家房产中介公司
• 服务区域：青岛市北区
• 部署环境：阿里云服务器 + 宝塔面板
• 小程序类型：个人小程序
• 开发模式：个人开发，快速迭代

🚀 快速开始 ​

环境要求 ​

后端配置 ​

# 进入后端目录
cd server

# 安装依赖
composer install

# 配置环境变量
cp .example.env .env

# 创建数据库
mysql -u root -p -e "CREATE DATABASE fangyou CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

# 导入数据表
mysql -u root -p fangyou < ../database/migrations/init.sql

# 启动开发服务器
php think run

前端配置 ​

# 进入前端目录
cd client

# 安装依赖
npm install

# 运行到微信小程序
npm run dev:mp-weixin

# 运行到 H5
npm run dev:h5

🏗️ 技术栈 ​

前端技术 ​

• 框架: uni-app + Vue 3
• UI 组件: uni-ui
• 状态管理: Pinia
• 地图服务: 腾讯地图 API
• 网络请求: uni.request 封装

后端技术 ​

• 框架: ThinkPHP 8.0
• 语言: PHP 8.1+
• 数据库: MySQL 5.7
• 缓存: Redis
• 认证: JWT (firebase/php-jwt)
• 邮件服务: PHPMailer (QQ 邮箱 SMTP)
• 图片处理: Intervention Image (缩略图生成)
• Web 服务器: Nginx + PHP-FPM

👥 用户角色 ​

1. 普通用户 ​

浏览房源列表 · 查看房源详情 · 关键词搜索 · 条件筛选 · 地图找房 · 联系经纪人 · 浏览历史

2. 经纪人 ​

申请成为经纪人 · 发布房源（即发即上） · 管理房源 · 编辑/删除/上下架 · 申请添加小区 · 查看统计数据

3. 管理员 ​

审核经纪人 · 管理所有房源 · 管理用户 · 管理小区 · 审核小区申请 · 管理标签 · 数据统计

🎯 核心功能 ​

用户端 ​

• ✅ 微信小程序登录 / H5 邮箱验证码登录
• ✅ 房源列表浏览（二手房/租房）
• ✅ 房源详情查看（图片轮播、视频播放）
• ✅ 关键词搜索 + 多条件筛选
• ✅ 多种排序（最新/价格/面积/浏览量）
• ✅ 拨打电话联系经纪人
• ✅ 分享房源（微信/朋友圈/海报/链接）
• ✅ 浏览历史记录

经纪人端 ​

• ✅ 申请成为经纪人（管理员审核）
• ✅ 发布房源（选择小区、上传图片/视频、填写信息、添加标签）
• ✅ 我的房源管理（列表、编辑、删除、上下架）
• ✅ 房源数据统计（总数、上架数、浏览量）
• ✅ 申请添加小区

管理后台 ​

• ✅ 数据统计（房源/用户/浏览量、周期对比）
• ✅ 经纪人申请审核
• ✅ 小区申请审核
• ✅ 房源管理（查看、编辑、删除所有房源）
• ✅ 用户管理（禁用/启用）
• ✅ 小区管理（添加、编辑、删除、POI 搜索、周边配套）
• ✅ 房源标签管理

💡 特色亮点 ​

🚀 即发即上，提高效率 ​

房源发布无需审核，直接上线 · 自动生成房源编号（FY202510290001） · 自动生成缩略图 · 房源永久有效

🗺️ 智能小区管理 ​

集成腾讯地图 API · POI 搜索定位小区 · 自动获取经纬度 · 自动获取周边配套（地铁、学校、医院、商场）

💰 零成本运营 ​

本地文件系统存储 · 无需云存储服务 · 图片≤5MB · 视频≤100MB · 自动生成缩略图节省带宽

📊 数据统计分析 ​

房源浏览量统计 · 今日新增数据 · 本周/本月数据对比 · 经纪人房源统计

🔐 灵活的登录方式 ​

微信小程序授权登录 · H5 邮箱验证码登录 · 验证码5分钟有效 · 未登录用户也能浏览房源

🏘️ 灵活的小区数据积累 ​

初始数据库为空，逐步积累 · 管理员通过地图 POI 搜索添加 · 经纪人可申请添加 · 自动获取周边配套

📝 开发计划 ​

总体进度 ​

• [x] Phase 1: 项目需求整理 ✅
• [ ] Phase 2: 核心功能开发（7-10天）
• [ ] Phase 3: 管理后台开发（3-4天）
• [ ] Phase 4: 进阶功能开发（3-5天）
• [ ] Phase 5: 部署上线（1-2天）

MVP 第一阶段（10天快速上线） ​

目标：快速上线最小可用产品，验证核心价值

• [ ] Day 1-2: 基础框架搭建
• [ ] Day 3-4: 房源列表与详情
• [ ] Day 5-6: 发布房源功能
• [ ] Day 7-8: 房源管理功能
• [ ] Day 9: 管理后台
• [ ] Day 10: 测试与部署

📚 文档导航 ​

🔗 技术文档 ​

• uni-app 官方文档
• ThinkPHP 8 官方文档
• 腾讯地图 API
• VitePress 官方文档

📞 联系方式 ​

开发者：张江（全栈开发）
客户方：居美家房产中介公司
服务区域：青岛市北区

居美家房产中介平台
专业 · 高效 · 可靠

开发团队：居美家技术团队
最后更新：2025-10-29