WaitAdmin(Python)开发手册

前台端

目录结构

├──📂 .nuxt                            # 开发模式下的产物
├──📂 .output                          # 打包构建的产物
├──📂 api                              # 所有请求
├──📂 assets                           # 静态资源（会经过构建工具构建）
├──📂 components                       # 全局公用组件
├──📂 composables                      # 全局可组合物（即hooks）
├──📂 constants                        # 静态数据
├──📂 enums                            # 全局枚举
├──📂 layouts                          # 基础布局  
├──📂 middleware                       # 中间件
├──📂 nuxt                             # nuxt.config.ts辅助函数
├──📂 pages                            # 所有页面
├──📂 plugins                          # 插件安装
├──📂 public                           # 服务器根目录
├──📂 scripts                          # js脚本
├──📂 stores                           # 全局状态管理
├──📂 typings                          # ts声明文件
├──📂 utils                            # 全局公用方法
├── .env.xxx                           # 环境变量配置
├── .eslintrc.cjs                      # eslint 配置项
├── app.vue                            # 根组件
├── global.d.ts                        # 全局ts声明文件
├── nuxt.config.ts                     # nuxt配置文件
├── package.json                       # package.json
├── tailwind.config.js                 # tailwindcss 配置项
├── tsconfig.json                      # ts 配置项

快速上手

  • 复制env文件

    • 1.复制.env.template文件，将复制的文件名修改为.env
    • 2.复制.env.template.development，将复制的文件名修改为.env.development
    • 3.复制.env.template.production，将复制的文件名修改为.env.production

  • 打开.env.development修改配置

    • 修改VITE_API_URL变量的值为项目安装部署的服务端地址
    • .env.development是开发环境是用的
    • .env.production是生成环境使用的
    • 请根据你自己当前情况调整这两个文件的请求域名
# 请求域名
VITE_API_URL=https://fastapi.waitadmin.cn
  • 安装依赖
    • 您首先要进入到源码的根目录
    • 依赖只需要安一次即可
    • 在终端执行命令
# 1、进入到源码目录
cd /waitadmin-python/nuxtjs

# 2、执行安装依赖命令 (请求超时的配置国内源)
npm install

# 3、编译运行
npm run dev

项目上线

  • 打包支持seo模式和非seo模式，默认为非seo模式, 修改.env文件可以修改模式。
# 是否开启ssr,填些任意值开启,为空则关闭
NUXT_SSR=1
  • 打包前修改请求域名: 打开 .env.production

注意

如果是非seo模式则不需要修改，将VITE_API_URL留空即可。
这样请求接口时会自动读取当前的域名做为接口请求的域名。

# 请求域名
VITE_API_URL=https://fastapi.waitadmin.cn

seo模型

  • 1、修改路由基础路径，默认基础路径为/pc/，修改为/，打开.env文件修改
# 基础路径
NUXT_BASE_URL=/pc/
  • 2、在终端中运行命令
# 运行命令进行打包
npm run build

# 将打包好后, 会自动将打包产物复制到`server/public/pc`下面, 只需要提交代码到服务器即可
  • 3、服务器部署
上次更新:
贡献者: zero