dashboard/.qoder/repowiki/knowledge/zh/Luxsin Audio Dashboard 全栈工程/Soybean Admin 前端应用（Vite + Vue3 多包工程）/架构设计.md

顶层以 pnpm-workspace.yaml 聚合 packages/* 下的多个独立 npm 包（@sa/alova、@sa/axios、@sa/hooks、@sa/materials、@sa/utils、@sa/color、@sa/uno-preset、@sa/scripts），由根 vite.config.ts 通过 alias 与 resolve.dedupe 暴露给业务代码；src/main.ts 作为唯一入口，按顺序加载 plugins/（全局插件）、router/（路由与守卫）、store/（Pinia 状态）、service/request/（HTTP 拦截器）后挂载 App Shell，业务页面位于 src/views/ 并通过 elegant-router 自动生成路由映射。src/service/api/*.ts 调用各 @sa 包提供的能力，src/layouts/ 提供 base/blank 两种布局壳，src/theme/preset/*.json 驱动 Naive UI 主题切换，形成「共享包 → 基础设施层 → 应用外壳 → 业务视图」的分层依赖关系。