FamilyBook/templates/settings.php

<?php
/**
 * 设置（仅管理员）。
 *
 * 与早期版本的两处不同，都是被明确要求改的：
 *   ① **「家庭名称」撤了**。首页标题已经是「某某某的家书」，一个家庭级名字
 *      既没人看、又容易和它打架；后端 settings/update 也不再接收这个字段，
 *      免得"某次提交把名字清空"。库里那一列留着不动（历史数据无害）。
 *   ② **slogan 变成"系统级默认"**。真正的 slogan 是每个人自己写的那句
 *      （在「我的资料」里），这里是**没人写自己的时候拿出来的兜底**。
 *   另加：阿里云 OSS 的**连通性测试**——逐步摊开结论，
 *   让"连不上"有具体原因，而不是一句"写入失败"。
 */
?>
<form method="post" action="<?= e(url('settings/update')) ?>" class="card card-pad">
  <?= csrf_field() ?>
  <h2 class="section-title">家庭 <span class="hint">首页上那一行小字</span></h2>
  <div class="form-grid">
    <div class="field full">
      <label for="motto">系统 slogan</label>
      <input class="input" id="motto" name="motto" value="<?= e($family['motto'] ?? '') ?>"
             placeholder="例如：一本用岁月写成的家谱">
      <span class="tip">
        每个人都可以在「我的资料」里写**自己的一句**，有的话就显示他自己的；
        <b>没写的人才用这里的这句</b>。所以这是一句"兜底"，不是全家的统一口号。
      </span>
    </div>
    <?php /* ⚠️ 天气的坐标输入框**从这里撤了**（用户 2026-10-03 第 1 条）。
         原话是「让用户在个人设置中填写自己的城市」——
         地点是**每个人自己**的事（一家人可能分处两地），而且应该是"填城市名"，
         不该让用户去查经纬度。现在在「个人设置 → 天气 · 我所在的城市」里。 */ ?>
  </div>
  <div class="btn-row">
    <button class="btn" type="submit">保存</button>
  </div>
</form>

<?php if (($upgradeWarn ?? '') !== ''): ?>
  <div class="flash" style="margin-top:16px">
    <div class="flash-item err">
      <b>上次结构升级有步骤失败了</b>（其余步骤已经跑完，站点可用）：<br>
      <?= e((string)$upgradeWarn) ?><br>
      <span class="muted small">修好之后可以清掉这条提示。</span>
    </div>
  </div>
<?php endif; ?>

<!-- ==================== 公共标签 ==================== -->
<?php
/* 🔴 v54（用户 2026-10-16 第 2 条）：这块从「公共分组」改口径为「公共标签」。
   用户原话：「现在已经没有分组的概念了，**全部都是标签的概念**。」
   ⇒ 这里维护的是**公共标签词表**：名册里给成员打标签时，这些词会出现在候选里
      （见 `App\PersonTag::choices()`）。表名仍叫 person_groups（见 _person_groups.php
      的说明：改名要背着 PersonGroup 类与其它会话正在改的 App-API 一起动，不划算），
      但界面上一律说"标签"。 */
$pubGroups = $pubGroups ?? [];
$pubCounts = $pubCounts ?? [];
$pubTotal  = count($pubGroups);
?>
<div class="card card-pad" style="margin-top:20px" id="public-groups">
  <h2 class="section-title">
    公共标签
    <span class="hint">全家人共用的一套</span>
  </h2>
  <p class="small muted" style="margin:0 0 16px">
    这里维护的是<b>公共标签</b> —— 建一次，全家每个人给名册成员打标签时都能拿来用。
    <br>
    每个人还可以在「名册 → 设置 → 名册标签」里<b>再加只给自己看的标签</b>，
    那部分不在这儿、也不会影响别人。挪顺序用 ▲ ▼（▲▼ 调的是"全家的默认顺序"，
    各人仍可在名册设置里改成自己习惯的顺序）。
    <br>
    删掉一个标签<b>只是从候选里去掉这个词</b>：已经打在别人身上的标签不受影响
    （标签是各人身上记着的词，不是引用）。
  </p>

  <?php if ($pubGroups): ?>
    <ol class="order-list">
      <?php foreach ($pubGroups as $i => $g): $gid = (int)$g['id']; ?>
        <li class="order-row">
          <span class="order-no"><?= $i + 1 ?></span>
          <span class="order-name"><?= e((string)$g['name']) ?></span>
          <span class="order-count"><?= (int)($pubCounts[$gid] ?? 0) ?> 人</span>
          <form method="post" action="<?= e(url('settings/groups/move')) ?>" class="order-move">
            <?= csrf_field() ?>
            <input type="hidden" name="id" value="<?= $gid ?>">
            <input type="hidden" name="scope" value="public">
            <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 === $pubTotal - 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="public">
    <label class="sr-only" for="newPubGroup">新标签名</label>
    <input class="input" id="newPubGroup" name="name" maxlength="20" placeholder="例如：邻居、亲家、老同事">
    <button class="btn btn-sm" type="submit">加一个公共标签</button>
  </form>

  <?php if ($pubGroups): ?>
    <ul class="group-manage" style="margin-top:14px">
      <?php foreach ($pubGroups as $g): $gid = (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="<?= $gid ?>">
            <input type="hidden" name="scope" value="public">
            <label class="sr-only" for="pgname<?= $gid ?>">标签名</label>
            <input class="input" id="pgname<?= $gid ?>" 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)($pubCounts[$gid] ?? 0) ?> 人</span>
          <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="<?= $gid ?>">
              <input type="hidden" name="scope" value="public">
              <span class="small muted">这组的人会变成「未分类」，确定？</span>
              <button class="btn btn-ghost btn-sm danger" type="submit">确认删除</button>
            </form>
          </details>
        </li>
      <?php endforeach; ?>
    </ul>
  <?php endif; ?>
</div>

<!-- ==================== 附件存储 ==================== -->
<form method="post" action="<?= e(url('settings/storage')) ?>" class="card card-pad" style="margin-top:20px">
  <?= csrf_field() ?>
  <h2 class="section-title">
    附件存储
    <span class="hint">头像等文件存哪儿</span>
  </h2>

  <p class="small muted" style="margin:0 0 16px">
    数据库里只存「相对路径」，所以随时可以在本地与云端之间切换 ——
    已上传的文件会按「本地优先」的顺序去找，切换后老文件照样能打开，出问题也能随时切回来。
    <br>
    <b>不管选哪个，页面上的图片与附件都统一走 <code>media.php</code> 代理</b>：
    桶不必开公共读、<code>uploads/</code> 也可以封死，能不能看由登录态决定。
  </p>

  <div class="field" style="margin-bottom:16px">
    <label>存在哪里</label>
    <div class="radio-row">
      <label class="radio-item">
        <input type="radio" name="driver" value="local" <?= $storageDriver === 'local' ? 'checked' : '' ?>>
        <span><b>服务器本地</b><br><span class="muted small">最简单，文件和服务在一起。适合家里自己用。</span></span>
      </label>
      <label class="radio-item">
        <input type="radio" name="driver" value="oss" <?= $storageDriver === 'oss' ? 'checked' : '' ?>>
        <span><b>阿里云 OSS</b><br><span class="muted small">文件独立存放，换服务器不丢。</span></span>
      </label>
    </div>
  </div>

  <?php if ($storageDriver === 'oss' && !$storageOk): ?>
    <div class="flash"><div class="flash-item err">
      云端配置还不完整，系统现在<b>临时用本地存储</b>在跑 —— 填全下面的信息再保存。
    </div></div>
  <?php elseif ($storageDriver === 'oss'): ?>
    <div class="flash"><div class="flash-item">
      当前生效：阿里云 OSS<?= $storageEffective === 'local' ? '（配置不完整，实际走的本地）' : '' ?>
    </div></div>
  <?php endif; ?>

  <details class="oss-box" <?= $storageDriver === 'oss' ? 'open' : '' ?>>
    <summary>阿里云 OSS 参数</summary>
    <div class="form-grid" style="margin-top:14px">
      <div class="field">
        <label>凭据方式</label>
        <select class="select" name="oss[auth_mode]">
          <option value="ak" <?= $storageOss['auth_mode'] === 'ak' ? 'selected' : '' ?>>AccessKey（手动填）</option>
          <option value="ecs_role" <?= $storageOss['auth_mode'] === 'ecs_role' ? 'selected' : '' ?>>服务器绑定角色（更安全）</option>
        </select>
        <span class="tip">若这台服务器是阿里云 ECS 且绑了 RAM 角色，优先用角色 —— 服务器上不落长期密钥。</span>
      </div>
      <div class="field">
        <label>Bucket</label>
        <input class="input" name="oss[bucket]" value="<?= e($storageOss['bucket']) ?>" placeholder="例如 my-family-bucket">
      </div>
      <div class="field">
        <label>Endpoint</label>
        <input class="input" name="oss[endpoint]" value="<?= e($storageOss['endpoint']) ?>"
               placeholder="oss-cn-beijing.aliyuncs.com">
        <span class="tip">不要带 https://，且要和桶的地域一致。</span>
      </div>
      <div class="field">
        <label>桶内前缀</label>
        <input class="input" name="oss[prefix]" value="<?= e($storageOss['prefix']) ?>" placeholder="可留空，如 familybook">
        <span class="tip">一个桶放多个站点时用它隔开。</span>
      </div>
      <div class="field">
        <label>AccessKey ID</label>
        <input class="input" name="oss[access_key_id]" value="<?= e($storageOss['access_key_id']) ?>"
               autocomplete="off" placeholder="用角色方式时可留空">
      </div>
      <div class="field">
        <label>AccessKey Secret</label>
        <input class="input" name="oss[access_key_secret]" type="password"
               value="<?= $storageOss['access_key_secret'] !== '' ? '••••••••••••' : '' ?>"
               autocomplete="new-password" placeholder="留空表示不改动已保存的">
      </div>
      <div class="field">
        <label>RAM 角色名</label>
        <input class="input" name="oss[ram_role_name]" value="<?= e($storageOss['ram_role_name']) ?>"
               placeholder="留空 = 自动取实例绑定的角色">
      </div>
      <div class="field">
        <label>自定义域名 / CDN</label>
        <input class="input" name="oss[custom_domain]" value="<?= e($storageOss['custom_domain']) ?>"
               placeholder="可留空">
        <span class="tip">填了会替代 bucket.endpoint 生成访问地址；该域名需已绑定到这个桶。</span>
      </div>
      <div class="field full">
        <label class="check-item">
          <input type="checkbox" name="oss[internal_endpoint]" value="1"
                 <?= $storageOss['internal_endpoint'] === '1' ? 'checked' : '' ?>>
          <span>服务端读取优先走内网 endpoint（服务器与桶在同地域时更快，还免流量费）</span>
        </label>
        <label class="check-item">
          <input type="checkbox" name="oss[https]" value="1"
                 <?= $storageOss['https'] === '1' ? 'checked' : '' ?>>
          <span>用 HTTPS 访问对象</span>
        </label>
      </div>
    </div>
  </details>

  <div class="btn-row">
    <button class="btn" type="submit">保存存储设置</button>
  </div>
</form>

<!-- ==================== 两种测试 ==================== -->
<div class="card card-pad" style="margin-top:16px">
  <h2 class="section-title">
    连通性测试
    <span class="hint">两种测试的分工不一样</span>
  </h2>
  <p class="small muted" style="margin:0 0 14px">
    「当前存储」测的是<b>现在生效的那一个</b>（可能是本地），只回答"能不能存东西"；
    「OSS 连通性」测的是<b>下面填的那套 OSS 参数本身</b> —— 即使现在跑在本地也能测，
    这样就可以<b>先把 OSS 测通、再切过去</b>，而不是"先切、发现不行、再切回来"。
  </p>

  <div class="test-actions">
    <form method="post" action="<?= e(url('settings/test_storage')) ?>">
      <?= csrf_field() ?>
      <button class="btn btn-ghost" type="submit">测试当前存储</button>
      <span class="small muted">写一个临时文件 → 读回来 → 删掉</span>
    </form>
    <form method="post" action="<?= e(url('settings/test_oss')) ?>">
      <?= csrf_field() ?>
      <button class="btn btn-ghost" type="submit">测试 OSS 连通性</button>
      <span class="small muted">逐步：配置 → 凭据 → 地域 → 公网 → 内网 → 读写</span>
    </form>
  </div>

  <?php if (!empty($ossDiag['steps'])): ?>
    <?php
    $dSteps = (array)$ossDiag['steps'];
    $dOk    = 0;
    foreach ($dSteps as $s) {
        if (!empty($s['ok'])) {
            $dOk++;
        }
    }
    $dAll = $dOk === count($dSteps);
    ?>
    <div class="oss-diag <?= $dAll ? 'is-ok' : 'is-bad' ?>">
      <div class="oss-diag-head">
        <b><?= $dAll ? '全部通过' : '有问题' ?></b>
        <span>共 <?= count($dSteps) ?> 步，通过 <?= $dOk ?> 步</span>
        <?php if (!empty($ossDiag['at'])): ?>
          <span class="muted small">· <?= e(date('Y-m-d H:i:s', (int)$ossDiag['at'])) ?></span>
        <?php endif; ?>
      </div>
      <table class="oss-diag-table">
        <thead>
          <tr><th>步骤</th><th>结论</th><th>耗时</th><th>详情</th></tr>
        </thead>
        <tbody>
          <?php foreach ($dSteps as $s): ?>
            <tr class="<?= !empty($s['ok']) ? 'row-ok' : 'row-bad' ?>">
              <td><?= !empty($s['ok']) ? '✓' : '✕' ?> <?= e((string)($s['name'] ?? '')) ?></td>
              <td><?= !empty($s['ok']) ? '通过' : '失败' ?></td>
              <td class="mono"><?= (int)($s['ms'] ?? 0) ?> ms</td>
              <td><?= nl2br(e((string)($s['detail'] ?? ''))) ?></td>
            </tr>
          <?php endforeach; ?>
        </tbody>
      </table>
      <p class="small muted" style="margin:12px 0 0">
        探针对象用后即删，不会在桶里留垃圾；跑完这一遍之后再切驱动最稳妥。
      </p>
    </div>
  <?php else: ?>
    <p class="small muted" style="margin:14px 0 0">
      还没测过。建议<b>先在下面填好 OSS 参数并保存，再点「测试 OSS 连通性」</b>，
      通过之后再回到上面把「存在哪里」切到阿里云 OSS。
    </p>
  <?php endif; ?>
</div>

<!-- ==================== 运行环境 ==================== -->
<div class="card card-pad" style="margin-top:20px">
  <h2 class="section-title">运行环境 <span class="hint">排错时看这一块</span></h2>
  <dl class="kv">
    <div class="kv-row"><dt>PHP</dt><dd><?= e(PHP_VERSION) ?></dd></div>
    <div class="kv-row"><dt>数据库</dt><dd><?= e($dbVersion) ?></dd></div>
    <div class="kv-row"><dt>加密密钥</dt><dd><?= $keyOk ? '已配置' : '<span style="color:var(--red)">未配置</span>' ?></dd></div>
    <div class="kv-row">
      <dt>附件存储</dt>
      <dd><?= $storageEffective === 'oss' ? '阿里云 OSS' : '服务器本地' ?>
        <?php if ($storageDriver !== $storageEffective): ?>
          <span class="muted small">（设置的是 OSS，但配置不全，实际用本地）</span>
        <?php endif; ?>
      </dd>
    </div>
    <div class="kv-row">
      <dt>附件出口</dt>
      <dd>统一走 media.php 代理 <span class="muted small">（本地与云端同一形态，需登录才能读）</span></dd>
    </div>
    <div class="kv-row">
      <dt>亲属连线</dt>
      <dd><?= (int)$relCount ?> 条</dd>
    </div>
    <div class="kv-row">
      <dt>账号</dt>
      <dd>
        管理员 <?= (int)$roleCounts['admin'] ?> ·
        家庭成员 <?= (int)$roleCounts['member'] ?> ·
        访客 <?= (int)$roleCounts['guest'] ?>
      </dd>
    </div>
  </dl>
  <p class="small muted" style="margin:14px 0 0">
    手机号与身份证号都是加密后入库的。这个密钥一旦换掉，已有数据就再也解不开 ——
    请把它和数据库分开、各备份一份。
  </p>
  <p class="small muted" style="margin:10px 0 0">
    访客账号在「<a href="<?= e(url('accounts/invite')) ?>">邀请访客</a>」里开通。
  </p>
</div>