工程合同义务跟踪表设计与动态监控的接口调用实战 - 第1节
1.1 为什么需要工程合同义务跟踪？
在大型工程项目中，合同往往长达数百页，包含付款、工期、变更、索赔、保修等数十项义务条款。传统依赖人工 Excel 或纸质台账的管理方式，容易导致以下问题：
- 义务遗漏：关键节点（如提交履约保函、完成隐蔽工程验收）无人提醒，造成违约风险。
- 信息孤岛：合同条款、实际执行、变更记录分散在不同部门，无法形成闭环。
- 响应滞后：义务到期后才开始处理，缺乏提前预警和动态调整能力。
- 审计困难：历史义务履行状态不可追溯，纠纷时举证成本高。
课程核心观点：将合同义务从静态文本转化为可跟踪、可预警、可统计的动态数据表，是提升工程履约管理效率的关键。
1.2 课程目标与学习路径
本课程旨在帮助学员掌握从零构建一套工程合同义务跟踪与动态监控系统的完整能力。学习路径分为四个阶段：
| 阶段 | 核心目标 | 产出物 |
|---|---|---|
| 第一阶段：基础搭建 | 理解合同义务数据模型，搭建 Flask + MySQL 后端 | 义务 CRUD API、数据库表结构 |
| 第二阶段：接口开发 | 实现义务列表、详情、状态变更、到期预警等接口 | RESTful API 文档与 Postman 测试集 |
| 第三阶段：前端交互 | 使用 Vue.js 构建义务跟踪看板与动态监控面板 | 可交互的 SPA 页面 |
| 第四阶段：集成与优化 | 前后端联调、权限控制、日志审计与部署 | 可运行的全栈项目 |
学习建议：每章结束后，建议在本地环境中复现代码，并尝试修改参数观察效果，以加深对接口调用与数据流转的理解。
1.3 整体技术栈概览
本课程选用业界成熟且轻量化的技术组合，兼顾教学效率与工程实用性：
- Python 3.10+：作为后端主力语言，生态丰富，适合快速开发 API。
- Flask 2.x：轻量级 Web 框架，路由、请求处理、JSON 响应简洁直观。
- MySQL 8.0：关系型数据库，用于存储合同义务、状态变更、预警记录等结构化数据。
- Vue.js 3 + Element Plus：前端框架与组件库，实现响应式看板、表格、表单与图表。
- RESTful API：前后端通过 JSON 格式交互，接口设计遵循标准 HTTP 方法。
1.4 课程特色与实战安排
本课程不是单纯的理论讲解，而是围绕一个真实的工程合同义务跟踪场景展开：
- 场景驱动：以一个“EPC 总承包合同”为蓝本，定义 10 项典型义务（如提交进度报告、支付进度款、完成设备到货验收等）。
- 接口实战：从 Flask 路由编写、MySQL 查询优化到 Vue.js 组件调用，每一步都有可运行的代码。
- 动态监控：实现义务状态看板、到期预警、超期高亮、历史变更追溯等真实功能。
前置要求：学员需具备 Python 基础语法、HTML/CSS/JavaScript 基本认知，以及 MySQL 基本操作能力。课程会提供必要的环境搭建指引，但不会从头教授编程基础。
1.5 本章小结
通过本章导论，我们明确了：
- 工程合同义务跟踪的业务痛点与数字化价值。
- 课程四阶段学习路径：基础搭建 → 接口开发 → 前端交互 → 集成优化。
- 技术栈选型：Python + Flask + MySQL + Vue.js，兼顾教学与工程实践。