# 养老院管理系统 - 工程架构详解 ## 一、项目整体架构图 ``` ┌─────────────────────────────────────────────────────────────────────┐ │ 前端应用层 │ │ ┌──────────────┬──────────────┬──────────────┬──────────────┐ │ │ │ Vue3后台 │ Vue2后台 │ Vben后台 │ UniApp移动 │ │ │ └──────────────┴──────────────┴──────────────┴──────────────┘ │ └────────────────────────────┬────────────────────────────────────────┘ │ HTTP/REST API ┌────────────────────────────────────────────────────────────────────┐ │ API网关 / 负载均衡 │ │ (Nginx / Spring Cloud) │ └────────────────────────────┬────────────────────────────────────────┘ │ ┌────────────────────────────────────────────────────────────────────┐ │ Spring Boot 应用层 │ │ ┌──────────────────────────────────────────────────────────────┐ │ │ │ yudao-server (主应用) │ │ │ │ ┌────────────────────────────────────────────────────────┐ │ │ │ │ │ Controller 层（控制器） │ │ │ │ │ │ ┌──────────┬──────────┬──────────┬──────────────┐ │ │ │ │ │ │ │Expense │Elderly │Contract │DailyExpenses│ │ │ │ │ │ │ │Controller│Controller│Controller│Controller │ │ │ │ │ │ │ └──────────┴──────────┴──────────┴──────────────┘ │ │ │ │ │ └────────────────────────────────────────────────────────┘ │ │ │ │ ↓ │ │ │ │ ┌────────────────────────────────────────────────────────┐ │ │ │ │ │ Service 层（业务逻辑） │ │ │ │ │ │ ┌──────────┬──────────┬──────────┬──────────────┐ │ │ │ │ │ │ │Expense │Elderly │Contract │DailyExpenses│ │ │ │ │ │ │ │Service │Service │Service │Service │ │ │ │ │ │ │ └──────────┴──────────┴──────────┴──────────────┘ │ │ │ │ │ └────────────────────────────────────────────────────────┘ │ │ │ │ ↓ │ │ │ │ ┌────────────────────────────────────────────────────────┐ │ │ │ │ │ Mapper 层（数据访问） │ │ │ │ │ │ ┌──────────┬──────────┬──────────┬──────────────┐ │ │ │ │ │ │ │Expense │Elderly │Contract │DailyExpenses│ │ │ │ │ │ │ │Mapper │Mapper │Mapper │Mapper │ │ │ │ │ │ │ └──────────┴──────────┴──────────┴──────────────┘ │ │ │ │ │ └────────────────────────────────────────────────────────┘ │ │ │ └──────────────────────────────────────────────────────────────┘ │ │ │ │ ┌──────────────────────────────────────────────────────────────┐ │ │ │ 框架层（yudao-framework） │ │ │ │ ┌─────────────┬─────────────┬─────────────┬────────────┐ │ │ │ │ │ Security │ MyBatis │ Redis │ Excel │ │ │ │ │ │ 权限认证 │ ORM增强 │ 缓存 │ 导入导出 │ │ │ │ │ └─────────────┴─────────────┴─────────────┴────────────┘ │ │ │ │ ┌─────────────┬─────────────┬─────────────┬────────────┐ │ │ │ │ │ Tenant │ Job │ MQ │ Monitor │ │ │ │ │ │ 多租户 │ 定时任务 │ 消息队列 │ 监控 │ │ │ │ │ └─────────────┴─────────────┴─────────────┴────────────┘ │ │ │ └──────────────────────────────────────────────────────────────┘ │ └────────────────────────────┬────────────────────────────────────────┘ │ ┌────────────────────────────────────────────────────────────────────┐ │ 数据持久化层 │ │ ┌──────────────┬──────────────┬──────────────┬──────────────┐ │ │ │ MySQL │ Redis │ Elasticsearch │ 其他DB │ │ │ │ 关系型数据库 │ 缓存存储 │ 搜索引擎 │ 备选方案 │ │ │ └──────────────┴──────────────┴──────────────┴──────────────┘ │ └────────────────────────────────────────────────────────────────────┘ ``` --- ## 二、模块依赖关系图 ``` yudao-dependencies (依赖版本管理) ↓ yudao-framework (框架层) ├─ yudao-common (通用工具) ├─ yudao-spring-boot-starter-security (权限) ├─ yudao-spring-boot-starter-mybatis (ORM) ├─ yudao-spring-boot-starter-redis (缓存) ├─ yudao-spring-boot-starter-biz-tenant (多租户) ├─ yudao-spring-boot-starter-job (定时任务) ├─ yudao-spring-boot-starter-mq (消息队列) ├─ yudao-spring-boot-starter-excel (Excel) ├─ yudao-spring-boot-starter-web (Web) ├─ yudao-spring-boot-starter-monitor (监控) └─ yudao-spring-boot-starter-protection (保护) ↓ yudao-module-system (系统模块 - 核心业务) ├─ yudao-module-system-api (API接口) └─ yudao-module-system-biz (业务实现) ↓ yudao-module-infra (基础设施模块) ├─ yudao-module-infra-api └─ yudao-module-infra-biz ↓ yudao-module-member (会员模块 - 可选) ├─ yudao-module-member-api └─ yudao-module-member-biz ↓ yudao-module-bpm (工作流模块 - 可选) ├─ yudao-module-bpm-api └─ yudao-module-bpm-biz ↓ yudao-module-report (报表模块 - 可选) ├─ yudao-module-report-api └─ yudao-module-report-biz ↓ yudao-server (主应用 - 容器) └─ 依赖所有上述模块 ``` --- ## 三、数据流向图 ### 3.1 账单查询流程 ``` ┌─────────────────────────────────────────────────────────────────┐ │ 前端请求: GET /api/order/receivable-total?year=2024 │ └────────────────────────┬────────────────────────────────────────┘ │ ↓ ┌─────────────────────────────────────────────────────────────────┐ │ OrderController.getOrderReceivableTotal() │ │ - 参数验证 │ │ - 权限检查 │ └────────────────────────┬────────────────────────────────────────┘ │ ↓ ┌─────────────────────────────────────────────────────────────────┐ │ OrderApiImpl.getOrderReceivableTotal() │ │ - 循环12个月 │ │ - 调用 getReceivableListByMonth() │ │ - 累加各项金额 │ └────────────────────────┬────────────────────────────────────────┘ │ ↓ ┌─────────────────────────────────────────────────────────────────┐ │ OrderApiImpl.getReceivableListByMonth() │ │ - 调用 getListByMonth() │ └────────────────────────┬────────────────────────────────────────┘ │ ↓ ┌─────────────────────────────────────────────────────────────────┐ │ OrderApiImpl.getListByMonth() │ │ ├─ orderMapper.selectListByMonth() │ │ │ └─ SQL: SELECT * FROM elderly_expense_order WHERE ... │ │ │ (查询该月订单列表) │ │ │ │ │ ├─ orderItemMapper.selectList() │ │ │ └─ SQL: SELECT * FROM elderly_expense_order_item │ │ │ WHERE expense_order_id IN (...) │ │ │ (批量查询订单项) │ │ │ │ │ ├─ itemMapper.selectBatchIds() │ │ │ └─ SQL: SELECT * FROM elderly_expense_item │ │ │ WHERE id IN (...) │ │ │ (批量查询费用项) │ │ │ │ │ └─ dailyExpensesMapper.selectBatchIds() │ │ └─ SQL: SELECT * FROM daily_expenses │ │ WHERE id IN (...) │ │ (批量查询日常开支) │ └────────────────────────┬────────────────────────────────────────┘ │ ↓ ┌─────────────────────────────────────────────────────────────────┐ │ 数据组装与计算 │ │ - 将DO转换为VO │ │ - 计算各项金额 │ │ - 计算实付比例 │ └────────────────────────┬────────────────────────────────────────┘ │ ↓ ┌─────────────────────────────────────────────────────────────────┐ │ 返回响应: OrderItemTotalRespVO │ │ { │ │ "billingMonth": "2024年12月", │ │ "bedTotalAmount": 12000.00, │ │ "nurseTotalAmount": 8000.00, │ │ "mealTotalAmount": 5000.00, │ │ "serviceTotalAmount": 3000.00, │ │ "totalAmount": 28000.00, │ │ "totalActualAmount": 25000.00, │ │ "actualTotalProportion": "89%" │ │ } │ └─────────────────────────────────────────────────────────────────┘ ``` ### 3.2 性能问题展示 ``` 【当前实现】- 性能问题 ┌──────────────────────────────────────────────────────────────┐ │ getOrderReceivableTotal() │ │ for i=1 to 12: │ │ ├─ getReceivableListByMonth(month=i) │ │ │ └─ getListByMonth() │ │ │ ├─ Query 1: selectListByMonth() │ │ │ ├─ Query 2: selectList() - 订单项 │ │ │ ├─ Query 3: selectBatchIds() - 费用项 │ │ │ └─ Query 4: selectBatchIds() - 日常开支 │ │ │ │ │ └─ 累加数据 │ │ │ │ 总查询数: 12 × 4 = 48 次数据库查询 ❌ │ └──────────────────────────────────────────────────────────────┘ 【优化方案】- 性能改进 ┌──────────────────────────────────────────────────────────────┐ │ getOrderReceivableTotal() │ │ ├─ selectListByYear(year) │ │ │ ├─ Query 1: selectListByYear() │ │ │ ├─ Query 2: selectList() - 订单项 │ │ │ ├─ Query 3: selectBatchIds() - 费用项 │ │ │ └─ Query 4: selectBatchIds() - 日常开支 │ │ │ │ │ └─ 在内存中按月份分组 │ │ └─ 循环12个月进行累加 │ │ │ │ 总查询数: 1 × 4 = 4 次数据库查询 ✅ │ │ 性能提升: 92% 的查询减少 │ └──────────────────────────────────────────────────────────────┘ ``` --- ## 四、业务对象关系图 ``` ┌─────────────────────────────────────────────────────────────────┐ │ ElderlyInfo (长者) │ │ ├─ id: 长者ID │ │ ├─ elder_name: 姓名 │ │ ├─ in_status: 在住状态 (1=在住, 2=退住) │ │ ├─ org_type: 机构类型 │ │ └─ tenant_id: 租户ID │ └────────┬──────────────────────────────────────────────────────────┘ │ 1:N ├─────────────────────────────────────────────────────────┐ │ │ ↓ ↓ ┌──────────────────────────┐ ┌──────────────────────────┐ │ ElderlyContract (合同) │ │ ElderlyExpense (费用) │ │ ├─ id │ │ ├─ id │ │ ├─ contract_number │ │ ├─ elder_id │ │ ├─ begin_time │ │ ├─ created_time │ │ ├─ expire_time │ │ └─ ... │ │ ├─ contract_term │ │ │ │ └─ ... │ │ 1:N │ └──────────────────────────┘ │ ↓ │ │ ┌──────────────────────┐│ │ │ExpenseItem (费用项) ││ │ │├─ id ││ │ │├─ expense_id ││ │ │├─ item_category_id ││ │ │├─ type ││ │ │├─ amount ││ │ │└─ ... ││ │ └──────────────────────┘│ └──────────────────────────┘ │ ├─────────────────────────────────────────────────────────┐ │ │ ↓ ↓ ┌──────────────────────────────┐ ┌──────────────────────────┐ │ ExpenseOrder (账单) │ │ DailyExpenses (日常开支)│ │ ├─ id │ │ ├─ id │ │ ├─ elder_id │ │ ├─ elder_id │ │ ├─ billing_month │ │ ├─ item_name │ │ ├─ pay_status │ │ ├─ amount │ │ ├─ payable_amount │ │ ├─ round_amount │ │ ├─ actual_amount │ │ ├─ type │ │ └─ ... │ │ └─ ... │ │ │ │ │ │ 1:N │ │ 1:N │ │ ↓ │ │ ↓ │ │ ┌──────────────────────────┐│ │ (关联) │ │ │ExpenseOrderItem (账单项) ││ │ │ │ │├─ id ││ │ │ │ │├─ expense_order_id ││ │ │ │ │├─ expense_source ││ │ │ │ │├─ source_expense_item_id ││ │ │ │ │├─ total_amount ││ │ │ │ │├─ actual_price ││ │ │ │ │├─ pay_status ││ │ │ │ │└─ ... ││ │ │ │ └──────────────────────────┘│ │ │ └──────────────────────────────┘ └──────────────────────────┘ │ ├─────────────────────────────────────────────────────────┐ │ │ ↓ ↓ ┌──────────────────────────┐ ┌──────────────────────────┐ │ DepositRecord (押金) │ │ ElderlyBalance (余额) │ │ ├─ id │ │ ├─ id │ │ ├─ elder_id │ │ ├─ elder_id │ │ ├─ deposit_amount │ │ ├─ amount │ │ ├─ refund_amount │ │ └─ ... │ │ └─ ... │ │ │ └──────────────────────────┘ └──────────────────────────┘ ``` --- ## 五、系统功能模块图 ``` ┌─────────────────────────────────────────────────────────────────┐ │ 养老院管理系统功能模块 │ └─────────────────────────────────────────────────────────────────┘ │ ├─────────────────────────────────────────────────────────┐ │ │ ↓ ↓ ┌──────────────────────────┐ ┌──────────────────────────┐ │ 长者管理模块 │ │ 合同管理模块 │ │ ├─ 长者信息维护 │ │ ├─ 合同创建 │ │ ├─ 入住管理 │ │ ├─ 合同续签 │ │ ├─ 退住管理 │ │ ├─ 合同终止 │ │ ├─ 床位分配 │ │ ├─ 合同查询 │ │ ├─ 护理等级 │ │ └─ 合同统计 │ │ └─ 长者查询 │ └──────────────────────────┘ └──────────────────────────┘ │ ├─────────────────────────────────────────────────────────┐ │ │ ↓ ↓ ┌──────────────────────────┐ ┌──────────────────────────┐ │ 费用管理模块 │ │ 账单管理模块 │ │ ├─ 费用项维护 │ │ ├─ 账单生成 │ │ ├─ 费用分类 │ │ ├─ 账单查询 │ │ ├─ 费用统计 │ │ ├─ 账单打印 │ │ ├─ 费用调整 │ │ ├─ 缴费管理 │ │ └─ 费用查询 │ │ ├─ 欠费管理 │ └──────────────────────────┘ │ └─ 账单统计 │ │ └──────────────────────────┘ │ ├─────────────────────────────────────────────────────────┐ │ │ ↓ ↓ ┌──────────────────────────┐ ┌──────────────────────────┐ │ 日常开支模块 │ │ 押金管理模块 │ │ ├─ 开支录入 │ │ ├─ 押金收取 │ │ ├─ 开支分类 │ │ ├─ 押金退还 │ │ ├─ 开支统计 │ │ ├─ 押金查询 │ │ ├─ 开支查询 │ │ └─ 押金统计 │ │ └─ 开支导出 │ └──────────────────────────┘ └──────────────────────────┘ │ ├─────────────────────────────────────────────────────────┐ │ │ ↓ ↓ ┌──────────────────────────┐ ┌──────────────────────────┐ │ 员工管理模块 │ │ 设备管理模块 │ │ ├─ 员工信息 │ │ ├─ 设备维护 │ │ ├─ 排班管理 │ │ ├─ 设备监控 │ │ ├─ 考勤管理 │ │ ├─ 设备告警 │ │ ├─ 薪资管理 │ │ └─ 设备统计 │ │ └─ 员工查询 │ └──────────────────────────┘ └──────────────────────────┘ │ ├─────────────────────────────────────────────────────────┐ │ │ ↓ ↓ ┌──────────────────────────┐ ┌──────────────────────────┐ │ 工作流模块 │ │ 报表统计模块 │ │ ├─ 流程定义 │ │ ├─ 收入统计 │ │ ├─ 流程监控 │ │ ├─ 开支统计 │ │ ├─ 任务管理 │ │ ├─ 长者统计 │ │ └─ 流程查询 │ │ ├─ 占用率统计 │ └──────────────────────────┘ │ └─ 自定义报表 │ └──────────────────────────┘ ``` --- ## 六、数据库表结构关系 ``` elderly_info (长者信息表) │ ├─ PK: id ├─ FK: tenant_id → tenant (租户) ├─ FK: bed_id → org_build_bed (床位) ├─ FK: build_id → org_build (建筑) │ ├─ 1:N → elderly_contract (合同) │ ├─ PK: id │ ├─ FK: elder_id → elderly_info │ └─ 字段: contract_number, begin_time, expire_time, contract_term │ ├─ 1:N → elderly_expense_order (账单) │ ├─ PK: id │ ├─ FK: elder_id → elderly_info │ ├─ 字段: billing_month, pay_status, payable_amount, actual_amount │ │ │ └─ 1:N → elderly_expense_order_item (账单项) │ ├─ PK: id │ ├─ FK: expense_order_id → elderly_expense_order │ ├─ 字段: expense_source, source_expense_item_id, total_amount │ └─ 关联: ExpenseItem 或 DailyExpenses │ ├─ 1:N → elderly_expense (费用) │ ├─ PK: id │ ├─ FK: elder_id → elderly_info │ │ │ └─ 1:N → elderly_expense_item (费用项) │ ├─ PK: id │ ├─ FK: expense_id → elderly_expense │ ├─ FK: item_category_id → sys_charge_category │ └─ 字段: type, amount │ ├─ 1:N → daily_expenses (日常开支) │ ├─ PK: id │ ├─ FK: elder_id → elderly_info │ └─ 字段: item_name, amount, round_amount, type │ ├─ 1:N → deposit_record (押金) │ ├─ PK: id │ ├─ FK: elder_id → elderly_info │ └─ 字段: deposit_amount, refund_amount │ ├─ 1:N → elderly_change_record (变更记录) │ ├─ PK: id │ ├─ FK: elder_id → elderly_info │ └─ 字段: change_type, change_content │ ├─ 1:1 → elderly_balance (余额) │ ├─ PK: id │ ├─ FK: elder_id → elderly_info │ └─ 字段: amount │ └─ 1:1 → elderly_expense_subsidy_account (补贴账户) ├─ PK: id ├─ FK: elder_id → elderly_info └─ 字段: amount ``` --- ## 七、API接口层次结构 ``` ┌─────────────────────────────────────────────────────────────────┐ │ API 接口层次结构 │ └─────────────────────────────────────────────────────────────────┘ ┌─ 长者管理 API ──────────────────────────────────────────────────┐ │ GET /api/elderly/list # 查询长者列表 │ │ GET /api/elderly/{id} # 查询长者详情 │ │ POST /api/elderly/create # 创建长者 │ │ PUT /api/elderly/update # 更新长者 │ │ DELETE /api/elderly/{id} # 删除长者 │ │ POST /api/elderly/check-in # 入住 │ │ POST /api/elderly/check-out # 退住 │ └─────────────────────────────────────────────────────────────────┘ ┌─ 合同管理 API ──────────────────────────────────────────────────┐ │ GET /api/contract/list # 查询合同列表 │ │ GET /api/contract/{id} # 查询合同详情 │ │ POST /api/contract/create # 创建合同 │ │ PUT /api/contract/update # 更新合同 │ │ DELETE /api/contract/{id} # 删除合同 │ │ POST /api/contract/renew # 续签合同 │ └─────────────────────────────────────────────────────────────────┘ ┌─ 费用管理 API ──────────────────────────────────────────────────┐ │ GET /api/expense/list # 查询费用列表 │ │ GET /api/expense/{id} # 查询费用详情 │ │ POST /api/expense/create # 创建费用 │ │ PUT /api/expense/update # 更新费用 │ │ DELETE /api/expense/{id} # 删除费用 │ │ GET /api/expense/statistics # 费用统计 │ └─────────────────────────────────────────────────────────────────┘ ┌─ 账单管理 API ──────────────────────────────────────────────────┐ │ GET /api/order/list # 查询账单列表 │ │ GET /api/order/{id} # 查询账单详情 │ │ POST /api/order/create # 创建账单 │ │ PUT /api/order/update # 更新账单 │ │ DELETE /api/order/{id} # 删除账单 │ │ GET /api/order/by-month # 按月查询账单 │ │ GET /api/order/total-by-month # 按月查询总计 │ │ GET /api/order/receivable-list # 查询应收列表 │ │ GET /api/order/receivable-total # 查询应收总计【性能问题】 │ │ POST /api/order/mark-paid # 标记已缴费 │ └─────────────────────────────────────────────────────────────────┘ ┌─ 日常开支 API ──────────────────────────────────────────────────┐ │ GET /api/daily-expenses/list # 查询开支列表 │ │ GET /api/daily-expenses/{id} # 查询开支详情 │ │ POST /api/daily-expenses/create # 创建开支 │ │ PUT /api/daily-expenses/update # 更新开支 │ │ DELETE /api/daily-expenses/{id} # 删除开支 │ │ GET /api/daily-expenses/statistics # 开支统计 │ └─────────────────────────────────────────────────────────────────┘ ┌─ 押金管理 API ──────────────────────────────────────────────────┐ │ GET /api/deposit/list # 查询押金列表 │ │ GET /api/deposit/{id} # 查询押金详情 │ │ POST /api/deposit/create # 创建押金 │ │ PUT /api/deposit/update # 更新押金 │ │ DELETE /api/deposit/{id} # 删除押金 │ │ POST /api/deposit/refund # 退还押金 │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## 八、系统部署架构 ``` ┌─────────────────────────────────────────────────────────────────┐ │ 开发环境 │ │ ┌──────────────┬──────────────┬──────────────┐ │ │ │ IDE │ Git │ Maven │ │ │ │ (IntelliJ) │ (GitHub) │ (3.8+) │ │ │ └──────────────┴──────────────┴──────────────┘ │ └─────────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────────────┐ │ 测试环境 │ │ ┌──────────────┬──────────────┬──────────────┐ │ │ │ JUnit │ Mockito │ H2 Database │ │ │ │ (单元测试) │ (Mock框架) │ (内存数据库)│ │ │ └──────────────┴──────────────┴──────────────┘ │ └─────────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────────────┐ │ 生产环境 │ │ ┌────────────────────────────────────────────────────────────┐ │ │ │ Nginx (反向代理) │ │ │ │ :80 / :443 (HTTPS) │ │ │ └────────────────────────────────────────────────────────────┘ │ │ ↓ │ │ ┌────────────────────────────────────────────────────────────┐ │ │ │ 负载均衡器 (可选) │ │ │ │ (Nginx / HAProxy / F5) │ │ │ └────────────────────────────────────────────────────────────┘ │ │ ↓ │ │ ┌────────────────────────────────────────────────────────────┐ │ │ │ Spring Boot 应用集群 │ │ │ │ ┌──────────────┬──────────────┬──────────────┐ │ │ │ │ │ Instance 1 │ Instance 2 │ Instance N │ │ │ │ │ │ :8080 │ :8081 │ :808N │ │ │ │ │ └──────────────┴──────────────┴──────────────┘ │ │ │ └────────────────────────────────────────────────────────────┘ │ │ ↓ │ │ ┌────────────────────────────────────────────────────────────┐ │ │ │ 数据持久化层 │ │ │ │ ┌──────────────┬──────────────┬──────────────┐ │ │ │ │ │ MySQL │ Redis │ Elasticsearch │ │ │ │ │ (主从) │ (集群) │ (可选) │ │ │ │ │ └──────────────┴──────────────┴──────────────┘ │ │ │ └────────────────────────────────────────────────────────────┘ │ │ ↓ │ │ ┌────────────────────────────────────────────────────────────┐ │ │ │ 备份与监控 │ │ │ │ ┌──────────────┬──────────────┬──────────────┐ │ │ │ │ │ 备份系统 │ 监控系统 │ 日志系统 │ │ │ │ │ │ (定时备份) │ (Prometheus)│ (ELK Stack) │ │ │ │ │ └──────────────┴──────────────┴──────────────┘ │ │ │ └────────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## 九、请求处理流程 ``` ┌─────────────────────────────────────────────────────────────────┐ │ HTTP 请求处理流程 │ └─────────────────────────────────────────────────────────────────┘ 1. 请求到达 ↓ Client 发送 HTTP 请求 GET /api/order/receivable-total?year=2024&tenantId=1 ↓ 2. 网关层 ↓ Nginx 接收请求 ├─ SSL/TLS 解密 (如果是HTTPS) ├─ 请求路由 ├─ 负载均衡 └─ 请求转发到应用 ↓ 3. Spring Boot 应用 ↓ DispatcherServlet 接收请求 ↓ 4. 过滤器链 ↓ ├─ CharacterEncodingFilter (字符编码) ├─ CorsFilter (跨域处理) ├─ SecurityFilter (安全过滤) └─ 其他自定义过滤器 ↓ 5. 拦截器链 ↓ ├─ PreHandle (前置处理) │ ├─ 权限验证 │ ├─ 租户隔离 │ └─ 日志记录 ├─ PostHandle (后置处理) └─ AfterCompletion (完成处理) ↓ 6. 控制器处理 ↓ OrderController.getOrderReceivableTotal() ├─ 参数验证 (@Valid) ├─ 权限检查 (@PreAuthorize) ├─ 租户隔离 (TenantContext) └─ 调用业务层 ↓ 7. 业务层处理 ↓ OrderApiImpl.getOrderReceivableTotal() ├─ 业务逻辑处理 ├─ 数据库查询 ├─ 数据组装 └─ 返回结果 ↓ 8. 数据访问层 ↓ ExpenseOrderMapper.selectListByYear() ├─ SQL 构建 ├─ 参数绑定 ├─ 数据库执行 └─ 结果映射 ↓ 9. 数据库操作 ↓ MySQL 执行 SQL 查询 ├─ 查询优化 ├─ 索引使用 ├─ 缓存查询 └─ 返回结果集 ↓ 10. 响应处理 ↓ ├─ 数据转换 (DO → VO) ├─ 序列化 (Object → JSON) ├─ 响应头设置 └─ 返回给客户端 ↓ 11. 客户端接收 ↓ { "code": 0, "msg": "success", "data": { "billingMonth": "2024年12月", "totalAmount": 28000.00, ... } } ``` --- ## 十、缓存策略 ``` ┌─────────────────────────────────────────────────────────────────┐ │ 缓存分层策略 │ └─────────────────────────────────────────────────────────────────┘ ┌─ 一级缓存 (本地缓存) ─────────────────────────────────────────┐ │ 位置: 应用内存 │ │ 工具: Guava Cache / Caffeine │ │ 特点: 速度快，但不支持分布式 │ │ 使用场景: │ │ ├─ 字典数据缓存 │ │ ├─ 配置信息缓存 │ │ └─ 热点数据缓存 │ │ TTL: 5-30 分钟 │ └─────────────────────────────────────────────────────────────────┘ ↓ ┌─ 二级缓存 (分布式缓存) ───────────────────────────────────────┐ │ 位置: Redis 服务器 │ │ 工具: Spring Data Redis │ │ 特点: 支持分布式，速度快 │ │ 使用场景: │ │ ├─ 用户会话缓存 │ │ ├─ 权限数据缓存 │ │ ├─ 账单数据缓存 │ │ └─ 统计数据缓存 │ │ TTL: 30 分钟 - 1 小时 │ │ 缓存键设计: │ │ ├─ order:receivable:total:{year}:{tenantId} │ │ ├─ order:list:{month}:{tenantId} │ │ └─ elderly:info:{elderId} │ └─────────────────────────────────────────────────────────────────┘ ↓ ┌─ 三级缓存 (数据库缓存) ───────────────────────────────────────┐ │ 位置: MySQL 数据库 │ │ 工具: MyBatis 查询缓存 │ │ 特点: 持久化存储 │ │ 使用场景: │ │ ├─ 所有业务数据 │ │ └─ 历史数据 │ │ TTL: 永久存储 │ └─────────────────────────────────────────────────────────────────┘ 缓存更新策略: ├─ Cache-Aside (旁路缓存) │ ├─ 读: 先查缓存，缓存未命中则查数据库，更新缓存 │ └─ 写: 先更新数据库，再删除缓存 │ ├─ Write-Through (写穿) │ ├─ 读: 先查缓存，缓存未命中则查数据库 │ └─ 写: 同时更新缓存和数据库 │ └─ Write-Behind (写回) ├─ 读: 先查缓存，缓存未命中则查数据库 └─ 写: 先更新缓存，异步更新数据库 ``` --- ## 十一、监控与告警 ``` ┌─────────────────────────────────────────────────────────────────┐ │ 监控与告警体系 │ └─────────────────────────────────────────────────────────────────┘ ┌─ 应用监控 ────────────────────────────────────────────────────┐ │ 工具: Spring Boot Actuator + Prometheus + Grafana │ │ 指标: │ │ ├─ JVM 内存使用率 │ │ ├─ 线程数 │ │ ├─ GC 频率 │ │ ├─ HTTP 请求数 │ │ ├─ 请求响应时间 │ │ ├─ 错误率 │ │ └─ 业务指标 │ │ ├─ 账单生成数 │ │ ├─ 缴费成功率 │ │ └─ 应收总额 │ └─────────────────────────────────────────────────────────────────┘ ┌─ 数据库监控 ──────────────────────────────────────────────────┐ │ 工具: MySQL Slow Query Log + pt-query-digest │ │ 指标: │ │ ├─ 慢查询日志 │ │ ├─ 查询执行时间 │ │ ├─ 连接数 │ │ ├─ 锁等待时间 │ │ └─ 复制延迟 │ └─────────────────────────────────────────────────────────────────┘ ┌─ 缓存监控 ────────────────────────────────────────────────────┐ │ 工具: Redis Info + Redis Exporter │ │ 指标: │ │ ├─ 缓存命中率 │ │ ├─ 缓存大小 │ │ ├─ 过期键数 │ │ ├─ 连接数 │ │ └─ 内存使用率 │ └─────────────────────────────────────────────────────────────────┘ ┌─ 日志监控 ────────────────────────────────────────────────────┐ │ 工具: ELK Stack (Elasticsearch + Logstash + Kibana) │ │ 日志类型: │ │ ├─ 应用日志 (INFO, WARN, ERROR) │ │ ├─ 访问日志 (HTTP 请求) │ │ ├─ 审计日志 (用户操作) │ │ └─ 业务日志 (关键业务操作) │ └─────────────────────────────────────────────────────────────────┘ 告警规则: ├─ CPU 使用率 > 80% → 告警 ├─ 内存使用率 > 85% → 告警 ├─ 磁盘使用率 > 90% → 告警 ├─ 数据库连接数 > 80% → 告警 ├─ 慢查询 > 1s → 告警 ├─ 错误率 > 1% → 告警 ├─ 缓存命中率 < 70% → 告警 └─ 应用响应时间 > 1s → 告警 ``` --- **文档生成时间**: 2025-12-08 **文档版本**: 1.0 **作者**: AI Assistant