feat(api): 添加帮助中心反馈系统和VIP服务功能

- 在ApiClient中新增submitFeedback、myFeedback、helpArticles、helpArticleDetail、 siteArticles、promotions、vipPackages、createVipOrder、vipOrders等方法 - 添加帮助文章和站点资讯的参数验证逻辑 - 更新测试文件添加新的API方法测试用例 - 在HTML页面中添加反馈、帮助和VIP服务相关页面的脚本引用 - 更新加入家谱页面为完整的申请流程界面 - 修改资讯详情页面为站点资讯展示页面 - 更新AxiosRequestUtil中认证处理逻辑 - 添加世系树渲染的HTML生成函数用于页面复用 - 更新文档中的API契约说明和页面规划
2026-07-30 16:04:48 +08:00
parent fb1743aa2a
commit 309598bfa6
53 changed files with 6740 additions and 282 deletions
@@ -0,0 +1,385 @@
+(function (root, factory) {
+  if (typeof module === 'object' && module.exports) {
+    module.exports = factory(root);
+    return;
+  }
+
+  root.FeedbackPages = factory(root);
+  if (root.document) {
+    root.document.addEventListener('DOMContentLoaded', function () {
+      root.FeedbackPages.init();
+    });
+  }
+})(typeof globalThis !== 'undefined' ? globalThis : window, function (root) {
+  'use strict';
+
+  var FEEDBACK_TYPES = {
+    advice: '意见建议',
+    bug: '问题反馈',
+    complaint: '投诉反馈',
+    other: '其他反馈'
+  };
+  var HANDLE_STATUS = {
+    '0': '待处理',
+    '1': '处理中',
+    '2': '已处理',
+    '3': '已关闭'
+  };
+
+  function escapeHtml(value) {
+    return String(value === undefined || value === null ? '' : value)
+      .replace(/&/g, '&amp;')
+      .replace(/</g, '&lt;')
+      .replace(/>/g, '&gt;')
+      .replace(/"/g, '&quot;')
+      .replace(/'/g, '&#39;');
+  }
+
+  function normalizeId(value) {
+    var text;
+
+    if (typeof value === 'number' && !Number.isSafeInteger(value)) return '';
+    if (value === undefined || value === null) return '';
+    text = String(value).trim();
+    return /^[1-9][0-9]*$/.test(text) ? text : '';
+  }
+
+  function optionalText(value) {
+    if (value === undefined || value === null) return '';
+    return String(value).trim();
+  }
+
+  function getFeedbackId(search) {
+    var params = new URLSearchParams(String(search === undefined && root.location ? root.location.search : search || '').replace(/^\?/, ''));
+
+    return normalizeId(params.get('feedbackId'));
+  }
+
+  function buildFeedbackBody(values) {
+    var source = values || {};
+    var body = {};
+    var feedbackType = optionalText(source.feedbackType);
+    var feedbackContent = optionalText(source.feedbackContent);
+    var contactInfo = optionalText(source.contactInfo);
+
+    if (feedbackType) body.feedbackType = feedbackType;
+    if (feedbackContent) body.feedbackContent = feedbackContent;
+    if (contactInfo) body.contactInfo = contactInfo;
+    return body;
+  }
+
+  function validateFeedbackBody(body) {
+    var source = body || {};
+
+    if (!optionalText(source.feedbackContent)) return '请填写反馈内容';
+    if (source.feedbackType && !Object.prototype.hasOwnProperty.call(FEEDBACK_TYPES, source.feedbackType)) {
+      return '反馈类型无效';
+    }
+    return '';
+  }
+
+  function normalizeFeedback(item) {
+    var source = item || {};
+    var feedbackId = normalizeId(source.feedbackId);
+    var feedbackType = optionalText(source.feedbackType);
+    var feedbackContent = optionalText(source.feedbackContent);
+    var handleStatus = String(source.handleStatus === undefined || source.handleStatus === null ? '' : source.handleStatus);
+    var status = String(source.status === undefined || source.status === null ? '' : source.status);
+
+    if (!feedbackId || !feedbackContent ||
+        !Object.prototype.hasOwnProperty.call(FEEDBACK_TYPES, feedbackType) ||
+        !Object.prototype.hasOwnProperty.call(HANDLE_STATUS, handleStatus) ||
+        ['0', '1'].indexOf(status) < 0) {
+      return null;
+    }
+    return {
+      feedbackId: feedbackId,
+      feedbackType: feedbackType,
+      feedbackContent: feedbackContent,
+      contactInfo: optionalText(source.contactInfo),
+      handleStatus: handleStatus,
+      handleResult: optionalText(source.handleResult),
+      handleTime: optionalText(source.handleTime),
+      status: status,
+      remark: optionalText(source.remark)
+    };
+  }
+
+  function normalizeFeedbackList(data) {
+    var items;
+
+    if (!Array.isArray(data)) return [];
+    items = data.map(normalizeFeedback);
+    return items.some(function (item) { return !item; }) ? [] : items;
+  }
+
+  function findFeedbackById(data, feedbackId) {
+    var targetId = normalizeId(feedbackId);
+    var items = normalizeFeedbackList(data);
+    var match;
+
+    if (!targetId) return null;
+    match = items.find(function (item) { return item.feedbackId === targetId; });
+    return match || null;
+  }
+
+  function buildFeedbackDetailUrl(feedbackId, detailPage) {
+    var id = normalizeId(feedbackId);
+    var params;
+
+    if (!id) return '';
+    params = new URLSearchParams();
+    params.set('feedbackId', id);
+    return (detailPage || 'ticket-detail.html') + '?' + params.toString();
+  }
+
+  function renderFeedbackList(data, options) {
+    var settings = options || {};
+    var items = normalizeFeedbackList(data);
+    var detailPage = settings.detailPage || 'ticket-detail.html';
+
+    if (!items.length) return '<div class="api-empty">当前没有反馈记录</div>';
+    return items.map(function (item) {
+      return '<a class="module-row" href="' +
+        escapeHtml(buildFeedbackDetailUrl(item.feedbackId, detailPage)) +
+        '"><div><h3>' + escapeHtml(FEEDBACK_TYPES[item.feedbackType]) +
+        '</h3><p>' + escapeHtml(item.feedbackContent) +
+        '</p></div><span class="pill">' + HANDLE_STATUS[item.handleStatus] +
+        '</span></a>';
+    }).join('');
+  }
+
+  function renderFeedbackDetail(item) {
+    var feedback = normalizeFeedback(item);
+    var details;
+
+    if (!feedback) return '<div class="api-empty">反馈记录不存在或无权查看</div>';
+    details = [
+      feedback.contactInfo ? '<dt>提交联系方式</dt><dd>' + escapeHtml(feedback.contactInfo) + '</dd>' : '',
+      '<dt>处理状态</dt><dd>' + HANDLE_STATUS[feedback.handleStatus] + '</dd>',
+      feedback.handleResult ? '<dt>处理结果</dt><dd>' + escapeHtml(feedback.handleResult) + '</dd>' : '',
+      feedback.handleTime ? '<dt>处理时间</dt><dd>' + escapeHtml(feedback.handleTime) + '</dd>' : '',
+      feedback.remark ? '<dt>备注</dt><dd>' + escapeHtml(feedback.remark) + '</dd>' : ''
+    ].filter(Boolean).join('');
+
+    return '<article class="module-panel"><div class="module-kicker">' +
+      escapeHtml(FEEDBACK_TYPES[feedback.feedbackType]) +
+      '</div><h2>问题说明</h2><p>' + escapeHtml(feedback.feedbackContent) +
+      '</p><dl class="detail-list">' + details + '</dl></article>';
+  }
+
+  function shouldRedirectToLogin(api, error) {
+    var status = error && (error.status || error.code);
+
+    return !api || !api.getToken || !api.getToken() || Number(status) === 401;
+  }
+
+  function redirectToLogin(api) {
+    if (api && api.clearToken) api.clearToken();
+    if (!root.location) return;
+    if (typeof root.location.replace === 'function') root.location.replace('login.html');
+    else root.location.href = 'login.html';
+  }
+
+  function getFormValues(form) {
+    var values = {};
+
+    Array.prototype.forEach.call(form.querySelectorAll('[name]'), function (field) {
+      values[field.name] = field.value;
+    });
+    return values;
+  }
+
+  function setStatus(message) {
+    var status = root.document && root.document.querySelector('[data-feedback-status]');
+
+    if (status) status.textContent = message || '';
+  }
+
+  async function readMyFeedback(api) {
+    var data = await api.myFeedback();
+    var items = normalizeFeedbackList(data);
+
+    if (!Array.isArray(data) || items.length !== data.length) {
+      throw new Error('反馈列表响应无效');
+    }
+    return items;
+  }
+
+  async function initFeedbackFormPage() {
+    var form = root.document && root.document.querySelector('[data-feedback-form]');
+    var list = root.document && root.document.querySelector('[data-feedback-list]');
+    var refresh = root.document && root.document.querySelector('[data-feedback-refresh]');
+    var page = root.document && root.document.querySelector('[data-feedback-page]');
+    var api = root.GenealogyApi && root.GenealogyApi.defaultClient;
+    var pageMode = page && page.getAttribute('data-feedback-page');
+    var writePending = false;
+
+    if (!form) return;
+    if (shouldRedirectToLogin(api)) {
+      redirectToLogin(api);
+      return;
+    }
+
+    async function loadList() {
+      var items;
+
+      if (!list) return [];
+      setStatus('正在读取反馈记录…');
+      try {
+        items = await readMyFeedback(api);
+        list.innerHTML = renderFeedbackList(items, { detailPage: 'ticket-detail.html' });
+        setStatus('');
+        return items;
+      } catch (error) {
+        if (shouldRedirectToLogin(api, error)) {
+          redirectToLogin(api);
+          return [];
+        }
+        list.innerHTML = '<div class="api-empty">读取反馈记录失败</div>';
+        setStatus(error.message || '读取反馈记录失败，请稍后重试');
+        return [];
+      }
+    }
+
+    if (refresh) refresh.addEventListener('click', loadList);
+    form.addEventListener('submit', async function (event) {
+      var body;
+      var validation;
+      var created;
+      var refreshed;
+      var button = form.querySelector('[data-feedback-submit]');
+
+      event.preventDefault();
+      if (writePending) return;
+      body = buildFeedbackBody(getFormValues(form));
+      validation = validateFeedbackBody(body);
+      if (validation) {
+        setStatus(validation);
+        return;
+      }
+      writePending = true;
+      if (button) button.disabled = true;
+      setStatus('正在提交反馈…');
+      try {
+        created = normalizeFeedback(await api.submitFeedback(body));
+        if (!created) throw new Error('提交响应缺少有效反馈信息');
+        refreshed = await readMyFeedback(api);
+        if (!refreshed.some(function (item) { return item.feedbackId === created.feedbackId; })) {
+          throw new Error('提交后无法读取同一反馈记录');
+        }
+        if (pageMode === 'ticket') {
+          if (root.location) root.location.href = buildFeedbackDetailUrl(created.feedbackId);
+          return;
+        }
+        if (list) list.innerHTML = renderFeedbackList(refreshed, { detailPage: 'ticket-detail.html' });
+        form.reset();
+        setStatus('反馈已提交');
+      } catch (error) {
+        if (shouldRedirectToLogin(api, error)) {
+          redirectToLogin(api);
+          return;
+        }
+        setStatus(error.message || '提交反馈失败，请稍后重试');
+      } finally {
+        writePending = false;
+        if (button) button.disabled = false;
+      }
+    });
+    await loadList();
+  }
+
+  async function initFeedbackListPage() {
+    var page = root.document && root.document.querySelector('[data-feedback-list-page]');
+    var list = root.document && root.document.querySelector('[data-feedback-list]');
+    var refresh = root.document && root.document.querySelector('[data-feedback-refresh]');
+    var api = root.GenealogyApi && root.GenealogyApi.defaultClient;
+
+    if (!page || !list) return;
+    if (shouldRedirectToLogin(api)) {
+      redirectToLogin(api);
+      return;
+    }
+
+    async function loadList() {
+      try {
+        setStatus('正在读取反馈记录…');
+        list.innerHTML = renderFeedbackList(await readMyFeedback(api), {
+          detailPage: 'ticket-detail.html'
+        });
+        setStatus('');
+      } catch (error) {
+        if (shouldRedirectToLogin(api, error)) {
+          redirectToLogin(api);
+          return;
+        }
+        list.innerHTML = '<div class="api-empty">读取反馈记录失败</div>';
+        setStatus(error.message || '读取反馈记录失败，请稍后重试');
+      }
+    }
+
+    if (refresh) refresh.addEventListener('click', loadList);
+    await loadList();
+  }
+
+  async function initFeedbackDetailPage() {
+    var page = root.document && root.document.querySelector('[data-feedback-detail-page]');
+    var detail = root.document && root.document.querySelector('[data-feedback-detail]');
+    var api = root.GenealogyApi && root.GenealogyApi.defaultClient;
+    var feedbackId = getFeedbackId();
+    var item;
+
+    if (!page || !detail) return;
+    if (!feedbackId) {
+      detail.innerHTML = '<div class="api-empty">反馈记录不存在或无权查看</div>';
+      return;
+    }
+    if (shouldRedirectToLogin(api)) {
+      redirectToLogin(api);
+      return;
+    }
+    try {
+      setStatus('正在读取反馈详情…');
+      item = findFeedbackById(await api.myFeedback(), feedbackId);
+      detail.innerHTML = renderFeedbackDetail(item);
+      setStatus(item ? '' : '反馈记录不存在或无权查看');
+    } catch (error) {
+      if (shouldRedirectToLogin(api, error)) {
+        redirectToLogin(api);
+        return;
+      }
+      detail.innerHTML = '<div class="api-empty">反馈详情读取失败</div>';
+      setStatus(error.message || '反馈详情读取失败，请稍后重试');
+    }
+  }
+
+  async function init() {
+    if (root.document && root.document.querySelector('[data-feedback-form]')) {
+      await initFeedbackFormPage();
+      return;
+    }
+    if (root.document && root.document.querySelector('[data-feedback-list-page]')) {
+      await initFeedbackListPage();
+      return;
+    }
+    if (root.document && root.document.querySelector('[data-feedback-detail-page]')) {
+      await initFeedbackDetailPage();
+    }
+  }
+
+  return {
+    getFeedbackId: getFeedbackId,
+    buildFeedbackBody: buildFeedbackBody,
+    validateFeedbackBody: validateFeedbackBody,
+    normalizeFeedback: normalizeFeedback,
+    normalizeFeedbackList: normalizeFeedbackList,
+    findFeedbackById: findFeedbackById,
+    buildFeedbackDetailUrl: buildFeedbackDetailUrl,
+    renderFeedbackList: renderFeedbackList,
+    renderFeedbackDetail: renderFeedbackDetail,
+    initFeedbackFormPage: initFeedbackFormPage,
+    initFeedbackListPage: initFeedbackListPage,
+    initFeedbackDetailPage: initFeedbackDetailPage,
+    init: init
+  };
+});