LQAdminPlatform/项目/字典管理系统设计.md

系统字典管理设计

系统字典表结构

• 字典类型表：t_sys_dict_category DROP TABLE IF EXISTS t_sys_dict_category; CREATE TABLE t_sys_dict_category ( category_id varchar(32) NOT NULL COMMENT '字典类型id', category_no varchar(512) DEFAULT NULL COMMENT '字典类型编号', category_name varchar(512) NOT NULL COMMENT '字典类型种类id', category_desc varchar(512) DEFAULT NULL COMMENT '字典类型种类备注', parent_field varchar(32) NOT NULL COMMENT '父节点字典类型种类id', created_by varchar(32) DEFAULT NULL COMMENT '创建人', created_time datetime DEFAULT NULL COMMENT '创建时间', updated_by varchar(32) DEFAULT NULL COMMENT '修改人', updated_time datetime DEFAULT NULL COMMENT '修改时间', del_flag char(1) DEFAULT '0' COMMENT '删除标志位:1是0否', category_level char(1) DEFAULT NULL COMMENT '字典层级', PRIMARY KEY (category_id) USING BTREE ) ENGINE = InnoDB CHARACTER SET = utf8mb4 COLLATE = utf8mb4_bin COMMENT = '字典类别表';

• 字典项表：t_sys_dictionary_item DROP TABLE IF EXISTS t_sys_dict_category_item; CREATE TABLE t_sys_dict_category_item ( dict_id int NOT NULL AUTO_INCREMENT COMMENT '字典id', dict_name varchar(512) NOT NULL COMMENT '字典名称', dict_value varchar(512) NOT NULL COMMENT '字典值', dict_desc varchar(512) DEFAULT NULL COMMENT '字典备注', category_id varchar(255) NOT NULL COMMENT '字典类型id', created_by varchar(32) DEFAULT NULL COMMENT '创建人', created_time datetime COMMENT '创建时间', updated_by varchar(32) DEFAULT NULL COMMENT '修改人', updated_time datetime DEFAULT NULL COMMENT '修改时间', enable_flag char(1) NOT NULL DEFAULT '1' COMMENT '启用标志位:1启用0禁用', del_flag char(1) NOT NULL DEFAULT '0' COMMENT '删除标志位:1是0否', sort int COMMENT '排序', PRIMARY KEY (dict_id) USING BTREE ) ENGINE = InnoDB AUTO_INCREMENT = 1 COMMENT = '字典项表';

系统字典逻辑

• 首先创建字典类型
  • 创建字典类型时，字典项的category_id字段，为字典类型id
• 再创建字典项
  • 字典项的category_id字段，为字典类型id
  • 字典项的dict_id字段，为字典项id
    

原型UI界面设计

• 字典类型管理
  • 左侧树形型结构
  • 可以增加字典类型
  • 可以删除字典类型
  • 可以修改字典类型
  • 可以查看字典类型
  • 选择树形节点后，右侧显示该节点下的字典项
• 字典项管理
  • 右侧列表显示字典项信息
  • 可以增加字典项
  • 可以删除字典项
  • 可以修改字典项
  • 可以查看字典项
  • 可以搜索字典项
  • 可以排序字典项
  • 可以批量删除字典项
  • 可以启用、禁用字典项
  • 可以设置字典项的排序

目录结构

• 字典类型管理

  • src/views/system/dict_category_view.py
  • src/schemas/system/dict_category_schema.py
  • src/services/system/dict_category_service.py

• 字典项管理

  • src/views/system/dict_item_view.py
  • src/schemas/system/dict_item_schema.py
  • src/services/system/dict_item_service.py
    

初始化数据

• 创建字典类型 文件类型枚举定义 file_type 专业类型枚举定义 professional_type 时效性枚举定义 time_effect 施工方案类别枚举定义 construction_plan_type 施工方案一级分类枚举定义 construction_plan_first_type 施工方案二级分类枚举定义 construction_plan_second_type 施工方案三级分类枚举定义 construction_plan_third_type 施工方案四级分类枚举定义 construction_plan_fourth_type

• 字典项枚举定义

  • 文件类型枚举定义 序号 中文名称（dict_name） 英文名称（dict_desc） 简写(dict_value) 1 国家标准 National Standard GB
    2 行业标准 Industry Standard HY
    3 部门规章 Department Regulations BM
    4 地方标准 Local Standard DB
    5 企业标准 Enterprise Standard QY
    6 管理制度 Management Regulation GL
    7 技术规范 Technical Specification GF
    8 团体标准 Group Standard TT
    9 国际标准 International Standard GJ
    10 国家法律 National Law FL
    11 地方法规 Local Regulations LR
    12 其他 Other QT

  • 专业类型枚举定义 序号（sort） 中文名称（dict_name） 英文名称（dict_desc） 简写(dict_value) 1 法律法规 Legal Regulations FL 2 通用标准 General Standards TY 3 勘察钻探 Survey and Drilling KC 4 地基基础 Foundation DJ 5 路基路面 Roadbed and Pavement LJ 6 桥梁工程 Bridge Engineering QL 7 隧道工程 Tunnel Engineering SD 8 交通工程 Traffic Engineering JT 9 建筑工程 Construction Engineering JZ 10 市政工程 Municipal Engineering SZ 11 机电安装 Electromechanical Installation JD 12 路桥工程 Road and Bridge Engineering LB 13 装饰装修 Decoration and Renovation ZS 14 港口航道 Port and Waterway GK 15 铁路工程 Railway Engineering TL 16 房建工程 Building Engineering FJ 17 水利电力 Water Conservancy and Power SL 18 信息化 Information Technology XX 19 试验检测 Testing and Inspection SY 20 安全环保 Safety and Environmental Protection AQ 21 其他 Other QT

  • 时效性枚举定义 序号 中文描述（dict_name） 英文描述（dict_desc） 简写(dict_value) 1 现行 Current XH 2 废止 Abolished FZ 3 试行 Trial / Interim SX

  • 施工程类别枚举定义 序号 中文描述（dict_name） 英文描述（dict_desc） 简写(dict_value) 1 超危大方案 Ultra-High-Risk Construction Plan CH 2 超危大方案较大Ⅱ级 Ultra-High-Risk Plan – Level II (Major) CH2 3 超危大方案特大Ⅳ级 Ultra-High-Risk Plan – Level IV (Extra Large) CH4 4 超危大方案一般Ⅰ级 Ultra-High-Risk Plan – Level I (General) CH1 5 超危大方案重大Ⅲ级 Ultra-High-Risk Plan – Level III (Significant) CH3 6 危大方案 High-Risk Construction Plan WD 7 一般方案 General Construction Plan YB 8 其他 Other QT

  • 施工计划一级分类枚举定义 序号 中文描述（dict_name） 英文描述（dict_desc） 简写(dict_value) 1 施工方案 Construction Plan SC 2 其他 Other QT

  • 施工计划二级分类枚举定义 序号 中文描述（dict_name） 英文描述（dict_desc） 简写(dict_value) 1 临建工程 Temporary Construction LZ 2 路基工程 Subgrade Engineering LJ 3 桥梁工程 Bridge Engineering QL 4 隧道工程 Tunnel Engineering SD 5 其他 Other QT

  • 施工计划三级分类枚举定义 序号 中文描述（dict_name） 英文描述（dict_desc） 简写(dict_value) 1 TBM施工 TBM Construction TM 2 拌和站安、拆施工 Mixing Plant Installation & Dismantling BH 3 不良地质隧道施工 Construction in Poor Geological Tunnel BL 4 常规桥梁 Conventional Bridge CG 5 挡土墙工程类 Retaining Wall Engineering DT 6 辅助坑道施工 Auxiliary Adit Construction FB 7 复杂洞口工程施工 Complex Portal Construction FD 8 钢筋加工场安、拆 Reinforcement Yard Setup & Removal GG 9 钢栈桥施工 Steel Trestle Construction GZ 10 拱桥 Arch Bridge GH 11 涵洞工程类 Culvert Engineering HD 12 滑坡体处理类 Landslide Treatment HP 13 路堤 Embankment LT 14 路堑 Cut Slope LQ 15 其他 Other QT 16 深基坑 Deep Foundation Pit JK 17 隧道总体施工 Overall Tunnel Construction ZT 18 特殊结构隧道 Special Structure Tunnel TS 19 斜拉桥 Cable-Stayed Bridge XL 20 悬索桥 Suspension Bridge XS

    其他  Other   QT
    

  • 施工计划四级分类枚举定义 序号 中文描述（dict_name） 英文描述（dict_desc） 简写(dict_value) 1 挡土墙 Retaining Wall DT 2 顶管 Pipe Jacking DG 3 断层破碎带及软弱围岩 Fault Zone & Weak Rock Mass DL 4 钢筋砼箱涵 Reinforced Concrete Box Culvert GX 5 高填路堤 High Fill Embankment GT 6 抗滑桩 Anti-Slide Pile KH 7 软岩大变形隧道 Large Deformation Tunnel in Soft Rock RY 8 上部结构 Superstructure SB 9 深基坑开挖与支护 Deep Excavation & Support JK 10 深挖路堑 Deep Road Cut LC 11 隧道TBM Tunnel Boring Machine (TBM) TM 12 隧道进洞 Tunnel Portal Entry JD 13 隧道竖井 Tunnel Shaft SJ 14 隧道斜井 Tunnel Incline Shaft XJ 15 特种设备 Special Equipment TZ 16 瓦斯隧道 Gas-Prone Tunnel WS 17 下部结构 Substructure XB 18 小净距隧道 Small Spacing Tunnel NJ 19 岩爆隧道 Rockburst Tunnel YB 20 岩溶隧道 Karst Tunnel YR 21 涌水突泥隧道 Water Inrush & Mud Burst Tunnel YN 22 桩基础 Pile Foundation ZJ 23 其他 Other QT

前端系统设计

字典功能开发

字典功能应用开发

• 本次调整包括对应功能的 LQAdminPlatform 后端逻辑 和 LQAdminFront 前端逻辑

• 知识库管理

  • 知识库新增：元数据字段定义，字段类型 新增“字典”选型，用户选择字典类型时，同时新增字段 字典类别为下拉树形选择字典类别
  • 知识库元数据表 “t_samp_metadata” 新增字段 category_id varchar(50) COMMENT '字典类型id'
  • 知识库新增元数据表定义，只有用户选择字段类型为“字典” 时，字典类别不能为空 ，必须选择

• 检索引擎管理

  • 检索模式 为 高级模式

    • 元数据过滤条件 当字段类型为字典类型时，输入为下拉列表（根据知识库元数据表 category_id 字段的值 查询字典项列表 供用户选择），而非输入框，输入框只有字段类型为 文本或数字时
      

  • 知识片段管理 列表界面、详情界面

    • 首先确认 知识片段所属 具体文档，再根据文档对应具体知识库，再根据知识库对应元数据字段信息
    • 元数据字段信息，如果元数据字段类型为字典类型时，需要转换为字典名称
    • 根据知识库元数据表 category_id 字段的值和具体字典值 查询字典项表（t_sys_dict_category_item 条件：category_id 、dict_value ）的字典名称（dict_name）进行展示

  • 检索模式 列表界面 、详情界面

    • 首先确认 知识片段所属 具体文档，再根据文档对应具体知识库，再根据知识库对应元数据字段信息
    • 元数据字段信息，如果元数据字段类型为字典类型时，需要转换为字典名称
    • 根据知识库元数据表 category_id 字段的值和具体字典值 查询字典项表（t_sys_dict_category_item 条件：category_id 、dict_value ）的字典名称（dict_name）进行展示
      

• 文档管理中心

  • 列表编辑 ， 每一条记录编辑界面
    • 施工标准规范基本信息编辑
    • 新增编辑字段 ，通过如下信息构建字段的选项列表（下拉显示名称使用字典名称：dict_name, 下拉value值使用字典值：dict_value）
      • 文件类型 ，使用字典列表的字典项数据 文件类型枚举定义 file_type
      • 专业领域 ，使用字典列表的字典项数据 专业类型枚举定义 professional_type
      • 时效性 , 使用字典列表的字典项数据 时效性枚举定义 time_effect
    • 施工方案基本信息编辑
      • 新增编辑字段 ，通过如下信息构建字段的选项列表（下拉显示名称使用字典名称：dict_name, 下拉value值使用字典值：dict_value）
      • 方案类别 ，使用字典列表的字典项数据 施工方案类别枚举定义 construction_plan_type
      • 一级分类 ，使用字典列表的字典项数据 施工方案一级分类枚举定义 construction_plan_first_type
      • 二级分类 ，使用字典列表的字典项数据 施工方案二级分类枚举定义 construction_plan_second_type
      • 三级分类 ，使用字典列表的字典项数据 施工方案三级分类枚举定义 construction_plan_third_type
      • 四级分类 ，使用字典列表的字典项数据 施工方案四级分类枚举定义 construction_plan_fourth_type

• 文档基本信息

  • 施工标准规范管理

    • 列表查询筛选 下拉列表使用字典类别及字段项完成下拉列表初始化
    • 列表数据展示 将列表中的 文件类型、专业领域、时效性 字典值 转换为字典名称
    • 新增编辑字段 ，通过如下信息构建字段的选项列表（下拉显示名称使用字典名称：dict_name, 下拉value值使用字典值：dict_value）
      • 文件类型 ，使用字典列表的字典项数据 文件类型枚举定义 file_type
      • 专业领域 ，使用字典列表的字典项数据 专业类型枚举定义 professional_type
      • 时效性 , 使用字典列表的字典项数据 时效性枚举定义 time_effect

  • 施工方案管理

    • 列表查询筛选 下拉列表使用字典类别及字段项完成下拉列表初始化
    • 列表数据展示 将列表中的 方案类别、一级分类、二级分类、三级分类、四级分类 字典值 转换为字典名称
    • 新增编辑字段 ，通过如下信息构建字段的选项列表（下拉显示名称使用字典名称：dict_name, 下拉value值使用字典值：dict_value）
      • 方案类别 ，使用字典列表的字典项数据 施工方案类别枚举定义 construction_plan_type
      • 一级分类 ，使用字典列表的字典项数据 施工方案一级分类枚举定义 construction_plan_first_type
      • 二级分类 ，使用字典列表的字典项数据 施工方案二级分类枚举定义 construction_plan_second_type
      • 三级分类 ，使用字典列表的字典项数据 施工方案三级分类枚举定义 construction_plan_third_type
      • 四级分类 ，使用字典列表的字典项数据 施工方案四级分类枚举定义 construction_plan_fourth_type

字典项功能应用修复

• 文档基本信息

  • 施工标准规范管理
    • 列表查询筛选 下拉列表使用字典类别及字段项完成下拉列表初始化
      • 时效性 , 使用字典列表的字典项数据 时效性枚举定义 time_effect
    • 列表数据展示 将列表中的 文件类型、专业领域、时效性 字典值 转换为字典名称
    • 新增编辑字段 ，通过如下信息构建字段的选项列表（下拉显示名称使用字典名称：dict_name, 下拉value值使用字典值：dict_value）
      • 时效性 , 使用字典列表的字典项数据 时效性枚举定义 time_effect

• 文档管理中心

  • 列表编辑 ， 每一条记录编辑界面

    • 施工标准规范基本信息编辑
    • 新增编辑字段 ，通过如下信息构建字段的选项列表（下拉显示名称使用字典名称：dict_name, 下拉value值使用字典值：dict_value）
      • 文件类型 ，使用字典列表的字典项数据 文件类型枚举定义 file_type
      • 专业领域 ，使用字典列表的字典项数据 专业类型枚举定义 professional_type
      • 时效性 , 使用字典列表的字典项数据 时效性枚举定义 time_effect
    • 施工方案基本信息编辑
      • 新增编辑字段 ，通过如下信息构建字段的选项列表（下拉显示名称使用字典名称：dict_name, 下拉value值使用字典值：dict_value）
      • 方案类别 ，使用字典列表的字典项数据 施工方案类别枚举定义 construction_plan_type
      • 一级分类 ，使用字典列表的字典项数据 施工方案一级分类枚举定义 construction_plan_first_type
      • 二级分类 ，使用字典列表的字典项数据 施工方案二级分类枚举定义 construction_plan_second_type
      • 三级分类 ，使用字典列表的字典项数据 施工方案三级分类枚举定义 construction_plan_third_type
      • 四级分类 ，使用字典列表的字典项数据 施工方案四级分类枚举定义 construction_plan_fourth_type

  • 知识片段管理

    • 知识库查询筛选下拉列表，默认为空