docs: annotate account commerce finance and content pages

app/pages/account/realname/company.vue

@@ -1,4 +1,7 @@
 <script>
+/**
+ * 企业实名认证路由适配层：复用统一实名认证页，仅把 initial-type 设为 company；认证状态、接口与上传流程均由统一页负责。
+ */
 import "~/assets/styles/UploadField.BbTCTv6C.css";
 import "~/assets/styles/PageSteps.B5K7G9zF.css";
 import "~/assets/styles/PaymentDialog.BNFKQF1U.css";

app/pages/account/realname/index.vue

@@ -1,4 +1,7 @@
 <script>
+/**
+ * 实名认证流程：个人/企业资料 → 选择渠道及动态字段 → 必要时支付认证费 → 二维码核验与状态轮询。序号将异步结果绑定到当前资料、渠道和核验会话。
+ */
 import "~/assets/styles/UploadField.BbTCTv6C.css";
 import "~/assets/styles/PageSteps.B5K7G9zF.css";
 import "~/assets/styles/PaymentDialog.BNFKQF1U.css";
@@ -46,6 +49,7 @@ import tablist from "primevue/tablist";
 import tab from "primevue/tab";
 var b = `#contentBox img[src^="data:image/"], #qrcode img, #qrCode img, img#qrcode, img#qrCode, .qrcode img, .qr-code img`,
   x = `img[src^="data:image/png;base64,"], img[src^="data:image/jpeg;base64,"]`;
+// 从认证服务返回的 HTML 中定位二维码，保留其动态更新逻辑并隐藏其余内容；无法唯一定位时拒绝展示。
 function S(e) {
   let t = new DOMParser().parseFromString(e, `text/html`),
     n =
@@ -454,6 +458,7 @@ var xe = {
             flush: `sync`,
           },
         );
+        // 只收集已上传的图片标识，空字段不随申请发送。
         function At() {
           let e = {};
           for (let [t, n] of Object.entries(G)) n && (e[t] = n);
@@ -466,9 +471,11 @@ var xe = {
           Q = null,
           $ = 0,
           Mt = 0;
+        // 结束当前核验轮询并提升会话序号，使已在途回调失效。
         function Nt() {
           ($++, Q !== null && (clearTimeout(Q), (Q = null)), (jt.value = !1));
         }
+        // 读取实名开关及个人/企业状态；仅最新请求可以写入当前页面。
         async function Pt() {
           let e = ++M;
           ((xt.value = !0), (z.value = ``));
@@ -483,11 +490,13 @@ var xe = {
             !N && e === M && (xt.value = !1);
           }
         }
+        // 切换渠道或关闭弹窗时清理动态字段与加载标识，同时使旧字段请求失效。
         function Ft() {
           (j++, (_t.value = ``), (A.value = ``), (k.value = !1));
           for (let e of Object.keys(O)) delete O[e];
           gt.value = [];
         }
+        // 兼容服务端布尔、数字和字符串形式的必填标识。
         function It(e) {
           return (
             e.required === !0 ||
@@ -496,6 +505,7 @@ var xe = {
             e.required === `true`
           );
         }
+        // 将数组、对象、JSON 字符串或逗号列表整理为选择项，供认证渠道动态表单使用。
         function Lt(e) {
           if (Array.isArray(e))
             return e.map((e) => ({
@@ -521,6 +531,7 @@ var xe = {
             }
           return [];
         }
+        // 加载当前认证类型与渠道的动态字段；请求结束时同时核对渠道、类型、弹窗状态和代次。
         async function Rt(e) {
           Ft();
           let t = j,
@@ -553,6 +564,7 @@ var xe = {
             i() && (k.value = !1);
           }
         }
+        // 验证个人资料及要求上传的证件后，暂存申请并进入渠道选择。
         async function zt() {
           if (!(W.value || C.value || Y.value || P.value || !Dt.value)) {
             if (((z.value = ``), K.value))
@@ -569,6 +581,7 @@ var xe = {
             });
           }
         }
+        // 企业申请额外校验企业实名开关、个人认证前置条件、营业执照和必要的委托书。
         async function Bt() {
           if (!(
             W.value ||
@@ -597,6 +610,7 @@ var xe = {
             });
           }
         }
+        // 保存待提交的资料快照；渠道选择不直接修改原始表单。
         async function Vt(e, t) {
           ((F.value = null),
             (D.value = {
@@ -607,6 +621,7 @@ var xe = {
             (C.value = !0),
             await Ht());
         }
+        // 加载可用认证插件，使用独立代次隔离弹窗重开或重试。
         async function Ht() {
           if (!C.value || W.value) return;
           let e = ++I;
@@ -625,6 +640,7 @@ var xe = {
             e === I && (w.value = !1);
           }
         }
+        // 非提交期间允许关闭渠道弹窗，并使其异步加载结果失效。
         function Ut() {
           W.value ||
             (I++,
@@ -635,6 +651,7 @@ var xe = {
             Ft(),
             (D.value = null));
         }
+        // 确认动态字段与当前渠道一致后检查渠道费用；需要付费时先保存申请快照并打开支付，不提前提交认证。
         async function Wt() {
           if (!C.value || w.value || W.value || !D.value) return;
           let e = L.value.find((e) => e.name === E.value);
@@ -720,6 +737,7 @@ var xe = {
             r === I && (W.value = !1);
           }
         }
+        // 已通过个人认证的企业升级走 convert，其余申请走 person/company；渠道字段随同原资料提交。
         async function Gt(e, t, n, r) {
           let i =
             e === `company` && Number(R.value?.person?.status) === 1
@@ -731,6 +749,7 @@ var xe = {
             plugin_name: n,
           });
         }
+        // 支付回调后再次查询渠道订单，确认同一订单已 Paid 才续交认证，不能仅凭前端支付事件认定到账。
         async function Kt() {
           let e = F.value;
           if (!e || W.value || N) return;
@@ -764,9 +783,11 @@ var xe = {
             !N && t === I && (W.value = !1);
           }
         }
+        // 重新打开待支付认证订单，不重复生成申请快照。
         function qt() {
           !W.value && F.value && (P.value = !0);
         }
+        // 开启新的二维码核验会话，先获取二维码，再为当前认证类型启动轮询。
         async function Jt(e = V.value === 1 ? `company` : `person`) {
           Nt();
           let t = $;
@@ -777,6 +798,7 @@ var xe = {
             await Xt(t),
             t === $ && Y.value && Zt(t, e));
         }
+        // 认证资料失效或变更时终止旧核验并刷新资料，要求用户重新提交。
         async function Yt(e) {
           if (![`10000`, `10001`].includes(String(e))) return !1;
           Qt();
@@ -792,6 +814,7 @@ var xe = {
             !0
           );
         }
+        // 按当前核验会话加载二维码，并设置刷新时间门槛；过期会话的响应不再显示。
         async function Xt(e) {
           if (e === $ && Y.value) {
             ((Z.value = !0), (Mt = Date.now() + (X.value ? 3e4 : 1e4)));
@@ -819,6 +842,7 @@ var xe = {
             }
           }
         }
+        // 每两秒查询核验状态；第三方完成后仍复查本平台认证资料，区别认证成功与进入审核，关闭后停止调度。
         function Zt(e, t) {
           jt.value = !0;
           let n = () => e === $ && Y.value;
@@ -874,6 +898,7 @@ var xe = {
           }
           Q = setTimeout(r, 2e3);
         }
+        // 关闭二维码核验并清空 HTML，同时取消下一次状态查询。
         function Qt() {
           ((Y.value = !1), Nt(), (Z.value = !1), (X.value = ``));
         }

app/pages/account/realname/personal.vue

@@ -1,4 +1,7 @@
 <script>
+/**
+ * 个人实名认证路由适配层：复用统一实名认证页，以 person 作为初始认证类型，不单独维护一套提交逻辑。
+ */
 import "~/assets/styles/UploadField.BbTCTv6C.css";
 import "~/assets/styles/PageSteps.B5K7G9zF.css";
 import "~/assets/styles/PaymentDialog.BNFKQF1U.css";