480 lines
13 KiB
Markdown
480 lines
13 KiB
Markdown
# 电子名片系统产品功能文档
|
||
|
||
## 1. 文档目的
|
||
|
||
本文档用于明确“电子名片 + 多租户后台管理系统”项目的业务目标、角色权限、功能范围、核心流程与交付边界，作为后续产品设计、技术开发、联调测试和验收的统一依据。
|
||
|
||
## 2. 项目概述
|
||
|
||
### 2.1 项目定位
|
||
|
||
本项目面向律师事务所、咨询机构、专业服务组织等“事务所型租户”，提供一套可运营、可配置、可扩展的电子名片系统：
|
||
|
||
- 前台：微信小程序，用于展示事务所信息、人员名片信息，并提供分享、拨号、导航、加联系人等能力。
|
||
- 后台：多租户管理系统，用于平台管理、租户管理、组织管理、用户管理、名片维护、素材管理和数据统计。
|
||
- 后端：统一提供租户、用户、名片、文件、统计等 API 服务，支撑小程序与后台管理系统。
|
||
|
||
### 2.2 业务目标
|
||
|
||
- 帮助事务所快速搭建统一品牌形象的电子名片体系。
|
||
- 帮助租户管理员统一维护事务所、部门、律师/员工信息。
|
||
- 帮助普通用户便捷维护个人电子名片，提高对外传播效率。
|
||
- 帮助平台方通过多租户能力统一服务多个事务所，降低交付和运维成本。
|
||
|
||
### 2.3 当前仓库现状
|
||
|
||
当前仓库已包含微信小程序静态原型，已具备以下页面雏形：
|
||
|
||
- 律所主页
|
||
- 律师列表页
|
||
- 律师详情页
|
||
- 浏览历史页
|
||
|
||
现阶段页面主要依赖本地 Mock 数据，后续需改造为对接后端接口的动态数据版本。
|
||
|
||
## 3. 目标用户与角色定义
|
||
|
||
### 3.1 角色划分
|
||
|
||
系统包含 3 类后台角色与 1 类前台访问身份：
|
||
|
||
| 角色 | 身份说明 | 核心职责 |
|
||
| --- | --- | --- |
|
||
| 超级管理员 | 平台运营方 | 管理租户、平台账号、平台配置、全局字典、全局监控 |
|
||
| 租户管理员 | 某个事务所的管理员 | 管理本租户的组织、人员、事务所资料、名片内容、素材与数据 |
|
||
| 普通用户 | 某个事务所下的成员 | 登录后台维护个人名片资料、查看个人数据、预览和分享名片 |
|
||
| 小程序访客 | 公众用户 | 浏览事务所主页、查看名片、拨号、保存联系人、导航、分享 |
|
||
|
||
### 3.2 权限边界
|
||
|
||
| 功能模块 | 超级管理员 | 租户管理员 | 普通用户 |
|
||
| --- | --- | --- | --- |
|
||
| 平台登录 | 支持 | 不支持 | 不支持 |
|
||
| 租户后台登录 | 可模拟排查 | 支持 | 支持 |
|
||
| 租户管理 | 全部 | 无 | 无 |
|
||
| 事务所信息维护 | 可查看 | 全部 | 只读 |
|
||
| 部门/组织维护 | 可查看 | 全部 | 只读 |
|
||
| 用户账号管理 | 全部 | 管理本租户用户 | 仅维护本人登录资料 |
|
||
| 角色授权 | 全部 | 分配本租户角色 | 无 |
|
||
| 名片信息维护 | 可查看 | 管理本租户全部名片 | 管理本人名片 |
|
||
| 素材管理 | 可查看 | 管理本租户素材 | 仅上传/替换本人素材 |
|
||
| 统计分析 | 全局 | 本租户 | 本人 |
|
||
| 数据隔离 | 平台可见全部 | 仅本租户 | 仅本人/本租户授权范围 |
|
||
|
||
## 4. 核心业务对象
|
||
|
||
### 4.1 核心对象
|
||
|
||
- 租户：一个事务所或公司/组织，是系统中的一级业务单元。
|
||
- 组织：租户下的部门、分所、业务组。
|
||
- 用户：租户下的可登录成员。
|
||
- 名片：用户对外展示的信息载体。
|
||
- 事务所主页：租户对外展示的机构简介、地址、专业领域、联系方式等信息。
|
||
- 素材：头像、徽标、封面图、二维码、附件等文件。
|
||
- 浏览记录：小程序端名片的访问行为数据。
|
||
|
||
### 4.2 核心关系
|
||
|
||
- 一个平台可管理多个租户。
|
||
- 一个租户可拥有多个组织节点。
|
||
- 一个租户可拥有多个用户。
|
||
- 一个用户默认对应一张电子名片。
|
||
- 一个租户对应一个对外展示主页，可关联多个办公地点、多个专业领域。
|
||
|
||
## 5. 产品功能范围
|
||
|
||
## 5.1 微信小程序端
|
||
|
||
### 5.1.1 律所主页
|
||
|
||
用于展示事务所品牌与入口信息。
|
||
|
||
功能点：
|
||
|
||
- 展示事务所 Logo、名称、封面图、简介
|
||
- 展示总部地址、办公地点列表、专业领域标签
|
||
- 展示一键跳转“人员列表”
|
||
- 展示咨询电话、导航入口
|
||
- 支持根据当前小程序绑定的 AppID 加载对应事务所信息
|
||
|
||
典型页面映射：
|
||
|
||
- 当前已有静态页面：`pages/firm/index`
|
||
|
||
### 5.1.2 人员名片列表
|
||
|
||
用于浏览某个租户下全部可公开展示的成员名片。
|
||
|
||
功能点：
|
||
|
||
- 按姓名、办公地点、专业领域搜索
|
||
- 按办公机构筛选
|
||
- 按专业领域筛选
|
||
- 卡片式展示头像、姓名、职务、专业方向
|
||
- 点击进入名片详情
|
||
- 一键拨打热线或跳转事务所位置
|
||
|
||
典型页面映射：
|
||
|
||
- 当前已有静态页面：`pages/lawyer-list/index`
|
||
|
||
### 5.1.3 个人名片详情
|
||
|
||
用于展示成员完整的对外名片信息。
|
||
|
||
功能点：
|
||
|
||
- 展示姓名、头像、职务、所属事务所/组织、联系方式、地址
|
||
- 展示个人简介、专业领域、二维码
|
||
- 支持拨打电话
|
||
- 支持保存到系统通讯录
|
||
- 支持打开地图导航
|
||
- 支持查看个人简介弹窗
|
||
- 支持分享小程序名片
|
||
- 支持记录浏览历史
|
||
|
||
典型页面映射：
|
||
|
||
- 当前已有静态页面：`pages/lawyer-detail/index`
|
||
|
||
### 5.1.4 浏览历史
|
||
|
||
用于提升回访效率。
|
||
|
||
功能点：
|
||
|
||
- 展示最近浏览的名片列表
|
||
- 展示浏览时间
|
||
- 支持点击再次进入名片
|
||
- 支持清空历史
|
||
|
||
说明：
|
||
|
||
- 当前原型为本地缓存方案，正式版本升级为“本地缓存 + 服务端埋点统计”双轨制。
|
||
|
||
典型页面映射：
|
||
|
||
- 当前已有静态页面：`pages/history/index`
|
||
|
||
### 5.1.5 分享与传播
|
||
|
||
功能点：
|
||
|
||
- 支持微信好友分享
|
||
- 支持微信会话卡片传播
|
||
- 支持通过二维码进入指定租户主页或指定个人名片页
|
||
- 支持在分享链路中保留租户信息与被分享对象信息
|
||
|
||
### 5.1.6 异常与空状态
|
||
|
||
功能点：
|
||
|
||
- 名片不存在提示
|
||
- 租户不存在或已停用提示
|
||
- 网络异常重试
|
||
- 暂无公开成员提示
|
||
- 暂无定位/电话/二维码配置提示
|
||
|
||
## 5.2 后台管理系统
|
||
|
||
后台管理系统为统一的 Web 管理端，登录后根据角色显示不同菜单与权限。
|
||
|
||
### 5.2.1 登录与账号体系
|
||
|
||
功能点：
|
||
|
||
- 账号密码登录
|
||
- 图形验证码
|
||
- 登录态续期与退出登录
|
||
- 角色鉴权、菜单鉴权、按钮鉴权
|
||
- 超级管理员与租户用户使用不同登录入口或同入口分流
|
||
- 支持用户首次登录后修改初始密码
|
||
- 支持重置密码
|
||
|
||
扩展项：
|
||
|
||
- 手机验证码登录
|
||
- 微信绑定登录
|
||
|
||
### 5.2.2 超级管理员端
|
||
|
||
#### 1. 租户管理
|
||
|
||
功能点：
|
||
|
||
- 新增/编辑/禁用租户
|
||
- 设置租户名称、编码、联系人、联系电话、状态、到期时间
|
||
- 设置租户套餐能力与上限
|
||
- 初始化租户管理员账号
|
||
- 配置租户对应的小程序 AppID、AppSecret、原始 ID、发布状态
|
||
- 查看租户使用情况
|
||
|
||
#### 2. 平台账号与权限管理
|
||
|
||
功能点：
|
||
|
||
- 平台管理员账号管理
|
||
- 平台角色管理
|
||
- 平台菜单与权限点管理
|
||
|
||
#### 3. 平台基础配置
|
||
|
||
功能点：
|
||
|
||
- 全局字典维护
|
||
- 系统参数维护
|
||
- 文件存储配置
|
||
- 微信小程序基础配置
|
||
- 小程序服务器域名、上传域名等平台级配置
|
||
|
||
#### 4. 租户小程序配置管理
|
||
|
||
功能点：
|
||
|
||
- 维护租户与微信小程序的绑定关系
|
||
- 配置并校验小程序 AppID 是否唯一
|
||
- 维护 AppSecret、原始 ID、名称、版本标记、启用状态
|
||
- 查看当前租户小程序配置是否完整
|
||
- 为后端公开接口提供 AppID 到租户的映射基础
|
||
|
||
#### 5. 全局监控与审计
|
||
|
||
功能点：
|
||
|
||
- 登录日志
|
||
- 操作日志
|
||
- 租户状态监控
|
||
- 错误告警概览
|
||
|
||
### 5.2.3 租户管理员端
|
||
|
||
#### 1. 事务所/公司/组织信息管理
|
||
|
||
功能点：
|
||
|
||
- 维护事务所名称、Logo、封面图、简介
|
||
- 维护总部地址、经纬度、联系电话
|
||
- 维护办公机构列表
|
||
- 维护专业领域列表
|
||
- 维护对外展示状态
|
||
|
||
#### 2. 组织架构管理
|
||
|
||
功能点：
|
||
|
||
- 部门/分所树维护
|
||
- 设置组织负责人
|
||
- 组织排序与展示控制
|
||
|
||
#### 3. 用户管理
|
||
|
||
功能点：
|
||
|
||
- 新增/导入/编辑/禁用用户
|
||
- 分配组织与角色
|
||
- 重置密码
|
||
- 设置是否公开展示
|
||
- 设置名片排序与推荐位
|
||
|
||
#### 4. 名片管理
|
||
|
||
功能点：
|
||
|
||
- 维护个人基础信息：姓名、职务、手机、邮箱、地址
|
||
- 维护个人扩展信息：简介、擅长领域、荣誉、执业证号、社交二维码
|
||
- 上传头像、二维码、宣传图
|
||
- 预览小程序展示效果
|
||
- 控制名片发布状态、上下架状态
|
||
|
||
#### 5. 素材与文件管理
|
||
|
||
功能点：
|
||
|
||
- 上传图片
|
||
- 查看图片使用情况
|
||
- 删除未引用素材
|
||
- 限制文件大小、格式
|
||
|
||
#### 6. 数据统计
|
||
|
||
功能点：
|
||
|
||
- 按用户查看名片浏览量
|
||
- 按时间查看访问趋势
|
||
- 查看热门名片排行
|
||
- 查看分享传播数据
|
||
|
||
### 5.2.4 普通用户端
|
||
|
||
普通用户登录后台后，仅维护本人相关信息。
|
||
|
||
功能点：
|
||
|
||
- 查看与编辑本人名片
|
||
- 上传本人头像、二维码
|
||
- 预览本人名片
|
||
- 查看本人浏览数据
|
||
- 修改密码
|
||
|
||
## 5.3 通用支撑能力
|
||
|
||
### 5.3.1 文件上传能力
|
||
|
||
- 支持头像、Logo、封面、二维码上传
|
||
- 支持图片压缩与格式校验
|
||
- 支持生成访问 URL
|
||
|
||
### 5.3.2 日志与审计
|
||
|
||
- 登录日志
|
||
- 操作日志
|
||
- 异常日志
|
||
- 关键业务日志
|
||
|
||
### 5.3.3 数据隔离
|
||
|
||
- 以租户为边界进行数据隔离
|
||
- 所有租户业务数据必须带租户归属
|
||
- 非平台角色不可跨租户读取和操作数据
|
||
|
||
### 5.3.4 可配置展示
|
||
|
||
- 支持控制成员是否公开
|
||
- 支持控制字段是否展示
|
||
- 支持控制租户主页是否启用
|
||
|
||
## 6. 核心业务流程
|
||
|
||
### 6.1 租户开通流程
|
||
|
||
1. 超级管理员创建租户。
|
||
2. 系统生成租户编码与初始租户管理员账号。
|
||
3. 超级管理员配置该租户对应的小程序 AppID 与相关参数。
|
||
4. 租户管理员首次登录，完善事务所资料。
|
||
5. 租户管理员创建组织并导入用户。
|
||
6. 用户补充个人名片信息并发布。
|
||
7. 小程序开始展示对应租户主页及成员名片。
|
||
|
||
### 6.2 普通用户名片维护流程
|
||
|
||
1. 普通用户登录后台。
|
||
2. 编辑个人信息、专业领域、联系方式、头像和二维码。
|
||
3. 点击保存并预览。
|
||
4. 若租户策略要求审核，则进入待审核状态。
|
||
5. 审核通过后在小程序端公开展示。
|
||
|
||
### 6.3 小程序访客浏览流程
|
||
|
||
1. 用户通过分享链接或二维码进入小程序。
|
||
2. 系统根据当前小程序 AppID 识别租户，并根据页面参数识别目标名片。
|
||
3. 加载事务所主页或名片详情。
|
||
4. 用户执行拨号、加联系人、导航、分享等动作。
|
||
5. 系统记录浏览、分享等统计数据。
|
||
|
||
## 7. 关键数据字段建议
|
||
|
||
### 7.1 事务所主页字段
|
||
|
||
- 租户名称
|
||
- 英文名称
|
||
- Logo
|
||
- 封面图
|
||
- 简介
|
||
- 联系电话
|
||
- 总部地址
|
||
- 经纬度
|
||
- 办公机构列表
|
||
- 专业领域列表
|
||
- 官网/公众号链接
|
||
- 展示状态
|
||
|
||
### 7.2 个人名片字段
|
||
|
||
- 用户姓名
|
||
- 性别
|
||
- 头像
|
||
- 职务/头衔
|
||
- 所属部门/分所
|
||
- 手机号
|
||
- 座机
|
||
- 邮箱
|
||
- 地址
|
||
- 擅长领域
|
||
- 个人简介
|
||
- 执业证号
|
||
- 教育/荣誉信息
|
||
- 微信二维码
|
||
- 名片封面图
|
||
- 对外展示状态
|
||
- 排序值
|
||
|
||
## 8. 非功能需求
|
||
|
||
### 8.1 安全性
|
||
|
||
- 后台接口必须鉴权
|
||
- 密码加密存储
|
||
- 操作日志可追溯
|
||
- 文件上传类型和大小受控
|
||
- 租户数据严格隔离
|
||
|
||
### 8.2 可用性
|
||
|
||
- 常规操作响应流畅
|
||
- 关键操作具备失败提示
|
||
- 网络失败可重试
|
||
- 页面需适配主流手机尺寸
|
||
|
||
### 8.3 可维护性
|
||
|
||
- 功能模块边界清晰
|
||
- 支持租户规模扩展
|
||
- 支持后续扩展审核、预约咨询、线索收集等能力
|
||
|
||
## 9. 版本建议
|
||
|
||
### 9.1 第一阶段：MVP
|
||
|
||
建议优先落地以下能力：
|
||
|
||
- 多租户基础能力
|
||
- 超级管理员租户管理
|
||
- 租户管理员维护事务所与用户
|
||
- 普通用户维护本人名片
|
||
- 小程序动态化展示事务所主页、列表、详情、历史
|
||
- 文件上传
|
||
- 基础统计
|
||
|
||
### 9.2 第二阶段：增强版
|
||
|
||
- 名片审核流
|
||
- Excel 批量导入/导出
|
||
- 分享海报/专属二维码
|
||
- 数据大屏与更细粒度统计
|
||
- 微信绑定登录
|
||
- 消息通知
|
||
|
||
## 10. 验收标准
|
||
|
||
### 10.1 业务验收
|
||
|
||
- 可创建多个租户，且数据互不串扰
|
||
- 超级管理员可管理租户
|
||
- 租户管理员可管理本租户事务所信息和用户
|
||
- 普通用户可编辑本人名片
|
||
- 小程序可按租户维度展示对应事务所与用户名片
|
||
- 小程序动作能力可正常使用：拨号、分享、导航、加联系人
|
||
|
||
### 10.2 体验验收
|
||
|
||
- 页面信息完整、结构清晰
|
||
- 搜索/筛选结果正确
|
||
- 空状态、错误状态、无权限状态提示明确
|
||
- 后台操作路径简洁，表单校验清晰
|
||
|
||
## 11. 后续开发原则
|
||
|
||
- 先完成“可用且正确”的多租户闭环，再逐步增加高级能力。
|
||
- 先保证租户、用户、名片、展示四条主链路打通，再扩展统计、审核、营销。
|
||
- 小程序与后台字段模型保持统一，避免前后端重复定义和语义不一致。
|