docs: annotate account commerce finance and content pages

app/pages/invoices/settings/index.vue

@@ -1,4 +1,7 @@
 <script>
+/**
+ * 发票资料设置：统一维护抬头与收票地址；编辑器复制原数据，提交按新增/修改及电子/纸质地址分别组装字段。
+ */
 import "~/assets/styles/settings.zV3AWuRw.css";
 import { toDisplayString } from "vue";
 import { onMounted } from "vue";
@@ -145,6 +148,7 @@ var ue = {
           M = ref([]),
           N = ref(!0),
           P = ref(``);
+        // 完整读取抬头与地址的所有分页，避免选择器仅显示第一页资料。
         async function F() {
           ((N.value = !0), (P.value = ``));
           try {
@@ -182,6 +186,7 @@ var ue = {
             bank: ``,
             bank_user: ``,
           });
+        // 重置抬头草稿后回填待编辑记录，避免上次表单字段残留。
         function V(e) {
           ((L.value = e?.id ?? null),
             (z.value = ``),
@@ -205,6 +210,7 @@ var ue = {
               }),
             (I.value = !0));
         }
+        // 抬头名称必填；新增与修改成功后统一重新加载资料列表。
         async function We() {
           if (!R.value) {
             if (((z.value = ``), !B.title.trim())) {
@@ -230,6 +236,7 @@ var ue = {
             }
           }
         }
+        // 删除抬头后重载列表，失败在页面保留错误提示。
         async function H(e) {
           try {
             (await v.del(`/invoice_title/${e.id}`), await F());
@@ -249,6 +256,7 @@ var ue = {
             phone: ``,
             is_default: !1,
           });
+        // 电子邮箱和纸质地址共用编辑器；打开时恢复默认字段，再复制现有资料。
         function J(e) {
           ((W.value = e?.id ?? null),
             (K.value = ``),
@@ -271,6 +279,7 @@ var ue = {
               }),
             (U.value = !0));
         }
+        // 电子地址只提交邮箱，纸质地址提交收件地址与电话，避免把另一种地址的草稿字段发给接口。
         async function Ge() {
           if (!G.value) {
             if (((K.value = ``), q.rec_type === `email` && !q.email.trim())) {
@@ -306,6 +315,7 @@ var ue = {
             }
           }
         }
+        // 删除收票地址后重载资料。
         async function Y(e) {
           try {
             (await v.del(`/invoice_address/${e.id}`), await F());
@@ -316,6 +326,7 @@ var ue = {
         let X = ref(!1),
           Z = ref(!1),
           Q = ref(null);
+        // 记录待删除抬头，在确认前不发起删除。
         function Ke(e) {
           ((Q.value = {
             kind: `title`,
@@ -323,6 +334,7 @@ var ue = {
           }),
             (X.value = !0));
         }
+        // 记录待删除地址，复用同一确认弹窗。
         function qe(e) {
           ((Q.value = {
             kind: `address`,
@@ -330,6 +342,7 @@ var ue = {
           }),
             (X.value = !0));
         }
+        // 确认时按目标类型调用删除函数，用独立忙碌态阻止重复确认。
         async function Je() {
           if (Q.value && !Z.value) {
             Z.value = !0;