# housekeeper-miniprogram

**Repository Path**: itweiwei/housekeeper-miniprogram

## Basic Information

- **Project Name**: housekeeper-miniprogram
- **Description**: 管家小程序
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-10
- **Last Updated**: 2025-08-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 管家端小程序 (Housekeeper MiniProgram)

## 项目概述

己悦管家是己悦生活平台专为房屋管家（包括平台管家和公寓管家）打造的专业工作工具，旨在提供高效的房源管理、客户服务和业务流程管理功能。

## 产品定位

专为房屋管家打造的专业工作工具，帮助管家提升工作效率和服务质量，实现房源资源的高效匹配和租赁流程的顺畅执行。

## 核心功能模块

### 平台管家功能
- **房源实勘管理**: 实勘任务接收、现场记录、房源评估
- **房源信息维护**: 房源状态更新、信息完善
- **绩效统计查看**: 实勘数量、上架成功率、绩效排名

### 公寓管家功能  
- **客户管理**: 客户信息记录、需求跟踪、标签管理
- **带看管理**: 带看预约、行程安排、客户反馈记录
- **合同管理**: 合同生成、电子签约、进度跟踪
- **绩效统计**: 带看次数、成交量、收入统计

### 通用功能
- **消息通知**: 任务提醒、客户消息、系统通知
- **个人中心**: 个人信息、工作记录、设置管理

## 目标用户

### 平台管家
- 年龄：25-40岁
- 教育程度：大专及以上  
- 工作经验：房地产或客户服务相关经验1-5年
- 核心职责：房源实勘、信息维护、质量把控

### 公寓管家
- 年龄：22-35岁
- 教育程度：高中及以上
- 工作经验：销售或客户服务相关经验0-3年  
- 核心职责：客户服务、带看签约、关系维护

## 核心价值

1. **全流程数字化管理**: 从房源实勘、客户管理到合同签署的全流程数字化
2. **双角色支持系统**: 同时支持平台管家和公寓管家两种角色
3. **精准绩效追踪**: 实时记录和分析管家的工作数据
4. **智能客户匹配**: 基于客户需求和房源特点，提供智能匹配建议
5. **无缝对接租客端**: 与租客端小程序无缝对接，实现信息同步

## 技术栈

- 框架: 微信小程序原生开发
- UI组件: WeUI / Vant Weapp
- 状态管理: MobX / Redux
- 网络请求: wx.request / 封装的HTTP库
- 地图服务: 腾讯地图API
- 图片处理: 小程序Canvas API

## 开发环境

```bash
# 使用微信开发者工具导入项目

# 安装依赖（如果使用npm构建）
npm install

# 构建项目（如果使用构建工具）
npm run build

# 预览和调试
# 在微信开发者工具中预览和调试
```

## 相关文档

- [管家端小程序PRD](../../../docs/管家端小程序PRD.md)
- [己悦生活平台整体PRD](../../../docs/PRD.md)

## 项目简介

管家端小程序是己悦生活平台面向房屋管家的专业工作工具，支持平台管家和公寓管家两种角色，提供房源管理、客户服务、业务流程管理等功能。

## 功能模块

### 核心功能
- 账户与权限管理（角色区分、权限控制）
- 房源管理（搜索筛选、实勘任务、上下架操作）
- 客户管理（客户信息、跟进记录、标签管理）
- 带看管理（预约安排、带看记录、反馈收集）
- 合同管理（合同生成、签约流程、状态跟踪）
- 物业交割（交割单管理、照片上传、异议处理）
- 绩效管理（出房绩效、实勘绩效、团队排名）

### 角色权限
- **平台管家**: 房源实勘、上下架、出房功能
- **公寓管家**: 客户管理、带看、出房功能

## 目录结构

```
housekeeper-miniprogram/
├── app.js                 # 小程序入口文件
├── app.json               # 小程序配置文件
├── app.wxss               # 全局样式文件
├── project.config.json    # 项目配置文件
├── sitemap.json          # 站点地图配置
├── pages/                # 页面目录
│   ├── index/            # 工作台首页
│   ├── auth/             # 登录认证
│   ├── property/         # 房源管理
│   │   ├── search/       # 房源搜索
│   │   ├── inspection/   # 房源实勘
│   │   └── listing/      # 房源上下架
│   ├── customer/         # 客户管理
│   │   ├── list/         # 客户列表
│   │   ├── detail/       # 客户详情
│   │   └── follow/       # 跟进记录
│   ├── viewing/          # 带看管理
│   │   ├── schedule/     # 带看安排
│   │   ├── record/       # 带看记录
│   │   └── feedback/     # 带看反馈
│   ├── contract/         # 合同管理
│   │   ├── create/       # 创建合同
│   │   ├── list/         # 合同列表
│   │   └── detail/       # 合同详情
│   ├── handover/         # 物业交割
│   │   ├── create/       # 创建交割单
│   │   ├── photos/       # 照片管理
│   │   └── disputes/     # 异议处理
│   ├── performance/      # 绩效管理
│   │   ├── summary/      # 绩效概览
│   │   ├── detail/       # 绩效详情
│   │   └── ranking/      # 团队排名
│   └── profile/          # 个人中心
├── components/           # 自定义组件
│   ├── property-card/    # 房源卡片
│   ├── customer-card/    # 客户卡片
│   ├── viewing-card/     # 带看卡片
│   ├── contract-form/    # 合同表单
│   ├── photo-uploader/   # 照片上传器
│   ├── permission-guard/ # 权限守卫
│   └── performance-chart/# 绩效图表
├── utils/                # 工具函数
│   ├── api.js           # API接口
│   ├── auth.js          # 认证工具
│   ├── permission.js    # 权限管理
│   ├── storage.js       # 存储工具
│   └── camera.js        # 相机工具
├── assets/               # 静态资源
│   ├── images/          # 图片资源
│   └── icons/           # 图标资源
└── libs/                 # 第三方库
    ├── chart.js/        # 图表库
    └── moment/          # 时间处理库
```

## API接口

### 账户与权限相关
- POST /api/v1/housekeeper/auth/login - 管家登录
- GET /api/v1/housekeeper/profile - 获取管家信息
- GET /api/v1/housekeeper/permissions - 获取权限列表

### 房源管理相关
- GET /api/v1/properties - 获取房源列表
- POST /api/v1/properties/search - 搜索房源
- GET /api/v1/inspections - 获取实勘任务列表
- POST /api/v1/inspections/{id}/complete - 完成实勘任务
- POST /api/v1/properties/{id}/listing - 上架房源

### 客户管理相关
- GET /api/v1/customers - 获取客户列表
- POST /api/v1/customers - 创建客户
- POST /api/v1/customers/{id}/follow - 添加客户跟进记录
- POST /api/v1/customers/{id}/reminder - 设置客户提醒

### 带看管理相关
- GET /api/v1/viewings - 获取带看列表
- POST /api/v1/viewings - 创建带看预约
- POST /api/v1/viewings/{id}/complete - 完成带看
- POST /api/v1/viewings/{id}/feedback - 记录带看反馈

### 合同管理相关
- GET /api/v1/contracts - 获取合同列表
- POST /api/v1/contracts - 创建合同
- POST /api/v1/contracts/{id}/send - 发送合同给客户签署
- GET /api/v1/contracts/{id}/status - 获取合同状态

### 物业交割相关
- GET /api/v1/handovers - 获取物业交割单列表
- POST /api/v1/handovers - 创建物业交割单
- POST /api/v1/handovers/{id}/photos - 上传物业交割单照片
- POST /api/v1/handovers/{id}/send - 发送物业交割单给租客确认

### 绩效管理相关
- GET /api/v1/performance/summary - 获取绩效概览
- GET /api/v1/performance/detail - 获取绩效详情
- GET /api/v1/performance/ranking - 获取团队排名
- GET /api/v1/performance/commission - 获取佣金明细

## 权限控制

### 平台管家权限
- 房源实勘功能
- 房源上下架功能
- 房源质量管理
- 实勘绩效查看

### 公寓管家权限
- 客户管理功能
- 带看管理功能
- 合同管理功能
- 出房绩效查看

## 开发规范

1. 基于角色的权限控制
2. 组件化开发，支持权限守卫
3. 统一的数据状态管理
4. 完善的错误处理机制
5. 离线功能支持
6. 性能优化和用户体验

## 部署说明

1. 开发环境：微信开发者工具
2. 测试环境：微信小程序测试版
3. 生产环境：微信小程序正式版

## 注意事项

- 需要配置企业微信相关权限
- 需要实现角色权限验证
- 需要支持相机和位置权限
- 遵循企业级应用安全规范