# S02 · 登录身份与小区访问上下文

状态：**业务评审草案 v0.5 / draft**。更新日期：2026-10-15。
来源：PRD 2.2、2.3、8.1–8.3；C-06、R09。
依赖：S01。

## 问题与目标

访客能找到小区公开信息；账号登录后可按房屋和身份进入住户或员工视图。访问小区的选择不能被当作住户授权，也不表示账号当前的地理位置。

## 使用者与需求

- 访客：扫码查看小区公开内容并找到报修入口。
- 多房屋住户：切换房屋、小区并使用相应权限。
- 兼有员工和住户身份的账号：切换使用视图。

## 一期范围

- 小程序登录与身份入口、访问小区选择、房屋切换、固定首页及“我的”入口。

## 业务规则与确认状态

- 【PRD 已定】住户与员工共用小程序；一个账号在不同房屋可有不同身份。
- 【PRD 已定】首页固定四入口：报修、意见反馈、通知公告、常用办事；下方展示我的待办、最新通知及公开信息牌；公共问题进度 F07 本轮移出一期；“我的”入底部导航。
- 【PRD 议】二维码只携带访问小区/楼栋的标识，不授予住户身份；本轮已确认：物业已发布通知全员可读；信息牌按 S13 全员可读；S12 公示不在一期。
- 【已确认待同步 C-06】未绑定可进入报修表单，提交时触发绑定；不能据此放宽实际提交权限。
- 【拆分建议】访问小区与实际办理所用人员—房屋关系须可区分，后者作为服务事项的授权上下文。

- 【本轮用户确认，2026-10-14】一期不读取 GPS、不请求定位权限、不校验账号当前是否在小区；房屋绑定依靠 S04/S05 的身份与授权核验。不在目标小区或未授予定位权限，均不能成为拒绝绑定的理由。

- 【本轮用户确认，S04 简化】业主登录后的归属正确即可使用；有误只提供申诉，由物业自行核对后后台更正，不再加手机号验证/专属邀请/材料审批等业主认领流程。

- 【本轮用户确认，S11】选小区后任何人可读该小区所有已发布物业通知；未登录、未绑定、不同楼栋、超期或退租都不拦阅读。私有房屋服务仍按原绑定/租期规则。

- 【本轮确认】S12 公共问题公示移出一期；S13 是所有人选小区即可看的信息牌，不提供读者身份筛选或办事审批流程。

## 操作前提与业务对象

- 小区已开通；公开内容由 S11 通知及 S13 信息牌提供；S12 延期，关系核验由 S04/S05 提供。
- 各入口区分访客、账号登录、有效人员—房屋关系、员工授权，不把四者合成一个状态。

下列“入口”描述业务上的操作位置，不预设最终菜单名或页面布局。`基线`沿用源文档；`待同步`仍需 PRD 同步；`条件/待裁决/候选`不能视为已批准；`补充建议`为本次新增的待确认细节。主流程中遇到相应条件未定，即表示该分支尚未具备实现依据。

## 用户主流程

| 步骤 | 给谁操作 | 在哪里 | 用户操作 | 可观察结果 / 状态 | 依据与确认等级 |
|---|---|---|---|---|---|
| S02-M01 | 访客 | 小区选择/二维码/分享入口 | 打开小程序直接选小区，或由有效二维码/分享带出小区 | 只确定要浏览的小区，不获取设备地理位置，也不获得住户身份 | 条件：PRD 8.2 议 R09 |
| S02-M02 | 访客 | 首页公开入口 | 查看所选小区的通知和公开信息牌 | 已发布物业通知和信息牌全员可读，无登录/绑定/楼栋/租期门槛；一期没有 F07 公示 | 本轮确认：S11/S13 全公开、S12 延期 |
| S02-M03 | 未登录/未绑定者 | 报修入口 | 进入并填写报修表单 | 可填写；提交时进入身份核验/绑定引导 | 待同步：C-06 |
| S02-M04 | 账号使用者 | 登录/房屋认领入口 | 完成登录，按 S04 查看档案关联的业主房屋；租住授权按 S05 | 正确归属/有效租住关系可用于提交；归属有误可申诉，返回表单细节待定 | 基线权限；S02-D01 |
| S02-M05 | 多房屋住户 | 房屋/小区选择入口 | 选择本次办理房屋 | 展示所选关系的范围，提交关联该关系，不借用其他房屋权限 | 基线：PRD 2.3/2.4 |
| S02-M06 | 兼有员工身份的账号 | 身份视图入口 | 切换住户/员工视图 | 员工动作按 S03 判定；住户动作按选中关系判定 | 基线：PRD 2.2 |
| S02-M07 | 已登录住户 | 首页或“我的” | 查看个人待办、本人记录，进入固定四主入口 | 展示适用事项；首页无物业费入口 | 基线：PRD 8.3 |

## 异常与分支处理

| 分支 | 触发情况 | 系统或业务处理 | 用户/办理者下一步 | 状态与历史影响 | 依据与确认等级 |
|---|---|---|---|---|---|
| S02-E01 | 二维码/分享链接指向的小区不存在或已停用 | 候选：提示该入口不可用，不自动切到任意公司；与用户实际所在地无关 | 重新选择可用的小区或获取有效入口 | 不创建关系 | 补充建议：S02-D02 |
| S02-E02 | 未绑定直接提交报修 | 阻止提交并进入绑定引导 | 完成核验后再提交 | 核验未通过不生成新服务事项 | 待同步：C-06；基线授权 |
| S02-E03 | 切换房屋后仍使用旧表单 | 候选：重新核对实际提交房屋与关系，明确让用户确认或重填 | 按批准交互重新选择 | 不把旧内容默默归入另一房屋 | 补充建议：S02-D01 |
| S02-E04 | 登录失败或拒绝登录 | 不把账号身份显示为已登录 | 重试或继续浏览允许的公开内容 | 是否保留表单及多久待定 | 补充建议：S02-D01；公开范围 R09 |
| S02-E05 | 员工身份已撤销但住户关系仍有效 | 拒绝员工动作，保留有效住户服务 | 切回住户视图 | 原员工历史不改 | 基线：PRD 9.3 |
| S02-E06 | 旧房屋关系已结束 | 拒绝用旧关系提交新事项 | 切换另一有效关系或办理新关系 | 旧记录仍按 S06 范围保留 | 基线：PRD 2.4/4.6 |

异常表对能够从基线确定的处理给出明确结果；无法确定的分支给出候选或明确缺口。没有写成定稿的恢复动作，不由开发者自行补成业务选择。

## 待确认与实现阻塞

- R09：物业通知和小区信息牌阅读均已明确全员公开；公共问题公示 S12 移到后续，不再作为一期阅读需求。
- C-06：登录/绑定返回后是否保留已填内容、保留多久，是尚未定义的交互细节。
- 管理员/员工开通关联已确认：平台指定首个管理员手机号并开通，物业管理员按手机号添加员工并分配小区、操作权限，对应本人账号登录后获得入口；具体登录技术方案另行设计。业主档案登录关联 S04-D03 因尚未取得实际 Excel 暂缓，待资料到手确认，不默认按手机号匹配；不阻塞其他模块业务评审。


### 本次补充的细节待确认

| 本 spec 补充编号 | 需要确认的具体细节 | 受影响位置 |
|---|---|---|
| S02-D01 | 登录/绑定返回表单、暂存期限、切换房屋后保留/清空/确认内容的交互；仅是候选，不默认保存。 | M04；E03–E04；AC06 |
| S02-D02 | 二维码/分享链接指向的小区不存在、停用时的提示与恢复入口；不涉及设备位置或是否在小区内。 | E01 |

## 验收标准与完成条件

### 可逐条核对的验收条件

以下编号稳定用于评审与后续测试追踪；“给定—当—则”只验证用户能观察的结果。条件验收须先批准对应规则；“未决验收占位”表示目前还没有完整预期，不能宣称通过。

| 编号 | 给定前置条件 | 当用户/办理者操作 | 则应观察到的结果 | 验收依据 / 生效前提 |
|---|---|---|---|---|
| S02-AC01 | 仅扫描楼栋码、无有效关系 | 提交私人房屋报修 | 不能靠二维码直接获得房屋权限 | 基线授权；R09 条件 |
| S02-AC02 | 未绑定用户且 C-06 已同步 | 填写表单并提交 | 可进入填写；实际提交先完成关系核验；未成功核验无新事项 | 待同步：C-06 |
| S02-AC03 | A/B 房屋关系都有效 | 切换到 B 后办理服务 | 提交关系与允许内容属于 B，不沿用 A 范围 | 基线：PRD 2.3/2.4 |
| S02-AC04 | 同账号有有效住户关系、已结束员工身份 | 尝试员工动作后使用住户服务 | 员工动作被拒绝；有效住户服务保留 | 基线：PRD 9.3 |
| S02-AC05 | 首页正常显示 | 浏览主要入口 | 只有报修、意见反馈、通知公告、常用办事四主入口；“我的”在底部；无物业费入口 | 基线：PRD 8.3 |
| S02-AC06 | 输入内容后登录失败且返回/保存规则已批准 | 恢复登录或再次进入表单 | 表单内容、实际办理房屋与保存期限符合确定规则，不能串房屋提交 | 条件：S02-D01 |

| S02-AC07 | 账号不在目标小区，或未授予定位权限；档案关联的业主房屋归属正确，或已有 S05 有效租住授权 | 从有效入口进入并完成房屋绑定 | 不请求或读取 GPS，不因人在小区外/无定位权限拒绝绑定；是否成功只按身份与授权核验结果决定 | 本轮用户确认：不做所在地校验 |

| S02-AC08 | 未登录、未绑定或已退租的人 | 直接选择小区后查看已发布物业通知列表和详情 | 可阅读所有已发布内容，不要求登录/绑定/楼栋匹配，也不授予私人房屋办理资格 | 本轮确认：S11 公共阅读 |

### 本 spec 完成的判断

- **文本评审完成**：使用者/目标、范围、主流程、异常和验收均有对应描述；本 spec 的待确认项被明确归类，没有把未知结果藏在“正常处理”中。
- **需求定稿完成**：当前“一期范围”中每个待决业务分支有明确选择；每个条件验收落实为确定前提与预期；未决占位被补齐或范围经明确批准调整。不得仅把条件段删除来宣称完成。
- **功能实现完成**：相关住户、员工、PC 路径按已批准范围贯通，适用基线与已生效条件验收逐条通过；越权/异常分支、状态和历史可核对。文档新增表格不表示功能已实现或测试已通过。
- **交接完成**：留下实际验收记录及未完事项；其他 spec 的必要权限/身份/收费/可见范围合同一致，没有只让主流程通过而遗漏关键分支。

## 不在本 spec 内

- 页面装修、外链主入口、物业费入口。
- GPS 定位、是否在小区内判定、定位权限授权及基于实际所在地的绑定限制。

## 后续开发切片建议

1. 扫码进入一个小区并浏览一项公开信息。
2. 完成登录、房屋切换及身份视图切换，并验证提交拦截。

开发切片须贯通相关界面、业务处理与可观察结果；不要拆成孤立的“先全部建表，再全部接口，再全部页面”。以上是顺序建议，不是已发布任务。

## 技术设计边界

本 spec 不预设数据库结构、接口地址、模块路径、状态落库方式或测试框架。规则批准后，再结合现有代码和技术约束形成设计与开发任务；验收验证外部行为、权限拒绝与关键边界，避免只测试实现细节。

文档覆盖检查见 [17-规格完整性检查.md](../specs/17-规格完整性检查.md)。

确认等级、全局边界与来源处理见 [00-拆分总览.md](../specs/00-拆分总览.md)；决策追踪见 [16-决策与覆盖矩阵.md](../specs/16-决策与覆盖矩阵.md)。