共享规则
代理商系统跨页面复用的统一产品规则和需求状态口径。
本页定义代理商系统跨页面共用的产品规则。页面 PRD 只写本页没有覆盖的差异；不得自行另起筛选、分页、权限、导出或异常口径。
| 标签 | 统一口径 |
|---|
Confirmed | 已确认需求，可作为实现、测试、培训和客服解释依据。 |
Inferred from Figma | 根据 Figma 推断的临时规则，需要在进入开发或上线前复核。 |
Open Question | 未确认问题，必须写当前默认处理、影响角色、是否阻塞上线和待确认方。 |
| 规则项 | 统一口径 |
|---|
| 支持语言 | English、Korean、简体中文 |
| 默认语言判断 | 本地保存语言 > 浏览器语言映射 > English |
| 生效方式 | 语言切换后当前页即时生效，不整页白屏刷新 |
| 持久化方式 | 在当前浏览器保留 180 天 |
| 文案来源 | 所有页面文案必须使用统一文案表，不允许在页面内写死 |
| 错误提示规范 | 先给可行动提示，再给必要原因，不展示技术性堆栈或内部错误 |
| 规则项 | 统一口径 |
|---|
| 登录方式 | 用户名 + 密码 |
| 空闲超时 | 30 分钟 |
| 绝对有效期 | 12 小时 |
| 续期机制 | 到期前 5 分钟内允许无感续期一次，失败则要求重新登录 |
| 会话失效表现 | 跳回登录页，展示 Session expired 类提示 |
| 页面显示 | 仅展示当前用户有权限访问的菜单和页面入口 |
| 默认落地页 | 指定跳转目标 > 上次有效访问页 > 系统默认页 > Data Report |
| 无权限处理 | 目标页无权限时回退到下一个合法页面；若无合法页面，进入无权限说明页 |
| 权限粒度 | 页面导航、按钮展示、数据查询、数据操作和导出权限必须分别校验 |
| 场景 | 统一规则 |
|---|
| Search / Apply | 提交条件后刷新当前结果集，并回到第 1 页。 |
| Reset | 恢复当前页面默认查询条件，并刷新当前结果集。 |
| Clear | 只清空当前控件或面板草稿，不直接刷新结果。 |
| 条件 chips | 必须真实反映已提交条件；删除 chip 后立即刷新结果并回到第 1 页。 |
| 筛选草稿 | 未点击 Search / Apply 前不得影响已生效列表。 |
| 多选逻辑 | 同一筛选组内多选按 OR，不同筛选组之间按 AND。 |
| 每页条数 | 改变每页条数后回到第 1 页。 |
| 切页 | 保留已提交搜索词和筛选条件，不保留未提交草稿。 |
| 场景 | 统一规则 |
|---|
| 数据范围 | 列表、汇总卡、Total 行、分页计数和导出必须使用同一已生效条件。 |
| 宽表 | 横向滚动只影响当前页面或当前弹窗，不影响其他页面。 |
| 空结果 | 保留筛选区、表头和容器，表格主体展示空态。 |
| 导出权限 | 无导出权限时隐藏或禁用导出入口。 |
| 导出范围 | 导出字段、排序、筛选条件、脱敏规则必须与当前页面一致。 |
| 敏感信息 | IP、设备、银行账号、失败原因、金额等敏感字段按权限脱敏，日志和截图留存也需遵守敏感信息规则。 |
| 规则项 | 统一口径 |
|---|
| 按钮策略 | 主按钮可常态点击，点击后再做输入校验，除非页面明确要求禁用态。 |
| 必填项标识 | 标签后使用红色 *，同时在错误态给出具体文案。 |
| Enter 行为 | 在可提交表单中，Enter 等价于点击主按钮。 |
| 提交中 | 按钮显示 loading，相关字段只读，禁止重复提交。 |
| 自动填充 | 必须兼容浏览器自动填充，不得因样式覆盖导致内容不可见。 |
| 粘贴行为 | 表单应允许粘贴，除非业务有明确安全限制。 |
| 场景 | 统一规则 |
|---|
| 字段错误 | 使用字段下方 inline error。 |
| 业务失败 | 使用页级 alert / banner，避免只给 toast。 |
| 网络异常 | 保留用户输入、筛选条件和上一次成功结果，并允许重试。 |
| 系统繁忙 | 提示稍后重试，不暴露内部错误细节。 |
| 成功反馈 | 若页面后续有明显跳转，可省略成功 toast，直接进入下一步。 |
| 结果未知 | 不伪造成功或失败，引导用户到对应记录页核对。 |
- 桌面端和移动端必须保持一致的信息架构，不允许删减关键操作。
- 关键按钮始终保留清晰的 hover、focus、loading 状态。
- 错误提示不能只依赖颜色，必须带文本说明。
- 所有页面必须支持键盘 Tab 导航和清晰焦点态。
- 表格、筛选器、状态标签的命名方式必须复用同一词表。
Data Report 默认作为代理商系统首页，除非系统规则或权限规则另行覆盖。- 验证码、二次认证、第三方登录属于独立登录能力；未确认入口、状态、失败处理和会话影响前，不得默认并入 Login。
- 页面需要定制空态、失败态、无权限态或移动端视觉时，必须提供对应设计状态；未提供时按本页默认规则实现。
- 新增跨页面筛选、导出、权限或反馈模式时，优先复用本页已有口径；确需差异时必须在对应页面说明适用范围。