本目录是 Vue 3 / Vite 前端。先阅读根 AGENTS.md、设计规范 和 ARCHITECTURE.md。
- API 调用统一放在
src/apis；组件不直接拼接普通 HTTP 请求。 - 前端权限与路由守卫只提供体验约束，后端始终执行最终授权。
- 复用
src/assets/css/base.css变量和@lucide/vue；不为一次性视觉需求引入新依赖。 - 保持 loading、empty、error、断线恢复和终态投影语义一致；不要用乐观 UI 覆盖 PostgreSQL 返回的最终事实。
pnpm run lint:check是只读 gate；pnpm run lint才允许本地自动修复。
提交前运行：
docker compose exec web pnpm run lint:check
docker compose exec web pnpm run test:unit
docker compose exec web pnpm run buildUI 改动必须在真实页面验证，并提供最终截图或录屏；适用时覆盖浅/深色、响应式、loading、empty 和 error 状态。