docs: explain configuration inputs and authentication components

app/components/config/PromoCodeField.vue

@@ -1,4 +1,5 @@
 <script>
+/** 优惠码输入框：提交后更新 v-model 并请求父级 recalc，不在组件内自行计算折扣。 */
 import "~/assets/styles/PromoCodeField.qFEkB6Hm.css";
 import { toDisplayString } from "vue";
 import { normalizeClass } from "vue";
@@ -53,6 +54,7 @@ var y = [`open`],
             w = ref(!1),
             T = ref(`idle`);
           function E() {
+            // 仅提交去空白的非空优惠码，w 用于把下一轮报价结束关联到本次应用动作。
             if (x.disabled || x.loading) return;
             let e = C.value.trim();
             e &&
@@ -69,6 +71,7 @@ var y = [`open`],
           }
           return (
             watch(
+              // 等父级 loading 从真变假后，根据实际折扣判断成功或无效，不把发事件当验证成功。
               () => x.loading,
               (e, t) => {
                 t &&