Merge pull request 'axr' (#1) from axr into main

Reviewed-on: #1
2026-10-05 22:56:41 +08:00 · 2026-10-05 22:56:41 +08:00 · 12ad34e0c5
commit 12ad34e0c5
parent b330305c85 f619802853
1497 changed files with 155002 additions and 14 deletions
--- a/.gitignore
+++ b/.gitignore
@ -65,3 +65,9 @@ rebel.xml
 application-my.yaml

 /yudao-ui-app/unpackage/
+
+# Local deployment credentials and runtime files
+/deploy/local/secrets.psd1
+/deploy/local/.runtime/
+/.run/ElderYudaoLocal.run.xml
+/yudao-server/src/main/resources/application-desktop.yaml
--- a/.run/ElderYudaoFrontend.run.xml
+++ b/.run/ElderYudaoFrontend.run.xml
@ -0,0 +1,5 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="ElderYudao Frontend" type="NodeJSConfigurationType" factoryName="Node.js" path-to-node="E:/BiSh/NodeJS/node.exe" path-to-js-file="$PROJECT_DIR$/yudao-ui-admin-vue3/node_modules/vite/bin/vite.js" working-dir="$PROJECT_DIR$/yudao-ui-admin-vue3" application-parameters="--mode desktop --host 127.0.0.1 --port 5173 --strictPort">
+    <method v="2" />
+  </configuration>
+</component>
--- a/.run/目录说明.txt
+++ b/.run/目录说明.txt
@ -0,0 +1,9 @@
+IDEA 启动配置
+
+目录：.run
+用途：保存后端和前端启动项，供 IDEA 顶部运行配置列表使用。
+当前状态：前端启动项已指向 yudao-ui-admin-vue3。
+迁移与维护：维护 *.run.xml；本目录名称保持不变。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/README.md
+++ b/README.md
@ -1,12 +1,5 @@
 # elder-yudao

-**严正声明：本项目只为了给在校学生和刚刚步入社会又囊中羞涩的年轻人提供一种选择，同时也为了打击中国式伪开源贡献一份力量。**
-
-**如果哪一天芋芋撕掉遮羞布，不割年轻人韭菜，一定不是良心发现或者钱赚够了，只是因为我来过。**
-
-### 不需要199
-### 不需要star
-### 没有遮羞布


 文档验证码: jiankan
@ -21,7 +14,6 @@ Cloud 文档验证码：https://cloud.iocoder.cn/?code=p70
 - 打开浏览器控制台，点击查看器，替换知识星球的首页地址为：https://doc.iocoder.cn/?code=p70
 - 再点击浏览器上面的链接，其原理是伪造Refer源

-![123.png](image%2F123.png)

 ## 模块

@ -42,11 +34,9 @@ Cloud 文档验证码：https://cloud.iocoder.cn/?code=p70
 | `yudao-module-report` | 大屏报表 Module 模块     |


-> 白天正常上班写代码，晚上有时间就同步文档(无遮羞布)。
-> 
-> 在这里跟原作者道个歉，年轻人真的比容易，还望刀下留情，韭菜割的差不多就得了。

 ## 项目文档

 - [文档目录](docs/README.md)
+- [系统管理后台本地部署](docs/系统管理后台本地部署.md)
 - [老年健康系统迁移上下文](docs/芋道框架迁移上下文.md)
--- a/deploy/local/check.ps1
+++ b/deploy/local/check.ps1
@ -0,0 +1,22 @@
+param([string]$SecretsFile = (Join-Path $PSScriptRoot 'secrets.psd1'))
+. (Join-Path $PSScriptRoot 'common.ps1')
+$settings = Read-LocalSettings $SecretsFile
+$origin = "http://127.0.0.1:$($settings.ServerPort)"
+$health = Invoke-RestMethod -Uri "$origin/actuator/health" -TimeoutSec 10
+if ($health.status -ne 'UP') { throw 'Health check is not UP.' }
+$docs = Invoke-WebRequest -Uri "$origin/doc.html" -UseBasicParsing -TimeoutSec 10
+if ($docs.StatusCode -ne 200) { throw 'API documentation is unavailable.' }
+$login = Invoke-RestMethod -Uri "$origin/admin-api/system/auth/login" -Method Post -Headers @{ 'tenant-id' = '1' } `
+    -ContentType 'application/json' -Body '{"username":"admin","password":"admin123"}' -TimeoutSec 15
+if ($login.code -ne 0) { throw "Seed administrator login failed: $($login.msg)" }
+$headers = @{ 'tenant-id' = '1'; Authorization = ('Bearer ' + $login.data.accessToken) }
+try {
+    $permission = Invoke-RestMethod -Uri "$origin/admin-api/system/auth/get-permission-info" -Headers $headers -TimeoutSec 15
+    if ($permission.code -ne 0) { throw "Permission API failed: $($permission.msg)" }
+    $users = Invoke-RestMethod -Uri "$origin/admin-api/system/user/page?pageNo=1&pageSize=10" -Headers $headers -TimeoutSec 15
+    if ($users.code -ne 0) { throw "User list API failed: $($users.msg)" }
+    Write-Output "Health UP; API docs HTTP 200; login and permission APIs passed; user list total=$($users.data.total)."
+} finally {
+    $logout = Invoke-RestMethod -Uri "$origin/admin-api/system/auth/logout" -Method Post -Headers $headers -TimeoutSec 15
+    if ($logout.code -ne 0) { throw 'Logout failed.' }
+}
--- a/deploy/local/common.ps1
+++ b/deploy/local/common.ps1
@ -0,0 +1,77 @@
+$ErrorActionPreference = 'Stop'
+$repoPath = (Resolve-Path (Join-Path $PSScriptRoot '../..')).Path
+$runtimePath = Join-Path $PSScriptRoot '.runtime'
+
+function Read-LocalSettings {
+    param([string]$Path = (Join-Path $PSScriptRoot 'secrets.psd1'))
+    if (-not (Test-Path -LiteralPath $Path)) {
+        throw 'Copy secrets.example.psd1 to secrets.psd1 and fill in the local database password first.'
+    }
+    $settings = Import-PowerShellDataFile -LiteralPath $Path
+    if ($settings.DatabaseName -notmatch '^elder_yudao_[a-z0-9_]+$') {
+        throw 'Use a separate database named elder_yudao_*; existing application databases are not supported by this initializer.'
+    }
+    return $settings
+}
+
+function Resolve-LocalProgram {
+    param([string]$ConfiguredPath, [string]$CommandName, [string]$FallbackPath = '')
+    if ($ConfiguredPath) {
+        if (-not (Test-Path -LiteralPath $ConfiguredPath -PathType Leaf)) { throw "Program not found: $ConfiguredPath" }
+        return (Resolve-Path -LiteralPath $ConfiguredPath).Path
+    }
+    $program = Get-Command $CommandName -ErrorAction SilentlyContinue
+    if ($program) { return $program.Source }
+    if ($FallbackPath -and (Test-Path -LiteralPath $FallbackPath)) { return $FallbackPath }
+    throw "Program not found: $CommandName. Install it or set its path in secrets.psd1."
+}
+
+function Invoke-LocalMySql {
+    param([hashtable]$Settings, [string]$Query, [string]$Database = '')
+    $mysqlExe = Resolve-LocalProgram $Settings.MySqlExe 'mysql.exe' 'C:\Program Files\MySQL\MySQL Server 8.0\bin\mysql.exe'
+    $arguments = @('--protocol=TCP', "--host=$($Settings.DatabaseHost)", "--port=$($Settings.DatabasePort)",
+        "--user=$($Settings.DatabaseUser)", '--connect-timeout=5', '--default-character-set=utf8mb4', '--batch', '--skip-column-names')
+    if ($Database) { $arguments += "--database=$Database" }
+    $arguments += "--execute=$Query"
+    $previousPassword = $env:MYSQL_PWD
+    try {
+        $env:MYSQL_PWD = $Settings.DatabasePassword
+        $result = @(& $mysqlExe @arguments)
+        if ($LASTEXITCODE -ne 0) { throw 'MySQL command failed; see the error above. No password is printed by this script.' }
+        return $result
+    } finally {
+        if ($null -eq $previousPassword) { Remove-Item Env:\MYSQL_PWD -ErrorAction SilentlyContinue }
+        else { $env:MYSQL_PWD = $previousPassword }
+    }
+}
+
+function Get-LocalServerProcess {
+    $pidFile = Join-Path $runtimePath 'server.pid'
+    if (-not (Test-Path -LiteralPath $pidFile)) { return $null }
+    $serverPid = 0
+    if (-not [int]::TryParse((Get-Content -LiteralPath $pidFile -Raw).Trim(), [ref]$serverPid)) {
+        throw 'Invalid server.pid; inspect the runtime directory before continuing.'
+    }
+    $process = Get-CimInstance Win32_Process -Filter "ProcessId=$serverPid" -ErrorAction SilentlyContinue
+    if (-not $process) { return $null }
+    $jarPath = Join-Path $repoPath 'yudao-server/target/yudao-server.jar'
+    if ($process.Name -notmatch '^java(w)?\.exe$' -or -not $process.CommandLine.Contains($jarPath)) {
+        throw 'The recorded PID belongs to another process; refusing to operate on it.'
+    }
+    return $process
+}
+
+function Get-LocalUiProcess {
+    $pidFile = Join-Path $runtimePath 'ui.pid'
+    if (-not (Test-Path -LiteralPath $pidFile)) { return $null }
+    $uiPid = 0
+    if (-not [int]::TryParse((Get-Content -LiteralPath $pidFile -Raw).Trim(), [ref]$uiPid)) { throw 'Invalid ui.pid.' }
+    $process = Get-CimInstance Win32_Process -Filter "ProcessId=$uiPid" -ErrorAction SilentlyContinue
+    if (-not $process) { return $null }
+    $vitePaths = @((Join-Path $repoPath 'yudao-ui-admin-vue3/node_modules/vite/bin/vite.js'), (Join-Path $runtimePath 'ui-src/node_modules/vite/bin/vite.js'))
+    $matchesUiPath = @($vitePaths | Where-Object { $process.CommandLine.Contains($_) }).Count -gt 0
+    if ($process.Name -ne 'node.exe' -or -not $matchesUiPath) {
+        throw 'The recorded UI PID belongs to another process; refusing to operate on it.'
+    }
+    return $process
+}
--- a/deploy/local/initialize.ps1
+++ b/deploy/local/initialize.ps1
@ -0,0 +1,24 @@
+param([string]$SecretsFile = (Join-Path $PSScriptRoot 'secrets.psd1'))
+. (Join-Path $PSScriptRoot 'common.ps1')
+$settings = Read-LocalSettings $SecretsFile
+$databaseName = $settings.DatabaseName
+$schemaExists = [int]@(Invoke-LocalMySql $settings "SELECT COUNT(*) FROM information_schema.SCHEMATA WHERE SCHEMA_NAME='$databaseName';")[0]
+if ($schemaExists -eq 0) {
+    Invoke-LocalMySql $settings "CREATE DATABASE ``$databaseName`` CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;" | Out-Null
+}
+$tableCount = [int]@(Invoke-LocalMySql $settings "SELECT COUNT(*) FROM information_schema.TABLES WHERE TABLE_SCHEMA='$databaseName';")[0]
+if ($tableCount -gt 0) {
+    throw "Database $databaseName already has $tableCount tables. Initialization is skipped to preserve existing data; run start.ps1 if it is already initialized."
+}
+$sqlPath = Join-Path $repoPath 'mysql_script/ruoyi-vue-pro.sql'
+$sql = Get-Content -LiteralPath $sqlPath -Raw -Encoding UTF8
+if ($sql -match '(?im)^\s*(USE\s|CREATE\s+DATABASE\s|DROP\s+DATABASE\s)') {
+    throw 'The seed script changes the target database; review it before importing.'
+}
+$sourcePath = $sqlPath.Replace('\', '/')
+Invoke-LocalMySql $settings "SOURCE $sourcePath;" $databaseName | Out-Null
+# Use the seeded database file store instead of a demonstration cloud bucket.
+Invoke-LocalMySql $settings 'UPDATE infra_file_config SET master = (id = 4) WHERE deleted = 0;' $databaseName | Out-Null
+$tableCount = @(Invoke-LocalMySql $settings "SELECT COUNT(*) FROM information_schema.TABLES WHERE TABLE_SCHEMA='$databaseName';")[0]
+$adminCount = @(Invoke-LocalMySql $settings "SELECT COUNT(*) FROM system_users WHERE username='admin' AND deleted=0 AND tenant_id=1;" $databaseName)[0]
+Write-Output "Initialized $databaseName with $tableCount tables and $adminCount administrator account. Existing databases were not imported into."
--- a/deploy/local/prepare-idea.ps1
+++ b/deploy/local/prepare-idea.ps1
@ -0,0 +1,47 @@
+param([string]$SecretsFile = (Join-Path $PSScriptRoot 'secrets.psd1'))
+. (Join-Path $PSScriptRoot 'common.ps1')
+$settings = Read-LocalSettings $SecretsFile
+$runPath = Join-Path $repoPath '.run'
+New-Item -ItemType Directory -Path $runPath -Force | Out-Null
+
+# IDEA loads this private run configuration from the project's .run directory.
+# It contains local credentials and is excluded from Git.
+[xml]$document = '<component name="ProjectRunConfigurationManager"><configuration default="false" name="ElderYudao Local" type="SpringBootApplicationConfigurationType" factoryName="Spring Boot"><option name="ACTIVE_PROFILES" value="local,desktop" /><module name="yudao-server" /><option name="SPRING_BOOT_MAIN_CLASS" value="cn.iocoder.yudao.server.YudaoServerApplication" /><option name="WORKING_DIRECTORY" value="$PROJECT_DIR$" /><option name="VM_PARAMETERS" value="-Dfile.encoding=UTF-8" /><envs /><method v="2"><option name="Make" enabled="true" /></method></configuration></component>'
+$configuration = $document.component.configuration
+$environment = @{
+    ELDER_DB_HOST = [string]$settings.DatabaseHost
+    ELDER_DB_PORT = [string]$settings.DatabasePort
+    ELDER_DB_NAME = [string]$settings.DatabaseName
+    ELDER_DB_USER = [string]$settings.DatabaseUser
+    ELDER_DB_PASSWORD = [string]$settings.DatabasePassword
+    ELDER_REDIS_HOST = [string]$settings.RedisHost
+    ELDER_REDIS_PORT = [string]$settings.RedisPort
+    ELDER_REDIS_DATABASE = [string]$settings.RedisDatabase
+    ELDER_SERVER_PORT = [string]$settings.ServerPort
+    ELDER_LOG_FILE = Join-Path $runtimePath 'application.log'
+}
+if ($settings.RedisPassword) { $environment.SPRING_REDIS_PASSWORD = [string]$settings.RedisPassword }
+foreach ($key in ($environment.Keys | Sort-Object)) {
+    $entry = $document.CreateElement('env')
+    $entry.SetAttribute('name', $key)
+    $entry.SetAttribute('value', $environment[$key])
+    $configuration.SelectSingleNode('envs').AppendChild($entry) | Out-Null
+}
+if ($settings.JavaExe) {
+    $javaExe = Resolve-LocalProgram $settings.JavaExe 'java.exe'
+    $jdkPath = Split-Path (Split-Path $javaExe -Parent) -Parent
+    foreach ($option in @(@{ name = 'ALTERNATIVE_JRE_PATH'; value = $jdkPath }, @{ name = 'ALTERNATIVE_JRE_PATH_ENABLED'; value = 'true' })) {
+        $entry = $document.CreateElement('option')
+        $entry.SetAttribute('name', $option.name)
+        $entry.SetAttribute('value', $option.value)
+        $configuration.AppendChild($entry) | Out-Null
+    }
+}
+$writerSettings = New-Object System.Xml.XmlWriterSettings
+$writerSettings.Encoding = New-Object System.Text.UTF8Encoding($false)
+$writerSettings.Indent = $true
+$writerSettings.OmitXmlDeclaration = $true
+$writer = [System.Xml.XmlWriter]::Create((Join-Path $runPath 'ElderYudaoLocal.run.xml'), $writerSettings)
+try { $document.Save($writer) } finally { $writer.Dispose() }
+Write-Output 'IDEA configuration prepared: ElderYudao Local (profiles: local,desktop).'
+Write-Output 'Select it in IDEA and run YudaoServerApplication. Reopen the project if the configuration has not appeared.'
--- a/deploy/local/prepare-ui.ps1
+++ b/deploy/local/prepare-ui.ps1
@ -0,0 +1,11 @@
+. (Join-Path $PSScriptRoot 'common.ps1')
+$uiPath = Join-Path $repoPath 'yudao-ui-admin-vue3'
+if (-not (Test-Path -LiteralPath (Join-Path $uiPath 'package.json'))) {
+    throw 'The maintained frontend source is missing: yudao-ui-admin-vue3.'
+}
+Push-Location $uiPath
+try {
+    & npm.cmd exec --yes --package=pnpm@8.6.12 -- pnpm install --frozen-lockfile --reporter=append-only
+    if ($LASTEXITCODE -ne 0) { throw 'Frontend dependency installation failed.' }
+} finally { Pop-Location }
+Write-Output 'Frontend dependencies are prepared in yudao-ui-admin-vue3. Run start-ui.ps1 or the IDEA frontend configuration.'
--- a/deploy/local/secrets.example.psd1
+++ b/deploy/local/secrets.example.psd1
@ -0,0 +1,15 @@
+@{
+    DatabaseHost = '127.0.0.1'
+    DatabasePort = 3306
+    DatabaseName = 'elder_yudao_local'
+    DatabaseUser = 'root'
+    DatabasePassword = ''
+    RedisHost = '127.0.0.1'
+    RedisPort = 6379
+    RedisDatabase = 15
+    RedisPassword = ''
+    ServerPort = 48080
+    # Optional absolute paths; otherwise the programs are resolved from PATH.
+    JavaExe = ''
+    MySqlExe = ''
+}
--- a/deploy/local/start-ui.ps1
+++ b/deploy/local/start-ui.ps1
@ -0,0 +1,35 @@
+param([int]$Port = 5173, [string]$SecretsFile = (Join-Path $PSScriptRoot 'secrets.psd1'))
+. (Join-Path $PSScriptRoot 'common.ps1')
+$settings = Read-LocalSettings $SecretsFile
+$existing = Get-LocalUiProcess
+if ($existing) { throw "The UI is already running with PID $($existing.ProcessId)." }
+if (Get-NetTCPConnection -State Listen -LocalPort $Port -ErrorAction SilentlyContinue) { throw "Port $Port is already in use." }
+$uiPath = Join-Path $repoPath 'yudao-ui-admin-vue3'
+$vitePath = Join-Path $uiPath 'node_modules/vite/bin/vite.js'
+if (-not (Test-Path -LiteralPath $vitePath)) { throw 'Run prepare-ui.ps1 first.' }
+$nodeExe = Resolve-LocalProgram '' 'node.exe'
+$apiOrigin = "http://127.0.0.1:$($settings.ServerPort)"
+$uiEnv = @"
+NODE_ENV=development
+VITE_DEV=true
+VITE_PORT=$Port
+VITE_OPEN=false
+VITE_BASE_URL=$apiOrigin
+VITE_UPLOAD_TYPE=server
+VITE_UPLOAD_URL=$apiOrigin/admin-api/infra/file/upload
+VITE_API_BASEPATH=/dev-api
+VITE_API_URL=/admin-api
+VITE_BASE_PATH=/
+VITE_DROP_DEBUGGER=false
+VITE_DROP_CONSOLE=false
+VITE_SOURCEMAP=false
+VITE_APP_CAPTCHA_ENABLE=false
+VITE_APP_DOCALERT_ENABLE=false
+VITE_APP_BAIDU_CODE=
+"@
+[System.IO.File]::WriteAllText((Join-Path $uiPath '.env.desktop'), $uiEnv, (New-Object System.Text.UTF8Encoding($false)))
+$ui = Start-Process -FilePath $nodeExe -ArgumentList @(('"' + $vitePath + '"'), '--mode', 'desktop', '--host', '127.0.0.1', '--port', [string]$Port, '--strictPort') `
+    -WorkingDirectory $uiPath -WindowStyle Hidden -PassThru `
+    -RedirectStandardOutput (Join-Path $runtimePath 'ui-stdout.log') -RedirectStandardError (Join-Path $runtimePath 'ui-stderr.log')
+[System.IO.File]::WriteAllText((Join-Path $runtimePath 'ui.pid'), [string]$ui.Id)
+Write-Output "Started UI PID $($ui.Id): http://127.0.0.1:$Port"
--- a/deploy/local/start.ps1
+++ b/deploy/local/start.ps1
@ -0,0 +1,50 @@
+param([switch]$Build, [string]$SecretsFile = (Join-Path $PSScriptRoot 'secrets.psd1'))
+. (Join-Path $PSScriptRoot 'common.ps1')
+$settings = Read-LocalSettings $SecretsFile
+New-Item -ItemType Directory -Path $runtimePath -Force | Out-Null
+$existing = Get-LocalServerProcess
+if ($existing) { throw "The local server is already running with PID $($existing.ProcessId)." }
+$jarPath = Join-Path $repoPath 'yudao-server/target/yudao-server.jar'
+if ($Build -or -not (Test-Path -LiteralPath $jarPath)) {
+    Push-Location $repoPath
+    try {
+        & mvn -B -ntp -pl yudao-server -am package -DskipTests
+        if ($LASTEXITCODE -ne 0) { throw 'Maven build failed.' }
+    } finally { Pop-Location }
+}
+$listener = Get-NetTCPConnection -State Listen -LocalPort $settings.ServerPort -ErrorAction SilentlyContinue
+if ($listener) { throw "Port $($settings.ServerPort) is already in use. Set a different ServerPort in secrets.psd1." }
+Invoke-LocalMySql $settings 'SELECT 1 FROM system_users LIMIT 1;' $settings.DatabaseName | Out-Null
+$javaExe = Resolve-LocalProgram $settings.JavaExe 'java.exe'
+$environment = @{
+    ELDER_DB_HOST = [string]$settings.DatabaseHost
+    ELDER_DB_PORT = [string]$settings.DatabasePort
+    ELDER_DB_NAME = [string]$settings.DatabaseName
+    ELDER_DB_USER = [string]$settings.DatabaseUser
+    ELDER_DB_PASSWORD = [string]$settings.DatabasePassword
+    ELDER_REDIS_HOST = [string]$settings.RedisHost
+    ELDER_REDIS_PORT = [string]$settings.RedisPort
+    ELDER_REDIS_DATABASE = [string]$settings.RedisDatabase
+    SPRING_REDIS_PASSWORD = $(if ($settings.RedisPassword) { [string]$settings.RedisPassword } else { $null })
+    ELDER_SERVER_PORT = [string]$settings.ServerPort
+    ELDER_LOG_FILE = Join-Path $runtimePath 'application.log'
+}
+$previousEnvironment = @{}
+try {
+    foreach ($key in $environment.Keys) {
+        $previousEnvironment[$key] = [Environment]::GetEnvironmentVariable($key, 'Process')
+        if ($null -eq $environment[$key]) { Remove-Item -LiteralPath "Env:\$key" -ErrorAction SilentlyContinue }
+        else { [Environment]::SetEnvironmentVariable($key, $environment[$key], 'Process') }
+    }
+    $server = Start-Process -FilePath $javaExe -ArgumentList @('-Xms256m', '-Xmx1024m', '-Dfile.encoding=UTF-8', '-jar', ('"' + $jarPath + '"'), '--spring.profiles.active=local,desktop') `
+        -WorkingDirectory $repoPath -WindowStyle Hidden -PassThru `
+        -RedirectStandardOutput (Join-Path $runtimePath 'stdout.log') -RedirectStandardError (Join-Path $runtimePath 'stderr.log')
+} finally {
+    foreach ($key in $previousEnvironment.Keys) {
+        if ($null -eq $previousEnvironment[$key]) { Remove-Item -LiteralPath "Env:\$key" -ErrorAction SilentlyContinue }
+        else { [Environment]::SetEnvironmentVariable($key, $previousEnvironment[$key], 'Process') }
+    }
+}
+[System.IO.File]::WriteAllText((Join-Path $runtimePath 'server.pid'), [string]$server.Id)
+Write-Output "Started PID $($server.Id). API docs: http://127.0.0.1:$($settings.ServerPort)/doc.html"
+Write-Output "Check health at http://127.0.0.1:$($settings.ServerPort)/actuator/health and logs in $runtimePath."
--- a/deploy/local/stop-ui.ps1
+++ b/deploy/local/stop-ui.ps1
@ -0,0 +1,8 @@
+. (Join-Path $PSScriptRoot 'common.ps1')
+$ui = Get-LocalUiProcess
+if ($ui) {
+    Stop-Process -Id $ui.ProcessId
+    Write-Output "Stopped local UI PID $($ui.ProcessId)."
+} else { Write-Output 'The local UI is not running.' }
+$pidFile = Join-Path $runtimePath 'ui.pid'
+if (Test-Path -LiteralPath $pidFile) { Remove-Item -LiteralPath $pidFile }
--- a/deploy/local/stop.ps1
+++ b/deploy/local/stop.ps1
@ -0,0 +1,10 @@
+. (Join-Path $PSScriptRoot 'common.ps1')
+$server = Get-LocalServerProcess
+if ($server) {
+    Stop-Process -Id $server.ProcessId
+    Write-Output "Stopped local server PID $($server.ProcessId)."
+} else {
+    Write-Output 'The local server is not running.'
+}
+$pidFile = Join-Path $runtimePath 'server.pid'
+if (Test-Path -LiteralPath $pidFile) { Remove-Item -LiteralPath $pidFile }
--- a/deploy/local/目录说明.txt
+++ b/deploy/local/目录说明.txt
@ -0,0 +1,9 @@
+本机部署脚本
+
+目录：deploy/local
+用途：prepare-ui.ps1 安装前端依赖；start/stop/check 脚本管理本机服务；prepare-idea.ps1 生成后端 IDEA 启动配置。
+当前状态：运行日志和旧前端缓存放在 .runtime，已忽略；本地连接设置来自 secrets.psd1。
+迁移与维护：实际前端源码在 ../../yudao-ui-admin-vue3，.runtime/ui-src 是历史运行缓存。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/deploy/目录说明.txt
+++ b/deploy/目录说明.txt
@ -0,0 +1,12 @@
+部署与本地运行
+
+目录：deploy
+用途：保存环境初始化、依赖安装、启动、停止和检查脚本。
+当前状态：当前使用 deploy/local。
+迁移与维护：应用部署操作在这里维护，业务代码放在业务模块中。
+
+已备注子目录：
+local：本机部署脚本。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/docs/README.md
+++ b/docs/README.md
@ -1,5 +1,10 @@
 # 项目文档

+- [项目目录说明](项目目录说明.md)：各目录用途、当前启用状态和迁移定位；IDEA 中可直接阅读各目录的“目录说明.txt”。
+
+- [管理端界面定制](管理端界面定制.md)：Olive 视觉参考、前端源码目录、产品配置、菜单处理与验证结果。
+
+- [系统管理后台本地部署](系统管理后台本地部署.md)：系统管理后台的访问地址、环境、初始化与启动脚本、管理界面来源以及验证结果。
 - [芋道框架迁移上下文](芋道框架迁移上下文.md)：旧老年健康系统的技术栈、业务模块、数据结构、接口、评分与推荐规则，以及迁移到芋道的建议和已知缺口。

 该文档是 2026-10-05 对旧系统的分析快照。有关目标框架和实施方案的历史假设，应结合当前项目代码及后续确认的需求核实；文档中的任务示例不代表已经开始或完成迁移。
--- a/docs/管理端界面定制.md
+++ b/docs/管理端界面定制.md
@ -0,0 +1,42 @@
+# 管理端界面定制
+
+实施日期：2026-10-05。维护目录：`yudao-ui-admin-vue3/`，属于 `elder-yudao-pro` 仓库；分支 `axr`。`node_modules` 和构建产物忽略，源码、环境默认值、依赖锁和资源记录纳入版本管理。
+
+## Olive 参考与本项目适配
+
+参考 `projects/olive/Olive-Smart/ruoyi-vue-plus-master/ruoyi-ui` 的 `src/views/login.vue`、`src/views/index.vue`、`Sidebar/Logo.vue`、`assets/styles/variables.scss`。Olive 使用 Vue 2，本管理端使用 Vue 3，因此沿用视觉元素并在现有登录和权限流程上实现。
+
+| 元素 | 本项目实现 |
+| --- | --- |
+| 科技蓝背景 | 复用 Olive 的 `loginBack.png`，作为登录和工作台欢迎区背景 |
+| 登录面板 | 深蓝半透明面板、浅蓝强调边框；手机尺寸采用单列 |
+| 导航 | 深蓝侧栏 `#0e2254`、白色顶部导航、蓝色激活项 |
+| 首页 | 管理模块与常用入口宫格，使用当前账号可访问菜单 |
+| 标识与文案 | 老年健康服务平台；使用健康心形 SVG，浏览器标题、加载页、侧栏、页脚统一 |
+| 模板推广 | 清理登录教程／咨询块、用户菜单文档入口和演示首页；关闭页面文档提示和模板外部统计 |
+| 动态菜单 | 过滤模板作者／文档外链，默认展示当前已启用的系统管理与基础设施 |
+| 默认头像与昵称 | 默认模板管理员在导航／工作台／锁屏显示“平台管理员”和健康标识，自定义账号昵称仍显示真实值 |
+
+业务菜单、用户、部门、租户等数据库记录没有重命名或删除。管理数据页面仍展示后台真实数据，包括原来的演示账号和部门名称；若要清理这些演示数据，应单独执行数据迁移。后台 Java 包名、原始授权文件和来源记录保留。
+
+## 后续维护入口
+
+- 名称：`.env` 的 `VITE_APP_TITLE`。
+- 默认租户：`.env` 的 `VITE_APP_DEFAULT_TENANT_ID=1`。清空 ID 时显示“服务机构”输入框并按真实租户名称查询；不会通过关闭多租户绕过后台隔离。
+- 模块：`.env` 的 `VITE_APP_ENABLED_MODULES=system,infra`。后续实现老人业务时可加 `elder`；此过滤只负责展示，不替代接口鉴权。
+- 视觉资源：`src/assets/brand/`，资源说明见该目录的 `README.md`。
+- 布局主题：`src/store/modules/app.ts`、`src/styles/var.css`。主题缓存使用 `elderTheme`，避免旧模板主题覆盖新的默认配色。
+- 工作台：`src/views/Home/Index.vue`。无权限时显示空状态；不会展示尚未实现的预约、派单或摄像头功能数据。
+- IDEA：`.run/ElderYudaoFrontend.run.xml` 已指向新源码目录，启动方式保持 `ElderYudao Frontend`。
+- 启动脚本：`deploy/local/prepare-ui.ps1` 从仓库源码安装依赖，不再克隆模板；`start-ui.ps1` 从新目录启动。
+
+正在运行的旧缓存进程本次同步了界面改动，方便立即查看。今后的修改只在新源码目录进行；在 IDEA 停止旧前端并重新运行 `ElderYudao Frontend` 后使用新目录。
+
+## 验证记录
+
+- 改动文件 ESLint 检查通过。
+- Vite 完整构建通过，产物位于 `yudao-ui-admin-vue3/dist/`。原模板存在未启用商城模块导出缺失提示，以及表单设计器依赖的 `eval` 提示；不影响当前系统管理页面构建和运行。
+- Chrome 实际连接本机后台：空密码校验、错误密码提示、正确登录、首页、用户管理（9 条记录）均通过，无页面脚本错误。
+- 首页按账号权限展示 2 个已启用模块、8 个常用入口，无作者动态／开发文档／教程广告；用户下拉菜单无文档推广入口。
+- 390 像素手机宽度下登录和首页通过，当前管理模块图标在本地打包。
+- 原始 MIT 许可与图标资源许可来源保留；前台展示未使用 Olive 的林区名称、备案号或团队标志。
--- a/docs/系统管理后台本地部署.md
+++ b/docs/系统管理后台本地部署.md
@ -0,0 +1,127 @@
+# 系统管理后台本地部署
+
+实施日期：2026-10-05。项目目录：`C:\Users\Administrator\Desktop\projects\elder-yudao-pro`，分支：`axr`。
+
+本阶段运行现有芋道系统管理后台，包括用户、角色、菜单、部门、字典等功能。服务由 `yudao-server` 承载，依赖已启用的 `yudao-module-system` 和 `yudao-module-infra`；其他业务模块暂未启用，老年健康业务尚未迁移。本次部署在本机运行。
+
+## 当前访问方式
+
+| 内容 | 地址或配置 |
+| --- | --- |
+| Vue 3 管理界面 | http://127.0.0.1:5173 |
+| 后端接口文档 | http://127.0.0.1:48080/doc.html |
+| 健康检查 | http://127.0.0.1:48080/actuator/health |
+| 登录租户 | 管理端默认使用 `tenant-id: 1`，无需填写原模板租户名 |
+| 初始化管理员 | `admin` / `admin123` |
+| MySQL 独立数据库 | `elder_yudao_local`，`127.0.0.1:3306` |
+| Redis | `127.0.0.1:6379`，15 号库 |
+
+前后端只监听 `127.0.0.1`。启动的是本地开发环境，验证码关闭、模拟登录关闭、Quartz 暂停，Actuator 只开放 `health` 和 `info`，Druid 控制台关闭。
+
+## 环境与本次修复
+
+- 本机使用 Java 11.0.12、Maven 3.9.12、MySQL 8.0.44 和现有 Redis 服务。源码目标版本仍为 Java 8，Spring Boot 仍为 2.7.18。
+- 补回根目录 `lombok.config`。模板调用链式 setter，需要 `lombok.accessors.chain=true`；缺失时 `ApiAccessLogFilter` 等源码无法编译。
+- 新增 `application-desktop.yaml`，叠加在 `local` 配置之后。数据库连接、日志路径和端口通过环境变量传入。
+- 私有连接配置位于 `deploy/local/secrets.psd1`，已加入 Git 忽略规则。当前使用本机已有的数据库连接信息，不在本文记录数据库密码。
+- 初始化脚本只允许 `elder_yudao_*` 独立库，且拒绝向非空库重复导入。种子文件为 `mysql_script/ruoyi-vue-pro.sql`，已导入 61 张表，默认文件存储改为数据库存储。
+
+现有 MySQL 服务内其他数据库和 Redis 0 号库未清空或导入数据。
+
+## 后续启动与停止
+
+在项目根目录打开 PowerShell。
+
+启动后端、检查登录和基础接口、启动界面：
+
+```powershell
+.\deploy\local\start.ps1
+.\deploy\local\check.ps1
+.\deploy\local\start-ui.ps1
+```
+
+后端启动通常需要约 30 秒。健康检查返回 `UP` 后访问管理界面。若刚修改后端源码或配置，先停止服务，再重新构建启动：
+
+```powershell
+.\deploy\local\stop.ps1
+.\deploy\local\start.ps1 -Build
+```
+
+分别停止界面和后端：
+
+```powershell
+.\deploy\local\stop-ui.ps1
+.\deploy\local\stop.ps1
+```
+
+脚本通过记录的 PID 和对应程序路径核对进程，避免停止其他 Java 或 Node 项目。它们启动隐藏的后台进程，不修改系统服务。
+
+日志和 PID 位于 `deploy/local/.runtime/`，已加入 Git 忽略规则：
+
+- `application.log`、`stdout.log`、`stderr.log`：后端日志。
+- `ui-stdout.log`、`ui-stderr.log`：界面日志。
+- `server.pid`、`ui.pid`：运行中的进程编号。
+- `ui-src/`：历史管理界面缓存；当前维护和启动目录为仓库根目录的 `yudao-ui-admin-vue3/`。
+
+## 在另一台电脑初始化
+
+先安装 Java 8/11、Maven、MySQL 8、Redis，以及 Node.js（界面依赖要求 Node 18+，本机验证为 Node 24.12.0）。启动 MySQL 和 Redis。
+
+```powershell
+Copy-Item .\deploy\local\secrets.example.psd1 .\deploy\local\secrets.psd1
+```
+
+编辑 `secrets.psd1`，填写数据库密码；如程序不在 PATH 中，可填写 `JavaExe`、`MySqlExe`。确认数据库名为新建独立库、Redis 库编号没有被其他项目使用。
+
+以下初始化命令仅在首次运行时执行。已有表时脚本会停止，不会覆盖：
+
+```powershell
+.\deploy\local\initialize.ps1
+.\deploy\local\start.ps1 -Build
+.\deploy\local\prepare-ui.ps1
+.\deploy\local\start-ui.ps1
+```
+
+`check.ps1` 使用种子管理员密码做检查；修改管理员密码后，应相应调整检查方式。
+
+## 在 IDEA 中运行后端
+
+在项目根目录的 PowerShell 终端执行：
+
+```powershell
+.\deploy\local\prepare-idea.ps1
+```
+
+在 IDEA 右上角选择 `ElderYudao Local` 运行配置，点击运行；若没有出现，重新打开 `elder-yudao-pro` 项目。启动类为 `cn.iocoder.yudao.server.YudaoServerApplication`，模块为 `yudao-server`，激活环境为 `local,desktop`。
+
+该脚本从 `secrets.psd1` 读取本地连接参数，生成 `.run/ElderYudaoLocal.run.xml`。此文件包含数据库密码，已加入 Git 忽略规则。修改连接参数后重新执行脚本即可。脚本只生成配置，不启动进程。
+
+也可以继续使用原来的 `YudaoServerApplication` 运行配置。`application.yaml` 默认激活 `local`；`application-local.yaml` 的主数据库已改为 `elder_yudao_local`，从数据库名称跟随主库。此方式使用 `application-local.yaml` 中的连接账号与密码，本机当前配置已验证能读取该库的租户表。
+
+`ElderYudao Local` 启动项仍使用 `local,desktop`，通过私有运行配置传入连接参数，同时应用仅监听本机、使用 Redis 15 号库等部署设置。若手动启用 `desktop`，需要设置环境变量 `ELDER_DB_PASSWORD`，其值为 `secrets.psd1` 中的 `DatabasePassword`。
+
+若日志出现 `Table 'ruoyi-vue-pro.system_tenant' doesn't exist` 或 `Table 'ruoyi-vue-pro.infra_api_error_log' doesn't exist`，说明当前进程仍指向模板原来的数据库。停止后端，在 IDEA 重新构建并启动，再刷新前端；实际应连接已初始化的 `elder_yudao_local`。不要为这两张表单独生成 DDL，系统需要的是完整的初始化数据。
+
+## 在 IDEA 中运行前端
+
+项目内已保存 `.run/ElderYudaoFrontend.run.xml`。在 IDEA 顶部运行配置列表选择 `ElderYudao Frontend`，点击运行按钮即可启动前端；点击停止按钮结束它。页面地址为 http://127.0.0.1:5173 。如果运行配置暂未出现，重新打开项目。
+
+该配置使用 Node.js 运行 Vite，工作目录和脚本位置均相对于项目根目录，参数为 `--mode desktop --host 127.0.0.1 --port 5173 --strictPort`，与已验证的终端启动命令一致。Node.js 当前路径为 `E:/BiSh/NodeJS/node.exe`；换电脑后，可在 Edit Configurations 中选择对应的 Node interpreter。前端源码与 `.env.desktop` 已在 `yudao-ui-admin-vue3/` 中；若尚未准备依赖，先执行 `prepare-ui.ps1`。
+
+前端运行日志会显示在 IDEA 的 Run 窗口中。正常登录还需要后端 `ElderYudao Local` 同时运行。
+
+## 管理界面来源与依赖固定
+
+此后端仓库原本没有管理界面源码。本次使用 [yudao-ui-admin-vue3](https://github.com/yudaocode/yudao-ui-admin-vue3/tree/v2.0.1) 的 `v2.0.1` 标签，对应提交 `6f38676af78349a79b5428bca082ea0d8b4f3142`。源码现已纳入 `yudao-ui-admin-vue3/`，并参考 Olive 管理端完成界面定制。`prepare-ui.ps1` 使用 `pnpm 8.6.12` 和该目录的 `pnpm-lock.yaml` 安装固定依赖，不再克隆或覆盖源码。
+
+SWC 固定为 `1.4.14`。未固定时，旧版前端依赖解析到了 `1.16.13`，在本机触发 `ERR_SWC_NATIVE_CACHE`，导致 Vite 无法启动；固定后界面验证通过。前端 `.env.desktop` 已提供默认本机配置，`start-ui.ps1` 也可按部署配置生成，调用本机的 `/admin-api`，关闭验证码和外部统计。
+
+这是 Vite 开发服务，用于当前本地验证；生产服务器、域名、HTTPS 和持续运行服务尚未部署。界面源码现已作为 `yudao-ui-admin-vue3/` 纳入版本管理，后续页面迁移在该目录进行。参考 [管理端界面定制](管理端界面定制.md)。
+
+## 已验证结果
+
+- Maven 构建：24 个参与构建的模块全部成功；打包时跳过现有单元测试，未声称执行完整测试套件。
+- MySQL 初始化：61 张表，租户 1 的管理员存在；重复初始化会拒绝非空库。
+- 健康检查：`UP`；接口文档：HTTP 200。
+- 登录、权限信息、用户分页、退出接口：业务状态码均为 0，用户分页返回 9 条记录。
+- 浏览器：登录后进入 `/index`，打开 `/system/user` 显示用户管理页面和 9 行数据，无页面脚本错误、无接口 HTTP 错误。
--- a/docs/项目目录说明.md
+++ b/docs/项目目录说明.md
@ -0,0 +1,259 @@
+# 项目目录说明
+
+更新日期：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)。
--- a/image/目录说明.txt
+++ b/image/目录说明.txt
@ -0,0 +1,9 @@
+模板文档配图
+
+目录：image
+用途：保存原模板 README 使用的宣传截图。
+当前状态：不参与系统业务和应用启动。
+迁移与维护：按用户要求暂时保留。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/lombok.config
+++ b/lombok.config
@ -0,0 +1,4 @@
+config.stopBubbling = true
+lombok.tostring.callsuper=CALL
+lombok.equalsandhashcode.callsuper=CALL
+lombok.accessors.chain=true
--- a/mysql_script/目录说明.txt
+++ b/mysql_script/目录说明.txt
@ -0,0 +1,9 @@
+数据库初始化脚本
+
+目录：mysql_script
+用途：保存 system/infra 初始化 SQL，以及 member、商城、支付、报表等可选模块的 SQL。
+当前状态：本机 system/infra 使用 ruoyi-vue-pro.sql 初始化。
+迁移与维护：后续 member 初始化会使用 ruoyi-member.sql；新增健康业务应使用独立增量脚本。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-dependencies/目录说明.txt
+++ b/yudao-dependencies/目录说明.txt
@ -0,0 +1,9 @@
+Maven 依赖版本管理
+
+目录：yudao-dependencies
+用途：统一管理 Java 依赖、内部模块和框架组件的版本，供各模块引用。
+当前状态：已参与当前构建。
+迁移与维护：增加新依赖时优先在这里管理版本。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-example/yudao-sso-demo-by-code/目录说明.txt
+++ b/yudao-example/yudao-sso-demo-by-code/目录说明.txt
@ -0,0 +1,9 @@
+授权码单点登录示例
+
+目录：yudao-example/yudao-sso-demo-by-code
+用途：演示 OAuth 2.0 授权码模式的单点登录接入。
+当前状态：当前未启用。
+迁移与维护：作为接口接入参考。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-example/yudao-sso-demo-by-password/目录说明.txt
+++ b/yudao-example/yudao-sso-demo-by-password/目录说明.txt
@ -0,0 +1,9 @@
+密码模式单点登录示例
+
+目录：yudao-example/yudao-sso-demo-by-password
+用途：演示 OAuth 2.0 密码模式的单点登录接入。
+当前状态：当前未启用。
+迁移与维护：作为接口接入参考。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-example/目录说明.txt
+++ b/yudao-example/目录说明.txt
@ -0,0 +1,13 @@
+单点登录示例
+
+目录：yudao-example
+用途：演示授权码模式、账号密码模式的单点登录接入。
+当前状态：根 pom.xml 未启用，当前后端未加载。
+迁移与维护：用于参考，暂时保留。
+
+已备注子目录：
+yudao-sso-demo-by-code：授权码单点登录示例。
+yudao-sso-demo-by-password：密码模式单点登录示例。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-framework/yudao-common/目录说明.txt
+++ b/yudao-framework/yudao-common/目录说明.txt
@ -0,0 +1,9 @@
+公共 Java 工具
+
+目录：yudao-framework/yudao-common
+用途：统一响应、分页、异常、枚举、校验和通用工具。
+当前状态：框架源码保留；位于当前框架构建集合中。
+迁移与维护：健康接口沿用 CommonResult、PageResult 等约定。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-framework/yudao-spring-boot-starter-biz-data-permission/目录说明.txt
+++ b/yudao-framework/yudao-spring-boot-starter-biz-data-permission/目录说明.txt
@ -0,0 +1,9 @@
+数据权限
+
+目录：yudao-framework/yudao-spring-boot-starter-biz-data-permission
+用途：按照后台角色与数据范围约束查询。
+当前状态：框架源码保留；位于当前框架构建集合中。
+迁移与维护：本人、家属授权和志愿者服务范围还需在健康业务层校验。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-framework/yudao-spring-boot-starter-biz-ip/目录说明.txt
+++ b/yudao-framework/yudao-spring-boot-starter-biz-ip/目录说明.txt
@ -0,0 +1,9 @@
+地区与 IP 信息
+
+目录：yudao-framework/yudao-spring-boot-starter-biz-ip
+用途：提供行政地区、IP 地址解析和相关工具。
+当前状态：框架源码保留；位于当前框架构建集合中。
+迁移与维护：可用于地址、场地区域和注册信息。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-framework/yudao-spring-boot-starter-biz-tenant/目录说明.txt
+++ b/yudao-framework/yudao-spring-boot-starter-biz-tenant/目录说明.txt
@ -0,0 +1,9 @@
+多租户隔离
+
+目录：yudao-framework/yudao-spring-boot-starter-biz-tenant
+用途：为请求和数据库访问提供租户上下文与隔离。
+当前状态：框架源码保留；位于当前框架构建集合中。
+迁移与维护：新增健康表需要跟随项目租户规则。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-framework/yudao-spring-boot-starter-excel/目录说明.txt
+++ b/yudao-framework/yudao-spring-boot-starter-excel/目录说明.txt
@ -0,0 +1,9 @@
+Excel 导入导出
+
+目录：yudao-framework/yudao-spring-boot-starter-excel
+用途：封装 Excel 数据转换、导入与导出。
+当前状态：框架源码保留；位于当前框架构建集合中。
+迁移与维护：档案导入导出可以复用。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-framework/yudao-spring-boot-starter-job/目录说明.txt
+++ b/yudao-framework/yudao-spring-boot-starter-job/目录说明.txt
@ -0,0 +1,9 @@
+定时任务
+
+目录：yudao-framework/yudao-spring-boot-starter-job
+用途：封装 Quartz 任务执行和管理接入。
+当前状态：框架源码保留；位于当前框架构建集合中。
+迁移与维护：可承载运动提醒与过期录像清理；具体任务尚未开发。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-framework/yudao-spring-boot-starter-monitor/目录说明.txt
+++ b/yudao-framework/yudao-spring-boot-starter-monitor/目录说明.txt
@ -0,0 +1,9 @@
+运行监控
+
+目录：yudao-framework/yudao-spring-boot-starter-monitor
+用途：集成应用运行监控和日志追踪相关能力。
+当前状态：框架源码保留；位于当前框架构建集合中。
+迁移与维护：保留为服务监控基础。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-framework/yudao-spring-boot-starter-mq/目录说明.txt
+++ b/yudao-framework/yudao-spring-boot-starter-mq/目录说明.txt
@ -0,0 +1,9 @@
+消息通信
+
+目录：yudao-framework/yudao-spring-boot-starter-mq
+用途：提供消息队列相关的通用集成。
+当前状态：框架源码保留；位于当前框架构建集合中。
+迁移与维护：后续按实际需要复用，无需先部署所有消息中间件。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-framework/yudao-spring-boot-starter-mybatis/目录说明.txt
+++ b/yudao-framework/yudao-spring-boot-starter-mybatis/目录说明.txt
@ -0,0 +1,9 @@
+数据库访问
+
+目录：yudao-framework/yudao-spring-boot-starter-mybatis
+用途：封装 MyBatis-Plus、Mapper、查询与分页等能力。
+当前状态：框架源码保留；位于当前框架构建集合中。
+迁移与维护：健康模块按 BaseDO、BaseMapperX 等既有方式编写。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-framework/yudao-spring-boot-starter-protection/目录说明.txt
+++ b/yudao-framework/yudao-spring-boot-starter-protection/目录说明.txt
@ -0,0 +1,9 @@
+接口保护
+
+目录：yudao-framework/yudao-spring-boot-starter-protection
+用途：提供限流、幂等、锁等保护能力。
+当前状态：框架源码保留；位于当前框架构建集合中。
+迁移与维护：预约人数、重复提交和派单并发可能需要这些能力。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-framework/yudao-spring-boot-starter-redis/目录说明.txt
+++ b/yudao-framework/yudao-spring-boot-starter-redis/目录说明.txt
@ -0,0 +1,9 @@
+Redis 缓存
+
+目录：yudao-framework/yudao-spring-boot-starter-redis
+用途：配置缓存连接、序列化和缓存访问。
+当前状态：框架源码保留；位于当前框架构建集合中。
+迁移与维护：保留为框架及业务缓存基础。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-framework/yudao-spring-boot-starter-security/目录说明.txt
+++ b/yudao-framework/yudao-spring-boot-starter-security/目录说明.txt
@ -0,0 +1,9 @@
+认证与接口鉴权
+
+目录：yudao-framework/yudao-spring-boot-starter-security
+用途：提供登录态、安全过滤和权限校验。
+当前状态：框架源码保留；位于当前框架构建集合中。
+迁移与维护：管理用户和业务会员是不同主体，健康接口需要明确调用者类型。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-framework/yudao-spring-boot-starter-test/目录说明.txt
+++ b/yudao-framework/yudao-spring-boot-starter-test/目录说明.txt
@ -0,0 +1,9 @@
+测试基础
+
+目录：yudao-framework/yudao-spring-boot-starter-test
+用途：提供数据库、缓存和服务测试的公共支持。
+当前状态：框架源码保留；位于当前框架构建集合中。
+迁移与维护：后续评分、权限、预约和工单测试可以复用。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-framework/yudao-spring-boot-starter-web/目录说明.txt
+++ b/yudao-framework/yudao-spring-boot-starter-web/目录说明.txt
@ -0,0 +1,9 @@
+Web 接口基础
+
+目录：yudao-framework/yudao-spring-boot-starter-web
+用途：处理 Web 配置、参数校验、异常与接口前缀等。
+当前状态：框架源码保留；位于当前框架构建集合中。
+迁移与维护：后台 controller.admin 使用 /admin-api，移动端 controller.app 使用 /app-api。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-framework/yudao-spring-boot-starter-websocket/目录说明.txt
+++ b/yudao-framework/yudao-spring-boot-starter-websocket/目录说明.txt
@ -0,0 +1,9 @@
+实时 WebSocket
+
+目录：yudao-framework/yudao-spring-boot-starter-websocket
+用途：提供实时连接、消息和认证相关支持。
+当前状态：框架源码保留；位于当前框架构建集合中。
+迁移与维护：后续派单和中控告警可接入，尚未实现设备业务。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-framework/目录说明.txt
+++ b/yudao-framework/目录说明.txt
@ -0,0 +1,26 @@
+公共技术框架
+
+目录：yudao-framework
+用途：封装 Web、认证、数据库、缓存、租户、数据权限、任务、消息和文件导出等技术能力。
+当前状态：已参与当前构建。
+迁移与维护：健康业务复用这些基础能力；具体业务规则放入后续 health 模块。
+
+已备注子目录：
+yudao-common：公共 Java 工具。
+yudao-spring-boot-starter-biz-data-permission：数据权限。
+yudao-spring-boot-starter-biz-ip：地区与 IP 信息。
+yudao-spring-boot-starter-biz-tenant：多租户隔离。
+yudao-spring-boot-starter-excel：Excel 导入导出。
+yudao-spring-boot-starter-job：定时任务。
+yudao-spring-boot-starter-monitor：运行监控。
+yudao-spring-boot-starter-mq：消息通信。
+yudao-spring-boot-starter-mybatis：数据库访问。
+yudao-spring-boot-starter-protection：接口保护。
+yudao-spring-boot-starter-redis：Redis 缓存。
+yudao-spring-boot-starter-security：认证与接口鉴权。
+yudao-spring-boot-starter-test：测试基础。
+yudao-spring-boot-starter-web：Web 接口基础。
+yudao-spring-boot-starter-websocket：实时 WebSocket。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-bpm/yudao-module-bpm-api/目录说明.txt
+++ b/yudao-module-bpm/yudao-module-bpm-api/目录说明.txt
@ -0,0 +1,9 @@
+工作流：模块调用接口
+
+目录：yudao-module-bpm/yudao-module-bpm-api
+用途：供其他后端模块调用的接口、DTO 和枚举；不是浏览器直接请求的 Controller。
+当前状态：源码保留，当前未启用。
+迁移与维护：模块间调用优先通过 API，减少对实现类的依赖。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/api/目录说明.txt
+++ b/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/api/目录说明.txt
@ -0,0 +1,8 @@
+模块内部 API 实现
+
+目录：yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/api
+用途：实现模块对外提供的 Java 调用接口。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/controller/目录说明.txt
+++ b/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/controller/目录说明.txt
@ -0,0 +1,8 @@
+HTTP 接口入口
+
+目录：yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/controller
+用途：admin 是管理端接口，app 是业务客户端接口；负责接收参数、校验权限和调用服务。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/convert/目录说明.txt
+++ b/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/convert/目录说明.txt
@ -0,0 +1,8 @@
+对象转换
+
+目录：yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/convert
+用途：转换数据对象、请求参数和响应对象。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/dal/目录说明.txt
+++ b/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/dal/目录说明.txt
@ -0,0 +1,8 @@
+数据库和缓存访问
+
+目录：yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/dal
+用途：dataobject 是数据库实体，mysql 是 Mapper，redis 是缓存访问对象。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/framework/目录说明.txt
+++ b/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/framework/目录说明.txt
@ -0,0 +1,8 @@
+模块框架适配
+
+目录：yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/framework
+用途：保存当前模块与通用框架结合的配置、组件和扩展。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/service/目录说明.txt
+++ b/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/service/目录说明.txt
@ -0,0 +1,8 @@
+业务服务
+
+目录：yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/service
+用途：实现业务规则、事务和数据处理，由 Controller 或模块 API 调用。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/目录说明.txt
+++ b/yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm/目录说明.txt
@ -0,0 +1,17 @@
+bpm 业务 Java 包
+
+目录：yudao-module-bpm/yudao-module-bpm-biz/src/main/java/cn/iocoder/yudao/module/bpm
+用途：按照 controller、service、dal、convert 等层次组织当前模块的实现。
+当前状态：启用状态以所属模块为准。
+迁移与维护：先按分层说明找到接口和服务，避免把业务规则堆到 Controller。
+
+已备注子目录：
+api：模块内部 API 实现。
+controller：HTTP 接口入口。
+convert：对象转换。
+dal：数据库和缓存访问。
+framework：模块框架适配。
+service：业务服务。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-bpm/yudao-module-bpm-biz/目录说明.txt
+++ b/yudao-module-bpm/yudao-module-bpm-biz/目录说明.txt
@ -0,0 +1,9 @@
+工作流：业务实现
+
+目录：yudao-module-bpm/yudao-module-bpm-biz
+用途：保存 REST Controller、Service、数据对象、Mapper、转换器及模块配置。
+当前状态：源码保留，当前未启用。
+迁移与维护：src/main/java 是 Java 源码，src/main/resources 是模块资源，src/test 是测试。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-bpm/目录说明.txt
+++ b/yudao-module-bpm/目录说明.txt
@ -0,0 +1,13 @@
+工作流
+
+目录：yudao-module-bpm
+用途：流程设计、审批、任务与流程实例管理，使用 Flowable。
+当前状态：源码保留，当前未启用。
+迁移与维护：运动协助工单计划在健康业务中实现状态流转，暂不依赖此模块。
+
+已备注子目录：
+yudao-module-bpm-api：工作流：模块调用接口。
+yudao-module-bpm-biz：工作流：业务实现。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-crm/yudao-module-crm-api/目录说明.txt
+++ b/yudao-module-crm/yudao-module-crm-api/目录说明.txt
@ -0,0 +1,9 @@
+客户关系管理：模块调用接口
+
+目录：yudao-module-crm/yudao-module-crm-api
+用途：供其他后端模块调用的接口、DTO 和枚举；不是浏览器直接请求的 Controller。
+当前状态：源码保留，当前未启用。
+迁移与维护：模块间调用优先通过 API，减少对实现类的依赖。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/api/目录说明.txt
+++ b/yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/api/目录说明.txt
@ -0,0 +1,8 @@
+模块内部 API 实现
+
+目录：yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/api
+用途：实现模块对外提供的 Java 调用接口。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/controller/目录说明.txt
+++ b/yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/controller/目录说明.txt
@ -0,0 +1,8 @@
+HTTP 接口入口
+
+目录：yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/controller
+用途：admin 是管理端接口，app 是业务客户端接口；负责接收参数、校验权限和调用服务。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/convert/目录说明.txt
+++ b/yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/convert/目录说明.txt
@ -0,0 +1,8 @@
+对象转换
+
+目录：yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/convert
+用途：转换数据对象、请求参数和响应对象。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/dal/目录说明.txt
+++ b/yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/dal/目录说明.txt
@ -0,0 +1,8 @@
+数据库和缓存访问
+
+目录：yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/dal
+用途：dataobject 是数据库实体，mysql 是 Mapper，redis 是缓存访问对象。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/framework/目录说明.txt
+++ b/yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/framework/目录说明.txt
@ -0,0 +1,8 @@
+模块框架适配
+
+目录：yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/framework
+用途：保存当前模块与通用框架结合的配置、组件和扩展。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/job/目录说明.txt
+++ b/yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/job/目录说明.txt
@ -0,0 +1,8 @@
+业务定时任务
+
+目录：yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/job
+用途：保存可由定时任务框架执行的任务。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/service/目录说明.txt
+++ b/yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/service/目录说明.txt
@ -0,0 +1,8 @@
+业务服务
+
+目录：yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/service
+用途：实现业务规则、事务和数据处理，由 Controller 或模块 API 调用。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/util/目录说明.txt
+++ b/yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/util/目录说明.txt
@ -0,0 +1,8 @@
+模块工具
+
+目录：yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/util
+用途：保存仅与当前模块有关的辅助方法。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/目录说明.txt
+++ b/yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm/目录说明.txt
@ -0,0 +1,19 @@
+crm 业务 Java 包
+
+目录：yudao-module-crm/yudao-module-crm-biz/src/main/java/cn/iocoder/yudao/module/crm
+用途：按照 controller、service、dal、convert 等层次组织当前模块的实现。
+当前状态：启用状态以所属模块为准。
+迁移与维护：先按分层说明找到接口和服务，避免把业务规则堆到 Controller。
+
+已备注子目录：
+api：模块内部 API 实现。
+controller：HTTP 接口入口。
+convert：对象转换。
+dal：数据库和缓存访问。
+framework：模块框架适配。
+job：业务定时任务。
+service：业务服务。
+util：模块工具。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-crm/yudao-module-crm-biz/目录说明.txt
+++ b/yudao-module-crm/yudao-module-crm-biz/目录说明.txt
@ -0,0 +1,9 @@
+客户关系管理：业务实现
+
+目录：yudao-module-crm/yudao-module-crm-biz
+用途：保存 REST Controller、Service、数据对象、Mapper、转换器及模块配置。
+当前状态：源码保留，当前未启用。
+迁移与维护：src/main/java 是 Java 源码，src/main/resources 是模块资源，src/test 是测试。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-crm/目录说明.txt
+++ b/yudao-module-crm/目录说明.txt
@ -0,0 +1,13 @@
+客户关系管理
+
+目录：yudao-module-crm
+用途：线索、客户、联系人、商机、合同、回款和销售统计。
+当前状态：源码保留，当前未启用。
+迁移与维护：目前老年健康服务需求不使用此业务。
+
+已备注子目录：
+yudao-module-crm-api：客户关系管理：模块调用接口。
+yudao-module-crm-biz：客户关系管理：业务实现。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-erp/yudao-module-erp-api/目录说明.txt
+++ b/yudao-module-erp/yudao-module-erp-api/目录说明.txt
@ -0,0 +1,9 @@
+进销存管理：模块调用接口
+
+目录：yudao-module-erp/yudao-module-erp-api
+用途：供其他后端模块调用的接口、DTO 和枚举；不是浏览器直接请求的 Controller。
+当前状态：源码保留，当前未启用。
+迁移与维护：模块间调用优先通过 API，减少对实现类的依赖。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-erp/yudao-module-erp-biz/src/main/java/cn/iocoder/yudao/module/erp/controller/目录说明.txt
+++ b/yudao-module-erp/yudao-module-erp-biz/src/main/java/cn/iocoder/yudao/module/erp/controller/目录说明.txt
@ -0,0 +1,8 @@
+HTTP 接口入口
+
+目录：yudao-module-erp/yudao-module-erp-biz/src/main/java/cn/iocoder/yudao/module/erp/controller
+用途：admin 是管理端接口，app 是业务客户端接口；负责接收参数、校验权限和调用服务。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-erp/yudao-module-erp-biz/src/main/java/cn/iocoder/yudao/module/erp/dal/目录说明.txt
+++ b/yudao-module-erp/yudao-module-erp-biz/src/main/java/cn/iocoder/yudao/module/erp/dal/目录说明.txt
@ -0,0 +1,8 @@
+数据库和缓存访问
+
+目录：yudao-module-erp/yudao-module-erp-biz/src/main/java/cn/iocoder/yudao/module/erp/dal
+用途：dataobject 是数据库实体，mysql 是 Mapper，redis 是缓存访问对象。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-erp/yudao-module-erp-biz/src/main/java/cn/iocoder/yudao/module/erp/framework/目录说明.txt
+++ b/yudao-module-erp/yudao-module-erp-biz/src/main/java/cn/iocoder/yudao/module/erp/framework/目录说明.txt
@ -0,0 +1,8 @@
+模块框架适配
+
+目录：yudao-module-erp/yudao-module-erp-biz/src/main/java/cn/iocoder/yudao/module/erp/framework
+用途：保存当前模块与通用框架结合的配置、组件和扩展。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-erp/yudao-module-erp-biz/src/main/java/cn/iocoder/yudao/module/erp/service/目录说明.txt
+++ b/yudao-module-erp/yudao-module-erp-biz/src/main/java/cn/iocoder/yudao/module/erp/service/目录说明.txt
@ -0,0 +1,8 @@
+业务服务
+
+目录：yudao-module-erp/yudao-module-erp-biz/src/main/java/cn/iocoder/yudao/module/erp/service
+用途：实现业务规则、事务和数据处理，由 Controller 或模块 API 调用。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-erp/yudao-module-erp-biz/src/main/java/cn/iocoder/yudao/module/erp/目录说明.txt
+++ b/yudao-module-erp/yudao-module-erp-biz/src/main/java/cn/iocoder/yudao/module/erp/目录说明.txt
@ -0,0 +1,15 @@
+erp 业务 Java 包
+
+目录：yudao-module-erp/yudao-module-erp-biz/src/main/java/cn/iocoder/yudao/module/erp
+用途：按照 controller、service、dal、convert 等层次组织当前模块的实现。
+当前状态：启用状态以所属模块为准。
+迁移与维护：先按分层说明找到接口和服务，避免把业务规则堆到 Controller。
+
+已备注子目录：
+controller：HTTP 接口入口。
+dal：数据库和缓存访问。
+framework：模块框架适配。
+service：业务服务。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-erp/yudao-module-erp-biz/目录说明.txt
+++ b/yudao-module-erp/yudao-module-erp-biz/目录说明.txt
@ -0,0 +1,9 @@
+进销存管理：业务实现
+
+目录：yudao-module-erp/yudao-module-erp-biz
+用途：保存 REST Controller、Service、数据对象、Mapper、转换器及模块配置。
+当前状态：源码保留，当前未启用。
+迁移与维护：src/main/java 是 Java 源码，src/main/resources 是模块资源，src/test 是测试。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-erp/目录说明.txt
+++ b/yudao-module-erp/目录说明.txt
@ -0,0 +1,13 @@
+进销存管理
+
+目录：yudao-module-erp
+用途：采购、销售、库存、供应商、仓库和财务管理。
+当前状态：源码保留，当前未启用。
+迁移与维护：轻量场地与设备管理计划放入 health，不引入完整 ERP。
+
+已备注子目录：
+yudao-module-erp-api：进销存管理：模块调用接口。
+yudao-module-erp-biz：进销存管理：业务实现。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-infra/yudao-module-infra-api/目录说明.txt
+++ b/yudao-module-infra/yudao-module-infra-api/目录说明.txt
@ -0,0 +1,9 @@
+基础设施：模块调用接口
+
+目录：yudao-module-infra/yudao-module-infra-api
+用途：供其他后端模块调用的接口、DTO 和枚举；不是浏览器直接请求的 Controller。
+当前状态：已启用。
+迁移与维护：模块间调用优先通过 API，减少对实现类的依赖。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/api/目录说明.txt
+++ b/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/api/目录说明.txt
@ -0,0 +1,8 @@
+模块内部 API 实现
+
+目录：yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/api
+用途：实现模块对外提供的 Java 调用接口。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/controller/目录说明.txt
+++ b/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/controller/目录说明.txt
@ -0,0 +1,8 @@
+HTTP 接口入口
+
+目录：yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/controller
+用途：admin 是管理端接口，app 是业务客户端接口；负责接收参数、校验权限和调用服务。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/convert/目录说明.txt
+++ b/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/convert/目录说明.txt
@ -0,0 +1,8 @@
+对象转换
+
+目录：yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/convert
+用途：转换数据对象、请求参数和响应对象。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/dal/目录说明.txt
+++ b/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/dal/目录说明.txt
@ -0,0 +1,8 @@
+数据库和缓存访问
+
+目录：yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/dal
+用途：dataobject 是数据库实体，mysql 是 Mapper，redis 是缓存访问对象。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/enums/目录说明.txt
+++ b/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/enums/目录说明.txt
@ -0,0 +1,8 @@
+业务枚举与常量
+
+目录：yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/enums
+用途：保存状态、类型及错误码等固定定义。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/framework/目录说明.txt
+++ b/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/framework/目录说明.txt
@ -0,0 +1,8 @@
+模块框架适配
+
+目录：yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/framework
+用途：保存当前模块与通用框架结合的配置、组件和扩展。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/job/目录说明.txt
+++ b/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/job/目录说明.txt
@ -0,0 +1,8 @@
+业务定时任务
+
+目录：yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/job
+用途：保存可由定时任务框架执行的任务。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/mq/目录说明.txt
+++ b/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/mq/目录说明.txt
@ -0,0 +1,8 @@
+业务消息
+
+目录：yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/mq
+用途：保存消息对象、生产者和消费者。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/service/目录说明.txt
+++ b/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/service/目录说明.txt
@ -0,0 +1,8 @@
+业务服务
+
+目录：yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/service
+用途：实现业务规则、事务和数据处理，由 Controller 或模块 API 调用。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/websocket/目录说明.txt
+++ b/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/websocket/目录说明.txt
@ -0,0 +1,8 @@
+模块实时通信
+
+目录：yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/websocket
+用途：实现 WebSocket 消息处理和推送。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/目录说明.txt
+++ b/yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra/目录说明.txt
@ -0,0 +1,21 @@
+infra 业务 Java 包
+
+目录：yudao-module-infra/yudao-module-infra-biz/src/main/java/cn/iocoder/yudao/module/infra
+用途：按照 controller、service、dal、convert 等层次组织当前模块的实现。
+当前状态：启用状态以所属模块为准。
+迁移与维护：先按分层说明找到接口和服务，避免把业务规则堆到 Controller。
+
+已备注子目录：
+api：模块内部 API 实现。
+controller：HTTP 接口入口。
+convert：对象转换。
+dal：数据库和缓存访问。
+enums：业务枚举与常量。
+framework：模块框架适配。
+job：业务定时任务。
+mq：业务消息。
+service：业务服务。
+websocket：模块实时通信。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-infra/yudao-module-infra-biz/目录说明.txt
+++ b/yudao-module-infra/yudao-module-infra-biz/目录说明.txt
@ -0,0 +1,9 @@
+基础设施：业务实现
+
+目录：yudao-module-infra/yudao-module-infra-biz
+用途：保存 REST Controller、Service、数据对象、Mapper、转换器及模块配置。
+当前状态：已启用。
+迁移与维护：src/main/java 是 Java 源码，src/main/resources 是模块资源，src/test 是测试。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-infra/目录说明.txt
+++ b/yudao-module-infra/目录说明.txt
@ -0,0 +1,13 @@
+基础设施
+
+目录：yudao-module-infra
+用途：配置管理、文件存储、定时任务、代码生成、接口日志、监控和 WebSocket 等设施。
+当前状态：已启用。
+迁移与维护：运动提醒、文件与检测事件通知将复用相关能力。
+
+已备注子目录：
+yudao-module-infra-api：基础设施：模块调用接口。
+yudao-module-infra-biz：基础设施：业务实现。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-mall/yudao-module-product-api/目录说明.txt
+++ b/yudao-module-mall/yudao-module-product-api/目录说明.txt
@ -0,0 +1,9 @@
+商城商品：模块调用接口
+
+目录：yudao-module-mall/yudao-module-product-api
+用途：供其他后端模块调用的接口、DTO 和枚举；不是浏览器直接请求的 Controller。
+当前状态：源码保留，当前未启用。
+迁移与维护：模块间调用优先通过 API，减少对实现类的依赖。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-mall/yudao-module-product-biz/src/main/java/cn/iocoder/yudao/module/product/api/目录说明.txt
+++ b/yudao-module-mall/yudao-module-product-biz/src/main/java/cn/iocoder/yudao/module/product/api/目录说明.txt
@ -0,0 +1,8 @@
+模块内部 API 实现
+
+目录：yudao-module-mall/yudao-module-product-biz/src/main/java/cn/iocoder/yudao/module/product/api
+用途：实现模块对外提供的 Java 调用接口。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-mall/yudao-module-product-biz/src/main/java/cn/iocoder/yudao/module/product/controller/目录说明.txt
+++ b/yudao-module-mall/yudao-module-product-biz/src/main/java/cn/iocoder/yudao/module/product/controller/目录说明.txt
@ -0,0 +1,8 @@
+HTTP 接口入口
+
+目录：yudao-module-mall/yudao-module-product-biz/src/main/java/cn/iocoder/yudao/module/product/controller
+用途：admin 是管理端接口，app 是业务客户端接口；负责接收参数、校验权限和调用服务。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-mall/yudao-module-product-biz/src/main/java/cn/iocoder/yudao/module/product/convert/目录说明.txt
+++ b/yudao-module-mall/yudao-module-product-biz/src/main/java/cn/iocoder/yudao/module/product/convert/目录说明.txt
@ -0,0 +1,8 @@
+对象转换
+
+目录：yudao-module-mall/yudao-module-product-biz/src/main/java/cn/iocoder/yudao/module/product/convert
+用途：转换数据对象、请求参数和响应对象。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-mall/yudao-module-product-biz/src/main/java/cn/iocoder/yudao/module/product/dal/目录说明.txt
+++ b/yudao-module-mall/yudao-module-product-biz/src/main/java/cn/iocoder/yudao/module/product/dal/目录说明.txt
@ -0,0 +1,8 @@
+数据库和缓存访问
+
+目录：yudao-module-mall/yudao-module-product-biz/src/main/java/cn/iocoder/yudao/module/product/dal
+用途：dataobject 是数据库实体，mysql 是 Mapper，redis 是缓存访问对象。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-mall/yudao-module-product-biz/src/main/java/cn/iocoder/yudao/module/product/framework/目录说明.txt
+++ b/yudao-module-mall/yudao-module-product-biz/src/main/java/cn/iocoder/yudao/module/product/framework/目录说明.txt
@ -0,0 +1,8 @@
+模块框架适配
+
+目录：yudao-module-mall/yudao-module-product-biz/src/main/java/cn/iocoder/yudao/module/product/framework
+用途：保存当前模块与通用框架结合的配置、组件和扩展。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-mall/yudao-module-product-biz/src/main/java/cn/iocoder/yudao/module/product/service/目录说明.txt
+++ b/yudao-module-mall/yudao-module-product-biz/src/main/java/cn/iocoder/yudao/module/product/service/目录说明.txt
@ -0,0 +1,8 @@
+业务服务
+
+目录：yudao-module-mall/yudao-module-product-biz/src/main/java/cn/iocoder/yudao/module/product/service
+用途：实现业务规则、事务和数据处理，由 Controller 或模块 API 调用。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-mall/yudao-module-product-biz/src/main/java/cn/iocoder/yudao/module/product/目录说明.txt
+++ b/yudao-module-mall/yudao-module-product-biz/src/main/java/cn/iocoder/yudao/module/product/目录说明.txt
@ -0,0 +1,17 @@
+product 业务 Java 包
+
+目录：yudao-module-mall/yudao-module-product-biz/src/main/java/cn/iocoder/yudao/module/product
+用途：按照 controller、service、dal、convert 等层次组织当前模块的实现。
+当前状态：启用状态以所属模块为准。
+迁移与维护：先按分层说明找到接口和服务，避免把业务规则堆到 Controller。
+
+已备注子目录：
+api：模块内部 API 实现。
+controller：HTTP 接口入口。
+convert：对象转换。
+dal：数据库和缓存访问。
+framework：模块框架适配。
+service：业务服务。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-mall/yudao-module-product-biz/目录说明.txt
+++ b/yudao-module-mall/yudao-module-product-biz/目录说明.txt
@ -0,0 +1,9 @@
+商城商品：业务实现
+
+目录：yudao-module-mall/yudao-module-product-biz
+用途：保存 REST Controller、Service、数据对象、Mapper、转换器及模块配置。
+当前状态：源码保留，当前未启用。
+迁移与维护：src/main/java 是 Java 源码，src/main/resources 是模块资源，src/test 是测试。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-mall/yudao-module-promotion-api/目录说明.txt
+++ b/yudao-module-mall/yudao-module-promotion-api/目录说明.txt
@ -0,0 +1,9 @@
+商城营销：模块调用接口
+
+目录：yudao-module-mall/yudao-module-promotion-api
+用途：供其他后端模块调用的接口、DTO 和枚举；不是浏览器直接请求的 Controller。
+当前状态：源码保留，当前未启用。
+迁移与维护：模块间调用优先通过 API，减少对实现类的依赖。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-mall/yudao-module-promotion-biz/src/main/java/cn/iocoder/yudao/module/promotion/api/目录说明.txt
+++ b/yudao-module-mall/yudao-module-promotion-biz/src/main/java/cn/iocoder/yudao/module/promotion/api/目录说明.txt
@ -0,0 +1,8 @@
+模块内部 API 实现
+
+目录：yudao-module-mall/yudao-module-promotion-biz/src/main/java/cn/iocoder/yudao/module/promotion/api
+用途：实现模块对外提供的 Java 调用接口。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-mall/yudao-module-promotion-biz/src/main/java/cn/iocoder/yudao/module/promotion/controller/目录说明.txt
+++ b/yudao-module-mall/yudao-module-promotion-biz/src/main/java/cn/iocoder/yudao/module/promotion/controller/目录说明.txt
@ -0,0 +1,8 @@
+HTTP 接口入口
+
+目录：yudao-module-mall/yudao-module-promotion-biz/src/main/java/cn/iocoder/yudao/module/promotion/controller
+用途：admin 是管理端接口，app 是业务客户端接口；负责接收参数、校验权限和调用服务。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/yudao-module-mall/yudao-module-promotion-biz/src/main/java/cn/iocoder/yudao/module/promotion/convert/目录说明.txt
+++ b/yudao-module-mall/yudao-module-promotion-biz/src/main/java/cn/iocoder/yudao/module/promotion/convert/目录说明.txt
@ -0,0 +1,8 @@
+对象转换
+
+目录：yudao-module-mall/yudao-module-promotion-biz/src/main/java/cn/iocoder/yudao/module/promotion/convert
+用途：转换数据对象、请求参数和响应对象。
+当前状态：启用状态以所属业务模块为准。
+
+完整索引：项目根目录 docs/项目目录说明.md。
+此文件只用于在 IDEA 中阅读目录用途，不修改目录名称、构建依赖或程序行为。
--- a/Show More
+++ b/Show More