@deppon/create-deppon-app 2.2.0

package/package.json

@@ -0,0 +1,51 @@
+{
+    "name": "@deppon/create-deppon-app",
+    "version": "2.2.0",
+    "description": "Vue 3 project scaffold CLI tool",
+    "author": {
+        "name": "",
+        "email": ""
+    },
+    "bin": {
+        "create-deppon-app": "deppon.js"
+    },
+    "type": "module",
+    "scripts": {
+        "lint": "eslint . --ext js,ts,tsx",
+        "format": "prettier --write **/*.{js,ts} && eslint . --ext js,ts --fix",
+        "prePublish": "npm run build && npm publish",
+        "publish:auto": "npm publish"
+    },
+    "main": "deppon.js",
+    "files": [
+        "deppon.js",
+        "template"
+    ],
+    "publishConfig": {
+        "registry": "https://registry.npmjs.org/",
+        "access": "public"
+    },
+    "engines": {
+        "node": ">=14.0.0"
+    },
+    "repository": {
+        "type": "git",
+        "url": "",
+        "directory": "packages/deppon-create"
+    },
+    "homepage": "",
+    "keywords": [
+        "webpack",
+        "vue",
+        "vue3",
+        "cli"
+    ],
+    "license": "MIT",
+    "dependencies": {
+        "chalk": "^4.1.0",
+        "commander": "^9.4.0",
+        "inquirer": "^7.3.3",
+        "semver": "^7.3.7"
+    },
+    "gitHead": "1e62b1a584750ea257911035a1b7ef1042c335e8"
+}

package/template/.env

@@ -0,0 +1,12 @@
+# ============================================
+# 基础环境配置文件
+# ============================================
+# 此文件包含所有环境的公共配置项
+# 各环境特定的配置请在各环境的配置文件中设置：
+# - .env.dev-local (本地环境)
+# - .env.development (开发环境)
+# - .env.test (测试环境)
+# - .env.production (生产环境)
+
+# 应用部署路径（根据实际项目名称修改）
+DP_PUBLIC_PATH=/

package/template/.env.dev-local.example

@@ -0,0 +1,64 @@
+# ============================================
+# local 环境配置
+# ============================================
+# 此文件包含本地开发环境的特定配置
+# 通过运行 npm run dev:local 使用此配置
+
+# ============================================
+# 环境标识
+# ============================================
+DP_ENV=development
+
+# ============================================
+# 开发服务器配置
+# ============================================
+
+# 开发服务器端口号
+DP_PORT=3100
+
+# 开发服务器监听的主机地址
+DP_HOST=0.0.0.0
+
+# 允许访问的主机名（多个用逗号分隔）
+DP_ALLOWED_HOSTS=
+
+# ============================================
+# 应用配置
+# ============================================
+
+# 登录页面 URL
+DP_LOGIN_URL=
+
+# 是否启用 HTTPS
+DP_HTTPS=false
+
+# 启动开发服务器时是否自动打开浏览器
+DP_OPEN=false
+
+# 自动打开的页面路径
+DP_OPEN_PAGE=/
+
+# 构建输出目录名称
+DP_BUILD_DIR=dist
+
+# 是否生成 source map 文件（开发环境建议开启，方便调试）
+DP_SOURCEMAP=true
+
+# 是否启用登录检验
+DP_ENABLE_LOGIN_CHECK=false
+
+# 是否使用布局组件
+DP_USE_LAYOUT=true
+
+# 是否使用本地路由
+DP_USE_LOCAL_ROUTES=true
+
+# ============================================
+# 多系统 API 地址配置
+# ============================================
+
+# 主业务 API 地址
+DP_API_HOST=
+
+# UAP 用户信息服务 API 地址
+DP_UAP_API_HOST=

package/template/.env.development.example

@@ -0,0 +1,64 @@
+# ============================================
+# Development 环境配置
+# ============================================
+# 此文件包含开发环境的特定配置
+# 通过运行 npm run dev 使用此配置
+
+# ============================================
+# 环境标识
+# ============================================
+DP_ENV=development
+
+# ============================================
+# 开发服务器配置
+# ============================================
+
+# 开发服务器端口号
+DP_PORT=3100
+
+# 开发服务器监听的主机地址
+DP_HOST=0.0.0.0
+
+# 允许访问的主机名（多个用逗号分隔）
+DP_ALLOWED_HOSTS=
+
+# ============================================
+# 应用配置
+# ============================================
+
+# 登录页面 URL
+DP_LOGIN_URL=
+
+# 是否启用 HTTPS
+DP_HTTPS=false
+
+# 启动开发服务器时是否自动打开浏览器
+DP_OPEN=false
+
+# 自动打开的页面路径
+DP_OPEN_PAGE=/
+
+# 构建输出目录名称
+DP_BUILD_DIR=dist
+
+# 是否生成 source map 文件（开发环境建议开启，方便调试）
+DP_SOURCEMAP=true
+
+# 是否启用登录检验
+DP_ENABLE_LOGIN_CHECK=false
+
+# 是否使用布局组件
+DP_USE_LAYOUT=true
+
+# 是否使用本地路由
+DP_USE_LOCAL_ROUTES=true
+
+# ============================================
+# 多系统 API 地址配置
+# ============================================
+
+# 主业务 API 地址
+DP_API_HOST=
+
+# UAP 用户信息服务 API 地址
+DP_UAP_API_HOST=

package/template/.env.example

@@ -0,0 +1 @@
+# Production environment variables

package/template/.env.production.example

@@ -0,0 +1,64 @@
+# ============================================
+# Production 环境配置
+# ============================================
+# 此文件包含生产环境的特定配置
+# 通过运行 npm run build 使用此配置
+
+# ============================================
+# 环境标识
+# ============================================
+DP_ENV=production
+
+# ============================================
+# 开发服务器配置
+# ============================================
+
+# 开发服务器端口号（生产环境构建后此配置通常不使用）
+DP_PORT=8888
+
+# 开发服务器监听的主机地址
+DP_HOST=0.0.0.0
+
+# 允许访问的主机名
+DP_ALLOWED_HOSTS=
+
+# ============================================
+# 应用配置
+# ============================================
+
+# 登录页面 URL
+DP_LOGIN_URL=
+
+# 是否启用 HTTPS
+DP_HTTPS=false
+
+# 启动开发服务器时是否自动打开浏览器（生产环境通常关闭）
+DP_OPEN=false
+
+# 自动打开的页面路径
+DP_OPEN_PAGE=/
+
+# 构建输出目录名称
+DP_BUILD_DIR=dist
+
+# 是否生成 source map 文件（生产环境建议关闭，减少文件大小并保护源码）
+DP_SOURCEMAP=false
+
+# 是否启用登录检验
+DP_ENABLE_LOGIN_CHECK=true
+
+# 是否使用布局组件
+DP_USE_LAYOUT=false
+
+# 是否使用本地路由
+DP_USE_LOCAL_ROUTES=true
+
+# ============================================
+# 多系统 API 地址配置
+# ============================================
+
+# 主业务 API 地址
+DP_API_HOST=
+
+# UAP 用户信息服务 API 地址
+DP_UAP_API_HOST=

package/template/.env.test.example

@@ -0,0 +1,64 @@
+# ============================================
+# test 环境配置
+# ============================================
+# 此文件包含测试环境的特定配置
+# 通过运行 npm run dev:test 或 npm run build:test 使用此配置
+
+# ============================================
+# 环境标识
+# ============================================
+DP_ENV=test
+
+# ============================================
+# 开发服务器配置
+# ============================================
+
+# 开发服务器端口号
+DP_PORT=3102
+
+# 开发服务器监听的主机地址
+DP_HOST=0.0.0.0
+
+# 允许访问的主机名
+DP_ALLOWED_HOSTS=
+
+# ============================================
+# 应用配置
+# ============================================
+
+# 登录页面 URL
+DP_LOGIN_URL=
+
+# 是否启用 HTTPS
+DP_HTTPS=false
+
+# 启动开发服务器时是否自动打开浏览器
+DP_OPEN=false
+
+# 自动打开的页面路径
+DP_OPEN_PAGE=/
+
+# 构建输出目录名称
+DP_BUILD_DIR=dist
+
+# 是否生成 source map 文件（测试环境建议关闭）
+DP_SOURCEMAP=false
+
+# 是否启用登录检验
+DP_ENABLE_LOGIN_CHECK=true
+
+# 是否使用布局组件
+DP_USE_LAYOUT=false
+
+# 是否使用本地路由
+DP_USE_LOCAL_ROUTES=true
+
+# ============================================
+# 多系统 API 地址配置
+# ============================================
+
+# 主业务 API 地址
+DP_API_HOST=
+
+# UAP 用户信息服务 API 地址
+DP_UAP_API_HOST=

package/template/.eslintignore

@@ -0,0 +1,2 @@
+node_modules/*
+dist/*

package/template/.eslintrc.cjs

@@ -0,0 +1,14 @@
+// This is a template file, ESLint config will be available after project initialization
+// Using a minimal config to avoid lint errors during template file checks
+module.exports = {
+    env: {
+        node: true,
+        es2021: true,
+    },
+    parserOptions: {
+        ecmaVersion: 2021,
+        sourceType: 'module',
+    },
+    // The actual config will be set after project initialization
+    // extends: ['@deppon/deppon-eslint-config'],
+};

package/template/.prettierrc.js

@@ -0,0 +1,3 @@
+const config = require('@deppon/deppon-eslint-config/prettier');
+
+module.exports = config;

package/template/.vscode/settings.json

@@ -0,0 +1,8 @@
+{
+    "typescript.tsdk": "node_modules/typescript/lib",
+    "editor.codeActionsOnSave": {
+        "source.fixAll.eslint": true
+    },
+    "editor.formatOnSave": true,
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+}

package/template/Dockerfile

@@ -0,0 +1,5 @@
+FROM swr.cn-east-3.myhuaweicloud.com/cicd-base-images/nginx:1.0
+ADD dist.tar /usr/share/nginx/html/
+RUN  mkdir /usr/share/nginx/html/{{PROJECT_NAME}} &&    mv /usr/share/nginx/html/dist/*  /usr/share/nginx/html/{{PROJECT_NAME}}
+RUN rm -rf /usr/share/nginx/html/dist/
+EXPOSE 80

package/template/README.md

@@ -0,0 +1,149 @@
+# 项目模板
+
+基于 @deppon 系列包的 Vue 3 项目模板
+
+## 启动
+
+```bash
+# 开发环境
+npm run dev
+
+# 测试环境
+npm run dev:test
+
+# 本地环境
+npm run dev:local
+```
+
+## 构建
+
+```bash
+# 生产环境构建
+npm run build
+
+# 测试环境构建
+npm run build:test
+```
+
+## 预览
+
+```bash
+# 预览生产构建
+npm run preview
+
+# 预览测试构建（带 base path）
+npm run preview:test
+
+# 使用预览服务器
+npm run serve:test
+```
+
+## 环境变量配置
+
+### 环境配置文件
+
+项目支持多个环境配置文件：
+
+- `.env` - 基础配置（公共配置项）
+- `.env.dev-local` - 本地开发环境
+- `.env.development` - 开发环境
+- `.env.test` - 测试环境
+- `.env.production` - 生产环境
+
+### 布局容器控制（DP_USE_LAYOUT）
+
+通过环境变量 `DP_USE_LAYOUT` 控制父级容器类型，用于模拟不同的测试环境：
+
+- **测试环境（默认）**：使用完整的 Layout 容器（包含侧边栏、头部等）
+
+  ```env
+  DP_USE_LAYOUT=true
+  # 或者不设置（默认为 true）
+  ```
+
+- **iframe 模式（生产环境）**：使用简单的 router-view 容器，模拟线上 iframe 环境
+
+  ```env
+  DP_USE_LAYOUT=false
+  ```
+
+**使用场景：**
+
+- 本地开发时，可以设置 `DP_USE_LAYOUT=false` 来模拟线上 iframe 环境的渲染方式
+- 测试环境默认使用完整的 Layout 容器，方便查看完整的页面布局
+
+**注意：**
+
+- `developmentRoutes` 只在开发环境（`import.meta.env.DEV === true`）才会加载
+- 生产环境只加载 `staticRoutes`（错误页面等）
+
+## 项目结构
+
+```
+src/
+├── api/              # API 接口文件
+├── assets/           # 静态资源（图片、JSON 等）
+├── components/       # 公共组件
+├── config/           # 配置文件（字典配置等）
+├── directives/       # 自定义指令（权限指令等）
+├── layouts/          # 布局组件
+├── router/           # 路由配置
+├── stores/           # Pinia 状态管理
+├── styles/           # 样式文件
+├── types/            # TypeScript 类型定义
+├── utils/            # 工具函数
+└── views/            # 页面组件
+```
+
+## 功能特性
+
+- ✅ Vue 3 + TypeScript
+- ✅ Element Plus UI 组件库
+- ✅ Vite 构建工具
+- ✅ 路由管理（@deppon/deppon-router）
+- ✅ 状态管理（@deppon/deppon-pinia）
+- ✅ 请求封装（@deppon/deppon-request）
+- ✅ 权限指令（v-permission）
+- ✅ 字典管理工具
+- ✅ 错误分析工具
+- ✅ 多环境配置支持
+- ✅ Legacy 浏览器支持
+
+## 开发规范
+
+### 代码检查
+
+```bash
+npm run lint
+```
+
+### 代码格式化
+
+```bash
+npm run format
+```
+
+## 部署
+
+### Docker 部署
+
+项目包含 `Dockerfile`，可以使用 Docker 进行部署。
+
+### Nginx 配置
+
+项目包含 `nginx.conf` 配置文件示例，需要根据实际项目路径修改配置中的 `/your-app-name` 路径。
+
+### 预览服务器
+
+项目包含 `preview-server.js`，用于本地预览构建后的文件。需要根据实际项目路径修改 `BASE_PATH` 配置。
+
+## 注意事项
+
+1. 创建新项目后，需要根据实际项目名称修改以下文件：
+   - `nginx.conf` 中的 `/your-app-name` 路径
+   - `preview-server.js` 中的 `BASE_PATH` 配置
+   - `.env` 中的 `DP_PUBLIC_PATH` 配置
+
+2. 权限指令（v-permission）需要根据实际项目实现权限检查函数，参考 `src/directives/permission.ts` 中的 `setPermissionCheckFn` 方法。
+
+3. 字典配置在 `src/config/dictionaryConfig.ts` 中定义，通过 `src/utils/dictionary.ts` 中的工具函数使用。

package/template/commitlint.config.js

@@ -0,0 +1,11 @@
+module.exports = {
+    extends: ['@commitlint/config-conventional'],
+    rules: {
+        'type-enum': [
+            2,
+            'always',
+            ['build', 'chore', 'ci', 'docs', 'feat', 'fix', 'perf', 'refactor', 'revert', 'style', 'test'],
+        ],
+    },
+};
+

package/template/gitignore

@@ -0,0 +1,8 @@
+.DS_Store
+node_modules/
+npm-debug.log
+dist/
+.git
+.idea
+*.log
+.env

package/template/index.html

@@ -0,0 +1,18 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+    <head>
+        <meta charset="UTF-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+        <meta name="description" content="德邦前端应用" />
+        <title>德邦</title>
+        <link type="favicon" rel="shortcut icon" href="https://www.deppon.com/cms/console/sites/favicon.ico" />
+        <!-- DNS 预解析 -->
+        <link rel="dns-prefetch" href="https://www.deppon.com" />
+        <!-- 预连接关键资源 -->
+        <link rel="preconnect" href="https://www.deppon.com" crossorigin />
+    </head>
+    <body>
+        <div id="app"></div>
+        <script type="module" src="/src/main.ts"></script>
+    </body>
+</html>

package/template/nginx.conf

@@ -0,0 +1,70 @@
+server {
+    listen       80;
+    server_name  localhost;
+
+    #charset koi8-r;
+    #access_log  /var/log/nginx/log/host.access.log  main;
+
+    root   /usr/share/nginx/html;
+    index  index.html index.htm;
+
+    # 处理应用路径不带斜杠的情况，重定向到带斜杠（精确匹配，优先级最高）
+    # 注意：需要根据实际项目路径修改 /your-app-name
+    location = /your-app-name {
+        return 301 /your-app-name/;
+    }
+    
+    # 处理静态资源（assets）- 必须在主 location 之前匹配
+    # 根据构建结果，所有资源路径都是 /your-app-name/assets/
+    # 包括：js、css、fonts 等
+    # 注意：需要根据实际项目路径修改 /your-app-name
+    location ~ ^/your-app-name/assets/(.*)$ {
+        alias /usr/share/nginx/html/your-app-name/assets/$1;
+        expires 1y;
+        add_header Cache-Control "public, immutable";
+        access_log off;
+    }
+    
+    # 处理 favicon.ico
+    location = /your-app-name/favicon.ico {
+        alias /usr/share/nginx/html/your-app-name/favicon.ico;
+        expires 1y;
+        add_header Cache-Control "public, immutable";
+        access_log off;
+    }
+    
+    # 处理 iframe.html（如果存在）
+    location = /your-app-name/iframe.html {
+        alias /usr/share/nginx/html/your-app-name/iframe.html;
+        access_log off;
+    }
+    
+    # 配置应用路径，支持 Vue Router history 模式（前缀匹配，优先级第二）
+    # 注意：这个 location 必须放在 assets 之后，但要在根路径之前
+    # 注意：需要根据实际项目路径修改 /your-app-name
+    location /your-app-name/ {
+        alias /usr/share/nginx/html/your-app-name/;
+        # 尝试访问文件，如果不存在则尝试目录，最后回退到 index.html（支持 Vue Router）
+        try_files $uri $uri/ /your-app-name/index.html;
+        index index.html;
+        # 禁止目录列表
+        autoindex off;
+        # 确保可以访问文件
+        access_log on;
+    }
+
+    # 根路径配置（通用匹配，优先级最低，放在最后）
+    location / {
+        root   /usr/share/nginx/html;
+        index  index.html index.htm;
+        try_files $uri $uri/ /index.html;
+    }
+
+    #error_page  404              /404.html;
+
+    # redirect server error pages to the static page /50x.html
+    error_page   500 502 503 504  /50x.html;
+    location = /50x.html {
+        root   /usr/share/nginx/html;
+    }
+}

package/template/npmrc

@@ -0,0 +1,2 @@
+registry=https://registry.npmjs.org/
+@deppon:registry=https://registry.npmjs.org/

package/template/package.json

@@ -0,0 +1,49 @@
+{
+    "name": "",
+    "description": "",
+    "version": "1.3.230",
+    "license": "MIT",
+    "scripts": {
+        "dev": "vite --mode development",
+        "dev:test": "vite --mode test",
+        "dev:local": "vite --mode dev-local",
+        "build:test": "vite build --mode test",
+        "build": "vite build --mode production",
+        "preview": "vite preview",
+        "preview:test": "vite preview --base /",
+        "serve:test": "node preview-server.js",
+        "lint": "eslint . --ext js,ts,vue",
+        "format": "prettier --write **/*.{js,ts,vue} && eslint . --ext js,ts,vue --fix"
+    },
+    "dependencies": {
+        "@deppon/deppon-assets": "^2.1.0",
+        "@deppon/deppon-auth": "^2.1.0",
+        "@deppon/deppon-pinia": "^2.1.0",
+        "@deppon/deppon-request": "^2.1.0",
+        "@deppon/deppon-router": "^2.1.0",
+        "@deppon/deppon-template": "^2.1.0",
+        "@deppon/deppon-ui": "^2.1.0",
+        "@deppon/deppon-utils": "^2.1.0",
+        "dayjs": "^1.11.19",
+        "echarts": "^6.0.0",
+        "element-plus": "^2.11.7",
+        "exceljs": "^4.4.0",
+        "file-saver": "^2.0.5",
+        "nprogress": "^0.2.0",
+        "pinyin-pro": "^3.27.0",
+        "vue": "^3.5.24"
+    },
+    "devDependencies": {
+        "@deppon/deppon-eslint-config": "^2.1.0",
+        "@types/node": "^24.10.1",
+        "@types/nprogress": "^0.2.3",
+        "@vitejs/plugin-legacy": "^5.4.0",
+        "@vitejs/plugin-vue": "^5.0.0",
+        "consola": "^3.4.2",
+        "cross-env": "^10.1.0",
+        "less": "^4.4.2",
+        "terser": "^5.46.0",
+        "typescript": "^5.9.3",
+        "vite": "^5.0.0"
+    }
+}