befly-admin 3.3.7 → 3.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "befly-admin",
-    "version": "3.3.7",
+    "version": "3.4.0",
     "description": "Befly Admin - 基于 Vue3 + OpenTiny Vue 的后台管理系统",
     "type": "module",
     "private": false,
@@ -17,7 +17,7 @@
     "dependencies": {
         "@opentiny/vue": "3.26.0",
         "axios": "1.12.2",
-        "befly-auto-routes": "^1.0.4",
+        "befly-auto-routes": "^1.1.0",
         "lucide-vue-next": "0.546.0",
         "pinia": "3.0.3",
         "vue": "3.5.22",
@@ -39,5 +39,5 @@
         "node": ">=22.0.0",
         "pnpm": ">=9.0.0"
     },
-    "gitHead": "c15e9bf787cbdf1c4d9bc5296a686a24e79c915e"
+    "gitHead": "f9672c8969f228336de372cdd3094b4507676792"
 }

package/src/components/internal/README.md

@@ -0,0 +1,27 @@
+# Internal 目录说明
+
+⚠️ **重要提示**
+
+此目录下的所有文件由 **befly-admin** 框架管理，请勿修改！
+
+## 自动更新
+
+运行以下命令会自动更新此目录：
+
+```bash
+befly sync:admin
+```
+
+## 注意事项
+
+1. ❌ **请勿修改** internal 目录下的任何文件
+2. ❌ **请勿删除** internal 目录
+3. ✅ 如需自定义组件，请在 internal 目录外创建文件
+
+## 文件用途
+
+此目录包含框架核心组件，确保管理系统的基础功能正常运行。
+
+---
+
+📚 更多信息请查看项目文档

package/src/layouts/4.vue

@@ -0,0 +1,17 @@
+<template>
+    <div class="custom-layout-0">
+        <h1>这是用户自定义的布局 0（覆盖 internal）</h1>
+        <RouterView />
+    </div>
+</template>
+
+<script setup>
+// 测试用户自定义布局是否能覆盖 internal 布局
+</script>
+
+<style scoped>
+.custom-layout-0 {
+    background-color: #f0f0f0;
+    padding: 20px;
+}
+</style>

package/src/layouts/{0.vue → internal/0.vue}

@@ -36,7 +36,7 @@
 </template>
 
 <script setup>
-import { arrayToTree } from '../util';
+import { arrayToTree } from '@/utils';
 
 const router = useRouter();
 const route = useRoute();

package/src/layouts/internal/README.md

@@ -0,0 +1,27 @@
+# Internal 目录说明
+
+⚠️ **重要提示**
+
+此目录下的所有文件由 **befly-admin** 框架管理，请勿修改！
+
+## 自动更新
+
+运行以下命令会自动更新此目录：
+
+```bash
+befly sync:admin
+```
+
+## 注意事项
+
+1. ❌ **请勿修改** internal 目录下的任何文件
+2. ❌ **请勿删除** internal 目录
+3. ✅ 如需自定义布局，请在 internal 目录外创建文件
+
+## 文件用途
+
+此目录包含框架核心布局文件，确保管理系统的页面结构正常运行。
+
+---
+
+📚 更多信息请查看项目文档

package/src/main.ts

@@ -3,10 +3,10 @@ import { createPinia } from 'pinia';
 import App from './App.vue';
 
 // 引入全局样式
-import './styles/index.scss';
+import './styles/internal/index.scss';
 
 // 引入路由实例
-import { router } from './plugins/router';
+import { router } from './plugins/internal/router';
 
 const app = createApp(App);
 

package/src/plugins/internal/README.md

@@ -0,0 +1,36 @@
+# Internal 目录说明
+
+⚠️ **重要提示**
+
+此目录下的所有文件由 **befly-admin** 框架管理，请勿修改！
+
+## 自动更新
+
+运行以下命令会自动更新此目录：
+
+```bash
+befly sync:admin
+```
+
+## 注意事项
+
+1. ❌ **请勿修改** internal 目录下的任何文件
+2. ❌ **请勿删除** internal 目录
+3. ✅ 如需自定义插件，请在 internal 目录外创建文件，并使用不同的导出名称
+
+## 保留的导出名称
+
+框架保留以下导出名称，请勿在自定义插件中使用：
+
+- `$Http` - HTTP 请求封装
+- `$Storage` - 本地存储封装
+- `router` - Vue Router 实例
+- `useAppStore` - 应用状态管理
+
+## 文件用途
+
+此目录包含框架核心插件，确保管理系统的基础功能正常运行。
+
+---
+
+📚 更多信息请查看项目文档

package/src/styles/internal/README.md

@@ -0,0 +1,27 @@
+# Internal 目录说明
+
+⚠️ **重要提示**
+
+此目录下的所有文件由 **befly-admin** 框架管理，请勿修改！
+
+## 自动更新
+
+运行以下命令会自动更新此目录：
+
+```bash
+befly sync:admin
+```
+
+## 注意事项
+
+1. ❌ **请勿修改** internal 目录下的任何文件
+2. ❌ **请勿删除** internal 目录
+3. ✅ 如需自定义样式，请在 internal 目录外创建文件
+
+## 文件用途
+
+此目录包含框架核心样式文件，确保管理系统的视觉效果正常运行。
+
+---
+
+📚 更多信息请查看项目文档

package/src/utils/README.md

@@ -0,0 +1,37 @@
+# Utils 目录说明
+
+## 目录结构
+
+- `internal.ts` - 框架核心工具函数（由 befly-admin 管理）
+- `index.ts` - 用户自定义工具函数
+
+## 使用说明
+
+### 框架工具函数
+
+```typescript
+import { arrayToTree } from '@/utils/internal';
+// 或者
+import { arrayToTree } from '@/utils';
+```
+
+### 自定义工具函数
+
+在 `index.ts` 中添加您的工具函数：
+
+```typescript
+/**
+ * 格式化日期
+ */
+export function formatDate(date: Date): string {
+    return date.toISOString().split('T')[0];
+}
+```
+
+## 注意事项
+
+⚠️ **请勿修改** `internal.ts` 文件，运行 `befly sync:admin` 会自动更新此文件
+
+---
+
+📚 更多信息请查看项目文档

package/src/utils/index.ts

@@ -0,0 +1,12 @@
+/**
+ * 用户自定义工具函数
+ * 可以在这里添加项目特定的工具函数
+ *
+ * 示例：
+ * export function formatDate(date: Date): string {
+ *     return date.toISOString().split('T')[0];
+ * }
+ */
+
+// 导出框架工具（可选）
+export * from './internal';

package/src/{util.ts → utils/internal.ts}

@@ -1,5 +1,7 @@
 /**
- * 工具函数集合
+ * 框架核心工具函数
+ * ⚠️ 此文件由 befly-admin 包管理，请勿修改
+ * 运行 `befly sync:admin` 会自动更新此文件
  */
 
 /**

package/src/views/internal/README.md

@@ -0,0 +1,27 @@
+# Internal 目录说明
+
+⚠️ **重要提示**
+
+此目录下的所有文件由 **befly-admin** 框架管理，请勿修改！
+
+## 自动更新
+
+运行以下命令会自动更新此目录：
+
+```bash
+befly sync:admin
+```
+
+## 注意事项
+
+1. ❌ **请勿修改** internal 目录下的任何文件
+2. ❌ **请勿删除** internal 目录
+3. ✅ 如需创建业务页面，请在 internal 目录外创建文件
+
+## 文件用途
+
+此目录包含框架提供的管理页面（用户管理、角色管理、菜单管理等），确保管理系统的基础功能正常运行。
+
+---
+
+📚 更多信息请查看项目文档

package/src/views/internal/index/components/userInfo.vue

@@ -0,0 +1,202 @@
+<template>
+    <div class="section-block user-info-card">
+        <div class="user-header">
+            <div class="user-avatar">
+                <Icon name="User" :size="32" />
+            </div>
+            <div class="user-basic">
+                <div class="user-name">{{ $Data.userInfo.nickname || $Data.userInfo.name || $Data.userInfo.username || '未设置' }}</div>
+                <div class="user-role">{{ $Data.userInfo.role?.name || '普通用户' }}</div>
+            </div>
+        </div>
+        <div class="user-details">
+            <div class="detail-item">
+                <Icon name="Mail" :size="14" />
+                <span>{{ $Data.userInfo.email || '未设置' }}</span>
+            </div>
+            <div v-if="$Data.userInfo.phone" class="detail-item">
+                <Icon name="Phone" :size="14" />
+                <span>{{ $Data.userInfo.phone }}</span>
+            </div>
+            <div v-if="$Data.userInfo.lastLoginTime" class="detail-item">
+                <Icon name="Clock" :size="14" />
+                <span>{{ $Method.formatTime($Data.userInfo.lastLoginTime) }}</span>
+            </div>
+        </div>
+
+        <!-- 仅 dev 角色显示刷新缓存按钮 -->
+        <div v-if="$Data.userInfo.roleCode === 'dev'" class="user-actions">
+            <tiny-button type="primary" size="mini" :loading="$Data.refreshing" @click="$Method.handleRefreshCache">
+                <template #icon>
+                    <Icon name="RotateCw" :size="14" />
+                </template>
+                刷新缓存
+            </tiny-button>
+        </div>
+    </div>
+</template>
+
+<script setup>
+// 响应式数据
+const $Data = $ref({
+    userInfo: {},
+    refreshing: false
+});
+
+// 方法集合
+const $Method = {
+    // 获取数据
+    async fetchData() {
+        try {
+            const { data } = await $Http('/addon/admin/admin/info');
+            Object.assign($Data.userInfo, data);
+        } catch (error) {
+            console.error('获取用户信息失败:', error);
+        }
+    },
+
+    // 刷新缓存
+    async handleRefreshCache() {
+        try {
+            $Data.refreshing = true;
+            const result = await $Http('/addon/admin/admin/cacheRefresh');
+
+            if (result.code === 0) {
+                const { apis, menus, roles } = result.data;
+                const messages = [];
+
+                if (apis.success) {
+                    messages.push(`接口缓存: ${apis.count} 个`);
+                }
+                if (menus.success) {
+                    messages.push(`菜单缓存: ${menus.count} 个`);
+                }
+                if (roles.success) {
+                    messages.push(`角色缓存: ${roles.count} 个`);
+                }
+
+                TinyMessage.success({
+                    message: `缓存刷新成功！${messages.join('，')}`,
+                    duration: 3000
+                });
+            } else {
+                TinyMessage.warning({
+                    message: result.msg || '部分缓存刷新失败',
+                    duration: 3000
+                });
+            }
+        } catch (error) {
+            console.error('刷新缓存失败:', error);
+            TinyMessage.error({
+                message: '刷新缓存失败，请稍后重试',
+                duration: 3000
+            });
+        } finally {
+            $Data.refreshing = false;
+        }
+    },
+
+    // 格式化时间
+    formatTime(timestamp) {
+        if (!timestamp) return '';
+        const date = new Date(Number(timestamp));
+        const now = new Date();
+        const diff = now - date;
+
+        // 小于1分钟
+        if (diff < 60000) {
+            return '刚刚';
+        }
+        // 小于1小时
+        if (diff < 3600000) {
+            return `${Math.floor(diff / 60000)}分钟前`;
+        }
+        // 小于24小时
+        if (diff < 86400000) {
+            return `${Math.floor(diff / 3600000)}小时前`;
+        }
+        // 小于7天
+        if (diff < 604800000) {
+            return `${Math.floor(diff / 86400000)}天前`;
+        }
+        // 超过7天显示具体日期
+        return `${date.getMonth() + 1}月${date.getDate()}日`;
+    }
+};
+
+// 初始化
+$Method.fetchData();
+</script>
+
+<style scoped lang="scss">
+.user-info-card {
+    .user-header {
+        display: flex;
+        align-items: center;
+        gap: 12px;
+        padding-bottom: 12px;
+        border-bottom: 1px solid $border-color;
+
+        .user-avatar {
+            width: 48px;
+            height: 48px;
+            background: linear-gradient(135deg, $primary-color, #764ba2);
+            border-radius: 50%;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            color: white;
+            flex-shrink: 0;
+        }
+
+        .user-basic {
+            flex: 1;
+            min-width: 0;
+
+            .user-name {
+                font-size: 16px;
+                font-weight: 600;
+                color: $text-primary;
+                margin-bottom: 4px;
+                overflow: hidden;
+                text-overflow: ellipsis;
+                white-space: nowrap;
+            }
+
+            .user-role {
+                font-size: 12px;
+                color: $text-secondary;
+            }
+        }
+    }
+
+    .user-details {
+        display: flex;
+        flex-direction: column;
+        gap: 8px;
+        margin-top: 12px;
+
+        .detail-item {
+            display: flex;
+            align-items: center;
+            gap: 8px;
+            font-size: 12px;
+            color: $text-secondary;
+
+            span {
+                overflow: hidden;
+                text-overflow: ellipsis;
+                white-space: nowrap;
+            }
+        }
+    }
+
+    .user-actions {
+        margin-top: 16px;
+        padding-top: 12px;
+        border-top: 1px solid $border-color;
+        display: flex;
+        justify-content: center;
+    }
+}
+</style>

package/src/views/{role → internal/role}/components/menu.vue

@@ -11,7 +11,7 @@
 </template>
 
 <script setup>
-import { arrayToTree } from '../../../util';
+import { arrayToTree } from '@/utils';
 
 const $Prop = defineProps({
     modelValue: {

package/vite.config.ts

@@ -26,8 +26,8 @@ export default defineConfig({
                 }
             ],
             resolvers: [TinyVueSingleResolver],
-            // 自动导入 plugins 目录下的所有导出
-            dirs: ['./src/plugins'],
+            // 自动导入 plugins 目录下的所有导出（internal 优先）
+            dirs: ['./src/plugins/internal', './src/plugins'],
             dts: 'src/types/auto-imports.d.ts',
             eslintrc: {
                 enabled: false
@@ -36,7 +36,7 @@ export default defineConfig({
         // 自动导入 OpenTiny 组件
         Components({
             resolvers: [TinyVueSingleResolver],
-            dirs: ['src/components'],
+            dirs: ['src/components/internal', 'src/components'],
             dts: 'src/types/components.d.ts'
         })
     ],
@@ -52,7 +52,7 @@ export default defineConfig({
         preprocessorOptions: {
             scss: {
                 api: 'modern-compiler',
-                additionalData: `@use "@/styles/variables.scss" as *;`
+                additionalData: `@use "@/styles/internal/variables.scss" as *;`
             }
         }
     },