4. 数据库设计（下）：义务明细表字段设计

义务明细表是合同义务跟踪系统的核心数据实体，它记录了每一条具体合同义务的完整属性。本节将详细拆解义务明细表的字段设计，包括字段类型、长度、约束以及业务含义，确保数据库结构能够支撑后续的动态监控与接口调用。

4.1 义务明细表核心字段清单

义务明细表（obligation_detail）的设计遵循“高内聚、低冗余”原则，每个字段都对应一个明确的业务监控维度。下表列出了所有关键字段及其设计规范：

4.2 字段设计深度解析

4.2.1 义务ID与合同ID：主键与外键的协作

• obligation_id 采用自增 BIGINT，确保高并发场景下主键的唯一性与写入性能。
• contract_id 作为外键，必须建立索引以加速按合同查询义务列表的 JOIN 操作。
• 建议在 contract_id 上创建非唯一索引，因为一个合同通常包含多条义务。

4.2.2 义务类型与状态：枚举驱动的业务逻辑

• obligation_type 决定了义务的监控规则。例如，付款义务需要关联财务凭证号，交付义务需要关联物流单号。
• status 字段与 deadline 字段联动：当当前日期超过 deadline 且 status 不为“已完成”或“已关闭”时，系统自动将 status 标记为“已逾期”。
• 状态流转必须遵循有限状态机（FSM）规则，例如“待办”只能进入“进行中”或“已逾期”，不能直接跳转到“已完成”。

4.2.3 完成百分比：精度与业务含义

• 使用 DECIMAL(5,2) 支持两位小数，满足精细化管理需求（如 87.50%）。
• 百分比的计算逻辑由后端服务根据子任务完成情况自动更新，不允许前端直接写入。
• 当 completion_percentage = 100.00 时，系统应自动触发状态变更检查，若满足条件则将 status 更新为“已完成”。

4.3 义务明细表实体关系图

下图展示了义务明细表与合同主表之间的核心关联，以及义务内部字段之间的逻辑依赖关系：

4.4 字段设计避坑指南

4.5 建表 SQL 参考

以下为义务明细表的完整建表语句，包含主键、外键、索引及默认值约束：

CREATE TABLE `obligation_detail` (
  `obligation_id`       BIGINT(20)    NOT NULL AUTO_INCREMENT  COMMENT '义务唯一ID',
  `contract_id`         BIGINT(20)    NOT NULL                 COMMENT '关联合同ID',
  `obligation_type`     TINYINT(4)    NOT NULL DEFAULT 0       COMMENT '义务类型:0-付款,1-交付,2-验收,3-质保,4-其他',
  `responsible_person`  VARCHAR(64)   NOT NULL                 COMMENT '责任人',
  `deadline`            DATE          NOT NULL                 COMMENT '截止日期',
  `status`              TINYINT(4)    NOT NULL DEFAULT 0       COMMENT '状态:0-待办,1-进行中,2-已完成,3-已逾期,4-已关闭',
  `completion_percentage` DECIMAL(5,2) NOT NULL DEFAULT 0.00  COMMENT '完成百分比 0.00~100.00',
  `create_time`         DATETIME      NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_time`         DATETIME      NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  PRIMARY KEY (`obligation_id`),
  KEY `idx_contract_id` (`contract_id`),
  KEY `idx_responsible_person` (`responsible_person`),
  KEY `idx_deadline` (`deadline`),
  KEY `idx_status` (`status`),
  CONSTRAINT `fk_contract` FOREIGN KEY (`contract_id`) REFERENCES `contract_main` (`contract_id`) ON DELETE CASCADE ON UPDATE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='合同义务明细表';