# zhipin-cloud-front-admin

**Repository Path**: zhipin-cloud/zhipin-cloud-front-admin

## Basic Information

- **Project Name**: zhipin-cloud-front-admin
- **Description**: 后台管理端前端代码仓库


- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-07-17
- **Last Updated**: 2026-10-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智聘云图 · 平台管理系统（管理端前端）

基于 Vue 3 + TypeScript + Vite + TDesign Vue Next 的管理端前端工程，与 zhipin-cloud-ms-web-admin（BFF）接口一一对应。

## 技术栈

- Vue 3（Composition API + script setup）
- TypeScript
- Vite 5
- TDesign Vue Next（组件库）+ tdesign-icons-vue-next（图标）
- Pinia + pinia-plugin-persistedstate（状态与登录态持久化）
- Vue Router 4（路由守卫）
- Axios（统一请求封装）
- Sass（样式变量与全局覆盖）

## 目录结构

    src/
      api/          接口封装（与后端 BFF 对应）
      types/        接口/业务类型定义
      router/       路由与守卫
      store/        Pinia 状态
      layouts/      基础布局（侧边栏 + 内容区）
      components/   通用组件（状态标签、Logo 占位等）
      styles/       全局样式与 TDesign 主题覆盖
      utils/        工具（token 存储、日期格式化、菜单配置）
      views/        页面（登录/工作台/企业入驻审核/企业管理/求职者管理/招聘者管理）

## 后端接口对应

所有请求经网关 /admin 前缀转发到 zhipin-cloud-ms-web-admin：

- 登录/退出/当前用户：/api/v1/auth/login、/api/v1/auth/logout、/api/v1/auth/user/info
- 企业入驻审核：/api/v1/admin/enterprise-reviews（列表/counts/详情/approve/reject）
- 企业管理：/api/v1/admin/companies（列表/详情）
- 求职者管理：/api/v1/admin/candidates（列表/counts/freeze/unfreeze）
- 招聘者管理：/api/v1/admin/recruiters（列表/counts/freeze/unfreeze）

统一响应体为 R：code=0 成功，非 0 为业务错误；分页响应为 PageResponse（counts/pageSize/pages/page/items）。

## 本地开发

    npm install
    npm run dev

开发态通过 Vite 代理把 /admin 转发到网关（默认 http://localhost:8600，可在 .env.development 的 VITE_PROXY_TARGET 修改）。

## 构建

    npm run build
    npm run type-check

## 说明

- 登录态 token 存于 localStorage（utils/auth），用户信息存于 Pinia 持久化。
- 营业执照/执照图片后端仅返回文件 ID（licenseFileId），当前无独立文件服务，前端以占位区展示文件 ID，待文件链路就绪后替换为真实预览。
- 工作台统计卡片与最新入驻申请均由现有计数/列表接口聚合，未引入额外假数据。