Files
FamilyBook/templates/people/form.php
T
laoyang 26026c7250 v53:纪念日记年份算「第几个」/ 首页待办排在进行中下面 / 日程编辑浮层跨满整行 / 新增成员打标签 / 新增页一次填完称呼与备注
用户 2026-10-16 五条。

① 纪念日要记录年份,才能知道「第几个」
   用户原话:「纪念日需要记录年份,这样才能知道**是第几个纪念日**。」
   **真根因有两层**(两处一起才构成"没有年份"):
     · 表里没有:anniversaries 只有 month + day(当年当成"一年一度,年份无意义");
     · 表单有、但被丢掉:日期控件本来就带年份(<input type="date"> 是 YYYY-MM-DD),
       而拆分 JS **只取 mm/dd**(`mo.value = m[2]; dy.value = m[3];`)⇒ 想存也没存上。
   修法:anniversaries.year(SMALLINT UNSIGNED NULL)+ 升级路径 addColumn;
     表单补 hidden year、拆分 JS 一并写;Anniversary::save 收 year(**区间守卫 1900..2100**);
     occurrences() 输出 year 与 nth;列表页显示「2018 年起 · 第 9 个」。
   ⚠️ 年份**可空、且不给默认值**:老数据就是没有年份,猜一个(按创建年之类)
      会让页面算出一个**错的**"第 N 个"。NULL = 只按月日过、不显示序号 —— 诚实。
   ⚠️ 顺带修一个自相矛盾:repeat_type='once' 原来落在公历分支 ⇒ **年年都冒出来**;
      现在有年份了 ⇒ 只在那一年出现(没年份的保持老行为,不凭空丢)。
   🔴 **序号算法抽成单点来源 `Anniversary::nthFor()`** —— `occurrences()`(临近区)与
      days/index.php(我添加的那张表)**都调它**;两处各写一遍是"改一处忘一处"的温床。
      用**今天所在的年**("今年是第几个"),不是"下一次发生那年"。
   🔴🔴 **踩坑(最值钱)**:`addColumn`(ALTER TABLE)**必须排在那张表 CREATE TABLE 之后**。
      第一版放进 movie_details 那段(anniversaries 的建表更靠后)⇒ 全新安装
      `1146 Table 'fb_test.anniversaries' doesn't exist` ⇒ 整段 ensure() 抛异常 ⇒
      **install 直接"安装失败"**(POST 回 200、不自删、schema_version=None、库一片空白)。
      新建库走 CREATE TABLE、老库走 addColumn —— **两条路都要在**。

② 首页近期任务:把待办也放进来(排在进行中下面)
   用户原话:「首页的近期任务,**把待办也放进来吧,放在进行中的下面**。」
   原来只收「进行中 + **已逾期**的待办」(当年怕待办一多首页变长清单)。
   ⇒ 现在**全部**收进来、按**状态分组**(doing 在前、todo 在后);
     两组内部仍按截止时间升序(byStatus 的 ORDER BY 已排好)。
   ⚠️ 配套改统计:`count($tasks) 件在做` 会把待办也算成"在做" ⇒ 改成**按状态拆开数**
      (进行中→「件在做」、待办→「件待办」,两数相加=列表行数,仍同源)。
      「件待办」原读 stat7['todos'](**与列表不同源**,v24 踩过"数字和列表对不上")。
   ⚠️ 空态:「没有进行中的任务,也没有待办。」
   ⚠️ .hd-pane-body 本来就是 overflow-y:auto + flex:1 1 auto/min-height:0,行数变多**内部滚动**、
      卡片高度不变(v32"两块外框恒等高"那套兜住了)。

③ 日程编辑浮层「只有左侧有内容,右侧空白,好像分栏了」
   **真根因**(assets/css/app.css):日程编辑页 event.php 里,`.mv-grid`(观影式**纵向**列表)
   被嵌在**两列**的 `.form-grid` 里 ⇒ 它只占**第一列**。整页形态下看不出来(页面宽),
   但**浮层里面板只有 620px** ⇒ 两列各 286px ⇒ 所有字段挤在左边 286px、右边整列空着。
   实测:panel=620 / form-grid=588 / cols="286px 286px" / mv-grid w=286
        →修后 mv-grid w=588(95% of panel)、标题输入框 w=516、距右缘 ~2px。
   修法:`.form-grid > .mv-grid { grid-column: 1 / -1; }` —— **一行 CSS**。
   ⚠️ 不去改 event.php 里"整页保留两列、浮层用 mv-grid"那个结构判断(那是有意保留的);
      `.mv-grid` 本身就是"一整块、占满宽度"的语义,天生不该被塞进半列。
   ⚠️ 排查手法:这种"看起来像分栏"的问题**量几何比读 CSS 快** ——
      getBoundingClientRect 打出 panel/grid/cols/内层宽,一眼看出"嵌了几层 grid"。

④ 添加成员时是**打标签**,不是选分组
   用户原话:「名册中添加成员时,**不是选择分组,而是打标签**。现在已经没有分组的概念了,
   **只有标签的概念**。」
   ⇒ 新增分支的「所属分组」下拉(group_id)换成**标签输入**(复用 v51 的 #ptBlock 那套:
      候选勾选 + 自由输入,**文本框是唯一提交源**)。
   ⚠️ 只在**新增**时出现在那个位置(编辑时上面那个 #ptBlock 已在管标签,出现两块会让人以为填两遍)。
   ⚠️ **分组表结构 person_roster.group_id 保留不动**(名册"拖动归档"还在用、历史数据也在),
      只是**新增入口不再要求人选**。
   ⚠️ e2e 里 v14「新增表单**有**分组下拉」与新需求正相反 ⇒ 改成「没有 group_id + 有 name=tags」。

⑤ 添加成员页一次填完「我对他的称呼 + 我的备注」
   用户原话:「我在添加一个成员的时候,是不是可以直接在添加成员的页面里填写**我对他的称呼**
   以及**我对他的备注**,**一次就解决**?要不然还得先添加、再返回他的名册去填,有点麻烦。」
   ⇒ 新增页也出现这两栏:
     · **我对他的备注**(person_notes)—— 条件从 `$isEdit && !$isSelf` 改成 `!$isSelf`;
     · **我对他的称呼**(nicknames)—— **新加的输入框** `name="my_nick"`。
   服务端 people/create 落两表(挂**我**名下:viewer=我, target=他)。
   ⚠️ 判"表单里有没有这一栏"用 **array_key_exists**(不是判值是否为空)——
      与编辑路径同一口径:**空串是明确的"清空"语义**(Nickname::set('') 会删行)。
   ⚠️ 四处**重渲染路径**(撞名确认/校验失败/手机号重复/people/new 初始)都要带上
      myTags/tagChoices/myNick,否则一撞名或一报错,刚打的标签与刚写的称呼备注就全没了。
   ⚠️ 编辑页也补 myNick 回显(否则"新增时填了、编辑页看不见"会以为没存上)。

验证(新增 2 套件 + 更新 e2e/deploy 断言):
 · _fb_v53_ui.py(**26 条**真机断言)
 · _b53_falsify.py(**10 注入 / 10 全抓**,基线 26/0)
 · e2e **1517/0**;familybook_deploy.sh 加 v53 静态断言段(14 正向 + 1 反向)
 · 全流水线 **PUSH_RC=0**、部署 0 FAIL(含"第53批形态")
 · 线上 8 文件 md5 逐字节一致;`anniversaries.year` 已由升级路径补上(nullable smallint);
   线上实测 nthFor 4 用例全对(2018→第9个 / null→NULL / 2019→2 / 未来年→NULL);
   诊断页已删并复验 404

⚠️ 本轮踩坑(已写进 pitfalls.md / 工作日志):
 · **`addColumn` 必须在同表的 CREATE TABLE 之后**(否则全新安装 `1146` ⇒ ensure() 抛异常);
 · **探针里 `dispatchEvent(new Event('submit'))` 不会真的提交表单**
   (不导航、不发请求)⇒ 判"存没存上"必须真点提交按钮或 `requestSubmit()`;
 · **反向验证的 `restore()` 不能只是"再跑一遍 build_work()"**(指纹闸门会把它变空操作
   ⇒ 第二轮基线是脏的,26/0 掉到 14/12);恢复必须**无条件** copy2;
 · **注入锚点在源码里出现两次 ⇒ 打到别处 ⇒ 那条断言恒不红**
   (v53 给新增页也加了 `id="ptBlock"`,打偏了 v51 那条"编辑页标签块"的注入);
 · **别把两个共用 fb_test 库的套件并行跑**(互相删播种行 ⇒ 看着像"整套功能坏了");
 · **部署静态断言的锚点引号/反斜杠必须与源码一字不差**:`\[` 在 bash 双引号里是
   **字面反斜杠**、单双引号不能混、漏个 `(int)` 也搜不到 —— 一轮里连红 4 条全是这个。
2026-10-16 16:51:04 +08:00

663 lines
37 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?php
/**
* 成员表单(新增 / 编辑)。
*
* 三处与早期版本不同的地方:
* · 「小名」没了 —— 称呼是**视角属性**(妈妈叫"明明"、姐姐叫"小弟"),
* 在「成员详情」页里各自设置自己怎么叫,不写在这个人的档案里。
* · 生日有两种记法:阳历生日与农历生日(证件上那天照常存库,但按用户要求不再显示)。
* 阳历与农历是同一个人的同一天,所以用「以哪个为准」明确这次填的是哪一个,
* 服务端据此反推另一个 —— 不靠 JS,避免"JS 没跑到就静默存错"。
* · 生日精确到**时分秒**:原生 datetime-local 只有时分、且中文环境会显示成
* 「下午 03:30」,所以用 _datetime.php 的「日期 + 24 小时制时:分:秒」组合控件。
*/
$isEdit = !empty($person['id']);
$avatarUrl = avatar_url($person['avatar'] ?? null);
// 这张表单有**两个入口**(名册/详情页的「编辑资料」、个人设置里的「编辑我的资料」),
// 但只有一套字段。改自己、且不是能写的人(访客)时,只给属于他自己的那些 ——
// 见 index.php 的 people/update(那条分支调 Person::updateSelf)。
$canEditAll = $canEditAll ?? \App\Auth::canWrite();
$isSelf = $isSelf ?? false;
$bdSource = old('birthday_source', 'solar');
// 库里这列叫 birthday、表单叫 birthday_solar,一律走 solarOf() 取,别直接下标
$solVal = old('birthday_solar', \App\Birthday::pretty(\App\Birthday::solarOf($person ?? [])));
$lunVal = old('birthday_lunar', '');
if ($lunVal === '') {
// 农历控件的值 = 库里存的农历年月日 + 时间
$lv = (string)($person['birthday_lunar'] ?? '');
$lunVal = $lv;
}
// 补充联系方式(v6 起):新增时是空数组;编辑时是库里解密后的行;
// 校验失败重画时是用户刚提交的那批(连同填错的也要原样带回)。
$contacts = $contacts ?? [];
foreach (['phone', 'email', 'address', 'url'] as $ctKind) {
if (!isset($contacts[$ctKind]) || !is_array($contacts[$ctKind])) {
$contacts[$ctKind] = [];
}
}
$ctEmpty = ['label' => '', 'value' => ''];
$ctTitles = [
'phone' => '补充电话',
'email' => '补充邮箱',
'address' => '其他地址',
'url' => '网址',
];
$ctHints = [
'phone' => '主手机号在「手机号」一栏(开通登录用);这里放工作号、老人机、家里座机等',
'email' => '主邮箱在「邮箱」一栏;这里放其他邮箱',
'address' => '住址在「住址」一栏;这里放单位地址、老家地址等',
'url' => '主页、博客、店铺链接……',
];
?>
<div class="page-head">
<h1><?= $isEdit ? ($isSelf ? '我的资料' : '编辑成员') : '添加成员' ?></h1>
<span class="sub"><?= $isEdit ? e($person['name']) : '填姓名就行,其他都可以以后再补' ?></span>
<?php /* 用户 2026-10-04 第 8 条:编辑资料的页面也要能**回到名册**。
编辑时是从名册点进来的,改完最常做的下一件事就是回名册找下一个人 ——
没有这个按钮就只能靠浏览器后退(而提交保存之后后退会退到旧页面上)。 */ ?>
<div class="actions">
<a class="btn btn-ghost btn-sm" href="<?= e(url('people')) ?>">返回名册</a>
</div>
</div>
<form method="post" enctype="multipart/form-data"
action="<?= e(url($isEdit ? 'people/update' : 'people/create')) ?>">
<?= csrf_field() ?>
<?php if ($isEdit): ?>
<input type="hidden" name="id" value="<?= (int)$person['id'] ?>">
<?php endif; ?>
<?php /* 🔴🔴 v52(用户 2026-10-15 第 5 条):「是不是这个人?」
新增成员时,若按 姓名 / 手机号 / 身份证号 在家里找到匹配的人,
**就在这张表里问一句** —— 而不是跳到一个单独的确认页。
⚠️ 关键理由:单独一页要把用户刚填的一整张表(含工作经历、补充联系方式
这些**数组字段**)原样回传;漏传任何一类都会**静默丢数据**。
在同一张表里问,字段天然全在。
⚠️ 两个按钮提交的就是**这张表**,靠 `confirm_existing` 的值分流:
1 = 就是这个人(不新建,直接加进我的名册);0 = 不是,另建一条。 */ ?>
<?php if (!empty($confirmHit)): ?>
<?php
$cfWhy = [
'phone' => '手机号一样',
'id_card' => '身份证号一样',
'name' => '姓名一样',
][(string)($confirmWhy ?? 'name')] ?? '信息很像';
$cfPid = (int)($confirmHit['id'] ?? 0);
$cfInMine = \App\PersonRoster::has((int)\App\Auth::familyId(), (int)\App\Auth::personId(), $cfPid);
?>
<div class="card card-pad person-confirm" id="personConfirm">
<h2 class="section-title">
家里已经有这个人了 —— 是他吗?
<span class="hint"><?= e($cfWhy) ?></span>
</h2>
<p class="small muted" style="margin:0 0 12px">
如果是他,直接加进你的名册就行 —— <b>资料共用同一份</b>,不用再录一遍,
以后你们改的也是同一个人。
<br>如果不是(只是重名),点「不是,是另一个人」,我就按你填的当新人建一条。
</p>
<div class="person-hit">
<span class="person-hit-av">
<?php if (!empty($confirmHit['avatar'])): ?>
<img src="<?= e(media_url((string)$confirmHit['avatar'])) ?>" alt="">
<?php else: ?>
<span class="avatar-fallback"><?= e(mb_substr((string)($confirmHit['name'] ?? ''), 0, 1, 'UTF-8')) ?></span>
<?php endif; ?>
</span>
<span class="person-hit-info">
<b><?= e((string)($confirmHit['name'] ?? '')) ?></b>
<?php if (!empty($confirmHit['is_placeholder'])): ?><span class="node-badge">虚拟人物</span><?php endif; ?>
<?php if ($cfInMine): ?><span class="node-badge badge-open">已在你的名册</span><?php endif; ?>
<span class="small muted">
<?php if ((string)($confirmHit['org'] ?? '') !== ''): ?><?= e((string)$confirmHit['org']) ?> · <?php endif; ?>
<?php if ((string)($confirmHit['title'] ?? '') !== ''): ?><?= e((string)$confirmHit['title']) ?><?php endif; ?>
</span>
</span>
<span class="person-hit-ops">
<a class="btn btn-ghost btn-sm" href="<?= e(url('people/show', ['id' => $cfPid])) ?>"
target="_blank" rel="noopener">先看看他的资料</a>
</span>
</div>
<div class="btn-row" style="margin-top:16px">
<button class="btn" type="submit" name="confirm_existing" value="1">就是这个人,加进我的名册</button>
<button class="btn btn-ghost" type="submit" name="confirm_existing" value="0">不是,是另一个人</button>
<input type="hidden" name="existing_id" value="<?= $cfPid ?>">
</div>
</div>
<?php endif; ?>
<div class="card card-pad">
<div class="form-grid">
<?php
// 裁剪比例不是拍脑袋定的,而是由「这个位置显示成什么形状」决定(见 App\ImageSlot)。
// 前端拿这些 data-* 去生成裁剪框,服务端拿同一个槽位去最终裁切 —— 一处定义、两处使用。
$avSlot = \App\ImageSlot::get('avatar');
?>
<?php /* 用户 2026-10-03 第 6 条:**头像放在表单最前面**,并且**去掉「选择文件」按钮**
—— 直接点那张(默认)头像就是选文件,选完弹裁剪框。
好处:① 省掉一整行"选择文件 + 当前头像"的重复控件;
② 一眼就知道"这里能换头像"(按钮式的 file 控件反而看不出当前长什么样)。 */ ?>
<div class="field full avatar-field">
<label>头像</label>
<div class="avatar-picker">
<img id="avatar-preview" src="<?= e($avatarUrl) ?>" alt=""
title="点击更换头像"
data-pick-input="#avatar"
data-has-avatar="<?= trim((string)($person['avatar'] ?? '')) !== '' ? '1' : '0' ?>">
<?php /* 真正吃文件的 input:视觉上藏起来,由上面的图片代它触发
(app.js 的通用绑定认 data-pick-input,不依赖 for/id 配对)。 */ ?>
<input class="sr-only" id="avatar" name="avatar" type="file" accept="image/*"
data-crop-ratio="<?= e((string)$avSlot['ratio']) ?>"
data-crop-w="<?= (int)$avSlot['w'] ?>"
data-crop-h="<?= (int)$avSlot['h'] ?>"
data-crop-label="<?= e((string)$avSlot['label']) ?>"
data-crop-hint="<?= e((string)$avSlot['hint']) ?>"
data-crop-preview="#avatar-preview">
<?php /* 用户挑的裁剪框(归一化的,相对原图 0..1);不裁就留空 = 居中裁切 */ ?>
<input type="hidden" name="avatar_crop" value="">
<span class="avatar-hint small muted">
点一下换头像;选完会弹裁剪框。<br>
头像是 1:1 正方形,多大都能传,保存时自动缩成 <?= (int)$avSlot['w'] ?>×<?= (int)$avSlot['h'] ?>。
</span>
</div>
</div>
<div class="field">
<label for="name">姓名 *</label>
<input class="input" id="name" name="name" value="<?= e(old('name', $person['name'] ?? '')) ?>" required>
<?php if (!empty($errors['name'])): ?><span class="err"><?= e($errors['name']) ?></span><?php endif; ?>
</div>
<div class="field">
<label for="gender">性别</label>
<select class="select" id="gender" name="gender">
<?php $g = old('gender', $person['gender'] ?? ''); ?>
<option value="" <?= $g === '' ? 'selected' : '' ?>>不填</option>
<option value="m" <?= $g === 'm' ? 'selected' : '' ?>>男</option>
<option value="f" <?= $g === 'f' ? 'selected' : '' ?>>女</option>
</select>
</div>
<?php if ($canEditAll): ?>
<div class="field">
<label for="birth_rank">家中排行</label>
<input class="input" id="birth_rank" name="birth_rank" type="number" min="1" max="99"
value="<?= e(old('birth_rank', $person['birth_rank'] ?? '')) ?>" placeholder="老大填 1">
<span class="tip">用来认兄弟姐妹的长幼:长子、次女、三弟…</span>
<?php if (!empty($errors['birth_rank'])): ?><span class="err"><?= e($errors['birth_rank']) ?></span><?php endif; ?>
</div>
<?php endif; ?>
<?php /* ⚠️ 这里**没有**「排序号」(已彻底取消,用户原话:「排序号,不要让用户填写」),
名册里的先后靠**拖动卡片**调。
🔴🔴 v53(用户 2026-10-16 第 4 条):「名册中添加成员时,**不是选择分组,
而是打标签**。现在已经没有分组的概念了,**只有标签的概念**。」
⇒ 原来这里是一个「所属分组」下拉(group_id)。现在改成**标签输入**,
与「编辑成员」页那个 #ptBlock 同一套(候选勾选 + 自由输入,文本框是唯一提交源)。
⚠️ 只在**新增**时出现在这个位置(编辑时上面那个 #ptBlock 已经在管标签了,
同一张表单里出现两块"标签"会让人以为要填两遍)。
⚠️ 分组(person_roster.group_id)**表结构保留不动** —— 名册里还靠它
做"拖动归档"的容器,历史数据也在。只是**新增入口不再要求人选它**。 */ ?>
<?php if (!$isEdit): ?>
<div class="field full" id="ptBlock">
<label for="pfTags">标签</label>
<?php if (!empty($tagChoices)): ?>
<div class="pt-picks pf-picks">
<?php foreach ($tagChoices as $tg): ?>
<label class="pt-pick">
<input type="checkbox" value="<?= e((string)$tg) ?>"
<?= in_array((string)$tg, array_map('strval', (array)($myTags ?? [])), true) ? 'checked' : '' ?>>
<span>#<?= e((string)$tg) ?></span>
</label>
<?php endforeach; ?>
</div>
<?php endif; ?>
<input class="input" id="pfTags" name="tags" maxlength="300"
value="<?= e(implode(' ', (array)($myTags ?? []))) ?>"
placeholder="如:亲戚 球友 同事(用空格分开)" autocomplete="off">
<span class="tip">
一个人可以有多个标签 —— 既是亲戚又是球友,两个都打上就行。<br>
<b>标签是你自己名册里的</b>:你给他打「球友」不会让全家的名册都多出这个词。
</span>
</div>
<?php endif; ?>
<!-- 生日块已挪到表单最底部:大多数情况下生日由身份证号读出、三个都对,
不需要动(用户原话:生日什么的应该放下面)。 -->
<?php /* 用户 2026-10-03 第 3 条:「编辑资料中,**这个人的**一句话,这个地方去掉,
每个人的一句话,**只能他自己修改**。如果他不修改,就是默认空的。」
→ 所以这一栏**只在改自己时出现**($isSelf):
别人编辑他时看不到、也改不了(那正是用户要"去掉"的场景);
而它确实得有个入口让他自己填,否则"只能他自己修改"就没有落点。
⚠️ 服务端同理:people/update 只在 $isSelf 时读 slogan,
否则"管理员编辑一次就把本人的那句话清空"。 */ ?>
<?php if ($isSelf): ?>
<div class="field full">
<label for="slogan">我的这一句话</label>
<input class="input" id="slogan" name="slogan" maxlength="200"
value="<?= e(old('slogan', $person['slogan'] ?? '')) ?>"
placeholder="可留空,如:慢慢来,比较快">
<span class="tip">只有你自己能改这句;显示在自己首页标题下面。留空就不显示。</span>
<?php if (!empty($errors['slogan'])): ?><span class="err"><?= e($errors['slogan']) ?></span><?php endif; ?>
</div>
<?php endif; ?>
<?php if ($canEditAll): ?>
<div class="field">
<label for="phone">手机号</label>
<input class="input" id="phone" name="phone" inputmode="numeric"
value="<?= e(old('phone', $phoneValue ?? '')) ?>" placeholder="可留空">
<span class="tip">开通登录后用它登录;加密存储,列表里只显示部分。其他号码放下面的「补充电话」。</span>
<?php if (!empty($errors['phone'])): ?><span class="err"><?= e($errors['phone']) ?></span><?php endif; ?>
</div>
<?php endif; ?>
<div class="field">
<label for="email">邮箱</label>
<input class="input" id="email" name="email" type="email"
value="<?= e(old('email', $person['email'] ?? '')) ?>" placeholder="可留空">
<?php if (!empty($errors['email'])): ?><span class="err"><?= e($errors['email']) ?></span><?php endif; ?>
</div>
<?php /* 用户 2026-10-03 第 4 条:单位/职务/职称**可以有多段**(记录工作变化)。
所以这里是一组"经历行",而不是三个单值输入框。
⚠️ 表单字段名是平行数组(job_org[] / job_title[] …),
服务端 read_jobs_input() + PersonJob::replace() 整组替换。 */ ?>
<div class="field full">
<label>工作经历</label>
<p class="small muted" style="margin:0 0 10px">
一个人可以有多段工作 —— 换过单位、提过职称都记下来。
<b>不填「结束年月」= 现在还在那儿</b>(列表里会标「现在」)。
</p>
<?php
// 回填优先级:老表单回显(old) → 库里已有的经历 → 完全空(新增时给一行空的)
$jobRows = $jobRows ?? [];
if (!$jobRows) {
$jobRows = [[]]; // 新增时给一行空白行,省得还要点"加一段"
}
?>
<div class="job-list" id="jobList">
<?php foreach ($jobRows as $jr): ?>
<div class="job-row">
<div class="job-cell">
<label class="job-lb">单位</label>
<input class="input" name="job_org[]" value="<?= e((string)($jr['org'] ?? '')) ?>" placeholder="如:中国海洋大学">
</div>
<div class="job-cell">
<label class="job-lb">职务</label>
<input class="input" name="job_title[]" value="<?= e((string)($jr['title'] ?? '')) ?>" placeholder="如:副院长">
</div>
<div class="job-cell">
<label class="job-lb">职称</label>
<input class="input" name="job_rank[]" value="<?= e((string)($jr['rank_name'] ?? '')) ?>" placeholder="如:副教授">
</div>
<div class="job-cell job-cell-sm">
<label class="job-lb">起</label>
<input class="input" type="month" name="job_start[]" value="<?= e((string)($jr['start_ym'] ?? '')) ?>">
</div>
<div class="job-cell job-cell-sm">
<label class="job-lb">止</label>
<input class="input" type="month" name="job_end[]" value="<?= e((string)($jr['end_ym'] ?? '')) ?>">
</div>
<button type="button" class="btn btn-ghost btn-sm job-del" title="删掉这一段">×</button>
</div>
<?php endforeach; ?>
</div>
<div class="btn-row" style="margin-top:8px">
<button type="button" class="btn btn-ghost btn-sm" id="jobAdd">+ 再加一段</button>
</div>
</div>
<?php if ($canEditAll): ?>
<div class="field full">
<label for="id_card">身份证号</label>
<input class="input mono" id="id_card" name="id_card"
value="<?= e(old('id_card', $idCardValue ?? '')) ?>" placeholder="可留空">
<span class="tip">
加密存储,页面上一律只显示前 6 后 4 位。
家庭场景里真正需要它的场合很少 —— 能不填就别填。
</span>
<?php if (!empty($errors['id_card'])): ?><span class="err"><?= e($errors['id_card']) ?></span><?php endif; ?>
</div>
<?php endif; ?>
<?php /* 用户 2026-10-04 第 4 条:地址拆成**国家 / 省 / 市 / 区 / 详细地址**五级。
前四级是级联下拉(数据在 regions 表里,全国 3429 条),
最后一级 `address` 就是原来的自由文本 —— 没那么详细时**只填到区**即可,
四个下拉里没选的那些存 NULL,不会留下一堆空串。
⚠️ 没有 JS 也能用:省/市/区三个下拉在服务端就把**当前这一条链**的选项渲染好了,
JS 只负责"换了省就把市和区跟着换"(见 assets/js/app.js 的 addr 段)。 */ ?>
<div class="field full">
<label for="addr_province">住址</label>
<div class="addr-grid" data-addr
data-src="<?= e(url('regions')) ?>">
<span class="addr-cell">
<span class="addr-k">国家</span>
<input class="input" id="addr_country" name="addr_country"
value="<?= e(old('addr_country', $person['addr_country'] ?? '')) ?>"
placeholder="中国" autocomplete="country-name">
</span>
<span class="addr-cell">
<span class="addr-k">省 / 自治区</span>
<select class="select" id="addr_province" name="addr_province" data-addr-lvl="1">
<option value="">(不填)</option>
<?php foreach (\App\Region::provinces() as $rg): ?>
<option value="<?= e($rg['name']) ?>" data-code="<?= e($rg['code']) ?>"
<?= old('addr_province', $person['addr_province'] ?? '') === $rg['name'] ? 'selected' : '' ?>>
<?= e($rg['name']) ?></option>
<?php endforeach; ?>
</select>
</span>
<span class="addr-cell">
<span class="addr-k">市</span>
<?php $cityCode = \App\Region::codeOfName(old('addr_province', $person['addr_province'] ?? ''), 1); ?>
<select class="select" id="addr_city" name="addr_city" data-addr-lvl="2"
data-code="<?= e($cityCode) ?>">
<option value="">(不填)</option>
<?php foreach (\App\Region::childrenOf($cityCode) as $rg): ?>
<option value="<?= e($rg['name']) ?>" data-code="<?= e($rg['code']) ?>"
<?= old('addr_city', $person['addr_city'] ?? '') === $rg['name'] ? 'selected' : '' ?>>
<?= e($rg['name']) ?></option>
<?php endforeach; ?>
</select>
</span>
<span class="addr-cell">
<span class="addr-k">区 / 县</span>
<?php $distCode = \App\Region::codeOfName(old('addr_city', $person['addr_city'] ?? ''), 2); ?>
<select class="select" id="addr_district" name="addr_district" data-addr-lvl="3"
data-code="<?= e($distCode) ?>">
<option value="">(不填)</option>
<?php foreach (\App\Region::childrenOf($distCode) as $rg): ?>
<option value="<?= e($rg['name']) ?>"
<?= old('addr_district', $person['addr_district'] ?? '') === $rg['name'] ? 'selected' : '' ?>>
<?= e($rg['name']) ?></option>
<?php endforeach; ?>
</select>
</span>
<span class="addr-cell addr-cell-wide">
<span class="addr-k">详细地址</span>
<input class="input" id="address" name="address"
value="<?= e(old('address', $person['address'] ?? '')) ?>"
placeholder="街道门牌、小区楼号……没有就留空" autocomplete="street-address">
</span>
</div>
<span class="tip">
没有详细地址时只填到「区 / 县」就行 —— 四级里没选的那些不会显示。
</span>
</div>
<?php /* 用户 2026-10-03 第 5 条:备注分两种 ——
① 这一栏是**这个人自己的**自我介绍/格言(他本人也能在个人设置里改,
别人打开他的资料能看到);
② 「我对他的私人备注」在下面单独一块(只有写的人自己看得到)。 */ ?>
<div class="field full">
<label for="note">自我介绍(他自己写的)</label>
<textarea class="input" id="note" name="note" placeholder="爱吃辣、对芒果过敏、怕坐过山车……"><?= e(old('note', $person['note'] ?? '')) ?></textarea>
<span class="tip">这是<b>他本人</b>的自我介绍,别人看得到。改的是同一份 —— 他也能在个人设置里改。</span>
</div>
<?php /* 用户第 5 条:**我对他的私人备注** —— 只有我自己看得到(存在 person_notes 里)。
只在"编辑别人"时出现(自己看自己不需要"我对我的备注")。
⚠️ 它是独立的出口(自己的路由 + 自己的表),不与上面那份混在一起:
「他愿意公开说的」与「我对他的私下记录」是两件事、两种可见性。
🔴🔴 v53(用户 2026-10-16 第 5 条):「我在添加一个成员的时候,是不是可以
直接在添加成员的页面里填写**我对他的称呼**以及**我对他的备注**,
**一次就解决**?要不然的话,我还得先添加,然后再返回这个人的名册,
再去填写我对他的备注和称呼。这样其实有点麻烦。」
⇒ 「新增」时也要出现(原来只在"编辑别人"时才有)——
与下面的「我对他的称呼」一起,新增页一次填完。 */ ?>
<?php if (!$isSelf): ?>
<div class="field full">
<label for="myNote">我对 <?= $isEdit ? e((string)$person['name']) : '他' ?> 的备注(只有我自己看得到)</label>
<textarea class="input" id="myNote" name="my_note" rows="2"
placeholder="怎么认识的、要注意什么、上次见面聊了什么……"><?= e((string)($myNote ?? '')) ?></textarea>
<span class="tip">
<b>只有你自己看得到</b>,别人(包括他本人)都看不到 ——
这里写的是"我和他之间的事",不是他的公开资料。
</span>
</div>
<?php endif; ?>
<?php /* 🔴 v53(用户 2026-10-16 第 5 条):**我对他的称呼**。
称呼是**视角属性**(妈妈叫"明明"、姐姐叫"小弟"),存在 nicknames 表里、
按 (看的人, 被看的人) 一对一条 —— 所以它天然是"我的"称呼,不会改到别人。
⚠️ 与上面「我对他的备注」并排放在一起:用户把这两件事当成"添加时一次填完"
的一组(他原话把「称呼」和「备注」并列)。
⚠️ 新增时也给(此时 $person 还不存在,标题用"他")。 */ ?>
<?php if (!$isSelf): ?>
<div class="field full">
<label for="pfNick">我对 <?= $isEdit ? e((string)$person['name']) : '他' ?> 的称呼</label>
<input class="input" id="pfNick" name="my_nick" maxlength="40"
value="<?= e(old('my_nick', (string)($myNick ?? ''))) ?>"
placeholder="如:大哥、明明、王老师(只有我自己看到)" autocomplete="off">
<span class="tip">
你在他名册里看到的名字会变成这个称呼 —— 妈妈叫「明明」、姐姐叫「小弟」互不影响。<br>
留空就用他自己的名字。
</span>
</div>
<?php endif; ?>
<?php /* 🔴🔴 v51(用户 2026-10-15 第 4 条):「名册这个功能里面,当我编辑资料的时候,
在这个页面竟然**没有办法选择它的标签**。按道理讲,名册编辑成员这个地方
应该能编辑这一个人的**所有信息**才对。」
⇒ 这一页补上「标签」—— 与名册列表上那颗标签按钮**同一份数据**(person_tags,
owner = 我),在这里改完名册列表上那颗按钮的文字也会跟着变(同一份记录)。
⚠️ 只在**编辑别人**时出现(`$isEdit && !$isSelf`):
标签是"我给别人打的",给自己打没有意义 —— 名册列表那颗标签按钮
本来也只对"我名册里的别人"出现。
⚠️ 与服务端 people/update 的分工:提交上来的 `tags` 由
`PersonTag::setFor(家庭, 我, 这个人, ...)` 整组替换 ——
**owner 永远是"我"**,所以改标签绝不会影响全家的标签。
那一句在 people/update 里(见 index.php 对应分支的注释),
这里只是把输入送到。 */ ?>
<?php if ($isEdit && !$isSelf): ?>
<div class="field full" id="ptBlock">
<label for="pfTags">标签</label>
<?php if (!empty($tagChoices)): ?>
<div class="pt-picks pf-picks">
<?php foreach ($tagChoices as $tg): ?>
<label class="pt-pick">
<input type="checkbox" value="<?= e((string)$tg) ?>"
<?= in_array((string)$tg, array_map('strval', (array)($myTags ?? [])), true) ? 'checked' : '' ?>>
<span>#<?= e((string)$tg) ?></span>
</label>
<?php endforeach; ?>
</div>
<?php endif; ?>
<?php /* ⚠️ 文本框是**唯一提交源**(`name="tags"`),勾选框只是快捷方式 ——
与名册列表那个浮层同一套约定(勾/取消会同步进文本框)。
这样服务端只读一个字段,不用担心"勾了又删掉"的边界。 */ ?>
<input class="input" id="pfTags" name="tags" maxlength="300"
value="<?= e(implode(' ', (array)($myTags ?? []))) ?>"
placeholder="如:小学同学 初中同学 球友(用空格分开)" autocomplete="off">
<span class="tip">
一个人可以有多个标签 —— 他既是小学同学、又是初中同学,两个都打上就行。<br>
<b>标签是你自己名册里的</b>:你给他打「球友」不会让全家的名册都多出这个词。
</span>
</div>
<?php endif; ?>
<!-- ==================== 补充联系方式(可多条,对齐 vCard) ==================== -->
<?php foreach (['phone', 'email', 'address', 'url'] as $ctKind): ?>
<div class="field full ct-block" data-ct-kind="<?= $ctKind ?>">
<label><?= $ctTitles[$ctKind] ?></label>
<p class="small muted" style="margin:0 0 8px"><?= $ctHints[$ctKind] ?></p>
<?php foreach (array_merge($contacts[$ctKind], [$ctEmpty]) as $ctRow): ?>
<div class="ct-row" data-ct-row>
<input class="input ct-label" name="ct_<?= $ctKind ?>_label[]" maxlength="20"
value="<?= e((string)($ctRow['label'] ?? '')) ?>" placeholder="标注(如:工作)">
<input class="input" name="ct_<?= $ctKind ?>_value[]"
value="<?= e((string)($ctRow['value'] ?? '')) ?>"
placeholder="<?= $ctKind === 'phone' ? '号码' : ($ctKind === 'url' ? 'https://…' : '内容') ?>">
</div>
<?php endforeach; ?>
<button type="button" class="btn btn-ghost btn-sm ct-add">再加一个</button>
<?php if (!empty($errors['contacts'])): ?><span class="err"><?= e($errors['contacts']) ?></span><?php endif; ?>
</div>
<?php endforeach; ?>
<!-- ==================== 三个生日(放在最后:多数情况不用动) ==================== -->
<div class="field full">
<label>生日</label>
<p class="small muted" style="margin:0 0 12px">
一个人的生日分两种记法:<b>真实阳历生日</b>与<b>农历生日</b>。
阳历与农历只要填一个,另一个自动算出来。两个不在同一天时,首页会分别提醒。
</p>
<div class="bd-source">
<label for="bdSource">我这次填的是</label>
<select class="select" id="bdSource" name="birthday_source" style="width:auto">
<option value="solar" <?= $bdSource === 'solar' ? 'selected' : '' ?>>阳历(公历)</option>
<option value="lunar" <?= $bdSource === 'lunar' ? 'selected' : '' ?>>农历(阴历)</option>
</select>
<span class="small muted">选中的那一边为准,另一边自动算</span>
</div>
<div class="bd-pane" id="bdSolarWrap">
<p class="bd-pane-k">阳历生日</p>
<?php
$dtName = 'birthday_solar';
$dtValue = $solVal;
$dtId = 'birthday_solar_date';
$dtRequired = false;
require __DIR__ . '/../_datetime.php';
?>
<span class="tip">精确到时分秒。不填时分秒就按 00:00:00 记。</span>
<?php if (!empty($errors['birthday_solar'])): ?><span class="err"><?= e($errors['birthday_solar']) ?></span><?php endif; ?>
</div>
<div class="bd-pane" id="bdLunarWrap">
<p class="bd-pane-k">农历生日</p>
<?php
$dtName = 'birthday_lunar';
$dtValue = $lunVal;
$dtId = 'birthday_lunar_date';
$dtRequired = false;
require __DIR__ . '/../_datetime.php';
?>
<label class="check-item" style="margin-top:8px">
<input type="checkbox" name="birthday_lunar_leap" value="1"
<?= old('birthday_lunar_leap', $person['birthday_lunar_leap'] ?? 0) ? 'checked' : '' ?>>
<span>这个月是<b>闰月</b>(如「闰六月」)</span>
</label>
<?php if (!empty($errors['birthday_lunar'])): ?><span class="err"><?= e($errors['birthday_lunar']) ?></span><?php endif; ?>
</div>
</div>
<?php if ($canEditAll): ?>
<div class="field full">
<label class="check-item">
<input type="checkbox" name="is_placeholder" value="1"
<?= old('is_placeholder', $person['is_placeholder'] ?? 0) ? 'checked' : '' ?>>
<span>
<b>这是「虚拟人物」</b><br>
<span class="muted small">
还没弄清真实身份时先占个位,比如起名「我的父亲」「外婆」。
他能参与亲属关系,等弄清真名再改过来即可;家谱上会标「待确认」。
</span>
</span>
</label>
</div>
<?php endif; ?>
</div>
<div class="btn-row">
<button class="btn" type="submit"><?= $isEdit ? '保存' : '加入名册' ?></button>
<?php
// 取消:改自己的话回「个人设置」更顺手(那是他来的地方),
// 改别人 / 新增则回他的详情页 / 名册。
$cancelUrl = $isEdit
? ($isSelf ? url('settings/me') : url('people/show', ['id' => (int)$person['id']]))
: url('people');
?>
<a class="btn btn-ghost" href="<?= e($cancelUrl) ?>">取消</a>
<?php if ($isSelf): ?>
<a class="btn btn-ghost" href="<?= e(url('people/show', ['id' => (int)$person['id']])) ?>">看我的详情页</a>
<?php endif; ?>
</div>
</div>
</form>
<script>
(function () {
/* ---- 头像:点图即选文件(用户 2026-10-03 第 6 条)----
⚠️ 2026-10-05 起这段**已搬到 app.js 的通用绑定**(模板上写
`data-pick-input="#avatar"` 即可)。搬走的原因:只写在"头像"这一页,
别的页面照抄同一套 DOM 却没有 JS —— 题图/封面点了没反应。
这里不再保留副本(同一件事两处实现,改一处漏一处正是那次事故的成因)。 */
/* ---- 工作经历:+/× 增删一段(用户第 4 条)----
⚠️ 模板里的行是**服务端渲染**的(首屏没有 JS 也能填、也能提交),
这里只加"再加一段 / 删掉这段"两个交互 —— 渐进增强,不是二选一。 */
var list = document.getElementById('jobList');
var addBtn = document.getElementById('jobAdd');
function bindDel(row) {
var del = row.querySelector('.job-del');
if (!del) { return; }
del.addEventListener('click', function () {
var all = list.querySelectorAll('.job-row');
if (all.length <= 1) {
// 只剩一行时"删"= 清空这一行(而不是消失),否则页面会没有输入框可填
row.querySelectorAll('input').forEach(function (i) { i.value = ''; });
return;
}
row.remove();
});
}
if (list) {
Array.prototype.forEach.call(list.querySelectorAll('.job-row'), bindDel);
if (addBtn) {
addBtn.addEventListener('click', function () {
var first = list.querySelector('.job-row');
if (!first) { return; }
var row = first.cloneNode(true);
row.querySelectorAll('input').forEach(function (i) { i.value = ''; });
list.appendChild(row);
bindDel(row);
var f = row.querySelector('input');
if (f) { f.focus(); }
});
}
}
/* 🔴 v51(用户第 4 条):标签的「勾选框 ↔ 文本框」双向同步。
⚠️ 文本框(name="tags")是**唯一提交源**,与服务端只读一个字段的约定一致;
勾选框只是快捷方式。判据与名册列表那个浮层**逐字一致**
(split(/[\s,,]+/) + 去掉前导 #)—— 两处口径不同的话,
"在列表页打的标签"与"在编辑页打的标签"会归一成不同的结果。
⚠️ 手打的新词没有勾选框 ⇒ 同步时要把它们**保留**(否则勾一下就把新词冲掉了)。 */
(function () {
var block = document.getElementById('ptBlock');
if (!block) { return; }
var inp = document.getElementById('pfTags');
var picks = block.querySelectorAll('.pt-pick input');
if (!inp || !picks.length) { return; }
function syncFromPicks() {
var on = [];
Array.prototype.forEach.call(picks, function (c) { if (c.checked) { on.push(c.value); } });
var known = {};
Array.prototype.forEach.call(picks, function (c) { known[c.value] = true; });
var keep = [];
String(inp.value || '').split(/[\s,,]+/).forEach(function (w) {
w = w.replace(/^#/, '');
if (w !== '' && !known[w]) { keep.push(w); }
});
inp.value = on.concat(keep).join(' ');
}
block.addEventListener('change', function (e) {
if (e.target && e.target.closest && e.target.closest('.pt-pick')) { syncFromPicks(); }
});
})();
})();
</script>