项目介绍：
本项目“智契通”是一个基于大模型的智能合同全生命周期处理平台，面向法律与商务场景，实现合同智能生成、风险评估、关键条款摘要、合同优化、多版本追溯等功能。

队名：志气队

项目博客地址：
（1）王熠：MerQWQ-CSDN博客
（2）张鸿震：2401_85166149-CSDN博客
（3）孙涔朔：iastvv11k1nb-CSDN博客
（4）韦建华：2301_78647081-CSDN博客

项目代码地址：https://gitee.com/iastvv11k1nb/ContraAI

项目开发记录

第五周：合同管理主线与智能功能补齐

第五周主要围绕中期检查后的功能补齐展开。前四周项目已经完成登录、模板管理、智能合同生成、AI 助手和合同优化基础页面，但系统整体仍偏向“能生成合同”，还没有完全体现“合同全生命周期处理平台”的定位。因此本周重点是补齐合同生成后的管理、审查、摘要和历史留痕能力。

王熠负责合同管理主功能和版本快照机制完善。此前合同管理页面主要承载智能合同生成表单，页面职责不够清晰。本周将合同管理主入口调整为合同台账页面，并把智能合同生成拆分为独立页面 /contract/generate。新的合同管理页面支持合同分页列表、关键词筛选、分类筛选、状态筛选和合同详情查看。后端详情查询时优先读取 latest_version_id，保证页面展示当前最新版本正文。正文保存时不直接覆盖原内容，而是新增 contract_version 版本记录，并更新合同主表的最新版本指向。同时新增上传导入合同功能，支持 txt、doc、docx、pdf 文件解析，使已有合同也能进入系统管理流程。

张鸿震负责合同风险审查功能第一阶段落地。原系统虽然已有风险审查页面入口和 risk 模块，但页面主要是静态示例数据，后端接口也没有真正接入大模型分析。本周张鸿震将风险审查拆分为完整业务链路：用户输入合同文本，后端构造风险审查 Prompt，调用 AiChatService 访问大模型，围绕合规性、公平性、完整性三类风险进行识别，并要求模型返回结构化 JSON。后端解析风险条款、风险分类、风险等级、置信度、风险说明和修改建议，将风险审查任务和明细结果保存到数据库。前端 RiskView.vue 改造为真实交互页面，支持发起审查、展示风险清单，并对单条风险进行确认或忽略。

孙涔朔负责合同摘要提取功能第一阶段。原摘要页面只是静态展示，后端接口也只返回固定内容。本周孙涔朔完成了摘要提取真实流程：支持用户直接输入合同文本，也支持上传 PDF、Word、TXT 文件并解析正文；后端接入 AiChatService，构造专门用于合同摘要的 Prompt，自动提取合同主体、金额、日期、违约责任等核心要素，并生成百字以内的一句话摘要。摘要结果保存到 contract_summary 表，前端摘要页面改造为“文本输入 + 文件上传”的双入口模式，展示摘要正文、核心要素、摘要长度、压缩率和覆盖率指标。该功能降低了用户阅读长篇合同的成本，也为后续接入合同详情页和版本体系提供了基础。

韦建华负责历史记录管理后端功能。随着合同生成、合同优化、摘要提取、风险审查等功能逐渐增多，系统需要统一入口保存用户操作结果。因此本周新增独立 history 模块，包括历史分类、历史列表、详情查看、关键词搜索和单条删除接口，并新增 history_record 表。历史记录支持保存功能类型、标题、预览内容、完整输入、完整输出、关联合同 ID、关联版本 ID 等信息。保存历史时采用 recordQuietly 方式，即历史保存失败不影响主业务流程，避免辅助功能阻塞合同生成、摘要提取或风险审查。该模块为后续统一查看各类 AI 操作结果提供了公共能力。

第六周：合同生命周期闭环继续完善

第六周主要在第五周基础上继续推进合同生命周期闭环，重点补充版本回滚、版本对比、导出归档、AI 日志、风险驱动优化、摘要版本绑定和历史记录前端页面。

王熠负责合同版本管理、文本对比、导出归档和 AI 调用日志。版本回滚遵循“历史版本不可变”的原则，不直接把 latest_version_id 指回旧版本，而是复制目标版本正文，新增一个 source_type 为 rollback 的版本，使回滚行为本身也成为可追踪的历史记录。版本对比方面，本周先实现确定性的文本 diff，按行切分左右版本正文，识别新增、删除和修改内容，并通过编辑距离计算文本相似度。同时新增合同 Word 导出和归档功能，支持导出最新版本或指定历史版本。AI 调用日志也统一接入 AiChatService，记录任务类型、模型名称、Prompt 版本、调用状态、耗时和错误信息，便于后续调试和评估。

张鸿震负责风险驱动合同优化功能。第五周风险审查已经能够发现风险，但如果只停留在“发现问题”，用户仍然需要手动修改合同。因此本周张鸿震在已有风险审查结果基础上继续推进，形成“发现风险 -> 确认风险 -> 生成修订建议”的处理链路。前端风险表格新增风险勾选能力，并限制只有“已确认”的风险才能进入一键优化流程。后端新增 /api/risk/optimize 接口，复用 AiChatService，根据风险说明和修改建议生成可替换的优化条款。前端增加“一键优化”按钮和优化结果弹窗，展示原条款、风险说明、AI 优化条款和修改摘要，并将优化记录写入历史记录模块，使风险审查能够进一步联动合同优化。

孙涔朔负责摘要功能迭代。第五周摘要功能已经能独立生成摘要，但它仍像一个单独工具，没有很好接入合同详情和版本体系。本周孙涔朔在合同详情页增加“生成摘要 / 重新生成摘要”入口，摘要生成时绑定 contractId 和 versionId，生成成功后保存到 contract_summary，并在摘要对应合同最新版本时回写 contract_info.summary_text。为避免摘要和正文版本不一致，当合同编辑保存新版本或执行版本回滚后，系统会清空旧摘要，提醒用户基于新正文重新生成。摘要 AI 调用也统一记录为 summary / summary-v1，便于后续统计、排查和 Prompt 迭代。该迭代让摘要功能从独立工具变成合同管理流程的一部分。

韦建华负责历史记录管理前端功能。本周新增 frontend/src/views/history/HistoryView.vue 和 frontend/src/api/history.ts，并在路由和菜单中接入 /history 页面。页面采用“左侧功能分类 + 右侧记录列表”的结构，分类从后端接口获取，用户点击分类后查询该分类下的历史记录。右侧列表展示标题、功能名称、预览内容、创建时间、关联合同 ID、关联版本 ID 和删除按钮。点击记录后，通过详情弹窗展示完整结果内容和输入内容，并保留合同文本原始换行格式。页面还支持关键词搜索、单条删除、分页、加载状态和空状态，使合同生成、合同优化、摘要提取、风险审查等操作有了统一查看入口。

截至第六周的整体进度

截至第六周，项目已经从中期检查时的基础生成演示系统，推进到较完整的智能合同生命周期处理平台。当前系统支持用户登录和角色菜单控制，管理员维护合同模板并发布，业务用户通过模板生成合同，也可以上传已有 Word、PDF、TXT 合同进入系统。合同进入系统后，可以在合同台账中查询、筛选、查看详情、编辑正文、生成新版本、查看历史版本、执行版本回滚、进行文本差异对比、导出 Word 文件并归档。

AI 能力方面，系统已经具备通用 AI 助手、智能合同生成、合同风险审查、风险驱动优化、摘要提取和合同优化基础能力。风险审查可以识别合规性、公平性、完整性风险，并支持人工确认或忽略；风险驱动优化可以针对已确认风险生成修改条款；摘要提取已经接入合同详情和版本体系；AI 调用日志能够记录模型调用过程，方便后续调试和评估。

目前仍需继续完善的能力包括：风险优化结果一键应用到合同正文、合同优化与版本体系进一步联动、版本对比结果持久化、语义级条款对比、PDF 导出、知识库检索增强、完整权限控制、测试报告、Prompt 版本管理和数据集评测。后续阶段将继续围绕最终验收推进联调测试、异常处理、页面体验优化、测试数据补充、项目文档完善和答辩材料整理。