docs: annotate remaining routes layouts and view boundaries

app/pages/orders/[id].vue

@@ -1,4 +1,7 @@
 <script>
+/**
+ * 订单/账单详情与旧支付路由共用页：展示订单、流水、转账凭证和支付入口；取消前重读订单，支付完成后从服务端刷新状态。
+ */
 import "~/assets/styles/PaymentDialog.BNFKQF1U.css";
 import "~/assets/styles/_id_.gjoJy9S8.css";
 import { toDisplayString } from "vue";
@@ -38,6 +41,7 @@ import PaymentDialog from "~/components/PaymentDialog.vue";
 import tag from "primevue/tag";
 import skeleton from "primevue/skeleton";
 import { t as bandwidth_display_t } from "~/lib/bandwidth-display.js";
+// 仅从符合续费周期格式的描述中提取商品名，避免把日期区间重复显示成产品标题。
 function D(e) {
   let t = e.description?.trim() || ``,
     n = e.product_name?.trim() || ``,
@@ -192,6 +196,7 @@ var ue = {
             credit: `余额支付`,
             credit_limit: `信用额支付`,
           };
+        // 在实际支付渠道列表中按标识查找显示名称。
         function L(e) {
           let t = e?.trim().toLowerCase();
           return (
@@ -202,6 +207,7 @@ var ue = {
             ``
           );
         }
+        // 渠道名称先使用服务端配置，再回落到已知余额/信用额类型或原始名称。
         function Ze(e) {
           let t = e?.trim() || ``;
           return L(t) || Xe[t.toLowerCase()] || t || `—`;
@@ -211,6 +217,7 @@ var ue = {
             t = j.value?.gateway?.trim() || ``;
           return L(e) || L(t) || Ze(t || e);
         });
+        // 支付渠道元信息单独加载，失败不阻止订单详情展示。
         async function $e() {
           try {
             let e = await O.get(`/gateway`);
@@ -220,15 +227,18 @@ var ue = {
         onMounted($e);
         let R = ref(!1),
           z = ref(!0);
+        // 轻量刷新当前订单，用于支付、凭证或取消后的状态同步。
         async function B() {
           try {
             let e = await O.get(`/order/${k}`);
             e.order && (j.value = e.order);
           } catch {}
         }
+        // 只接收与当前 ID 匹配的订单更新，避免支付组件更新其他订单。
         function et(e) {
           String(e.id) === k && (j.value = e);
         }
+        // 交易流水有独立错误与加载状态；失败不把未加载的金额显示成已支付零元。
         async function V() {
           ((P.value = !0), (F.value = !1), (I.value = ``));
           try {
@@ -240,6 +250,7 @@ var ue = {
             P.value = !1;
           }
         }
+        // 旧 pay 路由支付完成进入 paid 路由；普通详情则刷新订单及流水。
         function tt() {
           if (((R.value = !1), A.value)) {
             qe.push(`/orders/order/paid?id=${k}`);
@@ -262,6 +273,7 @@ var ue = {
           }
         });
         let nt = computed(() => j.value?.items?.some((e) => !!D(e)) ?? !1);
+        // 订单项标题优先使用已清理的产品名，缺失时回落到描述。
         function rt(e) {
           return (
             product_name_n(D(e) || e.product_name) ||
@@ -285,6 +297,7 @@ var ue = {
           ot = computed(() =>
             (j.value?.items ?? []).map((e) => e.product_name),
           );
+        // 订单项说明统一通过产品与带宽展示工具整理，保留真实配置含义。
         function st(e) {
           return bandwidth_display_t(product_name_r(e.description, ot.value));
         }
@@ -316,6 +329,7 @@ var ue = {
               !q.value &&
               !J.value,
           );
+        // 上传凭证后仅保存服务端 save_name 标识；附件上传期间阻止重复选择处理。
         async function dt(e) {
           let t = e.target,
             n = Array.from(t.files ?? []);
@@ -334,9 +348,11 @@ var ue = {
             }
           }
         }
+        // 尚未提交审核时允许移除本地待提交附件，不代表删除服务端历史凭证。
         function ft(e) {
           J.value || (K.value = K.value.filter((t, n) => n !== e));
         }
+        // 只有允许上传凭证的订单且附件已就绪才提交；提交后进入 WaitReview 并再次读取订单。
         async function pt() {
           if (j.value && Q.value && !J.value) {
             ((J.value = !0), (Y.value = ``));
@@ -358,6 +374,7 @@ var ue = {
             }
           }
         }
+        // 从人工转账凭证流程切换到其他支付方式，实际可用渠道由重新加载的订单决定。
         async function mt() {
           if (j.value && !X.value && ut.value) {
             ((X.value = !0), (Y.value = ``));
@@ -381,9 +398,11 @@ var ue = {
               j.value.status,
             ),
         );
+        // 仅对可取消状态打开确认框，按需订单不走此取消入口。
         function ht() {
           $.value && !U.value && ((W.value = ``), (H.value = !0));
         }
+        // 确认取消时再次读取订单并重新检查状态，再执行删除，减少使用过期详情误操作。
         async function gt() {
           if (H.value && $.value && !U.value && j.value) {
             ((U.value = !0), (W.value = ``));
@@ -407,9 +426,11 @@ var ue = {
             }
           }
         }
+        // 调用浏览器打印当前订单视图，不另行生成服务端发票。
         function _t() {
           window.print();
         }
+        // 订单项、交易流水、凭证审核与支付分开显示；取消确认读取最新状态，打印仅针对当前详情视图。
         return (n, a) => {
           let l = skeleton,
             g = message,