This is an old revision of the document!

家庭管理系统 H5 · 冷启动文件

版本 1.0 ｜更新 2026-09-16 ｜访问 `https://rd.huiflytech.com/family/`
与研发任务/库房/测试/评审会同一服务（`rd-h5.service`，Flask :13544）

1. 系统概览

项	值
—	—
后端	`/home/ubuntu/.hermes/scripts/family_api.py`（Blueprint `bp`，前缀 `/api/family`）
前端	`/home/ubuntu/.hermes/scripts/family.html`（页面 `/family/`）
数据	`/home/ubuntu/docs/family/family.db`（附件目录 `attachments/`）
管理员白名单	`ADMIN_PHONES = {“18932573927”}`（武燕青）
现有用户	18932573927 武燕青(admin) ｜ 16603395188 倾心(user) ｜ 13780562913 果果(user)
启动	`sudo systemctl restart rd-h5.service`（改代码后必须重启）

2. 模块与权限

全部 tab：🏠家务｜ ⭐积分｜ 💬语录｜ 🎂生日｜ 🍳菜谱｜ 💰缴费｜ ⚠️预警｜ 📋信息 ｜ 📜日志｜ 👤我的

普通用户可见（`USER_TABS`）：仅 `house / points / warn / me`

权限网关 `_guard()`（`@bp.before_request`）： - 未登录 → 401 - `role == 'admin'` → 全部放行 - 普通用户 → 仅白名单路径（tasks GET/PATCH、tasks/refresh、points、warns、me、log、user/*），其余 403 - ★ 新增的管理员模块路径不在白名单 → 天然仅管理员可用

3. 信息模块（2026-09-16 新增，仅管理员）

用途：家庭档案 / 学籍等敏感信息集中存储与展示。

表结构

CREATE TABLE IF NOT EXISTS info(
  key TEXT PRIMARY KEY, val TEXT DEFAULT '', updated TEXT DEFAULT '');

（`val` 存 JSON 字符串）

API

方法	路径	说明
—	—	—
GET	`/api/family/info`	返回 `{ok, data:{key: {…}}}`；未登录 401 / 普通用户 403
POST	`/api/family/info`	body `{data:{key:{…}}}`，`INSERT OR REPLACE` 保存

身份传递：`cur_user()` 从 `phone` 参数读取（query / JSON body / form）——测试时可直接 `?phone=18932573927`

前端：`ALL_TABS` 含 `['info','📋 信息']`，不入 `USER_TABS` → 普通用户看不到入口；`renderInfo()` 渲染卡片（主体信息 `INFO_FIELDS` + `__lists` 描述的成员列表）

数据结构（学籍示例）

{
  "xueji_xizien": {
    "__title": "席子恩 学籍信息",
    "姓名": "…", "性别": "…", "身份证件号": "…", "出生日期": "…",
    "__lists": [{"key": "监护人", "title": "监护人信息", "fields": ["姓名","关系","是否监护人","民族","身份证件类型","身份证件号","工作单位","户口所在地行政编码","户口所在地具体地址","联系电话"]}],
    "监护人": [{"姓名": "…", "关系": "母亲", "联系电话": "…"}, {"姓名": "…", "关系": "父亲", "联系电话": "…"}]
  }
}

已录入：`xueji_xizien` — 席子恩学籍（学生 19 字段 + 2 位监护人各 10 字段）

4. 学籍字段清单

学生（19 项）：姓名｜曾用名｜性别｜国籍/地区｜港澳台侨外｜民族｜身份证件类型｜身份证件号｜出生日期｜政治面貌｜现居住地行政编码｜现居住地址详细地址｜户口所在地行政编码｜户口所在地具体地址｜是否寄宿生｜是否残疾人｜是否农村留守儿童｜残疾类型｜特教学生就读类型

监护人（10 项/人）：姓名｜关系｜是否监护人｜民族｜身份证件类型｜身份证件号｜工作单位｜户口所在地行政编码｜户口所在地具体地址｜联系电话

5. 排障速查

现象	原因	处理
—	—	—
API 返回 401	未登录（请求未带 `phone`）	带 `?phone=<手机号>`
API 返回 403	普通用户访问管理员模块	正常（预期行为）
`info` tab 不显示	当前用户非管理员	正常
服务起不来（activating/失败）	路由用了 `@app.route`	必须用 `@bp.route`（family_api 用 Blueprint）
页面改动不生效	服务未重启	`sudo systemctl restart rd-h5.service`

6. 安全注意

- 信息模块含身份证号、住址、电话等敏感信息 → 仅管理员可见（前后端双重限制：前端 tab 不显示 + 后端 `_guard` 403） - 文档中不记录具体证件号码；数据仅存本地 SQLite（`docs/family/family.db`，权限 600） - 站点为 HTTPS（`rd.huiflytech.com`）

曼陀林知识库

Table of Contents