Appearance
目录结构指南
为了使各位开发者能够快速熟悉并找到所需修改的功能位置，特此提供项目的全景结构图与详细注解。项目采用彻底的前后端分离设计，目前包含三大核心子工程。
Server 后端（ThinkPHP 8）
Server 端依据 ThinkPHP 8 的经典多应用模式组织架构。所有的核心数据交互、数据库操作全部置于此。
text
server/
├─app （核心应用逻辑目录）
│ ├─adminapi （PC管理后台专门的 API 接口模块）
│ │ ├─config （该模块的配置文件目录）
│ │ ├─controller （控制器逻辑）
│ │ ├─http （中间件拦截配置）
│ │ ├─listener （事件监听或订阅逻辑）
│ │ ├─lists （列表类，封装表格数据分页检索独立职责）
│ │ ├─logic （核心业务逻辑处理单元）
│ │ ├─service （高度可复用的业务系统服务支持）
│ │ └─validate （接受参数后的过滤、规则强校验层）
│ ├─api （供给前台Web或移动端等的公共 API）
│ └─common （支持多应用内调用的公共类、基类包）
│
├─config （框架级的公共默认配置，全局影响）
├─database （数据库生成文件、导入/初始脚本结构文件等）
├─extend （非 Composer 下载的第三方独立拓展类库）
├─public （对外真实暴露的运行目录）
│ ├─index.php （应用的唯一进入点）
│ ├─admin （管理后台 Vue 打包后编译的发布版位置）
│ └─install （一键化安装系统的引导页）
│
├─route （全局静态路由与控制配置）
├─runtime （框架在执行中记录的缓存、应用日志）
├─vendor （Composer 安装的各类核心框架和依赖代码包）
├─view （TP自身极少用到的 View 层输出视图页面）
│
├─.env （服务端及数据库、全站基础架构环境变量配置表）
├─.htaccess （Apache 配合下隐藏 index.php 的伪静态规则）
├─composer.json （项目安装依赖的核心声明描述）
├─import.sql （数据库的安装脚本与基础库备份）
├─README.md
└─think （ThinkPHP 内建专属的命令行触发入口程序）web端（Vue3 + Vite）
基于 Vue 3、Vite 5+ 以及 Element Plus 构建的高质管理后台，采用极其经典和成熟的前端工程化开发结构。
text
admin/
├──📂 public # 公共资源文件
├──📂 scripts # 工程自动化运行或执行依赖的辅助脚本
├──📂 src # 核心源代码
│ ├──📂 api # 对应后端模块定义的请求接口封装
│ ├──📂 assets # 静态资源文件
│ ├──📂 components # 全局公用组件
│ ├──📂 directive # 自定义指令
│ ├──📂 layout # 框架版型布局
│ ├──📂 router # 路由
│ ├──📂 stores # 全局状态管理
│ ├──📂 styles # 全局样式
│ ├──📂 utils # 工具函数库
│ ├──📂 views # 所有页面
│ ├── App.vue # 入口页面
│ ├── main.ts # 入口文件 各个生态依赖的进入和注册点
│ ├── permission.ts # 前台路由拦截，权限管理
│ └── settings.ts # 系统配置
├── .env.development # 开发环境变量配置
├── .env.production # 生产环境变量配置
├── .eslintrc.cjs # ESLint 检测工具规则
├── .prettierrc.json # 团队化统一代码外观格式控制
├── index.html # 入口文件
├── package.json # Node 运行时必需引用的包含库
├── postcss.config.js # postcss 配置项
├── tailwind.config.js # tailwindcss 配置项
├── tsconfig.json # ts 配置项
└── vite.config.ts # vite 配置项