初始化

docs/projects/xk-admin/architecture.md

@@ -0,0 +1,55 @@
+# xk-admin 基类架构
+
+## 技术架构
+
+```mermaid
+graph TB
+    subgraph Monorepo
+        APP[apps/web-antd<br/>主应用]
+        INT[internal/<br/>内部共享包]
+        PKG[packages/<br/>共享工作区包]
+        PLAY[playground/<br/>开发调试]
+    end
+
+    subgraph 主应用 web-antd
+        MAIN[main.ts] --> VUE[Vue 3 App]
+        VUE --> ROUTER[Vue Router]
+        VUE --> PINIA[Pinia Store]
+        VUE --> UI[Ant Design Vue]
+        ROUTER --> VIEWS[views/*]
+        VIEWS --> API[api/*]
+        API --> HTTP[axios]
+    end
+
+    HTTP --> BACKEND[xk-api<br/>后端 API]
+```
+
+## 目录结构
+
+| 目录 | 说明 |
+|------|------|
+| `adapter/` | API 适配器，统一请求格式 |
+| `api/` | API 接口定义，按模块组织 |
+| `components/` | 共享 Vue 组件 |
+| `composables/` | Vue Composition API 复用逻辑 |
+| `layouts/` | 页面布局（侧边栏、顶栏、内容区） |
+| `locales/` | 国际化资源文件 |
+| `router/` | 路由配置和守卫 |
+| `store/` | Pinia 状态管理 |
+| `views/` | 页面视图，按模块组织 |
+| `utils/` | 工具函数 |
+
+## 构建工具
+
+- **Vite**: 开发服务器和构建
+- **Turborepo**: Monorepo 任务编排和缓存
+- **pnpm**: 包管理（workspace 协议）
+- **TypeScript**: 类型检查
+
+## 开发命令
+
+```bash
+pnpm dev          # 启动开发服务器
+pnpm build        # 生产构建
+pnpm lint         # 代码检查
+```