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

2026.4.15-2026.4.201. 工作内容本周依据项目总体架构设计、数据库设计、开发文档设计、项目流程图设计、接口文档使用Codex完成了项目骨架搭建并对AI生成代码进行了分析和拆解便于其他小组成员快速理解项目骨架进行其他功能的开发2. AI提示词根据该文件夹目录下的五个文档项目总体架构设计、数据库设计、开发文档设计、项目流程图设计、接口文档生成项目框架使用SpringBootVue3开发技术3. AI生成过程4. 项目骨架分析项目整体采用前后端分离架构主要分为backend和frontend两大部分。后端负责业务接口、数据处理和系统配置前端负责页面展示、交互逻辑和接口调用。通过对 AI 生成结果的分析可以看出这次生成的不只是一个简单的空项目而是已经具备了比较清晰的工程化骨架。4.1 后端骨架分析后端部分位于backend目录下采用的是Spring Boot Maven的开发方式并且使用了父子模块结构进行管理。1backend 根目录backend目录下主要包含以下内容pom.xml后端父工程配置文件用于统一管理依赖版本和模块结构。contract-admin/核心业务子模块也就是当前项目后端真正运行的服务模块。sql/数据库脚本目录用于存放初始化建表语句。这种结构的好处是后续如果项目继续扩展还可以在父工程下面继续新增其他子模块整体扩展性比较好。2contract-admin 模块contract-admin是当前后端的核心模块里面包含了项目启动类、业务代码和配置文件。在src/main/java/com/zhiqitong/contract/admin/目录下又可以继续分成两部分common公共模块modules业务模块3common 公共模块common目录主要用于存放项目中可复用的通用代码。目前生成的内容包括api/ApiResponse.java统一接口返回格式方便前后端交互时保持数据结构一致。config/CorsConfig.java跨域配置类用来解决前后端分离开发中常见的跨域访问问题。虽然目前公共层内容还不多但它已经为后续封装统一异常处理、统一响应码、拦截器等功能预留了位置。4modules 业务模块modules目录是整个后端骨架中最核心的一部分它按照业务功能进行拆分。当前已经生成的模块有auth登录认证模块contract合同管理模块template模板管理模块risk风险审查模块summary摘要生成模块compare合同对比模块polish合同润色模块user用户管理模块version版本管理模块从这里可以看出AI 已经根据前期文档内容把系统主要业务方向基本拆解出来了。其中每个模块下又进一步包含了不同职责的类例如controller负责接收前端请求、返回接口数据dto用于接收前端传入的数据vo用于返回给前端展示的数据这种分层方式说明生成结果已经初步具备了规范化开发的思路不再是把所有代码都堆在一起而是按照职责进行了划分。5resources 配置目录在src/main/resources目录下目前主要有application.yml项目配置文件当前配置中已经设置了服务端口和 Swagger 文档路径说明后端骨架已经考虑到了接口调试和后续联调的问题。6sql 数据库脚本在backend/sql/init.sql中已经生成了几个基础数据表例如sys_user用户表contract_template合同模板表contract_info合同信息表contract_version合同版本表这说明项目骨架并不只是停留在代码目录层面而是已经把数据库基础结构同步搭建出来了为后续功能开发节省了不少时间。4.2 前端骨架分析前端部分位于frontend目录下使用的是Vue 3 Vite TypeScript技术栈。整体结构比较清晰符合当前主流前端项目的组织方式。1frontend 根目录前端根目录下主要包括package.json项目依赖和脚本配置文件vite.config.tsVite 构建配置文件tsconfig.jsonTypeScript 配置文件src/前端核心源码目录从依赖配置来看项目中已经集成了vuevue-routerpiniaaxioselement-plus这说明前端基础开发环境已经搭建完成后续可以直接在这个基础上继续开发页面和功能。2src 核心目录前端的核心代码集中在src目录下主要可以分为以下几个部分api/接口请求封装layouts/页面布局router/路由配置stores/状态管理views/业务页面main.ts项目入口文件App.vue根组件styles.css全局样式文件这种目录划分非常典型也比较适合中后台项目开发。3api 接口层src/api/http.ts主要用于统一封装请求逻辑。这样做的好处是后续所有页面在调用后端接口时都可以复用同一套请求配置减少重复代码。4layouts 布局层src/layouts/MainLayout.vue是后台系统的主布局文件通常用于统一管理头部、侧边栏、菜单和内容区域。对于中后台管理系统来说这一层非常重要它决定了整个页面的整体结构。5router 路由层src/router/index.ts中已经配置了项目的主要路由包括登录页首页仪表盘模板管理页合同管理页风险审查页摘要生成页合同比对页系统管理页这说明前端骨架不仅生成了目录还已经把主要业务页面入口都准备好了。6stores 状态管理层src/stores/app.ts是全局状态管理模块使用的是Pinia。这部分虽然目前代码可能还比较简单但它为后续共享用户信息、菜单状态、系统配置等内容提供了基础支持。7views 页面层views目录下按功能拆分出了多个页面目录例如logindashboardtemplatecontractrisksummarycomparesystem每一个目录下都对应一个页面组件这样的组织方式使页面结构更加清晰也更方便后续逐个模块进行功能完善。4.3 项目骨架的整体特点从本次 AI 生成的结果来看这个项目骨架有几个比较明显的特点前后端分层清晰整体目录结构比较规范。后端已经按照业务功能完成了初步模块拆分具有一定的扩展性。前端具备完整的页面结构、路由结构和基础开发环境。数据库脚本、接口骨架和页面骨架是同步生成的说明 AI 在生成时能够结合多份文档信息进行整体组织。当前生成的内容更偏向“项目基础框架”适合作为后续详细开发的起点。4.4 小结整体来看这次 AI 生成的项目骨架完成度还是比较高的。它不仅搭建了前后端项目的基本目录也提前划分了主要业务模块并生成了数据库初始化脚本和页面入口。虽然很多具体业务逻辑还需要后续继续补充但作为项目初期的骨架来说已经能够较好地支撑后续开发工作。通过这一步我也更加直观地感受到AI 在项目初期的框架搭建、目录设计和基础代码生成方面确实能够显著提升开发效率。不过AI 生成的代码仍然需要结合项目实际需求进行分析、调整和优化才能真正满足后续开发使用。5. 项目效果展示