阶段 0 完整版：名册 + 账号 + 安装向导 + 设置（宣纸主题）

这一版把「家」的地基铺完：功能 - 安装向导 install.php：建四张表 → 建家庭 → 建第一人（兼管理员），装完自删；「是否已装」以数据库四张表为准，不以文件是否存在为准 - 家庭名册：成员增删改查、头像上传（居中裁方 512×512 转 JPEG、finfo 校验、随机文件名）、生日自动算年龄与倒数天数 - 敏感信息加密存储：手机号双写（SHA-256 哈希用于登录 + AES-256-CBC 密文用于显示）、身份证只存密文；页面上永远只显示脱敏后的 138****8000 / 前 6 后 4 - 账号体系：人与账号分离（孩子可入名册但无需密码）、开通/停用/角色、防爆破（5 次失败锁 60 秒）、修改密码、最后一个管理员不可移除 - 设置页：家庭名称与座右铭、加密密钥状态 - 宣纸主题 UI：砖红取自图标，扁平、留白充足；移动端顶栏收紧不换行安全 - 所有 POST 走 CSRF；输出全量 e() 转义；uploads/ 禁执行脚本 - app/ 与 templates/ 加 .htaccess 整体拒绝直连（直接请求模板会 Fatal 并把服务器绝对路径打在页面上 —— 这是线上真实抓到过的问题） - 已安装的 install.php 返回 404；display_errors 线上关闭工程 - 无框架无 Composer，query-string 路由（index.php?r=模块/动作），不依赖 rewrite - 静态资源带 mtime+size 版本号，改版后浏览器不会吃旧缓存 - 配套部署与冒烟（_tooling/，不入库）：部署脚本容忍 tar 对非属主目录的元数据回填失败；冒烟断言「状态码 + 正文无 PHP 错误 + </html> 收尾 + 无绝对路径泄露 + 断言总数下限」—— 只看状态码会把「200 但正文中间 Fatal」当成通过，这一版在线上真实抓到过一次
2026-09-30 00:49:53 +08:00
parent ecafa110f2
commit 8eb19267bc
30 changed files with 2462 additions and 123 deletions
@@ -0,0 +1,81 @@
+<?php
+/**
+ * 建表语句（安装向导与 tests 共用同一份）。
+ *
+ * 四条约定：
+ *   1. 全部 IF NOT EXISTS —— 重复执行不破坏已有数据
+ *   2. 字符集一律 utf8mb4_unicode_ci，emoji 与人名生僻字都不会乱码
+ *   3. 一切业务数据挂在 family_id 下，将来要支持多个家庭也不必改模型
+ *   4. 手机号存两份：phone_hash 用于登录查找（确定性哈希），phone_encrypted 用于展示
+ */
+
+declare(strict_types=1);
+
+namespace App;
+
+final class Schema
+{
+    /** @return string[] */
+    public static function statements(): array
+    {
+        return [
+            <<<'SQL'
+CREATE TABLE IF NOT EXISTS `families` (
+  `id`         INT UNSIGNED NOT NULL AUTO_INCREMENT,
+  `name`       VARCHAR(100) NOT NULL COMMENT '家庭名称',
+  `motto`      VARCHAR(200) DEFAULT NULL COMMENT '一句话，展示在首页',
+  `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  PRIMARY KEY (`id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='家庭空间（一切数据的根）'
+SQL,
+            <<<'SQL'
+CREATE TABLE IF NOT EXISTS `persons` (
+  `id`                INT UNSIGNED NOT NULL AUTO_INCREMENT,
+  `family_id`         INT UNSIGNED NOT NULL,
+  `kind`              ENUM('member','contact') NOT NULL DEFAULT 'member' COMMENT '家庭成员 / 外部联系人',
+  `name`              VARCHAR(50)  NOT NULL COMMENT '姓名',
+  `nickname`          VARCHAR(50)  DEFAULT NULL COMMENT '小名',
+  `gender`            ENUM('m','f','x') DEFAULT NULL COMMENT '男 / 女 / 未填写',
+  `birthday`          DATE         DEFAULT NULL COMMENT '生日（自动生成日历上的生日日程用）',
+  `avatar`            VARCHAR(255) DEFAULT NULL COMMENT '头像，相对于 uploads/avatars',
+  `phone_hash`        CHAR(64)     DEFAULT NULL COMMENT '手机号 sha256，登录查找用；NULL 不参与唯一约束',
+  `phone_encrypted`   VARCHAR(512) DEFAULT NULL COMMENT 'AES 加密的手机号',
+  `id_card_encrypted` VARCHAR(512) DEFAULT NULL COMMENT 'AES 加密的身份证号',
+  `email`             VARCHAR(120) DEFAULT NULL,
+  `address`           VARCHAR(200) DEFAULT NULL,
+  `note`              TEXT         DEFAULT NULL COMMENT '备注',
+  `sort_order`        INT NOT NULL DEFAULT 1000 COMMENT '名册排序，小的在前',
+  `created_at`        DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `updated_at`        DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_phone_hash` (`phone_hash`),
+  KEY `idx_family_kind` (`family_id`, `kind`, `sort_order`),
+  CONSTRAINT `fk_persons_family` FOREIGN KEY (`family_id`) REFERENCES `families` (`id`) ON DELETE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='家庭名册'
+SQL,
+            <<<'SQL'
+CREATE TABLE IF NOT EXISTS `accounts` (
+  `id`            INT UNSIGNED NOT NULL AUTO_INCREMENT,
+  `person_id`     INT UNSIGNED NOT NULL COMMENT '一个人最多一个账号',
+  `password_hash` VARCHAR(255) NOT NULL,
+  `role`          ENUM('admin','member') NOT NULL DEFAULT 'member' COMMENT '管理员 / 普通成员',
+  `status`        ENUM('active','disabled') NOT NULL DEFAULT 'active',
+  `last_login_at` DATETIME DEFAULT NULL,
+  `created_at`    DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  PRIMARY KEY (`id`),
+  UNIQUE KEY `uk_account_person` (`person_id`),
+  CONSTRAINT `fk_accounts_person` FOREIGN KEY (`person_id`) REFERENCES `persons` (`id`) ON DELETE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='登录账号'
+SQL,
+            <<<'SQL'
+CREATE TABLE IF NOT EXISTS `settings` (
+  `family_id` INT UNSIGNED NOT NULL,
+  `k`         VARCHAR(64)  NOT NULL,
+  `v`         TEXT         DEFAULT NULL,
+  PRIMARY KEY (`family_id`, `k`),
+  CONSTRAINT `fk_settings_family` FOREIGN KEY (`family_id`) REFERENCES `families` (`id`) ON DELETE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='家庭级键值对设置'
+SQL,
+        ];
+    }
+}