# PRD · 公司与用户（模块 1）

## 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 流程

个人注册到进入菜单：

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

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

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

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

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

车队添加司机：

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

公司资料修改：

```mermaid
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` 每一项是资料名称和文件地址：

```json
[
  {"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 这一期不建的表

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

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

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