科杰企业级系统（一期核心数据库字段详细版）

1. 文档定位

本文档给出科杰企业级系统一期核心数据库字段详细版，覆盖以下核心域：

• 组织与权限
• 标准设计资产
• 设备主档与一机一档
• 台账与整改
• 售后与服务
• 合规与资料导出

本文档目标不是直接生成最终建库 SQL，而是给出足够稳定的字段骨架，供后续：

• ER 图绘制
• ORM 建模
• 接口定义
• 数据迁移
• 权限和审计设计 使用。

2. 通用建模约定

2.1 主键与审计字段

除特殊说明外，所有业务表建议默认带以下公共字段：

• id BIGINT PK
• created_by BIGINT NULL
• created_at DATETIME NOT NULL
• updated_by BIGINT NULL
• updated_at DATETIME NOT NULL
• is_deleted TINYINT DEFAULT 0

2.2 状态字段建议

• 状态字段统一用 status 或 *_status
• 枚举值使用字典表维护，不直接硬编码在页面

2.3 附件字段建议

• 附件统一用 attachment_file 表管理
• 业务表只保存主附件 ID 或通过 biz_type + biz_id 关联

3. 组织与权限域

3.1 company

字段	类型	必填	说明
company_code	VARCHAR(64)	是	企业编码
company_name	VARCHAR(255)	是	企业名称
company_type	VARCHAR(64)	是	制造商/客户/维保商/供应商
unified_credit_code	VARCHAR(64)	否	统一社会信用代码
contact_name	VARCHAR(64)	否	联系人
contact_mobile	VARCHAR(32)	否	联系电话
province	VARCHAR(64)	否	省
city	VARCHAR(64)	否	市
address	VARCHAR(255)	否	地址
status	VARCHAR(32)	是	启用/停用

3.2 department

字段	类型	必填	说明
company_id	BIGINT	是	所属企业
dept_code	VARCHAR(64)	是	部门编码
dept_name	VARCHAR(128)	是	部门名称
parent_id	BIGINT	否	上级部门
manager_user_id	BIGINT	否	部门负责人
status	VARCHAR(32)	是	启用/停用

3.3 user_account

字段	类型	必填	说明
company_id	BIGINT	是	所属企业
dept_id	BIGINT	否	所属部门
username	VARCHAR(64)	是	登录账号
password_hash	VARCHAR(255)	是	密码摘要
real_name	VARCHAR(64)	是	姓名
mobile	VARCHAR(32)	否	手机号
email	VARCHAR(128)	否	邮箱
user_type	VARCHAR(32)	是	内部/客户/维保商/供应商
status	VARCHAR(32)	是	启用/停用/锁定
last_login_at	DATETIME	否	最近登录时间

3.4 role

字段	类型	必填	说明
role_code	VARCHAR(64)	是	角色编码
role_name	VARCHAR(128)	是	角色名称
role_group	VARCHAR(64)	是	销售/设计/台账/售后等
data_scope_type	VARCHAR(32)	是	本人/部门/公司/按客户/按设备
status	VARCHAR(32)	是	启用/停用

3.5 user_role_rel

字段	类型	必填	说明
user_id	BIGINT	是	用户
role_id	BIGINT	是	角色
effective_from	DATETIME	否	生效时间
effective_to	DATETIME	否	失效时间

3.6 permission_action

字段	类型	必填	说明
module_code	VARCHAR(64)	是	模块编码
page_code	VARCHAR(64)	否	页面编码
action_code	VARCHAR(32)	是	V/C/E/S/A/X/P/M
action_name	VARCHAR(64)	是	动作名称

3.7 role_permission_rel

字段	类型	必填	说明
role_id	BIGINT	是	角色
permission_id	BIGINT	是	权限动作

4. 标准设计资产域

4.1 product_model

字段	类型	必填	说明
model_code	VARCHAR(64)	是	机型编码
model_name	VARCHAR(128)	是	机型名称
crane_type	VARCHAR(64)	是	LD/LH/QD/门吊/半门吊
capacity_range	VARCHAR(64)	否	吨位范围
span_range	VARCHAR(64)	否	跨度范围
work_level	VARCHAR(32)	否	工作级别
status	VARCHAR(32)	是	草稿/启用/停用

4.2 electrical_scheme

字段	类型	必填	说明
model_id	BIGINT	是	所属机型
scheme_code	VARCHAR(64)	是	方案编码
scheme_name	VARCHAR(128)	是	方案名称
voltage_level	VARCHAR(32)	否	电压等级
dual_power_reserved	TINYINT	是	是否预留双模式
iot_reserved	TINYINT	是	是否预留 IoT
status	VARCHAR(32)	是	草稿/审核中/已发布
current_version_no	VARCHAR(32)	否	当前版本号

4.3 drawing_asset

字段	类型	必填	说明
scheme_id	BIGINT	是	所属方案
drawing_type	VARCHAR(32)	是	原理图/接线图/布局图/线束图
drawing_code	VARCHAR(64)	是	图纸编号
drawing_name	VARCHAR(128)	是	图纸名称
current_version_id	BIGINT	否	当前版本
status	VARCHAR(32)	是	草稿/启用/停用

4.4 drawing_version

字段	类型	必填	说明
drawing_id	BIGINT	是	图纸
version_no	VARCHAR(32)	是	版本号
file_id	BIGINT	是	附件文件
change_summary	VARCHAR(255)	否	变更摘要
review_status	VARCHAR(32)	是	草稿/待审/通过/驳回
publish_status	VARCHAR(32)	是	未发布/已发布
published_at	DATETIME	否	发布时间

4.5 plc_program

字段	类型	必填	说明
scheme_id	BIGINT	是	所属方案
program_code	VARCHAR(64)	是	程序编码
program_name	VARCHAR(128)	是	程序名称
current_version_id	BIGINT	否	当前版本
status	VARCHAR(32)	是	草稿/启用/停用

4.6 plc_program_version

字段	类型	必填	说明
program_id	BIGINT	是	程序
version_no	VARCHAR(32)	是	版本号
file_id	BIGINT	是	程序文件
compatible_model	VARCHAR(255)	否	兼容机型说明
review_status	VARCHAR(32)	是	草稿/待审/通过/驳回
publish_status	VARCHAR(32)	是	未发布/已发布

4.7 bom_template

字段	类型	必填	说明
scheme_id	BIGINT	是	所属方案
bom_code	VARCHAR(64)	是	BOM编码
bom_name	VARCHAR(128)	是	BOM名称
version_no	VARCHAR(32)	是	版本号
status	VARCHAR(32)	是	草稿/已发布/停用

4.8 bom_item

字段	类型	必填	说明
bom_id	BIGINT	是	BOM模板
part_code	VARCHAR(64)	是	物料编码
part_name	VARCHAR(128)	是	物料名称
spec	VARCHAR(128)	否	规格
quantity	DECIMAL(18,4)	是	数量
unit	VARCHAR(16)	是	单位
supplier_id	BIGINT	否	推荐供应商
is_domestic_preferred	TINYINT	是	是否国产优先
substitute_part_code	VARCHAR(64)	否	替代料编码

4.9 engineering_change

字段	类型	必填	说明
change_no	VARCHAR(64)	是	变更单号
source_type	VARCHAR(32)	是	图纸/PLC/BOM/方案
source_id	BIGINT	是	来源对象
change_reason	VARCHAR(255)	是	变更原因
impact_scope	VARCHAR(255)	否	影响范围
status	VARCHAR(32)	是	草稿/待审/已生效/已驳回
approved_by	BIGINT	否	审批人
effective_at	DATETIME	否	生效时间

5. 设备主档与一机一档域

5.1 equipment

字段	类型	必填	说明
equipment_code	VARCHAR(64)	是	设备编码
equipment_name	VARCHAR(128)	是	设备名称
model_id	BIGINT	是	机型
customer_id	BIGINT	否	客户
project_name	VARCHAR(128)	否	项目名称
manufacturer_name	VARCHAR(128)	否	制造单位
installation_company_name	VARCHAR(128)	否	安装单位
use_location	VARCHAR(255)	否	使用地点
registration_no	VARCHAR(64)	否	使用登记证号
inspection_valid_to	DATE	否	检验有效期
archive_status	VARCHAR(32)	是	待建档/建档中/已完整
operation_status	VARCHAR(32)	是	待投用/运行中/停用/禁用
risk_level	VARCHAR(32)	是	低/中/高

5.2 equipment_archive

字段	类型	必填	说明
equipment_id	BIGINT	是	设备
archive_completeness	DECIMAL(5,2)	是	完整度评分
random_docs_status	VARCHAR(32)	是	随机资料状态
inspection_docs_status	VARCHAR(32)	是	检验资料状态
registration_docs_status	VARCHAR(32)	是	登记资料状态
delivery_docs_status	VARCHAR(32)	是	交付资料状态
last_checked_at	DATETIME	否	最近校验时间

5.3 archive_document

字段	类型	必填	说明
equipment_id	BIGINT	是	设备
doc_type	VARCHAR(64)	是	合格证/检验报告/登记证/说明书等
doc_name	VARCHAR(128)	是	文件名称
file_id	BIGINT	是	附件
issue_date	DATE	否	出具日期
expire_date	DATE	否	到期日期
verify_status	VARCHAR(32)	是	未校验/有效/疑似异常/过期
version_no	VARCHAR(32)	否	版本

5.4 equipment_version_binding

字段	类型	必填	说明
equipment_id	BIGINT	是	设备
scheme_id	BIGINT	否	电控方案
drawing_version_id	BIGINT	否	图纸版本
plc_version_id	BIGINT	否	PLC版本
bom_id	BIGINT	否	BOM模板
bind_status	VARCHAR(32)	是	当前/历史

5.5 delivery_package

字段	类型	必填	说明
equipment_id	BIGINT	是	设备
package_no	VARCHAR(64)	是	资料包编号
package_type	VARCHAR(32)	是	出厂/交付/报检
generated_status	VARCHAR(32)	是	草稿/已生成
file_id	BIGINT	否	导出文件
generated_at	DATETIME	否	生成时间

6. 台账与整改域

6.1 inspection_task

字段	类型	必填	说明
equipment_id	BIGINT	是	设备
task_type	VARCHAR(32)	是	日检/月检/维保/年检/定检准备
plan_date	DATE	是	计划日期
due_date	DATE	是	截止日期
assignee_id	BIGINT	否	执行人
status	VARCHAR(32)	是	待执行/已完成/逾期/关闭
source_rule	VARCHAR(64)	否	生成规则

6.2 inspection_daily

字段	类型	必填	说明
equipment_id	BIGINT	是	设备
task_id	BIGINT	是	任务
check_date	DATE	是	检查日期
shift_type	VARCHAR(16)	是	白班/夜班
operator_id	BIGINT	是	操作员
safety_confirm_user_id	BIGINT	否	安全确认人
problem_desc	TEXT	否	问题描述
result	VARCHAR(32)	是	合格/异常
is_backfill	TINYINT	是	是否补录
backfill_reason	VARCHAR(255)	否	补录原因

6.3 inspection_daily_item

字段	类型	必填	说明
daily_id	BIGINT	是	日检单
item_code	VARCHAR(64)	是	项目编码
item_name	VARCHAR(128)	是	项目名称
check_result	VARCHAR(16)	是	√/×
remark	VARCHAR(255)	否	备注

6.4 inspection_monthly

字段	类型	必填	说明
equipment_id	BIGINT	是	设备
task_id	BIGINT	是	任务
check_date	DATE	是	月检日期
checker_id	BIGINT	是	检查人
safety_user_id	BIGINT	否	安全员
approver_id	BIGINT	否	审批人
issue_desc	TEXT	否	存在问题
rectification_desc	TEXT	否	整改情况
result	VARCHAR(32)	是	合格/异常
is_backfill	TINYINT	是	是否补录
backfill_reason	VARCHAR(255)	否	补录原因

6.5 maintenance_record

字段	类型	必填	说明
equipment_id	BIGINT	是	设备
task_id	BIGINT	是	任务
maintenance_company_id	BIGINT	否	维保单位
maintenance_date	DATE	是	维保日期
maintainer_id	BIGINT	是	维保人
accept_user_id	BIGINT	否	验收人
issue_desc	TEXT	否	遗留问题
rectification_requirement	TEXT	否	整改要求
result	VARCHAR(32)	是	已完成/异常
is_backfill	TINYINT	是	是否补录
backfill_reason	VARCHAR(255)	否	补录原因

6.6 annual_self_check

字段	类型	必填	说明
equipment_id	BIGINT	是	设备
task_id	BIGINT	是	任务
self_check_date	DATE	是	自检日期
checker_id	BIGINT	是	自检人
safety_user_id	BIGINT	否	安全管理员
approver_id	BIGINT	否	审批人
conclusion	VARCHAR(32)	是	合格/基本合格/不合格
issue_desc	TEXT	否	问题与整改
stamp_file_id	BIGINT	否	盖章件
is_backfill	TINYINT	是	是否补录
backfill_reason	VARCHAR(255)	否	补录原因

6.7 rectification_task

字段	类型	必填	说明
equipment_id	BIGINT	是	设备
source_type	VARCHAR(32)	是	日检/月检/维保/年检/工单
source_id	BIGINT	是	来源ID
issue_desc	TEXT	是	问题描述
risk_level	VARCHAR(32)	是	低/中/高
owner_id	BIGINT	否	责任人
due_date	DATE	否	截止日期
status	VARCHAR(32)	是	待处理/处理中/待复核/已关闭
rectification_measure	TEXT	否	整改措施
review_user_id	BIGINT	否	复核人
review_result	VARCHAR(32)	否	通过/驳回
closed_at	DATETIME	否	关闭时间

7. 售后与服务域

7.1 service_work_order

字段	类型	必填	说明
work_order_no	VARCHAR(64)	是	工单号
equipment_id	BIGINT	是	设备
customer_id	BIGINT	否	客户
order_type	VARCHAR(32)	是	故障/巡检/维保/回访
source_type	VARCHAR(32)	是	客户/系统/告警/内部
priority	VARCHAR(16)	是	低/中/高/紧急
issue_desc	TEXT	是	问题描述
status	VARCHAR(32)	是	待派工/处理中/待确认/已关闭

7.2 service_dispatch

字段	类型	必填	说明
work_order_id	BIGINT	是	工单
assignee_id	BIGINT	是	工程师
dispatch_user_id	BIGINT	是	派工人
dispatch_time	DATETIME	是	派工时间
arrive_time	DATETIME	否	到场时间
finish_time	DATETIME	否	完成时间
status	VARCHAR(32)	是	已派工/已接单/已完成

7.3 service_visit_record

字段	类型	必填	说明
work_order_id	BIGINT	是	工单
engineer_id	BIGINT	是	工程师
visit_date	DATE	是	服务日期
process_desc	TEXT	否	处理经过
result_desc	TEXT	否	处理结果
next_action	VARCHAR(255)	否	后续建议

7.4 service_part_usage

字段	类型	必填	说明
work_order_id	BIGINT	是	工单
part_code	VARCHAR(64)	是	配件编码
part_name	VARCHAR(128)	是	配件名称
quantity	DECIMAL(18,4)	是	用量
unit	VARCHAR(16)	是	单位
usage_note	VARCHAR(255)	否	说明

7.5 service_feedback

字段	类型	必填	说明
work_order_id	BIGINT	是	工单
customer_score	INT	否	评分
feedback_text	VARCHAR(255)	否	反馈
confirmed_by	BIGINT	否	确认人
confirmed_at	DATETIME	否	确认时间

8. 合规与导出域

8.1 compliance_case

字段	类型	必填	说明
equipment_id	BIGINT	是	设备
compliance_type	VARCHAR(32)	是	检验/登记/资料缺失/超期/整改
issue_desc	TEXT	是	风险描述
risk_level	VARCHAR(32)	是	低/中/高
status	VARCHAR(32)	是	待处理/处理中/已关闭
owner_id	BIGINT	否	责任人
due_date	DATE	否	截止日期
closed_at	DATETIME	否	关闭时间

8.2 inspection_status_log

字段	类型	必填	说明
equipment_id	BIGINT	是	设备
old_status	VARCHAR(32)	否	旧状态
new_status	VARCHAR(32)	是	新状态
reason	VARCHAR(255)	否	变更原因
changed_by	BIGINT	是	操作人
changed_at	DATETIME	是	变更时间

8.3 export_package

字段	类型	必填	说明
equipment_id	BIGINT	否	设备
package_type	VARCHAR(32)	是	台账包/报检包/交付包
export_scope	VARCHAR(255)	是	导出范围
generated_by	BIGINT	是	导出人
generated_at	DATETIME	是	导出时间
file_id	BIGINT	否	导出文件

9. 附件与审计域

9.1 attachment_file

字段	类型	必填	说明
biz_type	VARCHAR(64)	是	业务类型
biz_id	BIGINT	是	业务ID
file_name	VARCHAR(255)	是	文件名
file_ext	VARCHAR(16)	否	扩展名
file_size	BIGINT	否	文件大小
file_url	VARCHAR(500)	是	存储地址
uploaded_by	BIGINT	是	上传人
uploaded_at	DATETIME	是	上传时间

9.2 signature_record

字段	类型	必填	说明
biz_type	VARCHAR(64)	是	业务类型
biz_id	BIGINT	是	业务ID
signer_id	BIGINT	是	签字人
signer_role	VARCHAR(64)	否	角色
sign_type	VARCHAR(32)	是	图片签字/电子确认
sign_file_id	BIGINT	否	签字附件
sign_time	DATETIME	是	签字时间

9.3 operation_log

字段	类型	必填	说明
module_code	VARCHAR(64)	是	模块
biz_type	VARCHAR(64)	否	业务类型
biz_id	BIGINT	否	业务ID
action_code	VARCHAR(32)	是	create/update/delete/export/approve
operator_id	BIGINT	是	操作人
before_json	JSON	否	变更前
after_json	JSON	否	变更后
ip_address	VARCHAR(64)	否	IP
operated_at	DATETIME	是	操作时间

10. 一期建表优先级建议

P0 必建表

• company
• department
• user_account
• role
• user_role_rel
• product_model
• electrical_scheme
• drawing_asset
• drawing_version
• plc_program
• plc_program_version
• bom_template
• bom_item
• equipment
• equipment_archive
• archive_document
• equipment_version_binding
• inspection_task
• inspection_daily
• inspection_daily_item
• inspection_monthly
• maintenance_record
• annual_self_check
• rectification_task
• service_work_order
• service_dispatch
• compliance_case
• attachment_file
• signature_record
• operation_log

P1 建议表

• engineering_change
• delivery_package
• service_visit_record
• service_part_usage
• service_feedback
• inspection_status_log
• export_package

11. 结论

一期数据库不应该追求一步到位覆盖所有未来场景，而应该优先保证：

• 设计资产可管理
• 设备主档可沉淀
• 台账可闭环
• 服务可追溯
• 合规风险可识别
• 所有关键动作可审计

只要这六件事站住，后续的采购深化、IoT接入、客户协同与监管对接才能稳定演进。