立项原因： 旨在解决企业在从单体架构向微服务架构演进过程中通用脚手架缺失的问题。若依（RuoYi）官方版只提供用户、角色、菜单、字典、监控等通用底座，无法直接承载"人员通讯录管理、员工消费台账、个人资料合规变更、移动端办公"等真实业务场景；而完全自研一套微服务脚手架成本高、稳定性差、后期组件升级难。本项目在官方 RuoYi-Cloud v3.6.6 的基础上做"可插拔、可复用、不侵入核心"的二次演进，把通用平台能力与各业务诉求解耦。
行业场景与业务背景： 本项目聚焦企业内部数字化管理与移动化办公两个细分场景：
HR / 行政 / IT 运维场景：需要统一管理每位员工的多部手机号、设备绑定与责任人变更历史，作为差旅、紧急通讯、运维告警的基础数据；
财务报销与个人台账场景：集中记录员工日常消费、商务接待、差旅明细，支持多维度查询与变更留痕；
合规审计 + 移动办公场景：通过独立的 ruoyi-app + ruoyi-app-ui（H5）让员工在手机端主动发起手机号、邮箱、个人资料变更并进入审批流，提升内部流程的透明度与合规可追溯性。
项目具体功能模块：
上游通用模块（继承）：用户、部门、岗位、菜单、角色、字典、参数、通知公告、操作日志、登录日志、在线用户、定时任务、代码生成、系统接口、服务监控、连接池监视、在线构建器；
人员手机管理（自研） system:phone：基于内置代码生成器扩展的人员与手机号关联模块，含查询、新增、修改、删除、导出按钮权限点；
消费记录管理（自研） system:record：员工消费台账 CRUD 模块，支持关联信息查询改造（见 commit 55ca1b1）、导出与权限控制；
APP 模块（自研） com.ruoyi.app：独立部署的后端子工程，含 AppAudit（手机/邮箱/个人资料变更审计）、AppAuditAdmin（管理员审批）、AppUser、审计表 app_phone_change / app_email_change / app_profile_change 等；
字典缓存预热任务（设计+实施文档，docs/superpowers/specs & plans）：通过定时任务在启动或低峰期预热字典缓存，降低首屏接口延迟；
移动端 H5 ruoyi-app-ui：独立 Vue3 + Vite 项目，对接 ruoyi-app 网关路由，提供个人信息查询/修改入口；
基础设施层：Maven 多模块（gateway/auth/common/modules/visual/app）+ Docker / Docker Compose 一键部署。
主要功能描述：
统一接入层：ruoyi-gateway 基于 Spring Cloud Gateway 网关统一做 JWT 校验、验证码、XSS、黑白名单过滤，下游通过 FROM_SOURCE 防内部接口伪造；
认证授权：ruoyi-auth + Redis 存储登录态，结合 Spring Security 与自研 @Req
"我"负责的具体任务：
主导 RuoYi-Cloud 在企业内部场景下的二次定制，承担业务模块从需求拆解、数据库/菜单 SQL 设计、后端 service / mapper / Controller，到 Vue 页面与 API 封装的端到端落地；
完成 ruoyi-app 模块设计与编码：新增独立可部署的 ruoyi-app 后端子工程、独立网关路由（docs/ruoyi-gateway-dev.yml）、对应的 ruoyi-app-ui 移动 H5 项目骨架、Postman 接口集合、Nginx 与 docker-compose 部署脚本，使上游框架能够快速支撑独立的移动端业务；
负责"人员手机管理"、"消费记录"两个自研业务模块的代码生成与定制化（含关联信息查询改造、列表导出、按权限点控制按钮可见性）；
编写"字典缓存预热任务"的设计规格与实施计划文档（docs/superpowers/specs/2026-07-30-dict-cache-warmup-task-design.md、docs/superpowers/plans/2026-07-30-dict-cache-warmup-task.md），梳理任务编排、缓存一致性与回滚策略；
维护项目入口文档 CLAUDE.md，让团队成员在第一次接触代码时即可理解模块边界、命令约定、登录请求链路。
技术栈、架构亮点与难点：
技术栈：Java 8 + Spring Boot 2.7 + Spring Cloud Hoxton + Spring Cloud Alibaba + Nacos（注册中心/配置中心） + Redis + Sentinel + OpenFeign + MyBatis + PageHelper + Druid + Seata + Vue 2 / Element UI（管理后台）+ Vue 3 +
评论