# third-level-warehouse

**Repository Path**: Westbrook04/third-level-warehouse

## Basic Information

- **Project Name**: third-level-warehouse
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-07-16
- **Last Updated**: 2026-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# third-level-warehouse

基于 Electron + Vue 3 + TypeScript 的桌面端管理系统壳工程，使用 `electron-vite` 构建，前端采用 `Element Plus`、`Pinia`、`Vue Router`、`Tailwind CSS` 等技术栈。

## 项目概览

从当前代码结构看，这个项目主要包含以下部分：

- `src/main`：Electron 主进程，负责创建窗口和注册 IPC
- `src/preload`：预加载脚本，向渲染进程暴露安全能力
- `src/renderer`：Vue 前端应用
- `resources` 和 `build`：应用图标、桌面端打包资源和证书配置

业务层面已包含的模块：

- 登录、注册、忘记密码
- 仪表盘
- 机柜管理
- 系统管理
- 结果页与异常页
- 外部页面 iframe 嵌入

## 技术栈

- Electron
- electron-vite
- Vue 3
- TypeScript
- Vue Router
- Pinia
- Element Plus
- Tailwind CSS 4
- Axios
- ECharts
- i18n

## 运行环境

- Node.js 18+ 建议版本
- npm

## 安装

```bash
npm install
```

## 开发运行

```bash
npm run dev
```

开发模式下会启动 Electron 主进程和渲染进程，渲染端由 `electron-vite` 提供热更新。

## 构建

```bash
npm run build
```

## 打包

```bash
# Windows
npm run build:win

# macOS
npm run build:mac

# Linux
npm run build:linux
```

## 其他脚本

- `npm run start`：预览构建结果
- `npm run lint`：ESLint 检查
- `npm run format`：Prettier 格式化
- `npm run typecheck`：TypeScript 类型检查
- `npm run clean:dev`：清理渲染端开发缓存

## 目录结构

```text
src/
  main/        Electron 主进程
  preload/     预加载脚本
  renderer/    Vue 前端应用
resources/     运行时资源
build/         打包资源配置
```

## 主进程说明

主进程入口位于 [`src/main/index.ts`](./src/main/index.ts)。

当前窗口配置：

- 默认窗口尺寸为 `1360 x 960`
- 最小窗口尺寸为 `1360 x 960`
- 自动隐藏菜单栏
- 通过 preload 注入渲染端能力
- 开发环境加载 `ELECTRON_RENDERER_URL`
- 生产环境加载打包后的 `index.html`

目前暴露的 IPC 主要是窗口缩放能力：

- `getZoomFactor`
- `setZoomFactor`

对应实现位于：

- [`src/main/setMain.ts`](./src/main/setMain.ts)
- [`src/ipcFun/page.ts`](./src/ipcFun/page.ts)
- [`src/preload/modules/page.ts`](./src/preload/modules/page.ts)

## 前端结构

前端入口位于 [`src/renderer/src/main.ts`](./src/renderer/src/main.ts)。

应用初始化流程：

1. 创建 Vue 应用
2. 注入 Pinia
3. 注入路由
4. 注册全局指令
5. 注册错误处理
6. 启用国际化
7. 挂载到 `#app`

### 路由

路由采用 `hash` 模式，静态路由定义在：

- [`src/renderer/src/router/routes/staticRoutes.ts`](./src/renderer/src/router/routes/staticRoutes.ts)

模块化动态路由包括：

- 仪表盘
- 机柜管理
- 系统管理
- 结果页
- 异常页

相关入口：

- [`src/renderer/src/router/modules/index.ts`](./src/renderer/src/router/modules/index.ts)

### 主要页面

- 登录页：`/auth/login`
- 注册页：`/auth/register`
- 忘记密码：`/auth/forget-password`
- 控制台：`/console`
- 机柜列表：`/cabint/cabinetList`
- 机柜详情：`/cabint/detail`
- 用户管理：`/system/user`
- 角色管理：`/system/role`
- 菜单管理：`/system/menu`

## 配置说明

`electron.vite.config.ts` 中配置了：

- Vite 别名：`@`、`@views`、`@imgs`、`@icons`、`@utils`、`@stores`、`@styles`
- 开发服务器代理：`/api`
- 构建目标：`es2015`
- 压缩：gzip
- Element Plus 按需加载
- 自动导入 Vue、Vue Router、Pinia、VueUse

## 备注

- 项目当前包含 `README.md` 的基础内容，但已被重写为更贴近实际工程结构的说明。
- 如果需要，我可以继续补一版更完整的 README，包括接口说明、环境变量、页面截图和发布流程。