feat 完善注释

src/router/guard.ts

@@ -1,10 +1,8 @@
 import type { Router } from 'vue-router'
 import { storage } from '@/utils/storage'
 
-/** 路由守卫：登录态校验 + document.title */
 export function setupGuard(router: Router): void {
   router.beforeEach((to) => {
-    // 视觉走查旁路：仅本地开发且带 ?visual=1 时放行，便于逐页比对设计稿
     if (
       import.meta.env.DEV
       && new URLSearchParams(window.location.search).has('visual')

src/router/routes.ts

@@ -1,23 +1,15 @@
 import type { RouteRecordRaw } from 'vue-router'
 
-/**
- * 公共布局（AppHeader + router-view + AppFooter）下的路由
- * 完整规划见 docs/page-architecture.md 第 2 节
- * M3–M10 视图由子代理并行实现中，交付后本表即为终态
- */
 const layoutRoutes: RouteRecordRaw = {
   path: '/',
   component: () => import('@/layout/index.vue'),
   children: [
-    // ── 公开 ──
     { path: '', name: 'Home', component: () => import('@/views/home'), meta: { title: '首页', footer: true } },
     { path: 'business/:type', name: 'BusinessDetail', component: () => import('@/views/home/detail.vue'), meta: { title: '业务详情' } },
     { path: 'cases', name: 'Cases', component: () => import('@/views/cases'), meta: { title: '成功案例库' } },
     { path: 'cases/:id', name: 'CaseDetail', component: () => import('@/views/cases/detail.vue'), meta: { title: '案例详情' } },
-    // 需求提报依赖登录态：字典 / 业务类型 / 草稿 / 上传 / 提交接口匿名实测均 401
     { path: 'demand', name: 'Demand', component: () => import('@/views/demand'), meta: { title: '需求提报', requiresAuth: true, noFooter: true } },
 
-    // ── 登录区 ──
     { path: 'project', name: 'Project', component: () => import('@/views/project'), meta: { title: '项目中心', requiresAuth: true } },
     { path: 'project/:id', name: 'ProjectDetail', component: () => import('@/views/project/detail.vue'), meta: { title: '项目详情', requiresAuth: true } },
     { path: 'project/:id/after-sales', name: 'AfterSales', component: () => import('@/views/project/after-sales.vue'), meta: { title: '申请售后', requiresAuth: true } },
@@ -29,7 +21,6 @@ const layoutRoutes: RouteRecordRaw = {
     { path: 'finance/bills/:id', name: 'BillDetail', component: () => import('@/views/finance/bill-detail.vue'), meta: { title: '账单详情', requiresAuth: true } },
     { path: 'finance/bills/:id/pay', name: 'BillPay', component: () => import('@/views/finance/pay.vue'), meta: { title: '扫码支付', requiresAuth: true } },
     { path: 'finance/bills/:id/pay/result', name: 'PayResult', component: () => import('@/views/finance/pay-result.vue'), meta: { title: '支付成功', requiresAuth: true } },
-    // 收银台（确认支付）：由账单明细勾选/单笔「去支付」带入 `?ids=bill-001,bill-002`
     { path: 'finance/checkout', name: 'Checkout', component: () => import('@/views/finance/checkout.vue'), meta: { title: '确认支付', requiresAuth: true } },
     { path: 'finance/invoices', name: 'Invoices', component: () => import('@/views/finance/invoices.vue'), meta: { title: '发票申请', requiresAuth: true } },
     { path: 'finance/invoice-titles', name: 'InvoiceTitles', component: () => import('@/views/finance/invoice-titles.vue'), meta: { title: '发票抬头', requiresAuth: true } },
@@ -37,7 +28,6 @@ const layoutRoutes: RouteRecordRaw = {
     { path: 'message/:id', name: 'MessageDetail', component: () => import('@/views/message/detail.vue'), meta: { title: '通知详情', requiresAuth: true } },
     { path: 'service', name: 'Service', component: () => import('@/views/service'), meta: { title: '在线客服', requiresAuth: true } },
 
-    // ── 个人中心（左菜单嵌套）──
     {
       path: 'profile',
       component: () => import('@/views/profile'),
@@ -57,7 +47,6 @@ const layoutRoutes: RouteRecordRaw = {
   ],
 }
 
-/** 无全局布局的路由（登录注册独立品牌页 + 404） */
 const plainRoutes: RouteRecordRaw[] = [
   { path: '/login', name: 'Login', component: () => import('@/views/login'), meta: { title: '登录' } },
   { path: '/register', name: 'Register', component: () => import('@/views/login/register.vue'), meta: { title: '注册' } },