第五十，五十一天

编写文档，系统详细设计。
4.2.1 质检管理
4.2.1.1功能描述
对子系统中的所有质检信息进行维护管理，包含查询，新增，修改，删除，虫子这5个功能。
查询功能通过输入油品名称，油品编码来查询质检信息，查询的列表可以通过双加查询详细信息。支持模糊查询。
新增功能通过下拉框选择罐号，油品名称；通过输入框输入批号，批量，通过控件选择是否合格，生产日期，检验日志；通过附件上传功能上传合格证，上传的图片保存在本地服务器上，上传成功后返回图片名称及路径，将图片显示在合格证下方，并将存储附件主键。可以通过删除按钮同时删除数据库中数据及本地服务器上的图片，上传的图片不超过5张，支持多图上传。点击保存时校验数据，通过校验和在质检表中新增数据。
修改功能通过质检主键获取质检信息，然后根据业务进行修改，当点击保存时通过校验即修改成功。
删除功能提示用户是否确认删除，确认时通过主键获取质检实体，然后通过实体在表中删除质检数据。
重置按钮是删除上方数据查询中的油品名称，油品编码数据后查询数据，即查询所有有效数据。

5.2.1.2表结构设计
序号 字段名称 类型 长度 备注
1 QUALITY _KEY Varchar 32 质检主键
2 TANK_NO Varchar 128 罐号
3 OIL_CODE Varchar 128 油品编码
4 OIL_NAME Varchar 128 油品名称
5 IS_QUALIFIED char 1 是否合格
6 CERTIFICATE Varchar 1024 合格证
7 BATCH_NO Varchar 128 批号
8 OUTPUT Number 批量(吨)
9 PRODUCE_DATE Varchar 10 生产日期
10 CHECKOUT_DATE Varchar 10 检验日期
11 IS_FLAG char 1 是否有效
12 CREATE_USER Varchar 32 创建人
13 CREATE_TIME Varchar 19 创建时间
14 MODIFY_TIME Varchar 19 修改时间

序号 字段名称 类型 长度 备注
1 FILE_KEY Varchar 32 附件KEY
2 FILE_NAME Varchar 256 附件名称
3 FILE_CONTENT Varchar 1024 附件描述
4 FILE_SIZE Varchar 20 附件大小
5 FILE_SAVE_PATH Varchar 1024 存放路径
6 DELETE_STATE Char 3 删除状态
7 CREATE_TIME Varchar 19 创建时间
8 MODIFY_TIME Varchar 19 修改时间

4.2.2 库存管理
4.2.2.1功能描述
对子系统中的库存信息进行管理，包括追加可销量和保存功能，重新获取功能。
库存管理中的数据是每天早晨8点从Mse系统中提取的库存信息。可以在页面查看油品，库存，可销量信息，追加可销量信息。
通过点击追加可销量，使追加可销量变为可编辑状态，修改可销量信息后点击保存按钮，通过校验后修改追加可销量信息。支持同时编辑多个信息。
重新获取功能是在Mse系统中重新获取一次数据。
5.2.2.2表结构设计
序号 字段名称 类型 长度 备注
1 INVENTORY_KEY Varchar 32 库存主键
2 OIL_CODE Varchar 32 油品编码
3 OIL_NAME Varchar 32 油品名称
4 INVENTORY_AMOUNT Number 库存量
5 SALABLE_AMOUNT Number 可销售量
6 ADDITIONAL_SALES_AMOUNT Number 追加销售量
7 INVENTORY_DATE Varchar 10 库存日期
8 OPERATOR_MAN Varchar 32 操作人
9 OPERATOR_TIME Varchar 19 操作时间
10 MES_OIL_CODE Varchar 32 MES油品编码

4.2.3 销售计划管理
4.2.3.1功能描述
销售计划管理是通过当日库存信息制定销售计划，将计划存储在切块信息表中。可销量分配，添加，修改，删除功能。只要超级管理员拥有对通过审核的销售计划进行修改和删除的权限。
通过点击可销量分配进入对应的油品的可销量分配页面，需要对应的运输方式，提货单位名称，可销量，是否审核这4个信息。其中运输方式，提货单位和是否审核下拉框选择。当选择运输方式时，会显示对用运输方式的提货单位。对应的可提取想量和不能超过可销售量，如果超过则提示用户可提取量分配过大。当选择不审核时，默认通过审核，点击添加时会提醒用户，该选项的数据无法修改或删除，是否确认添加。当选择需要审核时，添加校验只需要判断在该油品下是否已经有相同的提货单位和运输方式被添加。如果有提示已经有相同信息被添加。
当超级管理员进入该页面，点击切块信息对应的修改按钮时，对应的可提取量变为可编辑。点击保存时，可提取量的和不能超过可销售量并且不能小于提油单中对应的批准总量和。
所有通过审核的公路运输的切块信息和一期数据库同步。
5.2.3.2表结构设计
序号 字段名称 类型 长度 备注
1 QK_PLAN_KEY Varchar 32 切块计划主键
2 DELIVERY_DEPART_CODE Varchar 32 提货单位编码
3 OIL_CODE Varchar 32 油品编码
4 OIL_NAME Varchar 32 油品名称
5 SALABLE_AMOUNT Number 可销售量
6 INVENTORY_DATE Varchar 10 库存日期
7 TRANSPORT_TYPE char 3 运输方式
8 OPERATOR_MAN Varchar 32 操作人
9 OPERATOR_TIME Varchar 19 操作时间
10 IS_AUDIT char 1 是否审核
11 AUDIT_STATE char 3 审核状态
12 AUDIT_CONTENT Varchar 1024 审核内容
13 AUDIT_TIME Varchar 19 审核时间
14 AUDIT_PERSON Varchar 32 审核人
15 IS_FLAG char 1 有效状态

4.2.4 销售计划审核管理
4.2.4.1功能描述
对所有当天的待审核的销售计划进行审核。
列表显示油品名称，提货单位，运输方式，可销量，库存日期，操作人，操作时间。
点击审核时，弹出审核页面，审核页面可以选择审核通过和审核不通过，下方是审核意见，默认显示审核通过和审核不通过。点击提交按钮后提醒用户确认。确认后，判断切块信息是否通过审核，如果通过则修改该信息的审核状态为审核通过，审核内容为审核意见；如果不通过则修改该信息的审核状态为审核不通过，审核内容为审核意见，并将数据有效状态为无效。
所有通过审核的公路运输的切块信息和一期数据库同步。

4.2.5 切块信息
4.2.5.1功能描述
通过表格展示所有通过审核的切块信息。展示内容包括油品名称，库存，可销量，运输方式，提货单位，可提取量。其中根据油品，运输方式，提货单位进行了三次划分。
在最上方通过下拉框选择油品名称可以快速定位到对应的信息。

4.2.6 提油单管理
4.2.6.1功能描述
对铁路运输的提油单进行管理，包含查询，新增，修改，删除，重置，提交这7个功能。
查询功能通过油品名称，提货单位，发货单位查询，支持模糊查询。对查询的数据双击可查看详细数据。
新增功能中必填信息为油品名称，提货单位名称，发货单位名称，提货人，批准总量，日期。非必填信息为备注和操作。油品名称，提货单位，发货单位是通过下拉框选择，如果油品名称和提货单位在通过审核的切块信息中没有对用的数据，则提示先在销售计划中分配；如果获取到对应数据，则在批准总量处显示剩余的可提取量。日期默认显示当天日期，也可以通过点击选择。操作的提油单所属车辆导入需要先分配批准总量，下载对应EXCEL模板。模板中需要填写的数据有7位车号，批准量，罐号。导入时根据车号判断在实到车辆中是否存在，如存在在状态为已到，否则为未到。导入成功后，在下方显示提油单车辆信息管理，可以对导入的车辆信息惊醒修改和删除操作。点击保存，通过校验后将提油单数据存入提油单表中，将车辆信息存入提油单所属车辆表中，两张表通过编号关联。
修改功能通过获取提油单主键获取提油单信息及所属车辆信息，根据需求修改，点击保存，通过校验后修改内容。
删除功能提示是否确认删除，通过提油单主键获取实体，删除对应2表中的数据。
重置清除上方油品名称，提货单位，发货单位的内容查询。
提交功能是提示是否提交，当用户确认后判断提准量和是否和可提取量相等，如果相等提交数据，提油单状态变为已提交，所属车辆信息的状态变为已提交；否则不提交。
5.2.6.2表结构设计
序号 字段名称 类型 长度 备注
1 TI_OIL_KEY Varchar 32 主键
2 ORDERS_NUMBER Varchar 50 编号
3 OIL_CODE Varchar 50 油品编码
4 OIL_NAME Varchar 32 油品名称
5 DELIVERY_DEPART Varchar 50 提货单位
6 DELIVERY_DEPART_CODE Varchar 32 提货单位编码
7 SEND_DEPART Varchar 50 发货单位
8 SEND_DEPART_CODE Varchar 50 发货单位编码
9 DATE_YMD Varchar 50 日期
10 PICK_PERSON Varchar 50 提货人
11 CALCULATE_PERSON Varchar 50 计量人
12 OPERATOR_PERSON Varchar 50 开票人
13 ADVANCE_TATAL Number 10 批准总量
14 REAL_TATTAL Number 10 实装总量
15 REMARK Varchar 1024 备注
16 STATE char 3 状态
17 SUBMIT_TIME Varchar 50 提交时间
18 MODIFY_TIME Varchar 50 修改时间

序号 字段名称 类型 长度 备注
1 RELATION_KEY Varchar 32 主键
2 ORDERS_NUMBER Varchar 50 编号
3 TRAIN_NO Varchar 50 车号
4 ADVANCE_AMOUNTKG Number 10 数量(批准)
5 REAL_AMOUNTKG Number 10 数量(实发)
6 TANK_NO Varchar 50 罐号
7 SEAL_NO Varchar 50 铅封号
8 STATE char 3 状态

4.2.7 预告车辆管理
4.2.7.1功能描述
用来管理预告车辆信息。涉及查询，重置，预告车辆导入，导入模板下载这4个操作。
查询时支持模糊查询，可通过车型，车号和创建时间（时间选择器默认选中当前日期），来单个模糊查询或者多个组合模糊查询来查询提货单位信息。
重置是清除查询数据中的发货单位名称名称，并再次查询数据。
导入模板下载是为用户提供标准的模板，点击导入模板下载可将模板下载下来。
预告车辆导入是通过导入填写好预告车辆信息的Excel文件来将预告车辆信息导入到数据库中，从而查询出相关信息。
4.2.7.2表结构设计
序号 字段名称 类型 长度 备注
1 ACTUAL_TRAIN_KEY VARCHAR2 32 主键
2 TRAIN_TYPE VARCHAR2 50 车型
3 TRAIN_NO VARCHAR2 50 车号
4 CREATE_PERSON VARCHAR2 32 创建人
5 CREATE_TIME VARCHAR2 19 创建时间
6 MODIFY_TIME VARCHAR2 19 修改时间
7 MODIFY_PERSON VARCHAR2 32 修改人
8 IS_FLAG VARCHAR2 1 是否有效
9 PASS_TIME VARCHAR2 19 过车时间(实到车批次号)
10 REMARK VARCHAR2 1024 备注

4.2.8 实到车辆管理
4.2.8.1功能描述
用来管理预告车辆信息。涉及查询，重置，车辆导入，导入模板下载这4个操作。
查询分为两种，分别为查询全部单选按钮和按批次查询单选按钮，查询全部可根据过车时间（时间选择器）来查询出对应时间的车辆信息。按批次查询可根据具体的批次号来查询车辆信息。
按具体的批次号查询出的车辆信息才可以进行修改，添加删除操作。当按批次查询后会出现修改按钮，点击修改按钮后可以对车型，车号进行批量修改，同时修改按钮变为保存按钮。添加时序号不得大于总车辆数加1的值；对车型及车号输入的内容做了校验。修改完后点击保存按钮，将保存所修改的车辆信息。并且回到按当前批次查询出的页面，以便进行后续的操作。
重置是将单选按钮选中查询全部并清空查询输入框中的内容，再次查询数据。
导入模板下载是为用户提供标准的模板，点击导入模板下载可将模板下载下来。
车辆导入是通过导入按模板标准填写好车辆信息的Excel文件来将车辆信息导入到数据库中，从而查询出相关信息。
4.2.8.2表结构设计
序号 字段名称 类型 长度 备注
1 ACTUAL_TRAIN_KEY VARCHAR2 32 主键
2 SORT_NUM INTEGER 序号
3 BATCH_NUMBER VARCHAR2 19 实到车批次号
4 TRAIN_TYPE VARCHAR2 50 车型
5 TRAIN_NO VARCHAR2 50 车号
6 CREATE_PERSON VARCHAR2 32 创建人
7 CREATE_TIME VARCHAR2 19 创建时间
8 MODIFY_TIME VARCHAR2 19 修改时间
9 MODIFY_PERSON VARCHAR2 32 修改人
10 IS_FLAG CHAR 1 是否有效
11 POSITION VARCHAR2 50 位置
12 REMARK VARCHAR2 1024 备注
13 PASS_TIME VARCHAR2 19 过车时间

4.2.9 历史车辆管理
4.2.9.1功能描述
显示历史车辆信息，查询所有状态是已提交的提油单所属车辆信息。
查询操作可以通过批次号，车号，过车时间查询。显示数据包括批次号，车型，车号，创建人，位置，批准量，过车时间。
重置是清空批次号，车号，过车时间后查询。