# house

**Repository Path**: unite/house

## Basic Information

- **Project Name**: house
- **Description**: house
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-15
- **Last Updated**: 2026-06-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 长沙二手房异动提醒系统

仅服务长沙地区。用户输入贝壳/链家/安居客房源链接，自动监控价格异动，降价/下架时微信通知。

## 快速开始

```bash
# 环境要求
PHP 7.4 / MySQL 5.7 / Composer

# 安装
composer install
cp .env.example .env
# 编辑 .env 配置数据库连接

# 数据库迁移 + 种子（含管理员账号）
php artisan migrate
php artisan db:seed

# 启动
php artisan serve
```

### 管理员登录

| 字段 | 值 |
|------|-----|
| openid | admin |
| is_admin | 1 |

后台路径：`/admin`，登录页输入 `openid=admin` 即可。

> ⚠ 开发测试方案，不可用于生产环境。

---

## 文档索引

| # | 文档 | 说明 |
|---|------|------|
| 01 | [产品需求（PRD）](01-PRD.md) | 项目背景、用户角色、核心功能、非功能需求 |
| 02 | [系统架构（SAD）](02-SAD.md) | 总体架构、模块划分、核心流程、爬虫架构 |
| 03 | [任务列表](03-Task-List.md) | Sprint 划分、V1 接口范围 |
| 04 | [数据库设计（DDD）](04-数据库详细设计-DDD.md) | 表结构、索引、种子数据 |
| 05 | [接口规范（API）](05-接口规范-API.md) | 接口定义、错误码、幂等语义 |
| 06 | [H5 前端页面设计](docs/product/06-H5前端页面设计.md) | 页面清单、信息架构、核心组件 |
| 07 | [爬虫与成交价采集方案](docs/product/07-爬虫与成交价采集方案.md) | 抓取目标、平台适配、成交价策略 |
| — | [H5 视觉重设计说明](product-notes/h5-visual-redesign-brief.md) | 视觉风格、色彩系统、组件改造 |
| — | [文档审查与修订建议](docs/review/doc-review-for-deepseek.md) | 对 01-05 的问题梳理与改进建议 |

### 文档结构

```
├── 01-PRD.md                         # 产品需求
├── 02-SAD.md                         # 系统架构
├── 03-Task-List.md                   # 任务列表
├── 04-数据库详细设计-DDD.md          # 数据库设计
├── 05-接口规范-API.md                # 接口规范
├── docs/
│   ├── product/
│   │   ├── 06-H5前端页面设计.md       # H5 页面定义
│   │   └── 07-爬虫与成交价采集方案.md  # 爬虫方案
│   └── review/
│       └── doc-review-for-deepseek.md # 文档审查
├── product-notes/
│   └── h5-visual-redesign-brief.md   # 视觉重设计
└── README.md
```

---

## 技术栈

| 层级 | 技术 |
|------|------|
| 后端 | Laravel 8 / PHP 7.4 |
| 数据库 | MySQL 5.7 |
| 缓存 | Redis（V1 可选） |
| 用户端 | Vue2 + ElementUI（SPA） |
| 后台 | Vue2 + ElementUI（独立 SPA） |
| 部署 | Docker / Nginx / Supervisor |

---

## V1 核心功能

- ✅ 房源解析：贝壳/链家/安居客链接标准化 + 信息提取
- ✅ 房源监控：收藏即监控，幂等语义
- ✅ 价格抓取：每日定时全量巡检
- ✅ 异动提醒：降价推送 + 下架推送（微信通知）
- ✅ 历史价格：价格变化曲线
- ✅ 简易后台：房源查看 + 爬虫/通知日志
- ✅ 用户端 H5：首页、录入、监控列表、详情、通知、我的