elder-yudao-pro/docs/项目目录说明.md

# 项目目录说明

更新日期：2026-10-05。项目：`elder-yudao-pro`。本次只添加目录说明，不删除、移动或重命名目录，也不修改构建和运行配置。

IDEA 项目树不原生支持为每个普通目录设置独立副标题。本项目在 287 个主要目录中添加了 `目录说明.txt`，点击即可阅读；已有 README.md 的目录沿用原说明。源码中的 .txt 文件不会被 Vue/Vite 的组件扫描当成页面或组件。

可在 IDEA 中按 Ctrl+Shift+N，输入“目录说明.txt”查找说明；输入“项目目录说明.md”打开本索引。外层目录与 Maven 子模块有独立说明，后端分层和前端组件也分别注明用途。

## 当前状态

当前后端启用 system、infra；member 源码保留，计划用于老人、志愿者和家属账号。health 模块尚未建立。其他模板业务目前未启用，暂时保留文件。前端页面或 API 源码存在不代表后端功能已经启用。

## 项目根目录

| 目录 | 用途 | 状态／迁移定位 |
| --- | --- | --- |
| [.run](../.run/目录说明.txt) | IDEA 启动配置：保存后端和前端启动项，供 IDEA 顶部运行配置列表使用。 | 前端启动项已指向 yudao-ui-admin-vue3。 维护 *.run.xml；本目录名称保持不变。 |
| [deploy](../deploy/目录说明.txt) | 部署与本地运行：保存环境初始化、依赖安装、启动、停止和检查脚本。 | 当前使用 deploy/local。 应用部署操作在这里维护，业务代码放在业务模块中。 |
| [docs](../docs/README.md) | 项目文档：记录旧系统迁移分析、本地部署、界面定制与目录用途。 | 迁移上下文和已完成操作分别记录。 从 README.md 或 项目目录说明.md 开始阅读。 |
| [image](../image/目录说明.txt) | 模板文档配图：保存原模板 README 使用的宣传截图。 | 不参与系统业务和应用启动。 按用户要求暂时保留。 |
| [mysql_script](../mysql_script/目录说明.txt) | 数据库初始化脚本：保存 system/infra 初始化 SQL，以及 member、商城、支付、报表等可选模块的 SQL。 | 本机 system/infra 使用 ruoyi-vue-pro.sql 初始化。 后续 member 初始化会使用 ruoyi-member.sql；新增健康业务应使用独立增量脚本。 |
| [yudao-dependencies](../yudao-dependencies/目录说明.txt) | Maven 依赖版本管理：统一管理 Java 依赖、内部模块和框架组件的版本，供各模块引用。 | 已参与当前构建。 增加新依赖时优先在这里管理版本。 |
| [yudao-framework](../yudao-framework/目录说明.txt) | 公共技术框架：封装 Web、认证、数据库、缓存、租户、数据权限、任务、消息和文件导出等技术能力。 | 已参与当前构建。 健康业务复用这些基础能力；具体业务规则放入后续 health 模块。 |
| [yudao-server](../yudao-server/目录说明.txt) | 后端启动工程：包含 Spring Boot 主启动类、应用配置和业务模块依赖，负责组装并运行服务。 | 当前加载 system 和 infra；member 等模块未加载。 启用健康业务或会员模块时，需要调整本目录 pom.xml 及根 pom.xml。 |
| [yudao-ui-admin-vue3](../yudao-ui-admin-vue3/README.md) | 管理端前端：Vue 3、Vite、Element Plus 管理界面，是当前维护的正式前端源码目录。 | 已完成 Olive 视觉适配；菜单当前展示 system、infra。 以后在这个目录改页面；运行方法见本目录 README.md。 |
| [yudao-example](../yudao-example/目录说明.txt) | 单点登录示例：演示授权码模式、账号密码模式的单点登录接入。 | 根 pom.xml 未启用，当前后端未加载。 用于参考，暂时保留。 |
| [yudao-module-system](../yudao-module-system/目录说明.txt) | 系统管理：后台账号、角色、菜单、部门、岗位、字典、租户、操作日志、短信、邮箱和站内信。 | 已启用。 管理端权限、通知和字典会继续复用。 |
| [yudao-module-infra](../yudao-module-infra/目录说明.txt) | 基础设施：配置管理、文件存储、定时任务、代码生成、接口日志、监控和 WebSocket 等设施。 | 已启用。 运动提醒、文件与检测事件通知将复用相关能力。 |
| [yudao-module-member](../yudao-module-member/目录说明.txt) | 业务用户账号：会员账号、登录与个人资料；还保留模板中的积分、等级、标签等扩展。 | 源码保留，当前未启用。 计划用于老人、志愿者和家属账号；健康资料放到独立 health 模块。 |
| [yudao-module-bpm](../yudao-module-bpm/目录说明.txt) | 工作流：流程设计、审批、任务与流程实例管理，使用 Flowable。 | 源码保留，当前未启用。 运动协助工单计划在健康业务中实现状态流转，暂不依赖此模块。 |
| [yudao-module-crm](../yudao-module-crm/目录说明.txt) | 客户关系管理：线索、客户、联系人、商机、合同、回款和销售统计。 | 源码保留，当前未启用。 目前老年健康服务需求不使用此业务。 |
| [yudao-module-erp](../yudao-module-erp/目录说明.txt) | 进销存管理：采购、销售、库存、供应商、仓库和财务管理。 | 源码保留，当前未启用。 轻量场地与设备管理计划放入 health，不引入完整 ERP。 |
| [yudao-module-mall](../yudao-module-mall/目录说明.txt) | 商城业务集合：商品、营销、交易、分销和商城统计等模块。 | 源码保留，当前未启用。 当前没有商城需求；会员前端仍存在对商城、支付页面的引用，不能只删目录。 |
| [yudao-module-mp](../yudao-module-mp/目录说明.txt) | 微信公众号管理：公众号账号、粉丝、素材、消息、菜单和自动回复管理。 | 源码保留，当前未启用。 当前项目尚未采用该公众号管理能力。 |
| [yudao-module-pay](../yudao-module-pay/目录说明.txt) | 支付管理：支付应用、渠道、订单、退款、钱包及支付通知。 | 源码保留，当前未启用。 当前运动预约和志愿服务没有确定收费需求。 |
| [yudao-module-report](../yudao-module-report/目录说明.txt) | 报表与大屏设计器：集成报表设计与可视化大屏设计器。 | 源码保留，当前未启用。 后续中控和健康统计可以先在业务前端直接实现。 |

## Maven 子模块与框架组件

| 目录 | 用途 | 状态／迁移定位 |
| --- | --- | --- |
| [yudao-framework/yudao-common](../yudao-framework/yudao-common/目录说明.txt) | 公共 Java 工具：统一响应、分页、异常、枚举、校验和通用工具。 | 框架源码保留；位于当前框架构建集合中。 健康接口沿用 CommonResult、PageResult 等约定。 |
| [yudao-framework/yudao-spring-boot-starter-biz-data-permission](../yudao-framework/yudao-spring-boot-starter-biz-data-permission/目录说明.txt) | 数据权限：按照后台角色与数据范围约束查询。 | 框架源码保留；位于当前框架构建集合中。 本人、家属授权和志愿者服务范围还需在健康业务层校验。 |
| [yudao-framework/yudao-spring-boot-starter-biz-ip](../yudao-framework/yudao-spring-boot-starter-biz-ip/目录说明.txt) | 地区与 IP 信息：提供行政地区、IP 地址解析和相关工具。 | 框架源码保留；位于当前框架构建集合中。 可用于地址、场地区域和注册信息。 |
| [yudao-framework/yudao-spring-boot-starter-biz-tenant](../yudao-framework/yudao-spring-boot-starter-biz-tenant/目录说明.txt) | 多租户隔离：为请求和数据库访问提供租户上下文与隔离。 | 框架源码保留；位于当前框架构建集合中。 新增健康表需要跟随项目租户规则。 |
| [yudao-framework/yudao-spring-boot-starter-excel](../yudao-framework/yudao-spring-boot-starter-excel/目录说明.txt) | Excel 导入导出：封装 Excel 数据转换、导入与导出。 | 框架源码保留；位于当前框架构建集合中。 档案导入导出可以复用。 |
| [yudao-framework/yudao-spring-boot-starter-job](../yudao-framework/yudao-spring-boot-starter-job/目录说明.txt) | 定时任务：封装 Quartz 任务执行和管理接入。 | 框架源码保留；位于当前框架构建集合中。 可承载运动提醒与过期录像清理；具体任务尚未开发。 |
| [yudao-framework/yudao-spring-boot-starter-monitor](../yudao-framework/yudao-spring-boot-starter-monitor/目录说明.txt) | 运行监控：集成应用运行监控和日志追踪相关能力。 | 框架源码保留；位于当前框架构建集合中。 保留为服务监控基础。 |
| [yudao-framework/yudao-spring-boot-starter-mq](../yudao-framework/yudao-spring-boot-starter-mq/目录说明.txt) | 消息通信：提供消息队列相关的通用集成。 | 框架源码保留；位于当前框架构建集合中。 后续按实际需要复用，无需先部署所有消息中间件。 |
| [yudao-framework/yudao-spring-boot-starter-mybatis](../yudao-framework/yudao-spring-boot-starter-mybatis/目录说明.txt) | 数据库访问：封装 MyBatis-Plus、Mapper、查询与分页等能力。 | 框架源码保留；位于当前框架构建集合中。 健康模块按 BaseDO、BaseMapperX 等既有方式编写。 |
| [yudao-framework/yudao-spring-boot-starter-protection](../yudao-framework/yudao-spring-boot-starter-protection/目录说明.txt) | 接口保护：提供限流、幂等、锁等保护能力。 | 框架源码保留；位于当前框架构建集合中。 预约人数、重复提交和派单并发可能需要这些能力。 |
| [yudao-framework/yudao-spring-boot-starter-redis](../yudao-framework/yudao-spring-boot-starter-redis/目录说明.txt) | Redis 缓存：配置缓存连接、序列化和缓存访问。 | 框架源码保留；位于当前框架构建集合中。 保留为框架及业务缓存基础。 |
| [yudao-framework/yudao-spring-boot-starter-security](../yudao-framework/yudao-spring-boot-starter-security/目录说明.txt) | 认证与接口鉴权：提供登录态、安全过滤和权限校验。 | 框架源码保留；位于当前框架构建集合中。 管理用户和业务会员是不同主体，健康接口需要明确调用者类型。 |
| [yudao-framework/yudao-spring-boot-starter-test](../yudao-framework/yudao-spring-boot-starter-test/目录说明.txt) | 测试基础：提供数据库、缓存和服务测试的公共支持。 | 框架源码保留；位于当前框架构建集合中。 后续评分、权限、预约和工单测试可以复用。 |
| [yudao-framework/yudao-spring-boot-starter-web](../yudao-framework/yudao-spring-boot-starter-web/目录说明.txt) | Web 接口基础：处理 Web 配置、参数校验、异常与接口前缀等。 | 框架源码保留；位于当前框架构建集合中。 后台 controller.admin 使用 /admin-api，移动端 controller.app 使用 /app-api。 |
| [yudao-framework/yudao-spring-boot-starter-websocket](../yudao-framework/yudao-spring-boot-starter-websocket/目录说明.txt) | 实时 WebSocket：提供实时连接、消息和认证相关支持。 | 框架源码保留；位于当前框架构建集合中。 后续派单和中控告警可接入，尚未实现设备业务。 |
| [yudao-example/yudao-sso-demo-by-code](../yudao-example/yudao-sso-demo-by-code/目录说明.txt) | 授权码单点登录示例：演示 OAuth 2.0 授权码模式的单点登录接入。 | 当前未启用。 作为接口接入参考。 |
| [yudao-example/yudao-sso-demo-by-password](../yudao-example/yudao-sso-demo-by-password/目录说明.txt) | 密码模式单点登录示例：演示 OAuth 2.0 密码模式的单点登录接入。 | 当前未启用。 作为接口接入参考。 |
| [yudao-module-bpm/yudao-module-bpm-api](../yudao-module-bpm/yudao-module-bpm-api/目录说明.txt) | 工作流：模块调用接口：供其他后端模块调用的接口、DTO 和枚举；不是浏览器直接请求的 Controller。 | 源码保留，当前未启用。 模块间调用优先通过 API，减少对实现类的依赖。 |
| [yudao-module-bpm/yudao-module-bpm-biz](../yudao-module-bpm/yudao-module-bpm-biz/目录说明.txt) | 工作流：业务实现：保存 REST Controller、Service、数据对象、Mapper、转换器及模块配置。 | 源码保留，当前未启用。 src/main/java 是 Java 源码，src/main/resources 是模块资源，src/test 是测试。 |
| [yudao-module-crm/yudao-module-crm-api](../yudao-module-crm/yudao-module-crm-api/目录说明.txt) | 客户关系管理：模块调用接口：供其他后端模块调用的接口、DTO 和枚举；不是浏览器直接请求的 Controller。 | 源码保留，当前未启用。 模块间调用优先通过 API，减少对实现类的依赖。 |
| [yudao-module-crm/yudao-module-crm-biz](../yudao-module-crm/yudao-module-crm-biz/目录说明.txt) | 客户关系管理：业务实现：保存 REST Controller、Service、数据对象、Mapper、转换器及模块配置。 | 源码保留，当前未启用。 src/main/java 是 Java 源码，src/main/resources 是模块资源，src/test 是测试。 |
| [yudao-module-erp/yudao-module-erp-api](../yudao-module-erp/yudao-module-erp-api/目录说明.txt) | 进销存管理：模块调用接口：供其他后端模块调用的接口、DTO 和枚举；不是浏览器直接请求的 Controller。 | 源码保留，当前未启用。 模块间调用优先通过 API，减少对实现类的依赖。 |
| [yudao-module-erp/yudao-module-erp-biz](../yudao-module-erp/yudao-module-erp-biz/目录说明.txt) | 进销存管理：业务实现：保存 REST Controller、Service、数据对象、Mapper、转换器及模块配置。 | 源码保留，当前未启用。 src/main/java 是 Java 源码，src/main/resources 是模块资源，src/test 是测试。 |
| [yudao-module-infra/yudao-module-infra-api](../yudao-module-infra/yudao-module-infra-api/目录说明.txt) | 基础设施：模块调用接口：供其他后端模块调用的接口、DTO 和枚举；不是浏览器直接请求的 Controller。 | 已启用。 模块间调用优先通过 API，减少对实现类的依赖。 |
| [yudao-module-infra/yudao-module-infra-biz](../yudao-module-infra/yudao-module-infra-biz/目录说明.txt) | 基础设施：业务实现：保存 REST Controller、Service、数据对象、Mapper、转换器及模块配置。 | 已启用。 src/main/java 是 Java 源码，src/main/resources 是模块资源，src/test 是测试。 |
| [yudao-module-mall/yudao-module-product-api](../yudao-module-mall/yudao-module-product-api/目录说明.txt) | 商城商品：模块调用接口：供其他后端模块调用的接口、DTO 和枚举；不是浏览器直接请求的 Controller。 | 源码保留，当前未启用。 模块间调用优先通过 API，减少对实现类的依赖。 |
| [yudao-module-mall/yudao-module-product-biz](../yudao-module-mall/yudao-module-product-biz/目录说明.txt) | 商城商品：业务实现：保存 REST Controller、Service、数据对象、Mapper、转换器及模块配置。 | 源码保留，当前未启用。 src/main/java 是 Java 源码，src/main/resources 是模块资源，src/test 是测试。 |
| [yudao-module-mall/yudao-module-promotion-api](../yudao-module-mall/yudao-module-promotion-api/目录说明.txt) | 商城营销：模块调用接口：供其他后端模块调用的接口、DTO 和枚举；不是浏览器直接请求的 Controller。 | 源码保留，当前未启用。 模块间调用优先通过 API，减少对实现类的依赖。 |
| [yudao-module-mall/yudao-module-promotion-biz](../yudao-module-mall/yudao-module-promotion-biz/目录说明.txt) | 商城营销：业务实现：保存 REST Controller、Service、数据对象、Mapper、转换器及模块配置。 | 源码保留，当前未启用。 src/main/java 是 Java 源码，src/main/resources 是模块资源，src/test 是测试。 |
| [yudao-module-mall/yudao-module-statistics-api](../yudao-module-mall/yudao-module-statistics-api/目录说明.txt) | 商城统计：模块调用接口：供其他后端模块调用的接口、DTO 和枚举；不是浏览器直接请求的 Controller。 | 源码保留，当前未启用。 模块间调用优先通过 API，减少对实现类的依赖。 |
| [yudao-module-mall/yudao-module-statistics-biz](../yudao-module-mall/yudao-module-statistics-biz/目录说明.txt) | 商城统计：业务实现：保存 REST Controller、Service、数据对象、Mapper、转换器及模块配置。 | 源码保留，当前未启用。 src/main/java 是 Java 源码，src/main/resources 是模块资源，src/test 是测试。 |
| [yudao-module-mall/yudao-module-trade-api](../yudao-module-mall/yudao-module-trade-api/目录说明.txt) | 商城交易：模块调用接口：供其他后端模块调用的接口、DTO 和枚举；不是浏览器直接请求的 Controller。 | 源码保留，当前未启用。 模块间调用优先通过 API，减少对实现类的依赖。 |
| [yudao-module-mall/yudao-module-trade-biz](../yudao-module-mall/yudao-module-trade-biz/目录说明.txt) | 商城交易：业务实现：保存 REST Controller、Service、数据对象、Mapper、转换器及模块配置。 | 源码保留，当前未启用。 src/main/java 是 Java 源码，src/main/resources 是模块资源，src/test 是测试。 |
| [yudao-module-member/yudao-module-member-api](../yudao-module-member/yudao-module-member-api/目录说明.txt) | 业务用户账号：模块调用接口：供其他后端模块调用的接口、DTO 和枚举；不是浏览器直接请求的 Controller。 | 源码保留，当前未启用。 模块间调用优先通过 API，减少对实现类的依赖。 |
| [yudao-module-member/yudao-module-member-biz](../yudao-module-member/yudao-module-member-biz/目录说明.txt) | 业务用户账号：业务实现：保存 REST Controller、Service、数据对象、Mapper、转换器及模块配置。 | 源码保留，当前未启用。 src/main/java 是 Java 源码，src/main/resources 是模块资源，src/test 是测试。 |
| [yudao-module-mp/yudao-module-mp-api](../yudao-module-mp/yudao-module-mp-api/目录说明.txt) | 微信公众号管理：模块调用接口：供其他后端模块调用的接口、DTO 和枚举；不是浏览器直接请求的 Controller。 | 源码保留，当前未启用。 模块间调用优先通过 API，减少对实现类的依赖。 |
| [yudao-module-mp/yudao-module-mp-biz](../yudao-module-mp/yudao-module-mp-biz/目录说明.txt) | 微信公众号管理：业务实现：保存 REST Controller、Service、数据对象、Mapper、转换器及模块配置。 | 源码保留，当前未启用。 src/main/java 是 Java 源码，src/main/resources 是模块资源，src/test 是测试。 |
| [yudao-module-pay/yudao-module-pay-api](../yudao-module-pay/yudao-module-pay-api/目录说明.txt) | 支付管理：模块调用接口：供其他后端模块调用的接口、DTO 和枚举；不是浏览器直接请求的 Controller。 | 源码保留，当前未启用。 模块间调用优先通过 API，减少对实现类的依赖。 |
| [yudao-module-pay/yudao-module-pay-biz](../yudao-module-pay/yudao-module-pay-biz/目录说明.txt) | 支付管理：业务实现：保存 REST Controller、Service、数据对象、Mapper、转换器及模块配置。 | 源码保留，当前未启用。 src/main/java 是 Java 源码，src/main/resources 是模块资源，src/test 是测试。 |
| [yudao-module-pay/yudao-spring-boot-starter-biz-pay](../yudao-module-pay/yudao-spring-boot-starter-biz-pay/目录说明.txt) | 支付渠道集成组件：封装支付渠道客户端、请求与回调等底层支付能力。 | 所属支付模块当前未启用。 与健康预约业务无直接依赖，暂保留。 |
| [yudao-module-report/yudao-module-report-api](../yudao-module-report/yudao-module-report-api/目录说明.txt) | 报表与大屏设计器：模块调用接口：供其他后端模块调用的接口、DTO 和枚举；不是浏览器直接请求的 Controller。 | 源码保留，当前未启用。 模块间调用优先通过 API，减少对实现类的依赖。 |
| [yudao-module-report/yudao-module-report-biz](../yudao-module-report/yudao-module-report-biz/目录说明.txt) | 报表与大屏设计器：业务实现：保存 REST Controller、Service、数据对象、Mapper、转换器及模块配置。 | 源码保留，当前未启用。 src/main/java 是 Java 源码，src/main/resources 是模块资源，src/test 是测试。 |
| [yudao-module-system/yudao-module-system-api](../yudao-module-system/yudao-module-system-api/目录说明.txt) | 系统管理：模块调用接口：供其他后端模块调用的接口、DTO 和枚举；不是浏览器直接请求的 Controller。 | 已启用。 模块间调用优先通过 API，减少对实现类的依赖。 |
| [yudao-module-system/yudao-module-system-biz](../yudao-module-system/yudao-module-system-biz/目录说明.txt) | 系统管理：业务实现：保存 REST Controller、Service、数据对象、Mapper、转换器及模块配置。 | 已启用。 src/main/java 是 Java 源码，src/main/resources 是模块资源，src/test 是测试。 |
| [yudao-ui-admin-vue3/build](../yudao-ui-admin-vue3/build/目录说明.txt) | 前端构建配置源码：保存 Vite 插件和构建优化配置。 | 不是构建输出，启动和打包会使用。 |
| [yudao-ui-admin-vue3/build/vite](../yudao-ui-admin-vue3/build/vite/目录说明.txt) | Vite 插件与优化：配置 Vue、自动导入、组件扫描、图标、压缩和依赖预处理。 | 已用于当前前端启动和构建。 |
| `yudao-ui-admin-vue3/public` | 前端公共静态资源：保存 favicon 等直接按 URL 访问的资源。 | 此目录会复制到构建产物。 资源说明保存在 docs/项目目录说明.md，避免把说明文件复制到公共访问目录。 |
| [yudao-ui-admin-vue3/types](../yudao-ui-admin-vue3/types/目录说明.txt) | 前端全局类型：保存环境变量、路由、组件和公共类型声明。 | TypeScript 编译会读取此处声明。 |
| [yudao-ui-admin-vue3/src](../yudao-ui-admin-vue3/src/目录说明.txt) | 前端应用源码：页面、接口、布局、组件、状态、样式和工具的主目录。 | 这是后续管理端业务迁移的主要编辑位置。 |

## 后端源码分层

这些目录分工适用于各业务模块；分层用途不代表对应模块已经启用。

| 子目录 | 用途 |
| --- | --- |
| `api` | 模块内部 API 实现：实现模块对外提供的 Java 调用接口。 |
| `controller` | HTTP 接口入口：admin 是管理端接口，app 是业务客户端接口；负责接收参数、校验权限和调用服务。 |
| `convert` | 对象转换：转换数据对象、请求参数和响应对象。 |
| `dal` | 数据库和缓存访问：dataobject 是数据库实体，mysql 是 Mapper，redis 是缓存访问对象。 |
| `enums` | 业务枚举与常量：保存状态、类型及错误码等固定定义。 |
| `framework` | 模块框架适配：保存当前模块与通用框架结合的配置、组件和扩展。 |
| `job` | 业务定时任务：保存可由定时任务框架执行的任务。 |
| `mq` | 业务消息：保存消息对象、生产者和消费者。 |
| `service` | 业务服务：实现业务规则、事务和数据处理，由 Controller 或模块 API 调用。 |
| `util` | 模块工具：保存仅与当前模块有关的辅助方法。 |
| `websocket` | 模块实时通信：实现 WebSocket 消息处理和推送。 |

`src/main/java` 保存 Java 源码，`src/main/resources` 保存配置和模块资源，`src/test/java` / `src/test/resources` 保存测试及测试数据。`cn/iocoder/yudao/...` 是 Java 包名路径，不是可随意改名的普通分类目录。

## 前端主要目录

| 目录 | 用途 | 状态／迁移定位 |
| --- | --- | --- |
| [yudao-ui-admin-vue3/build](../yudao-ui-admin-vue3/build/目录说明.txt) | 前端构建配置源码：保存 Vite 插件和构建优化配置。 | 不是构建输出，启动和打包会使用。 |
| [yudao-ui-admin-vue3/build/vite](../yudao-ui-admin-vue3/build/vite/目录说明.txt) | Vite 插件与优化：配置 Vue、自动导入、组件扫描、图标、压缩和依赖预处理。 | 已用于当前前端启动和构建。 |
| `yudao-ui-admin-vue3/public` | 前端公共静态资源：保存 favicon 等直接按 URL 访问的资源。 | 此目录会复制到构建产物。 资源说明保存在 docs/项目目录说明.md，避免把说明文件复制到公共访问目录。 |
| [yudao-ui-admin-vue3/types](../yudao-ui-admin-vue3/types/目录说明.txt) | 前端全局类型：保存环境变量、路由、组件和公共类型声明。 | TypeScript 编译会读取此处声明。 |
| [yudao-ui-admin-vue3/src](../yudao-ui-admin-vue3/src/目录说明.txt) | 前端应用源码：页面、接口、布局、组件、状态、样式和工具的主目录。 | 这是后续管理端业务迁移的主要编辑位置。 |
| [yudao-ui-admin-vue3/src/api](../yudao-ui-admin-vue3/src/api/目录说明.txt) | 后端接口调用：按业务模块封装 HTTP 请求，页面通过这些方法访问后台。 | 正式管理端源码的一部分。 |
| [yudao-ui-admin-vue3/src/assets](../yudao-ui-admin-vue3/src/assets/目录说明.txt) | 前端资源：保存品牌、图片、SVG 和地图数据等会被源码引用的资源。 | 正式管理端源码的一部分。 |
| [yudao-ui-admin-vue3/src/components](../yudao-ui-admin-vue3/src/components/目录说明.txt) | 公共 UI 组件：提供表格、表单、上传、弹窗、图标、编辑器等通用组件；也保留模板专用组件。 | 正式管理端源码的一部分。 |
| [yudao-ui-admin-vue3/src/config](../yudao-ui-admin-vue3/src/config/目录说明.txt) | 前端配置：product.ts 控制名称、默认租户和启用模块；axios 保存请求配置。 | 正式管理端源码的一部分。 |
| [yudao-ui-admin-vue3/src/directives](../yudao-ui-admin-vue3/src/directives/目录说明.txt) | Vue 自定义指令：提供按钮权限等模板指令。 | 正式管理端源码的一部分。 |
| [yudao-ui-admin-vue3/src/hooks](../yudao-ui-admin-vue3/src/hooks/目录说明.txt) | 可复用逻辑：封装表格、消息、缓存、国际化和表单等组合式逻辑。 | 正式管理端源码的一部分。 |
| [yudao-ui-admin-vue3/src/layout](../yudao-ui-admin-vue3/src/layout/目录说明.txt) | 管理端布局：组织侧栏、顶栏、标签页、用户菜单和页脚。 | 正式管理端源码的一部分。 |
| [yudao-ui-admin-vue3/src/locales](../yudao-ui-admin-vue3/src/locales/目录说明.txt) | 多语言文案：保存中文、英文等界面文本。 | 正式管理端源码的一部分。 |
| [yudao-ui-admin-vue3/src/plugins](../yudao-ui-admin-vue3/src/plugins/目录说明.txt) | 前端插件初始化：集中注册 Element Plus、图标、国际化、表单和样式等能力。 | 正式管理端源码的一部分。 |
| [yudao-ui-admin-vue3/src/router](../yudao-ui-admin-vue3/src/router/目录说明.txt) | 前端路由：配置固定页面和动态菜单路由；菜单来自后台权限数据。 | 正式管理端源码的一部分。 |
| [yudao-ui-admin-vue3/src/store](../yudao-ui-admin-vue3/src/store/目录说明.txt) | 前端状态管理：使用 Pinia 保存用户、权限、布局、标签页等状态。 | 正式管理端源码的一部分。 |
| [yudao-ui-admin-vue3/src/styles](../yudao-ui-admin-vue3/src/styles/目录说明.txt) | 全局样式：保存布局变量、主题和通用样式。 | 正式管理端源码的一部分。 |
| [yudao-ui-admin-vue3/src/types](../yudao-ui-admin-vue3/src/types/目录说明.txt) | 业务与组件类型：保存表单、表格、主题等源码内部的 TypeScript 类型及自动生成声明。 | 正式管理端源码的一部分。 |
| [yudao-ui-admin-vue3/src/utils](../yudao-ui-admin-vue3/src/utils/目录说明.txt) | 前端工具方法：提供请求认证、字典、日期、路由、文件下载和通用函数。 | 正式管理端源码的一部分。 |
| [yudao-ui-admin-vue3/src/views](../yudao-ui-admin-vue3/src/views/目录说明.txt) | 管理端页面：按模块组织系统管理、基础设施和模板保留业务页面。 | 正式管理端源码的一部分。 |
| [yudao-ui-admin-vue3/src/views/system](../yudao-ui-admin-vue3/src/views/system/目录说明.txt) | 系统管理页面：后台账号、角色、菜单、部门、岗位、字典、租户、操作日志、短信、邮箱和站内信。 | 已启用。 管理端权限、通知和字典会继续复用。 |
| [yudao-ui-admin-vue3/src/api/system](../yudao-ui-admin-vue3/src/api/system/目录说明.txt) | 系统管理接口调用：封装系统管理的后台请求。 | 已启用。 API 源码存在并不表示后端模块已启用。 |
| [yudao-ui-admin-vue3/src/views/infra](../yudao-ui-admin-vue3/src/views/infra/目录说明.txt) | 基础设施页面：配置管理、文件存储、定时任务、代码生成、接口日志、监控和 WebSocket 等设施。 | 已启用。 运动提醒、文件与检测事件通知将复用相关能力。 |
| [yudao-ui-admin-vue3/src/api/infra](../yudao-ui-admin-vue3/src/api/infra/目录说明.txt) | 基础设施接口调用：封装基础设施的后台请求。 | 已启用。 API 源码存在并不表示后端模块已启用。 |
| [yudao-ui-admin-vue3/src/views/member](../yudao-ui-admin-vue3/src/views/member/目录说明.txt) | 业务用户账号页面：会员账号、登录与个人资料；还保留模板中的积分、等级、标签等扩展。 | 源码保留，当前未启用。 计划用于老人、志愿者和家属账号；健康资料放到独立 health 模块。 |
| [yudao-ui-admin-vue3/src/api/member](../yudao-ui-admin-vue3/src/api/member/目录说明.txt) | 业务用户账号接口调用：封装业务用户账号的后台请求。 | 源码保留，当前未启用。 API 源码存在并不表示后端模块已启用。 |
| [yudao-ui-admin-vue3/src/views/bpm](../yudao-ui-admin-vue3/src/views/bpm/目录说明.txt) | 工作流页面：流程设计、审批、任务与流程实例管理，使用 Flowable。 | 源码保留，当前未启用。 运动协助工单计划在健康业务中实现状态流转，暂不依赖此模块。 |
| [yudao-ui-admin-vue3/src/api/bpm](../yudao-ui-admin-vue3/src/api/bpm/目录说明.txt) | 工作流接口调用：封装工作流的后台请求。 | 源码保留，当前未启用。 API 源码存在并不表示后端模块已启用。 |
| [yudao-ui-admin-vue3/src/views/crm](../yudao-ui-admin-vue3/src/views/crm/目录说明.txt) | 客户关系管理页面：线索、客户、联系人、商机、合同、回款和销售统计。 | 源码保留，当前未启用。 目前老年健康服务需求不使用此业务。 |
| [yudao-ui-admin-vue3/src/api/crm](../yudao-ui-admin-vue3/src/api/crm/目录说明.txt) | 客户关系管理接口调用：封装客户关系管理的后台请求。 | 源码保留，当前未启用。 API 源码存在并不表示后端模块已启用。 |
| [yudao-ui-admin-vue3/src/views/erp](../yudao-ui-admin-vue3/src/views/erp/目录说明.txt) | 进销存管理页面：采购、销售、库存、供应商、仓库和财务管理。 | 源码保留，当前未启用。 轻量场地与设备管理计划放入 health，不引入完整 ERP。 |
| [yudao-ui-admin-vue3/src/api/erp](../yudao-ui-admin-vue3/src/api/erp/目录说明.txt) | 进销存管理接口调用：封装进销存管理的后台请求。 | 源码保留，当前未启用。 API 源码存在并不表示后端模块已启用。 |
| [yudao-ui-admin-vue3/src/views/mall](../yudao-ui-admin-vue3/src/views/mall/目录说明.txt) | 商城业务集合页面：商品、营销、交易、分销和商城统计等模块。 | 源码保留，当前未启用。 当前没有商城需求；会员前端仍存在对商城、支付页面的引用，不能只删目录。 |
| [yudao-ui-admin-vue3/src/api/mall](../yudao-ui-admin-vue3/src/api/mall/目录说明.txt) | 商城业务集合接口调用：封装商城业务集合的后台请求。 | 源码保留，当前未启用。 API 源码存在并不表示后端模块已启用。 |
| [yudao-ui-admin-vue3/src/views/mp](../yudao-ui-admin-vue3/src/views/mp/目录说明.txt) | 微信公众号管理页面：公众号账号、粉丝、素材、消息、菜单和自动回复管理。 | 源码保留，当前未启用。 当前项目尚未采用该公众号管理能力。 |
| [yudao-ui-admin-vue3/src/api/mp](../yudao-ui-admin-vue3/src/api/mp/目录说明.txt) | 微信公众号管理接口调用：封装微信公众号管理的后台请求。 | 源码保留，当前未启用。 API 源码存在并不表示后端模块已启用。 |
| [yudao-ui-admin-vue3/src/views/pay](../yudao-ui-admin-vue3/src/views/pay/目录说明.txt) | 支付管理页面：支付应用、渠道、订单、退款、钱包及支付通知。 | 源码保留，当前未启用。 当前运动预约和志愿服务没有确定收费需求。 |
| [yudao-ui-admin-vue3/src/api/pay](../yudao-ui-admin-vue3/src/api/pay/目录说明.txt) | 支付管理接口调用：封装支付管理的后台请求。 | 源码保留，当前未启用。 API 源码存在并不表示后端模块已启用。 |
| [yudao-ui-admin-vue3/src/views/report](../yudao-ui-admin-vue3/src/views/report/目录说明.txt) | 报表与大屏设计器页面：集成报表设计与可视化大屏设计器。 | 源码保留，当前未启用。 后续中控和健康统计可以先在业务前端直接实现。 |
| [yudao-ui-admin-vue3/src/api/report](../yudao-ui-admin-vue3/src/api/report/目录说明.txt) | 报表与大屏设计器接口调用：封装报表与大屏设计器的后台请求。 | 源码保留，当前未启用。 API 源码存在并不表示后端模块已启用。 |
| [yudao-ui-admin-vue3/src/views/Error](../yudao-ui-admin-vue3/src/views/Error/目录说明.txt) | 异常页面：显示无权限、页面不存在和服务异常等状态。 | 公共页面。 |
| [yudao-ui-admin-vue3/src/views/Home](../yudao-ui-admin-vue3/src/views/Home/目录说明.txt) | 首页工作台页面：当前展示实际可访问模块和常用入口，不使用模板演示统计。 | 已启用。 |
| [yudao-ui-admin-vue3/src/views/Login](../yudao-ui-admin-vue3/src/views/Login/目录说明.txt) | 登录页面：当前主登录页已适配健康服务品牌；其余登录组件暂保留。 | 账号密码登录已验证。 |
| [yudao-ui-admin-vue3/src/views/Profile](../yudao-ui-admin-vue3/src/views/Profile/目录说明.txt) | 当前用户个人中心页面：管理当前后台账号的个人资料、头像和密码。 | 公共页面。 |
| [yudao-ui-admin-vue3/src/views/Redirect](../yudao-ui-admin-vue3/src/views/Redirect/目录说明.txt) | 页面重定向页面：辅助页面刷新和路由跳转。 | 公共基础页面。 |
| [yudao-ui-admin-vue3/src/api/login](../yudao-ui-admin-vue3/src/api/login/目录说明.txt) | 认证接口接口调用：封装认证接口的后台请求。 | 已使用。 API 源码存在并不表示后端模块已启用。 |
| [yudao-ui-admin-vue3/src/assets/brand](../yudao-ui-admin-vue3/src/assets/brand/README.md) | 健康服务品牌资源：平台 SVG 标识、Olive 登录背景和本地图标集合；已有 README.md 记录来源。 |  |
| [yudao-ui-admin-vue3/src/assets/imgs](../yudao-ui-admin-vue3/src/assets/imgs/目录说明.txt) | 通用与模板图片：保存头像、插图等原模板静态图片。 |  |
| [yudao-ui-admin-vue3/src/assets/map](../yudao-ui-admin-vue3/src/assets/map/目录说明.txt) | 地图资源：地图边界或相关数据资源。 |  |
| [yudao-ui-admin-vue3/src/assets/svgs](../yudao-ui-admin-vue3/src/assets/svgs/目录说明.txt) | SVG 图标资源：供 SVG 图标插件扫描与打包的图形资源。 |  |
| [yudao-ui-admin-vue3/src/plugins/animate.css](../yudao-ui-admin-vue3/src/plugins/animate.css/目录说明.txt) | 动画样式：初始化界面动画样式。 |  |
| [yudao-ui-admin-vue3/src/plugins/echarts](../yudao-ui-admin-vue3/src/plugins/echarts/目录说明.txt) | ECharts 图表：初始化图表能力，后续健康统计可以复用。 |  |
| [yudao-ui-admin-vue3/src/plugins/elementPlus](../yudao-ui-admin-vue3/src/plugins/elementPlus/目录说明.txt) | Element Plus：初始化管理端 UI 组件库。 |  |
| [yudao-ui-admin-vue3/src/plugins/formCreate](../yudao-ui-admin-vue3/src/plugins/formCreate/目录说明.txt) | 动态表单：初始化 form-create，供表单构建和相关页面使用。 |  |
| [yudao-ui-admin-vue3/src/plugins/productIcons](../yudao-ui-admin-vue3/src/plugins/productIcons/目录说明.txt) | 本地管理图标：注册当前管理端图标，降低对在线图标服务的依赖。 |  |
| [yudao-ui-admin-vue3/src/plugins/svgIcon](../yudao-ui-admin-vue3/src/plugins/svgIcon/目录说明.txt) | SVG 图标初始化：注册本地 SVG 资源。 |  |
| [yudao-ui-admin-vue3/src/plugins/tongji](../yudao-ui-admin-vue3/src/plugins/tongji/目录说明.txt) | 外部统计插件：模板百度统计初始化；当前统计标识为空，不发送统计数据。 |  |
| [yudao-ui-admin-vue3/src/plugins/unocss](../yudao-ui-admin-vue3/src/plugins/unocss/目录说明.txt) | UnoCSS 样式：加载原子样式系统。 |  |
| [yudao-ui-admin-vue3/src/plugins/vueI18n](../yudao-ui-admin-vue3/src/plugins/vueI18n/目录说明.txt) | 多语言初始化：配置国际化语言与文案加载。 |  |
| [yudao-ui-admin-vue3/src/layout/components](../yudao-ui-admin-vue3/src/layout/components/目录说明.txt) | 布局组成组件：导航、侧栏、用户菜单和标签页等布局组件。 |  |
| [yudao-ui-admin-vue3/src/config/axios](../yudao-ui-admin-vue3/src/config/axios/目录说明.txt) | HTTP 请求配置：配置请求地址、超时、认证、租户和响应处理。 |  |
| [yudao-ui-admin-vue3/src/directives/permission](../yudao-ui-admin-vue3/src/directives/permission/目录说明.txt) | 界面按钮权限：按照当前账号权限控制按钮等元素的显示。 | 界面隐藏不能替代后端接口鉴权。 |
| [yudao-ui-admin-vue3/src/hooks/web](../yudao-ui-admin-vue3/src/hooks/web/目录说明.txt) | Web 组合式逻辑：封装消息、表格、缓存、国际化、主题等管理端通用逻辑。 |  |
| [yudao-ui-admin-vue3/src/store/modules](../yudao-ui-admin-vue3/src/store/modules/目录说明.txt) | Pinia 状态模块：按 app、user、permission、tagsView 等主题保存状态。 |  |
| [yudao-ui-admin-vue3/src/router/modules](../yudao-ui-admin-vue3/src/router/modules/目录说明.txt) | 固定路由集合：remaining.ts 包含固定页面及模板保留路由。 | 一些未启用模块仍有静态路由引用，暂时保留。 |

## 前端公共组件与布局

| 目录 | 用途 | 状态／迁移定位 |
| --- | --- | --- |
| [yudao-ui-admin-vue3/src/components/AppLinkInput](../yudao-ui-admin-vue3/src/components/AppLinkInput/目录说明.txt) | 应用链接选择：模板应用链接输入与选择，包含商城页面引用。 |  |
| [yudao-ui-admin-vue3/src/components/Backtop](../yudao-ui-admin-vue3/src/components/Backtop/目录说明.txt) | 返回顶部：提供页面返回顶部按钮。 |  |
| [yudao-ui-admin-vue3/src/components/bpmnProcessDesigner](../yudao-ui-admin-vue3/src/components/bpmnProcessDesigner/目录说明.txt) | BPMN 流程设计器：模板工作流设计相关组件，当前业务未启用。 |  |
| [yudao-ui-admin-vue3/src/components/Card](../yudao-ui-admin-vue3/src/components/Card/目录说明.txt) | 卡片组件：通用卡片显示封装。 |  |
| [yudao-ui-admin-vue3/src/components/ColorInput](../yudao-ui-admin-vue3/src/components/ColorInput/目录说明.txt) | 颜色输入：颜色选择输入组件。 |  |
| [yudao-ui-admin-vue3/src/components/ConfigGlobal](../yudao-ui-admin-vue3/src/components/ConfigGlobal/目录说明.txt) | 全局 UI 设置：统一 UI 尺寸等组件配置。 |  |
| [yudao-ui-admin-vue3/src/components/ContentDetailWrap](../yudao-ui-admin-vue3/src/components/ContentDetailWrap/目录说明.txt) | 详情内容容器：统一详情页面外层结构。 |  |
| [yudao-ui-admin-vue3/src/components/ContentWrap](../yudao-ui-admin-vue3/src/components/ContentWrap/目录说明.txt) | 内容容器：统一列表、表单等页面的内容外框。 |  |
| [yudao-ui-admin-vue3/src/components/CountTo](../yudao-ui-admin-vue3/src/components/CountTo/目录说明.txt) | 数字动画：展示数字变化动画。 |  |
| [yudao-ui-admin-vue3/src/components/Crontab](../yudao-ui-admin-vue3/src/components/Crontab/目录说明.txt) | 定时表达式编辑：辅助编辑 cron 任务执行时间。 |  |
| [yudao-ui-admin-vue3/src/components/Cropper](../yudao-ui-admin-vue3/src/components/Cropper/目录说明.txt) | 图片裁剪：头像和图片裁剪上传。 |  |
| [yudao-ui-admin-vue3/src/components/Descriptions](../yudao-ui-admin-vue3/src/components/Descriptions/目录说明.txt) | 详情字段展示：按标签和值展示详情数据。 |  |
| [yudao-ui-admin-vue3/src/components/Dialog](../yudao-ui-admin-vue3/src/components/Dialog/目录说明.txt) | 弹窗：统一对话框尺寸、标题和内容区域。 |  |
| [yudao-ui-admin-vue3/src/components/DictTag](../yudao-ui-admin-vue3/src/components/DictTag/目录说明.txt) | 字典标签：将字典值显示为名称或标签。 |  |
| [yudao-ui-admin-vue3/src/components/DiyEditor](../yudao-ui-admin-vue3/src/components/DiyEditor/目录说明.txt) | 商城装修设计器：模板商城页面装修与组件配置，当前业务未启用。 |  |
| [yudao-ui-admin-vue3/src/components/DocAlert](../yudao-ui-admin-vue3/src/components/DocAlert/目录说明.txt) | 模板文档提示：显示模板开发文档提示；当前环境关闭此提示。 |  |
| [yudao-ui-admin-vue3/src/components/Draggable](../yudao-ui-admin-vue3/src/components/Draggable/目录说明.txt) | 拖拽容器：提供拖拽排序等交互；源码包含对 DiyEditor 的引用。 |  |
| [yudao-ui-admin-vue3/src/components/Echart](../yudao-ui-admin-vue3/src/components/Echart/目录说明.txt) | 图表封装：供统计页面渲染 ECharts 图表。 |  |
| [yudao-ui-admin-vue3/src/components/Editor](../yudao-ui-admin-vue3/src/components/Editor/目录说明.txt) | 富文本编辑器：用于公告、模板内容等富文本输入。 |  |
| [yudao-ui-admin-vue3/src/components/Error](../yudao-ui-admin-vue3/src/components/Error/目录说明.txt) | 异常内容组件：提供错误状态展示。 |  |
| [yudao-ui-admin-vue3/src/components/Form](../yudao-ui-admin-vue3/src/components/Form/目录说明.txt) | 表单封装：根据表单 schema 构建输入和校验。 |  |
| [yudao-ui-admin-vue3/src/components/Highlight](../yudao-ui-admin-vue3/src/components/Highlight/目录说明.txt) | 代码高亮：显示代码或文本高亮内容。 |  |
| [yudao-ui-admin-vue3/src/components/Icon](../yudao-ui-admin-vue3/src/components/Icon/目录说明.txt) | 图标：统一显示本地图标和 Iconify 图标。 |  |
| [yudao-ui-admin-vue3/src/components/IFrame](../yudao-ui-admin-vue3/src/components/IFrame/目录说明.txt) | 内嵌页面：用 iframe 展示接口文档、监控和设计器等页面。 |  |
| [yudao-ui-admin-vue3/src/components/ImageViewer](../yudao-ui-admin-vue3/src/components/ImageViewer/目录说明.txt) | 图片预览：展示图片放大预览。 |  |
| [yudao-ui-admin-vue3/src/components/Infotip](../yudao-ui-admin-vue3/src/components/Infotip/目录说明.txt) | 信息提示：提供说明和提示展示。 |  |
| [yudao-ui-admin-vue3/src/components/InputPassword](../yudao-ui-admin-vue3/src/components/InputPassword/目录说明.txt) | 密码输入：密码输入及相关交互。 |  |
| [yudao-ui-admin-vue3/src/components/InputWithColor](../yudao-ui-admin-vue3/src/components/InputWithColor/目录说明.txt) | 带颜色的输入：组合文字输入与颜色选择。 |  |
| [yudao-ui-admin-vue3/src/components/MagicCubeEditor](../yudao-ui-admin-vue3/src/components/MagicCubeEditor/目录说明.txt) | 图片布局编辑：模板装修中的图片组合布局编辑。 |  |
| [yudao-ui-admin-vue3/src/components/OperateLogV2](../yudao-ui-admin-vue3/src/components/OperateLogV2/目录说明.txt) | 操作日志展示：显示对象相关的操作记录。 |  |
| [yudao-ui-admin-vue3/src/components/Pagination](../yudao-ui-admin-vue3/src/components/Pagination/目录说明.txt) | 分页：管理列表的分页控件。 |  |
| [yudao-ui-admin-vue3/src/components/Qrcode](../yudao-ui-admin-vue3/src/components/Qrcode/目录说明.txt) | 二维码：生成和展示二维码。 |  |
| [yudao-ui-admin-vue3/src/components/RouterSearch](../yudao-ui-admin-vue3/src/components/RouterSearch/目录说明.txt) | 菜单搜索：搜索并跳转到可访问路由。 |  |
| [yudao-ui-admin-vue3/src/components/Search](../yudao-ui-admin-vue3/src/components/Search/目录说明.txt) | 查询表单：通用列表查询条件区域。 |  |
| [yudao-ui-admin-vue3/src/components/ShortcutDateRangePicker](../yudao-ui-admin-vue3/src/components/ShortcutDateRangePicker/目录说明.txt) | 日期范围选择：提供常用日期范围快捷选择。 |  |
| [yudao-ui-admin-vue3/src/components/Sticky](../yudao-ui-admin-vue3/src/components/Sticky/目录说明.txt) | 吸顶容器：保持内容在滚动时固定显示。 |  |
| [yudao-ui-admin-vue3/src/components/SummaryCard](../yudao-ui-admin-vue3/src/components/SummaryCard/目录说明.txt) | 汇总卡片：展示数量、金额等统计摘要。 |  |
| [yudao-ui-admin-vue3/src/components/Table](../yudao-ui-admin-vue3/src/components/Table/目录说明.txt) | 表格封装：统一表格列、数据展示和交互。 |  |
| [yudao-ui-admin-vue3/src/components/Tooltip](../yudao-ui-admin-vue3/src/components/Tooltip/目录说明.txt) | 悬浮提示：鼠标悬浮时展示补充信息。 |  |
| [yudao-ui-admin-vue3/src/components/UploadFile](../yudao-ui-admin-vue3/src/components/UploadFile/目录说明.txt) | 文件上传：提供文件上传和相关展示。 |  |
| [yudao-ui-admin-vue3/src/components/Verifition](../yudao-ui-admin-vue3/src/components/Verifition/目录说明.txt) | 验证码：滑块等验证码组件；目录拼写沿用现有源码。 |  |
| [yudao-ui-admin-vue3/src/components/VerticalButtonGroup](../yudao-ui-admin-vue3/src/components/VerticalButtonGroup/目录说明.txt) | 竖向按钮组：排列纵向操作按钮。 |  |
| [yudao-ui-admin-vue3/src/components/XButton](../yudao-ui-admin-vue3/src/components/XButton/目录说明.txt) | 按钮封装：统一按钮、图标和加载状态。 |  |
| [yudao-ui-admin-vue3/src/layout/components/Breadcrumb](../yudao-ui-admin-vue3/src/layout/components/Breadcrumb/目录说明.txt) | Breadcrumb 布局组件：显示当前页面所在的菜单层级。 |  |
| [yudao-ui-admin-vue3/src/layout/components/Collapse](../yudao-ui-admin-vue3/src/layout/components/Collapse/目录说明.txt) | Collapse 布局组件：折叠或展开侧栏。 |  |
| [yudao-ui-admin-vue3/src/layout/components/ContextMenu](../yudao-ui-admin-vue3/src/layout/components/ContextMenu/目录说明.txt) | ContextMenu 布局组件：提供标签等区域的右键操作。 |  |
| [yudao-ui-admin-vue3/src/layout/components/Footer](../yudao-ui-admin-vue3/src/layout/components/Footer/目录说明.txt) | Footer 布局组件：显示平台页脚。 |  |
| [yudao-ui-admin-vue3/src/layout/components/LocaleDropdown](../yudao-ui-admin-vue3/src/layout/components/LocaleDropdown/目录说明.txt) | LocaleDropdown 布局组件：切换界面语言。 |  |
| [yudao-ui-admin-vue3/src/layout/components/Logo](../yudao-ui-admin-vue3/src/layout/components/Logo/目录说明.txt) | Logo 布局组件：显示平台名称与健康标识。 |  |
| [yudao-ui-admin-vue3/src/layout/components/Menu](../yudao-ui-admin-vue3/src/layout/components/Menu/目录说明.txt) | Menu 布局组件：渲染当前账号可访问菜单。 |  |
| [yudao-ui-admin-vue3/src/layout/components/Message](../yudao-ui-admin-vue3/src/layout/components/Message/目录说明.txt) | Message 布局组件：展示站内消息。 |  |
| [yudao-ui-admin-vue3/src/layout/components/Screenfull](../yudao-ui-admin-vue3/src/layout/components/Screenfull/目录说明.txt) | Screenfull 布局组件：切换全屏。 |  |
| [yudao-ui-admin-vue3/src/layout/components/Setting](../yudao-ui-admin-vue3/src/layout/components/Setting/目录说明.txt) | Setting 布局组件：调整布局和主题。 |  |
| [yudao-ui-admin-vue3/src/layout/components/SizeDropdown](../yudao-ui-admin-vue3/src/layout/components/SizeDropdown/目录说明.txt) | SizeDropdown 布局组件：切换 UI 控件尺寸。 |  |
| [yudao-ui-admin-vue3/src/layout/components/TabMenu](../yudao-ui-admin-vue3/src/layout/components/TabMenu/目录说明.txt) | TabMenu 布局组件：分栏布局中的菜单。 |  |
| [yudao-ui-admin-vue3/src/layout/components/TagsView](../yudao-ui-admin-vue3/src/layout/components/TagsView/目录说明.txt) | TagsView 布局组件：管理已打开页面标签。 |  |
| [yudao-ui-admin-vue3/src/layout/components/ThemeSwitch](../yudao-ui-admin-vue3/src/layout/components/ThemeSwitch/目录说明.txt) | ThemeSwitch 布局组件：切换明暗主题。 |  |
| [yudao-ui-admin-vue3/src/layout/components/UserInfo](../yudao-ui-admin-vue3/src/layout/components/UserInfo/目录说明.txt) | UserInfo 布局组件：显示当前账号、个人中心、锁屏与退出操作。 |  |

## 工具、缓存与生成目录

以下目录不插入说明文件，避免影响工具内部数据或生成结果；说明统一保存在这里。

| 目录 | 用途 |
| --- | --- |
| `.git` | Git 版本库内部数据；由 Git 管理。 |
| `.idea` | IDEA 工程设置、数据源和工作区状态；由 IDE 管理。 |
| `deploy/local/.runtime` | 日志、验证截图和历史前端缓存；不放长期维护的业务源码。 |
| `yudao-ui-admin-vue3/node_modules` | 前端安装依赖；由 pnpm 管理，可重新安装。 |
| `yudao-ui-admin-vue3/dist` | 前端构建输出；由 Vite 生成。 |
| `yudao-ui-admin-vue3/.image` | 原前端模板文档截图；不参与业务运行。 |
| `各 Maven 模块的 target` | Java 编译和打包输出；由 Maven 生成。 |

当前部署和启动方式见 [系统管理后台本地部署](系统管理后台本地部署.md)，界面适配见 [管理端界面定制](管理端界面定制.md)，旧业务细节见 [芋道框架迁移上下文](芋道框架迁移上下文.md)。