家谱现有接口调试50%

2026-07-09 17:29:25 +08:00
commit 6050508144
262 changed files with 63354 additions and 0 deletions
@@ -0,0 +1,365 @@
+(function (root, factory) {
+  // 成员与家族管理模块同时支持浏览器页面和 Node 单元测试。
+  if (typeof module === 'object' && module.exports) {
+    module.exports = factory(root);
+    return;
+  }
+
+  root.MemberAdminPages = factory(root);
+  if (root.document) {
+    root.document.addEventListener('DOMContentLoaded', function () {
+      root.MemberAdminPages.init();
+    });
+  }
+})(typeof globalThis !== 'undefined' ? globalThis : window, function (root) {
+  'use strict';
+
+  var documentRef = root.document;
+
+  function normalizeList(data) {
+    // 成员接口返回可能是数组，也可能包在 rows、records、list、data 中。
+    if (Array.isArray(data)) return data;
+    if (!data || typeof data !== 'object') return [];
+    if (Array.isArray(data.rows)) return data.rows;
+    if (Array.isArray(data.records)) return data.records;
+    if (Array.isArray(data.list)) return data.list;
+    if (Array.isArray(data.data)) return data.data;
+    return [];
+  }
+
+  function pick(item, keys, fallback) {
+    var source = item || {};
+    var index;
+    var value;
+
+    for (index = 0; index < keys.length; index += 1) {
+      value = source[keys[index]];
+      if (value !== undefined && value !== null && value !== '') return value;
+    }
+
+    return fallback || '';
+  }
+
+  function escapeHtml(value) {
+    // 成员姓名、关系名进入 innerHTML 前统一转义。
+    return String(value === undefined || value === null ? '' : value)
+      .replace(/&/g, '&amp;')
+      .replace(/</g, '&lt;')
+      .replace(/>/g, '&gt;')
+      .replace(/"/g, '&quot;')
+      .replace(/'/g, '&#39;');
+  }
+
+  function getApi() {
+    return root.GenealogyApi && root.GenealogyApi.defaultClient;
+  }
+
+  function query(selector, rootNode) {
+    return (rootNode || documentRef).querySelector(selector);
+  }
+
+  function queryAll(selector, rootNode) {
+    return Array.prototype.slice.call((rootNode || documentRef).querySelectorAll(selector));
+  }
+
+  function showMessage(message) {
+    if (root.layui && root.layui.layer) {
+      root.layui.layer.msg(message);
+      return;
+    }
+
+    root.alert(message);
+  }
+
+  function getQueryParam(search, name) {
+    var params = new URLSearchParams(String(search || '').replace(/^\?/, ''));
+    return params.get(name) || '';
+  }
+
+  function getCurrentGenealogyId() {
+    var search = root.location && root.location.search;
+    var page = query('[data-member-admin-page], [data-admin-permission-page], [data-family-invite-page], [data-family-share-page]');
+
+    return getQueryParam(search, 'id') ||
+      getQueryParam(search, 'genealogyId') ||
+      (page && page.getAttribute('data-genealogy-id')) ||
+      '';
+  }
+
+  function trimOrUndefined(value) {
+    var text = String(value === undefined || value === null ? '' : value).trim();
+
+    return text || undefined;
+  }
+
+  function toNumber(value) {
+    var text = String(value === undefined || value === null ? '' : value).trim();
+    var number = Number(text);
+
+    return text && Number.isFinite(number) ? number : undefined;
+  }
+
+  function formatRole(roleType) {
+    var role = String(roleType || '').trim();
+    var roleMap = {
+      owner: '创建者',
+      creator: '创建者',
+      admin: '管理员',
+      manager: '管理员',
+      member: '普通成员'
+    };
+
+    return roleMap[role] || role || '普通成员';
+  }
+
+  function buildMemberUpdateBody(values) {
+    // GenealogyMemberUpdateBody 来自 APP.openapi.json。
+    var source = values || {};
+
+    return {
+      memberName: trimOrUndefined(source.memberName),
+      relationName: trimOrUndefined(source.relationName),
+      roleType: String(source.roleType || '').trim() || 'member',
+      lineagePersonId: toNumber(source.lineagePersonId)
+    };
+  }
+
+  function buildOverviewSummary(detail) {
+    var source = detail || {};
+    var name = pick(source, ['genealogyName', 'name'], '当前家谱');
+    var memberCount = pick(source, ['memberCount', 'members', 'personCount'], '0');
+    var articleCount = pick(source, ['articleCount', 'articles'], '0');
+    var albumCount = pick(source, ['albumCount', 'albums'], '0');
+
+    return name + ' · ' + memberCount + ' 位成员 · ' + articleCount + ' 篇谱文 · ' + albumCount + ' 个相册';
+  }
+
+  function getMemberId(item) {
+    return pick(item, ['memberId', 'id', 'genealogyMemberId'], '');
+  }
+
+  function buildMemberRow(item) {
+    var memberId = getMemberId(item);
+    var name = pick(item, ['memberName', 'nickName', 'name'], '未命名成员');
+    var relation = pick(item, ['relationName', 'relation'], '族亲');
+    var roleType = pick(item, ['roleType', 'role'], 'member');
+    var bindName = pick(item, ['lineagePersonName', 'personName'], '未绑定');
+
+    return '<div class="module-row member-admin-row" data-member-id="' + escapeHtml(memberId) + '">' +
+      '<div><h3>' + escapeHtml(name) + '</h3><p>' + escapeHtml(relation) + ' · ' + escapeHtml(formatRole(roleType)) + ' · 绑定：' + escapeHtml(bindName) + '</p></div>' +
+      '<div class="row-actions"><button class="pill" type="button" data-member-edit="' + escapeHtml(memberId) + '" data-member-name="' + escapeHtml(name) + '" data-member-relation="' + escapeHtml(relation) + '" data-member-role="' + escapeHtml(roleType) + '">权限</button><button class="pill is-danger" type="button" data-member-remove="' + escapeHtml(memberId) + '">移除</button></div>' +
+      '</div>';
+  }
+
+  function buildOption(item) {
+    var memberId = getMemberId(item);
+    var name = pick(item, ['memberName', 'label', 'name'], '未命名成员');
+
+    return '<option value="' + escapeHtml(memberId) + '">' + escapeHtml(name) + '</option>';
+  }
+
+  function buildInviteLink(currentUrl, genealogyId) {
+    var url = new URL(currentUrl || 'http://localhost/profile-invite.html');
+
+    url.pathname = url.pathname.replace(/[^/]*$/, 'join-genealogy.html');
+    url.search = '?id=' + encodeURIComponent(genealogyId || '');
+    url.hash = '';
+    return url.toString();
+  }
+
+  function renderOverview(detail) {
+    var summary = query('[data-member-overview]');
+    var title = query('[data-member-title]');
+
+    if (title) title.textContent = pick(detail, ['genealogyName', 'name'], title.textContent || '家族管理');
+    if (summary) summary.textContent = buildOverviewSummary(detail);
+  }
+
+  function renderMembers(items) {
+    var container = query('[data-member-list]');
+    var list = normalizeList(items);
+
+    if (!container) return;
+    if (!list.length) {
+      container.innerHTML = '<div class="api-empty">暂无家谱成员</div>';
+      return;
+    }
+
+    container.innerHTML = list.map(buildMemberRow).join('');
+  }
+
+  function renderMemberOptions(items) {
+    var select = query('[data-member-select]');
+    var list = normalizeList(items);
+
+    if (!select) return;
+    select.innerHTML = '<option value="">请选择成员</option>' + list.map(buildOption).join('');
+  }
+
+  function renderInvite(detail, genealogyId) {
+    var code = query('[data-invite-code]');
+    var link = query('[data-invite-link]');
+    var currentUrl = root.location && root.location.href;
+    var inviteCode = pick(detail, ['inviteCode', 'genealogyNo', 'genealogyCode'], genealogyId || '未获取');
+
+    if (code) code.textContent = inviteCode;
+    if (link) link.textContent = buildInviteLink(currentUrl, genealogyId);
+  }
+
+  async function loadMemberAdmin() {
+    var api = getApi();
+    var genealogyId = getCurrentGenealogyId();
+    var detail;
+
+    if (!api) return;
+    if (!genealogyId) {
+      showMessage('请从具体家谱进入管理页面');
+      return;
+    }
+
+    try {
+      detail = await api.genealogyOverview(genealogyId);
+      renderOverview(detail);
+      renderInvite(detail, genealogyId);
+
+      if (query('[data-member-list]')) {
+        renderMembers(await api.genealogyMembers(genealogyId));
+      }
+
+      if (query('[data-member-select]')) {
+        renderMemberOptions(await api.genealogyMemberOptions(genealogyId));
+      }
+    } catch (error) {
+      showMessage(error.message || '家族管理数据加载失败');
+    }
+  }
+
+  async function updateMemberFromPrompt(button) {
+    var api = getApi();
+    var genealogyId = getCurrentGenealogyId();
+    var memberId = button.getAttribute('data-member-edit');
+    var roleType = root.prompt('请输入角色类型：owner/admin/member', button.getAttribute('data-member-role') || 'member');
+
+    if (!api || !genealogyId || !memberId || !roleType) return;
+
+    try {
+      await api.updateGenealogyMember(genealogyId, memberId, buildMemberUpdateBody({
+        memberName: button.getAttribute('data-member-name'),
+        relationName: button.getAttribute('data-member-relation'),
+        roleType: roleType
+      }));
+      showMessage('成员权限已更新');
+      loadMemberAdmin();
+    } catch (error) {
+      showMessage(error.message || '更新成员失败');
+    }
+  }
+
+  async function removeMember(memberId) {
+    var api = getApi();
+    var genealogyId = getCurrentGenealogyId();
+
+    if (!api || !genealogyId || !memberId) return;
+    if (!root.confirm('确定移除该成员？')) return;
+
+    try {
+      await api.removeGenealogyMember(genealogyId, memberId);
+      showMessage('成员已移除');
+      loadMemberAdmin();
+    } catch (error) {
+      showMessage(error.message || '移除成员失败');
+    }
+  }
+
+  async function submitPermission(form) {
+    var api = getApi();
+    var genealogyId = getCurrentGenealogyId();
+    var memberId = query('[data-member-select]', form).value;
+    var roleType = query('[name="roleType"]', form).value;
+
+    if (!api || !genealogyId || !memberId) {
+      showMessage('请选择要设置的成员');
+      return;
+    }
+
+    try {
+      await api.updateGenealogyMember(genealogyId, memberId, buildMemberUpdateBody({
+        roleType: roleType
+      }));
+      showMessage('管理员权限已保存');
+    } catch (error) {
+      showMessage(error.message || '保存权限失败');
+    }
+  }
+
+  async function transferOwner() {
+    var api = getApi();
+    var genealogyId = getCurrentGenealogyId();
+    var select = query('[data-member-select]');
+
+    if (!api || !genealogyId || !select || !select.value) {
+      showMessage('请选择要转让的成员');
+      return;
+    }
+
+    if (!root.confirm('确定转让家谱所有者？')) return;
+
+    try {
+      await api.transferGenealogyOwner(genealogyId, {
+        targetMemberId: Number(select.value)
+      });
+      showMessage('家谱所有者已转让');
+    } catch (error) {
+      showMessage(error.message || '转让失败');
+    }
+  }
+
+  function bindActions() {
+    if (!documentRef) return;
+
+    documentRef.addEventListener('click', function (event) {
+      var editButton = event.target.closest('[data-member-edit]');
+      var removeButton = event.target.closest('[data-member-remove]');
+      var transferButton = event.target.closest('[data-owner-transfer]');
+
+      if (editButton) {
+        event.preventDefault();
+        updateMemberFromPrompt(editButton);
+      }
+
+      if (removeButton) {
+        event.preventDefault();
+        removeMember(removeButton.getAttribute('data-member-remove'));
+      }
+
+      if (transferButton) {
+        event.preventDefault();
+        transferOwner();
+      }
+    });
+
+    documentRef.addEventListener('submit', function (event) {
+      var form = event.target.closest('[data-permission-form]');
+
+      if (!form) return;
+      event.preventDefault();
+      submitPermission(form);
+    });
+  }
+
+  function init() {
+    if (!documentRef) return;
+
+    bindActions();
+    loadMemberAdmin();
+  }
+
+  return {
+    normalizeList: normalizeList,
+    buildMemberUpdateBody: buildMemberUpdateBody,
+    buildOverviewSummary: buildOverviewSummary,
+    buildMemberRow: buildMemberRow,
+    buildInviteLink: buildInviteLink,
+    init: init
+  };
+});