G 广珠订单重构PRD 文档站
文档/公司与用户

PRD · 公司与用户(模块 1)

需求公司、车队、供应商三类主体;注册认证、成员管理与司机账号的完整流程。

需求模块 原文件 PRD-公司与用户.md 约 15 分钟读完 9753 字符
下载 .md

1. Summary

外部用户先注册个人账号,再提交公司认证。平台审核通过后,提交人成为该公司的企业管理员,并按公司勾选的类型自动获得菜单。一家公司可以同时是需求公司、车队和供应商。管理员可以添加本公司员工。车队添加司机时按手机号认出同一个人,多家车队共用一个司机账号。

这一期一个人作为员工只能加入一家公司。表结构允许以后一个人加入多家公司。公司当前资料可以改。以后的订单只记下单时的公司名称。

本模块的公司、员工、司机使用新表。全平台品名继续用现网 biz_goods。地址继续用现网 biz_address,只增加公司。不改 Jeecg 自带的用户、角色、菜单表结构。

2. Contacts

姓名 角色 说明
建超 产品 本模块负责人

3. Background

现网可以注册个人账号,也可以提交企业认证。审核同意只改申请状态,不把提交人绑到公司,也不给业务角色。新用户要进菜单,还得有人再去角色里勾一次。

现网的公司资料和认证资料分在两张表里,名称、地址、电话都有一份。新项目如果两边都写,改一次资料要改两个地方。新功能不再读写这两张旧表。

车队新增司机时会新建一个登录账号。同一个司机给第二家车队干活时,现场只能再开一个账号。

公司名称以后会改。订单如果每次都去读公司最新名称,历史单据上的客户名会跟着变。

4. Objective

外部用户从注册到进入对应菜单,中间不需要人工赋角色。同一个司机只保留一个登录账号。公司改名不改写已有订单上的公司名称。

Key Results(上线后用数据校准)

  • KR1:审核通过的公司,提交人下次登录能看到所勾类型对应的菜单,中间没有人工赋角色。
  • KR2:同一手机号被第二家车队添加为司机时,只增加与该车队的关系,不新建登录账号。
  • KR3:公司名称被修改后,能查到改之前的名称。订单模块上线后,已有订单仍显示下单时的公司名称。

5. Market Segment(s)

来注册公司的人。 需求公司、车队或供应商的经办人。已能注册个人账号,接下来要让公司通过认证,并让同事能登录。

平台审核人。 处理企业认证。要核对证件和公司类型,同意后用户就能进对应菜单。

车队调度。 给本车队添加司机。经常遇到司机已经在别的车队开过账号。

这一期不给平台内部的业务员、运营、客服重新做开户,他们仍在后台单独建账号。员工权限只分企业管理员和普通成员。

6. Value Proposition

来注册公司的人

  • Who: 要给公司开通系统的经办人。
  • Why: 公司要通过认证,同事要能登录并看到本公司该看的菜单。
  • What before: 注册完不知道下一步;认证通过后菜单仍是空的,还要找人加角色。
  • How: 登录后提交认证。通过后提交人成为企业管理员,按所勾类型自动进入菜单,再在员工管理里加人。
  • What after: 本公司的人能登录办事。管理员不用进角色管理。
  • Alternatives: 继续由平台逐个建用户、逐个勾角色。公司和人绑在一起之后,菜单随公司类型走。

价值陈述:认证通过,提交人就是这家公司的管理员,同事由他添加,菜单自动带上。

平台审核人

  • Who: 处理企业认证的平台人员。
  • Why: 要在同意的同时定下公司类型,并让提交人立刻能用。
  • What before: 同意只改一个状态,用户仍然进不去业务菜单。
  • How: 同意时把提交人设为该企业管理员,并按勾选的类型写入角色。拒绝时填写原因。
  • What after: 不用再打开角色页给这个人赋权。
  • Alternatives: 同意之后再手工赋角色。同意即生效,少一次容易漏掉的操作。

价值陈述:审核同意就是开户完成。

车队调度

  • Who: 给本车队维护司机的调度。
  • Why: 同一个司机会给几家车队干活,不能因为手机号已存在就再开一个号。
  • What before: 手机号重复就建失败,现场改用另一个手机号或登录名,一个人变成多个账号。
  • How: 添加司机时先认手机号。没有账号就创建;已有账号就把这个人加入本车队。
  • What after: 司机用原来的账号能看到各家车队派给他的活。车队之间看不到对方的单。
  • Alternatives: 继续一人多号。一个手机号一个账号,停用、改密和派活都落在同一个人身上。

价值陈述:司机只注册一次,每家车队只加一条合作关系。

7. Solution

7.1 流程

个人注册到进入菜单:

flowchart TD A[注册个人账号] --> B[登录] B --> C{是否已加入公司} C -->|未加入| D[填写企业认证并勾选公司类型] D --> E[审核中] E --> F{平台审核} F -->|同意| G[提交人成为企业管理员] G --> H[按所勾类型进入菜单] F -->|拒绝并填写原因| I[修改资料后再次提交] I --> E C -->|已加入| H

业务员代建公司。客户不操作系统时走这条,不建登录账号。

flowchart TD A[业务员或业务管理员新建公司] --> B[填写公司资料并勾选类型] B --> C[公司直接为已确认] C --> D[可以给这家公司下单和配规则] D --> E[以后在用户管理创建账号并关联这家公司] E --> F[按公司类型获得菜单]

管理员添加员工。这一期由管理员直接建账号。短信邀请留到以后,表上先留邀请状态。

flowchart TD A[企业管理员打开员工管理] --> B{加人方式} B -->|本期: 填写账号| C[填写姓名 登录账号 手机号 初始密码] C --> D{账号和手机号都未被占用} D -->|是| E[创建用户 加入本公司 岗位为普通成员] D -->|否| F[提示已被占用] B -->|以后: 邀请| G[填写手机号并发送链接] G --> H[员工打开链接并确认] H --> E

车队添加司机:

flowchart TD A[车队填写司机手机号] --> B{这个手机号是否已有账号} B -->|没有| C[创建账号并赋予司机角色] B -->|已有| D[沿用原账号] C --> E[写上这家车队和这个人的司机关系] D --> E E --> F[司机用原账号查看各车队派给自己的活]

公司资料修改:

flowchart TD A[修改公司资料] --> B{谁在改} B -->|企业管理员| C[可改名称 地址 电话 银行 联系人] B -->|平台管理员或业务管理员| D[可改资料 也可改公司类型] C --> E[保存并记下变更日志] D --> F[类型变化时重算该公司员工的菜单] F --> E E --> G[已有订单继续显示下单当时的公司名称]

7.2 这一期要做的

  1. 个人注册
    登录账号、密码、确认密码、手机号。手机号必填,全平台唯一。注册成功后不绑公司,不给业务角色,回到登录。
    这一期用账号和密码登录。手机号验证码注册、手机号验证码登录、忘记密码以后再做。手机号从这一期起就是这个人的唯一身份。

  2. 企业认证
    客户自己注册时:已登录且未加入公司的用户提交认证。一条认证就是一家公司。
    客户不操作系统时:业务员、业务管理员直接新建公司,不创建登录账号。公司状态为已确认,创建人记在公司上。之后就可以给这家公司下单、配短驳规则。
    公司类型可以多选:需求公司、车队、供应商,可以同时勾。
    文字资料这一期所有类型相同。营业执照、法人身份证人像面、国徽面各传一张。其他资料可以一次上传多张,每张带一个资料名称。
    统一社会信用代码已经有「审核中」或「已确认」的公司时,不能再注册一家。
    客户自己提交的认证,状态为审核中,页面锁定。未登录不能从注册页直接填公司资料。

  3. 审核
    只审核客户自己提交的认证。平台审核人查看资料、证件和所勾类型,通过前可以改勾选。
    同意:提交人成为该企业管理员,并按勾中的每一类获得对应菜单。兼有几类时,菜单合在一起。
    拒绝:原因必填。不给角色。用户可以修改后再次提交。
    已确认、已拒绝的申请不能再同意或拒绝。
    业务员代建的公司不经过这条审核。

  4. 稍后关联账号
    代建的公司可以一直没有登录账号。客户以后要自己操作系统时,在用户管理创建账号,关联到这家公司,岗位默认企业管理员。菜单按公司当前类型自动带上。一家公司这一期仍然只有一名企业管理员时,沿用员工规则。

  5. 登录后能看到什么

    状态 登录后
    未申请公司 只有企业认证
    审核中 认证页锁定
    已拒绝 可修改并再次提交,能看到拒绝原因
    企业管理员 所勾类型的业务菜单,加员工管理和公司资料
    普通成员 所勾类型的业务菜单
    已停用的员工 回到未申请公司
    只做司机、不是任何公司员工 只看派给自己的活
    平台内部账号 仍走现有业务员、运营、客服菜单
  6. 员工
    这一期管理员直接建账号,岗位为普通成员。
    可以改为企业管理员,或取消企业管理员。本公司至少保留一名企业管理员。
    停用只解除和本公司的员工关系,并收回这家公司带来的角色。账号还在。对方没有别的身份时,登录后只剩企业认证。
    短信邀请这一期不发。关系上留「待接受」、邀请人和过期时间。

  7. 司机
    司机不占用「一名员工只能属于一家公司」的名额,也不进入车队的员工菜单。
    一个手机号一个登录账号。每家车队一条司机关系。
    移出司机只删除这一家车队的关系。还有别的车队,或这个人还是某家公司的员工时,账号保留。
    现网已经存在的重复司机账号这一期不合并。

  8. 公司资料
    企业管理员可以改名称、地址、电话、银行、联系人,不能改公司类型,也不能改统一社会信用代码。
    平台管理员、业务管理员可以改公司资料,也可以改公司类型。改类型后,该公司在职员工的菜单按新的类型重算。
    已有订单之后要更换法律主体,另建公司,不在这一期做。信用代码只允许平台管理员、业务管理员改正录入错误。
    后一次保存覆盖当前资料,并记下谁在何时把哪个字段从什么改成什么。这一期改完即生效,不重新进入审核。
    订单模块以后只在订单上记下单时的公司名称,不记地址、银行、信用代码和联系人。公司后来改名,不回写旧订单上的名称。
    以后如果改类型或改资料必须先审核再生效,再做变更申请。这一期不建这张表,功能细则也未定。

  9. 以后增加更细的权限
    菜单、按钮、接口仍然挂在角色上。全平台共用一套角色模板:需求公司、车队、供应商各一个业务角色,再加一个公司管理员角色。司机角色单独存在。
    一个人在一家公司里有哪些角色,记在员工关系上。这一期页面不能勾选,加入时按公司类型自动写入。
    以后要增加下单员、财务、只读,就新增全局角色模板,再勾到这条员工关系上。不给每家公司复制一套角色。
    一个人以后可以属于多家公司时,登录先进入当前公司,菜单只取这家公司的角色。

  10. 品名
    全平台品名继续用现网 biz_goods。业务员可以新建,也可以导入。
    每家需求公司另有一份常用品名,只保存这家里会用到的品名。下单时的品名选择列出常用品名。选择框旁边有「品名库选择」,弹窗里从全平台品名多选,加入这家公司的常用品名。
    需求公司菜单有品名管理,用来维护这份常用品名,可以把不常用的移出。移出不删除全平台品名。
    订单提交时,这一票的品名如果还不在常用品名里,也写进去。

  11. 地址
    装卸货地址沿用现网地址页和现有操作。biz_address 增加公司。列表、新增、修改、删除按公司查询,不再按创建人账号。业务员代一家公司维护时,用的是这一家公司。

7.3 数据怎么放

公司、员工、司机写在 qh_biz 开头的新表里。全平台品名读写现网 biz_goods。地址读写现网 biz_address,并使用新增的公司字段。现网的公司表、认证表、用户公司关系表不读写。Jeecg 自带的用户、角色、菜单、部门表不加字段。

登录后的菜单仍由 Jeecg 的用户角色数据决定。员工加入、停用、司机关系变化时,按新业务表去增减这些角色数据。这一期一个人只有一家公司,两边一致。

公司从提交认证起就是同一条记录。审核中、已拒绝的公司不会出现在派车、下单的公司选择里。因此认证资料和正式公司不用拆成两张表。

订单这一期不建表。以后订单只存公司名称。变更日志用来回看公司改过什么。

以后如果签章前要再审一次,在审核状态上增加新的状态文字,页面按状态决定还在认证、要去签章,还是可以进入业务菜单。签章文件以后单独做。

以后如果改类型或改资料要先审核再生效,再做变更申请。功能未定,这一期不设计表。

7.4 假设和未决问题

  • 手机号验证码注册、手机号登录、忘记密码这一期不上。
  • 员工邀请短信这一期不发。
  • 现网重复的司机账号不在这一期合并。
  • 司机由车队当场添加,添加后立即生效,不需要司机再点确认。
  • 供应商的具体菜单到平台订单模块再定。这一期先让供应商这个类型能够登录并看到管理员功能。
  • 改类型、改资料这一期保存后直接生效。以后要先审核再生效时,再做变更申请。

8. Release

这一期要有的

  • 个人注册后的企业认证、平台同意或拒绝。
  • 业务员、业务管理员代建公司。可以不建登录账号,公司直接已确认。以后再创建账号并关联。
  • 同意后自动绑定管理员,并按所勾类型给菜单。
  • 管理员直接添加员工。岗位只有企业管理员和普通成员。
  • 车队按手机号添加司机。多家车队共用一个账号。
  • 企业管理员可以改名称、地址、电话、银行、联系人。平台管理员、业务管理员还可以改公司类型。修改留下变更记录。
  • 其他资料可以一次上传多张。
  • 全平台品名继续用 biz_goods,业务员可新建和导入。每家需求公司有常用品名。
  • 地址沿用现网页面。biz_address 增加公司,接口按公司查询。
  • 新表以 qh_biz 开头。除地址表增加公司外,现网旧表和 Jeecg 原表结构不动。

这一期不做

  • 一个人作为员工加入多家公司。
  • 短信邀请、手机号验证码注册和登录、忘记密码。
  • 比管理员和普通成员更细的岗位。
  • 合并现网已经存在的重复司机账号。
  • 把公司名称写进订单。规则在本文定下,随订单模块一起做。
  • 企业自己修改公司类型。
  • 已有订单后更换法律主体。
  • 改资料、改类型时重新审核。变更申请表留到以后。
  • 结算、竞价、多个车队按顺序派单。
  • 某一类公司单独的固定证件栏目。多出来的证件放在其他资料里上传。
  • 双方线上电子合同和签章。

9. 数据库表设计参考

本模块新建下面这些表。地址沿用 biz_address,只增加公司。全平台品名沿用 biz_goods,不改结构。其余现网旧表不改、不读写。Jeecg 的 sys_user、sys_role、sys_user_role、sys_permission、sys_depart 不加字段。需要登录和菜单时,往 sys_user、sys_user_role 写入数据。

9.1 公司 qh_biz_company

一家公司从提交认证到审核通过,都是这一条记录。列表要选择「已确认」的公司时,按审核状态过滤。

字段 说明
id 主键
name 企业名称
uscc 统一社会信用代码。审核中、已确认的记录里不可重复
registered_capital 注册资金
pca_code / pca_text 所在地区
addr 详细地址
representative 法定代表人
lr_idcard 法人身份证号
phone 企业电话
email 企业邮箱
bank_account 银行账号
bank 开户行
contact_name 业务联系人
contact_phone 业务联系人电话
contact_email 业务联系人邮箱
introduction 公司简介
busi_scope 经营范围
busi_license 营业执照,一张
lr_side_person 法人身份证人像面,一张
lr_side_emblem 法人身份证国徽面,一张
other_files 其他资料。文本,内容是 JSON 数组,见下方
is_demand 是否需求公司。0 否,1 是
is_fleet 是否车队。0 否,1 是
is_supplier 是否供应商。0 否,1 是
application_status 审核状态,字符串。取值:审核中、已确认、已拒绝。以后签章只增加取值,不加新字段
reject_reason 拒绝原因
create_by / create_time / update_by / update_time 维护字段

三个类型可以同时为 1。页面列表不单独铺开三列,用一列文字显示勾中的类型,例如「需求公司、车队」。筛选「只要车队」时查 is_fleet = 1。

other_files 每一项是资料名称和文件地址:

[
  {"name": "道路运输许可证", "url": "文件地址"},
  {"name": "其他资料", "url": "文件地址"}
]

前端「其他资料」一次可选多张。这一期可以不传。以后某类公司要多交一种证件,就多传几张并写上名称。

余额、预付款不在这张表里。那是以后的结算模块。

9.2 员工关系 qh_biz_user_company

字段 说明
id 主键
user_id 用户,对应 sys_user.id
company_id 公司,对应 qh_biz_company.id
position 岗位:admin 企业管理员,member 普通成员
status active 已加入,disabled 已停用,invited 待接受。这一期只用前两个
invite_by 邀请人。这一期不写
invite_expire 邀请过期时间。这一期不写
create_by / create_time / update_by / update_time 维护字段

同一用户和同一公司只能有一条。公司可以暂时没有员工。这一期保存时检查:一个用户只能有一条已加入的员工关系。数据库不限制一个用户只能有一条,以便以后放开。

9.3 员工角色 qh_biz_user_company_role

字段 说明
id 主键
user_company_id 员工关系
role_id 角色模板,对应 sys_role.id

同一条员工关系上,同一个角色只有一条。加入公司时,按公司上为 1 的类型自动写入。企业管理员再加公司管理员角色。

9.4 车队司机 qh_biz_fleet_driver

字段 说明
id 主键
company_id 车队公司
user_id 司机的登录用户
status 在这家车队是否有效
create_by / create_time 谁添加的

同一车队和同一个用户只有一条。一个司机可以对应多家车队。

9.5 公司资料变更日志 qh_biz_company_change_log

字段 说明
id 主键
company_id 公司
field_name 被改的字段
old_value 旧值
new_value 新值
update_by / update_time 谁在何时改的

9.6 常用品名 qh_biz_company_goods

一家需求公司里,一个全平台品名只有一条。

字段 说明
id 主键
company_id 需求公司,对应 qh_biz_company.id
goods_id 全平台品名,对应 biz_goods 的主键
create_by / create_time 谁在何时加入

9.7 地址

沿用 biz_address。增加 company_id,对应 qh_biz_company.id。原有公司名称、联系人、电话、地址、地址类型、经纬度保留。查询和保存按 company_id,不再按创建人过滤。

9.8 这一期不建的表

订单表不在这一期建。以后订单只保存下单时的公司名称。

签章以后单独做。公司表的审核状态可以增加状态文字,用来区分要不要签章。

变更申请以后可能做。公司已经在用之后,如果改类型或改资料要先审核再生效,再单独做。功能未定,这一期不设计表。

广珠订单重构 · PRD 文档站 · 由 Mavis 生成