---
jd-id: "01.03"
name: "src-views"
desc: "Top-level route components — one `.vue` file per URL in the SPA. Each is a `<script setup>` SFC using Vuetify components and the localized strings from `src/locales`."
author: "Clark Lin"
updateTime: "2026-07-06"
status: active
type: "A-高层系统"
tags:
  - 前端
  - Vue3
  - Pages
---

## Core Files

| File path | Route | Role |
|-----------|-------|------|
| `src/views/LoginView.vue` | `/login` | Bare layout (`meta.layout: 'none'`); submits credentials via `useAuthStore().login(...)` |
| `src/views/HomeView.vue` | `/` | Landing page after authentication |
| `src/views/ProfileView.vue` | `/profile` | Current user profile |
| `src/views/StudentView.vue` | `/master-data/students` | Students CRUD |
| `src/views/SubjectView.vue` | `/master-data/subjects` | Subjects CRUD |
| `src/views/TermView.vue` | `/master-data/terms` | Terms CRUD |
| `src/views/StoryView.vue` | `/master-data/stories` | Stories CRUD |
| `src/views/TaskView.vue` | `/tasks` | FullCalendar task view; fetches image attachments via `getTaskImage(...)` (blob) |
| `src/views/SettingsView.vue` | `/settings` | App-level settings (locale via `LanguageSwitcher`) |

---

## Conventions

- All views use `<script setup>` Composition API.
- Localized strings must come from `useI18n()` / `$t(...)` — never hardcoded English.
- Each view is paired with parallel translation keys under `src/locales/{en,zh-CN}/modules/*.js`.
- Add new authenticated pages with `meta.layout: 'default'` and `meta.requiresAuth: true`, and declare `meta.breadcrumbPath` so breadcrumbs render in `AppLayout`.

---

Home: [[01.00 student-app-frontend]] | **Location:** `C:\Projects\vue\student-app-frontend\src\views`