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 流程
个人注册到进入菜单:
业务员代建公司。客户不操作系统时走这条,不建登录账号。
管理员添加员工。这一期由管理员直接建账号。短信邀请留到以后,表上先留邀请状态。
车队添加司机:
公司资料修改:
7.2 这一期要做的
个人注册
登录账号、密码、确认密码、手机号。手机号必填,全平台唯一。注册成功后不绑公司,不给业务角色,回到登录。
这一期用账号和密码登录。手机号验证码注册、手机号验证码登录、忘记密码以后再做。手机号从这一期起就是这个人的唯一身份。企业认证
客户自己注册时:已登录且未加入公司的用户提交认证。一条认证就是一家公司。
客户不操作系统时:业务员、业务管理员直接新建公司,不创建登录账号。公司状态为已确认,创建人记在公司上。之后就可以给这家公司下单、配短驳规则。
公司类型可以多选:需求公司、车队、供应商,可以同时勾。
文字资料这一期所有类型相同。营业执照、法人身份证人像面、国徽面各传一张。其他资料可以一次上传多张,每张带一个资料名称。
统一社会信用代码已经有「审核中」或「已确认」的公司时,不能再注册一家。
客户自己提交的认证,状态为审核中,页面锁定。未登录不能从注册页直接填公司资料。审核
只审核客户自己提交的认证。平台审核人查看资料、证件和所勾类型,通过前可以改勾选。
同意:提交人成为该企业管理员,并按勾中的每一类获得对应菜单。兼有几类时,菜单合在一起。
拒绝:原因必填。不给角色。用户可以修改后再次提交。
已确认、已拒绝的申请不能再同意或拒绝。
业务员代建的公司不经过这条审核。稍后关联账号
代建的公司可以一直没有登录账号。客户以后要自己操作系统时,在用户管理创建账号,关联到这家公司,岗位默认企业管理员。菜单按公司当前类型自动带上。一家公司这一期仍然只有一名企业管理员时,沿用员工规则。登录后能看到什么
状态 登录后 未申请公司 只有企业认证 审核中 认证页锁定 已拒绝 可修改并再次提交,能看到拒绝原因 企业管理员 所勾类型的业务菜单,加员工管理和公司资料 普通成员 所勾类型的业务菜单 已停用的员工 回到未申请公司 只做司机、不是任何公司员工 只看派给自己的活 平台内部账号 仍走现有业务员、运营、客服菜单 员工
这一期管理员直接建账号,岗位为普通成员。
可以改为企业管理员,或取消企业管理员。本公司至少保留一名企业管理员。
停用只解除和本公司的员工关系,并收回这家公司带来的角色。账号还在。对方没有别的身份时,登录后只剩企业认证。
短信邀请这一期不发。关系上留「待接受」、邀请人和过期时间。司机
司机不占用「一名员工只能属于一家公司」的名额,也不进入车队的员工菜单。
一个手机号一个登录账号。每家车队一条司机关系。
移出司机只删除这一家车队的关系。还有别的车队,或这个人还是某家公司的员工时,账号保留。
现网已经存在的重复司机账号这一期不合并。公司资料
企业管理员可以改名称、地址、电话、银行、联系人,不能改公司类型,也不能改统一社会信用代码。
平台管理员、业务管理员可以改公司资料,也可以改公司类型。改类型后,该公司在职员工的菜单按新的类型重算。
已有订单之后要更换法律主体,另建公司,不在这一期做。信用代码只允许平台管理员、业务管理员改正录入错误。
后一次保存覆盖当前资料,并记下谁在何时把哪个字段从什么改成什么。这一期改完即生效,不重新进入审核。
订单模块以后只在订单上记下单时的公司名称,不记地址、银行、信用代码和联系人。公司后来改名,不回写旧订单上的名称。
以后如果改类型或改资料必须先审核再生效,再做变更申请。这一期不建这张表,功能细则也未定。以后增加更细的权限
菜单、按钮、接口仍然挂在角色上。全平台共用一套角色模板:需求公司、车队、供应商各一个业务角色,再加一个公司管理员角色。司机角色单独存在。
一个人在一家公司里有哪些角色,记在员工关系上。这一期页面不能勾选,加入时按公司类型自动写入。
以后要增加下单员、财务、只读,就新增全局角色模板,再勾到这条员工关系上。不给每家公司复制一套角色。
一个人以后可以属于多家公司时,登录先进入当前公司,菜单只取这家公司的角色。品名
全平台品名继续用现网biz_goods。业务员可以新建,也可以导入。
每家需求公司另有一份常用品名,只保存这家里会用到的品名。下单时的品名选择列出常用品名。选择框旁边有「品名库选择」,弹窗里从全平台品名多选,加入这家公司的常用品名。
需求公司菜单有品名管理,用来维护这份常用品名,可以把不常用的移出。移出不删除全平台品名。
订单提交时,这一票的品名如果还不在常用品名里,也写进去。地址
装卸货地址沿用现网地址页和现有操作。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 这一期不建的表
订单表不在这一期建。以后订单只保存下单时的公司名称。
签章以后单独做。公司表的审核状态可以增加状态文字,用来区分要不要签章。
变更申请以后可能做。公司已经在用之后,如果改类型或改资料要先审核再生效,再单独做。功能未定,这一期不设计表。