xiangan/README.md

祥安e家 - 社区管理系统

项目介绍

祥安e家是一个基于uni-app开发的社区管理小程序，为社区居民提供便捷的物业服务、生活缴费、访客管理等功能。

功能模块

1. 用户认证

• 业主认证
• 家属认证
• 租客认证

2. 物业服务

• 物业缴费
• 报修服务
• 投诉建议
• 问卷调查

3. 访客管理

• 访客邀请（业主邀请）
• 访客登记（外卖/快递人员登记）
  • 二维码扫描登记
  • 访客信息填写（身份证、姓名、电话、车牌号等）
  • 访问房号和目的选择
  • 访客记录查看

4. 小区二维码管理

• 为每个小区生成专属访客登记二维码
• 二维码保存和打印功能

5. 生活服务

• 生活缴费
• 餐饮服务
• 快递服务
• 远程开门

新增访客登记功能说明

功能描述

为满足小区安全管理需求，系统新增访客登记功能，主要服务于外卖员、快递员等配送人员。通过在小区保安亭等位置张贴专属二维码，访客扫码后需完成注册登录并填写相关信息，认证成功后方可进入小区送货。

实现流程

1. 物业管理人员操作：

   • 进入"二维码管理"页面
   • 选择对应小区生成专属二维码
   • 打印并张贴到保安亭等位置

2. 访客操作流程：

   • 扫描小区专属二维码
   • 系统自动识别小区信息
   • 如未登录，跳转至登录页面
   • 填写访客信息（身份证、姓名、电话、车牌号、身份）
   • 选择访问房号和访问目的
   • 提交登记信息
   • 系统记录访客信息并通知对应业主

技术实现

• 前端：uni-app + uView UI
• 页面：
  • pages/user/visitor-register.vue - 访客登记页面
  • pages/user/visitor-record.vue - 访客记录查看页面
  • pages/user/visitor-detail.vue - 访客详情页面
  • pages/user/qr-scanner.vue - 二维码扫描页面
  • pages/user/village-qr-manage.vue - 小区二维码管理页面
• API接口：
  • api/visitor.js - 访客相关接口

页面功能详情

访客登记页面

• 自动识别扫码进入的小区信息
• 访客基本信息填写（姓名、手机号、身份证号、车牌号）
• 身份选择（外卖员、快递员、跑腿员等）
• 访问信息填写（房号选择、访问目的）
• 表单验证和数据提交

访客记录查看页面

• 展示访客登记记录列表
• 显示访客基本信息和访问信息
• 查看记录详情

访客详情页面

• 展示访客详细信息
• 显示登记时间、状态等信息

二维码扫描页面

• 调用摄像头扫描二维码
• 支持从相册选取二维码图片
• 闪光灯控制功能

小区二维码管理页面

• 展示所有小区列表
• 为每个小区生成专属访客登记二维码
• 二维码保存功能

开发说明

目录结构

.
├── api                 # 接口请求
├── components          # 公共组件
├── config              # 配置文件
├── js_sdk             # 第三方SDK
├── pages              # 页面文件
│   ├── user           # 用户相关页面
│   ├── service        # 服务相关页面
│   └── ...            # 其他页面
├── static             # 静态资源
├── util               # 工具函数
└── ...

新增页面

• pages/user/visitor-register.vue
• pages/user/visitor-record.vue
• pages/user/visitor-detail.vue
• pages/user/qr-scanner.vue
• pages/user/village-qr-manage.vue

新增API

• api/visitor.js

部署说明

1. 安装依赖：npm install
2. 运行开发环境：npm run dev:%PLATFORM%
3. 构建生产环境：npm run build:%PLATFORM%

注意事项

1. 访客登记功能需要后端接口支持
2. 二维码生成需要后端提供生成服务
3. 访客信息提交需要进行数据验证和安全处理