This file supplements ../AGENTS.md for the user-facing Vue 3 application.
- Use Vue 3 Composition API with
<script setup lang="ts">, Pinia, Vue Router, and the existing i18n layout. - API modules under
src/api/call the helpers fromsrc/utils/request.tsdirectly. Do not introduce management-style API objects solely for symmetry. - Initialize authentication before installing the router; protected-route guards depend on completed auth bootstrap.
AppLayout.vueis conditional. Do not assume every route has a sidebar.- Add translation keys to both
src/i18n/locales/zh-CN/andsrc/i18n/locales/en-US/. - Check
shared/before duplicating behavior used by management. Do not import management-only UI or hidden test-case views. - Mock
src/utils/request.tsin API unit tests using Vitest; the project does not use MSW.
Run from this directory:
pnpm lint
pnpm type-check
pnpm test
pnpm buildpnpm lint and formatting commands modify files; inspect their diff. The app test command intentionally excludes shared auth and theme tests, so run the changed shared package's own checks as well.