lovife
e94e76ba0f
naive 的 NFormItem 一旦用了 #feedback 插槽，renderExplains 就永不渲染
（children || feedback ? feedback : …），校验错误被完全遮住 —— 用户看到的是
"红框 + 一句无关的正常提示"，现象上等价于"点了保存没反应"。RoleFormModal 里
早就记录过这个机制，但只在自己那个文件绕开了，没固化成约定，于是扩散到 7 处。
- 7 处 validate() 的 catch 改成 message.error(firstError(errors) ?? 兜底)
（login / org / role / user / task 建改任务 / 材料规则 / 表单设计）
- ⚠️ firstError 必须摊平后再取：naive reject 出来的是嵌套数组，
errors[0].message 恒为 undefined，兜底文案会把每条错误都吞成"请检查表单填写"
- 批次号在"修改"时置灰（task_code = 批次号 + 4 位序号，且同时是文件目录名，
而服务端 update 无条件写 batch_no、没有"编码已生成"的保护）
- 删掉「本期范围」区块（收集模式 / 认定类型恒定，请求体里仍写死 1）
- 清掉教材式描述：extras_json / extra_ 前缀 / 幂等 / 接收能力 / 识别结果只用于提示
- 规则沉淀进 frontend-pc/AGENTS.md 第 10 条与交接摘要 §一·四十
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 重写）。四条最容易写错的：
- 没有 auto-import —— 组件与 API 全部显式
import； - 没有
v-hasPerm—— 权限判断写useUserStore().has('码')，字符串与后端PermissionDef逐字一致； n-tag的type必须过@/utils/tag.ts—— Arco 色词直接透传会静默变灰；- 图标集升级后重跑
scripts/extract-pc-icons.py—— 缺图标是空占位、不报错。