82 lines
3.9 KiB
PHP
82 lines
3.9 KiB
PHP
|
<?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,
|
|||
|
|
];
|
|||
|
|
}
|
|||
|
|
}
|