laoyang
e0562b8627
用户 2026-10-03 的十条，逐条落点： 1. 天气改为**个人设置里填城市**（每人一份）：新增 app/Geo.php，内置 197 个 地级市坐标（离线、逐条核对，生成脚本 _tooling/_fb_geo_gen.py）。填坐标仍 作为内置表没有时的出口；老的家庭级坐标保留为兜底，升级当天天气不会凭空消失。 2. 所有"找个人"的地方**输入即筛选**：新增 assets/js/filter.js（纯前端显隐， 不发请求、回车不刷新）+ app/PersonQuery.php 把服务端判据收敛成一份 （名册 / 挑人 / 高级搜索共用，避免三处实现漂移）。 3. 名册列表：有昵称就不重复显示本名、行变矮、补齐手机/阴历阳历生日(带年份)/ 邮箱/工作单位；「清除」与「搜索」同款同尺寸。 4/5. 日程：撤掉左侧日历本栏改满宽，功能（显隐/颜色/导入/默认视图）全收进 右侧 ☰；**色块高度改为按起止时长**（旧实现一律 30 分钟，三小时的会跟 十五分钟的同高）；点日历空白处即建日程，开始时间＝点的那一格。 6/10. 资源：搜索提到最上；按"最近改动/最新新增"排序，默认只显示最新 10 条并 给「显示全部」出口。 7. 任务：看板的**列＝用户自定义的看板**（不再是写死的待办/进行中）， 拖动/左右键＝换看板（改 board_id，不动 status）。 8. 财务：概览在上账目在下、记一笔改右侧按钮、账本设置（共享/改名/新建/删除） 收进 ☰、默认账本名「xxx的账本」、"挂在谁名下"默认自己且用标准选人框； **新增盘点**（新增 ledger_entry_snapshots 只增不改的历史表，旧值不被清空） + 上面画金额变化折线图（app/chart.php 服务端画 SVG，零依赖）。 9. 纪念日：手动添加的与名册生日派生的**分两块**、手动的在上；右侧设置可增删 分类（家庭级，删分类不强改已用的历史）。 本轮另外修掉/加固的四类问题（都由新增的静态或运行时守卫兜住）： - index.php 少写 2 个 use 导入（Pinyin / UserSetting）→ 名册与个人设置 返回 200 但正文是 Fatal；顺带修了一处早已存在的 Attachment 未导入。 → 新增 _fb_import_check.py（1f 段）。 - 一次不精确替换弄丢了 app/Calendar.php 开头的 `<?php`，整份源码被当 HTML 吐给浏览器，而 `php -l` 报"无语法错误"（纯文本输出确实合法）。 → 新增 _fb_php_open_check.py（1e 段）。 - 模板片段 unset 了宿主模板的变量（账本片段 unset($canWrite)）→ 正文里一片 Undefined variable 而 HTTP 仍 200。同 _datetime.php 早年 $t 的坑。 → 新增 _fb_fragment_scope_check.py（1g 段）+ _fb_batch_e.py 的 26 页无告警巡检。 - 窄屏下页头动作区不换行 → 周视图横向溢出且按钮被挤成三种高度（用户提过三次 "按钮要同高"）→ .page-head .actions 加 flex-wrap。 验证战绩（全绿）： e2e 773/0 · 第 5 轮专项 91/0 · 结构升级 126/0 · 几何 428/0 · 移动端 684/0 · 交互 97/0 · 家谱 26/0 · 按钮 60/0；三轮反向验证各 3/3 抓到，还原后复绿。 线上：schema v14、指纹一致（9df6c9fccc6796db）、snapshots 表已建、197 城、 8 个关键文件 md5 与本地逐字节一致、app/ 403 无源码泄漏、错误日志无新增。
375 lines
15 KiB
PHP
375 lines
15 KiB
PHP
<?php
|
||
/**
|
||
* 纪念日（v24 用户第 13 条）
|
||
*
|
||
* 用户原话：「增加纪念日模块，可以根据阴历和阳历来设置纪念日，在纪念日模块中，
|
||
* 可以默认看到已经保存的名册中的人的各种生日，生日本身就是纪念日的一种。
|
||
* 所有的纪念日，都显示在日历的日程中，作为一个全天日程出现。
|
||
* 纪念日，需要按照阴历和阳历进行重复。」
|
||
*
|
||
* 三条设计决定：
|
||
*
|
||
* ① **生日不落这张表**，而是像观影/旅程那样**实时派生**。
|
||
* 理由：生日已经存在 persons（birthday / birthday_lunar），再复制一份到
|
||
* anniversaries 就会出现"改了生日，纪念日那边还是旧的"。派生出来，
|
||
* 改生日当天纪念日跟着变 —— 与"日历里观影/旅程是实时派生"同一套口径。
|
||
*
|
||
* ② 用户自建的纪念日才落库（anniversaries 表）。`repeat_type` 决定怎么"年年重现"：
|
||
* solar = 每年公历的同月同日；lunar = 每年农历的同月同日（所以库里存的是
|
||
* **农历的月/日**，不是公历换算结果 —— 换算结果只对某一年有效）。
|
||
*
|
||
* ③ 进日历、而且是**全天**日程（用户明确要求）。所以渲染时 all_day=1、
|
||
* 时间部分留空。
|
||
*/
|
||
|
||
declare(strict_types=1);
|
||
|
||
namespace App;
|
||
|
||
final class Anniversary
|
||
{
|
||
/** 重复方式 */
|
||
public const REPEAT = [
|
||
'solar' => '每年（阳历）',
|
||
'lunar' => '每年（农历）',
|
||
'once' => '只此一次',
|
||
];
|
||
|
||
/** 庆典类纪念日大致的分类，给个默认值方便挑选（用户可自由填） */
|
||
public const PRESET_KINDS = ['生日', '结婚纪念日', '相识纪念日', '忌日', '节日', '其它'];
|
||
|
||
public const ATTACH = 'anniversary';
|
||
|
||
// ---------------- ① 用户自建的纪念日 ----------------
|
||
|
||
public static function list(int $familyId): array
|
||
{
|
||
$st = Database::get()->prepare(
|
||
'SELECT * FROM anniversaries WHERE family_id = ? ORDER BY month, day, id'
|
||
);
|
||
$st->execute([$familyId]);
|
||
return $st->fetchAll();
|
||
}
|
||
|
||
public static function find(int $familyId, int $id): ?array
|
||
{
|
||
$st = Database::get()->prepare('SELECT * FROM anniversaries WHERE id = ? AND family_id = ?');
|
||
$st->execute([$id, $familyId]);
|
||
$r = $st->fetch();
|
||
return $r ?: null;
|
||
}
|
||
|
||
/**
|
||
* 新建 / 修改一条纪念日。
|
||
*
|
||
* @param array $d title / repeat_type / month / day / kind / note / person_id / leap
|
||
* @return int 记录 id
|
||
*/
|
||
public static function save(int $familyId, array $d, int $id = 0): int
|
||
{
|
||
$db = Database::get();
|
||
$title = trim((string)($d['title'] ?? ''));
|
||
if ($title === '') {
|
||
$title = '纪念日';
|
||
}
|
||
$repeat = (string)($d['repeat_type'] ?? 'solar');
|
||
if (!isset(self::REPEAT[$repeat])) {
|
||
$repeat = 'solar';
|
||
}
|
||
$month = max(1, min(12, (int)($d['month'] ?? 1)));
|
||
$day = max(1, min(31, (int)($d['day'] ?? 1)));
|
||
$kind = mb_substr(trim((string)($d['kind'] ?? '')), 0, 40, 'UTF-8');
|
||
$note = trim((string)($d['note'] ?? ''));
|
||
$pid = (int)($d['person_id'] ?? 0) ?: null;
|
||
$leap = !empty($d['leap']) ? 1 : 0;
|
||
|
||
if ($id > 0) {
|
||
$db->prepare(
|
||
'UPDATE anniversaries SET title=?, repeat_type=?, month=?, day=?, is_leap=?,
|
||
kind=?, note=?, person_id=? WHERE id=? AND family_id=?'
|
||
)->execute([$title, $repeat, $month, $day, $leap, $kind !== '' ? $kind : null,
|
||
$note !== '' ? $note : null, $pid, $id, $familyId]);
|
||
return $id;
|
||
}
|
||
$db->prepare(
|
||
'INSERT INTO anniversaries (family_id, title, repeat_type, month, day, is_leap,
|
||
kind, note, person_id)
|
||
VALUES (?,?,?,?,?,?,?,?,?)'
|
||
)->execute([$familyId, $title, $repeat, $month, $day, $leap,
|
||
$kind !== '' ? $kind : null, $note !== '' ? $note : null, $pid]);
|
||
return (int)$db->lastInsertId();
|
||
}
|
||
|
||
public static function remove(int $familyId, int $id): void
|
||
{
|
||
Attachment::removeAll(self::ATTACH, $id);
|
||
Database::get()->prepare('DELETE FROM anniversaries WHERE id = ? AND family_id = ?')
|
||
->execute([$id, $familyId]);
|
||
}
|
||
|
||
// ---------------- ② 派生：名册里每个人的生日 ----------------
|
||
|
||
/**
|
||
* 把名册里所有人的生日，当成"纪念日"派生出来。
|
||
*
|
||
* 用户原话：「生日本身就是纪念日的一种」——所以这里不去 persons 里写任何东西，
|
||
* 只读出生日、包成与自建纪念日**同一个形状**的行，上层（列表页 / 日历）一视同仁。
|
||
*
|
||
* @return array<int,array> 每项含 title/kind/month/day/repeat_type/person_id/source/…
|
||
*/
|
||
public static function birthdays(int $familyId, int $viewerId): array
|
||
{
|
||
$people = Person::map($familyId);
|
||
$out = [];
|
||
foreach ($people as $pid => $p) {
|
||
$pid = (int)$pid;
|
||
// 阳历生日（列名叫 birthday，读取一律走 Birthday::solarOf）
|
||
$solar = Birthday::dateOnly(Birthday::solarOf($p));
|
||
if ($solar !== '') {
|
||
$out[] = [
|
||
'id' => 0,
|
||
'title' => (string)($p['name'] ?? '') . ' 的生日',
|
||
'kind' => '生日',
|
||
'repeat_type' => 'solar',
|
||
'month' => (int)substr($solar, 5, 2),
|
||
'day' => (int)substr($solar, 8, 2),
|
||
'is_leap' => 0,
|
||
'person_id' => $pid,
|
||
'person_name' => (string)($p['name'] ?? ''),
|
||
'source' => 'birthday_solar',
|
||
'born' => $solar,
|
||
];
|
||
}
|
||
// 农历生日（**日期部分是农历**，所以月/日是农历的月日）
|
||
$lunar = Birthday::dateOnly((string)($p['birthday_lunar'] ?? ''));
|
||
if ($lunar !== '') {
|
||
$out[] = [
|
||
'id' => 0,
|
||
'title' => (string)($p['name'] ?? '') . ' 的农历生日',
|
||
'kind' => '生日',
|
||
'repeat_type' => 'lunar',
|
||
'month' => (int)substr($lunar, 5, 2),
|
||
'day' => (int)substr($lunar, 8, 2),
|
||
'is_leap' => (int)($p['birthday_lunar_leap'] ?? 0),
|
||
'person_id' => $pid,
|
||
'person_name' => (string)($p['name'] ?? ''),
|
||
'source' => 'birthday_lunar',
|
||
'born' => $lunar,
|
||
];
|
||
}
|
||
}
|
||
unset($viewerId);
|
||
return $out;
|
||
}
|
||
|
||
/** 自建纪念日 + 派生生日，合成一份"全部纪念日" */
|
||
public static function all(int $familyId, int $viewerId): array
|
||
{
|
||
$out = self::birthdays($familyId, $viewerId);
|
||
foreach (self::list($familyId) as $r) {
|
||
$r['source'] = 'custom';
|
||
$r['person_name'] = '';
|
||
$out[] = $r;
|
||
}
|
||
return $out;
|
||
}
|
||
|
||
/**
|
||
* 两块分开（v24 用户 2026-10-03 第 9 条）。
|
||
*
|
||
* 用户原话：「纪念日中，手动添加的纪念日和来自其他模块的，例如生日的纪念日，
|
||
* 要分开，手动纪念日在上面。」
|
||
*
|
||
* 所以返回 ['custom' => [...], 'derived' => [...]] 两块，各按日期排。
|
||
* ⚠️ 派生块用**这个人的出生年**来算"今年是几号"没法排序（农历要逐年换算），
|
||
* 这里统一按 month/day 排（也就是"一年里按日历顺序"），
|
||
* 与列表上显示的「X 月 X 日」完全一致 —— 不会出现"排出来的顺序和看到的不一样"。
|
||
*
|
||
* @return array{custom:array,derived:array}
|
||
*/
|
||
public static function split(int $familyId, int $viewerId): array
|
||
{
|
||
$custom = [];
|
||
foreach (self::list($familyId) as $r) {
|
||
$r['source'] = 'custom';
|
||
$r['person_name'] = '';
|
||
$custom[] = $r;
|
||
}
|
||
$derived = self::birthdays($familyId, $viewerId);
|
||
|
||
$byMD = static function (array $a, array $b): int {
|
||
return ((int)($a['month'] ?? 0) <=> (int)($b['month'] ?? 0))
|
||
?: ((int)($a['day'] ?? 0) <=> (int)($b['day'] ?? 0))
|
||
?: strcmp((string)($a['title'] ?? ''), (string)($b['title'] ?? ''));
|
||
};
|
||
usort($custom, $byMD);
|
||
usort($derived, $byMD);
|
||
return ['custom' => $custom, 'derived' => $derived];
|
||
}
|
||
|
||
// ---------------- 纪念日分类（v24 用户 2026-10-03 第 9 条）----------------
|
||
|
||
/**
|
||
* 用户自定义的分类清单（family 级，存 settings）。
|
||
*
|
||
* 用户原话：「在新建纪念日和右侧，也增加设置按钮，可以设置纪念日的分类。」
|
||
*
|
||
* ⚠️ 与分类**落到每条纪念日上的 kind 字段**是两件事：
|
||
* · 这里的清单 = 新建时下拉里给哪些选项（可增删）；
|
||
* · kind = 这一条实际选了哪个。
|
||
* 删掉一个分类**不**会把已用的纪念日改掉（那些 kind 仍然是那个字），
|
||
* 只是新建时不再出现在下拉里 —— 强改历史数据比留着一个"没人认识的分类"更糟。
|
||
*
|
||
* @return string[] 有序、去重、非空
|
||
*/
|
||
public static function kinds(int $familyId): array
|
||
{
|
||
$raw = (string)Setting::get($familyId, 'anniv_kinds', '');
|
||
$dec = $raw !== '' ? json_decode($raw, true) : null;
|
||
if (!is_array($dec)) {
|
||
return self::PRESET_KINDS; // 没配过 → 用预置那套
|
||
}
|
||
$out = [];
|
||
foreach ($dec as $k) {
|
||
$k = trim((string)$k);
|
||
if ($k !== '' && mb_strlen($k, 'UTF-8') <= 20 && !in_array($k, $out, true)) {
|
||
$out[] = $k;
|
||
}
|
||
}
|
||
// ⚠️ 空数组是**合法**的（用户可能就是不想有分类），所以不在这里兜回预置；
|
||
// 只有"从来没配过"（$raw === ''）才给预置。
|
||
return $out;
|
||
}
|
||
|
||
public static function saveKinds(int $familyId, array $kinds): void
|
||
{
|
||
$out = [];
|
||
foreach ($kinds as $k) {
|
||
$k = trim((string)$k);
|
||
if ($k === '' || mb_strlen($k, 'UTF-8') > 20) {
|
||
continue;
|
||
}
|
||
if (!in_array($k, $out, true)) {
|
||
$out[] = $k;
|
||
}
|
||
if (count($out) >= 30) { // 上限：一个下拉放不下更多了
|
||
break;
|
||
}
|
||
}
|
||
Setting::set($familyId, 'anniv_kinds', json_encode($out, JSON_UNESCAPED_UNICODE));
|
||
}
|
||
|
||
/** 每个分类被用了几条（设置页要显示"这个分类有没有在用"） */
|
||
public static function kindCounts(int $familyId): array
|
||
{
|
||
$st = Database::get()->prepare(
|
||
'SELECT kind, COUNT(*) AS n FROM anniversaries
|
||
WHERE family_id = ? AND kind IS NOT NULL AND kind <> "" GROUP BY kind'
|
||
);
|
||
$st->execute([$familyId]);
|
||
$out = [];
|
||
foreach ($st->fetchAll() as $r) {
|
||
$out[(string)$r['kind']] = (int)$r['n'];
|
||
}
|
||
return $out;
|
||
}
|
||
|
||
// ---------------- ③ 这一年会落在哪几天（给日历用） ----------------
|
||
|
||
/**
|
||
* 某一年里，这些纪念日各落在哪个公历日期。
|
||
*
|
||
* ⚠️ 农历那一路必须**逐年换算**：农历新年在公历 1~2 月，
|
||
* 所以同一条"农历冬月初一"在不同年份对应的公历日期完全不同，
|
||
* 不存在"存一个公历日期年年用"的可能。
|
||
*
|
||
* @return array<int,array{date:string,title:string,days:int,kind:string,person_id:int,source:string,age:?int}>
|
||
*/
|
||
public static function occurrences(int $familyId, int $viewerId, int $year): array
|
||
{
|
||
$out = [];
|
||
foreach (self::all($familyId, $viewerId) as $a) {
|
||
$repeat = (string)($a['repeat_type'] ?? 'solar');
|
||
$m = (int)($a['month'] ?? 0);
|
||
$d = (int)($a['day'] ?? 0);
|
||
if ($m < 1 || $m > 12 || $d < 1 || $d > 31) {
|
||
continue;
|
||
}
|
||
$date = null;
|
||
if ($repeat === 'lunar') {
|
||
$leap = !empty($a['is_leap']) && Lunar::leapMonth($year) === $m;
|
||
$sol = Lunar::lunarToSolar($year, $m, $d, $leap);
|
||
if ($sol === null) {
|
||
// 这一年这个月没有这一天（如腊月三十遇上 29 天的腊月）→ 退到当月最后一天
|
||
$max = $leap ? Lunar::leapDays($year) : Lunar::monthDays($year, $m);
|
||
$sol = Lunar::lunarToSolar($year, $m, max(1, min($d, $max)), $leap);
|
||
}
|
||
if ($sol === null) {
|
||
continue;
|
||
}
|
||
$date = sprintf('%04d-%02d-%02d', $sol['year'], $sol['month'], $sol['day']);
|
||
} else {
|
||
// 公历（含"只此一次"）：2/29 落在平年时退到 2/28
|
||
$dd = $d;
|
||
if (!checkdate($m, $dd, $year)) {
|
||
$dd = min($dd, (int)date('t', mktime(0, 0, 0, $m, 1, $year)));
|
||
}
|
||
$date = sprintf('%04d-%02d-%02d', $year, $m, $dd);
|
||
}
|
||
$age = null;
|
||
if (($a['source'] ?? '') !== 'custom' && !empty($a['born'])) {
|
||
$age = Birthday::ageOn((string)$a['born'], $date);
|
||
}
|
||
$out[] = [
|
||
'date' => $date,
|
||
'title' => (string)($a['title'] ?? ''),
|
||
'kind' => (string)($a['kind'] ?? ''),
|
||
'person_id' => (int)($a['person_id'] ?? 0),
|
||
'source' => (string)($a['source'] ?? 'custom'),
|
||
'note' => (string)($a['note'] ?? ''),
|
||
'id' => (int)($a['id'] ?? 0),
|
||
'age' => $age,
|
||
'repeat' => $repeat,
|
||
];
|
||
}
|
||
return $out;
|
||
}
|
||
|
||
/**
|
||
* 一段时间内的纪念日（日历画格子用）。
|
||
* @return array<int,array> 按日期升序
|
||
*/
|
||
public static function between(int $familyId, int $viewerId, string $from, string $to): array
|
||
{
|
||
$y1 = (int)substr($from, 0, 4);
|
||
$y2 = (int)substr($to, 0, 4);
|
||
$out = [];
|
||
for ($y = $y1; $y <= $y2; $y++) {
|
||
foreach (self::occurrences($familyId, $viewerId, $y) as $o) {
|
||
if ($o['date'] >= $from && $o['date'] <= $to) {
|
||
$out[] = $o;
|
||
}
|
||
}
|
||
}
|
||
usort($out, static fn($a, $b) => strcmp($a['date'], $b['date']));
|
||
return $out;
|
||
}
|
||
|
||
/** 接下来 n 天内的纪念日（列表页头部"临近"用） */
|
||
public static function upcoming(int $familyId, int $viewerId, int $withinDays = 60): array
|
||
{
|
||
$today = date('Y-m-d');
|
||
$to = date('Y-m-d', strtotime('+' . max(1, $withinDays) . ' days'));
|
||
$rows = self::between($familyId, $viewerId, $today, $to);
|
||
foreach ($rows as &$r) {
|
||
$r['days'] = (int)((strtotime($r['date']) - strtotime($today)) / 86400);
|
||
}
|
||
unset($r);
|
||
return $rows;
|
||
}
|
||
|
||
public static function repeatWord(string $k): string
|
||
{
|
||
return self::REPEAT[$k] ?? $k;
|
||
}
|
||
} |