前端骨架与使用说明

• 目录结构：

  • src/: Vue 源码示例（组件、视图、样式）
  • public/swagger/: Swagger UI 静态页面（用于预览 OpenAPI）
  • openapi/import_openapi.js: 简单脚本，将仓库根目录的 OpenAPI JSON 复制到 frontend/public/swagger/openapi.json

• 快速开始（开发者手动执行）：

1. 如果已有 Vue 项目，将 src/styles 中的 SCSS 文件合并到现有项目中。

2. 将 public/swagger/openapi.json 放到能被静态服务器访问的位置，打开 public/swagger/index.html 查看 Swagger UI。

3. 若需要生成 API 客户端，建议使用 OpenAPI Generator 或 Swagger Codegen。

4. 开发运行（示例步骤）：

   • 进入 frontend/ 目录并安装依赖：

     cd frontend
     npm install
     

   • 运行开发服务器：

     npm run dev
     

   • 将根目录的 默认模块.openapi.json 复制到 Swagger 静态目录（脚本会帮助复制）：

     npm run import-openapi
     

   • 在另一个终端运行 Swagger 静态预览（可选）：

     npm run serve-swagger
     

     打开 http://localhost:8081 查看 Swagger UI（或直接在 dev server 中访问 http://localhost:5173/public/swagger/index.html）。