尧图网页设计 
简介本资源是哈尔滨工程大学《应用软件架构设计》课程的大作业成果——防疫信息管理系统完整文档面向高校计算机、软件工程专业学生及数据库与Web开发初学者聚焦后疫情时代流动人口与常住居民核酸检测数据的规范化、自动化管理问题。文档以Word格式.doc单文件呈现大小5.5MB涵盖需求分析、系统设计含B/S架构、SpringBootMyBatis技术栈、角色权限模型用户/普通管理员/超级管理员、核心功能实现核酸申请、审核、信息汇总查询、数据库优化索引/触发器/视图及ECharts可视化方案并附详细分工、进度安排与参考文献。内容预览显示其结构完整包含用例建模、分层代码说明Controller/Service/DAO、前端页面搭建与动态验证码等实操细节。目前已有173人学习下载可直接用于课程设计复盘、数据库综合实践参考或Java Web项目学习范本。1. 这不是一份“交完就扔”的课程资料而是软件架构能力落地的实操切口哈尔滨工程大学《应用软件架构设计》课程的大作业常被学生当作期末硬任务——查模板、拼代码、赶DDL。但翻看近年实际交付成果会发现真正拉开差距的不是UML图画得有多规范而是能否在有限课时内用真实约束如单机部署、无云资源、Java/Python双栈可选完成一个可运行、可演进、可解释架构决策的系统。它不追求高并发或微服务规模但强制要求体现分层隔离、接口契约、依赖倒置等核心原则不考背诵设计模式名称但会在评审中追问“为什么这里用策略模式而不是状态模式”“数据库访问层为何不直接暴露JDBC连接”。适合计算机/软件工程专业大三及以上学生——你已写过Spring Boot或Django项目现在需要把“能跑”升级为“为什么这样跑”。这门课的资料价值不在答案本身而在于它提供了一套从需求模糊到架构具象的推演路径如何把“做一个校园二手书交易平台”拆解为领域边界、如何用C4模型替代纯类图表达协作关系、如何用轻量级契约测试验证模块间协议。后续做毕业设计、实习面试中的系统设计题、甚至参与企业内部中台建设这套思维肌肉记忆比任何PPT模板都管用。2. 用分层架构领域驱动思想搭建最小可行系统骨架2.1 为什么必须放弃“Controller-Service-DAO”三层硬编码哈尔滨工程大学该课程近年明确要求避免传统MVC的扁平化分层。典型反例是所有业务逻辑塞进Service类DAO直接返回ListMapString, ObjectController里做JSON序列化和字段校验。这种结构导致三个致命问题领域概念消失用户、订单、图书等实体被降维成DTO无法承载业务规则如“二手书价格不能低于原价30%”技术细节污染Service方法名出现updateBookStatusByRedisKey()暴露了缓存实现而非业务意图测试成本爆炸修改一个价格计算逻辑需启动整个Web容器数据库才能验证。提示课程评分细则中“架构合理性”占比40%其中“是否识别出核心领域对象”和“是否将技术实现与业务逻辑解耦”是关键扣分点。2.2 用DDD四层架构重构基础结构以Java为例按课程推荐实践采用精简版DDD分层跳过复杂聚合根/仓储模式聚焦可教学性2.2.1 层级职责与包结构定义com.hrbust.arch.bookstore // 根包 ├── application // 应用层协调用例不包含业务逻辑 │ ├── dto // 请求/响应DTO仅数据载体 │ └── service // 用例服务如BookOrderService ├── domain // 领域层核心业务规则与实体 │ ├── model // 聚合根Book、User、值对象Money、ISBN │ ├── repository // 仓库接口BookRepository定义数据操作契约 │ └── service // 领域服务PriceCalculationService处理跨实体逻辑 ├── infrastructure // 基础设施层具体实现MyBatis、Redis、文件存储 │ ├── persistence // MyBatis Mapper 实体映射 │ └── cache // Redis缓存实现实现domain.repository.BookRepository └── interfaceweb // 接口层Spring MVC Controller 参数校验2.2.2 关键代码片段领域层价格规则强制落地// domain/model/Book.java public class Book { private final String isbn; private final String title; private Money originalPrice; // 值对象封装金额运算 private Money currentPrice; public void setPrice(Money newPrice) { if (newPrice.isLessThan(originalPrice.multiply(0.3))) { throw new BusinessRuleViolationException(二手书售价不得低于原价30%); } this.currentPrice newPrice; } } // domain/service/PriceCalculationService.java public class PriceCalculationService { // 业务规则根据新书折扣率、使用年限自动计算建议售价 public Money calculateSuggestedPrice(Book book, int yearsUsed) { BigDecimal discountRate yearsUsed 5 ? BigDecimal.valueOf(0.7) : BigDecimal.valueOf(0.5); return book.getOriginalPrice().multiply(discountRate); } }参数说明Money是自定义值对象非BigDecimal裸用封装货币精度、四舍五入策略避免double精度陷阱setPrice()方法内嵌校验确保任何调用方都无法绕过业务规则calculateSuggestedPrice()位于领域服务而非Controller体现“业务逻辑归属领域层”原则。2.2.3 应用层用例编排示例// application/service/BookOrderService.java Transactional public Order createOrder(CreateOrderRequest request) { // 1. 从基础设施层获取领域对象 Book book bookRepository.findById(request.getBookId()) .orElseThrow(() - new BookNotFoundException()); // 2. 调用领域服务计算价格 Money finalPrice priceCalculationService.calculateSuggestedPrice(book, request.getYearsUsed()); // 3. 创建订单聚合根含业务规则校验 Order order Order.create(book, finalPrice, request.getUser()); // 4. 持久化调用基础设施层实现 orderRepository.save(order); return order; }逻辑说明应用层只做“协调”不处理if-else业务分支Order.create()是静态工厂方法在创建时即执行订单有效性校验如库存是否充足Transactional标注在应用层而非DAO层符合事务边界定义规范。3. 用C4模型替代UML类图让架构图真正讲清系统故事3.1 为什么课程要求禁用传统UML类图学生提交的UML图常见问题类图堆砌上百个属性方法却无法回答“用户下单时数据流经哪些组件”组件图用虚线箭头标“依赖”但未说明依赖的是API契约还是具体实现如MySQL驱动部署图画了NginxTomcatMySQL但未标注各节点承担的逻辑角色如“API网关”“领域服务集群”。课程强调架构图是沟通工具不是绘图比赛。C4模型通过四层抽象System Context → Containers → Components → Code强制剥离技术细节聚焦“谁在用、系统做什么、模块怎么协作”。3.2 用PlantUML生成可维护的C4图附哈尔滨工程大学常用模板3.2.1 System Context图定位系统在校园IT生态中的位置startuml title 校园二手书平台 - 系统上下文图 skinparam defaultFontSize 12 Person(Student, 学生) Person(Admin, 管理员) System(BookStoreSystem, 二手书交易平台, 提供图书发布、搜索、交易功能) System_Ext(UniversityAuth, 校内统一身份认证系统, 提供OAuth2登录) System_Ext(EmailService, 校园邮件服务, 发送订单通知) Student -- BookStoreSystem : 浏览/发布/下单 Admin -- BookStoreSystem : 审核图书/管理用户 BookStoreSystem -- UniversityAuth : 认证用户身份 BookStoreSystem -- EmailService : 发送交易通知 enduml参数说明Person表示外部用户角色非具体人名System_Ext标识外部依赖系统箭头标注交互目的非技术协议所有文字用中文符合哈工程课程报告规范。3.2.2 Container图明确进程级边界与技术选型startuml title 校园二手书平台 - 容器图 [Web Application] as webapp Spring Boot [Database] as db MySQL 8.0 [Cache] as redis Redis 7 webapp -- db : 读写图书/订单数据 webapp -- redis : 缓存热门图书列表 webapp -- UniversityAuth : HTTP API调用 webapp -- EmailService : SMTP协议发送邮件 enduml关键约束每个Container对应一个独立进程如Spring Boot Jar、MySQL实例技术栈标注具体版本课程要求体现技术选型依据如“选用Redis 7因支持Stream消息队列”箭头标注逻辑用途非网络协议避免出现“HTTP”“JDBC”等底层术语。3.2.3 Component图揭示模块协作契约startuml title 图书管理组件 - 组件图 [Web Application] as webapp package 领域层 { [BookDomainService] as bookDomain [BookRepository] as bookRepo } package 基础设施层 { [MyBatisBookRepository] as mybatisImpl [RedisBookCache] as redisCache } bookDomain -- bookRepo : 查询图书详情 mybatisImpl -- db : SQL执行 redisCache -- redis : 缓存读写 bookDomain -- redisCache : 更新缓存 bookRepo .. mybatisImpl : 实现接口 enduml逻辑说明bookDomain -- bookRepo表示领域服务调用仓库接口体现依赖倒置原则bookRepo .. mybatisImpl用虚线箭头表示“实现”强调接口与实现分离所有组件名使用业务语义如BookDomainService禁用BookServiceImpl等技术后缀。4. 用契约测试验证模块边界避免“联调时才发现接口不匹配”4.1 为什么单元测试不足以保障架构健康学生常犯错误为BookService写100%覆盖率单元测试但当BookRepository接口变更如findByIsbn()改为findByIsbnAndStatus()时所有调用方测试仍通过——因为Mock对象被手动更新了。这导致架构层间契约沦为口头约定模块独立演进能力丧失改一个模块必同步改所有依赖方课程答辩时被追问“如果明天把MySQL换成MongoDB哪些代码要改”时无法回答。4.2 基于Pact的消费者驱动契约测试实战4.2.1 消费者端Web Application定义期望契约// test/java/.../BookConsumerTest.java Test public void shouldFetchBookByIsbn() { PactBuilder pactBuilder new PactBuilder(); pactBuilder .given(图书存在) .uponReceiving(查询ISBN为978-7-302-12345-6的图书) .path(/api/books/978-7-302-12345-6) .method(GET) .willRespondWith() .status(200) .body({\isbn\:\978-7-302-12345-6\,\title\:\软件架构设计\,\price\:45.50}) .toFile(pacts/book-service-consumer.json); // 生成契约文件 }参数说明given()描述前置状态非数据库状态而是业务场景body()中JSON字段名必须与领域模型一致如price而非current_price确保契约反映业务语义生成的book-service-consumer.json将被提交至Git仓库作为供应商开发依据。4.2.2 供应商端Infrastructure层验证契约实现// test/java/.../BookProviderVerificationTest.java Test public void verifyBookProvider() { PactRunner.runConsumerContractTest( pacts/book-service-consumer.json, // 消费者提供的契约 new BookController(), // 被测控制器 /api/books/{isbn} // 路径变量映射 ); }执行逻辑Pact框架自动启动嵌入式HTTP服务器模拟消费者请求调用BookController真实方法验证返回状态码、响应体结构、字段类型若BookController返回{isbn:...,title:...,price:45}整数则契约验证失败因契约要求price为浮点数。4.2.3 CI流水线集成GitLab CI示例# .gitlab-ci.yml stages: - test-contract contract-test: stage: test-contract script: - ./gradlew pactVerify # 验证当前代码是否满足所有消费者契约 artifacts: paths: - build/reports/pact/ # 生成可视化报告关键收益每次Push自动检查架构层间契约一致性报告中明确列出“缺失字段”“类型不匹配”等具体问题无需人工排查符合课程对“自动化验证架构约束”的评分要求。5. 用架构决策记录ADR固化关键选择让评审老师看到你的思考过程5.1 ADR不是文档负担而是架构演进的导航日志哈尔滨工程大学课程答辩中教师高频提问“为什么选MySQL不选PostgreSQL”“为什么用Redis缓存图书列表而非Elasticsearch”——标准答案“因为简单”会被直接扣分。ADR强制要求记录决策背景当时面临的具体约束如“单机部署无DBA支持”选项分析对比项需量化如MySQL社区版免费 vs PostgreSQL需学习新SQL方言最终选择明确结论及可验证的后果如“选用MySQL导致无法使用JSONB全文检索后续用LIKE模糊查询替代”。5.2 哈工程推荐的ADR模板与填写要点字段填写要求示例二手书平台标题用动词开头描述决策动作选择MySQL作为主数据库状态proposed/accepted/deprecatedaccepted背景具体问题影响范围需持久化图书、用户、订单数据团队成员熟悉MySQL运维且课程要求单机部署决策明确技术选型版本MySQL 8.0.33启用InnoDB引擎后果必须包含正反两面✅ 支持事务ACID满足订单一致性要求br❌ 不支持开箱即用的向量相似搜索未来扩展AI推荐需额外组件相关ADR引用其他决策编号参见ADR-003采用RESTful API设计风格5.3 在IDE中快速生成ADR的实用技巧IntelliJ IDEA插件配置安装ADR Generator插件右键包→New → Architecture Decision Record模板自动填充插件预置哈工程格式生成时自动添加# ADR-007编号及日期Git提交钩子在.git/hooks/pre-commit中加入检查if git status --porcelain | grep -q adr/.*\.md; then echo ADR文件已更新正在验证格式... awk /^## Decision$/ {in_decision1; next} /^## Consequences$/ {in_decision0} in_decision /^[a-z]/ {print 错误Decision字段需用动词开头; exit 1} adr/*.md fi效果提交ADR时自动校验“Decision”段首字母小写违反规范则阻断提交确保格式统一。注意课程明确要求每份大作业至少包含3份ADR数据库选型、缓存策略、API设计风格且需在答辩PPT中展示决策树图——用Mermaid语法绘制选项分支标注每个分支的权重依据如“MySQL权重0.7团队熟悉度0.4 社区支持0.3”。本文还有配套的精品资源点击获取 软件架构实操：DDD分层+C4建模+契约测试落地指南
简介本资源是哈尔滨工程大学《应用软件架构设计》课程的大作业成果——防疫信息管理系统完整文档面向高校计算机、软件工程专业学生及数据库与Web开发初学者聚焦后疫情时代流动人口与常住居民核酸检测数据的规范化、自动化管理问题。文档以Word格式.doc单文件呈现大小5.5MB涵盖需求分析、系统设计含B/S架构、SpringBootMyBatis技术栈、角色权限模型用户/普通管理员/超级管理员、核心功能实现核酸申请、审核、信息汇总查询、数据库优化索引/触发器/视图及ECharts可视化方案并附详细分工、进度安排与参考文献。内容预览显示其结构完整包含用例建模、分层代码说明Controller/Service/DAO、前端页面搭建与动态验证码等实操细节。目前已有173人学习下载可直接用于课程设计复盘、数据库综合实践参考或Java Web项目学习范本。1. 这不是一份“交完就扔”的课程资料而是软件架构能力落地的实操切口哈尔滨工程大学《应用软件架构设计》课程的大作业常被学生当作期末硬任务——查模板、拼代码、赶DDL。但翻看近年实际交付成果会发现真正拉开差距的不是UML图画得有多规范而是能否在有限课时内用真实约束如单机部署、无云资源、Java/Python双栈可选完成一个可运行、可演进、可解释架构决策的系统。它不追求高并发或微服务规模但强制要求体现分层隔离、接口契约、依赖倒置等核心原则不考背诵设计模式名称但会在评审中追问“为什么这里用策略模式而不是状态模式”“数据库访问层为何不直接暴露JDBC连接”。适合计算机/软件工程专业大三及以上学生——你已写过Spring Boot或Django项目现在需要把“能跑”升级为“为什么这样跑”。这门课的资料价值不在答案本身而在于它提供了一套从需求模糊到架构具象的推演路径如何把“做一个校园二手书交易平台”拆解为领域边界、如何用C4模型替代纯类图表达协作关系、如何用轻量级契约测试验证模块间协议。后续做毕业设计、实习面试中的系统设计题、甚至参与企业内部中台建设这套思维肌肉记忆比任何PPT模板都管用。2. 用分层架构领域驱动思想搭建最小可行系统骨架2.1 为什么必须放弃“Controller-Service-DAO”三层硬编码哈尔滨工程大学该课程近年明确要求避免传统MVC的扁平化分层。典型反例是所有业务逻辑塞进Service类DAO直接返回ListMapString, ObjectController里做JSON序列化和字段校验。这种结构导致三个致命问题领域概念消失用户、订单、图书等实体被降维成DTO无法承载业务规则如“二手书价格不能低于原价30%”技术细节污染Service方法名出现updateBookStatusByRedisKey()暴露了缓存实现而非业务意图测试成本爆炸修改一个价格计算逻辑需启动整个Web容器数据库才能验证。提示课程评分细则中“架构合理性”占比40%其中“是否识别出核心领域对象”和“是否将技术实现与业务逻辑解耦”是关键扣分点。2.2 用DDD四层架构重构基础结构以Java为例按课程推荐实践采用精简版DDD分层跳过复杂聚合根/仓储模式聚焦可教学性2.2.1 层级职责与包结构定义com.hrbust.arch.bookstore // 根包 ├── application // 应用层协调用例不包含业务逻辑 │ ├── dto // 请求/响应DTO仅数据载体 │ └── service // 用例服务如BookOrderService ├── domain // 领域层核心业务规则与实体 │ ├── model // 聚合根Book、User、值对象Money、ISBN │ ├── repository // 仓库接口BookRepository定义数据操作契约 │ └── service // 领域服务PriceCalculationService处理跨实体逻辑 ├── infrastructure // 基础设施层具体实现MyBatis、Redis、文件存储 │ ├── persistence // MyBatis Mapper 实体映射 │ └── cache // Redis缓存实现实现domain.repository.BookRepository └── interfaceweb // 接口层Spring MVC Controller 参数校验2.2.2 关键代码片段领域层价格规则强制落地// domain/model/Book.java public class Book { private final String isbn; private final String title; private Money originalPrice; // 值对象封装金额运算 private Money currentPrice; public void setPrice(Money newPrice) { if (newPrice.isLessThan(originalPrice.multiply(0.3))) { throw new BusinessRuleViolationException(二手书售价不得低于原价30%); } this.currentPrice newPrice; } } // domain/service/PriceCalculationService.java public class PriceCalculationService { // 业务规则根据新书折扣率、使用年限自动计算建议售价 public Money calculateSuggestedPrice(Book book, int yearsUsed) { BigDecimal discountRate yearsUsed 5 ? BigDecimal.valueOf(0.7) : BigDecimal.valueOf(0.5); return book.getOriginalPrice().multiply(discountRate); } }参数说明Money是自定义值对象非BigDecimal裸用封装货币精度、四舍五入策略避免double精度陷阱setPrice()方法内嵌校验确保任何调用方都无法绕过业务规则calculateSuggestedPrice()位于领域服务而非Controller体现“业务逻辑归属领域层”原则。2.2.3 应用层用例编排示例// application/service/BookOrderService.java Transactional public Order createOrder(CreateOrderRequest request) { // 1. 从基础设施层获取领域对象 Book book bookRepository.findById(request.getBookId()) .orElseThrow(() - new BookNotFoundException()); // 2. 调用领域服务计算价格 Money finalPrice priceCalculationService.calculateSuggestedPrice(book, request.getYearsUsed()); // 3. 创建订单聚合根含业务规则校验 Order order Order.create(book, finalPrice, request.getUser()); // 4. 持久化调用基础设施层实现 orderRepository.save(order); return order; }逻辑说明应用层只做“协调”不处理if-else业务分支Order.create()是静态工厂方法在创建时即执行订单有效性校验如库存是否充足Transactional标注在应用层而非DAO层符合事务边界定义规范。3. 用C4模型替代UML类图让架构图真正讲清系统故事3.1 为什么课程要求禁用传统UML类图学生提交的UML图常见问题类图堆砌上百个属性方法却无法回答“用户下单时数据流经哪些组件”组件图用虚线箭头标“依赖”但未说明依赖的是API契约还是具体实现如MySQL驱动部署图画了NginxTomcatMySQL但未标注各节点承担的逻辑角色如“API网关”“领域服务集群”。课程强调架构图是沟通工具不是绘图比赛。C4模型通过四层抽象System Context → Containers → Components → Code强制剥离技术细节聚焦“谁在用、系统做什么、模块怎么协作”。3.2 用PlantUML生成可维护的C4图附哈尔滨工程大学常用模板3.2.1 System Context图定位系统在校园IT生态中的位置startuml title 校园二手书平台 - 系统上下文图 skinparam defaultFontSize 12 Person(Student, 学生) Person(Admin, 管理员) System(BookStoreSystem, 二手书交易平台, 提供图书发布、搜索、交易功能) System_Ext(UniversityAuth, 校内统一身份认证系统, 提供OAuth2登录) System_Ext(EmailService, 校园邮件服务, 发送订单通知) Student -- BookStoreSystem : 浏览/发布/下单 Admin -- BookStoreSystem : 审核图书/管理用户 BookStoreSystem -- UniversityAuth : 认证用户身份 BookStoreSystem -- EmailService : 发送交易通知 enduml参数说明Person表示外部用户角色非具体人名System_Ext标识外部依赖系统箭头标注交互目的非技术协议所有文字用中文符合哈工程课程报告规范。3.2.2 Container图明确进程级边界与技术选型startuml title 校园二手书平台 - 容器图 [Web Application] as webapp Spring Boot [Database] as db MySQL 8.0 [Cache] as redis Redis 7 webapp -- db : 读写图书/订单数据 webapp -- redis : 缓存热门图书列表 webapp -- UniversityAuth : HTTP API调用 webapp -- EmailService : SMTP协议发送邮件 enduml关键约束每个Container对应一个独立进程如Spring Boot Jar、MySQL实例技术栈标注具体版本课程要求体现技术选型依据如“选用Redis 7因支持Stream消息队列”箭头标注逻辑用途非网络协议避免出现“HTTP”“JDBC”等底层术语。3.2.3 Component图揭示模块协作契约startuml title 图书管理组件 - 组件图 [Web Application] as webapp package 领域层 { [BookDomainService] as bookDomain [BookRepository] as bookRepo } package 基础设施层 { [MyBatisBookRepository] as mybatisImpl [RedisBookCache] as redisCache } bookDomain -- bookRepo : 查询图书详情 mybatisImpl -- db : SQL执行 redisCache -- redis : 缓存读写 bookDomain -- redisCache : 更新缓存 bookRepo .. mybatisImpl : 实现接口 enduml逻辑说明bookDomain -- bookRepo表示领域服务调用仓库接口体现依赖倒置原则bookRepo .. mybatisImpl用虚线箭头表示“实现”强调接口与实现分离所有组件名使用业务语义如BookDomainService禁用BookServiceImpl等技术后缀。4. 用契约测试验证模块边界避免“联调时才发现接口不匹配”4.1 为什么单元测试不足以保障架构健康学生常犯错误为BookService写100%覆盖率单元测试但当BookRepository接口变更如findByIsbn()改为findByIsbnAndStatus()时所有调用方测试仍通过——因为Mock对象被手动更新了。这导致架构层间契约沦为口头约定模块独立演进能力丧失改一个模块必同步改所有依赖方课程答辩时被追问“如果明天把MySQL换成MongoDB哪些代码要改”时无法回答。4.2 基于Pact的消费者驱动契约测试实战4.2.1 消费者端Web Application定义期望契约// test/java/.../BookConsumerTest.java Test public void shouldFetchBookByIsbn() { PactBuilder pactBuilder new PactBuilder(); pactBuilder .given(图书存在) .uponReceiving(查询ISBN为978-7-302-12345-6的图书) .path(/api/books/978-7-302-12345-6) .method(GET) .willRespondWith() .status(200) .body({\isbn\:\978-7-302-12345-6\,\title\:\软件架构设计\,\price\:45.50}) .toFile(pacts/book-service-consumer.json); // 生成契约文件 }参数说明given()描述前置状态非数据库状态而是业务场景body()中JSON字段名必须与领域模型一致如price而非current_price确保契约反映业务语义生成的book-service-consumer.json将被提交至Git仓库作为供应商开发依据。4.2.2 供应商端Infrastructure层验证契约实现// test/java/.../BookProviderVerificationTest.java Test public void verifyBookProvider() { PactRunner.runConsumerContractTest( pacts/book-service-consumer.json, // 消费者提供的契约 new BookController(), // 被测控制器 /api/books/{isbn} // 路径变量映射 ); }执行逻辑Pact框架自动启动嵌入式HTTP服务器模拟消费者请求调用BookController真实方法验证返回状态码、响应体结构、字段类型若BookController返回{isbn:...,title:...,price:45}整数则契约验证失败因契约要求price为浮点数。4.2.3 CI流水线集成GitLab CI示例# .gitlab-ci.yml stages: - test-contract contract-test: stage: test-contract script: - ./gradlew pactVerify # 验证当前代码是否满足所有消费者契约 artifacts: paths: - build/reports/pact/ # 生成可视化报告关键收益每次Push自动检查架构层间契约一致性报告中明确列出“缺失字段”“类型不匹配”等具体问题无需人工排查符合课程对“自动化验证架构约束”的评分要求。5. 用架构决策记录ADR固化关键选择让评审老师看到你的思考过程5.1 ADR不是文档负担而是架构演进的导航日志哈尔滨工程大学课程答辩中教师高频提问“为什么选MySQL不选PostgreSQL”“为什么用Redis缓存图书列表而非Elasticsearch”——标准答案“因为简单”会被直接扣分。ADR强制要求记录决策背景当时面临的具体约束如“单机部署无DBA支持”选项分析对比项需量化如MySQL社区版免费 vs PostgreSQL需学习新SQL方言最终选择明确结论及可验证的后果如“选用MySQL导致无法使用JSONB全文检索后续用LIKE模糊查询替代”。5.2 哈工程推荐的ADR模板与填写要点字段填写要求示例二手书平台标题用动词开头描述决策动作选择MySQL作为主数据库状态proposed/accepted/deprecatedaccepted背景具体问题影响范围需持久化图书、用户、订单数据团队成员熟悉MySQL运维且课程要求单机部署决策明确技术选型版本MySQL 8.0.33启用InnoDB引擎后果必须包含正反两面✅ 支持事务ACID满足订单一致性要求br❌ 不支持开箱即用的向量相似搜索未来扩展AI推荐需额外组件相关ADR引用其他决策编号参见ADR-003采用RESTful API设计风格5.3 在IDE中快速生成ADR的实用技巧IntelliJ IDEA插件配置安装ADR Generator插件右键包→New → Architecture Decision Record模板自动填充插件预置哈工程格式生成时自动添加# ADR-007编号及日期Git提交钩子在.git/hooks/pre-commit中加入检查if git status --porcelain | grep -q adr/.*\.md; then echo ADR文件已更新正在验证格式... awk /^## Decision$/ {in_decision1; next} /^## Consequences$/ {in_decision0} in_decision /^[a-z]/ {print 错误Decision字段需用动词开头; exit 1} adr/*.md fi效果提交ADR时自动校验“Decision”段首字母小写违反规范则阻断提交确保格式统一。注意课程明确要求每份大作业至少包含3份ADR数据库选型、缓存策略、API设计风格且需在答辩PPT中展示决策树图——用Mermaid语法绘制选项分支标注每个分支的权重依据如“MySQL权重0.7团队熟悉度0.4 社区支持0.3”。本文还有配套的精品资源点击获取