业主端小程序 作为 物业管理系统 的一部分，作为住户主要登录的入口。
修改原因：由于小区住户已有住户信息的情况下，一直以为还需要走 去认证 功能。
原功能：存在手机号登陆 和 去认证 两个功能，去认证用于系统登记的住户手机号与住户真实使用的手机号不一致，让住户填写认证信息成功后修改手机号。
现功能：保留手机号登陆，修改 去认证 功能，在选择认证的房屋下，
1、手机号已存在，且证件号一致的情况下；提示系统已存在手机号，是否直接登录，确认后进入使用手机号进入小程序，房屋默认为填写认证的房屋；
2、手机号不存在，但姓名+证件号存在的情况下，更新住户信息手机号后，选中认证房屋后进入小程序；
3、手机号、姓名、证件号都不存在的情况 / 手机号存在+姓名、证件号都不存在的情况 下，判断房屋状态 是否是 已出租/已出售 的情况。
如果是已出租/已出售，将住户信息提交到住户审核里，并且使用服务号一次性推送，让住户选择是否推送审核信息；
如果是未出租/未入住，提示住户“选择的房屋未进行入住登记，请到管理处办理”。
详细的业务流程说明：
业主小程序登录认证流程图
流程说明
本流程图描述了业主端小程序的登录认证逻辑，包含手机号登录和认证登录两种方式。
完整流程图
三种主要认证场景详解
场景1: 手机号已存在 + 证件号一致
住户填写认证信息
↓
系统检测: 手机号已存在 且 证件号一致
↓
弹窗提示: "系统已存在该手机号，是否直接登录?"
↓
用户确认
↓
使用该手机号登录，默认房屋设置为填写的认证房屋
↓
进入小程序
场景2: 手机号不存在 + 姓名+证件号存在
住户填写认证信息
↓
系统检测: 手机号不存在 但 姓名+证件号存在
↓
自动更新住户档案中的手机号
↓
选中认证房屋
↓
进入小程序
场景3: 手机号/姓名/证件号都不存在（或手机号存在但姓名证件号不匹配）
住户填写认证信息
↓
系统检测: 信息不匹配或不存在
↓
检查填写的房屋状态
↓
┌─────────────────┬─────────────────┐
│ 已出租/已出售 │ 未出租/未入住 │
└─────────────────┴─────────────────┘
↓ ↓
提交住户信息到审核 提示: "选择的房屋未进行
↓ 入住登记，请到管理处办理"
询问是否允许服务号推送 ↓
↓ ↓ 流程结束
是 否
↓ ↓
订阅推送 等待审核
↓ ↓
等待审核
↓
物业审核
↓
┌────┴────┐
↓ ↓
审核通过 审核驳回
↓ ↓
创建档案 记录原因
↓ ↓
已订阅? 已订阅?
↓ ↓ ↓ ↓
是 否 是 否
↓ ↓ ↓ ↓
推送 无 推送 无
通过 驳回
消息 消息
↓ ↓
进入 流程
小程序 结束
关键业务规则
1. 匹配优先级
优先匹配: 手机号 + 证件号
次级匹配: 姓名 + 证件号
房屋状态检查: 都不匹配时检查房屋状态
2. 房屋状态判断
已出租/已出售: 允许提交认证审核
未出租/未入住: 不允许认证，需到管理处办理
3. 手机号更新规则
仅在"手机号不存在 + 姓名证件号存在"场景下自动更新
其他场景不自动更新，需走审核流程
4. 审核推送
提交审核时询问住户是否允许服务号推送
住户同意后订阅服务号一次性消息推送
审核完成后（通过/驳回）自动推送结果通知
推送内容：
审核通过：通知可以登录使用
审核驳回：通知驳回原因，提示可重新提交
数据字段说明
认证表单字段
字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
房屋ID | String | 是 | 选择要认证的房屋 |
姓名 | String | 是 | 住户真实姓名 |
证件号 | String | 是 | 身份证号码 |
手机号 | String | 是 | 住户当前使用的手机号 |
系统检查逻辑
查询住户表:
WHERE phone = 输入手机号查询住户表:
WHERE name = 输入姓名 AND id_card = 输入证件号查询房屋表:
WHERE house_id = 选择房屋ID AND status IN (已出租, 已出售, 未出租, 未入住)
错误提示文案
场景 | 提示文案 |
|---|---|
微信授权失败 | "获取手机号失败，请重试或选择去认证" |
手机号未注册 | "该手机号未注册，请先进行认证" |
手机号已存在 | "系统已存在该手机号，是否直接登录？" |
房屋未登记 | "选择的房屋未进行入住登记，请到管理处办理" |
审核驳回 | "您的认证申请已被驳回，原因：{驳回原因}" |
技术实现要点
1. 前端交互
认证表单需实时校验（姓名、证件号、手机号格式）
房屋选择支持搜索和筛选（楼栋-单元-房号）
提交后显示加载状态
审核状态实时查询
2. 后端接口
POST /api/auth/wechat-login- 微信授权手机号登录POST /api/auth/verify- 提交认证信息GET /api/auth/check-status- 查询审核状态POST /api/auth/notify- 发送审核推送
3. 数据库操作
住户表查询（手机号、姓名+证件号）
房屋表查询（房屋状态）
住户审核表插入（新增审核记录）
住户表更新（手机号更新）
4. 消息推送
使用微信服务号一次性订阅消息
推送时机：
审核通过时推送（如果住户已订阅）
审核驳回时推送（如果住户已订阅）
推送内容：
通过消息：审核通过通知 + 登录引导
驳回消息：审核驳回通知 + 驳回原因 + 重新提交入口