PRODUCT REQUIREMENTS DOCUMENT

密码本产品需求文档

集中管理，安全高效。本文档用于产品、设计、开发和测试共同评审密码本的目标、范围与核心流程。

返回原型 验收标准

0. 文档信息

产品名称密码本
文档类型产品需求文档（PRD）
当前版本V1.2 修订稿

0.1 文档说明

本文档覆盖产品概要、页面流程、功能需求、数据与接口约定和验收标准。

1. 产品背景

内部工作人员通常需要使用多个政务或业务平台，每个平台具有独立的登录地址、账号和密码。现有使用方式容易出现以下问题：

  • 平台入口分散，查找登录地址耗时；
  • 账号密码依赖人工记录，容易遗忘或填错；
  • 不同平台之间频繁切换，无法快速完成登录准备；
  • 平台分类和使用记录缺少统一管理；

密码本通过统一的平台入口和凭据管理能力，帮助用户集中维护平台登录信息，并在打开真实登录地址的同时快速获取对应账号密码。

2. 用户痛点

2.1 入口查找困难

平台数量增加后，用户需要在浏览器收藏夹、聊天记录、文件或搜索引擎中查找平台地址，效率较低。

2.2 凭据管理分散

账号和密码缺少统一记录位置，用户可能重复维护、错误使用或无法及时找到对应凭据。

2.3 登录切换成本高

用户打开平台后仍需要返回其他页面查找账号密码，多个页面之间切换不便。

2.4 平台信息缺少分类

不同业务平台混在一起时，用户难以按业务范围快速定位目标平台。

3. 产品目标

密码本通过统一的平台入口、分类和账号密码管理能力，帮助用户集中维护平台登录信息，快速查找平台、打开真实登录地址并复制对应凭据，同时提供密码显示控制、最近使用和回收站能力，提升日常登录效率和信息管理的可控性。

4. 目标用户与使用场景

4.1 目标用户

本期面向单一内部用户，典型用户为需要日常登录多个政务或业务系统的工作人员。

4.2 典型使用场景

首次维护平台

用户新增平台，填写名称和登录地址，可选填账号、密码和备注；未选择分类时自动归入“未分类”，保存后平台出现在列表中。

快速登录平台

用户点击“登入系统”，新页签打开真实登录地址，同时在密码本页面中央展示密码助手。

查看或更新凭据

用户查看平台详情，查看账号密码、登录地址和备注，并进入编辑页面更新信息。

按分类查找平台

用户通过左侧分类筛选平台，分类名称可编辑，只有空分类可以删除。

查找最近使用的平台

用户查看最近30天内使用过的平台及最近一次使用时间，定位常用平台。

恢复误删平台

用户进入回收站确认平台名称、域名和删除时间，可恢复平台及原分类和凭据。

5. 产品范围

5.1 本期包含

  • 平台导航与平台列表；
  • 平台新增、编辑和移入回收站；
  • 平台名称、登录地址、所属分类、Logo自动获取与展示和备注维护；
  • 每个平台一组账号和密码维护；
  • 账号复制、密码复制；
  • 密码默认隐藏、显示/隐藏切换；
  • 点击“登入系统”打开真实登录地址新页签；
  • 密码本中央密码助手弹窗；
  • 分类新增、编辑和空分类删除；
  • 最近30天使用记录及最近使用时间展示；
  • 回收站平台恢复、单条彻底删除和全部删除；
  • 后台持久化的数据保存能力；
  • URL格式校验和必要的操作反馈。

5.2 平台信息规则

  • 平台名称为必填字段；
  • 登录地址为必填字段；
  • 所属分类为非必填字段，未选择时自动归入“未分类”；
  • 账号和密码允许为空；
  • Logo优先自动获取网站Logo，获取失败时展示平台名称首字图标；
  • Logo获取失败不阻塞平台保存；
  • 每个平台本期只维护一组账号密码；
  • 登录地址只校验URL格式，不负责检测目标网站是否可访问。

5.3 默认分类

  • 系统首次初始化时自动创建5个预制分类：党建工作、村务管理、财务管理、民政服务、乡村振兴。
  • 上述分类覆盖村级干部日常使用频率较高的党建、村务、财务、民政和乡村振兴类平台。
  • 用户可以直接使用预制分类，也可以编辑分类名称；分类下无平台时可以删除，分类下有平台时不展示删除入口。

6. 核心流程概述

6.1 新增平台流程

  1. 用户点击“新增平台”；
  2. 系统打开新增平台表单；
  3. 用户填写平台名称和登录地址，可选择所属分类；
  4. 用户可选填写备注、账号和密码；
  5. 用户提交表单；
  6. 系统校验必填项及登录地址格式；
  7. 校验通过后保存平台及凭据；
  8. 系统关闭表单并刷新平台列表、分类数量和统计数据。

6.2 登录平台流程

  1. 用户在平台卡片或详情中点击“登入系统”；
  2. 系统在新页签打开平台真实登录地址；
  3. 系统记录平台最近一次使用时间；
  4. 原密码本页面保持不变；
  5. 密码本页面中央展示对应平台的密码助手；
  6. 用户复制账号或密码，或点击眼睛按钮显示/隐藏密码；
  7. 用户主动关闭助手，或点击弹窗外区域关闭助手。

6.3 编辑平台流程

  1. 用户选择平台并打开详情；
  2. 用户点击“编辑”；
  3. 系统打开编辑表单并回填当前平台信息和凭据；
  4. 用户修改平台字段或账号密码；
  5. 系统校验必填项和登录地址格式；
  6. 保存成功后刷新平台卡片、详情、统计和相关筛选结果。

6.4 分类管理流程

  1. 用户新增分类或编辑已有分类名称；
  2. 系统校验分类名称不能为空且不能与现有分类重复；
  3. 分类保存成功后刷新左侧分类列表和平台数量；
  4. 当分类下无平台时显示删除入口；
  5. 用户删除空分类并确认后，系统移除该分类；
  6. 当分类下存在平台时，不显示删除入口或阻止删除。

6.5 回收站流程

  1. 用户在平台详情中点击“删除”；
  2. 系统提示确认，将平台及其凭据移入回收站；
  3. 回收站记录保存原分类、平台信息、凭据和删除时间；
  4. 用户可恢复平台，恢复后回到原分类并恢复凭据；
  5. 用户可选择单条彻底删除或“全部删除”；
  6. 彻底删除前进行二次确认，确认后不可恢复；
  7. 回收站无内容时展示空状态，有内容时仅展示平台列表。

6.6 最近使用流程

  1. 用户点击“最近使用”；
  2. 系统筛选最近30天内有使用记录的平台；
  3. 系统按最近一次使用时间倒序展示；
  4. 每条记录展示平台名称及具体使用时间；
  5. 用户可继续查看详情或登入系统。

7. 详细功能需求

7.1 平台导航与搜索

  • 平台卡片展示平台名称、Logo或首字图标、登录域名、所属分类和登入系统入口。
  • 搜索支持平台名称、域名、备注关键字，忽略首尾空格，不区分大小写。
  • 全部平台按默认排序展示；最近使用按最近使用时间倒序；收藏按收藏状态筛选。
  • 无匹配结果时展示空状态，不影响其他筛选入口使用。
  • 点击平台卡片任意内容区域打开平台详情；点击收藏、登入系统等操作按钮时不触发详情选择。

7.2 平台新增与编辑

  • 平台名称和登录地址为必填字段，页面使用红色星号标识。
  • 所属分类、账号、密码和备注为非必填字段。
  • 平台名称长度限制由前端和后端共同校验，建议不超过40个字符。
  • 登录地址必须符合URL格式；系统不检测目标网站是否可访问。
  • 保存成功后关闭表单，刷新平台卡片、分类数量、统计数量和详情内容。
  • 编辑时回填全部当前字段；取消或关闭不保存未提交修改。
  • 重复提交需要防抖或提交中禁用，避免生成重复平台。

7.3 Logo获取与展示

  • 系统根据登录地址自动获取网站Logo。
  • Logo加载失败、超时或资源格式不支持时，展示平台名称首字图标。
  • Logo失败不阻塞平台新增、编辑和登入系统。
  • Logo必须提供替代文本或作为装饰性图片处理，不能出现空白卡片。

7.4 账号密码管理

  • 每个平台只维护一组账号和密码。
  • 密码默认以掩码展示；点击眼睛按钮切换明文和掩码。
  • 关闭详情、切换平台、关闭助手或重新打开助手时，密码恢复为隐藏状态。
  • 账号和密码均支持复制，复制成功后给出明确反馈。
  • 账号或密码未配置时显示“未配置”，复制操作提示用户先完善信息。
  • 密码输入和展示不得因为内容过长破坏页面布局。

7.5 登入系统与密码助手

  • 点击“登入系统”后调用新页签打开平台真实登录地址。
  • 密码本主页面保持原状态，不被第三方平台页面替换。
  • 新页签打开后，密码助手在密码本页面中央展示。

7.6 分类管理

  • 首次初始化时自动创建党建工作、村务管理、财务管理、民政服务、乡村振兴5个预制分类。
  • 支持新增分类和编辑分类名称。
  • 分类名称不能为空，且不能与当前已有分类重复。
  • 分类下无平台时显示删除图标；分类下有平台时不展示删除入口。
  • 删除分类前进行确认，删除后刷新左侧分类列表和数量。
  • 分类删除不影响其他分类和回收站数据。

7.7 最近使用

  • 用户点击登入系统时记录平台最近一次使用时间。
  • 最近使用展示最近30天内有记录的平台。
  • 每个平台展示平台名称和具体使用时间。
  • 时间按用户所在时区展示，具体时区规则在技术方案中确定。
  • 超过30天的记录不出现在最近使用列表，但不立即删除历史数据。

7.8 回收站

  • 平台移入回收站时保存平台基础信息、账号密码、原分类和删除时间。
  • 回收站卡片展示平台名称、登录域名、删除时间和操作按钮。
  • 恢复平台后回到原分类，并恢复删除前的账号密码和平台信息。
  • 单条彻底删除需要二次确认，确认后不可恢复。
  • 全部删除按钮在回收站有内容时可用，点击后需要二次确认。
  • 回收站数量为0时显示空状态；数量超过99时显示“99+”。

8. 数据与接口约定

8.1 核心数据实体

实体核心字段说明
Platformid、name、loginUrl、logoUrl、categoryId、note、isFavorite、sortOrder、lastUsedAt平台入口及展示信息
CredentialplatformId、username、password、note、updatedAt、passwordChangedAt平台对应的一组登录凭据
Categoryid、name、sortOrder平台分类，首次初始化时创建5个预制分类
UsageRecordid、platformId、usedAt、userId平台使用记录，可用于最近使用查询
TrashItemid、platformSnapshot、credentialSnapshot、categorySnapshot、trashedAt回收站中的平台快照

8.2 接口业务语义

接口能力业务动作成功结果
查询平台列表按搜索、分类、收藏或最近使用筛选返回平台列表及统计信息
初始化默认分类首次初始化密码本时创建5个预制分类返回默认分类列表
新增平台保存平台信息和凭据返回平台ID及完整平台记录
编辑平台更新平台字段和凭据返回更新后的平台记录
记录平台使用打开平台时写入最近使用时间返回最新使用时间
移入回收站创建回收站快照并移除活动平台返回回收站记录
恢复平台从回收站恢复原平台、分类和凭据返回恢复后的平台记录
彻底删除删除一条或全部回收站记录返回删除结果和剩余数量

8.3 数据一致性要求

  • 平台、凭据、分类和回收站记录使用稳定ID关联。
  • 平台删除和回收站快照写入应保持原子性，避免出现平台已删除但回收站无记录。
  • 恢复平台时需校验原分类是否仍存在；不存在时进入预设兜底分类或阻止恢复，具体方案待技术评审。
  • 列表、详情、统计数量和回收站数量应在操作成功后同步刷新。

9. 字段校验

9.1 字段校验

字段规则失败提示
平台名称必填，不超过约定长度，不允许纯空格请输入平台名称
登录地址必填，必须符合URL格式请输入有效的平台登录地址
账号/密码允许为空，按字符串保存未配置时提示用户完善信息

10. 验收标准

10.1 平台与凭据

  • 可以新增平台，平台名称或登录地址缺失时不能保存，未选择分类时自动归入“未分类”。
  • 登录地址格式错误时给出明确提示，不提交无效数据。
  • 可以编辑平台名称、地址、分类、备注和账号密码，保存后列表和详情同步更新；Logo由系统自动获取或生成。
  • 账号和密码为空时平台仍可保存，详情和助手显示未配置状态。
  • 密码默认隐藏，眼睛按钮可以显示和恢复隐藏，关闭或切换后重新隐藏。
  • 复制账号和密码成功后有反馈，内容为空时不给出误导性成功提示。

10.2 登录与助手

  • 点击任意“登入系统”均打开对应真实登录地址新页签。
  • 打开新页签后密码本原页面内容保持不变。
  • 助手在密码本页面中央显示，不依赖浏览器置顶、画中画或并排窗口。
  • 点击助手外部关闭，点击助手内部不会误关闭。
  • 助手只展示已约定的复制、显示/隐藏和关闭操作。

10.3 分类与最近使用

  • 首次初始化时自动创建党建工作、村务管理、财务管理、民政服务、乡村振兴5个预制分类，用户可以直接使用、编辑或删除空分类。
  • 分类名称可以新增和编辑，空分类显示删除图标，有内容分类不显示删除入口。
  • 最近使用只展示最近30天记录，并按时间倒序展示具体时间。
  • 平台登入系统后最近使用时间更新，统计数量和列表同步变化。

10.4 回收站

  • 平台删除确认后进入回收站，并从活动平台列表移除。
  • 回收站展示平台名称、登录域名和删除时间。
  • 恢复后平台回到原分类，账号密码和平台字段完整恢复。
  • 单条彻底删除和全部删除均需要二次确认，确认后不可恢复。
  • 回收站有内容时不显示空状态；无内容时不显示列表。
  • 数量超过99时，入口和页面数量均显示99+。

10.5 体验

  • 主页面和回收站页面均可直接打开，不出现白屏或控制台新增错误。
  • 刷新页面后已保存数据仍可正常读取。
  • 中文文案、图标、Logo和默认首字图标均正常显示。