393 lines
16 KiB
PHP
393 lines
16 KiB
PHP
|
<?php
|
|||
|
|
/**
|
|||
|
|
* 首页 dashboard 的数据装配（用户 2026-10-03 第 3 条）。
|
|||
|
|
*
|
|||
|
|
* 这一版首页要回答的是「今天是个什么日子、家里最近怎么样」：
|
|||
|
|
* · 一句随机问候（按当前时段 + 今日待办/日程给一句人话）
|
|||
|
|
* · 今天的天气
|
|||
|
|
* · 近七天的日程数 / 待办数 / 逾期数
|
|||
|
|
* · 各模块的一张小结（用户可开关与排序）
|
|||
|
|
*
|
|||
|
|
* ⚠️ 天气是**外部依赖**，所以：
|
|||
|
|
* ① 只在配置里给了 key 时才去请求（没配就整块不显示，不报错、不占位）；
|
|||
|
|
* ② 结果**缓存 30 分钟**（天气不需要每分钟刷；也避免把外部接口打爆）；
|
|||
|
|
* ③ 请求失败一律静默回落成"没有天气"——首页不能因为第三方挂了就打不开。
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
declare(strict_types=1);
|
|||
|
|
|
|||
|
|
namespace App;
|
|||
|
|
|
|||
|
|
final class Home
|
|||
|
|
{
|
|||
|
|
/** 天气缓存有效期（秒） */
|
|||
|
|
private const WEATHER_TTL = 1800;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 随机问候语。
|
|||
|
|
*
|
|||
|
|
* 用户原话：「随机给出一段问候语，例如，上午好，xxx，最近心情怎么样之类的」。
|
|||
|
|
* 所以是**按时段 + 带名字 + 有点变化**，而不是固定的"你好"。
|
|||
|
|
* ⚠️ 用 md5(日期+人名) 做种子而不是 random_int：
|
|||
|
|
* 同一天刷新多次看到的应该是**同一句**，否则每次刷新都变、像抽奖。
|
|||
|
|
*
|
|||
|
|
* @param string $name 我怎么称呼自己（家书里"我"就是他）
|
|||
|
|
*/
|
|||
|
|
public static function greeting(string $name, string $today, int $events = 0, int $overdue = 0): string
|
|||
|
|
{
|
|||
|
|
$h = (int)date('G');
|
|||
|
|
if ($h < 5) {
|
|||
|
|
$part = '夜深了';
|
|||
|
|
} elseif ($h < 11) {
|
|||
|
|
$part = '早上好';
|
|||
|
|
} elseif ($h < 13) {
|
|||
|
|
$part = '中午好';
|
|||
|
|
} elseif ($h < 18) {
|
|||
|
|
$part = '下午好';
|
|||
|
|
} else {
|
|||
|
|
$part = '晚上好';
|
|||
|
|
}
|
|||
|
|
$who = trim($name) !== '' ? '，' . trim($name) : '';
|
|||
|
|
|
|||
|
|
// 有逾期先说逾期（那是最该被看见的），其次今天的安排，最后才是寒暄
|
|||
|
|
if ($overdue > 0) {
|
|||
|
|
$tail = '有 ' . $overdue . ' 件事已经过期了，要不要先处理一下？';
|
|||
|
|
} elseif ($events > 0) {
|
|||
|
|
$tail = '今天有 ' . $events . ' 件事，慢慢来。';
|
|||
|
|
} else {
|
|||
|
|
$tails = [
|
|||
|
|
'最近心情怎么样？',
|
|||
|
|
'今天想做点什么？',
|
|||
|
|
'日子慢慢过，不着急。',
|
|||
|
|
'记得给家里打个电话。',
|
|||
|
|
'今天也是好日子。',
|
|||
|
|
'有空翻翻往年的今天。',
|
|||
|
|
];
|
|||
|
|
$seed = crc32($today . '|' . $name);
|
|||
|
|
$tail = $tails[$seed % count($tails)];
|
|||
|
|
}
|
|||
|
|
return $part . $who . '，' . $tail;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/** 今天星期几（中文） */
|
|||
|
|
public static function weekday(string $date): string
|
|||
|
|
{
|
|||
|
|
$w = ['日', '一', '二', '三', '四', '五', '六'][(int)date('w', strtotime($date))];
|
|||
|
|
return '星期' . $w;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 今天的天气。没配 key / 请求失败 / 超时 → null（首页整块不显示）。
|
|||
|
|
*
|
|||
|
|
* 用 Open-Meteo：**不需要申请 key**、允许非商业使用、有中文描述。
|
|||
|
|
* 之所以不选和风/心知：都要申请 key，而"配好 key 才能看见天气"这件事
|
|||
|
|
* 会让用户以为功能没做（配置项藏在哪他未必找得到）。
|
|||
|
|
*
|
|||
|
|
* ⚠️ 只按经纬度请求，不传城市名 —— 经纬度由管理员在系统设置里填。
|
|||
|
|
* 没填经纬度就当"没配天气"，不猜（猜错城市比不显示更糟）。
|
|||
|
|
*
|
|||
|
|
* @return array{temp:string,text:string,icon:string,place:string}|null
|
|||
|
|
*/
|
|||
|
|
public static function weather(int $familyId, string $lat, string $lon, string $place): ?array
|
|||
|
|
{
|
|||
|
|
$lat = trim($lat);
|
|||
|
|
$lon = trim($lon);
|
|||
|
|
if ($lat === '' || $lon === '' || !is_numeric($lat) || !is_numeric($lon)) {
|
|||
|
|
return null;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ⚠️ 缓存存在 settings 表里，而那张表对 family_id 有**外键**：
|
|||
|
|
// 传 0 会插入失败（外键不存在），所以必须带家庭 id。
|
|||
|
|
// 同一个家庭共用一份天气缓存 —— 本来也就是同一个地方。
|
|||
|
|
$cacheKey = 'weather_' . md5($lat . ',' . $lon);
|
|||
|
|
$cached = Setting::get($familyId, $cacheKey, '');
|
|||
|
|
if ($cached !== '') {
|
|||
|
|
$dec = json_decode((string)$cached, true);
|
|||
|
|
if (is_array($dec) && (int)($dec['at'] ?? 0) + self::WEATHER_TTL > time()) {
|
|||
|
|
return self::weatherOut((array)($dec['data'] ?? []), $place);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
$url = 'https://api.open-meteo.com/v1/forecast'
|
|||
|
|
. '?latitude=' . urlencode($lat) . '&longitude=' . urlencode($lon)
|
|||
|
|
. '¤t=temperature_2m,weather_code&timezone=Asia%2FShanghai';
|
|||
|
|
$body = self::httpGet($url);
|
|||
|
|
if ($body === null) {
|
|||
|
|
return null;
|
|||
|
|
}
|
|||
|
|
$j = json_decode($body, true);
|
|||
|
|
if (!is_array($j) || !isset($j['current'])) {
|
|||
|
|
return null;
|
|||
|
|
}
|
|||
|
|
$data = [
|
|||
|
|
'temp' => (string)round((float)($j['current']['temperature_2m'] ?? 0)),
|
|||
|
|
'code' => (int)($j['current']['weather_code'] ?? -1),
|
|||
|
|
];
|
|||
|
|
// 缓存下来（存在 settings，key 里带 family 0 = 全站级）
|
|||
|
|
Setting::set($familyId, $cacheKey, json_encode(['at' => time(), 'data' => $data], JSON_UNESCAPED_UNICODE));
|
|||
|
|
return self::weatherOut($data, $place);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/** 内部结构 → 页面用的天气结构 */
|
|||
|
|
private static function weatherOut(array $data, string $place): ?array
|
|||
|
|
{
|
|||
|
|
if (!isset($data['temp'])) {
|
|||
|
|
return null;
|
|||
|
|
}
|
|||
|
|
[$text, $icon] = self::wmo((int)($data['code'] ?? -1));
|
|||
|
|
return [
|
|||
|
|
'temp' => (string)$data['temp'] . '°C',
|
|||
|
|
'text' => $text,
|
|||
|
|
'icon' => $icon,
|
|||
|
|
'place' => trim($place),
|
|||
|
|
];
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* WMO 天气代码 → [中文描述, 一个符号]。
|
|||
|
|
* 符号用**普通字符**（不是 emoji）：emoji 在部分旧系统上会变豆腐块，
|
|||
|
|
* 而这是每天都要看的一块，宁可用朴素符号也不要出现方框。
|
|||
|
|
*/
|
|||
|
|
private static function wmo(int $c): array
|
|||
|
|
{
|
|||
|
|
if ($c === 0) {
|
|||
|
|
return ['晴', '☀'];
|
|||
|
|
}
|
|||
|
|
if (in_array($c, [1, 2], true)) {
|
|||
|
|
return ['多云', '⛅'];
|
|||
|
|
}
|
|||
|
|
if ($c === 3) {
|
|||
|
|
return ['阴', '☁'];
|
|||
|
|
}
|
|||
|
|
if (in_array($c, [45, 48], true)) {
|
|||
|
|
return ['有雾', '≋'];
|
|||
|
|
}
|
|||
|
|
if ($c >= 51 && $c <= 57) {
|
|||
|
|
return ['毛毛雨', '☂'];
|
|||
|
|
}
|
|||
|
|
if ($c >= 61 && $c <= 67) {
|
|||
|
|
return ['下雨', '☂'];
|
|||
|
|
}
|
|||
|
|
if ($c >= 71 && $c <= 77) {
|
|||
|
|
return ['下雪', '❄'];
|
|||
|
|
}
|
|||
|
|
if ($c >= 80 && $c <= 82) {
|
|||
|
|
return ['阵雨', '☂'];
|
|||
|
|
}
|
|||
|
|
if ($c >= 85 && $c <= 86) {
|
|||
|
|
return ['阵雪', '❄'];
|
|||
|
|
}
|
|||
|
|
if ($c >= 95) {
|
|||
|
|
return ['雷雨', '⚡'];
|
|||
|
|
}
|
|||
|
|
return ['天气', '·'];
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/** 极简 GET（3 秒超时；失败返回 null，绝不抛） */
|
|||
|
|
private static function httpGet(string $url): ?string
|
|||
|
|
{
|
|||
|
|
if (!function_exists('curl_init')) {
|
|||
|
|
$ctx = stream_context_create(['http' => ['timeout' => 3, 'ignore_errors' => true]]);
|
|||
|
|
$r = @file_get_contents($url, false, $ctx);
|
|||
|
|
return $r === false ? null : (string)$r;
|
|||
|
|
}
|
|||
|
|
$ch = curl_init($url);
|
|||
|
|
curl_setopt_array($ch, [
|
|||
|
|
CURLOPT_RETURNTRANSFER => true,
|
|||
|
|
CURLOPT_TIMEOUT => 3,
|
|||
|
|
CURLOPT_CONNECTTIMEOUT => 2,
|
|||
|
|
CURLOPT_FOLLOWLOCATION => true,
|
|||
|
|
CURLOPT_SSL_VERIFYPEER => true,
|
|||
|
|
CURLOPT_USERAGENT => 'FamilyBook/1.0',
|
|||
|
|
]);
|
|||
|
|
$r = curl_exec($ch);
|
|||
|
|
$code = (int)curl_getinfo($ch, CURLINFO_HTTP_CODE);
|
|||
|
|
curl_close($ch);
|
|||
|
|
if ($r === false || $code < 200 || $code >= 300) {
|
|||
|
|
return null;
|
|||
|
|
}
|
|||
|
|
return (string)$r;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 各模块的一张小结。返回 key => ['name','icon','color','href','big','lines']。
|
|||
|
|
*
|
|||
|
|
* 「big」是一个最该被看见的数字/短句，「lines」是几行补充。
|
|||
|
|
* 每张卡都**点得进去**（href 指向该模块最能回答这张卡的那一页）。
|
|||
|
|
*/
|
|||
|
|
public static function moduleCards(int $familyId, int $me, array $soon, array $tasks): array
|
|||
|
|
{
|
|||
|
|
$cards = [];
|
|||
|
|
|
|||
|
|
// ---- 名册 ----
|
|||
|
|
$people = Person::map($familyId);
|
|||
|
|
$roster = Person::roster($familyId, $me, 'member', '');
|
|||
|
|
$cards['people'] = [
|
|||
|
|
'name' => '名册',
|
|||
|
|
'icon' => self::icon('people'),
|
|||
|
|
'color' => Module::color('people', $familyId),
|
|||
|
|
'href' => url('people'),
|
|||
|
|
'big' => (string)count($roster) . ' 人',
|
|||
|
|
'lines' => [count($people) . ' 人在这个家里'],
|
|||
|
|
];
|
|||
|
|
|
|||
|
|
// ---- 家谱 ----
|
|||
|
|
$graph = Kinship::graph($familyId);
|
|||
|
|
$cards['kin'] = [
|
|||
|
|
'name' => '家谱',
|
|||
|
|
'icon' => self::icon('kin'),
|
|||
|
|
'color' => Module::color('kin', $familyId),
|
|||
|
|
'href' => url('kin'),
|
|||
|
|
'big' => (string)Relations::count($familyId) . ' 条连线',
|
|||
|
|
'lines' => ['父母 / 配偶 / 子女填上就能长出来'],
|
|||
|
|
];
|
|||
|
|
|
|||
|
|
// ---- 观影 ----
|
|||
|
|
$st = Database::get()->prepare(
|
|||
|
|
"SELECT COUNT(*) FROM events WHERE family_id = ? AND kind = 'movie'"
|
|||
|
|
);
|
|||
|
|
$st->execute([$familyId]);
|
|||
|
|
$movieN = (int)$st->fetchColumn();
|
|||
|
|
$st = Database::get()->prepare(
|
|||
|
|
"SELECT title FROM events WHERE family_id = ? AND kind = 'movie'
|
|||
|
|
ORDER BY starts_at DESC, id DESC LIMIT 1"
|
|||
|
|
);
|
|||
|
|
$st->execute([$familyId]);
|
|||
|
|
$lastMovie = (string)($st->fetchColumn() ?: '');
|
|||
|
|
$cards['movies'] = [
|
|||
|
|
'name' => '观影',
|
|||
|
|
'icon' => self::icon('movies'),
|
|||
|
|
'color' => Module::color('movies', $familyId),
|
|||
|
|
'href' => url('movies'),
|
|||
|
|
'big' => $movieN . ' 部',
|
|||
|
|
'lines' => $lastMovie !== '' ? ['最近看了《' . $lastMovie . '》'] : ['还没有观影记录'],
|
|||
|
|
];
|
|||
|
|
|
|||
|
|
// ---- 旅程 ----
|
|||
|
|
$st = Database::get()->prepare(
|
|||
|
|
"SELECT COUNT(*) FROM events e
|
|||
|
|
LEFT JOIN trip_details d ON d.event_id = e.id
|
|||
|
|
WHERE e.family_id = ? AND e.kind = 'trip' AND COALESCE(d.is_public,1) = 1"
|
|||
|
|
);
|
|||
|
|
$st->execute([$familyId]);
|
|||
|
|
$tripN = (int)$st->fetchColumn();
|
|||
|
|
$st = Database::get()->prepare(
|
|||
|
|
"SELECT e.title FROM events e
|
|||
|
|
LEFT JOIN trip_details d ON d.event_id = e.id
|
|||
|
|
WHERE e.family_id = ? AND e.kind = 'trip' AND COALESCE(d.is_public,1) = 1
|
|||
|
|
ORDER BY e.starts_at DESC, e.id DESC LIMIT 1"
|
|||
|
|
);
|
|||
|
|
$st->execute([$familyId]);
|
|||
|
|
$lastTrip = (string)($st->fetchColumn() ?: '');
|
|||
|
|
$cards['trips'] = [
|
|||
|
|
'name' => '旅程',
|
|||
|
|
'icon' => self::icon('trips'),
|
|||
|
|
'color' => Module::color('trips', $familyId),
|
|||
|
|
'href' => url('trips'),
|
|||
|
|
'big' => $tripN . ' 趟',
|
|||
|
|
'lines' => $lastTrip !== '' ? ['最近去了' . $lastTrip] : ['还没有旅程记录'],
|
|||
|
|
];
|
|||
|
|
|
|||
|
|
// ---- 日程 ----
|
|||
|
|
$cards['calendar'] = [
|
|||
|
|
'name' => '日程',
|
|||
|
|
'icon' => self::icon('calendar'),
|
|||
|
|
'color' => Module::color('calendar', $familyId),
|
|||
|
|
'href' => url('calendar'),
|
|||
|
|
'big' => count($soon) . ' 条',
|
|||
|
|
'lines' => ['未来七天'],
|
|||
|
|
];
|
|||
|
|
|
|||
|
|
// ---- 资源 ----
|
|||
|
|
$st = Database::get()->prepare(
|
|||
|
|
'SELECT COUNT(*) FROM resources r
|
|||
|
|
LEFT JOIN resource_shares s ON s.resource_id = r.id AND s.person_id = ?
|
|||
|
|
WHERE r.family_id = ? AND (r.owner_id = ? OR s.person_id IS NOT NULL)'
|
|||
|
|
);
|
|||
|
|
$st->execute([$me, $familyId, $me]);
|
|||
|
|
$resN = (int)$st->fetchColumn();
|
|||
|
|
$cards['resources'] = [
|
|||
|
|
'name' => '资源',
|
|||
|
|
'icon' => self::icon('resources'),
|
|||
|
|
'color' => Module::color('resources', $familyId),
|
|||
|
|
'href' => url('resources'),
|
|||
|
|
'big' => $resN . ' 项',
|
|||
|
|
'lines' => ['证件 / 资料 / 附件'],
|
|||
|
|
];
|
|||
|
|
|
|||
|
|
// ---- 任务 ----
|
|||
|
|
$board = Task::board($familyId, $me);
|
|||
|
|
$doing = count($board['doing']);
|
|||
|
|
$todo = count($board['todo']);
|
|||
|
|
$late = 0;
|
|||
|
|
foreach ([$board['todo'], $board['doing']] as $col) {
|
|||
|
|
foreach ($col as $t) {
|
|||
|
|
if (Task::isOverdue($t['due_at'] ?? null)) {
|
|||
|
|
$late++;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
$cards['tasks'] = [
|
|||
|
|
'name' => '任务',
|
|||
|
|
'icon' => self::icon('tasks'),
|
|||
|
|
'color' => Module::color('tasks', $familyId),
|
|||
|
|
'href' => url('tasks'),
|
|||
|
|
'big' => $doing . ' 件在做',
|
|||
|
|
'lines' => [$todo . ' 件待办' . ($late > 0 ? ' · ' . $late . ' 件逾期' : '')],
|
|||
|
|
];
|
|||
|
|
|
|||
|
|
// ---- 纪念日 ----
|
|||
|
|
$up = Anniversary::upcoming($familyId, $me, 30);
|
|||
|
|
$next = $up[0] ?? null;
|
|||
|
|
$cards['days'] = [
|
|||
|
|
'name' => '纪念日',
|
|||
|
|
'icon' => self::icon('days'),
|
|||
|
|
'color' => Module::color('days', $familyId),
|
|||
|
|
'href' => url('days'),
|
|||
|
|
'big' => $next ? ((int)$next['days'] === 0 ? '今天' : (int)$next['days'] . ' 天后') : '—',
|
|||
|
|
'lines' => [$next ? (string)$next['title'] : '三十天内没有纪念日'],
|
|||
|
|
];
|
|||
|
|
|
|||
|
|
// ---- 财务 ----
|
|||
|
|
$books = Ledger::mine($familyId, $me);
|
|||
|
|
$net = 0;
|
|||
|
|
$hasBook = false;
|
|||
|
|
foreach ($books as $b) {
|
|||
|
|
$hasBook = true;
|
|||
|
|
$net += Ledger::summary(Ledger::entries((int)$b['id']))['net'];
|
|||
|
|
}
|
|||
|
|
$cards['ledger'] = [
|
|||
|
|
'name' => '财务',
|
|||
|
|
'icon' => self::icon('ledger'),
|
|||
|
|
'color' => Module::color('ledger', $familyId),
|
|||
|
|
'href' => url('ledger'),
|
|||
|
|
'big' => $hasBook ? Ledger::money($net) : '还没记账',
|
|||
|
|
'lines' => [$hasBook ? count($books) . ' 本账（净资产）' : '先建一本家庭账'],
|
|||
|
|
];
|
|||
|
|
|
|||
|
|
return $cards;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/** 模块图标（行内 SVG；与观影设置下拉同一套做法，不引外部字体/图片） */
|
|||
|
|
public static function icon(string $key): string
|
|||
|
|
{
|
|||
|
|
$paths = [
|
|||
|
|
'people' => '<circle cx="7" cy="6" r="2.6"/><path d="M2.6 14c0-2.4 2-3.9 4.4-3.9s4.4 1.5 4.4 3.9"/><circle cx="13" cy="7.2" r="2"/><path d="M11.6 14c0-1.9 1.2-3 2.8-3s2.6 1.1 2.6 3"/>',
|
|||
|
|
'kin' => '<rect x="6.4" y="1.8" width="5.2" height="4" rx="1"/><rect x="1.8" y="12.2" width="5.2" height="4" rx="1"/><rect x="11" y="12.2" width="5.2" height="4" rx="1"/><path d="M9 5.8v3M4.4 12.2v-1.6h9.2v1.6M4.4 10.6h9.2"/>',
|
|||
|
|
'movies' => '<rect x="1.8" y="3.4" width="14.4" height="11.2" rx="2"/><path d="M1.8 7.2h14.4M5.4 3.4v3.8M10.6 3.4v3.8"/>',
|
|||
|
|
'trips' => '<path d="M9 1.8c-2.9 0-5.2 2.3-5.2 5.2 0 3.9 5.2 9.2 5.2 9.2s5.2-5.3 5.2-9.2c0-2.9-2.3-5.2-5.2-5.2z"/><circle cx="9" cy="7" r="1.9"/>',
|
|||
|
|
'calendar' => '<rect x="2" y="3.6" width="14" height="12.4" rx="2"/><path d="M2 7.6h14M5.6 1.8v3.6M12.4 1.8v3.6"/>',
|
|||
|
|
'resources' => '<path d="M2.4 4.4A1.6 1.6 0 0 1 4 2.8h3.2l1.6 2h5.2A1.6 1.6 0 0 1 15.6 6.4v7.2a1.6 1.6 0 0 1-1.6 1.6H4a1.6 1.6 0 0 1-1.6-1.6z"/>',
|
|||
|
|
'tasks' => '<rect x="2.4" y="2.4" width="13.2" height="13.2" rx="2"/><path d="M5.6 9.2l2.4 2.4 4.4-4.8"/>',
|
|||
|
|
'days' => '<path d="M9 2.2l2 4.2 4.6.6-3.4 3.2.8 4.6L9 12.6l-4 2.2.8-4.6L2.4 7l4.6-.6z"/>',
|
|||
|
|
'ledger' => '<rect x="2.4" y="3" width="13.2" height="12" rx="2"/><path d="M5.6 6.6h6.8M5.6 9.4h6.8M5.6 12.2h4"/>',
|
|||
|
|
];
|
|||
|
|
$d = $paths[$key] ?? '';
|
|||
|
|
if ($d === '') {
|
|||
|
|
return '';
|
|||
|
|
}
|
|||
|
|
return '<svg viewBox="0 0 18 18" width="18" height="18" aria-hidden="true" fill="none"'
|
|||
|
|
. ' stroke="currentColor" stroke-width="1.5" stroke-linecap="round"'
|
|||
|
|
. ' stroke-linejoin="round">' . $d . '</svg>';
|
|||
|
|
}
|
|||
|
|
}
|