项目介绍：

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

队名：志气队

项目博客地址：

（1）王熠：https://blog.csdn.net/MerQWQ?spm=1000.2115.3001.5343
（2）张鸿震：https://blog.csdn.net/2401_85166149?type=blog
（3）孙涔朔：https://blog.csdn.net/2201_75606551?type=blog
（4）韦建华：https://blog.csdn.net/2301_78647081?type=blog
项目代码地址：https://gitee.com/iastvv11k1nb/ContraAI

项目开发记录

第一周：需求分析与总体设计

第一周主要围绕项目启动、需求拆解和开发文档制定展开，重点是把任务书中的目标转化为可开发的模块。

王熠负责总体架构和技术路线设计，确定项目采用 Spring Boot 3 + Vue 3 + Vite + Element Plus + Pinia + Axios 的前后端分离方案，后端以 backend/contract-admin 作为当前核心单体模块。

孙涔烁负责需求分析和流程设计，明确业务角色、核心业务流程，并整理合同生成、风险审查、摘要提取、合同润色、版本管理等模块，形成 04-项目流程图设计（需求分析）.md。

张鸿震负责数据库第一阶段设计，梳理用户、角色、权限、合同模板、模板字段、合同主表、合同字段值、合同附件等核心实体，形成 02-数据库设计.md 的主体结构。

韦建华负责开发文档前半部分，整理开发目标、验收指标、工程结构、后端分层规范、接口返回规范、前端开发规范和 AI 服务封装规范，形成 03-开发文档设计.md 的基础内容。

第一周结束时，项目完成了需求边界、技术选型、数据库初稿、流程图和开发规范的初步统一，为后续使用 AI 生成工程骨架和分模块开发提供了依据。

第二周：文档完善与项目骨架生成

第二周主要是完善开发文档，并根据文档生成项目模板，进行初步运行和微调。

王熠补充了核心数据库建表脚本 backend/sql/init.sql，覆盖用户表、合同模板表、模板字段表、合同主表、合同字段值表、合同版本表等，为后续模板管理和合同生成落库提供基础。

孙涔烁整理接口文档 05-接口文档.md，统一接口前缀 /api 和返回格式 { code, message, data }，规划认证、用户、模板、合同、风险、摘要润色、版本管理等接口。

张鸿震继续完善数据库设计，补充风险分析任务、风险结果、摘要结果、润色结果、Prompt 模板、模型调用日志、数据集和操作日志等规划表，并设计索引和初始化字典。其中风险、摘要、润色相关表后续已部分落地，Prompt 和模型日志仍处于规划阶段。

韦建华补充开发文档后半部分，包括接口清单、前后端任务拆解、AI Prompt 任务拆解、测试设计、交付文档、开发排期和技术风险应对。

第二周结束时，项目已有较完整的文档体系，包括架构、数据库、开发规范、流程图和接口文档；同时初步生成了 Spring Boot 后端和 Vue 前端工程骨架，后续开发开始从文档阶段转向代码阶段。

第三周：基础能力落地与模块初步开发

第三周开始进入功能开发和联调阶段。

王熠完成通用 AI 助手链路。后端新增 modules/ai，包括 AiProperties、AiChatService、AiChatController 等，提供 POST /api/ai/chat 接口；后端通过 RestClient 调用 Sophnet OpenAI 兼容接口 /v1/chat/completions，模型配置为 DeepSeek-V4-Flash。前端新增 AiChatButton.vue 并挂载到 MainLayout.vue，实现弹窗提问和 AI 回答展示。

孙涔烁使用 Codex 基于五份设计文档生成并分析项目基础骨架。项目保留了 backend Maven 父工程、contract-admin 子模块，以及前端 api / layouts / router / stores / views 等目录结构，预置登录、仪表盘、模板、合同、风险、摘要、润色、对比、系统设置等页面入口。

张鸿震完成 JPA 与 MySQL 数据库环境搭建。后端引入 spring-boot-starter-data-jpa 和 mysql-connector-java，在 application.yml 中配置 MySQL 数据源、ddl-auto: update 和 show-sql: true，并落地用户权限相关实体类，用于验证 Hibernate 自动建表。

韦建华完成合同优化后端第一阶段。PolishController.java 中的 POST /api/polish/generate 接口开始接收 originalText，进行空文本校验，并返回 originalText 和 polishedText。当前暂未接入真实 AI 优化，也未保存数据库，但预留了后续智能处理入口。

第三周结束时，项目已经具备可运行的前后端骨架、MySQL/JPA 数据层基础、通用 AI 助手接口，以及合同优化后端最小闭环。

第四周：核心业务链路推进

第四周重点推进可演示功能。

王熠完成模板管理和智能合同生成第一阶段。后端新增 TemplateController、TemplateService，支持模板列表、详情、新增、编辑、删除、发布和字段配置；前端 TemplateView.vue 实现模板维护页面。合同生成方面，ContractView.vue 支持选择已发布模板、填写甲乙方、金额、日期、动态字段、知识库参考文本和额外要求，并调用 POST /api/contract/generate。后端由 ContractGenerateService 编排流程，通过 ContractPromptBuilder 组装 Prompt，复用 AiChatService.chatWithPrompt 调用大模型，并将结果保存到 contract_info、contract_field_value、contract_version。

孙涔烁完成轻量版登录闭环与角色菜单控制。后端 AuthController.java 支持 admin / 123456 和 user / 123456 两类 mock 用户，分别返回 ADMIN 和 USER。前端新增 auth.ts，修改 stores/app.ts 使用 Pinia 和 localStorage 保存登录状态，修改 router/index.ts 增加路由守卫，修改 MainLayout.vue 实现退出登录和管理员菜单控制。

张鸿震完成核心业务实体类和 Repository 数据访问层。已落地合同、模板、风险、摘要、润色、用户权限等模块的 entity 和 repository，包括 ContractInfo、ContractFieldValue、ContractVersion、ContractTemplate、RiskAnalysisTask、RiskAnalysisResult、ContractSummary、ContractPolishResult、SysUser 等，并提供按合同编号、状态、模板、创建人、风险等级、复核状态等查询方法。

韦建华完成合同优化前端第一阶段。前端新增 polish.ts，封装 generatePolish() 请求；PolishView.vue 实现输入区和结果区两栏布局，支持粘贴完整合同文本、空文本提示、请求 loading、展示优化结果和清空内容。当前结果仍来自后端占位逻辑，后续将接入真实大模型优化。

第四周结束时，项目已经形成较完整的演示链路：用户登录进入系统，管理员维护模板并发布，业务用户选择模板填写字段，后端调用大模型生成合同草稿，并保存合同主数据、字段值和初始版本快照；同时具备通用 AI 助手和合同优化基础页面。

截至中期检查的整体进度

截至中期检查，项目已完成前后端分离工程搭建，后端采用 Spring Boot 3 + Spring Data JPA + MySQL，前端采用 Vue 3 + Vite + TypeScript + Element Plus + Pinia + Axios。已实现登录与角色区分、AI 助手、模板管理、智能合同生成、合同生成结果落库、合同优化基础输入输出链路。

目前可实际演示的功能包括：管理员/普通用户登录、角色菜单控制、模板增删改查与发布、模板字段配置、选择模板生成合同、调用 Sophnet DeepSeek-V4-Flash 生成合同草稿、保存合同主数据和版本快照、AI 助手弹窗问答、合同优化页面基础交互。

已经建设但尚未完全落地的能力包括：风险智能评估、摘要提取、真实合同润色、版本语义对比、历史记录管理、Prompt 版本管理、模型调用日志、数据集评测、完整权限体系和测试报告。这些模块已有文档、数据库设计或页面入口，部分已有实体表和 Repository，但业务服务和前端闭环仍需继续完善。

下一阶段计划围绕任务书要求继续推进：补齐至少 5 类合同模板，完善风险识别 Prompt 和风险结果展示，实现摘要提取、真实合同优化、版本对比与历史追溯；补充模型调用日志、Prompt 迭代记录和测试数据集；最后进行联调测试、性能优化、文档完善和中后期答辩材料整理。