Z
ZeniCore
/文档中心
文档框架架构

框架架构

2026-04-21 v1.0.0

框架架构

ZeniCore Nuxt 采用分层架构设计,各层职责明确,耦合度低,便于维护和扩展。

架构分层

  • 视图层:Vue 组件 + 页面,负责 UI 渲染和用户交互
  • 逻辑层:Composables + Store,负责业务逻辑和状态管理
  • 数据层:API 请求 + 数据转换,负责与后端交互
  • 基础设施层:中间件 + 插件 + 工具函数,提供通用能力

布局系统

框架提供了四种布局类型:

布局名称文件说明
defaultlayouts/default.vue默认布局,Header + Sidebar + Main + Footer
adminlayouts/admin.vue管理后台布局,固定侧边栏
portallayouts/portal.vue门户布局,适合展示型网站
blanklayouts/blank.vue空白布局,仅包含内容区域

权限体系

四层权限控制:

  • 路由级:导航守卫(middleware/auth.ts)
  • 组件级:自定义 Directive 指令
  • 接口级:请求拦截器
  • 按钮级:权限组件封装

认证流程

  • JWT Token + RefreshToken 机制
  • Token 存储于 Cookie
  • 请求自动携带认证头
  • Token 过期自动刷新
  • 退出登录清除所有认证信息