2026山东大学软件学院创新项目实训博客(一)

本周工作内容是生成部分开发文档文档内容如下1. 文档目标本文档用于指导项目团队基于Spring Boot Vue AI完成“智契通”系统研发覆盖开发规范、模块划分、接口规划、测试方案、实施计划与交付物设计。2. 项目开发目标2.1 研发范围智能合同生成风险识别与修改建议关键条款摘要合同润色优化多版本对比与历史追溯用户权限与系统管理2.2 验收指标映射支持至少 5 类合同模板合同生成完整率达到 100%风险识别覆盖 3 大类、15 小类风险识别召回率不低于 85%误报率不高于 15%摘要覆盖率达到 95% 以上单合同支持至少 10 个历史版本单元测试用例不少于 50 个3. 开发环境设计3.1 开发工具JDK 17Maven 3.9Node.js 20MySQL 8.0RedisIntelliJ IDEAVS CodeApifoxGit GitHub3.2 环境划分本地开发环境测试环境演示环境生产/答辩环境4. 代码工程结构建议4.1 后端工程结构smart-contract-platform/ ├─ backend/ │ ├─ contract-admin │ ├─ contract-common │ ├─ contract-system │ ├─ contract-template │ ├─ contract-core │ ├─ contract-ai │ ├─ contract-risk │ ├─ contract-summary │ ├─ contract-compare │ └─ sql └─ frontend/ ├─ src/ ├─ public/ └─ package.json4.2 前端目录建议src/ ├─ api/ ├─ assets/ ├─ components/ ├─ layouts/ ├─ router/ ├─ stores/ ├─ utils/ ├─ views/ │ ├─ login/ │ ├─ dashboard/ │ ├─ template/ │ ├─ contract/ │ ├─ risk/ │ ├─ summary/ │ ├─ compare/ │ └─ system/ └─ types/5. 后端开发规范5.1 分层规范controller接口层只负责参数接收与结果返回service业务层负责业务编排manager复杂聚合逻辑与跨模块协调repository/mapper数据访问层entity数据库实体dto/vo输入输出对象5.2 接口规范统一前缀/api统一返回结构{code:200,message:success,data:{}}分页接口统一使用pageNum、pageSize列表查询尽量支持状态、分类、创建人、时间区间筛选5.3 异常处理规范使用全局异常处理器业务异常与系统异常分离AI调用失败需返回明确错误码与可读提示5.4 日志规范使用Slf4j Logback关键业务记录 info 日志模型失败、任务失败记录 error 日志敏感内容禁止全量明文打印6. 前端开发规范6.1 页面开发规范页面分为查询区、结果区、操作区合同编辑页面采用左右布局左侧表单右侧预览风险审查页面采用原文高亮 风险列表联动对比页面采用双栏版本对照6.2 状态管理规范用户信息使用Pinia字典数据、模板缓存可使用本地缓存 Pinia长任务状态通过轮询或 WebSocket 更新6.3 组件规范公共表格组件公共弹窗组件动态表单组件风险标注组件合同文本对比组件7. AI开发设计7.1 AI服务封装规范统一封装模型调用接口请求体包含任务类型、模型名称、Prompt版本返回体包含文本结果、结构化结果、tokens、耗时7.2 Prompt管理规范每个任务独立维护 Prompt至少保留 5 个版本迭代记录Prompt必须记录适用场景、输入字段、输出格式7.3 AI结果校验规范合同生成结果需要结构完整性校验风险识别结果需校验分类、置信度、建议文本摘要结果需校验长度与关键要素覆盖率语义对比结果需校验差异类型是否合法