xiaotutongxue/frontend-pc

PC 管理端（frontend-pc）

深学在线 · 管理端。纯 Vue 3 + Naive UI（2026-10 从 Gi Admin Pro + Arco Design Vue 重搭）。

上一版这份 README 是 Gi Admin Pro 的模板原文（含它的演示账号 admin / 123456），已整体替换 —— 那个账号在本项目里不存在。

技术栈

项	值
框架	Vue 3.5 + TypeScript + Vite 7
UI	Naive UI 2.42（无 Arco / Gi 依赖）
状态	Pinia（pinia-plugin-persistedstate）
请求	axios（src/utils/http.ts 统一封装）
样式	SCSS（Stylelint 已移除，只有 ESLint）

常用命令

pnpm install
pnpm dev          # → http://localhost:5173（/api 代理到 http://localhost:8080）
pnpm build        # 生产构建 → dist/
pnpm typecheck    # vue-tsc（当前 0 错）
pnpm lint         # ESLint（@antfu/eslint-config）

• 没有 Mock：pnpm dev 把 /api 代理到后端 8080 → 后端不起着就没有数据
• 路径别名：@ → src/

演示账号（本地 dev）

账号	密码	租户码	角色
admin	Admin@123	demo	学校管理员
platform	Platform@123	—	平台运营

账号在多个单位下重名时，登录页才会出现「租户码」输入框（服务端返回 40012）。 一键登录脚本：python scripts/dev-login.py。

目录

src/
├── apis/xt/        接口模块（按业务域分文件）+ types.ts
├── composables/    pagination.ts（列表页分页器统一参数）
├── config/         xt-routes.ts（业务菜单表：菜单键 ↔ 路由 ↔ 视图 ↔ 分组）
├── icons/          AppIcon.vue + icon-data.ts（由 scripts/extract-pc-icons.py 生成）
├── layout/         AppSider / AppHeader / index.vue
├── router/         本地菜单表按后端 menuKeys 过滤后注册
├── stores/         user.ts / acting-tenant.ts / app.ts
├── styles/         index.scss（只放跨页面样式）
├── utils/          http.ts / naive.ts / tag.ts / format.ts / auth.ts / rsa.ts
└── views/          页面（每个菜单一个目录）

写代码前必读

AGENTS.md 与 .agents/（本目录内的规范，已按 Naive UI 重写）。四条最容易写错的：

1. 没有 auto-import —— 组件与 API 全部显式 import；
2. 没有 v-hasPerm —— 权限判断写 useUserStore().has('码')，字符串与后端 PermissionDef 逐字一致；
3. n-tag 的 type 必须过 @/utils/tag.ts —— Arco 色词直接透传会静默变灰；
4. 图标集升级后重跑 scripts/extract-pc-icons.py —— 缺图标是空占位、不报错。