create-admin-mvp 1.0.0

package/templates/admin-portal/.env.production

@@ -0,0 +1,41 @@
+# 生产环境变量
+# 生产环境（npm run build）会使用这些变量
+
+# 环境模式
+NODE_ENV=production
+
+# API 基础 URL（生产环境）
+VITE_API_BASE_URL=https://api.example.com/api
+
+# 是否启用 Mock 数据（生产环境）
+VITE_ENABLE_MOCK=false
+
+# 是否启用性能监控（生产环境）
+VITE_ENABLE_PERFORMANCE=true
+
+# 是否启用错误监控（生产环境）
+VITE_ENABLE_ERROR_TRACKING=true
+
+# 是否启用用户行为分析（生产环境）
+VITE_ENABLE_USER_ANALYTICS=true
+
+# 是否启用热更新（生产环境）
+VITE_HMR=false
+
+# 是否启用 Source Map（生产环境）
+VITE_SOURCE_MAP=false
+
+# 是否启用 ESLint（生产环境）
+VITE_ENABLE_ESLINT=false
+
+# 是否启用 Prettier（生产环境）
+VITE_ENABLE_PRETTIER=false
+
+# 是否启用 Stylelint（生产环境）
+VITE_ENABLE_STYLELINT=false
+
+# 是否启用 Vitest（生产环境）
+VITE_ENABLE_VITEST=false
+
+# 是否启用 Playwright（生产环境）
+VITE_ENABLE_PLAYWRIGHT=false

package/templates/admin-portal/.eslintrc.cjs

@@ -0,0 +1,45 @@
+module.exports = {
+  // 告诉 ESLint 这是项目的根配置文件，停止向上级目录继续查找
+  root: true,
+  // 声明代码运行环境：浏览器、ES2021 语法、Node.js 全局变量均可用
+  
+  env: {
+    browser: true, // 告诉 ESLint 识别浏览器全局变量（window、document 等），避免误报未定义
+    es2021: true,  // 允许使用 ES2021 新语法及全局变量（如 Promise.any、WeakRef），防止解析错误
+    node: true,    // 识别 Node.js 全局变量（process、__dirname 等），确保在 Node 环境不报错
+  },
+  // 继承官方推荐规则集、Vue3+TypeScript 推荐规则集、Prettier 格式化冲突覆盖
+  
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:vue/vue3-recommended',
+    'prettier',
+  ],
+  // 解析器选项：使用最新 ECMAScript 版本、@typescript-eslint/parser 解析 TS、按 ESModule 解析
+  parserOptions: {
+    ecmaVersion: 'latest',
+    parser: '@typescript-eslint/parser',
+    sourceType: 'module',
+  },
+  // 显式启用 vue 与 @typescript-eslint 插件，让对应规则生效
+  plugins: ['vue', '@typescript-eslint'],
+  // 自定义规则：关闭 Vue 多词组件名强制；未使用变量报错；any 类型仅警告；生产环境 console/debugger 警告，开发环境关闭
+  rules: {
+    'vue/multi-word-component-names': 'off',
+    'vue/no-unused-vars': 'error',
+    '@typescript-eslint/no-unused-vars': 'error',
+    '@typescript-eslint/no-explicit-any': 'warn',
+    'no-console': process.env.NODE_ENV === 'production' ? 'warn' : 'off',
+    'no-debugger': process.env.NODE_ENV === 'production' ? 'warn' : 'off',
+  },
+  // 针对 *.vue 文件单独覆盖：强制 script 标签内部使用 2 空格缩进，且相对 <script> 标签再缩进 1 级
+  overrides: [
+    {
+      files: ['*.vue'],
+      rules: {
+        'vue/script-indent': ['error', 2, { baseIndent: 1 }],
+      },
+    },
+  ],
+}

package/templates/admin-portal/.github/workflows/ci.yml

@@ -0,0 +1,217 @@
+# CI/CD 配置文件
+# 用于自动化构建、测试和部署
+
+name: CI/CD
+
+# 触发条件
+on:
+  push:
+    branches:
+      - main
+      - develop
+  pull_request:
+    branches:
+      - main
+      - develop
+
+# 环境变量
+env:
+  NODE_VERSION: '18'
+
+# 任务
+jobs:
+  # 代码检查
+  lint:
+    name: 代码检查
+    runs-on: ubuntu-latest
+
+    steps:
+      # 检出代码
+      - name: 检出代码
+        uses: actions/checkout@v4
+
+      # 设置 Node.js 环境
+      - name: 设置 Node.js 环境
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      # 安装依赖
+      - name: 安装依赖
+        run: npm ci
+
+      # 运行 ESLint
+      - name: 运行 ESLint
+        run: npm run lint:eslint
+
+      # 运行 Prettier
+      - name: 运行 Prettier
+        run: npm run lint:prettier
+
+      # 运行 Stylelint
+      - name: 运行 Stylelint
+        run: npm run lint:stylelint
+
+  # 单元测试
+  test:
+    name: 单元测试
+    runs-on: ubuntu-latest
+
+    steps:
+      # 检出代码
+      - name: 检出代码
+        uses: actions/checkout@v4
+
+      # 设置 Node.js 环境
+      - name: 设置 Node.js 环境
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      # 安装依赖
+      - name: 安装依赖
+        run: npm ci
+
+      # 运行单元测试
+      - name: 运行单元测试
+        run: npm run test:unit
+
+      # 上传测试覆盖率报告
+      - name: 上传测试覆盖率报告
+        uses: codecov/codecov-action@v3
+        with:
+          files: ./coverage/coverage-final.json
+          flags: unittests
+          name: codecov-umbrella
+
+  # E2E 测试
+  e2e:
+    name: E2E 测试
+    runs-on: ubuntu-latest
+
+    steps:
+      # 检出代码
+      - name: 检出代码
+        uses: actions/checkout@v4
+
+      # 设置 Node.js 环境
+      - name: 设置 Node.js 环境
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      # 安装依赖
+      - name: 安装依赖
+        run: npm ci
+
+      # 安装 Playwright 浏览器
+      - name: 安装 Playwright 浏览器
+        run: npx playwright install --with-deps
+
+      # 运行 E2E 测试
+      - name: 运行 E2E 测试
+        run: npm run test:e2e
+
+      # 上传测试报告
+      - name: 上传测试报告
+        if: always()
+        uses: actions/upload-artifact@v3
+        with:
+          name: playwright-report
+          path: playwright-report/
+          retention-days: 30
+
+  # 构建
+  build:
+    name: 构建
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+
+    steps:
+      # 检出代码
+      - name: 检出代码
+        uses: actions/checkout@v4
+
+      # 设置 Node.js 环境
+      - name: 设置 Node.js 环境
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      # 安装依赖
+      - name: 安装依赖
+        run: npm ci
+
+      # 构建项目
+      - name: 构建项目
+        run: npm run build
+
+      # 上传构建产物
+      - name: 上传构建产物
+        uses: actions/upload-artifact@v3
+        with:
+          name: build
+          path: dist/
+          retention-days: 7
+
+  # 部署
+  deploy:
+    name: 部署
+    runs-on: ubuntu-latest
+    needs: [build]
+    if: github.ref == 'refs/heads/main'
+
+    steps:
+      # 检出代码
+      - name: 检出代码
+        uses: actions/checkout@v4
+
+      # 设置 Node.js 环境
+      - name: 设置 Node.js 环境
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      # 安装依赖
+      - name: 安装依赖
+        run: npm ci
+
+      # 下载构建产物
+      - name: 下载构建产物
+        uses: actions/download-artifact@v3
+        with:
+          name: build
+          path: dist/
+
+      # 登录 Docker Hub
+      - name: 登录 Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_PASSWORD }}
+
+      # 构建 Docker 镜像
+      - name: 构建 Docker 镜像
+        run: docker build -t ${{ secrets.DOCKER_USERNAME }}/my-app:${{ github.sha }} .
+
+      # 推送 Docker 镜像
+      - name: 推送 Docker 镜像
+        run: docker push ${{ secrets.DOCKER_USERNAME }}/my-app:${{ github.sha }}
+
+      # 部署到服务器
+      - name: 部署到服务器
+        uses: appleboy/ssh-action@v1.0.0
+        with:
+          host: ${{ secrets.SERVER_HOST }}
+          username: ${{ secrets.SERVER_USERNAME }}
+          key: ${{ secrets.SERVER_SSH_KEY }}
+          script: |
+            docker pull ${{ secrets.DOCKER_USERNAME }}/my-app:${{ github.sha }}
+            docker stop my-app || true
+            docker rm my-app || true
+            docker run -d --name my-app -p 80:80 ${{ secrets.DOCKER_USERNAME }}/my-app:${{ github.sha }}

package/templates/admin-portal/.husky/commit-msg

@@ -0,0 +1,11 @@
+#!/usr/bin/env sh
+# filepath: /Users/xuhuiping/admin-mvp/packages/cli/templates/admin-portal/.husky/commit-msg
+# Git commit-msg hook
+# 在提交信息输入后执行，检查提交信息的格式
+
+# 使用 commitlint 检查提交信息格式是否符合规范
+# 1. npx：调用 Node 包执行器，确保使用本地依赖中的 commitlint
+# 2. --no：禁止自动安装缺失的包，避免意外修改依赖
+# 3. commitlint：执行 commitlint 命令，读取项目中的 commitlint 配置
+# 4. --edit "$1"：告诉 commitlint 读取 Git 传入的提交信息文件路径（$1），并对其进行格式校验
+npx --no -- commitlint --edit "$1"

package/templates/admin-portal/.husky/pre-commit

@@ -0,0 +1,10 @@
+#!/usr/bin/env sh
+# filepath: /Users/xuhuiping/admin-mvp/packages/cli/templates/admin-portal/.husky/pre-commit
+# Git pre-commit hook
+# 在提交前执行，检查代码规范
+
+# 使用 lint-staged 对暂存区的文件进行检查和格式化
+# 1. npx：调用 Node 包执行器，确保使用本地依赖中的 lint-staged
+# 2. --no：禁止自动安装缺失的包，避免意外修改依赖
+# 3. lint-staged：执行 lint-staged 命令，读取项目中的 .lintstagedrc.json 配置
+npx --no lint-staged

package/templates/admin-portal/.lintstagedrc.json

@@ -0,0 +1,13 @@
+
+{
+  "*.{js,jsx,ts,tsx,vue}": [
+    "eslint --fix",
+    "prettier --write"
+  ],
+  "*.{css,scss,vue}": [
+    "stylelint --fix"
+  ],
+  "*.{json,md}": [
+    "prettier --write"
+  ]
+}

package/templates/admin-portal/.prettierrc.cjs

@@ -0,0 +1,19 @@
+module.exports = {
+  // 是否使用分号
+  semi: true,
+  
+  // 缩进空格数
+  tabWidth: 2,
+  
+  // 是否使用单引号
+  singleQuote: true,
+  
+  // 每行最大字符数
+  printWidth: 100,
+  
+  // 尾随逗号（ES5 兼容）
+  trailingComma: 'es5',
+  
+  // 箭头函数参数括号（单参数时省略）
+  arrowParens: 'avoid'
+}

package/templates/admin-portal/.stylelintrc.cjs

@@ -0,0 +1,35 @@
+module.exports = {
+  extends: [
+    'stylelint-config-standard',
+    'stylelint-config-recommended-vue',
+    'stylelint-config-prettier',
+  ],
+  rules: {
+    'selector-class-pattern': null,
+    'no-descending-specificity': null,
+    'comment-empty-line-before': null,
+    'number-leading-zero': null,
+    'rule-empty-line-before': null,
+    'value-keyword-case': null,
+    'color-function-notation': null,
+    'alpha-value-notation': null,
+    'selector-id-pattern': null,
+    'selector-type-no-unknown': null,
+    'selector-pseudo-class-no-unknown': [
+      true,
+      {
+        ignorePseudoClasses: ['deep'],
+      },
+    ],
+  },
+  overrides: [
+    {
+      files: ['**/*.vue'],
+      customSyntax: 'postcss-html',
+    },
+    {
+      files: ['**/*.less'],
+      customSyntax: 'postcss-less',
+    },
+  ],
+}

package/templates/admin-portal/Dockerfile

@@ -0,0 +1,35 @@
+# Dockerfile
+# 用于构建 Docker 镜像
+
+# 阶段1：构建阶段
+FROM node:18-alpine AS builder
+
+# 设置工作目录
+WORKDIR /app
+
+# 复制 package.json 和 package-lock.json
+COPY package*.json ./
+
+# 安装依赖
+RUN npm ci
+
+# 复制源代码
+COPY . .
+
+# 构建项目
+RUN npm run build
+
+# 阶段2：生产阶段
+FROM nginx:alpine
+
+# 复制 nginx 配置文件
+COPY nginx.conf /etc/nginx/conf.d/default.conf
+
+# 从构建阶段复制构建产物
+COPY --from=builder /app/dist /usr/share/nginx/html
+
+# 暴露端口
+EXPOSE 80
+
+# 启动 nginx
+CMD ["nginx", "-g", "daemon off;"]

package/templates/admin-portal/README.md

@@ -0,0 +1,196 @@
+# Admin Portal
+
+企业级 Vue 3 + TypeScript + Vite 项目脚手架，包含完整的工程化配置。
+
+## 特性
+
+- 🚀 **Vue 3** - 使用 Composition API
+- 💎 **TypeScript** - 类型安全
+- ⚡ **Vite** - 快速的构建工具
+- 🎨 **代码规范** - ESLint + Prettier + Stylelint
+- 🔒 **Git Hooks** - Husky + lint-staged + Commitlint
+- 🧪 **自动化测试** - Vitest + Playwright
+- 🐳 **Docker** - 容器化部署
+- 🚀 **CI/CD** - GitHub Actions
+
+## 快速开始
+
+### 安装依赖
+
+```bash
+npm install
+```
+
+### 启动开发服务器
+
+```bash
+npm run dev
+```
+
+### 构建生产版本
+
+```bash
+npm run build
+```
+
+### 预览生产构建
+
+```bash
+npm run preview
+```
+
+## 代码规范
+
+### 运行代码检查
+
+```bash
+# ESLint
+npm run lint:eslint
+
+# Prettier
+npm run lint:prettier
+
+# Stylelint
+npm run lint:stylelint
+
+# 所有检查
+npm run lint
+```
+
+### 自动修复
+
+```bash
+# ESLint 自动修复
+npm run lint:eslint -- --fix
+
+# Prettier 自动修复
+npm run lint:prettier -- --write
+
+# Stylelint 自动修复
+npm run lint:stylelint -- --fix
+```
+
+## 测试
+
+### 单元测试
+
+```bash
+# 运行单元测试
+npm run test:unit
+
+# 运行单元测试并生成覆盖率报告
+npm run test:unit -- --coverage
+
+# 监听模式
+npm run test:unit -- --watch
+```
+
+### E2E 测试
+
+```bash
+# 运行 E2E 测试
+npm run test:e2e
+
+# 运行 E2E 测试并生成报告
+npm run test:e2e -- --reporter=html
+
+# 调试模式
+npm run test:e2e -- --debug
+```
+
+## Docker
+
+### 构建 Docker 镜像
+
+```bash
+docker build -t my-app .
+```
+
+### 运行 Docker 容器
+
+```bash
+docker run -p 80:80 my-app
+```
+
+### 使用 Docker Compose
+
+```bash
+# 启动所有服务
+docker-compose up -d
+
+# 停止所有服务
+docker-compose down
+
+# 查看服务状态
+docker-compose ps
+```
+
+## CI/CD
+
+### 配置 GitHub Secrets
+
+在 GitHub 仓库中配置以下 Secrets：
+
+| Secret 名称 | 说明 |
+|------------|------|
+| `DOCKER_USERNAME` | Docker Hub 用户名 |
+| `DOCKER_PASSWORD` | Docker Hub 密码 |
+| `SERVER_HOST` | 服务器地址 |
+| `SERVER_USERNAME` | 服务器用户名 |
+| `SERVER_SSH_KEY` | 服务器 SSH 密钥 |
+
+### 触发 CI/CD
+
+推送到 `main` 或 `develop` 分支会自动触发 CI/CD 流程。
+
+## 项目结构
+
+```
+.
+├── .github/workflows/    # CI/CD 配置
+├── .husky/               # Git Hooks
+├── public/               # 公共资源
+├── src/
+│   ├── assets/           # 静态资源
+│   │   └── styles/       # 样式文件
+│   ├── router/           # 路由配置
+│   ├── views/            # 页面组件
+│   ├── App.vue           # 根组件
+│   └── main.ts           # 入口文件
+├── tests/
+│   ├── e2e/              # E2E 测试
+│   └── unit/             # 单元测试
+├── .env                  # 环境变量
+├── .env.development      # 开发环境变量
+├── .env.production       # 生产环境变量
+├── Dockerfile            # Docker 配置
+├── docker-compose.yml    # Docker Compose 配置
+├── nginx.conf            # Nginx 配置
+├── package.json          # 项目配置
+├── tsconfig.json         # TypeScript 配置
+└── vite.config.ts        # Vite 配置
+```
+
+## 环境变量
+
+| 变量名 | 说明 | 默认值 |
+|--------|------|--------|
+| `VITE_APP_NAME` | 应用名称 | `Admin Portal` |
+| `VITE_API_BASE_URL` | API 基础 URL | `/api` |
+| `VITE_ENABLE_MOCK` | 是否启用 Mock | `false` |
+
+## 贡献指南
+
+1. Fork 本仓库
+2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交更改 (`git commit -m 'feat: add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 创建 Pull Request
+
+## 许可证
+
+MIT License
+
+## 联系方式
+
+如有问题，请创建 Issue。

package/templates/admin-portal/commitlint.config.cjs

@@ -0,0 +1,41 @@
+// filepath: /Users/xuhuiping/admin-mvp/packages/cli/templates/admin-portal/commitlint.config.cjs
+// Commitlint 配置文件
+// 规范 Git 提交信息的格式
+
+module.exports = {
+  // 继承标准的提交信息规范（Conventional Commits）
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    // 限制提交信息的类型，只允许以下类型
+    'type-enum': [
+      2,           // 错误级别：2 = error（提交失败）
+      'always',     // 必须匹配，不允许其他类型
+      [
+        'feat',     // 新功能（feature）
+        'fix',      // 修复bug（bug fix）
+        'docs',     // 文档变更（documentation）
+        'style',    // 代码格式调整（不影响代码运行的变动）
+        'refactor', // 重构（既不是新增功能，也不是修复bug的代码变动）
+        'perf',     // 性能优化（performance）
+        'test',     // 测试相关（tests）
+        'chore',    // 构建过程或辅助工具变动（如更新依赖）
+        'revert',   // 回退之前的提交（revert）
+        'build',    // 打包（build system）
+      ],
+    ],
+    // 关闭类型大小写检查（允许大写或小写）
+    'type-case': [0],
+    // 关闭类型不能为空的检查（允许没有类型）
+    'type-empty': [0],
+    // 关闭作用域不能为空的检查（允许没有作用域）
+    'scope-empty': [0],
+    // 关闭作用域大小写检查（允许大写或小写）
+    'scope-case': [0],
+    // 关闭主题不能以句号结尾的检查（允许句号结尾）
+    'subject-full-stop': [0, 'never'],
+    // 关闭主题大小写检查（允许大写或小写）
+    'subject-case': [0, 'never'],
+    // 关闭标题最大长度检查（允许超过72个字符）
+    'header-max-length': [0, 'always', 72],
+  },
+}

package/templates/admin-portal/docker-compose.yml

@@ -0,0 +1,35 @@
+# docker-compose.yml
+# 用于编排 Docker 容器
+
+version: '3.8'
+
+services:
+  # 前端应用
+  app:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    ports:
+      - "80:80"
+    environment:
+      - NODE_ENV=production
+    restart: always
+    networks:
+      - app-network
+
+  # API 服务（可选）
+  api:
+    image: node:18-alpine
+    working_dir: /app
+    volumes:
+      - ./api:/app
+    ports:
+      - "3000:3000"
+    command: npm start
+    restart: always
+    networks:
+      - app-network
+
+networks:
+  app-network:
+    driver: bridge