FamilyBook/templates/_person_groups.php

<?php
/**
 * 「名册标签」词表管理卡片 —— 从个人设置**搬出来**的（v52 用户 2026-10-15 第 6 条），
 * v54（用户 2026-10-16 第 2 条）**从"分组"改口径为"标签词表"**。
 *
 * 用户原话（v52）：「名册右侧，只保留一个添加成员按钮，右侧再加一个设置按钮，
 *            点击后下拉设置，第一个就是导入联系人，第二个就是原来个人设置那里的
 *            **名册分组**，这样**个人设置中就不显示名册分组的内容**了。」
 *
 * 用户原话（v54，本次）：「现在名册里面给人打标签的时候，这个标签数据是从哪读出来的呀？
 *            在这个名册的设置页面，有很多分组，现在还叫分组。但是打标签的时候，
 *            却不是从这些分组里读出来的。所以现在应该在这个设置页面，不应该再叫
 *            「名册分组」了吧？应该叫「名册标签」，是不是？**应该从这里面把所有标签都读出来**吧？」
 *
 * 🔴 澄清一个容易混的点（也是用户困惑的根源）：
 *   这张卡背后的表仍然是 `person_groups`（**表名没改**，因为改名要背着
 *   `PersonGroup` 类、`person_roster.group_id`、其它会话正在写的 App-API 一起动，
 *   风险远大于收益）—— 但它的**语义**从 v28 起就已经是"**标签词表**"：
 *   这里配的每个词，现在会出现在名册里打标签时的**候选列表**里
 *   （见 `App\PersonTag::choices()`：**这张表 ∪ 我用过的词**）。
 *
 *   所以：
 *     · 界面上**一律叫"标签"**，不再出现"分组"二字；
 *     · 这里加的词 = "预定义标签"，还没用过也能一点就打上；
 *     · 某个人身上真有哪几个标签，仍然在名册卡片上那颗标签按钮里改。
 *
 * ⚠️ 表单 action 仍指向 `settings/groups/*`（**一个字段都没改**）——
 *    它是"我自己的词表"，与它挂在哪一页、叫什么名字无关；
 *    换路由只会白白多一处要维护的东西（而且老书签/脚本会失效）。
 *
 * 变量（require 前设好；**入参仍用宿主那边的名字**，片段内部一律 pg* 前缀，见下）：
 *   $groups       PersonGroup::orderFor(...) 的结果（公共同我的）
 *   $groupCounts  gid => 人数
 *   $rosterCount  我的名册人数
 */
/* ⚠️ 变量名**必须带片段前缀**（pg*）：模板片段与宿主 `require` 是**共享作用域**，
   用 `$groups` 这种通名会把宿主模板的同名变量覆盖掉（本项目有静态断言专门查这个）。 */
$pgGroups      = (array)($groups ?? []);
$pgCounts      = (array)($groupCounts ?? []);
$pgRosterN     = (int)($rosterCount ?? 0);
$pgTotal       = count($pgGroups);
?>
<div class="card card-pad">
  <h2 class="section-title">
    名册标签
    <span class="hint">公共的 + 我自己加的</span>
  </h2>
  <p class="small muted" style="margin:0 0 16px">
    这里配的是**给名册成员打标签时可以一点就选的词**。
    <b>公共标签</b>由管理员在「系统设置」里维护（全家都能用）；
    你要是觉得不够，就在下面<b>加只给自己看的标签</b>，别人看不到、也不受影响。
    <br>
    一个人可以有多个标签（他既是「亲戚」又是「球友」），所以标签不分组、不分栏。
    谁身上真有哪个标签，在名册里点他那张卡片上的标签按钮就能改。
    <br>
    列表里 <b>公共</b> 标的是大家共用的那几个。
    哪个排前面也是你自己的习惯，用 ▲ ▼ 调 —— 别人看到的顺序不变。
    <br>
    你的名册现在有 <b><?= $pgRosterN ?></b> 人。
  </p>

  <?php if (!$pgGroups): ?>
    <p class="small muted" style="margin:0 0 14px">还没有标签。加一个吧。</p>
  <?php else: ?>
    <ol class="order-list">
      <?php foreach ($pgGroups as $i => $g): $pgGid = (int)$g['id']; $pgOwn = (int)$g['owner_id']; ?>
        <li class="order-row">
          <span class="order-no"><?= $i + 1 ?></span>
          <span class="order-name">
            <?php /* ⚠️ 这里**不加 `#`** —— 词表里存的是**词本身**（`家人`），
               `#` 只是名册里打标签时的显示习惯（`#家人`）。
               在词表管理页加上 `#`，会让人以为"输入时要带 #"，
               而实际 `PersonTag::clean()` 会把 `#` 剥掉 —— 两处显示不一致。
               🔴 v54：e2e 的顺序断言 `my_group_order()` 抓的是 `<ol class="order-list">`
                 里 `order-name` 的**第一个子串**，多出来的 `#` 会让它读成 `#家人`
                 ⇒ 断言红（这也是"界面多加一个字符就可能打歪既有断言"的又一例）。 */ ?>
            <?= e((string)$g['name']) ?>
            <?php if ($pgOwn === 0): ?><span class="badge">公共</span><?php else: ?><span class="badge badge-open">我的</span><?php endif; ?>
          </span>
          <span class="order-count"><?= (int)($pgCounts[$pgGid] ?? 0) ?> 人</span>
          <form method="post" action="<?= e(url('settings/groups/move')) ?>" class="order-move">
            <?= csrf_field() ?>
            <input type="hidden" name="id" value="<?= $pgGid ?>">
            <input type="hidden" name="scope" value="me">
            <button class="btn btn-ghost btn-sm" type="submit" name="dir" value="up"
                    title="上移一个" <?= $i === 0 ? 'disabled' : '' ?>>▲</button>
            <button class="btn btn-ghost btn-sm" type="submit" name="dir" value="down"
                    title="下移一个" <?= $i === $pgTotal - 1 ? 'disabled' : '' ?>>▼</button>
          </form>
        </li>
      <?php endforeach; ?>
    </ol>
  <?php endif; ?>

  <form method="post" action="<?= e(url('settings/groups/add')) ?>" class="inline-form" style="margin-top:16px">
    <?= csrf_field() ?>
    <input type="hidden" name="scope" value="me">
    <label class="sr-only" for="newMyGroup">新标签名</label>
    <input class="input" id="newMyGroup" name="name" maxlength="20" placeholder="例如：球友、老同学">
    <button class="btn btn-sm" type="submit">加一个我自己的标签</button>
  </form>

  <?php
  // 只有我自己建的标签才给改名 / 删除 —— 公共标签要在系统设置里改（那是管理员的事），
  // 免得有人在自己设置里把"家人"改成别的、影响全家。
  $pgMine = array_values(array_filter($pgGroups, fn($g) => (int)$g['owner_id'] > 0));
  ?>
  <?php if ($pgMine): ?>
    <ul class="group-manage" style="margin-top:14px">
      <?php foreach ($pgMine as $g): $pgGid = (int)$g['id']; ?>
        <li class="group-manage-row">
          <form method="post" action="<?= e(url('settings/groups/rename')) ?>" class="group-rename">
            <?= csrf_field() ?>
            <input type="hidden" name="id" value="<?= $pgGid ?>">
            <input type="hidden" name="scope" value="me">
            <label class="sr-only" for="gname<?= $pgGid ?>">标签名</label>
            <input class="input" id="gname<?= $pgGid ?>" name="name" maxlength="20"
                   value="<?= e((string)$g['name']) ?>">
            <button class="btn btn-ghost btn-sm" type="submit">改名</button>
          </form>
          <span class="group-count muted small"><?= (int)($pgCounts[$pgGid] ?? 0) ?> 人</span>
          <?php /* 删除做成两步（<details>），不用 JS 也能防手滑 —— 一点就没了太容易出事 */ ?>
          <details class="del-wrap">
            <summary class="btn btn-ghost btn-sm">删除</summary>
            <form method="post" action="<?= e(url('settings/groups/delete')) ?>" class="del-confirm">
              <?= csrf_field() ?>
              <input type="hidden" name="id" value="<?= $pgGid ?>">
              <input type="hidden" name="scope" value="me">
              <?php /* 🔴 v54：删词表的**成员语义变了** ——
                   原来它删的是"分组"，挂在这一组的人会变成「未分类」；
                   现在它只是**从可选词里去掉这个词**，已经打在别人身上的标签**不受影响**
                   （标签是各自身上的字符串，不是引用）。文案必须说清，
                   否则用户以为"删了=把人身上的标签也摘了"。 */ ?>
              <span class="small muted">只是从候选里去掉这个词，已经打在别人身上的不受影响，确定？</span>
              <button class="btn btn-ghost btn-sm danger" type="submit">确认删除</button>
            </form>
          </details>
        </li>
      <?php endforeach; ?>
    </ul>
  <?php endif; ?>

  <?php if (\App\Auth::isAdmin()): ?>
    <p class="small muted" style="margin:16px 0 0">
      公共标签在「<a href="<?= e(url('settings')) ?>#public-groups">系统设置</a>」里维护。
    </p>
  <?php endif; ?>
</div>
<?php unset($pgGroups, $pgCounts, $pgRosterN, $pgTotal, $pgMine, $pgGid, $pgOwn, $g); ?>